Atualização do agente de monitoramento legado

O Cloud Manager não oferecerá mais suporte para Automação, Backup e Monitoramento do MongoDB 3.6 e 4.0 após 30 de agosto de 2024. Faça upgrade da sua versão do MongoDB ou migre para o Atlas.

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ê tem um projeto com sistemas monitoradas do MongoDB que a automação não managed e deseja atualizar para o MongoDB Agent.

Observação

Revise os pré-requisitos primeiro

Se você quiser iniciar ou continuar usando Automation para managed suas implementações do MongoDB, revise os pré- requisitos do MongoDB Agent antes de atualizar para o MongoDB Agent.

Procedimento

Use este procedimento para atualizar para o MongoDB Agent na arquitetura x86_64 executando o Microsoft Windows:

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Se a automação não gerenciou seu agente de monitoramento, você pode adicionar as configurações de monitoramento que tinha antes na etapa Add Custom Configuration Options for your MongoDB Agent (Optional) .

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione Windows - MSI.
Clique Next. O modal Install New MongoDB Agent abre.

Instale o MongoDB Agent.

A caixa MongoDB Agent Installation Instructions exibe as seguintes informações:

Project ID (Obrigatório para vinculação a um projeto)
API Key
Se você não tiver uma chave de API, clique em Generate Key (Gerar chave).

Aviso

Alguns ou todos esses valores são necessários em uma etapa posterior. Copie esses valores e armazene-os onde você possa acessá-los mais tarde.

Execute o instalador do Windows do MongoDB Agent.

Após os downloads do MSI , clique duas vezes:
mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi
Observação
O uso de mongodb-mms-automation no nome do arquivo é um artefato legado e não significa que o MongoDB Agent está sendo instalado com a Automação configurada.
Se um aviso de segurança aparecer, clique em Run.
Na etapa Configuration/Log Folder
Forneça o diretório no qual esses arquivos são salvos.
Na etapa Key Type, selecione Agent API Key para vincular a um projetoespecífico.
Insira as chaves apropriadas do agente.
Observação
Estas chaves são fornecidas no modal MongoDB Agent Installation Instructions descrito na etapa anterior.
- Digite seu ID do projeto no campo Project ID.
- Digite sua Chave API do agente no campo Agent API Key.
Na etapa MongoDB Paths, especifique os diretórios Log e Backup
Na etapa Windows Firewall Configuration, clique na configuração de firewall de sua preferência.
Se você clicar Configure firewall rules allowing access from only the specified |ipaddr| addresses. em , digite os endereços IPv IPv4 necessários na caixa fornecida.
(Condicional) O Windows habilita o Modo Invisível para o Firewall do Windows por padrão. Se você não o tiver desabilitado no host do MongoDB no qual está instalando o MongoDB Agent, desative-o agora. O Stealth Mode degrada significativamente o desempenho e a capacidade do MongoDB Agent. Clique Disable Stealth Mode.
(Condicional) O Windows não habilita Contadores de Desempenho de Disco por padrão. Se você não habilitou Contadores de Desempenho de Disco para o host MongoDB , clique em Enable Disk Performance Counters. O MongoDB Agent usa esses contadores para algumas de suas atividades de monitoramento de hardware.
Clique em Install.
Clique em Finish quando a configuração for concluída.

Após os downloads do MSI , você pode executar uma instalação autônoma. Você executa uma instalação autônoma a partir da linha de comando no Prompt de Comando ou no PowerShell. Para saber mais sobre instalações autônomas, consulte a documentação da Microsoft sobre Opções de linha de comando do instalador padrão

Para executar o instalador do MSI sem supervisão a partir da linha de comando, invoque o msiexec.exe com os sinalizadores /q e /i e uma combinação de parâmetros exigidos e opcionais:

Parâmetro	necessidade	Valor
`MMSAPIKEY`	Obrigatório	Chave API do agente do seu projeto do Cloud Manager .
`MMSGROUPID`	Obrigatório	Identificador único do seu projeto do Cloud Manager .
`CONFIGLOGDIR`	Opcional	Caminho de arquivo absoluto para o qual o Cloud Manager deve gravar o arquivo de configuração do MongoDB Agent .
`LOGFILE`	Opcional	Caminho de arquivo absoluto para o qual o Cloud Manager deve escrever o log do MongoDB Agent
`MMSCONFIGBACKUP`	Opcional	Caminho de arquivo absoluto para o arquivo JSON de backup de configuração de automação do Cloud Manager .

