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 manualmente o MongoDB 8.3 Enterprise Edition no macOS usando um tarball .tgz baixado.
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
MongoDB Shell, mongosh
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.
Suporte a plataformas
MongoDB 8.3 A edição Enterprise suporta macOS 14 ou posterior e requer uma arquitetura de CPU Has disso ou mais recente.
Para obter mais informações, consulte Suporte à plataforma.
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
Para instalar manualmente a edição MongoDB Enterprise a partir do .tgz, complete as seguintes etapas:
Baixar o tarball.
Após instalar os pacotes de pré-requisitos exigidos, baixe o tarball do MongoDB Enterprise tgz pelo seguinte link:
➤
Centro de downloads do MongoDB
Na lista suspensa Version, selecione a versão do MongoDB para baixar.
No menu suspenso Platform, selecione a versão e arquitetura do sistema operacional.
No menu suspenso Package, selecione tgz.
Clique em Download.
(Opcional) Garanta binários no PATH.
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/
(Opcional) Instale o MongoDB Shell (mongosh).
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.
Executar o MongoDB Enterprise Edition
- Considerações 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
ulimitpara o número de arquivos abertos estiver em64000, o MongoDB gerará um aviso de inicialização.
Procedimento
Siga estas etapas para executar a edição MongoDB Enterprise. Estas instruções presumem que você esteja usando as configurações padrão.
Crie o diretório de dados.
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
Defina permissões para os diretórios de dados e registro.
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
Execute o MongoDB.
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 mongod com parâmetros de linha de comando
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 mongod com um arquivo de configuração
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 Configurações do sistema
Clique em Privacidade e segurança na barra lateral.
Na seção Segurança, clique no botão Open Anyway à direita da mensagem sobre
mongod.
Comece a usar o MongoDB.
Inicie uma sessão na mongosh mesma máquina host que o.mongod Você pode executar o sem quaisquer opções de mongosh linha de comando para conectar a um que está mongod executando no seu localhost com a porta padrão 27017 do:
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 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.
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, oupor 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.