Atualizar o cluster fragmentado 8.2 para 8.3

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 8.2 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ê usar um arquivo de configuração, atualize o arquivo para especificar,, e, então sharding.clusterRole: configsvr replication.replSetNamenet.port net.bindIpinicie 8 o.3 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.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 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.3 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 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.

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

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

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

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

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

O MongoDB limpa todos os documentos órfãos que existem em seus shards quando você define setFeatureCompatibilityVersion 8.3como. 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.