Exemplo

Para instalar o MongoDB Agent sem supervisão, invoque msiexec.exe com as seguintes opções:

msiexec.exe /q /i "C:\PATH\TO\mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi" MMSGROUPID=<GROUP.ID> MMSAPIKEY=<AGENT.API.ID> MMSBASEURL="<http://opsmanager.example.com:8080>" LOGFILE="C:\MMSData\Server\Log\automation-agent.log" MMSCONFIGBACKUP="C:\MMSData\MongoDB\mms-cluster-config-backup.json"

Conclua a instalação do MongoDB Agent. No modal Install Agent Instructions, clique em Done.

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

(Opcional) Altere o local dos binários do MongoDB Agent e dos arquivos de backup de configuração.

As políticas ou práticas do sistema podem exigir que os binários do MongoDB e o arquivo de backup de configuração do Cloud Manager estejam em algum lugar diferente do local padrão do %SystemDrive%\MMSMongoDB\versions.

Observação

O Windows define a variável de ambiente %SystemDrive% para a unidade na qual você instalou o Windows. Por padrão, você é direcionado a instalar o Windows na unidade C: . Para encontrar seu %SystemDrive%, problema com o seguinte comando do PowerShell:

get-childitem env:SystemDrive

Se você quiser armazenar esses arquivos em um diretório diferente, siga estes procedimentos:

Como alterar o local dos binários do MongoDB Agent

No MongoDB Cloud Manager, Go a página Deployment do seu projeto.
1. Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
3. Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
  A página Sistema é exibida.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Clique na aba Downloads & Settings.
Abaixo do cabeçalho Download Directory, clique em à direita do caminho mostrado no Download Directory (Windows).
Altere o caminho para o novo caminho que você deseja.
Clique em Save.
Crie o novo diretório que você especificou em cada host que executa um MongoDB Agent. Use o Windows Explorer para mover o arquivo ou emita o seguinte comando em um prompt de comando ou PowerShell:
```
md \<newPath>
```
Importante
Certifique-se de que o usuário do sistema que executa o MongoDB Agent possa gravar nesse novo diretório. Geralmente, esse é o usuário SYSTEM , que não requer nenhuma configuração adicional, a menos que você altere o usuário.

Para alterar o local do backup de configuração do MongoDB Agent

Abra o arquivo de configuração do MongoDB Agent em seu editor de texto preferido.
Altere a configuração mmsConfigBackup para o novo caminho para o arquivo da cópia de segurança da configuração. Substitua X no exemplo a seguir pela letra da unidade na qual sua cópia de segurança está armazenada.
```
mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json
```
Salve o arquivo de configuração do MongoDB Agent.
Mova o arquivo da cópia de segurança de configuração para o novo diretório. Use o Windows Explorer para mover o arquivo ou emita o seguinte comando em um prompt de comando ou PowerShell:
```
move %SystemDrive%\MMSMongoDB\versions\mms-cluster-config-backup.json \<newPath>
```

Repita o procedimento de instalação para cada host MongoDB.

Use este procedimento para atualizar para o MongoDB Agent:

Em arquitetura x86_64 executando Debian 8, Debian 9, Ubuntu 18.04, Ubuntu 20.04 ou Ubuntu 22.04:

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione Debian 8/9, Ubuntu 16.X/18.X - DEB.
Clique Next. O modal Install New MongoDB Agent abre.

Baixe a versão mais recente do MongoDB Agent.

Observação

Começando com esta etapa, siga o modal de instalação do MongoDB Agent e copie os comandos fornecidos no shell do Linux.

Em um shell do sistema no host que executará o MongoDB Agent, emita o seguinte comando curl para baixar o instalador forUbuntu 18.04/20.04/22.04 ou Debian 9/10/11 para 64-bit x86:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.amd64.ubuntu1604.deb

Edite o arquivo de configuração do MongoDB Agent.

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Atualize as seguintes opções de configuração:

Chave	Valor
`mmsGroupId`	`ProjectID` do seu projeto.
`mmsApiKey`	chave de API do agente do seu projeto.

Opcional: configure o MongoDB Agent para usar um servidor proxy.

Para configurar o MongoDB Agent para se conectar ao Cloud Manager por meio de um servidor proxy, você deve especificar o servidor na variável de ambiente httpProxy .

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Adicione a seguinte chave de configuração:

Chave	Valor
`httpProxy`	URL (nome do host e porta) do seu servidor proxy.

Prepare o diretório de dados.

