Atualizar um cluster fragmentado para 8.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 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 7.0 binário pelo 8.0 binário.

   3. Iniciar o binário 8.0.

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

   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.

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

   4. Iniciar o binário 8.0.

      Inicie o 8.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 8.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 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 7.0 binário pelo 8.0 binário.

      Inicie o binário 8.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 8.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 . com o binário 8.0 .

   3. Iniciar o binário 8.0.

      Inicie o binário 8.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 8.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 8.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()

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

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

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

Para habilitar esses recursos da versão 8.0, defina a versão de compatibilidade do recurso (fCV) como 8.0.

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

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

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