Editar a configuração de um sistema
Nesta página
- A autenticação OAuth 2.0 para acesso programático ao Cloud Manager está disponível como um recurso de visualização.
- O recurso e a documentação correspondente podem mudar a qualquer momento durante o período de Pré-visualização. Para usar a 2.0 autenticação OAuth, crie uma conta de serviço para usar em suas solicitações para a API pública do Cloud Manager .
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 um cluster fragmentado de nível superior ou 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 Cloud 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:
A documentação do driver.
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.
Se você optar por atualizar para o MongoDB 4.2 com "featureCompatibilityVersion" : 4.2
, o Cloud Manager exibirá um modal que solicita que você concorde com a licença especial que a MongoDB, Inc. concede para usar o MongoDB Enterprise para backups.
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 WiredTiger Storage Engine, o Cloud 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 Cloud Manager será encerrado e reiniciará o processo do MongoDB . Para um conjunto de réplicas de vários membros, o Cloud Manager executa uma sincronização inicial contínua de cada membro.
O Cloud 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 Cloud 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 Cloud 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 Cloud 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:
Você pode modificar as seguintes configurações do sistema:
log path
no nível do processo
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 Cloud 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.
Pré-requisitos
Sua implantação deve estar executando uma versão da automação que seja compatível com o Cloud Manager. Se sua implementação não estiver executando uma versão compatível do agente, o Cloud Manager exibirá um banner solicitando que você atualize seus agentes.
Procedimento
Selecione o tipo de sistema que deseja editar:
No MongoDB Cloud Manager, acesse aGo 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 a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é exibida.
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 do host para o qual o Cloud Manager implementa o |
Port | Especifique o número da porta IANA para o processo O |
Version | |
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 Cloud Manager exibirá esse campo se seu sistema executar o MongoDB versão 3.4 ou posterior. |
Log File | Especifique o caminho completo para o arquivo de log Por exemplo, especificar O |
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 Cloud 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.
No MongoDB Cloud Manager, acesse aGo 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 a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é exibida.
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 Cloud Manager exibirá esse campo se seu sistema executar o 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 O Cloud Manager aplica quaisquer configurações definidas para o conjunto de réplicas para todos os seus processos associados. |
Version | |
Log File | Especifique o caminho completo para o arquivo de log Por exemplo, especificar O |
Configure cada membro do conjunto de réplicas.
O Cloud Manager lista cada membro do conjunto de réplicas no 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:
|
Hostname | Selecione no menu o host para o qual o Cloud Manager Automation implementa o membro do conjunto de réplicas. O menu lista somente os hosts em Automação do Cloud Manager. Para obter a documentação completa sobre como adicionar servidores à automação do Cloud 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 O |
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 |
Priority | |
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 |
Build Indexes | Especifique |
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 Para obter a documentação completa sobre as tags de conjuntos de réplicas, consulte Tags de conjuntosde réplicas |
Add a Mongod |
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 Para obter mais informações, consulte Replica Set Protocol Versions. |
Chaining Allowed | Especifique |
Write Concern Majority Journal Default | Determina o comportamento de preocupação de gravação |
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 |
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 |
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 |
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 |
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, |
Force Reconfigure | Especifique que você deseja forçar uma reconfiguração do conjunto de réplicas. Quando definido para 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 . |
No MongoDB Cloud Manager, acesse aGo 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 a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é exibida.
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 Cloud Manager nomeia cada shard no cluster usando o formato |
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 Cloud Manager exibirá esse campo se seu sistema executar o MongoDB versão 3.4 ou posterior. |
Process Name | Nome do host e porta de um O Cloud Manager agrupa Para clusters que executam o MongoDB versão 3.0 ou anterior, o Cloud Manager agrupa os processos |
Version | |
Log File | Especifique o caminho completo para o arquivo de log de log do Por exemplo, especificar O |
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 Cloud 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:
|
Hostname | Selecione no menu o host para o qual o Cloud Manager Automation implementa o membro do conjunto de réplicas. O menu lista somente os hosts em Automação do Cloud Manager. Para obter a documentação completa sobre como adicionar servidores à automação do Cloud 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 O |
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 |
Priority | |
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 |
Build Indexes | Especifique |
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 Para obter a documentação completa sobre as tags de conjuntos de réplicas, consulte Tags de conjuntosde réplicas |
Add a Mongod |
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 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 a automação do Cloud Manager implementa 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 O |
Add a Mongos | Clique para adicionar um processo |