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.

Instale o MongoDB Enterprise Edition no Red Hat ou CentOS

Visão geral

Use this tutorial to install MongoDB 8.0 Enterprise Edition on Red Hat Enterprise Linux, CentOS Linux, or Oracle Linux [1] using the YUM package manager.

O MongoDB Enterprise Edition está disponível em plataformas selecionadas e é compatível com recursos relacionados à segurança e 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 Enterprise Edition supports the following 64-bit versions of Red Hat Enterprise Linux (RHEL), CentOS Linux, Oracle Linux [1], Rocky Linux, and AlmaLinux [2] on x86_64 architecture:

  • RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 10

  • RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 9

  • RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 8

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

MongoDB 8.0 A Edição Enterprise em RHEL / CentOS / Oracle / Rocky / Alma Linux também suporta a arquitetura ARM64 em plataformas selecionadas.

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

[1](1, 2) MongoDB only supports Oracle Linux running the Red Hat Compatible Kernel (RHCK). MongoDB does not support the Unbreakable Enterprise Kernel (UEK).

[2] Os produtos locais do MongoDB lançados para RHEL versão 8.0+ são compatíveis e suportados no Rocky Linux versão 8.0+ e AlmaLinux versão 8.0+, dependendo dessas distribuições cumprirem sua obrigação de fornecer compatibilidade total com RHEL.

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.

Instale o MongoDB Enterprise Edition

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

1

Configurar o repositório.

Crie um arquivo /etc/yum.repos.d/mongodb-enterprise-8.0.repo para instalar o MongoDB Enterprise diretamente utilizando o yum:

[mongodb-enterprise-8.0]name=MongoDB Enterprise Repositorybaseurl=https://repo.mongodb.com/yum/redhat/10/mongodb-enterprise/8.0/$basearch/gpgcheck=1enabled=1gpgkey=https://pgp.mongodb.com/server-8.0.asc

Observação

Se você tiver um arquivo mongodb-enterprise.repo neste diretório a partir de uma instalação anterior do MongoDB, deverá removê-lo. Use o arquivo mongodb-enterprise-8.0.repo acima para instalar o MongoDB 8.0.

Você também pode baixar os arquivos .rpm diretamente do Repositório do MongoDB. As transferências são organizadas pela versão Red Hat/CentOS (por exemplo, 9), em seguida, a versão de lançamento do MongoDB (por exemplo, 8.0), depois a arquitetura (por exemplo, x86_64).

2

Instale o MongoDB Enterprise Edition.

Para instalar a versão estável mais recente do MongoDB Enterprise 8.0, emita o seguinte comando:

sudo yum install -y mongodb-enterprise

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 yum 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 yum remove -y mongodb-mongosh && sudo yum install -ymongodb-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 yum remove -y mongodb-mongosh && sudo yum install -ymongodb-mongosh-shared-openssl3

Se o MongoDB Shell não iniciar com o seguinte erro, instale o pacote mongodb-mongosh-shared-openssl3 usando os comandos anteriores:

mongosh: OpenSSL configuration error: ...:error:030000A9:digitalenvelope routines:alg_module_init:unknownoption:../deps/openssl/openssl/crypto/evp/evp_cnf.c:61:name=rh-allow-sha1-signatures,value=yes

O erro afeta o RHEL 9+ e derivados, como o Amazon Linux 2023.

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 yum install -y mongodb-enterprise-databasemongodb-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 yum install -y mongodb-enterprise-databasemongodb-enterprise-tools mongodb-mongosh-shared-openssl3

Executar o MongoDB Enterprise Edition

ulimit

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.

Caminhos de Diretório

Para Usar Diretórios Padrão

Por padrão, o MongoDB é executado com a conta de usuário mongodb e utiliza os seguintes diretórios padrão:

  • /var/lib/mongodb (o diretório de dados)

  • /var/log/mongodb (o diretório log)

O gerenciador de pacotes cria os diretórios padrão durante a instalação. O proprietário e o nome do grupo são mongodb.

