Visão geral
Use este tutorial para instalar o MongoDB 9.0 MongoDB Enterprise Edition em versões LTS (suporte de longo prazo) do Ubuntu Linux usando o gerenciador de pacotes APT.
MongoDB Enterprise Edition is available on select platforms and contains support for features related to security and monitoring.
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 no canto superior esquerdo desta página para selecionar a documentação dessa versão.
Considerações
Suporte a plataformas
MongoDB 9.0 O Enterprise Edition é compatível com as seguintes versões de 64-bit Ubuntu LTS (suporte de longo prazo) na arquitetura x86_64 :
26.04 LTS ("Resolute")
24.04 LTS ("Noble")
22.04 LTS ("Jammy")
O MongoDB oferece suporte apenas às versões de 64 bits dessas plataformas. Para determinar qual versão do Ubuntu seu host está executando, execute o seguinte comando no terminal do host:
cat /etc/lsb-release
MongoDB 9.0 A edição Enterprise no Ubuntu também oferece suporte à arquitetura ARM64 em plataformas selecionadas.
Consulte Suporte da Plataforma para obter mais informações.
Para versões anteriores do MongoDB Enterprise compatíveis com Ubuntu 16.04 POWER/PPC64LE:
Devido a um bug de elisão de trava presente em versões mais antigas do pacote glibc no Ubuntu 16.04 para POWER, você deve atualizar o pacote glibc para pelo menos glibc 2.23-0ubuntu5 antes de executar o MongoDB. Sistemas com versões mais antigas do pacote glibc sofrerão falhas e mau comportamento no servidor de banco de dados devido à corrupção aleatória da memória e são inadequados para sistemas de produção do MongoDB
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.
Pacotes oficiais do MongoDB
Para instalar o MongoDB Enterprise em seu sistema Ubuntu, estas instruções utilizarão o pacote oficial do mongodb-enterprise , que é mantido e suportado pela MongoDB Inc. O pacote oficial do mongodb-enterprise sempre contém a versão mais recente do MongoDB e está disponível em seu próprio repositório dedicado.
Importante
O pacote mongodb fornecido pela Ubuntu não é mantido pela MongoDB Inc. e entra em conflito com o pacote oficial mongodb-enterprise. Se você já instalou o mongodb pacote em seu sistema Ubuntu, você deverá primeiro desinstalar o mongodb pacote antes de prosseguir com estas instruções.
See MongoDB Enterprise Edition Packages for the complete list of official packages.
Instale o MongoDB Enterprise Edition
Siga estas etapas para instalar o MongoDB Enterprise Edition usando o gerenciador de pacotes APT.
Importe a chave pública.
A partir de um terminal, instale gnupg e curl, se ainda não estiverem disponíveis:
sudo apt-get install gnupg curl
Para importar a chave GPG pública do MongoDB, execute o seguinte comando:
curl -fsSL https://pgp.mongodb.com/server-9.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-9.gpg \ --dearmor
Crie o arquivo de lista.
Crie o arquivo de lista /etc/apt/sources.list.d/mongodb-enterprise-9.0.list para sua versão do Ubuntu.
Crie o arquivo de lista para o Ubuntu 26.04 (Resolute):
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-9.gpg ] https://repo.mongodb.com/apt/ubuntu resolute/mongodb-enterprise/9.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-9.0.list
Crie o arquivo de lista para o Ubuntu 24.04 (Noble):
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-9.gpg ] https://repo.mongodb.com/apt/ubuntu noble/mongodb-enterprise/9.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-9.0.list
Crie o arquivo de lista para o Ubuntu 22.04 (Jammy):
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-9.gpg ] https://repo.mongodb.com/apt/ubuntu jammy/mongodb-enterprise/9.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-9.0.list
Instale o MongoDB Enterprise Edition.
Para instalar a versão estável mais recente, execute o seguinte comando:
sudo apt-get 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 apt-get install -y mongodb-enterprise=9.0.0 mongodb-enterprise-database=9.0.0 mongodb-enterprise-server=9.0.0 mongodb-mongosh mongodb-enterprise-mongos=9.0.0 mongodb-enterprise-tools=9.0.0
Se você instalar o mongodb-enterprise=9.0.0 somente e não incluir os pacotes de componentes, a versão mais recente de cada pacote MongoDB será instalada independentemente da versão especificada.
Embora você possa especificar qualquer versão disponível do MongoDB, o apt-get atualizará os pacotes quando uma versão mais nova se tornar disponível. Para evitar atualizações não intencionais, fixe o pacote. Para fixar a versão do MongoDB na versão instalada atualmente, emita a seguinte sequência de comando:
echo "mongodb-enterprise hold" | sudo dpkg --set-selections echo "mongodb-enterprise-server hold" | sudo dpkg --set-selections echo "mongodb-enterprise-database hold" | sudo dpkg --set-selections echo "mongodb-mongosh hold" | sudo dpkg --set-selections echo "mongodb-enterprise-mongos hold" | sudo dpkg --set-selections echo "mongodb-enterprise-tools hold" | sudo dpkg --set-selections
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 apt-get 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 apt-get remove -y mongodb-mongosh && sudo apt-get 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 apt-get remove -y mongodb-mongosh && sudo apt-get 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 apt-get 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 apt-get install -y mongodb-enterprise-database mongodb-enterprise-tools mongodb-mongosh-shared-openssl3
Para obter ajuda na solução de erros encontrados ao instalar o MongoDB no Ubuntu, consulte nosso guia de solução de problemas.
Executar o MongoDB Enterprise Edition
Por padrão, uma instância MongoDB armazena:
seus arquivos de dados em
/var/lib/mongodbseus 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 mongodb. Se você alterar o usuário que executa o processo MongoDB, também deverá modificar a permissão /var/lib/mongodb 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.
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.
Procedimento
Siga estas etapas para executar a edição MongoDB Enterprise em seu sistema. Estas instruções pressupõem que você esteja usando o pacote oficial mongodb-enterprise, não o pacote mongodb não oficial fornecido pela Ubuntu, e estão 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.
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.
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.
Start a mongosh session on the same host machine as the mongod. You can run mongosh without any command-line options to connect to a mongod that is running on your localhost with default port 27017.
mongosh
For more information on connecting using mongosh, such as to connect to a mongod instance running on a different host and/or port, see the mongosh documentation.
To help you start using MongoDB, MongoDB provides Getting Started Guides in various driver editions. For the driver documentation, see Start Developing with MongoDB.
Inicie o MongoDB.
Emita o seguinte comando para iniciar mongod:
sudo service mongod start
Verifique se o MongoDB foi iniciado com sucesso.
Verifique se o processo mongod foi iniciado com sucesso:
sudo service mongod status
Você também pode verificar no arquivo de log o status atual do processo mongod, localizado em: /var/log/mongodb/mongod.log por padrão. Uma instância mongod em execução indicará que está pronta para conexões com a seguinte linha:
[initandlisten] waiting for connections on port 27017
Pare o MongoDB.
Conforme necessário, você pode interromper o processo mongod emitindo o seguinte comando:
sudo service mongod stop
Reinicie o MongoDB.
Emita o seguinte comando para reiniciar mongod:
sudo service mongod restart
Comece a usar o MongoDB.
Start a mongosh session on the same host machine as the mongod. You can run mongosh without any command-line options to connect to a mongod that is running on your localhost with default port 27017.
mongosh
For more information on connecting using mongosh, such as to connect to a mongod instance running on a different host and/or port, see the mongosh documentation.
To help you start using MongoDB, MongoDB provides Getting Started Guides in various driver editions. For the driver documentation, see Start Developing with MongoDB.
Informações adicionais
Atualizando o MongoDB Enterprise Edition
When upgrading MongoDB Enterprise Edition, ensure that you are using the official packages. Specify the same version for each component as in this example:
VERSION=${VERSION} sudo apt-get install -y \ mongodb-enterprise=${VERSION} \ mongodb-enterprise-server=${VERSION} \ mongodb-enterprise-mongos=${VERSION} \ mongodb-enterprise-tools=${VERSION} \ --allow-downgrades --allow-change-held-packages
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 |
|---|---|
| Um |
| Um
|
| Contains the MongoDB Shell ( |
| Contains the MongoDB Shell that uses the OpenSSL version already installed on your computer ( |
| Um
|