O diretório de dados armazena dados MongoDB. Para um sistema MongoDB existente, garanta que o diretório seja de propriedade do usuário do mongodb. Se não existir nenhuma implantação MongoDB, crie o diretório e defina o proprietário.

Para criar um diretório de dados e definir o proprietário como o usuário do mongodb:

sudo mkdir -p /data; sudo chown mongodb:mongodb /data

Inicie o MongoDB Agent.

Emitir o seguinte comando:

sudo systemctl start mongodb-mms-automation-agent.service

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

Conclua a instalação do MongoDB Agent.

No modal Install Agent Instructions, clique em Done.

Repita o procedimento de instalação para cada host MongoDB.

Na arquitetura zSeries executando o Ubuntu 18.x utilizando um pacote deb :

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione Ubuntu 18.X Z-Series (s390x) - DEB.
Clique Next. O modal Install New MongoDB Agent abre.

Baixe a versão mais recente do MongoDB Agent.

Observação

Começando com esta etapa, siga o modal de instalação do MongoDB Agent e copie os comandos fornecidos no shell do Linux.

Em um shell do sistema no host que executará o MongoDB Agent, emita o seguinte comando curl para baixar o instalador do Ubuntu 18.04 para IBM zSeries:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.ubuntu1804.deb

Edite o arquivo de configuração do MongoDB Agent.

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Atualize as seguintes opções de configuração:

Chave	Valor
`mmsGroupId`	`ProjectID` do seu projeto.
`mmsApiKey`	chave de API do agente do seu projeto.

Opcional: configure o MongoDB Agent para usar um servidor proxy.

Para configurar o MongoDB Agent para se conectar ao Cloud Manager por meio de um servidor proxy, você deve especificar o servidor na variável de ambiente httpProxy .

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Adicione a seguinte chave de configuração:

Chave	Valor
`httpProxy`	URL (nome do host e porta) do seu servidor proxy.

Prepare o diretório de dados.

Para criar um diretório de dados e definir o proprietário como o usuário do mongodb:

sudo mkdir -p /data; sudo chown mongodb:mongodb /data

Inicie o MongoDB Agent.

Emitir o seguinte comando:

sudo systemctl start mongodb-mms-automation-agent.service

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

Conclua a instalação do MongoDB Agent.

No modal Install Agent Instructions, clique em Done.

Repita o procedimento de instalação para cada host MongoDB.

Use este procedimento para atualizar para o MongoDB Agent:

Na arquitetura x86_64 :

Executando RHEL / CentOS 6.x usando um pacote rpm :

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione Amazon Linux - RPM.
Clique Next. O modal Install New MongoDB Agent abre.

Baixe a versão mais recente do MongoDB Agent.

Observação

Começando com esta etapa, siga o modal de instalação do MongoDB Agent e copie os comandos fornecidos no shell do Linux.

Em um shell do sistema no host que executará o MongoDB Agent, emita o seguinte comando curl para baixar o instalador para RHEL 6 para 64-bit x86:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rpm

Edite o arquivo de configuração do MongoDB Agent.

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Atualize as seguintes opções de configuração:

Chave	Valor
`mmsGroupId`	`ProjectID` do seu projeto.
`mmsApiKey`	chave de API do agente do seu projeto.

Opcional: configure o MongoDB Agent para usar um servidor proxy.

Para configurar o MongoDB Agent para se conectar ao Cloud Manager por meio de um servidor proxy, você deve especificar o servidor na variável de ambiente httpProxy .

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Adicione a seguinte chave de configuração:

Chave	Valor
`httpProxy`	URL (nome do host e porta) do seu servidor proxy.

Prepare o diretório de dados.

O diretório de dados armazena dados MongoDB e deve ser de propriedade do usuário mongod . Para um sistema MongoDB existente, certifique-se de que o diretório tenha o usuário mongod como proprietário. Se não existir nenhuma implantação MongoDB , crie o diretório e defina o proprietário.

Os seguintes comandos criam um diretório de dados e definem o proprietário como o usuário mongod :

sudo mkdir /data; sudo chown mongod:mongod /data

Inicie o MongoDB Agent.

Emitir o seguinte comando:

sudo service mongodb-mms-automation-agent start

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

Conclua a instalação do MongoDB Agent.

No modal Install Agent Instructions, clique em Done.

Repita o procedimento de instalação para cada host MongoDB.

Executando RHEL / CentOS 7.x, SUSE12, SUSE15 ou Amazon Linux 2:

