Editar a configuração de um sistema

Nesta página

Considerações

Pré-requisitos
Procedimento

Você pode modificar a configuração e a topologia de um sistema, incluindo suas versões do MongoDB, mecanismos de armazenamento e número de hosts ou shards. Você pode fazer modificações em todos os níveis da topologia de um sistema de umcluster fragmentado de nível superior ou de um conjunto de réplicas para níveis inferiores, como um conjunto de réplicas dentro de um cluster fragmentado ou um processo individual dentro de um conjunto de réplicas. Você também pode modificar processos standalone .

Considerações

Aplicar alterações ao cluster ou membro

Se você fizer alterações de configuração em um processo individual do MongoDB em um cluster, quaisquer alterações futuras no cluster não se aplicarão mais ao processo filho.

Exemplo

Se você desativar o registro no diário de um membro do conjunto de réplicas e, posteriormente, alterar o intervalo de confirmação do diário para o conjunto de réplicas, a alteração não se aplicará ao membro.

Versão do MongoDB

Para escolher quais versões do MongoDB estão disponíveis para o MongoDB Ops Manager, consulte Adicionar uma compilação personalizada do MongoDB .

Verifique os documentos a seguir quanto a considerações ou problemas de compatibilidade antes de alterar a versão do MongoDB de um sistema:
- Notas de versão do MongoDB
  Aviso
  Atualizações do MongoDB 5.0 para 6.0
  Ao atualizar um cluster fragmentado do MongoDB 5.0 para 6.0, você deve usar o procedimento na página Atualizar um cluster fragmentado para 6.0 do Manual do MongoDB para atualizar a tabela de roteamento em cache para cada mongos.
- A documentação do driver.
- Matriz de compatibilidade do MongoDB
Planeje a alteração de versão durante uma janela de manutenção pré-definida.
Altere a versão do MongoDB em um ambiente de preparação antes de alterar um ambiente de produção. O ambiente de preparação deve espelhar o ambiente de produção. Isso pode ajudar a evitar problemas de compatibilidade que podem resultar em tempo de inatividade para seu sistema de produção.
Siga as notas de versão do MongoDB ao executar atualizações manuais de conjuntos de réplicas e clusters fragmentados.

Observação

Limitações de downgrade

Não é possível fazer downgrade de um MongoDB deployment:

Da versão 5.0 para qualquer versão anterior a 4.4.0
Da versão 4.4 para qualquer versão anterior a 4.2.6

Considerações de backup para versões MongoDB

Para saber mais sobre considerações de backup, consulte Considerações de backup.

Mecanismo de armazenamento

Importante

O MongoDB removeu o suporte para o mecanismo de armazenamento MMAPv1 no MongoDB 4.2. Se você editar a configuração do sistema para alterar o mecanismo de armazenamento para o Mecanismo de armazenamentoWiredTiger , o MongoDB Ops Manager reiniciará os processos do MongoDB .

Se você executar ou atualizar para o MongoDB 3.0 ou posterior e modificar o mecanismo de armazenamento do MongoDB , o MongoDB Ops Manager encerrará e reiniciará o processo do MongoDB . Para um conjunto de réplicas de vários membros, o MongoDB Ops Manager executa uma sincronização inicial contínua de cada membro.

O MongoDB Ops Manager cria diretórios de backup durante a migração de um storage engine para outro se o host tiver espaço em disco adequado. Se o espaço em disco for insuficiente, nenhum backup será feito. O MongoDB Ops Manager não exclui os diretórios de backup depois que a migração é concluída. Você pode manter ou excluir os diretórios de backup anteriores. Os diretórios de backup estão localizados no diretório de dados do mongod.

Exemplo

Se a linguagem de definição de dados (DDL) fosse /data/process, o backup seria /data/process.bak.UNIQUENAME. O UNIQUENAME é uma string aleatória que o Ops Manager gera.

Antes de alterar o mecanismo de armazenamento de uma instância autônomo ou de um conjunto de réplicas, você deve conceder acesso de gravação de automação ao diretório principal do diretório de diretório de dados MongoDB . O agente cria um backup temporário dos dados no diretório pai ao atualizar o mecanismo de armazenamento. As alterações do mecanismo de armazenamento em instâncias autônomo também exigem espaço em disco adequado para executar um /mongodump e /mongorestore completos. Esse espaço em disco é então restaurado na instância após a alteração da configuração do mecanismo de armazenamento. O MongoDB Ops Manager não exclui os diretórios de backup.

Você não pode alterar o storage engine em um servidor de configuração. Para obter mais informações sobre os mecanismos de armazenamento e as opções disponíveis, consulte Armazenamento no manual MongoDB.

propriedade fixas

Você não pode modificar as seguintes configurações após a criação de um sistema:

database path
O nome do host, bind_ip ou port para o qual um processo MongoDB é atribuído

Você pode modificar as seguintes configurações do sistema:

log path no nível do processo
Opções avançadas

Topologia de implantação

Você pode fazer modificações em todos os níveis da topologia de um sistema, incluindo processos filho.

Para modificar a topologia ou os processos, use este tutorial ou um dos tutoriais mais específicos:

Modificações no nível do projeto

Algumas modificações que afetam um sistema ocorrem no nível do projeto. As seguintes alterações afetam todos os processos MongoDB no projeto. Para essas alterações, use os tutoriais especificados:

Para habilitar o TLS para o sistema, consulte Habilitar TLS para um sistema.
Para habilitar a autenticação para a implantação, consulte Habilitar autenticação para um projeto do Ops Manager.
Para adicionar ou modificar usuários e roles do MongoDB para a implantação, consulte managed usuários do MongoDB.

