Actualizar el clúster fragmentado 8.0 a 8.3.

Deshabilitar el balanceador

Conecte mongosh a una instancia mongos en el clúster fragmentado y ejecute sh.stopBalancer() para desactivar el balanceador:

sh.stopBalancer()

sh.getBalancerState()

Para obtener más información sobre cómo deshabilitar el balanceador, consulta Deshabilitar el balanceador.

Actualizar los servidores de configuración

1. Actualiza los miembros secundarios del set de réplicas, uno a la vez.

   1. Apague la instancia secundaria.

      Para cerrar el proceso mongod, use mongosh para conectarse al nodo del clúster y ejecutar el siguiente comando:

      db.adminCommand( { shutdown: 1 } )

   2. Reemplaza el binario 8.0 con el binario 8.3.

   3. Inicie el binario 8.3.

      Inicia el binario 8.3 con el --configsvr, --replSet y --port. Incluya cualquier otra opción utilizada por la implementación.

      mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      Si utiliza un archivo de configuración, actualice el archivo para sharding.clusterRole: configsvr replication.replSetNameespecificar,, y, net.port y luego inicie el net.bindIp 8 3 binario.:

      sharding:
         clusterRole: configsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      Incluye cualquier otro ajuste que corresponda a tu implementación.

   4. Espere a que el nodo se recupere al estado SECONDARY antes de actualizar el siguiente nodo secundario.

      Para comprobar el estado del nodo, ejecuta rs.status() en mongosh.

2. Reduce el primario del set de réplicas.

   1. Conecte mongosh al principal y utilice rs.stepDown() para rebajar al principal y forzar la elección de un nuevo principal:

      rs.stepDown()

   2. Apague el primario reducido.

      Cuando rs.status() indique que el nodo principal se ha desplazado y otro miembro ha asumido el estado PRIMARY, apaga el nodo principal desplazado.

      Para apagar la primaria degradada, utiliza mongosh para conectarte a la primaria y ejecutar el siguiente comando:

      db.adminCommand( { shutdown: 1 } )

   3. Reemplace el binario mongod con el binario 8.3.

   4. Inicie el binario 8.3.

      Inicia el 8.3 con las opciones --configsvr, --replSet, --port, y --bind_ip. Incluye cualquier opción de línea de comandos opcional utilizada en la implementación anterior:

      mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      Si utiliza un archivo de configuración, actualice el archivo para sharding.clusterRole: configsvr replication.replSetNameespecificar,, y, net.port y luego inicie el net.bindIp 8 3 binario.:

      sharding:
         clusterRole: configsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      Incluye cualquier otra configuración que sea adecuada para tu implementación.

Actualizar las particiones

Actualice las particiones una por una.

Para cada set de réplicas de particiones:

1. Actualiza los miembros secundarios del set de réplicas, uno a la vez.

   1. Apague la instancia secundaria.

      Para cerrar el proceso mongod, use mongosh para conectarse al nodo del clúster y ejecutar el siguiente comando:

      db.adminCommand( { shutdown: 1 } )

   2. Reemplaza el binario 8.0 con el binario 8.3.

      Inicia el binario 8.3 con las opciones --shardsvr, --replSet, --port y --bind_ip. Incluya las opciones de línea de comandos adicionales que correspondan para su implementación:

      mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      Si se utiliza un archivo de configuración, actualiza el archivo para incluir sharding.clusterRole: shardsvr, replication.replSetName, net.port y net.bindIp, y luego inicia el 8.3 binario:

      sharding:
         clusterRole: shardsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      Incluye cualquier otra configuración que sea adecuada para tu implementación.

   3. Espere a que el nodo se recupere al estado SECONDARY antes de actualizar el siguiente nodo secundario.

      Para comprobar el estado del nodo, puedes emitir rs.status() en mongosh.

   4. Repetir para cada miembro secundario.

2. Reduce el primario del set de réplicas.

   Conecte mongosh al principal y utilice rs.stepDown() para rebajar al principal y forzar la elección de un nuevo principal:

   rs.stepDown()

3. Actualiza el primario bajado.

   Cuando rs.status() muestra que el primario ha dejado su función y otro nodo ha asumido el estado PRIMARY, actualice el primario que ha sido desligado:

   1. Apague el primario reducido.

      Para apagar el primario degradado, use mongosh para conectarse al miembro del set de réplicas y ejecute el siguiente comando:

      db.adminCommand( { shutdown: 1 } )

   2. Reemplace el binario mongod. con el 8.3 binario.

   3. Inicie el binario 8.3.

      Inicia el binario 8.3 con las opciones --shardsvr, --replSet, --port y --bind_ip. Incluya las opciones de línea de comandos adicionales que correspondan para su implementación:

      mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      Si utilizas un archivo de configuración, actualiza el archivo para especificar sharding.clusterRole: shardsvr, replication.replSetName, net.port y net.bindIp, y luego inicia el 8.3 binario:

      sharding:
            clusterRole: shardsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      Incluye cualquier otra configuración que sea adecuada para tu implementación.

Actualizar las mongos instancias

Reemplaza cada instancia de mongos por el binario 8.3 y reinicia. Incluye cualquier otra configuración que sea apropiada para tu implementación.

mongos --configdb csReplSet/<rsconfigsver1:port1>,<rsconfigsver2:port2>,<rsconfigsver3:port3> --bind_ip localhost,<ip address>

Vuelva a habilitar el equilibrador

Usando mongosh, conecta a un mongos en el clúster y ejecuta sh.startBalancer() para volver a habilitar el balanceador:

sh.startBalancer()

Para más información sobre la reactivación del balanceador, consulta Activar el balanceador.

Habilitar funciones 8.3 incompatibles con versiones anteriores

En este punto, se pueden ejecutar los binarios 8.3 sin las características 8.3 que son incompatibles con 8.0.

Para habilitar estas 8.3 características, establezca la versión de compatibilidad de características (FCV) en 8.3. También debe establecer confirm en verdadero.

En una instancia mongos, ejecuta el comando setFeatureCompatibilityVersion en la base de datos admin:

db.adminCommand( { setFeatureCompatibilityVersion: "8.3", confirm: true } )

Configuración featureCompatibilityVersion (compatibilidad de características entre versiones) : "8.3" realiza de forma implícita una replSetReconfig en cada partición para añadir el campo term al documento de configuración de la réplica de partición.

El comando no se completa hasta que la nueva configuración se propaga a la mayoría de los miembros del set de réplicas.

Este comando debe realizar escrituras en una colección interna del sistema. Si el comando no se completa, puede volver a intentarlo sin problemas en mongos el dispositivo, ya que la operación es idempotente.

MongoDB limpia cualquier documento huérfano que exista en sus fragmentos cuando establece setFeatureCompatibilityVersion 8.3en. El proceso de limpieza es el siguiente:

• No impide que la actualización se complete, y

• Tiene un límite de velocidad. Para mitigar el posible impacto en el rendimiento durante la limpieza de documentos huérfanos, consulta Tuning del Rendimiento de Eliminación de Rangos.