Overview
Los sets de réplicas permiten que una implementación de MongoDB permanezca disponible durante la mayor parte de una ventana de mantenimiento.
Este documento describe el procedimiento básico para realizar el mantenimiento de cada uno de los nodos de un set de réplicas. Además, esta secuencia particular se esfuerza por minimizar el tiempo que el principal está inactivo y controlar el impacto en toda la implementación.
Utilice estos pasos como base para las operaciones comunes de sets de réplicas, especialmente para procedimientos como la actualización a la última versión de MongoDB.
Procedimiento
Para cada nodo de un set de réplicas, empezando por un secundario, realiza la siguiente secuencia de eventos, finalizando con el primario:
Reinicia la instancia
mongodcomo autónoma.Ejecute la tarea en la instancia autónomo.
Reinicia la instancia
mongodcomo nodo del set de réplicas.
Reinicie el secundario como autónomo en un puerto diferente.
En el indicador del shell del sistema operativo, reinicie mongod como una instancia autónomo.
Si está utilizando un archivo de configuración, realice las siguientes actualizaciones de configuración:
Comenta la opción
replication.replSetName.Cambia el
net.porta un puerto diferente. Toma nota de la configuración original del puerto como comentario.Establece el parámetro
disableLogicalSessionCacheRefreshentrueen la secciónsetParameter.Si el
mongodes un partición o servidor de configuración nodo, también debes:Comenta la opción
sharding.clusterRole.Establece el parámetro
skipShardingConfigurationChecksentrueen la secciónsetParameter.
Por ejemplo, si se realiza el mantenimiento de un miembro del set de réplicas de partición/servidor de configuración para el mantenimiento, el archivo de configuración actualizado incluirá contenido como el siguiente ejemplo:
net: bindIp: localhost,<hostname(s)|ip address(es)> port: 27218 # port: 27018 #replication: # replSetName: shardA #sharding: # clusterRole: shardsvr setParameter: skipShardingConfigurationChecks: true disableLogicalSessionCacheRefresh: true
Si utilizas opciones de línea de comandos, realiza las siguientes actualizaciones de configuración para reiniciar:
Remover
--replSetName.Modificar
--porta un puerto diferente.Configura el parámetro
disableLogicalSessionCacheRefreshatrueen la opción--setParameter.Si el
mongodes un partición o servidor de configuración nodo, también debes:Elimine
--shardsvrsi es un nodo de la partición y--configsvrsi es un nodo del servidor de configuración.Establece el parámetro
skipShardingConfigurationChecksentrueen la secciónsetParameter.
Por ejemplo, para reiniciar un miembro del set de réplicas que no forma parte de un clúster:
mongod --port 27218 --dbpath /srv/mongodb --bind_ip localhost,<hostname(s)|ip address(es)> --setParameter disableLogicalSessionCacheRefresh=true
Por ejemplo, para reiniciar un miembro del set de réplicas de partición o servidor de configuración para tareas de mantenimiento:
mongod --port 27218 --dbpath /srv/mongodb --bind_ip localhost,<hostname(s)|ip address(es)> --setParameter skipShardingConfigurationChecks=true --setParameter disableLogicalSessionCacheRefresh=true
Advertencia
Antes de vincular la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar habilitar la autenticación y reforzar la infraestructura de red.
Siempre inicia mongod con el mismo usuario, incluso al reiniciar un miembro de un set de réplicas como una instancia autónoma.
Realizar operaciones de mantenimiento en el secundario.
Mientras el nodo es autónomo, utilice mongosh para realizar el mantenimiento:
mongo --port 27218
Importante
Mientras el nodo es autónomo, no se replican guardados en dicho nodo ni los guardados realizados en dicho nodo se replican en los demás nodos del set de réplicas.
Asegúrese de que cualquier escritura en este autónomo no entre en conflicto con las escrituras oplog que se aplicarán al nodo cuando vuelva a unirse al set de réplicas.
Reiniciar mongod como nodo del set de réplicas.
Después de realizar todas las tareas de mantenimiento, utilice el siguiente procedimiento para reiniciar el mongod como nodo del conjunto de réplicas en su puerto habitual.
Desde mongosh, apague el servidor autónomo después de completar el mantenimiento:
use admin db.shutdownServer()
Reinicie la instancia mongod como miembro de set de réplicas con su configuración original; es decir, deshaga los cambios realizados durante el inicio como autónomo.
Tip
Asegúrese de remover el parámetro disableLogicalSessionCacheRefresh.
Para los nodos del partición o del servidor de configuración, asegúrese de remover el parámetro skipShardingConfigurationChecks.
Cuando se haya iniciado, conecte mongosh a la instancia reiniciada.
El secundario tarda en ponerse al día con el primario. Desde mongosh, utilice el siguiente comando para verificar que el nodo se ha puesto al día desde el estado RECOVERING hasta el estado SECONDARY.
rs.status()
Realizar el mantenimiento en el principal al final.
Para realizar el mantenimiento en el primario después de completar las tareas de mantenimiento en todos los secundarios, conecte
mongoshal primario y utilicers.stepDown()para degradar el primario y permitir que uno de los secundarios sea elegido como nuevo primario. Especifique un período de espera de 300 segundos para evitar que el nodo sea elegido primario de nuevo durante cinco minutos:rs.stepDown(300) Después de que el primario se retire, el set de réplicas elegirá un nuevo primario.
Reinicie
mongodcomo una instancia autónoma, realizando las siguientes actualizaciones de configuración.
Si está utilizando un archivo de configuración, realice las siguientes actualizaciones de configuración:
Comenta la opción
replication.replSetName.Cambia el
net.porta un puerto diferente. Toma nota de la configuración original del puerto como comentario.Configura el parámetro
disableLogicalSessionCacheRefreshatrueen la opción--setParameter.Si el
mongodes un partición o servidor de configuración nodo, también debes:Comenta la opción
sharding.clusterRole.Establece el parámetro
skipShardingConfigurationChecksentrueen la secciónsetParameter.
Por ejemplo, si se realiza el mantenimiento de un miembro del set de réplicas de partición/servidor de configuración para el mantenimiento, el archivo de configuración actualizado incluirá contenido como el siguiente ejemplo:
net: bindIp: localhost,<hostname(s)|ip address(es)> port: 27218 # port: 27018 #replication: # replSetName: shardA #sharding: # clusterRole: shardsvr setParameter: skipShardingConfigurationChecks: true disableLogicalSessionCacheRefresh: true
Advertencia
Antes de vincular la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar habilitar la autenticación y reforzar la infraestructura de red.
Si usas opciones de línea de comando, realiza las siguientes actualizaciones de configuración:
Remover
--replSetName.Modificar
--porta un puerto diferente.Configura el parámetro
disableLogicalSessionCacheRefreshatrueen la opción--setParameter.Si el
mongodes un partición o servidor de configuración nodo, también debes:Elimine
--shardsvrsi es un nodo de la partición y--configsvrsi es un nodo del servidor de configuración.Establece el parámetro
skipShardingConfigurationChecksentrueen la secciónsetParameter.
Por ejemplo, para reiniciar un miembro del set de réplicas que no forma parte de un clúster:
mongod --port 27218 --dbpath /srv/mongodb --bind_ip localhost,<hostname(s)|ip address(es)> --setParameter disableLogicalSessionCacheRefresh=true
Por ejemplo, para reiniciar un miembro del set de réplicas de partición o servidor de configuración para tareas de mantenimiento:
mongod --port 27218 --dbpath /srv/mongodb --bind_ip localhost,<hostname(s)|ip address(es)> --setParameter skipShardingConfigurationChecks=true --setParameter disableLogicalSessionCacheRefresh=true
Advertencia
Antes de vincular la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar habilitar la autenticación y reforzar la infraestructura de red.
Realiza tareas de mantenimiento en el ahora autónomo.
Importante
Mientras el nodo es autónomo, no se replican guardados en dicho nodo ni los guardados realizados en dicho nodo se replican en los demás nodos del set de réplicas.
Asegúrese de que cualquier escritura en este autónomo no entre en conflicto con las escrituras oplog que se aplicarán al nodo cuando vuelva a unirse al set de réplicas.
Después de realizar todas las tareas de mantenimiento, reinicie la
mongodinstancia como un set de réplicas con su configuración original; es decir, deshaga los cambios de configuración realizados al iniciarse como autónomo.Tip
Asegúrese de remover el parámetro
disableLogicalSessionCacheRefresh.Para los nodos del partición o del servidor de configuración, asegúrese de remover el parámetro
skipShardingConfigurationChecks.