Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / / /

Instale o MongoDB Enterprise Edition no Ubuntu

Nesta página

  • Visão geral
  • Considerações
  • Instale o MongoDB Enterprise Edition
  • Executar o MongoDB Enterprise Edition
  • Desinstalar MongoDB
  • Informações adicionais

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.

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.

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

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.

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.

Siga estas etapas para instalar o MongoDB Enterprise Edition usando o gerenciador de pacotes apt.

1

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
2

Crie o arquivo de lista /etc/apt/sources.list.d/mongodb-org-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
3

Dê o seguinte comando para recarregar a base de dados do pacote local:

sudo apt-get update
4

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.

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.

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.


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
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.

1

Emita o seguinte comando para iniciar mongod:

sudo service mongod start
2

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

3

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

sudo service mongod stop
4

Emita o seguinte comando para reiniciar mongod:

sudo service mongod restart
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.

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.

1

Interrompa o processo mongod com o seguinte comando:

sudo service mongod stop
2

Remova todos os pacotes do MongoDB que você instalou anteriormente.

sudo apt-get purge mongodb-enterprise*
3

Remova bancos de dados e arquivos de log do MongoDB.

sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/mongodb

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}

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, ou

  • por 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.

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.

Nome do Pacote
Descrição
mongodb-enterprise-server
Contém o daemon do mongod e 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:

Nome do Pacote
Descrição
mongodb-database-tools

Contém as seguintes ferramentas de banco de dados MongoDB:

mongodb-enterprise-database-tools-extra

Contém as seguintes ferramentas de suporte MongoDB:

Voltar

Instale usando .tgz Tarball