Atualizar um cluster fragmentado para 5.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()

Para verificar se o balanceador está desativado, execute sh.getBalancerState(), que retorna falso se o balanceador estiver desativado:

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 membros secundários da réplicas para definir um de cada vez:

   1. Encerre a instância mongod secundária e substitua o binário 4.4 pelo binário 5.0.

   2. Inicie o binário 5.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 5.0 binário:

      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.

   3. Aguarde até que o membro se recupere com o estado SECONDARY antes de atualizar o próximo membro secundário. Para verificar o estado do membro, emita rs.status() em mongosh.

      Repita para cada membro secundário.

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

   1. 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. Quando rs.status() indicar que o primário foi desativado e outro membro tiver assumido o estado PRIMARY, encerre o primário desativado e substitua o binário mongod pelo binário 5.0.

   3. Inicie o binário 5.0 com as opções--configsvr, --replSet --port e opções --bind_ip. Inclua quaisquer opções de linha de comando opcionais usadas 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 5.0 binário:

      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.

Para cada conjunto de réplicas do fragmento:

1. Atualize os membros secundários da réplicas para definir um de cada vez:

   1. Desligue a instância mongod e substitua o binário 4.4 pelo binário 5.0.

   2. Inicie o binário 5.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 5.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.

      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. Quando rs.status() indicar que o primário foi desativado e outro membro tiver assumido o estado PRIMARY, faça upgrade do primário desativado:

   1. Desligue o principal passo a passo e substitua o binário mongod pelo binário 5,0.

   2. Inicie o binário 5.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 5.0 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 mongos instâncias de.

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

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.

Habilite recursos 5.0 incompatíveis com versões anteriores.

Neste ponto, você pode executar os binários do 5.0 sem as feições do 5,0 que são incompatíveis com 4.4.

Para habilitar essas funcionalidades do 5.0, defina feature compatibility version (fCV) para 5.0.

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

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

Definindo featureCompatibilityVersion (fCV) : "5.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 5.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.