Instale o MongoDB Enterprise Edition no Amazon Linux
Nesta página
Visão geral
Use este tutorial para instalar o MongoDB 8.0 Enterprise Edition no Amazon Linux com o gerenciador de pacoteyum
.
O MongoDB Enterprise Edition está disponível em plataformas selecionadas e contém suporte para vários recursos relacionados à segurança e ao 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/*release
O resultado deve ser Amazon Linux ou Amazon Linux AMI. Se estiver usando uma distribuição Linux diferente, consulte asinstruções de instalação para sua plataforma.
Versão do MongoDB
Este tutorial instala o MongoDB 8.0 Enterprise Edition. Para instalar uma versão diferente do MongoDB Enterprise, use o menu suspenso de versão no canto superior esquerdo desta página para selecionar a documentação dessa versão.
Considerações
Suporte a plataformas
MongoDB 8.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 8.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, considere o documento Notas de produção para implantações autogerenciadas, que oferece considerações de desempenho e recomendações de configuração para implantações de produção do MongoDB.
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-8.0.repo
para instalar o MongoDB Enterprise diretamente utilizando o yum
:
[mongodb-enterprise-8.0] name=MongoDB Enterprise Repository baseurl=https://repo.mongodb.com/yum/amazon/2023/mongodb-enterprise/8.0/$basearch/ gpgcheck=1 enabled=1 gpgkey=https://pgp.mongodb.com/server-8.0.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-8.0.repo
acima para instalar o MongoDB 8.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, 8.0
), depois a arquitetura (por exemplo, x86_64
).
Para instalar a versão estável mais recente do MongoDB Enterprise 8.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-8.0.0 mongodb-enterprise-database-8.0.0 mongodb-enterprise-server-8.0.0 mongodb-mongosh mongodb-enterprise-mongos-8.0.0 mongodb-enterprise-tools-8.0.0
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 -y mongodb-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 -y mongodb-mongosh-shared-openssl3
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-database mongodb-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-database mongodb-enterprise-tools mongodb-mongosh-shared-openssl3
Executar 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 impacto negativamente a operação do MongoDB e devem ser ajustados. Consulte Configurações do UNIX ulimit
para sistemas autogerenciados 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/mongo
seus arquivos de log em
/var/log/mongodb
Se você instalou pelo gerenciador de pacotes, estes diretórios padrão serão criados durante a instalação.
Se você instalou manualmente baixando os tarballs, você poderá criar os diretórios utilizando o mkdir -p <directory>
ou sudo mkdir -p
<directory>
dependendo do usuário que executará MongoDB. (Veja 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 do mongod
, você utilizará o sistema de inicialização integrado do sistema operacional. Versões recentes do Linux tendem a utilizar systemd (que utiliza o comando systemctl
), enquanto versões mais antigas do Linux tendem a utilizar System V init (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.
Inicie o MongoDB.
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.
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 mongod
Opcionalmente, você pode garantir que o MongoDB iniciará após reinicialização do sistema emitindo o seguinte comando:
sudo systemctl enable mongod
Pare o MongoDB.
Conforme necessário, você pode interromper o processo mongod
emitindo o seguinte comando:
sudo systemctl stop mongod
Reinicie o MongoDB.
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
.
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.
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.
Inicie o MongoDB.
Você pode iniciar o processo mongod
emitindo o seguinte comando:
sudo service mongod start
Verifique 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 on
Pare o MongoDB.
Conforme necessário, você pode interromper o processo mongod
emitindo o seguinte comando:
sudo service mongod stop
Reinicie o MongoDB.
Você pode reiniciar o processo mongod
emitindo o seguinte comando:
sudo service mongod restart
Você 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.
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.
Desinstalar MongoDB
Para remover completamente o MongoDB de um sistema, você deve remover os próprios aplicativos MongoDB, os arquivos de configuração e quaisquer diretórios que contenham dados e registros. A seção a seguir orienta você nas etapas necessárias.
Aviso
Esse processo removerá completamente o MongoDB, sua configuração e todos os bancos de dados. Este processo não é reversível, portanto, certifique-se de fazer backup de todas as suas configurações e dados antes de continuar.
Pare o MongoDB.
Interrompa o processo mongod
com o seguinte comando:
sudo service mongod stop
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 o mongod
só pode aceitar conexões de clientes que estejam executando na mesma máquina. Os clientes remotos não conseguirão se conectar ao mongod
e o mongod
não conseguirá inicializar um conjunto de réplicas, a menos que esse valor seja definido como uma interface de rede válida.
Este valor pode ser configurado de duas maneiras:
no arquivo de configuração do MongoDB com
bindIp
, oupor meio do argumento 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 | ||||||||
---|---|---|---|---|---|---|---|---|---|
mongodb-enterprise | Um metapackage que instala automaticamente os pacotes do componente listados abaixo. | ||||||||
mongodb-enterprise-database | Um
| ||||||||
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
|