Atualização 8.0 Cluster fragmentado para 8.3

Desabilitar o Balanceador

Connect mongosh to a mongos instance in the sharded cluster, and run sh.stopBalancer() to disable the balancer:

sh.stopBalancer()

sh.getBalancerState()

Para obter mais informações sobre como desabilitar o balanceador, consulte Desabilitar o balanceador.

Atualize os servidores de configuração

1. Atualize os nós secundários do conjunto de réplicas, um de cada vez.

   1. Desligue a instância secundária.

      To shut down the mongod process, use mongosh to connect to the cluster member and run the following command:

      db.adminCommand( { shutdown: 1 } )

   2. Substitua o 8.0 binário pelo 8.3 binário.

   3. Iniciar o binário 8.3.

      Inicie o binário 8.3 com o --configsvr, --replSete --port. Inclua quaisquer outras opções conforme usado pela implantação.

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

      Se você utilizar um arquivo de configuração, atualize o arquivo para especificar sharding.clusterRole: configsvr, replication.replSetName, net.port e net.bindIp, então inicie o 8.3 binary:

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

      Inclua quaisquer outras configurações conforme adequado para sua implantação.

   4. Aguarde até que o membro se recupere para o estado SECONDARY antes de atualizar o próximo membro secundário.

      To check the member's state, issue rs.status() in mongosh.

   Repita para cada membro secundário.

2. Reduza o conjunto de réplicas primário.

   1. Connect mongosh to the primary and use rs.stepDown() to step down the primary and force an election of a new primary:

      rs.stepDown()

   2. Encerrar o primário de redução

      Quando rs.status() mostrar que o primário foi desativado e outro nó assumiu o estado PRIMARY, encerre o primário desativado.

      To shut down the stepped-down primary, use mongosh to connect to the primary and run the following command:

      db.adminCommand( { shutdown: 1 } )

   3. Substitua o binário mongod pelo binário 8.3 .

   4. Iniciar o binário 8.3.

      Inicie o 8.3 com as opções --configsvr, --replSet, --port e --bind_ip. Inclua quaisquer opções de linha de comando opcionais utilizadas pela implantação anterior:

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

      Se você utilizar um arquivo de configuração, atualize o arquivo para especificar sharding.clusterRole: configsvr, replication.replSetName, net.port e net.bindIp, então inicie o 8.3 binary:

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

      Inclua qualquer outra configuração conforme adequado para sua implantação.

Atualize os shards

Atualize os fragmentos um de cada vez.

Para cada conjunto de réplicas do fragmento:

1. Atualize os nós secundários do conjunto de réplicas, um de cada vez.

   1. Desligue a instância secundária.

      To shut down the mongod process, use mongosh to connect to the cluster member and run the following command:

      db.adminCommand( { shutdown: 1 } )

   2. Substitua o 8.0 binário pelo 8.3 binário.

      Inicie o binário 8.3 com as opções --shardsvr, --replSet, --port e --bind_ip. Inclua opções de linha de comando adicionais, conforme adequado, para sua implantação:

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

      Se estiver usando um arquivo de configuração, atualize-o para incluir sharding.clusterRole: shardsvr, replication.replSetName, net.port e net.bindIp, então inicie o binário 8.3 :

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

      Inclua qualquer outra configuração conforme adequado para sua implantação.

   3. Aguarde até que o membro se recupere para o estado SECONDARY antes de atualizar o próximo membro secundário.

      To check the member's state, you can issue rs.status() in mongosh.

   4. Repita para cada membro secundário.

2. Reduza o conjunto de réplicas primário.

   Connect mongosh to the primary and use rs.stepDown() to step down the primary and force an election of a new primary:

   rs.stepDown()

3. Atualize o primário desativado.

   Quando rs.status() mostrar que o primário foi desativado e outro membro assumiu o estado PRIMARY, faça upgrade do primário desativado:

   1. Encerrar o primário de redução

      To shut down the stepped-down primary, use mongosh to connect to the replica set member and run the following command:

      db.adminCommand( { shutdown: 1 } )

   2. Substitua o binário mongod . com o binário 8.3 .

   3. Iniciar o binário 8.3.

      Inicie o binário 8.3 com as opções --shardsvr, --replSet, --port e --bind_ip. Inclua opções de linha de comando adicionais, conforme adequado, para sua implantação:

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

      Se estiver usando um arquivo de configuração, atualize o arquivo para especificar sharding.clusterRole: shardsvr, replication.replSetName, net.port e net.bindIp e, em seguida, inicie o 8.3 binário:

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

      Inclua qualquer outra configuração conforme adequado para sua implantação.

Atualize as instâncias de mongos

Substitua cada instância mongos pelo 8.3 binário e reinicie. Inclua qualquer outra configuração conforme adequado para sua implantação.

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

Reative o balancer

Using mongosh, connect to a mongos in the cluster and run sh.startBalancer() to re-enable the balancer:

sh.startBalancer()

Para obter mais informações sobre como reativar o balanceador, consulte a página Habilitar o balanceador.

Habilitar funcionalidades 8.3 incompatíveis com versões anteriores

Neste ponto, você pode executar o 8.3 binários sem os recursos recursos do 8.3 que são incompatíveis com 8.0.

Para habilitar estas funcionalidades do 8.3, configure a versão de compatibilidade do recurso (FCV) para 8.3. Você também deve definir confirm como true.

Em uma instância do mongos, execute o comando setFeatureCompatibilityVersion no banco de dados admin:

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

Definindo featureCompatibilityVersion (FCV) : "8.3" executa implicitamente um em cada replSetReconfig term shard para adicionar o campo ao documento de configuração de réplica do shard.

O comando não é concluído até que a nova configuração se propague para a maioria dos membros do conjunto de réplicas.

Este comando deve executar gravações em uma coleção interna do sistema. Se o comando não for concluído, você poderá tentar novamente o comando no mongos com segurança, pois a operação é idempotente.