Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Sistemas autogerenciados
/
Implemente e gerencie conjuntos de réplicas autogerenciadas
/
Manter

Renomear um conjunto de réplicas autogerenciadas

Nesta página

  • Pré-requisitos
  • Procedimento

Para renomear um conjunto de réplicas, você deve desligar todos os membros do conjunto de réplicas e, em seguida, configurar o banco de dados local de cada membro com o novo nome do conjunto de réplica.

Este procedimento requer tempo de inatividade.

Pré-requisitos

  • Certifique-se de que seu conjunto de réplicas não esteja fragmentado. O procedimento de renomeação é somente para conjuntos de réplicas não fragmentadas.

  • Antes de renomear um conjunto de réplicas, faça um backup completo do MongoDB deployment.

  • Quando a autenticação estiver ativada, certifique-se de que sua função de usuário tenha privilégios find, insert e remove na coleção system.replset no banco de dados local de cada membro.

    Dica

    Você pode visualizar os privilégios de uma função emitindo o comando rolesInfo com os campos showPrivileges e showBuiltinRoles configurados como true.

Procedimento

1

Encerre os membros do conjunto de réplicas.

Siga o procedimento em Parar um conjunto de réplicas para confirmar que os membros do conjunto de réplicas estão desligados.

Aviso

Esta etapa exige tempo de inatividade, pois todos os membros da réplica precisarão ser desligados.

2

Renomeie o conjunto de réplicas.

Execute as seguintes etapas para cada nó do conjunto de réplicas:

  1. Inicie o membro do conjunto de réplicas em uma porta diferente sem a opção --replSet.

  2. Atualize o nome do conjunto de réplicas.

  3. Conecte ao membro do conjunto de réplicas.

  4. Atualize o nome do conjunto de réplicas no banco de dados local com os seguintes comandos:

    /* Set `newId` to the new replica set name */
    var newId = '<new replica set name>'
    var doc = db.getSiblingDB("local").system.replset.findOne()
    var oldId = doc._id
    doc._id = newId
    db.getSiblingDB("local").system.replset.insertOne(doc)
    db.getSiblingDB("local").system.replset.deleteOne({_id: oldId})

  5. Desligue o membro do conjunto de réplicas.

    Observação

    Ops Manager

    Se você estiver usando o MongoDB Ops Manager, deverá interromper o gerenciamento do conjunto de réplicas pelo MongoDB Ops Manager antes de encerrar o membro do conjunto de réplicas. Para obter mais informações sobre esse procedimento, consulte Remover um processo do Ops Management

  6. Inicie o membro do conjunto de réplicas em sua porta original.

    • Se estiver usando um arquivo de configuração, certifique-se de que replication.replSetName esteja definido com o novo nome do conjunto de réplicas.

    • Se utilizar o comando de inicialização do mongod com a opção --replSet, passe o novo nome do conjunto de réplicas para a opção --replSet.

Voltar

Configurar destino de sincronização