Visão geral
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.
Verifique a distribuição do Linux
Você pode verificar qual distribuição Linux você está executando ao executar o seguinte comando na linha de comando:
grep ^NAME /etc/*releaseO 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.
Versão do MongoDB
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.
Considerações
Suporte a plataformas
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.
Notas de produção
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.
Instale o MongoDB Enterprise Edition
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:
Configure o sistema de gerenciamento de pacotes (yum).
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.ascObservaçã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).
Para instalar a versão estável mais recente do MongoDB Enterprise 9.0, emita o seguinte comando:
sudo yum install -y mongodb-enterprisePara 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.4Observaçã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-toolsObservaçã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-openssl11O 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-openssl11O 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-openssl3Se 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=yesO 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-openssl11O 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-openssl3Executar o MongoDB Enterprise Edition
Considerações ulimit
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.
Diretórios
Por padrão, uma instância MongoDB armazena:
seus arquivos de dados em
/var/lib/mongoseus 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.
Procedimento
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 1Em 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.
Inicie o MongoDB.
Você pode iniciar o processo mongod emitindo o seguinte comando:
sudo systemctl start mongodSe 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-reloadEm seguida, execute o comando de inicialização acima novamente.
Verifique se o MongoDB foi iniciado com sucesso.
Você pode verificar se o processo mongod começou com sucesso emitindo o seguinte comando:
sudo systemctl status mongodOpcionalmente, você pode garantir que o MongoDB iniciará após reinicialização do sistema emitindo o seguinte comando:
sudo systemctl enable mongodPare o MongoDB.
Conforme necessário, você pode interromper o processo mongod emitindo o seguinte comando:
sudo systemctl stop mongodReinicie o MongoDB.
Você pode reiniciar o processo mongod emitindo o seguinte comando:
sudo systemctl restart mongodVocê pode acompanhar o estado do processo em busca de erros ou mensagens importantes
observando o resultado no arquivo /var/log/mongodb/mongod.log.
Comece a usar o MongoDB.
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.
mongoshPara 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.
Inicie o MongoDB.
Você pode iniciar o processo mongod emitindo o seguinte comando:
sudo service mongod startVerifique se o MongoDB foi iniciado com sucesso.
Você pode verificar se o processo mongod começou com sucesso verificando o conteúdo do arquivo de log em /var/log/mongodb/mongod.log para uma linha de leitura
[initandlisten] waiting for connections on port <port>onde <port> é a porta configurada em /etc/mongod.conf, 27017 por padrão.
Opcionalmente, você pode garantir que o MongoDB iniciará após reinicialização do sistema emitindo o seguinte comando:
sudo chkconfig mongod onPare o MongoDB.
Conforme necessário, você pode interromper o processo mongod emitindo o seguinte comando:
sudo service mongod stopReinicie o MongoDB.
Você pode reiniciar o processo mongod emitindo o seguinte comando:
sudo service mongod restartVocê pode acompanhar o estado do processo em busca de erros ou mensagens importantes
observando o resultado no arquivo /var/log/mongodb/mongod.log.
Comece a usar o MongoDB.
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.
mongoshPara 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.
Informações adicionais
Vinculação ao localhost por padrão
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.
Pacotes do MongoDB Enterprise Edition
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 |
|---|---|
| Um |
| Um
|
| Contém o MongoDB Shell ( |
| Contém o MongoDB Shell que usa a versão OpenSSL já instalada em seu computador ( |
| Um
|