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
Página inicial do Docs
/ /
Instale no Linux
Página inicial do Docs
/ /
Enterprise
/
Instale no Linux
Página inicial do Docs
/
Gestão
/
Instalação
/
Enterprise
/
Instale no Linux

Instale o MongoDB Enterprise Edition no Red Hat ou CentOS

Importante

MongoDB 8.3 é a versão menor mais recente. A partir do MongoDB 8.2, versões secundárias estão disponíveis para implantações locais (Community e EA) para casos de uso específicos. Para obter mais informações, consulte a seção Versões do MongoDB.

Para instalar a versão mais recente do MongoDB compatível com uso local, consulte as instruções de instalação.

Visão geral

Use este tutorial para instalar o MongoDB 8.3 Enterprise Edition no Red Hat Enterprise Linux, CentOS Linux ou Oracle Linux [1] usando o gerenciador de pacote apt .

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.3 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.3 A edição Enterprise suporta as seguintes versões de 64bits do Red Hat Enterprise Linux (RHEL), CentOS Linux, Oracle Linux [1], Rocky Linux e AlmaLinux [2] em x86_64 arquitetura:

  • 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.3 Enterprise Edition 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) O MongoDB é compatível apenas com o Oracle Linux que executa o Red Hat Compatible Kernel (RHCK). O MongoDB não suporta o 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 apt.

1

Configurar o repositório.

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

[mongodb-enterprise-8.3]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/redhat/10/mongodb-enterprise/8.3/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-8.0.asc
[mongodb-enterprise-8.3]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/redhat/9/mongodb-enterprise/8.3/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-8.0.asc
[mongodb-enterprise-8.3]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/redhat/8/mongodb-enterprise/8.3/$basearch/
gpgcheck=1
enabled=1
gpgkey=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.3.repo acima para instalar o MongoDB 8.3.

Você também pode baixar os .rpm arquivos diretamente do Repositório do MongoDB . Os downloads são organizados pela versão do Red Hat / CentOS (por9 exemplo,), pela versão de lançamento do MongoDB (por8.3 exemplo,) e pela arquitetura (porx86_64 exemplo,).

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

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 yum install -y mongodb-enterprise-8.3.7 mongodb-enterprise-database-8.3.7 mongodb-enterprise-server-8.3.7 mongodb-mongosh mongodb-enterprise-mongos-8.3.7 mongodb-enterprise-tools-8.3.7

Observação

Embora você possa especificar qualquer versão disponível do MongoDB Enterprise, o yum atualiza os pacotes quando uma versão mais nova se tornar disponível. Para evitar atualizações indesejadas, fixe o pacote adicionando a seguinte diretiva exclude ao seu arquivo /etc/yum.conf:

exclude=mongodb-enterprise,mongodb-enterprise-database,mongodb-enterprise-server,mongodb-enterprise-shell,mongodb-enterprise-mongos,mongodb-enterprise-tools

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 -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 yum remove -y mongodb-mongosh && sudo yum 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 yum 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 yum install -y mongodb-enterprise-database
mongodb-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 impacto negativamente a operação do MongoDB e devem ser ajustados.Consulte Configurações do Ulimit do UNIX 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.

Caminhos de Diretório

Para Usar Diretórios Padrão

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

  • /var/lib/mongo (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 mongod.

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.

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 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 mongod instância 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-selinux
    make

  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 mongodb_admin macro. Esta macro não está incluída na política do SELinux do MongoDB . Um administrador no unconfined_t domínio pode mongod gerenciar.

  • 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 na mongosh mesma máquina host que o.mongod Você pode executar o sem quaisquer mongosh mongod opções de linha de comando para conectar a um 27017que está executando no seu localhost com porta padrão.

mongosh

Para obter mais informações sobre como conectar-se usandomongosh, como conectar-se a uma instânciamongodem 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 drivers. Para obter a documentação do driver, consulte Começar a desenvolver com MongoDB.

1
Inicie o MongoDB.

Você pode iniciar o processo mongod emitindo o seguinte comando:

sudo service mongod start
2
Verifique se o MongoDB foi iniciado com sucesso.

Você pode verificar se o processo mongod começou com sucesso verificando o conteúdo do arquivo de log em /var/log/mongodb/mongod.log para uma linha de leitura

[initandlisten] waiting for connections on port <port>

onde <port> é a porta configurada em /etc/mongod.conf, 27017 por padrão.

Opcionalmente, você pode garantir que o MongoDB iniciará após reinicialização do sistema emitindo o seguinte comando:

sudo chkconfig mongod on
3
Pare o MongoDB.

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

sudo service mongod stop
4
Reinicie o MongoDB.

Você pode reiniciar o processo mongod emitindo o seguinte comando:

sudo service mongod restart

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 na mongosh mesma máquina host que o.mongod Você pode executar o sem quaisquer mongosh mongod opções de linha de comando para conectar a um 27017que está executando no seu localhost com porta padrão.

mongosh

Para obter mais informações sobre como conectar-se usandomongosh, como conectar-se a uma instânciamongodem 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 drivers. Para obter a documentação do driver, consulte Começar a desenvolver com 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/mongodb
sudo 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