Múltiplas modificações

Você pode combinar múltiplas modificações em um sistema.

Exemplo

Você pode fazer todas as seguintes modificações antes de clicar no botão Review Changes :

Adicione a versão estável mais recente do MongoDB a Add a Custom Build.
Habilite o TLS para os processos do MongoDB do sistema.
Adicione um novo cluster fragmentado executando a versão estável mais recente do MongoDB de cima.

Quando você clica em Review Changes, a revisão exibe todas as alterações em uma tela para você confirmar antes de implantar.

Forçar reconfiguração

Somente para conjuntos de réplica e clusters fragmentados

O MongoDB Agent pode forçar um conjunto de réplicas a aceitar uma nova configuração quando você define a configuração de replicação Force Reconfigure como Yes. Forçar apenas uma reconfiguração para recuperar um conjunto de réplicas de um estado em que uma minoria de seus membros esteja disponível.

AVISO: forçar a reconfiguração de um conjunto de réplicas pode levar a uma reversão das gravações comprometidas pela maioria.

Prossiga com cuidado. Entre em contato com o Suporte do MongoDB se tiver dúvidas sobre os possíveis impactos desta operação.

Dica

Veja também:

Reconfigure um conjunto de réplicas com membros indisponíveis no Manual do MongoDB .

Removendo um fragmento

Somente para clusters fragmentados

Quando você remove um fragmento, todos os bancos de dados não compartilhados nesse fragmento são movidos para um fragmento restante usando o comando movePrimary .

Todas as coleções fragmentadas permanecem online e disponíveis durante o processo de remoção de fragmentos. No entanto, as operações de leitura e gravação enviadas para coleções não fragmentadas durante a operação movePrimary podem resultar em um comportamento inesperado, incluindo falha na migração ou perda de dados.

Recomendamos mover o fragmento primário para quaisquer bancos de dados que contenham coleções não compartilhadas antes de remover o fragmento.

Para saber mais sobre como remover fragmentos, consulte Remover fragmentos de um cluster fragmentado existente.

Removendo vários membros do conjunto de réplicas

Você pode remover ou migrar vários membros do conjunto de réplicas de uma só vez, mas a maioria dos membros votantes deve permanecer. Se você precisar remover mais membros votantes, remova-os um de cada vez.

Exemplo

Exemplo 1

Você tem um conjunto de réplicas de quatro nós. Todos os nós são membros votantes. Você pode remover apenas um nó, que preserva a maioria dos três dos quatro nós de votação. Você pode remover outro nó do conjunto de réplicas de três nós restante posteriormente. Isso preserva a maioria dos nós de votação restantes.

Exemplo

Exemplo 2

Você tem um conjunto de réplicas de quatro nós. Três nós são membros votantes e um nó é um membro não votante. Você pode remover um membro votante e um membro não votante ao mesmo tempo. Isso preserva a maioria dos dois dos três nós de votação.

Para saber mais sobre votação, consulte Alta Disponibilidade do Conjunto de Réplicas e Eleições do Conjunto de Réplicas.

Aviso

Atualizações do MongoDB 5.0 para 6.0

Ao atualizar um cluster fragmentado do MongoDB 5.0 para 6.0, você deve usar o procedimento na página Atualizar um cluster fragmentado para 6.0 do Manual do MongoDB para atualizar a tabela de roteamento em cache para cada mongos.

Todas as mudanças são em todo o cluster

As alterações não podem ser feitas em membros individuais de um conjunto de réplicas ou cluster fragmentado, somente em todo o conjunto ou cluster.

O operador do Kubernetes substitui algumas configurações do Ops Manager

Algumas configurações que você define usando Kubernetes Operator não podem ser substituídas no aplicativo MongoDB Ops Manager . Se você alterar uma dessas configurações, o Kubernetes Operator reverterá as configurações sempre que você aplicar a especificação de recursos. As configurações que o operador Kubernetes não gerencia são aceitas.

A lista de configurações a seguir é exclusiva do Kubernetes. Essa lista pode ser alterada posteriormente.

Essas configurações podem ser encontradas na página Configuração de automação .

