Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Instalar o MongoDB Enterprise no Debian (.tgz)

Use este tutorial para instalar manualmente o MongoDB 9.0 Enterprise Edition no Debian Linux usando um tarball .tgz baixado.

MongoDB Enterprise Edition is available on select platforms and contains support for features related to security and monitoring.

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.

Embora você possa instalar o MongoDB manualmente usando um .tgz tarball baixado, conforme descrito neste documento, recomendamos usar o gerenciador de pacote apt em seu sistema, se possível. A utilização de um gerenciador de pacote instala automaticamente todas as dependências necessárias, fornece um arquivo de exemplo mongod.conf e simplifica futuras tarefas de atualização e manutenção.

➤ Consulte Instalar o MongoDB usando o gerenciador de pacotes apt para obter instruções.

Ao utilizar o pacote .tgz para instalar o servidor, você precisa seguir as instruções de instalação do mongosh para baixar e instalar o mongosh separadamente.

MongoDB 9.0 A edição Enterprise suporta as seguintes versões Debian 64bits na arquitetura x86_64 :

  • Debian 13 "Trixie"

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, consulte o documento Notas de produção para implementações autogerenciadas para obter considerações de desempenho e recomendações de configuração.

Use o comando a seguir para instalar as dependências necessárias para o tarball MongoDB Enterprise .tgz:

sudo apt-get install libcurl4 libgssapi-krb5-2 libldap-common libwrap0 libsasl2-2 libsasl2-modules libsasl2-modules-gssapi-mit openssl liblzma5

Siga estas etapas para instalar manualmente o MongoDB Enterprise Edition a partir do .tgz.

1

Após instalar os pacotes de pré-requisitos exigidos, baixe o tarball do MongoDB Enterprise tgz pelo seguinte link:

➤

Centro de downloads do MongoDB

  1. Na lista suspensa Version, selecione a versão do MongoDB para baixar.

  2. No menu suspenso Platform, selecione a versão e arquitetura do sistema operacional.

  3. No menu suspenso Package, selecione tgz.

  4. Clique em Download.

2

Usando um programa gerente de arquivos ou o comando tar, extraia os arquivos. Por exemplo, a partir de um shell do sistema, você pode extrair usando o comando tar:

tar -zxvf mongodb-*-9.0.0.tgz
3

Os binários do MongoDB estão no diretório bin/ do tarball. Você também pode:

  • Copiar os binários em um diretório listado em sua variável PATH, como /usr/local/bin (atualize /path/to/the/mongodb-directory/ com seu diretório de instalação conforme apropriado)

    sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/
  • Crie links simbólicos para os binários a partir de um diretório listado na variável sua PATH, como /usr/local/bin (atualize /path/to/the/mongodb-directory/ com seu diretório de instalação conforme apropriado):

    sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/
4

Instalar mongosh em seguida, use o MongoDB Shell para conectar à sua implantação.

Download the package for the version of mongosh you need from the MongoDB Download Center and uncompress the package.

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

Siga estas etapas para executar a edição MongoDB Enterprise. Estas instruções presumem que você esteja usando as configurações padrão.

1

Crie um diretório onde a instância do MongoDB armazenará seus dados. Por exemplo:

sudo mkdir -p /var/lib/mongo

Crie um diretório em que a instância do MongoDB armazene seu log. Por exemplo:

sudo mkdir -p /var/log/mongodb

O usuário que inicia o processo do MongoDB deve ter permissão de leitura e gravação nesses diretórios. Por exemplo, se você pretende executar o MongoDB como você mesmo:

sudo chown `whoami` /var/lib/mongo # Or substitute another user
sudo chown `whoami` /var/log/mongodb # Or substitute another user
2

Para executar MongoDB, execute o processo mongod no prompt do sistema.

mongod --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --fork

Para detalhes sobre as opções de linha de comando --dbpath e --logpath, consulte Opções.

3

Verifique se o MongoDB começou com sucesso verificando a saída do processo para a seguinte linha no arquivo de log /var/log/mongodb/mongod.log:

[initandlisten] waiting for connections on port 27017

Você poderá ver avisos não críticos como resultado do processo. Desde que veja a linha de registro mostrada acima, você pode ignorar com segurança esses avisos durante sua avaliação inicial do MongoDB.

4

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.

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.