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

Instale o MongoDB Enterprise Edition no Debian

Nesta página

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

Observação

MongoDB Atlas

O MongoDB Atlas é uma opção de serviço MongoDB hospedado em nuvem que não requer sobrecarga de instalação e oferece camada grátis para começar.

Use este tutorial para instalar a edição MongoDB 7.0 Enterprise usando o apt gerenciador de pacotes.

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 MongoDB 7.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 7.0 A edição Enterprise suporta as seguintes versões Debian de 64-bit na arquitetura x86_64 :

  • Debian 12 "Bookworm"

  • Debian 11 "bullseye"

O MongoDB é compatível somente com as versões de 64 bits dessas plataformas.

Consulte Suporte da Plataforma para obter mais informações.

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 Debian, 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 Debian não é mantido pela MongoDB Inc. e entra em conflito com o pacote mongodb-enterprise oficial. Se já tiver instalado o mongodb pacote em seu sistema Debian, você deverá primeiro desinstalar o mongodb pacote 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-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
--dearmor
2

Crie o arquivo de lista usando o comando apropriado para sua versão do Debian:

echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] http://repo.mongodb.com/apt/debian bookworm/mongodb-enterprise/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] http://repo.mongodb.com/apt/debian bullseye/mongodb-enterprise/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list

Se quiser instalar pacotes do MongoDB Enterprise a partir de uma determina série de versões, você poderá especificar a série de versões de uma versão do MongoDB que é compatível com sua compilação Debian na configuração do repositório. Por exemplo, para restringir o sistema à série de versão 6.0, adicione o seguinte repositório:

echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] http://repo.mongodb.com/apt/debian bullseye/mongodb-enterprise/6.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-6.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=7.0.14 mongodb-enterprise-database=7.0.14 mongodb-enterprise-server=7.0.14 mongodb-mongosh mongodb-enterprise-mongos=7.0.14 mongodb-enterprise-tools=7.0.14

Se você instalar o mongodb-enterprise=7.0.14 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

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 o MongoDB Enterprise Edition 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 pelo Debian, e estão 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.


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

By default, MongoDB launches with bindIp set to 127.0.0.1, which binds to the localhost network interface. This means that the mongod can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod, and the mongod will not be able to initialize a replica set unless this value is set to a valid network interface which is accessible from the remote clients.

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