Usando um pacote rpm :

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione RHEL/CentOS (7.X), SUSE12, Amazon Linux2 - RPM.
Clique Next. O modal Install New MongoDB Agent abre.

Baixe a versão mais recente do MongoDB Agent.

Observação

Começando com esta etapa, siga o modal de instalação do MongoDB Agent e copie os comandos fornecidos no shell do Linux.

Em um shell do sistema no host que executará o MongoDB Agent, emita o seguinte comando curl para baixar o instalador para RHEL 7 para 64-bit x86:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rhel7.rpm

Edite o arquivo de configuração do MongoDB Agent.

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Atualize as seguintes opções de configuração:

Chave	Valor
`mmsGroupId`	`ProjectID` do seu projeto.
`mmsApiKey`	chave de API do agente do seu projeto.

Opcional: configure o MongoDB Agent para usar um servidor proxy.

Para configurar o MongoDB Agent para se conectar ao Cloud Manager por meio de um servidor proxy, você deve especificar o servidor na variável de ambiente httpProxy .

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Adicione a seguinte chave de configuração:

Chave	Valor
`httpProxy`	URL (nome do host e porta) do seu servidor proxy.

Prepare o diretório de dados.

Os seguintes comandos criam um diretório de dados e definem o proprietário como o usuário mongod :

sudo mkdir /data; sudo chown mongod:mongod /data

Inicie o MongoDB Agent.

Emitir o seguinte comando:

sudo service mongodb-mms-automation-agent start

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

Conclua a instalação do MongoDB Agent.

No modal Install Agent Instructions, clique em Done.

Repita o procedimento de instalação para cada host MongoDB.

Usando um arquivo tar :

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione RHEL/CentOS (7.X), SUSE12, Amazon Linux 2 - TAR.
Clique Next. O modal Install New MongoDB Agent abre.

Baixe a versão mais recente do MongoDB Agent.

Observação

Começando com esta etapa, siga o modal de instalação do MongoDB Agent e copie os comandos fornecidos no arquivo .

Em um shell do sistema no host que executará o MongoDB Agent, emita o seguinte comando curl para baixar o instalador para RHEL para 64-bit x86:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.rhel7_x86_64.tar.gz

Extraia o MongoDB Agent.

Você pode instalar o MongoDB Agent em qualquer diretório. Se você quiser mover o arquivo para outro diretório antes de extrair, você pode fazer isso.

Para instalar o MongoDB Agent, extraia o arquivo:

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64.tar.gz

Mude para o diretório binário extraído.

Altere para o diretório que foi criado após a extração do binário do MongoDB Agent :

cd mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64

Edite o arquivo de configuração do MongoDB Agent.

No diretório onde você instalou o MongoDB Agent, abra o arquivo local.config no editor de texto de sua preferência.

vi <install-path>/local.config

Atualize as seguintes opções de configuração:

Chave	Valor
`mmsGroupId`	`ProjectID` do seu projeto.
`mmsApiKey`	chave de API do agente do seu projeto.

Opcional: configure o MongoDB Agent para usar um servidor proxy.

Para configurar o MongoDB Agent para se conectar ao Cloud Manager por meio de um servidor proxy, você deve especificar o servidor na variável de ambiente httpProxy .

No diretório onde você instalou o MongoDB Agent, abra o arquivo local.config no editor de texto de sua preferência.

vi <install-path>/local.config

Adicione a seguinte chave de configuração:

Chave	Valor
`httpProxy`	URL (nome do host e porta) do seu servidor proxy.

Opcional: Crie os diretórios binário, de log e de dados.

Se você tiver um usuário do agente de monitoramento existente e não planeja ativar a automação, você só precisa criar o diretório de log.

Crie os seguintes diretórios para armazenar os arquivos necessários para o MongoDB Agent .

Observação

O uso de mongodb-mms-automation no caminho do arquivo é um artefato legado e não média que o MongoDB Agent esteja sendo instalado com a Automação configurada.

Componente	Diretório padrão	Descrição
Binários	`/var/lib/mongodb-mms-automation`	Esses são os binários que o MongoDB Agent gerencia. Elas incluem os binários MongoDB Agent, BI Connector e MongoDB .
Registros do Agente do MongoDB	`/var/log/mongodb-mms-automation`	Esses são os arquivos de log que o MongoDB Agent cria.
Bancos de dados MongoDB	`/data`	Esses são os bancos de dados que o MongoDB Agent cria e gerencia.

