Instalar o MongoDB Agent para gerenciar sistemas
- 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 .
Instale o MongoDB Agent para gerenciar, monitorar e fazer backup de seus MongoDB deployments.
Observação
Revise os pré-requisitos primeiro
Leia os pré-requisitos do MongoDB Agent antes de instalá-lo.
Use este procedimento para instalar o MongoDB Agent na arquitetura x86_64 executando o Microsoft Windows:
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment , selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System, clique em Windows - MSI.
Clique em Next.
No menu Install Agent, clique em Windows - MSI.
Baixe 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).
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.
Instale o MongoDB Agent.
Após os downloads do
MSI, clique duas vezes:mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msiSe 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, será solicitado que você o desabilite. 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 interpretador 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 autônomo a partir da linha de comando, você invoca 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, você invocaria 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 Verify Agent para garantir que o MongoDB Agent possa se conectar ao Cloud Manager.
Clique em Done.
(Opcional) Altere o local dos binários do MongoDB Agent e dos arquivos de backup de configuração.
Por padrão, os binários do MongoDB e o arquivo de backup de configuração do Cloud Manager estão localizados em %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ê seria 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.
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.
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 do
mmsConfigBackuppara o novo caminho para o arquivo da cópia de segurança da configuração. SubstituaXpela 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>
Use este procedimento para instalar o MongoDB Agent:
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Em arquitetura x86_64 executando Debian 8/9/10/11 ou Ubuntu 18.04/20.04/22.04:
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System, clique em Debian 8/9, Ubuntu 16.X/18.X - DEB.
Clique em Next.
No menu Install Agent, clique em Debian 8/9, Ubuntu 16.X/18.X - DEB.
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 8/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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Use este procedimento para instalar o MongoDB Agent:
Na arquitetura x86_64 :
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Executar o Amazon Linux usando um pacote rpm :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em Amazon Linux - RPM.
Clique em Next.
No menu Install Agent , clique em Amazon Linux - RPM.
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 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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Executando RHEL / CentOS 7.x, SUSE12, SUSE15 ou Amazon Linux 2:
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Usando um pacote rpm :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X), SUSE12, Amazon Linux2 - RPM.
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X), SUSE12, Amazon Linux2 - RPM.
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Usando um arquivo tar :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X), SUSE12, Amazon Linux 2 - TAR.
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X), SUSE12, Amazon Linux 2 - TAR.
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 para 64-bit x86:
curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_x86_64.tar.gz
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
URL (nome do host e porta) do seu servidor proxy. |
Opcional: Crie os diretórios binário, de log e de dados.
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.
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.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
Clique em Downloads & Settings.
Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
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 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
mmsConfigBackuppara 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 mongod user and group if they do not exist if ! sudo /usr/bin/id -g mongod &>/dev/null; then sudo /usr/sbin/groupadd -r mongod fi Create mongod user if they do not exist and assign them to the mongod group if ! sudo /usr/bin/id mongod &>/dev/null; then sudo /usr/sbin/useradd -M -r -g mongod \ -d /var/lib/mongo -s /bin/false \ -c mongod mongod > /dev/null 2>&1 fi Grant the mongod:mongod user and group permissions to manage deployments. sudo chown mongod:mongod /var/lib/mongod-mms-automation sudo chown mongod:mongod /var/log/mongod-mms-automation sudo chown mongod:mongod /data
Em RHEL / CentOS (7.x) na arquitetura PowerPC (gerenciando o MongoDB 3.4 ou sistemas posteriores):
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Usando um pacote rpm :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X) Power (ppc64le) - RPM.
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X) Power (ppc64le) - RPM.
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.ppc64le.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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Usando um arquivo tar :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X) Power (ppc64le) - TAR.
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X) Power (ppc64le) - TAR.
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-latest.rhel7_ppc64le.tar.gz
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
URL (nome do host e porta) do seu servidor proxy. |
Opcional: Crie os diretórios binário, de log e de dados.
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.
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.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
Clique em Downloads & Settings.
Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
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 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
mmsConfigBackuppara 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 mongod user and group if they do not exist if ! sudo /usr/bin/id -g mongod &>/dev/null; then sudo /usr/sbin/groupadd -r mongod fi Create mongod user if they do not exist and assign them to the mongod group if ! sudo /usr/bin/id mongod &>/dev/null; then sudo /usr/sbin/useradd -M -r -g mongod \ -d /var/lib/mongo -s /bin/false \ -c mongod mongod > /dev/null 2>&1 fi Grant the mongod:mongod user and group permissions to manage deployments. sudo chown mongod:mongod /var/lib/mongod-mms-automation sudo chown mongod:mongod /var/log/mongod-mms-automation sudo chown mongod:mongod /data
Na arquitetura zSeries (gerenciando o MongoDB 4.0 ou sistemas posteriores):
Executando RHEL / CentOS 7.x/8.x:
Executando RHEL / CentOS 7.x/8.x usando o gerenciador de pacote rpm :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL 7.X/8X Z-Series (s390x) - RPM.
Clique em Next.
No menu Install Agent , clique em RHEL 7.X/8X Z-Series (s390x) - RPM.
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Na arquitetura ARM64 executando RHEL 8.x/9.x ou Amazon Linux 2:
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Executando RHEL 8.x/9.x ou Amazon Linux 2 usando o gerenciador de pacote rpm:
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM).
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM).
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 8.x/9.x ou Amazon Linux 2 para ARM64:
curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Usando um arquivo tar :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM).
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM).
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 8.x/9.x ou Amazon Linux 2 para ARM64:
curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.amzn2_aarch64.tar.gz
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
URL (nome do host e porta) do seu servidor proxy. |
Opcional: Crie os diretórios binário, de log e de dados.
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.
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.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
Clique em Downloads & Settings.
Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
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 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
mmsConfigBackuppara 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 mongod user and group if they do not exist if ! sudo /usr/bin/id -g mongod &>/dev/null; then sudo /usr/sbin/groupadd -r mongod fi Create mongod user if they do not exist and assign them to the mongod group if ! sudo /usr/bin/id mongod &>/dev/null; then sudo /usr/sbin/useradd -M -r -g mongod \ -d /var/lib/mongo -s /bin/false \ -c mongod mongod > /dev/null 2>&1 fi Grant the mongod:mongod user and group permissions to manage deployments. sudo chown mongod:mongod /var/lib/mongod-mms-automation sudo chown mongod:mongod /var/log/mongod-mms-automation sudo chown mongod:mongod /data
Use este procedimento para instalar sistemas Linux que não utilizam pacotes deb ou rpm .
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em Outro Linux - TAR.
Clique em Next.
No menu Install Agent , clique em Outro Linux - TAR.
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-latest.linux_x86_64.tar.gz
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
URL (nome do host e porta) do seu servidor proxy. |
Opcional: Crie os diretórios binário, de log e de dados.
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.
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.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
Clique em Downloads & Settings.
Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
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 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
mmsConfigBackuppara 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
Use este procedimento para instalar o MongoDB Agent na arquitetura x86_64 executando o Microsoft Windows:
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System, clique em Windows - MSI.
Clique em Next.
No menu Install Agent, clique em Windows - MSI.
Baixe 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).
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.
Instale o MongoDB Agent.
Após os downloads do
MSI, clique duas vezes:mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msiSe 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 em Configure firewall rules allowing access from only the specified |ipaddr| addresses., digite os endereços 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, será solicitado que você o desabilite. 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 interpretador 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 autônomo a partir da linha de comando, você invoca 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, você invocaria 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 Verify Agent para garantir que o MongoDB Agent possa se conectar ao Cloud Manager.
Clique em Done.
(Opcional) Altere o local dos binários do MongoDB Agent e dos arquivos de backup de configuração.
Por padrão, os binários do MongoDB e o arquivo de backup de configuração do Cloud Manager estão localizados em %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ê seria 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.
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.
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 do
mmsConfigBackuppara o novo caminho para o arquivo da cópia de segurança da configuração. SubstituaXpela 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>
Use este procedimento para instalar o MongoDB Agent:
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Em arquitetura x86_64 executando Debian 8/9/10/11 ou Ubuntu 18.04/20.04/22.04:
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System, clique em Debian 8/9, Ubuntu 16.X/18.X - DEB.
Clique em Next.
No menu Install Agent, clique em Debian 8/9, Ubuntu 16.X/18.X - DEB.
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 8/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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Use este procedimento para instalar o MongoDB Agent:
Na arquitetura x86_64 :
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Executar o Amazon Linux usando um pacote rpm :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em Amazon Linux - RPM.
Clique em Next.
No menu Install Agent , clique em Amazon Linux - RPM.
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 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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Executando RHEL / CentOS 7.x, SUSE12, SUSE15 ou Amazon Linux 2:
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Usando um pacote rpm :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X), SUSE12, Amazon Linux2 - RPM.
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X), SUSE12, Amazon Linux2 - RPM.
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Usando um arquivo tar :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X), SUSE12, Amazon Linux 2 - TAR.
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X), SUSE12, Amazon Linux 2 - TAR.
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 para 64-bit x86:
curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_x86_64.tar.gz
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
URL (nome do host e porta) do seu servidor proxy. |
Opcional: Crie os diretórios binário, de log e de dados.
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.
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.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
Clique em Downloads & Settings.
Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
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 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
mmsConfigBackuppara 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 mongod user and group if they do not exist if ! sudo /usr/bin/id -g mongod &>/dev/null; then sudo /usr/sbin/groupadd -r mongod fi Create mongod user if they do not exist and assign them to the mongod group if ! sudo /usr/bin/id mongod &>/dev/null; then sudo /usr/sbin/useradd -M -r -g mongod \ -d /var/lib/mongo -s /bin/false \ -c mongod mongod > /dev/null 2>&1 fi Grant the mongod:mongod user and group permissions to manage deployments. sudo chown mongod:mongod /var/lib/mongod-mms-automation sudo chown mongod:mongod /var/log/mongod-mms-automation sudo chown mongod:mongod /data
Em RHEL / CentOS (7.x) na arquitetura PowerPC (gerenciando o MongoDB 3.4 ou sistemas posteriores):
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Usando um pacote rpm :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X) Power (ppc64le) - RPM.
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X) Power (ppc64le) - RPM.
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.ppc64le.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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Usando um arquivo tar :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X) Power (ppc64le) - TAR.
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X) Power (ppc64le) - TAR.
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-latest.rhel7_ppc64le.tar.gz
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
URL (nome do host e porta) do seu servidor proxy. |
Opcional: Crie os diretórios binário, de log e de dados.
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.
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.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
Clique em Downloads & Settings.
Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
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 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
mmsConfigBackuppara 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 mongod user and group if they do not exist if ! sudo /usr/bin/id -g mongod &>/dev/null; then sudo /usr/sbin/groupadd -r mongod fi Create mongod user if they do not exist and assign them to the mongod group if ! sudo /usr/bin/id mongod &>/dev/null; then sudo /usr/sbin/useradd -M -r -g mongod \ -d /var/lib/mongo -s /bin/false \ -c mongod mongod > /dev/null 2>&1 fi Grant the mongod:mongod user and group permissions to manage deployments. sudo chown mongod:mongod /var/lib/mongod-mms-automation sudo chown mongod:mongod /var/log/mongod-mms-automation sudo chown mongod:mongod /data
Na arquitetura zSeries (gerenciando o MongoDB 4.0 ou sistemas posteriores):
Executando RHEL / CentOS 7.x/8.x:
Executando RHEL / CentOS 7.x/8.x usando o gerenciador de pacote rpm :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL 7.X/8X Z-Series (s390x) - RPM.
Clique em Next.
No menu Install Agent , clique em RHEL 7.X/8X Z-Series (s390x) - RPM.
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Na arquitetura ARM64 executando RHEL 8.x/9.x ou Amazon Linux 2:
Importante
Iniciando com a versão 10.24.0.6714-1, quando você instala o MongoDB Agent utilizando pacotes deb ou rpm , o pacote não adiciona binários MongoDB à variável de ambiente PATH .
Se sua implantação depender da presença de binários do MongoDB no PATH, você deverá adicionar manualmente os caminhos para binários do MongoDB ao PATH. Para saber como atualizar variáveis de ambiente, consulte a documentação do seu sistema operacional.
Executando RHEL 8.x/9.x ou Amazon Linux 2 usando o gerenciador de pacote rpm:
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM).
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (7.X/8.X/9.X), Amazon Linux2, Amazon Linux 2023 - RPM (ARM).
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 8.x/9.x ou Amazon Linux 2 para ARM64:
curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
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
Usando um arquivo tar :
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em RHEL/CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM).
Clique em Next.
No menu Install Agent , clique em RHEL/CentOS (8.X/9.X), Amazon Linux 2, Amazon Linux 2023 - TAR (ARM).
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 8.x/9.x ou Amazon Linux 2 para ARM64:
curl -OL https://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-latest.amzn2_aarch64.tar.gz
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
URL (nome do host e porta) do seu servidor proxy. |
Opcional: Crie os diretórios binário, de log e de dados.
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.
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.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
Clique em Downloads & Settings.
Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
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 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
mmsConfigBackuppara 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 mongod user and group if they do not exist if ! sudo /usr/bin/id -g mongod &>/dev/null; then sudo /usr/sbin/groupadd -r mongod fi Create mongod user if they do not exist and assign them to the mongod group if ! sudo /usr/bin/id mongod &>/dev/null; then sudo /usr/sbin/useradd -M -r -g mongod \ -d /var/lib/mongo -s /bin/false \ -c mongod mongod > /dev/null 2>&1 fi Grant the mongod:mongod user and group permissions to manage deployments. sudo chown mongod:mongod /var/lib/mongod-mms-automation sudo chown mongod:mongod /var/log/mongod-mms-automation sudo chown mongod:mongod /data
Use este procedimento para instalar sistemas Linux que não utilizam pacotes deb ou rpm .
Iniciar ou gerenciar um sistema.
Seu projeto não tem sistemas e você visualiza um prompt para começar.
No menu Build New Deployment, selecione o tipo de sistema que deseja adicionar:
Se, na página Create New Deployment , o Cloud Manager não puder detectar nenhum host com o MongoDB Agent instalado, você visualizará um banner exibido na parte superior da página Create New Deployment .
Clique no link see instructions.
No menu Select Your Server's Operating System , clique em Outro Linux - TAR.
Clique em Next.
No menu Install Agent , clique em Outro Linux - TAR.
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-latest.linux_x86_64.tar.gz
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 |
|---|---|
ProjectID do seu projeto. | |
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 |
|---|---|
URL (nome do host e porta) do seu servidor proxy. |
Opcional: Crie os diretórios binário, de log e de dados.
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.
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.
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Altere o caminho.
Clique em Downloads & Settings.
Abaixo do cabeçalho Download Directory , clique no ícone de lápis à direita do caminho mostrado no Download Directory (Linux).
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 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
mmsConfigBackuppara 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