Restaurar um cluster fragmentado autogerenciado

Restore the CSRS primary mongod data files.

Selecione a guia que corresponde ao seu método de backup preferido:

Solte o local banco de banco de dados .

Utilize o db.dropDatabase() para soltar o banco de dados do local:

use local
db.dropDatabase()

Insira a lista de arquivos filtrados no banco de dados local.

Essa etapa só é necessária se você estiver restaurando a partir de um snapshot filtrado por namespace.

Para cada shard, localize a lista de arquivos filtrados com o seguinte formato de nome: <shardRsID>-filteredFileList.txt. Este arquivo contém uma lista de objetos JSON com o seguinte formato:

{
   "filename":"file1",
   "ns":"sampleDb1.sampleCollection1",
   "uuid": "3b241101-e2bb-4255-8caf-4136c566a962"
}

Adicione cada objeto JSON de cada arquivo fragmentado a uma nova coleção db.systems.collections_to_restore no seu banco de dados local . Você pode ignorar entradas com campos ns ou uuid vazios. Ao inserir entradas, o campo uuid deve ser inserido como tipo UUID().

Execute o comando de restauração do arquivo filtrado.

Essa etapa só é necessária se você estiver restaurando a partir de um snapshot filtrado por namespace.

Depois de inserir todas as entradas, execute os seguintes comandos:

use admin
db.runCommand({"_configsvrRunRestore":1})

For any planned or completed shard hostname or replica set name changes, update the metadata in config.shards.

Você pode pular esta etapa se todos os itens a seguir forem verdadeiros:

• Nenhum nome de host da máquina host membro do shard foi ou será alterado durante este procedimento.

• Nenhum nome de conjunto de réplicas de shards foi ou será alterado durante este procedimento.

Emita o seguinte método find() na collection shards no banco de dados de configuração. Substitua <shardName> pelo nome do shard. Por padrão, o nome do shard é o nome do conjunto de réplicas. Se você adicionou o shard utilizando o comando addShard e especificou um name personalizado, você deverá especificar name a <shardName>.

use config
db.shards.find( { "_id" : "<shardName>" } )

Esta operação retorna um documento semelhante ao seguinte:

{
   "_id" : "shard1",
   "host" : "myShardName/alpha.example.net:27018,beta.example.net:27018,charlie.example.net:27018",
   "state" : 1
}

Utilize o método updateOne() para atualizar a string hosts para refletir o nome do conjunto de réplicas planejado e lista de nome do host para o shard. Por exemplo, a seguinte operação atualiza a connection string do host para o shard com "_id" : "shard1":

db.shards.updateOne(
  { "_id" : "shard1" },
  { $set : { "host" : "myNewShardName/repl1.example.net:27018,repl2.example.net:27018,repl3.example.net:27018" } }
)

Repita o processo até que todos os metadados do shard representam com precisão o nome do conjunto de réplicas planejado e a lista de nomes de host para cada shard no cluster.

use config
db.shards.find({})

Restart the mongod as a new single-node replica set.

Desligue o mongod. Descomente ou adicione as seguintes opções de arquivo de configuração:

replication:
  replSetName: myNewCSRSName
sharding:
  clusterRole: configsvr

Se você deseja alterar o nome do conjunto de réplica, você deverá atualizar o campo replSetName com o novo nome antes de continuar.

Inicie o mongod com o arquivo de configuração atualizado:

mongod --config /path/to/mongodb/mongod.conf

Se mongod estiver configurado para ser executado como um serviço do sistema, inicie-o usando o processo recomendado para o gerenciador de serviços do sistema.

Após o mongod iniciar, conecte-se a ele utilizando a shell mongo.

Inicie o novo conjunto de réplicas.

Inicie o conjunto de réplicas utilizando rs.initiate() com as configurações padrão.

rs.initiate()

Quando a operação for concluída, use rs.status() para verificar se o membro se tornou o principal.