Execute os seguintes comandos para criar os diretórios:

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

Por padrão, os binários do agente e o arquivo de backup de configuração do Cloud Manager estão localizados em /var/lib/mongodb-mms-automation. Se você quiser armazenar esses arquivos em um diretório diferente, siga estes procedimentos:

Para alterar a localização dos binários do agente:

No MongoDB Cloud Manager, Go a página Deployment do seu projeto.
1. Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
3. Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
  A página Sistema é exibida.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
1. Clique em Downloads & Settings.
2. Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
3. Altere o caminho para o novo caminho que você deseja.
4. Clique em Save.
5. Crie o novo diretório que você especificou em cada host que executa um agente.
  sudo mkdir -m 755 -p /<newPath>

Para alterar o local do backup de configuração do agente:

Abra o arquivo de configuração do agente no editor de texto de sua preferência.
Altere a configuração do mmsConfigBackup para o novo caminho para o arquivo da cópia de segurança da configuração.
```
mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
```
Salve o arquivo de configuração do agente.
Mova o arquivo da cópia de segurança de configuração para o novo diretório.
```
sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
```

Atribua permissões ao usuário do sistema que executa o MongoDB Agent.

Execute os seguintes comandos:

# Create mongodb user and group if they do not exist
if ! sudo /usr/bin/id -g mongodb &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongodb
fi
# Create mongodb user if they do not exist and assign
# them to the mongodb group
if ! sudo /usr/bin/id mongodb &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongodb \
    -d /var/lib/mongo -s /bin/false \
    -c mongodb mongodb > /dev/null 2>&1
fi
# Grant the mongodb:mongodb user and group permissions
# to manage deployments.
sudo chown mongodb:mongodb /var/lib/mongodb-mms-automation
sudo chown mongodb:mongodb /var/log/mongodb-mms-automation
sudo chown mongodb:mongodb /data

Inicie o MongoDB Agent.

No diretório no qual você instalou o MongoDB Agent e como o usuário do sistema que você criou na última etapa, emita o seguinte comando:

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

Conclua a instalação do MongoDB Agent.

No modal Install Agent Instructions, clique em Done.

Repita o procedimento de instalação para cada host MongoDB.

Em RHEL / CentOS (7.x) na arquitetura PowerPC (gerenciando o MongoDB 3.4 ou sistemas posteriores):

Usando um pacote rpm :

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione RHEL/CentOS (7.X), SUSE12, Amazon Linux2 - RPM.
Clique Next. O modal Install New MongoDB Agent abre.

Baixe a versão mais recente do MongoDB Agent.

Observação

Começando com esta etapa, siga o modal de instalação do MongoDB Agent e copie os comandos fornecidos no shell do Linux.

Em um shell do sistema no host que executará o MongoDB Agent, emita o seguinte comando curl para baixar o instalador para RHEL 7 para PowerPC:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc641e.rhel7.rpm

Edite o arquivo de configuração do MongoDB Agent.

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Atualize as seguintes opções de configuração:

Chave	Valor
`mmsGroupId`	`ProjectID` do seu projeto.
`mmsApiKey`	chave de API do agente do seu projeto.

Opcional: configure o MongoDB Agent para usar um servidor proxy.

Para configurar o MongoDB Agent para se conectar ao Cloud Manager por meio de um servidor proxy, você deve especificar o servidor na variável de ambiente httpProxy .

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Adicione a seguinte chave de configuração:

Chave	Valor
`httpProxy`	URL (nome do host e porta) do seu servidor proxy.

Prepare o diretório de dados.

Os seguintes comandos criam um diretório de dados e definem o proprietário como o usuário mongod :

sudo mkdir /data; sudo chown mongod:mongod /data

Inicie o MongoDB Agent.

Emitir o seguinte comando:

sudo service mongodb-mms-automation-agent start

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

Conclua a instalação do MongoDB Agent.

No modal Install Agent Instructions, clique em Done.

Repita o procedimento de instalação para cada host MongoDB.

Usando um arquivo tar :

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione RHEL/CentOS (7.X) Power (ppc64le) - TAR.
Clique Next. O modal Install New MongoDB Agent abre.

Baixe a versão mais recente do MongoDB Agent.

Observação

Começando com esta etapa, siga o modal de instalação do MongoDB Agent e copie os comandos fornecidos no shell do Linux.

Em um shell do sistema no host que executará o MongoDB Agent, emita o seguinte comando curl para baixar o instalador para RHEL 7 para PowerPC:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.rhel7_ppc64le.tar.gz