processes.args2_6.net.port
processes.args2_6.replication.replSetName
processes.args2_6.storage.dbPath
processes.args2_6.systemLog.path
processes.authSchemaVersion
processes.cluster (processos Mongo
processes.featureCompatibilityVersion
processes.hostname
processes.name
processes.version
replicaSets._id
replicaSets.members._id
replicaSets.members.host
replicaSets.members
replicaSets.version
sharding.clusterRole (servidor de configuração)
sharding.configServerReplica
sharding.name
sharding.shards._id
sharding.shards.rs

Exemplo

O Kubernetes Operator cria um conjunto de réplicas de 3 membros.
Você alterou storage.wiredTiger.engineConfig.cacheSizeGB para 40.
Em seguida, você dimensiona o conjunto de réplicas para 5 membros.
O storage.wiredTiger.engineConfig.cacheSizeGB nos novos membros deve ser 40.

Alterações não disponíveis no Kubernetes

Se uma configuração não estiver disponível para um recurso do MongoDB Kubernetes , a alteração deverá ser feita no Aplicativo MongoDB Ops Manager .

Pré-requisitos

Sua implantação deve estar executando uma versão da automação que seja compatível com o Ops Manager. Se sua implantação não estiver executando uma versão compatível do agente, o Ops Manager exibirá um banner solicitando que você atualize seus agentes.

Você deve ter espaço em disco suficiente no diretório pai para executar backups antes de fazer alterações no mecanismo de armazenamento em processos standalone. Recomendamos o uso de conjuntos de réplicas em vez de processos autônomo, que aplicam alterações de forma contínua.

Para atualizar um objeto do MongoDB Kubernetes, você precisa atender aos pré-requisitos e concluir os procedimentos na página Instalar Kubernetes Operator .

Procedimento

Selecione o tipo de sistema que deseja editar:

Navegue até a Deployment página do seu projeto.

Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Deployment na barra lateral.

Na linha que lista o item de implantação, clique Modify em .

Modifique as configurações autônomo.

A seção Standalone Settings contém as seguintes definições de configuração:

Contexto	Descrição
Hostname	Nome de host para o qual o MongoDB Ops Manager implementa o `mongod`. Esse nome de host pode ser um nome de host, um FQDN, um endereço IPv4 ou um endereço IPv6 . Você só pode implantar em hosts sob a automação MongoDB Ops Manager . Para obter a documentação completa sobre como adicionar servidores à automação MongoDB Ops Manager , consulte Provision Servers for Automation.
Port	Especifique o número da porta IANA para o processo `mongod` . Esta configuração corresponde à opção de arquivo de configuração do `net.port` . O padrão é `27017`. O `mongod` deve ter acesso exclusivo à porta especificada. Se estiver implantando vários processos `mongod` em um único host, você deverá selecionar uma porta não utilizada exclusiva para cada processo.
Version	Selecione a versão do servidor MongoDB do processo `mongod`. O Ops Manager lista apenas as versões MongoDB que estão disponíveis para sua implantação. Para desativar esta filtragem, consulte `automation.versions.download.baseUrl.allowOnlyAvailableBuilds`.
Auth Schema Version	Selecione o esquema para armazenar o usuário para armazenar os dados do usuário para seu sistema. Se você estiver atualizando de uma versão do MongoDB anterior a 3.0, O MongoDB 3.0+ usa um esquema diferente para dados do usuário do que as versões anteriores. Para obter informações sobre compatibilidade, consulte as Alterações de Segurança nas notas de versão do MongoDB 3.0 .
Feature Compatibility Version	Selecione a Versão de compatibilidade de recursos do sistema. O MongoDB Ops Manager exibe este campo se sua implantação executar MongoDB versão 3.4 ou posterior.
Log File	Especifique o caminho completo para o arquivo de log `mongod`, incluindo o nome e a extensão do arquivo de log. Esta configuração corresponde à opção de arquivo de configuração do `systemLog.path`. O `mongod` deve ter permissão para ler e gravar no arquivo especificado. Por exemplo, especificar `/var/log/mongodb/mongo.log` direciona o `mongod` para armazenar seu arquivo de log em `/var/log/mongodb/` como `mongo.log`. O `mongod` deve ter seu próprio arquivo de log exclusivo. Se estiver implantando vários processos `mongod` no mesmo host, certifique-se de que cada `mongod` tenha seu próprio arquivo de log distinto.

Modificar opções de configuração avançadas.

A seção Advanced Configuration Options permite a você configurar opções de tempo de execução do MongoDB para cada processo do MongoDB em seu sistema.

Para adicionar uma opção:

Clique em Add Option.
Clique em Select a Startup Option e selecione a opção de configuração.
O Ops Manager exibe uma entrada sensível ao contexto para configurar um valor aceitável para a opção selecionada.
Clique em Add para adicionar a opção selecionada e seu valor correspondente ao processo.

Para descrições do Advanced Configuration Options disponível, consulte Opções avançadas para sistemas MongoDB.

Clique em Save.

O Ops Manager redireciona-o para a página Deployment , onde você deve revisar suas alterações antes de distribuir a configuração atualizada.

Clique Review & Deploy em para rever as suas alterações.

Clique Confirm & Deploy em para implantar suas alterações.

Caso contrário, clique em Cancel e você poderá fazer alterações adicionais.

Navegue até a Deployment página do seu projeto.

Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Deployment na barra lateral.

Na linha que lista o item de implantação, clique Modify em .

Modificar configurações de todo o cluster.

A seção Replica Set Configuration contém as seguintes definições de configuração em todo o agrupamento.

Contexto	Descrição
Auth Schema Version	Selecione o esquema para armazenar o usuário para armazenar os dados do usuário para seu sistema. Se você estiver atualizando de uma versão do MongoDB anterior a 3.0, O MongoDB 3.0+ usa um esquema diferente para dados do usuário do que as versões anteriores. Para obter informações sobre compatibilidade, consulte as Alterações de Segurança nas notas de versão do MongoDB 3.0 .
Feature Compatibility Version	Selecione a Versão de compatibilidade de recursos do sistema. O MongoDB Ops Manager exibe este campo se sua implantação executar MongoDB versão 3.4 ou posterior.
Replica Set Settings	Exibe uma tabela de cada processo associado ao conjunto de réplicas. Você pode configurar a versão do servidor MongoDB, o diretório de dados e o caminho de log de cada processo.
Process Name	Nome do host e porta de um processo `mongod` . Esse nome de host pode ser um nome de host, um FQDN, um endereço IPv4 ou um endereço IPv6 . MongoDB Ops Manager agrupa inicialmente cada processo sob o nome do conjunto de réplica . Clique em à esquerda do nome do conjunto de réplicas para exibir todos os processos do `mongod` no conjunto de réplicas. O Ops Manager aplica quaisquer configurações definidas para o conjunto de réplicas para todos os seus processos associados.
Version	Selecione a versão do servidor MongoDB do processo `mongod`. O Ops Manager lista apenas as versões MongoDB que estão disponíveis para sua implantação. Para desativar esta filtragem, consulte `automation.versions.download.baseUrl.allowOnlyAvailableBuilds`.
Log File	Especifique o caminho completo para o arquivo de log `mongod`, incluindo o nome e a extensão do arquivo de log. Esta configuração corresponde à opção de arquivo de configuração do `systemLog.path`. O `mongod` deve ter permissão para ler e gravar no arquivo especificado. Por exemplo, especificar `/var/log/mongodb/mongo.log` direciona o `mongod` para armazenar seu arquivo de log em `/var/log/mongodb/` como `mongo.log`. O `mongod` deve ter seu próprio arquivo de log exclusivo. Se estiver implantando vários processos `mongod` no mesmo host, certifique-se de que cada `mongod` tenha seu próprio arquivo de log distinto.

Configure cada membro do conjunto de réplicas.

MongoDB Ops Manager lista cada membro do conjunto de réplicas sob o cabeçalho MongoD Settings da seção Member Configuration. Cada membro do conjunto de réplicas possui as seguintes opções configuráveis:

Contexto	Descrição
Member	Selecione uma das seguintes roles do nó do conjunto de réplicas no menu: `Default` Um membro portador de dados do set que pode se tornar o primário e votar nas eleições. Árbitro Um nó não portador de dados do conjunto de réplicas que pode votar nas eleições. Corresponde à opção de configuração de réplica do `arbiterOnly`. Oculto Um nó portador de dados do conjunto de réplicas que pode votar nas eleições. Corresponde à opção de configuração de réplica do `hidden`. Atrasado oculto Um membro portador de dados do conjunto de réplicas que pode votar nas eleições. Corresponde às opções de configuração de réplica `secondaryDelaySecs` e `hidden`.
Hostname	Selecione no menu o host para o qual o Ops Manager Automation implementa o membro do conjunto de réplicas. O menu lista somente os hosts em Automação do Ops Manager. Para obter a documentação completa sobre como adicionar servidores à automação do Ops Manager, consulte Provisionar servidores para automação. Este nome de host pode ser um nome de host, um FQDN, um endereço IPv4 ou um endereço IPv6.
Port	Especifique o número da porta IANA para o processo `mongod` . Esta configuração corresponde à opção de arquivo de configuração do `net.port` . O padrão é `27017`. O `mongod` deve ter acesso exclusivo à porta especificada. Se estiver implantando vários processos `mongod` em um único host, você deverá selecionar uma porta não utilizada exclusiva para cada processo.
Votes	Especifique o número de votos que o membro do conjunto de réplicas tem durante as eleições. Essa configuração corresponde à opção de configuração do conjunto de réplicas `votes` `mongod`.
Priority	Especifique a prioridade do membro durante as eleições. Os membros do conjunto de réplicas com prioridade `0` não podem se tornar os primários e não podem acionar eleições. Essa configuração corresponde à opção de configuração do conjunto de réplicas `priority` `mongod`.
Delay	Especifique o número de segundos "atrás" do nó primário que esse nó deve "atrasar". Essa configuração corresponde à opção de configuração do conjunto de réplicas `secondaryDelaySecs` `mongod` .
Build Indexes	Especifique `true` para direcionar o `mongod` para criar índices. Essa configuração corresponde à opção de configuração `buildIndexes` `mongod` do conjunto de réplicas.
Tags	Especifique a tag ou tags associadas ao conjunto de réplicas. Essa configuração corresponde à opção de configuração do conjunto de réplicas `tags` `mongod`. Para obter a documentação completa sobre as tags de conjuntos de réplicas, consulte Tags de conjuntosde réplicas
Add a Mongod	Adiciona um processo `mongod` a mais como membro do conjunto de réplicas. Adicionar um novo processo `mongod` também atualiza a lista de processos na seção Replica Set Configuration. Você deve configurar o Version, Data Directory e Log File do novo processo.

Defina suas configurações de replicação.

A seção Replication Settings contém as seguintes opções de configuração para o conjunto de réplicas:

Contexto	Descrição
Protocol Version	Selecione a versão do protocolo de replicação usada pelo conjunto de réplicas. Esta configuração corresponde à opção de configuração do conjunto de réplicas do `protocolVersion` . Para obter mais informações, consulte Replica Set Protocol Versions.
Chaining Allowed	Especifique `true` para permitir que nós secundários repliquem a partir de outros nós secundários. Essa configuração corresponde à opção de configuração do conjunto de réplicas `chainingAllowed`.
Write Concern Majority Journal Default	Determina o comportamento de preocupação de gravação `{w:"majority"}` se a preocupação de gravação não especificar explicitamente a opção de registro no diário `j`. Esta configuração corresponde à opção de configuração do conjunto de réplicas do `writeConcernMajorityJournalDefault`.
Heartbeat Timeout (secs)	Especifique o número de segundos em que os membros do conjunto de réplicas aguardam um heartbeat bem-sucedido um do outro. Esta configuração corresponde à opção de configuração do conjunto de réplicas `heartbeatTimeoutSecs`.
Election Timeout (ms)	Especifique o limite de tempo, em milésimos de segundo, para detectar quando o primário de um conjunto de réplicas não pode ser acessado. Essa configuração corresponde à opção de configuração do conjunto de réplicas `electionTimeoutMillis`.
CatchUp Timeout (ms)	Especifique o limite de tempo, em milésimos de segundo, para que um primário recém-eleito sincronize ou se atualize com os outros nós do conjunto de réplicas que possam ter gravações mais recentes. Essa configuração corresponde à opção de configuração do conjunto de réplicas `catchUpTimeoutMillis`.
CatchUp Takeover Delay (ms)	Especifique o tempo em milissegundos que um nó espera para iniciar um catchup takeover após determinar que está à frente do primário atual. Esta configuração corresponde à opção de configuração do conjunto de réplicas do `catchUpTakeoverDelayMillis`.
Last Error Defaults	Especifique a preocupação de gravação padrão para o conjunto de réplicas. O conjunto de réplicas utiliza esta preocupação de gravação somente quando as operações de gravação ou getLastError não especificam outra preocupação de gravação. Se esta opção não estiver definida, a preocupação de gravação padrão para o conjunto de réplicas exigirá apenas a confirmação do primário. Especifique esta opção na forma de um documento, ou seja, `{"w":2}`.
Force Reconfigure	Especifique que você deseja forçar uma reconfiguração do conjunto de réplicas. Quando definido para `Yes`, o Agente MongoDB força o conjunto de réplicas a aceitar uma nova configuração, mesmo que a maioria dos membros não esteja disponível. AVISO: forçar a reconfiguração de um conjunto de réplicas pode levar a uma reversão das gravações comprometidas pela maioria. Prossiga com cuidado. Entre em contato com o Suporte do MongoDB se tiver dúvidas sobre os possíveis impactos desta operação. Para saber mais, consulte Reconfigurar um conjunto de réplicas com membros indisponíveis no Manual do MongoDB Server .

Modificar opções de configuração avançadas.

A seção Advanced Configuration Options permite a você configurar opções de tempo de execução do MongoDB para cada processo do MongoDB em seu sistema.

Para adicionar uma opção:

Clique em Add Advanced Options.
Clique em Select a Startup Option e selecione a opção de configuração.
O Ops Manager exibe uma entrada sensível ao contexto para configurar um valor aceitável para a opção selecionada.
Clique em Add para adicionar a opção selecionada e seu valor correspondente a cada processo do tipo de processo selecionado no agrupamento.

O Ops Manager lista cada processo no cluster agrupado logicamente. Clique na seta cinza à esquerda do agrupamento lógico para exibir seus subgrupos e processos. Você pode modificar as opções avançadas para cada processo individualmente, conforme necessário.

Para descrições do Advanced Configuration Options disponível, consulte Opções avançadas para sistemas MongoDB.

Clique em Save.

O MongoDB Ops Manager redireciona você para a página de implantação, onde você deve revisar suas alterações antes de implantar a configuração atualizada.

Clique Review & Deploy em para rever as suas alterações.

Clique Confirm & Deploy em para implantar suas alterações.

Caso contrário, clique em Cancel e você poderá fazer alterações adicionais.

O MongoDB Ops Manager exibe a seguinte mensagem se você tentar forçar a reconfiguração de um conjunto de réplicas.

Diagrama que |mms| é exibida quando você tenta forçar a reconfiguração de um conjunto de réplicas.

clique para ampliar

Antes de clicar em Confirm & Deploy, certifique-se de que você entende os riscos de forçar a reconfiguração de um conjunto de réplicas.

Dica

Veja também:

Reconfigure um conjunto de réplicas com membros indisponíveis no Manual do MongoDB ....

Navegue até a Deployment página do seu projeto.

Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Deployment na barra lateral.

Na linha que lista o item de implantação, clique Modify em .

Definir configurações em todo o cluster.

A seção Cluster Configuration contém as seguintes definições de configuração em todo o agrupamento.

Contexto	Descrição
Shard Name Prefix	Especifique o prefixo de cada fragmento no cluster. O MongoDB Ops Manager nomeia cada shard no cluster usando o formato `<prefix_n>`, em que `n` é um número inteiro indexado em 0que aumenta monotonicamente.
Auth Schema Version	Selecione o esquema para armazenar o usuário para armazenar os dados do usuário para seu sistema. Se você estiver atualizando de uma versão do MongoDB anterior a 3.0, O MongoDB 3.0+ usa um esquema diferente para dados do usuário do que as versões anteriores. Para obter informações sobre compatibilidade, consulte as Alterações de Segurança nas notas de versão do MongoDB 3.0 .
Feature Compatibility Version	Selecione a Versão de compatibilidade de recursos do sistema. O MongoDB Ops Manager exibe este campo se sua implantação executar MongoDB versão 3.4 ou posterior.
Process Name	Nome do host e porta de um `mongod` ou `mongos` associado ao cluster fragmentado. Esse nome de host pode ser um nome de host, um FQDN, um endereço IPv4 ou um endereço IPv6 . MongoDB Ops Manager agrupa processos `mongod` sob o nome do conjunto de réplicas pai e `mongos` processos sob mongoses. Em seguida, o MongoDB Ops Manager agrupa todos os componentes do cluster sob o nome do cluster. Clique em à esquerda de um agrupamento para listar seus subgrupos ou processos. A modificação de qualquer uma das configurações disponíveis para um agrupamento altera o valor correspondente em seus subgrupos e processos. Para clusters que executam o MongoDB 3.0 ou anterior, o MongoDB Ops Manager agrupa os processos do servidor de configuração `mongod` em configServers.
Version	Selecionar a versão do servidor MongoDB do processo `mongod` ou `mongos`. O Ops Manager lista apenas as versões MongoDB que estão disponíveis para sua implantação. Para desativar esta filtragem, consulte `automation.versions.download.baseUrl.allowOnlyAvailableBuilds`.
Log File	Especifique o caminho completo para o arquivo de log de log do `mongod` ou `mongos` , incluindo o nome e extensão do arquivo de log . Esta configuração corresponde à opção de arquivo de configuração do `systemLog.path` . O `mongod` ou `mongos` deve ter permissão para ler e escrever no arquivo especificado. Por exemplo, especificar `/var/log/mongodb/mongo.log` direciona `mongod` ou `mongos` para armazenar seu arquivo de log em `/var/log/mongodb/` como `mongo.log`. O `mongod` ou `mongos` deve ter seu próprio arquivo de log exclusivo. Se estiver implantando vários processos `mongod` ou `mongos` no mesmo host, certifique-se de que cada `mongod` ou `mongos` tenha seu próprio arquivo de log distinto.

Configure cada fragmento em seu cluster.

Na seção Member Configuration , clique em Shard Settings para abrir as opções de configuração de shard . O MongoDB Ops Manager lista cada shard no cluster e os processos mongod associados a esse shard. Cada processo de shard tem as seguintes opções. Você não pode modificar opções que estão esmaecidas:

Contexto	Descrição
Member	Selecione uma das seguintes roles do nó do conjunto de réplicas no menu: `Default` Um membro portador de dados do set que pode se tornar o primário e votar nas eleições. Árbitro Um nó não portador de dados do conjunto de réplicas que pode votar nas eleições. Corresponde à opção de configuração de réplica do `arbiterOnly`. Oculto Um nó portador de dados do conjunto de réplicas que pode votar nas eleições. Corresponde à opção de configuração de réplica do `hidden`. Atrasado oculto Um membro portador de dados do conjunto de réplicas que pode votar nas eleições. Corresponde às opções de configuração de réplica `secondaryDelaySecs` e `hidden`.
Hostname	Selecione no menu o host para o qual o Ops Manager Automation implementa o membro do conjunto de réplicas. O menu lista somente os hosts em Automação do Ops Manager. Para obter a documentação completa sobre como adicionar servidores à automação do Ops Manager, consulte Provisionar servidores para automação. Este nome de host pode ser um nome de host, um FQDN, um endereço IPv4 ou um endereço IPv6.
Port	Especifique o número da porta IANA para o processo `mongod` . Esta configuração corresponde à opção de arquivo de configuração do `net.port` . O padrão é `27017`. O `mongod` deve ter acesso exclusivo à porta especificada. Se estiver implantando vários processos `mongod` em um único host, você deverá selecionar uma porta não utilizada exclusiva para cada processo.
Votes	Especifique o número de votos que o membro do conjunto de réplicas tem durante as eleições. Essa configuração corresponde à opção de configuração do conjunto de réplicas `votes` `mongod`.
Priority	Especifique a prioridade do membro durante as eleições. Os membros do conjunto de réplicas com prioridade `0` não podem se tornar os primários e não podem acionar eleições. Essa configuração corresponde à opção de configuração do conjunto de réplicas `priority` `mongod`.
Delay	Especifique o número de segundos "atrás" do nó primário que esse nó deve "atrasar". Essa configuração corresponde à opção de configuração do conjunto de réplicas `secondaryDelaySecs` `mongod` .
Build Indexes	Especifique `true` para direcionar o `mongod` para criar índices. Essa configuração corresponde à opção de configuração `buildIndexes` `mongod` do conjunto de réplicas.
Tags	Especifique a tag ou tags associadas ao conjunto de réplicas. Essa configuração corresponde à opção de configuração do conjunto de réplicas `tags` `mongod`. Para obter a documentação completa sobre as tags de conjuntos de réplicas, consulte Tags de conjuntosde réplicas
Add a Mongod	Adiciona um processo `mongod` a mais como membro do conjunto de réplicas. Adicionar um novo processo `mongod` também atualiza a lista de processos na seção Replica Set Configuration. Você deve configurar o Version, Data Directory e Log File do novo processo.

Para adicionar fragmentos adicionais ao cluster:

Clique em Add a Shard.
Na seção Cluster Configuration, defina os seguintes parâmetros para cada mongod no fragmento:
- Version
- Data Directory
- Log File

Configure cada servidor de configuração no seu cluster.

No menu suspenso, escolha entre Dedicated e Embedded tipos de servidor de configuração. Clusters de fragmentos maiores que 3 devem usar o tipo Dedicated .

O Ops Manager exibe um cabeçalho diferente para as configurações do servidor de configuração, dependendo da versão do MongoDB selecionada para os servidores de configuração.

MongoDB 3.2 ou posterior:

Na seção Member Configuration , clique em Config Server Replica Set Settings para abrir as opções de configuração do CSRS. Cada nó do conjunto de réplicas do servidor de configuração de configuração possui as seguintes opções:

Contexto	Descrição
Member	Selecione uma das seguintes roles do nó do conjunto de réplicas no menu: `Default` Um membro portador de dados do set que pode se tornar o primário e votar nas eleições. Árbitro Um nó não portador de dados do conjunto de réplicas que pode votar nas eleições. Corresponde à opção de configuração de réplica do `arbiterOnly`. Oculto Um nó portador de dados do conjunto de réplicas que pode votar nas eleições. Corresponde à opção de configuração de réplica do `hidden`. Atrasado oculto Um membro portador de dados do conjunto de réplicas que pode votar nas eleições. Corresponde às opções de configuração de réplica `secondaryDelaySecs` e `hidden`.
Hostname	Selecione no menu o host para o qual o Ops Manager Automation implementa o membro do conjunto de réplicas. O menu lista somente os hosts em Automação do Ops Manager. Para obter a documentação completa sobre como adicionar servidores à automação do Ops Manager, consulte Provisionar servidores para automação. Este nome de host pode ser um nome de host, um FQDN, um endereço IPv4 ou um endereço IPv6.
Port	Especifique o número da porta IANA para o processo `mongod` . Esta configuração corresponde à opção de arquivo de configuração do `net.port` . O padrão é `27017`. O `mongod` deve ter acesso exclusivo à porta especificada. Se estiver implantando vários processos `mongod` em um único host, você deverá selecionar uma porta não utilizada exclusiva para cada processo.
Votes	Especifique o número de votos que o membro do conjunto de réplicas tem durante as eleições. Essa configuração corresponde à opção de configuração do conjunto de réplicas `votes` `mongod`.
Priority	Especifique a prioridade do membro durante as eleições. Os membros do conjunto de réplicas com prioridade `0` não podem se tornar os primários e não podem acionar eleições. Essa configuração corresponde à opção de configuração do conjunto de réplicas `priority` `mongod`.
Delay	Especifique o número de segundos "atrás" do nó primário que esse nó deve "atrasar". Essa configuração corresponde à opção de configuração do conjunto de réplicas `secondaryDelaySecs` `mongod` .
Build Indexes	Especifique `true` para direcionar o `mongod` para criar índices. Essa configuração corresponde à opção de configuração `buildIndexes` `mongod` do conjunto de réplicas.
Tags	Especifique a tag ou tags associadas ao conjunto de réplicas. Essa configuração corresponde à opção de configuração do conjunto de réplicas `tags` `mongod`. Para obter a documentação completa sobre as tags de conjuntos de réplicas, consulte Tags de conjuntosde réplicas
Add a Mongod	Adiciona um processo `mongod` a mais como membro do conjunto de réplicas. Adicionar um novo processo `mongod` também atualiza a lista de processos na seção Cluster Configuration. Você deve configurar o Version, Data Directory e Log File do novo processo.

MongoDB 3.0 ou anterior

Na seção Member Configuration, clique em Config Server Settings para abrir as opções do servidor de configuração. Cada servidor de configuração possui as seguintes opções:

Contexto

Descrição

Hostname

Selecione no menu o host para o qual o Ops Manager Automation implementa o membro do conjunto de réplicas. O menu lista somente os hosts em Automação do Ops Manager. Para obter a documentação completa sobre como adicionar servidores à automação do Ops Manager, consulte Provisionar servidores para automação.

Este nome de host pode ser um nome de host, um FQDN, um endereço IPv4 ou um endereço IPv6.

Port

Especifique o número da porta IANA para o processo mongod . Esta configuração corresponde à opção de arquivo de configuração do net.port . O padrão é 27017.

O mongod deve ter acesso exclusivo à porta especificada. Se estiver implantando vários processos mongod em um único host, você deverá selecionar uma porta não utilizada exclusiva para cada processo.

Configure cada no `mongos` seu cluster.

Na seção Member Configuration , clique em Mongos Settings para abrir as opções de configuração do mongos . Cada processo do mongos tem as seguintes opções. Você não pode modificar opções que estão esmaecidas:

Contexto	Descrição
Hostname	Selecione no menu o host para o qual o MongoDB Ops Manager Automation implementa o `mongos`. O menu lista somente os hosts em Automação MongoDB Ops Manager . Para obter a documentação completa sobre como adicionar servidores à automação MongoDB Ops Manager , consulte Provision Servers for Automation. Este nome de host pode ser um nome de host, um FQDN, um endereço IPv4 ou um endereço IPv6.
Port	Especifique o número da porta IANA para o processo `mongos` . Esta configuração corresponde à opção de arquivo de configuração do `net.port` . O padrão é `27017`. O `mongos` deve ter acesso exclusivo à porta especificada. Se estiver implantando vários processos `mongos` em um único host, você deverá selecionar uma porta não utilizada exclusiva para cada processo.
Add a Mongos	Clique para adicionar um processo `mongos` a mais.

Configure cada conjunto de réplicas no seu cluster.

A seção Replication Settings contém as seguintes opções de configuração para cada conjunto de réplicas no cluster:

Contexto	Descrição
Protocol Version	Selecione a versão do protocolo de replicação usada pelo conjunto de réplicas. Esta configuração corresponde à opção de configuração do conjunto de réplicas do `protocolVersion` . Para obter mais informações, consulte Replica Set Protocol Versions.
Chaining Allowed	Especifique `true` para permitir que nós secundários repliquem a partir de outros nós secundários. Essa configuração corresponde à opção de configuração do conjunto de réplicas `chainingAllowed`.
Write Concern Majority Journal Default	Determina o comportamento de preocupação de gravação `{w:"majority"}` se a preocupação de gravação não especificar explicitamente a opção de registro no diário `j`. Esta configuração corresponde à opção de configuração do conjunto de réplicas do `writeConcernMajorityJournalDefault`.
Heartbeat Timeout (secs)	Especifique o número de segundos em que os membros do conjunto de réplicas aguardam um heartbeat bem-sucedido um do outro. Esta configuração corresponde à opção de configuração do conjunto de réplicas `heartbeatTimeoutSecs`.
Election Timeout (ms)	Especifique o limite de tempo, em milésimos de segundo, para detectar quando o primário de um conjunto de réplicas não pode ser acessado. Essa configuração corresponde à opção de configuração do conjunto de réplicas `electionTimeoutMillis`.
CatchUp Timeout (ms)	Especifique o limite de tempo, em milésimos de segundo, para que um primário recém-eleito sincronize ou se atualize com os outros nós do conjunto de réplicas que possam ter gravações mais recentes. Essa configuração corresponde à opção de configuração do conjunto de réplicas `catchUpTimeoutMillis`.
CatchUp Takeover Delay (ms)	Especifique o tempo em milissegundos que um nó espera para iniciar um catchup takeover após determinar que está à frente do primário atual. Esta configuração corresponde à opção de configuração do conjunto de réplicas do `catchUpTakeoverDelayMillis`.
Last Error Defaults	Especifique a preocupação de gravação padrão para o conjunto de réplicas. O conjunto de réplicas utiliza esta preocupação de gravação somente quando as operações de gravação ou getLastError não especificam outra preocupação de gravação. Se esta opção não estiver definida, a preocupação de gravação padrão para o conjunto de réplicas exigirá apenas a confirmação do primário. Especifique esta opção na forma de um documento, ou seja, `{"w":2}`.
Force Reconfigure	Especifique que você deseja forçar uma reconfiguração do conjunto de réplicas. Quando definido para `Yes`, o Agente MongoDB força o conjunto de réplicas a aceitar uma nova configuração, mesmo que a maioria dos membros não esteja disponível. AVISO: forçar a reconfiguração de um conjunto de réplicas pode levar a uma reversão das gravações comprometidas pela maioria. Prossiga com cuidado. Entre em contato com o Suporte do MongoDB se tiver dúvidas sobre os possíveis impactos desta operação. Para saber mais, consulte Reconfigurar um conjunto de réplicas com membros indisponíveis no Manual do MongoDB Server .

Modificar opções de configuração avançadas.

A seção Advanced Configuration Options permite a você configurar opções de tempo de execução do MongoDB para cada processo do MongoDB em seu sistema.

Para adicionar uma opção:

Clique em Add Advanced Options.
Clique em Select a Startup Option e selecione a opção de configuração.
O Ops Manager exibe uma entrada sensível ao contexto para configurar um valor aceitável para a opção selecionada.
Clique em Add para adicionar a opção selecionada e seu valor correspondente a cada processo do tipo de processo selecionado no agrupamento.

Para descrições do Advanced Configuration Options disponível, consulte Opções avançadas para sistemas MongoDB.

Clique em Save.

O MongoDB Ops Manager redireciona você para a página de implantação, onde você deve revisar suas alterações antes de implantar a configuração atualizada.

Clique Review & Deploy em para rever as suas alterações.

Clique Confirm & Deploy em para implantar suas alterações.

Caso contrário, clique em Cancel e você poderá fazer alterações adicionais.

Edite o arquivo de especificação de recurso do Kubernetes.
Modifique ou adicione quaisquer configurações que você precise adicionar ou alterar.
Salve seu arquivo de especificação.
Invoque o seguinte comando do Kubernetes para atualizar seu recurso.
```
kubectl apply -f <standalone-conf>.yaml
```

Voltar

Preparar-se para a manutenção

Gerenciar BI Connector

Considerações

Aplicar alterações ao cluster ou membro

Exemplo

Versão do MongoDB

Aviso

Atualizações do MongoDB 5.0 para 6.0

Observação

Limitações de downgrade

Considerações de backup para versões MongoDB

Mecanismo de armazenamento

Importante

Exemplo

propriedade fixas

Topologia de implantação

Modificações no nível do projeto

Múltiplas modificações

Exemplo

Forçar reconfiguração

Dica

Veja também:

Removendo um fragmento

Removendo vários membros do conjunto de réplicas

Exemplo

Exemplo 1

Exemplo

Exemplo 2

Aviso

Atualizações do MongoDB 5.0 para 6.0

Todas as mudanças são em todo o cluster

O operador do Kubernetes substitui algumas configurações do Ops Manager

Exemplo

Alterações não disponíveis no Kubernetes

Pré-requisitos

Procedimento

Navegue até a Deployment página do seu projeto.

Na linha que lista o item de implantação, clique Modify em .

Modifique as configurações autônomo.

Modificar opções de configuração avançadas.

Clique em Save.

Clique Review & Deploy em para rever as suas alterações.

Clique Confirm & Deploy em para implantar suas alterações.

Navegue até a Deployment página do seu projeto.

Na linha que lista o item de implantação, clique Modify em .

Modificar configurações de todo o cluster.

Configure cada membro do conjunto de réplicas.

Defina suas configurações de replicação.

Modificar opções de configuração avançadas.

Clique em Save.

Clique Review & Deploy em para rever as suas alterações.

Clique Confirm & Deploy em para implantar suas alterações.

Dica

Veja também:

Navegue até a Deployment página do seu projeto.

Na linha que lista o item de implantação, clique Modify em .

Definir configurações em todo o cluster.

Configure cada fragmento em seu cluster.

Configure cada servidor de configuração no seu cluster.

Configure cada no mongos seu cluster.

Configure cada conjunto de réplicas no seu cluster.

Modificar opções de configuração avançadas.

Clique em Save.

Clique Review & Deploy em para rever as suas alterações.

Clique Confirm & Deploy em para implantar suas alterações.

Configure cada no `mongos` seu cluster.