Adicione mais nós de conjuntos de réplicas.

Para cada nó do conjunto de réplicas no CSRS, inicie o mongod em sua máquina host. Depois de iniciar todos os nós restantes do cluster, conecte um shell mongo ao nó primary do conjunto de réplicas. A partir do primary, utilize o método rs.add() para adicionar cada nó do conjunto de réplicas. Inclua o nome do conjunto de réplicas como prefixo, seguido pelo nome do host e pela porta do processo mongod do nó:

rs.add("config2.example.net:27019")
rs.add("config3.example.net:27019")

Se quiser adicionar o membro com definições específicas de configuração de réplica member, você pode passar um documento para rs.add() que defina o nome de host do membro e quaisquer configurações members que seu sistema exija.

rs.add(
 {
   "host" : "config2.example.net:27019",
   priority: <int>,
   votes: <int>,
   tags: <int>
 }
)

Cada novo nó executa uma sincronização inicial para alcançar o primary. Dependendo de fatores como a quantidade de dados a serem sincronizados, a topologia e saúde de sua rede e o poder de cada máquina host, a sincronização inicial pode levar bastante tempo para ser concluída.

O conjunto de réplicas pode eleger um novo primário enquanto você adiciona membros adicionais. Utilize o rs.status() para identificar qual membro é o principal atual. Você só pode executar rs.add() no primário.

Defina todas as configurações adicionais de replicação necessárias.

O método rs.reconfig() atualiza a configuração do conjunto de réplicas baseado em um documento de configuração passado como um parâmetro. Você deve executar reconfig() em relação ao membro principal do conjunto de réplicas.

Consulte a saída do arquivo de configuração original do conjunto de réplicas conforme identificado na etapa A. Review Replica Set Configurations e aplique as configurações conforme necessário.

Restore the shard primary mongod data files.

Selecione a guia que corresponde ao seu método de backup preferido:

Create a temporary user with the __system role.

Durante este procedimento você modificará documentos na coleção admin.system.version . Para clusters que impõem autenticação, somente o papel __system concede permissão para modificar esta coleção. Você poderá pular esta etapa se o cluster não impor a autenticação.

1. Autentique-se como um usuário com a função userAdmin no banco de dados admin ou a função userAdminAnyDatabase:

   use admin
   db.auth("myUserAdmin","mySecurePassword")

2. Crie um usuário com a role __system:

   db.createUser(
     {
       user: "mySystemUser",
       pwd: "<replaceMeWithAStrongPassword>",
       roles: [ "__system" ]
     }
   )

   As senhas devem ser aleatórias, longas e complexas para garantir a segurança do sistema e evitar ou atrasar o acesso malicioso.

3. Autenticar como usuário privilegiado:

   db.auth("mySystemUser","<replaceMeWithAStrongPassword>")

Solte o local banco de banco de dados .

Utilize o db.dropDatabase() para soltar o banco de dados do local:

use local
db.dropDatabase()

Remove the minOpTimeRecovery document from the admin.system.versions collection.

Para atualizar os componentes internos de sharding, execute o seguinte método deleteOne() na coleção system.version do banco de dados admin:

use admin
db.system.version.deleteOne( { _id: "minOpTimeRecovery" } )

Opcional: para qualquer alteração no nome do host CSRS ou no nome do conjunto de réplicas, atualize os metadados do shard no documento de identidade de cada shard.

Você pode pular esta etapa se todos os itens a seguir forem verdadeiros:

• Os nomes de host de qualquer host CSRS não foram alterados durante este procedimento.

• O nome do conjunto de réplicas CSRS não foi alterado durante este procedimento.

A coleção system.version no banco de dados do admin contém metadados relacionados ao shard, incluindo a connection string CSRS. Se o nome do CSRS ou qualquer nome de host do membro for alterado durante a restauração do CSRS, você deverá atualizar esses metadados.

Emita o seguinte método find() na coleção system.version no banco de dados admin:

use admin
db.system.version.find( {"_id" : "shardIdentity" } )

O método find() retorna um documento semelhante ao seguinte:

{
  "_id" : "shardIdentity",
  "clusterId" : ObjectId("2bba123c6eeedcd192b19024"),
  "shardName" : "shard1",
  "configsvrConnectionString" : "myCSRSName/alpha.example.net:27019,beta.example.net:27019,charlie.example.net:27019" }

O seguinte método do updateOne() atualiza o documento de forma que a string do host represente a connection string CSRS mais atual:

db.system.version.updateOne(
  { "_id" : "shardIdentity" },
  { $set :
    { "configsvrConnectionString" : "myNewCSRSName/config1.example.net:27019,config2.example.net:27019,config3.example.net:27019"}
  }
)

Restart the mongod as a new single-node replica set.

Desligue o mongod. Descomente ou adicione as seguintes opções de arquivo de configuração:

replication:
  replSetName: myNewShardName
sharding:
  clusterRole: shardsvr

Se você deseja alterar o nome do conjunto de réplica, você deverá atualizar o campo replSetName com o novo nome antes de continuar.

Inicie o mongod com o arquivo de configuração atualizado:

mongod --config /path/to/mongodb/mongod.conf

Se mongod estiver configurado para ser executado como um serviço do sistema, inicie-o usando o processo recomendado para o gerenciador de serviços do sistema.

Após o mongod iniciar, conecte-se a ele utilizando a shell mongo.

Inicie o novo conjunto de réplicas.

Inicie o conjunto de réplicas utilizando rs.initiate() com as configurações padrão.

rs.initiate()

Quando a operação for concluída, use rs.status() para verificar se o membro se tornou o principal.

Adicione mais nós de conjuntos de réplicas.

Para cada membro do conjunto de réplicas no conjunto de réplicas fragmentadas, inicie o mongod em sua máquina host. Depois de iniciar todos os membros restantes do cluster com sucesso, conecte um shell mongo ao membro primário do conjunto de réplicas. No primário, use o método rs.add() para adicionar cada membro do conjunto de réplicas. Inclua o nome do conjunto de réplicas como prefixo, seguido pelo nome do host e pela porta do processo de mongod do membro:

rs.add("repl2.example.net:27018")
rs.add("repl3.example.net:27018")

Se quiser adicionar o membro com definições específicas de configuração de réplica member, você pode passar um documento para rs.add() que defina o nome de host do membro e quaisquer configurações members que seu sistema exija.

rs.add(
 {
   "host" : "repl2.example.net:27018",
   priority: <int>,
   votes: <int>,
   tags: <int>
 }
)

Cada novo nó executa uma sincronização inicial para alcançar o primary. Dependendo de fatores como a quantidade de dados a serem sincronizados, a topologia e saúde de sua rede e o poder de cada máquina host, a sincronização inicial pode levar bastante tempo para ser concluída.

O conjunto de réplicas pode eleger um novo primário enquanto você adiciona membros adicionais. Utilize o rs.status() para identificar qual membro é o principal atual. Você só pode executar rs.add() no primário.

Defina todas as configurações adicionais de replicação necessárias.

O método rs.reconfig() atualiza a configuração do conjunto de réplicas baseado em um documento de configuração passado como um parâmetro. Você deve executar reconfig() em relação ao membro principal do conjunto de réplicas.

Consulte a saída do arquivo de configuração original do conjunto de réplicas conforme identificado na etapa A. Review Replica Set Configurations e aplique as configurações conforme necessário.

Remova o usuário privilegiado temporário.

Para clusters que aplicam autenticação, remova o usuário privilegiado criado anteriormente neste procedimento:

1. Autentique-se como um usuário com a função userAdmin no banco de dados admin ou a função userAdminAnyDatabase:

   use admin
   db.auth("myUserAdmin","mySecurePassword")

2. Excluir o usuário privilegiado:

   db.removeUser("mySystemUser")