Para Usar Diretórios Não Padrão

Para usar um diretório de dados e/ou diretório de registros diferente dos diretórios padrão:

  1. Crie o novo diretório ou diretórios.

  2. Edite o arquivo de configuração /etc/mongod.conf e modifique os campos de acordo:

    • storage.dbPath para especificar um novo caminho do diretório de dados , como /some/data/directory

    • systemLog.path para especificar um novo caminho de arquivo de log , como /some/log/directory/mongod.log

  3. Certifique-se de que o usuário que executa o MongoDB tenha acesso ao diretório ou diretórios:

    sudo chown -R mongod:mongod <directory>

    Se você alterar o usuário que executa o processo MongoDB,deverá conceder ao novo usuário acesso a esses diretórios.

  4. Configure o SELinux, se aplicado. Consulte Configurar o SELinux.

Configurar SELinux

A partir do MongoDB 5.0, uma nova política do SELinux está disponível para instalações do MongoDB que:

  • Use um instalador .rpm.

  • Use as configurações padrão.

  • Execute no RHEL7 ou posterior.

Se a sua instalação não atender estes requisitos, consulte as Instruções do SELinux para pacotes do .tgz.

Observação

Se o seu MongoDB deployment usar configurações personalizadas para qualquer um dos itens a seguir:

Você não pode usar a política do SELinux fornecida pelo MongoDB. Uma alternativa é criar uma política SELinux personalizada; no entanto, uma política personalizada escrita incorretamente pode ser menos segura ou pode impedir que sua instância mongod funcione.

Instalar a Política do SELinux

  1. Certifique-se de ter os seguintes pacotes instalados:

    • git

    • make

    • checkpolicy

    • policycoreutils

    • selinux-policy-devel

    sudo yum install git make checkpolicy policycoreutils selinux-policy-devel

  2. Baixe o repositório de políticas.

    git clone https://github.com/mongodb/mongodb-selinux

  3. Crie a política.

    cd mongodb-selinuxmake

  4. Aplique a política.

    sudo make install

Importante

Funcionalidade incompatível com versões anteriores

A partir do MongoDB 5.1, você deve executar o seguinte comando no diretório no qual a política do SELinux foi clonada anteriormente antes de fazer desatualizar para uma versão anterior do MongoDB:

sudo make uninstall

Política do SELinux Considerações

  • A política do SELinux foi projetada para funcionar com a configuração resultante de uma instalação de pacote padrão do MongoDB .rpm. Consulte as suposições de instalação padrão para mais detalhes.

  • A política do SELinux foi projetada para servidores do mongod. Não se aplica a outros daemons ou ferramentas do MongoDB, como:

  • A política de referência fornecida pelo Projeto SELinux inclui uma macro mongodb_admin. Esta macro não está incluída na política do SELinux do MongoDB . Um administrador no domínio unconfined_t pode gerenciar mongod.

  • Para desinstalar a política, acesse o diretório onde você baixou o repositório de políticas e execute:

    sudo make uninstall

Procedimento

Siga estas etapas para executar o MongoDB Enterprise Edition em seu sistema. Estas instruções pressupõem que você esteja 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.

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

2
Verifique se o MongoDB foi iniciado com sucesso.

Você pode verificar se o processo mongod começou com sucesso emitindo o seguinte comando:

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
Pare o MongoDB.

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

sudo systemctl stop mongod
4
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.

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

1

Pare o MongoDB.

Interrompa o processo mongod com o seguinte comando:

sudo service mongod stop
2

Remova Pacotes.

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

sudo yum erase $(rpm -qa | grep mongodb-enterprise)
3

Remova Diretórios de Dados.

Remova bancos de dados e arquivos de log do MongoDB.

sudo rm -r /var/log/mongodbsudo rm -r /var/lib/mongo

Informações adicionais

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

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 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 no Linux
Próximo
Instale usando .tgz Tarball
Avalie esta página

Nesta página