Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Instale o MongoDB Enterprise Edition no Amazon Linux

Use este tutorial para instalar o MongoDB 9.0 Enterprise Edition no Amazon Linux usando o gerenciador de pacotes YUM.

O MongoDB Enterprise Edition está disponível em plataformas selecionadas e é compatível com recursos relacionados à segurança e monitoramento.

Você pode verificar qual distribuição Linux você está executando ao executar o seguinte comando na linha de comando:

grep ^NAME /etc/*release

O resultado deve ser Amazon Linux ou Amazon Linux AMI. Se estiver usando uma distribuição Linux diferente, consulte as instruções de instalação para sua plataforma.

Este tutorial instala o MongoDB 9.0 Enterprise Edition. Para instalar uma versão diferente do MongoDB Enterprise, use o menu suspenso de versão na barra lateral e selecione a documentação para essa versão.

MongoDB 9.0 O Enterprise Edition é compatível com a seguinte versão 64-bit do Amazon Linux na arquitetura x86_64 :

  • Amazon Linux 2023

O MongoDB oferece suporte somente às versões de bits desta plataforma.

MongoDB 9.0 A edição Enterprise no Amazon Linux também é compatível com a arquitetura ARM64 em plataformas selecionadas.

Consulte Suporte da Plataforma para obter mais informações.

Antes de implantar o MongoDB em um ambiente de produção, consulte o documento Notas de produção para implementações autogerenciadas para obter considerações de desempenho e recomendações de configuração.

Siga estas etapas para instalar o MongoDB Enterprise Edition usando o gerenciador de pacotes YUM. Selecione a aba para a sua versão do Amazon Linux:

1

Crie um arquivo /etc/yum.repos.d/mongodb-enterprise-9.0.repo para instalar o MongoDB Enterprise diretamente utilizando o yum:

[mongodb-enterprise-9.0]name=MongoDB Enterprise Repositorybaseurl=https://repo.mongodb.com/yum/amazon/2023/mongodb-enterprise/9.0/$basearch/gpgcheck=1enabled=1gpgkey=https://pgp.mongodb.com/server-9.asc

Observação

Se você tiver um arquivo mongodb-enterprise.repo neste diretório a partir de uma instalação anterior do MongoDB, deverá removê-lo. Use o arquivo mongodb-enterprise-9.0.repo acima para instalar o MongoDB 9.0.

Você também pode baixar os arquivos .rpm diretamente do repositório do MongoDB. Os downloads são organizados pela versão do Amazon Linux (por exemplo, 2023), em seguida, a versão do MongoDB (por exemplo, 9.0), depois a arquitetura (por exemplo, x86_64).

2

Para instalar a versão estável mais recente do MongoDB Enterprise 9.0, emita o seguinte comando:

sudo yum install -y mongodb-enterprise

Para instalar uma versão específica, você deve especificar cada pacote de componente individualmente junto com o número da versão, como no exemplo a seguir:

sudo yum install -y mongodb-enterprise-9.0.4 mongodb-enterprise-database-9.0.4 mongodb-enterprise-server-9.0.4 mongodb-mongosh mongodb-enterprise-mongos-9.0.4 mongodb-enterprise-tools-9.0.4

Observação

Embora você possa especificar qualquer versão disponível do MongoDB Enterprise, o yum atualiza os pacotes quando uma versão mais nova se tornar disponível. Para evitar atualizações indesejadas, fixe o pacote adicionando a seguinte diretiva exclude ao seu arquivo /etc/yum.conf:

exclude=mongodb-enterprise,mongodb-enterprise-database,mongodb-enterprise-server,mongodb-enterprise-shell,mongodb-enterprise-mongos,mongodb-enterprise-tools

Observação

Você também pode instalar o MongoDB Shell que usa o OpenSSL do sistema. Você já deve ter instalado o OpenSSL em seu sistema antes de instalar esta versão do MongoDB Shell.

Você pode instalar todos os pacotes MongoDB Enterprise e MongoDB Shell que usam o OpenSSL do sistema sem remover o MongoDB Shell primeiro. Por exemplo:

sudo yum install -y mongodb-enterprise mongodb-mongosh-shared-openssl11

O exemplo a seguir remove o MongoDB Shell e depois instala o MongoDB Shell que usa o OpenSSL 1,1 do sistema:

sudo yum remove -y mongodb-mongosh && sudo yum install -ymongodb-mongosh-shared-openssl11

O exemplo a seguir remove o MongoDB Shell e depois instala o MongoDB Shell que usa o OpenSSL 3 do sistema:

sudo yum remove -y mongodb-mongosh && sudo yum install -ymongodb-mongosh-shared-openssl3

Se o MongoDB Shell não iniciar com o seguinte erro, instale o pacote mongodb-mongosh-shared-openssl3 usando os comandos anteriores:

mongosh: OpenSSL configuration error: ...:error:030000A9:digitalenvelope routines:alg_module_init:unknownoption:../deps/openssl/openssl/crypto/evp/evp_cnf.c:61:name=rh-allow-sha1-signatures,value=yes

O erro afeta o RHEL 9+ e derivados, como o Amazon Linux 2023.

Você também pode escolher os pacotes MongoDB para instalar.

O exemplo a seguir instala o MongoDB Enterprise e ferramentas, e o MongoDB Shell que utiliza o OpenSSL 1,1 do sistema:

sudo yum install -y mongodb-enterprise-databasemongodb-enterprise-tools mongodb-mongosh-shared-openssl11

O exemplo a seguir instala o MongoDB Enterprise e ferramentas, e o MongoDB Shell que utiliza o OpenSSL 3 do sistema:

sudo yum install -y mongodb-enterprise-databasemongodb-enterprise-tools mongodb-mongosh-shared-openssl3

A maioria dos sistemas operacionais do tipo Unix limita os recursos do sistema que um processo pode usar. Esses limites podem impactar negativamente a operação do MongoDB e devem ser ajustados. Consulte UNIX ulimit Configurações para implantações autogerenciadas para obter as configurações recomendadas para sua plataforma.

Observação

Se o valor ulimit para o número de arquivos abertos estiver em 64000, o MongoDB gerará um aviso de inicialização.

Por padrão, uma instância MongoDB armazena:

  • seus arquivos de dados em /var/lib/mongo

  • seus arquivos de log em /var/log/mongodb

Se você instalou usando o gerenciador de pacote , esses diretórios padrão serão criados durante a instalação.

Se você instalou manualmente baixando os tarballs, crie os diretórios usando mkdir -p <directory> ou sudo mkdir -p <directory> dependendo do usuário que executará o MongoDB. Consulte as páginas de manual do Linux para obter informações sobre mkdir e sudo.

Por padrão, o MongoDB é executado com a conta de usuário mongod. Se você alterar o usuário que executa o processo MongoDB, também deverá modificar a permissão /var/lib/mongo para /var/log/mongodb os diretórios e para conceder a este usuário acesso a estes diretórios.

Para especificar um diretório de arquivo de log diferente e diretório de arquivo de dados, edite as configurações do systemLog.path e storage.dbPath no /etc/mongod.conf. Certifique-se de que o usuário que executa o MongoDB tenha acesso a esses diretórios.

Siga estas etapas para executar a edição MongoDB Enterprise. Estas instruções presumem que você esteja usando as configurações padrão.

Sistema de Inicialização

Para executar e gerenciar seu processo,mongod use o sistema de inicialização integrado do seu sistema operacional. Versões recentes do Linux utilizam systemd, que utiliza o comando systemctl, enquanto versões mais antigas do Linux utilizam init do Sistema V, que utiliza o comando service.

Se você não tiver certeza de qual sistema de inicialização sua plataforma usa, execute o seguinte comando:

ps --no-headers -o comm 1

Em seguida, selecione a aba apropriada abaixo com base no resultado:

  • systemd - selecione a aba systemd (systemctl) abaixo.

  • init - selecione a aba System V Init (service) abaixo.

1

Você pode iniciar o processo mongod emitindo o seguinte comando:

sudo systemctl start mongod

Se receber um erro semelhante ao seguinte ao iniciar o mongod:

Failed to start mongod.service: Unit mongod.service not found.

Execute o seguinte comando primeiro:

sudo systemctl daemon-reload

Em seguida, execute o comando de inicialização acima novamente.

2

Você pode verificar se o processo mongod começou com sucesso emitindo o seguinte comando:

sudo systemctl status mongod

Opcionalmente, você pode garantir que o MongoDB iniciará após reinicialização do sistema emitindo o seguinte comando:

sudo systemctl enable mongod
3

Conforme necessário, você pode interromper o processo mongod emitindo o seguinte comando:

sudo systemctl stop mongod
4

Você pode reiniciar o processo mongod emitindo o seguinte comando:

sudo systemctl restart mongod

Você pode acompanhar o estado do processo em busca de erros ou mensagens importantes observando o resultado no arquivo /var/log/mongodb/mongod.log.

5

Inicie uma sessão mongosh na mesma máquina host que o mongod. Você pode executar mongosh sem nenhuma opção de linha de comando para se conectar a um mongod que esteja sendo executado em seu host local com a porta padrão 27017.

mongosh

Para obter mais informações sobre como se conectar usando mongosh, como se conectar a uma instância mongod em execução em um host e/ou porta diferente, consulte a documentação do mongosh.

Para ajudá-lo a começar a usar o MongoDB, o MongoDB fornece Guias de Introdução em várias edições de driver. Para obter a documentação do driver, consulte Iniciar o desenvolvimento com o MongoDB.

Por padrão, o MongoDB é iniciado com bindIp definido como 127.0.0.1, que se vincula à interface de rede localhost. Isso significa que a instância mongod só aceita conexões de clientes que estejam sendo executados na mesma máquina. Para permitir que clientes remotos acessem a instância mongod ou para inicializar um conjunto de réplicas na instância, você deve vincular mongod a uma interface de rede acessível publicamente.

Para vincular a interface de rede, use a configuração bindIp no arquivo de configuração ou inicie o mongod com a opção de linha de comando --bind_ip.

Aviso

Antes de vincular sua instância a um endereço IP acessível publicamente, você deve proteger seu cluster contra o acesso não autorizado. Para obter uma lista completa de recomendações de segurança, consulte Lista de verificação de segurança para implantações autogerenciadas. No mínimo, considere habilitar a autenticação e fortalecer a infraestrutura de rede.

Para obter mais informações sobre como configurar bindIp, consulte Vinculação de IP em implementações autogerenciadas.

A edição MongoDB Enterprise está disponível em seu próprio repositório dedicado e contém os seguintes pacotes com suporte oficial:

Nome do Pacote
Descrição

mongodb-enterprise

Um metapackage que instala automaticamente os pacotes do componente listados abaixo.

mongodb-enterprise-database

Um metapackage que instala automaticamente os pacotes do componente listados abaixo:

  • mongodb-enterprise-server: contém o daemon mongod e as configurações associadas e scripts de inicialização.

  • mongodb-enterprise-mongos: contém o daemon mongos.

  • mongodb-enterprise-cryptd: contém o binário mongocryptd.

mongodb-mongosh

Contém o MongoDB Shell (mongosh).

mongodb-shared-openssl*

Contém o MongoDB Shell que usa a versão OpenSSL já instalada em seu computador (mongosh).

mongodb-enterprise-tools

Um metapackage que instala automaticamente os pacotes do componente listados abaixo: