Instale o MongoDB Enterprise Edition no Ubuntu
Nesta página
Visão geral
Use este tutorial para instalar o MongoDB 8.0 Enterprise Edition nas versões LTS (suporte de longo prazo) do Ubuntu Linux usando o gerenciador de pacotes apt
.
O MongoDB Enterprise Edition está disponível em plataformas selecionadas e contém suporte para vários recursos relacionados à segurança e ao monitoramento.
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 as seguintes versões 64-bit Ubuntu LTS (suporte de longo prazo) na arquitetura x86_64 :
24.04 LTS ("Noble")
22.04 LTS ("Jammy")
20.04 LTS ("Focal")
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 8.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, 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.
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 compatível com a MongoDB Inc. O pacote oficial 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 mongodb-enterprise
oficial. Se você já tiver instalado o pacote mongodb
em seu sistema Ubuntu, você deverá primeiro desinstalar o pacote mongodb
antes de prosseguir com estas instruções.
Consulte Pacotes do MongoDB Enterprise Edition para obter a lista completa de pacotes oficiais.
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-8.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \ --dearmor
Crie o arquivo de lista.
Crie o arquivo de lista /etc/apt/sources.list.d/mongodb-enterprise-8.0.list
para sua versão do Ubuntu.
Crie o arquivo de lista para o Ubuntu 24.04 (Noble):
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.com/apt/ubuntu noble/mongodb-enterprise/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.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-8.0.gpg ] https://repo.mongodb.com/apt/ubuntu jammy/mongodb-enterprise/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.0.list
Crie o arquivo de lista para o Ubuntu 20.04 (Focal).
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] http://repo.mongodb.com/apt/ubuntu focal/mongodb-enterprise/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.0.list
Instale o MongoDB Enterprise Edition.
Para instalar a versão mais recente do MongoDB Enterprise Edition, 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=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
Se você instalar o mongodb-enterprise=8.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/mongodb
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 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 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.
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
, e não o pacote mongodb
não oficial fornecido pelo Ubuntu, e 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.
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.
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.
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
Atualizando o MongoDB Enterprise Edition
Ao atualizar o MongoDB Enterprise Edition, certifique-se de que esteja usando os pacotes oficiais. Especifique a mesma versão para cada componente como neste exemplo:
VERSION=6.0.7 sudo apt-get install -y \ mongodb-enterprise=${VERSION} \ mongodb-enterprise-server=${VERSION} \ mongodb-enterprise-mongos=${VERSION} \ mongodb-enterprise-tools=${VERSION}
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
|