Menu Docs
Página inicial do Docs
/ /

Instalar o MongoDB Enterprise no macOS

Importante

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

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

Use este tutorial para instalar manualmente o MongoDB 8.2 Enterprise Edition no macOS usando um tarball .tgz baixado.

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.2 Edição de empreendimentos. Para instalar uma versão diferente do MongoDB Enterprise, use a lista suspensa de versões em Self-Managed Deployments no lado esquerdo desta página para selecionar a documentação dessa versão.

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 8.2 Enterprise Edition é compatível com o macOS 11 ou posterior.

Para obter mais informações, consulte Suporte à plataforma.

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

Faça o download do pacote para a versão de mongosh de que você precisa no Centro de Download do MongoDB e descompacte o pacote.

Considerações 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.

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

1

Antes de iniciar o MongoDB pela primeira vez, você deve criar o diretório para o qual o processo do mongod gravará os dados.

Por exemplo, para criar o diretório ~/data/db:

sudo mkdir -p ~/data/db
2

Você também deve criar o diretório no qual o processo mongod escreverá seu arquivo de log:

Por exemplo, para criar o diretório ~/data/log/mongodb:

sudo mkdir -p ~/data/log/mongodb
3

Certifique-se de que a conta de usuário que executa mongod tenha permissões de leitura e gravação para esses dois diretórios. Se você estiver executando mongod como sua própria conta de usuário e tiver acabado de criar os dois diretórios acima, eles já deverão estar acessíveis ao seu usuário. Caso contrário, você pode usar chown para definir a propriedade, substituindo o usuário apropriado:

sudo chown <user> ~/data/db
sudo chown <user> ~/data/log/mongodb
4

Para executar MongoDB, execute o mongod processo no prompt do sistema, fornecendo os dois parâmetros dbpath e logpath acima, e o comando nohup para executar mongod no background. Alternativamente, você pode optar por armazenar os valores para dbpath, logpath e muitos outros parâmetros em um arquivo de configuração.

Execute o processo do mongod no prompt do sistema, fornecendo os três parâmetros necessários diretamente na linha de comando:

nohup mongod --dbpath ~/path/to/dbdir --logpath ~/path/to/mongodb.log >/dev/null &

Execute o processo do mongod no prompt do sistema, fornecendo o caminho para um arquivo de configuração com o parâmetro config :

mongod --config /usr/local/etc/mongod.conf

macOS pode impedir que o mongod seja executado após a instalação. Se você receber um erro de segurança ao iniciar o mongod indicando que o desenvolvedor não pôde ser identificado ou verificado, faça o seguinte para conceder acesso ao mongod para executar:

  • Abra as Preferências do sistema

  • Selecione o painel Segurança e Privacidade.

  • Na aba Geral, clique no botão à direita da mensagem sobre mongod, rotulado com Open Anyway ou Allow Anyway dependendo da sua versão do macOS.

5

Verifique se o MongoDB foi iniciado com sucesso:

ps aux | grep -v grep | grep mongod

Se você não vir um processo mongod em execução, verifique se há mensagens de erro no arquivo de log.

6

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 em execução em seu localhost com a porta padrão de 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 ajudar você a começar a usar o MongoDB, o MongoDB fornece guias de introdução em várias edições de drivers. Consulte Introdução ao MongoDB para ver as edições disponíveis.

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.

Voltar

Instale usando .tgz Tarball

Nesta página