Extraia o MongoDB Agent.

Você pode instalar o MongoDB Agent em qualquer diretório. Se você quiser mover o arquivo para outro diretório antes de extrair, você pode fazer isso.

Para instalar o MongoDB Agent, extraia o arquivo:

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le.tar.gz

Mude para o diretório binário extraído.

Altere para o diretório que foi criado após a extração do binário do MongoDB Agent :

cd mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le

Edite o arquivo de configuração do MongoDB Agent.

No diretório onde você instalou o MongoDB Agent, abra o arquivo local.config no editor de texto de sua preferência.

vi <install-path>/local.config

Atualize as seguintes opções de configuração:

Chave	Valor
`mmsGroupId`	`ProjectID` do seu projeto.
`mmsApiKey`	chave de API do agente do seu projeto.

Opcional: configure o MongoDB Agent para usar um servidor proxy.

Para configurar o MongoDB Agent para se conectar ao Cloud Manager por meio de um servidor proxy, você deve especificar o servidor na variável de ambiente httpProxy .

No diretório onde você instalou o MongoDB Agent, abra o arquivo local.config no editor de texto de sua preferência.

vi <install-path>/local.config

Adicione a seguinte chave de configuração:

Chave	Valor
`httpProxy`	URL (nome do host e porta) do seu servidor proxy.

Opcional: Crie os diretórios binário, de log e de dados.

Se você tiver um usuário do agente de monitoramento existente e não planeja ativar a automação, você só precisa criar o diretório de log.

Crie os seguintes diretórios para armazenar os arquivos necessários para o MongoDB Agent .

Observação

O uso de mongodb-mms-automation no caminho do arquivo é um artefato legado e não média que o MongoDB Agent esteja sendo instalado com a Automação configurada.

Componente	Diretório padrão	Descrição
Binários	`/var/lib/mongodb-mms-automation`	Esses são os binários que o MongoDB Agent gerencia. Elas incluem os binários MongoDB Agent, BI Connector e MongoDB .
Registros do Agente do MongoDB	`/var/log/mongodb-mms-automation`	Esses são os arquivos de log que o MongoDB Agent cria.
Bancos de dados MongoDB	`/data`	Esses são os bancos de dados que o MongoDB Agent cria e gerencia.

Execute os seguintes comandos para criar os diretórios:

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

Para alterar a localização dos binários do agente:

No MongoDB Cloud Manager, Go a página Deployment do seu projeto.
1. Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
3. Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
  A página Sistema é exibida.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
1. Clique em Downloads & Settings.
2. Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
3. Altere o caminho para o novo caminho que você deseja.
4. Clique em Save.
5. Crie o novo diretório que você especificou em cada host que executa um agente.
  sudo mkdir -m 755 -p /<newPath>

Para alterar o local do backup de configuração do agente:

Abra o arquivo de configuração do agente no editor de texto de sua preferência.
Altere a configuração do mmsConfigBackup para o novo caminho para o arquivo da cópia de segurança da configuração.
```
mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
```
Salve o arquivo de configuração do agente.
Mova o arquivo da cópia de segurança de configuração para o novo diretório.
```
sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
```

Atribua permissões ao usuário do sistema que executa o MongoDB Agent.

Execute os seguintes comandos:

# Create mongodb user and group if they do not exist
if ! sudo /usr/bin/id -g mongodb &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongodb
fi
# Create mongodb user if they do not exist and assign
# them to the mongodb group
if ! sudo /usr/bin/id mongodb &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongodb \
    -d /var/lib/mongo -s /bin/false \
    -c mongodb mongodb > /dev/null 2>&1
fi
# Grant the mongodb:mongodb user and group permissions
# to manage deployments.
sudo chown mongodb:mongodb /var/lib/mongodb-mms-automation
sudo chown mongodb:mongodb /var/log/mongodb-mms-automation
sudo chown mongodb:mongodb /data

Inicie o MongoDB Agent.

No diretório no qual você instalou o MongoDB Agent e como o usuário do sistema que você criou na última etapa, emita o seguinte comando:

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

Conclua a instalação do MongoDB Agent.

No modal Install Agent Instructions, clique em Done.

Repita o procedimento de instalação para cada host MongoDB.

Na arquitetura zSeries (gerenciando o MongoDB 4.0 ou sistemas posteriores):

Executando RHEL / CentOS 7.x/8.x usando o gerenciador de pacote rpm :

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione RHEL 7.X/8X Z-Series (s390x) - RPM.
Clique Next. O modal Install New MongoDB Agent abre.

