Atualizar um cluster fragmentado para 6.0

Desabilitar o Balanceador.

Conecte o mongosh a uma instância do mongos no cluster fragmentado e execute o sh.stopBalancer() para desabilitar o balanceador:

sh.stopBalancer()

sh.getBalancerState()

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

Atualize a tabela de roteamento em cache para cada mongos.

Para cada mongos no cluster, conecte mongosh à instância mongos e execute flushRouterConfig para atualizar a tabela de roteamento em cache:

db.adminCommand("flushRouterConfig")
db.adminCommand(
   {
     flushRouterConfig: 1
   }
)

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.

      Para desligar o processo do mongod, utilize mongosh para se conectar ao membro do cluster e execute o seguinte comando:

      db.adminCommand( { shutdown: 1 } )

   2. Substitua o binário 5.0 pelo binário 6.0.

   3. Iniciar o binário 6.0.

      Inicie o binário 6.0 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 estiver usando um arquivo de configuração, atualize o arquivo para especificar sharding.clusterRole: configsvr, replication.replSetName, net.port e net.bindIp e, em seguida, inicie o binário 6.0:

      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.

      Para verificar o estado do membro, emita rs.status() em mongosh.

   5. Repita para cada membro secundário.

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

   1. Rebaixe o primário.

      Conecte mongosh ao primário e use rs.stepDown() para reduzir o primário e forçar a eleição de um novo primário:

      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.

      Para encerrar o primário desativado, utilize mongosh para se conectar ao primário e executar o seguinte comando:

      db.adminCommand( { shutdown: 1 } )

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

   4. Iniciar o binário 6.0.

      Inicie o 6.0 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 estiver usando um arquivo de configuração, atualize o arquivo para especificar sharding.clusterRole: configsvr, replication.replSetName, net.port e net.bindIp e, em seguida, inicie o binário 6.0:

      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 fragmentos.

Atualize os fragmentos um de cada vez.

1. Para cada conjunto de réplicas de shard, atualize os membros secundários do conjunto de réplicas, um de cada vez:

   1. Desligue a instância secundária.

      Para desligar o processo do mongod, utilize mongosh para se conectar ao membro do cluster e execute o seguinte comando:

      db.adminCommand( { shutdown: 1 } )

   2. Substitua o binário 5.0 pelo binário 6.0.

      Inicie o binário 6.0 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 6.0 :

      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.

      Para verificar o estado do membro, você pode emitir rs.status() em mongosh.

   4. Repita para cada membro secundário.

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

   Conecte mongosh ao primário e use rs.stepDown() para reduzir o primário e forçar a eleição de um novo primário:

   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

      Para encerrar o primário desativado, utilize mongosh para conectar ao membro do conjunto de réplicas e executar o seguinte comando:

      db.adminCommand( { shutdown: 1 } )

   2. Substitua o binário mongod pelo binário 6.0 .

   3. Iniciar o binário 6.0.

      Inicie o binário 6.0 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 binário 6.0:

      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 mongos instâncias de.

Substitua cada instância mongos pelo 6.0 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>

Reabilitar o balanceador.

Utilizando mongosh, conecte-se a um mongos no cluster e execute sh.startBalancer() para reativar o balanceador:

sh.startBalancer()

A partir do MongoDB 6.0.3, a divisão automática de partes não é executada. Isso se deve a melhorias na política de balanceamento. Os comandos de divisão automática ainda existem, mas não executam uma operação. Para obter detalhes, consulte Alterações na política de balanceamento.

Nas versões MongoDB anteriores a 6.0.3, o sh.startBalancer() também habilita a divisão automática para o cluster fragmentado.

Se não desejar ativar a divisão automática enquanto o balanceador estiver ativado, você também deverá executar sh.disableAutoSplit().

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

Ative recursos 6.0 incompatíveis com versões anteriores.

Neste ponto, você pode executar os binários do 6.0 sem as funcionalidades do 6.0 que são incompatíveis com 5.0.

Para habilitar estes recursos do 6.0, defina a versão de compatibilidade de recursos (fCV) para 6.0.

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

db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )

Definindo featureCompatibilityVersion (fCV) : "6.0" executa implicitamente um replSetReconfig em cada shard para adicionar o campo term 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.

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

Quaisquer documentos órfãos que existam em seus fragmentos serão limpos quando você definir o setFeatureCompatibilityVersion como 6.0. O processo de limpeza:

• Não bloqueia a conclusão da atualização e

• Tem limitação de taxa. Para mitigar o possível efeito no desempenho durante a limpeza de documentos órfãos, consulte Ajuste de desempenho de exclusão de intervalo.