Baixe a versão mais recente do MongoDB Agent.

Observação

Começando com esta etapa, siga o modal de instalação do MongoDB Agent e copie os comandos fornecidos no shell do Linux.

Em um shell do sistema no host que executará o MongoDB Agent, emita o seguinte comando curl para baixar o instalador para RHEL 7.X/8.X para IBM zSeries:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.rhel7.rpm

Edite o arquivo de configuração do MongoDB Agent.

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Atualize as seguintes opções de configuração:

Chave	Valor
`mmsGroupId`	`ProjectID` do seu projeto.
`mmsApiKey`	chave de API do agente do seu projeto.

Opcional: configure o MongoDB Agent para usar um servidor proxy.

Para configurar o MongoDB Agent para se conectar ao Cloud Manager por meio de um servidor proxy, você deve especificar o servidor na variável de ambiente httpProxy .

No diretório onde você instalou o MongoDB Agent, abra o arquivo automation-agent.config em seu editor de texto preferido.

sudo vi /etc/mongodb-mms/automation-agent.config

Adicione a seguinte chave de configuração:

Chave	Valor
`httpProxy`	URL (nome do host e porta) do seu servidor proxy.

Prepare o diretório de dados.

Os seguintes comandos criam um diretório de dados e definem o proprietário como o usuário mongod :

sudo mkdir /data; sudo chown mongod:mongod /data

Inicie o MongoDB Agent.

Emitir o seguinte comando:

sudo service mongodb-mms-automation-agent start

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

Conclua a instalação do MongoDB Agent.

No modal Install Agent Instructions, clique em Done.

Repita o procedimento de instalação para cada host MongoDB.

Use este procedimento para instalar a atualização para o MongoDB Agent em sistemas Linux que não usam pacotes deb ou rpm .

Faça login no Cloud Manager.

No banner de notificação, clique em Atualizar todos os agentes.

A página Update to MongoDB Agent abre para iniciar o processo de atualização. A etapa Introducing the MongoDB Agent é exibida. Quando terminar de ler esta etapa, clique em Next.

Adicione quaisquer opções de configuração existentes para o seu agente de monitoramento legado.

Para adicionar as opções que você tinha para o seu agente de monitoramento, na seção Monitoring Configurations :

Digite a configuração desejada na caixa Setting e o valor correspondente na caixa Value .
Para adicionar mais de um Setting, clique no link + Add Setting . Outra linha é exibida.
Repita até que todas as configurações tenham sido adicionadas.
Após adicionar todas as configurações necessárias para seu sistema, clique em Next.

Você pode clicar em para remover as configurações adicionadas.

Importante

O Cloud Manager não valida nenhuma dessas configurações. Certifique-se de que as configurações e os valores estejam corretos.

Instale o MongoDB Agent.

Clique View Agent Install Instructions. O modal Install Agent Instructions abre.
No menu Select Your Server's Operating System , selecione Outro Linux - TAR.
Clique Next. O modal Install New MongoDB Agent abre.

Baixe a versão mais recente do MongoDB Agent.

Observação

Começando com esta etapa, siga o modal de instalação do MongoDB Agent e copie os comandos fornecidos no shell do Linux.

Em um shell do sistema no host que executará o MongoDB Agent, emita o seguinte comando curl para baixar o instalador para Linux genérico 64-bit:

curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.linux_x86_64.tar.gz

Extraia o MongoDB Agent.

Você pode instalar o MongoDB Agent em qualquer diretório. Se você quiser mover o arquivo para outro diretório antes de extrair, você pode fazer isso.

Para instalar o MongoDB Agent, extraia o arquivo:

tar -xvzf mongodb-mms-automation-agent-<VERSION>.linux_x86_64.tar.gz

Mude para o diretório binário extraído.

Altere para o diretório que foi criado após a extração do binário do MongoDB Agent :

cd mongodb-mms-automation-agent-<VERSION>.linux_x86_64

Edite o arquivo de configuração do MongoDB Agent.

No diretório onde você instalou o MongoDB Agent, abra o arquivo local.config no editor de texto de sua preferência.

vi <install-path>/local.config

Atualize as seguintes opções de configuração:

Chave	Valor
`mmsGroupId`	`ProjectID` do seu projeto.
`mmsApiKey`	chave de API do agente do seu projeto.

Opcional: configure o MongoDB Agent para usar um servidor proxy.

Para configurar o MongoDB Agent para se conectar ao Cloud Manager por meio de um servidor proxy, você deve especificar o servidor na variável de ambiente httpProxy .

No diretório onde você instalou o MongoDB Agent, abra o arquivo local.config no editor de texto de sua preferência.

vi <install-path>/local.config

Adicione a seguinte chave de configuração:

Chave	Valor
`httpProxy`	URL (nome do host e porta) do seu servidor proxy.

Opcional: Crie os diretórios binário, de log e de dados.

Se você tiver um usuário do agente de monitoramento existente e não planeja ativar a automação, você só precisa criar o diretório de log.

Crie os seguintes diretórios para armazenar os arquivos necessários para o MongoDB Agent .

Observação

O uso de mongodb-mms-automation no caminho do arquivo é um artefato legado e não média que o MongoDB Agent esteja sendo instalado com a Automação configurada.

Componente	Diretório padrão	Descrição
Binários	`/var/lib/mongodb-mms-automation`	Esses são os binários que o MongoDB Agent gerencia. Elas incluem os binários MongoDB Agent, BI Connector e MongoDB .
Registros do Agente do MongoDB	`/var/log/mongodb-mms-automation`	Esses são os arquivos de log que o MongoDB Agent cria.
Bancos de dados MongoDB	`/data`	Esses são os bancos de dados que o MongoDB Agent cria e gerencia.

Execute os seguintes comandos para criar os diretórios:

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

Para alterar a localização dos binários do agente:

No MongoDB Cloud Manager, Go a página Deployment do seu projeto.
1. Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
3. Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
  A página Sistema é exibida.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
1. Clique em Downloads & Settings.
2. Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
3. Altere o caminho para o novo caminho que você deseja.
4. Clique em Save.
5. Crie o novo diretório que você especificou em cada host que executa um agente.
  sudo mkdir -m 755 -p /<newPath>

Para alterar o local do backup de configuração do agente:

Abra o arquivo de configuração do agente no editor de texto de sua preferência.
Altere a configuração do mmsConfigBackup para o novo caminho para o arquivo da cópia de segurança da configuração.
```
mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
```
Salve o arquivo de configuração do agente.
Mova o arquivo da cópia de segurança de configuração para o novo diretório.
```
sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
```

Atribua permissões ao usuário do sistema que executa o MongoDB Agent.

Execute os seguintes comandos:

# Create mongodb user and group if they do not exist
if ! sudo /usr/bin/id -g mongodb &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongodb
fi
# Create mongodb user if they do not exist and assign
# them to the mongodb group
if ! sudo /usr/bin/id mongodb &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongodb \
    -d /var/lib/mongo -s /bin/false \
    -c mongodb mongodb > /dev/null 2>&1
fi
# Grant the mongodb:mongodb user and group permissions
# to manage deployments.
sudo chown mongodb:mongodb /var/lib/mongodb-mms-automation
sudo chown mongodb:mongodb /var/log/mongodb-mms-automation
sudo chown mongodb:mongodb /data

Inicie o MongoDB Agent.

No diretório no qual você instalou o MongoDB Agent e como o usuário do sistema que você criou na última etapa, emita o seguinte comando:

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &

Verifique se o MongoDB Agent está em execução.

No modal Install Agent Instructions , aguarde que cada sistema mostre Verified na etapa Install the MongoDB Agent .

Importante

Todas as credenciais de autenticação SCRAM, LDAP e Kerberos de Agentes legado são mantidas após a atualização. Todos os arquivos de chave .pem também são mantidos.

Clique em Next.

Conclua a instalação do MongoDB Agent.

No modal Final Steps, o agente de monitoramento legado e agente de backup são colocados no modo de espera. Clique Finish.

Repita o procedimento de instalação para cada host MongoDB.

Próximos passos

Após a conclusão da atualização do MongoDB Agent:

Se a automação não managed anteriormente seu agente de monitoramento, ative o backup e/ou o monitoramento em sua deployment do MongoDB.
Se a automação gerenciou anteriormente seu agente de monitoramento, agora ele está ativado. Para verificar se a automação está ativada:
1
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.
2
Acesse a página Servers.
Clique na aba Servers para sua implantação.
A página Servidores é exibida.
Se você quiser ativar a automação, adicione uma implantação ao seu projeto MongoDB.
Pare e remova o agente de monitoramento legado.
Pare e remova o agente de backup legado.

Voltar

Todos os agentes legados

Backups legados e agentes de monitoramento