Visão geral
Use este tutorial para instalar manualmente o MongoDB 8.0 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.
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
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.0 Enterprise Edition é compatível com o macOS 11 ou posterior.
Para obter mais informações, consulte Suporte à plataforma.
Notas de produção
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.
Instale o MongoDB Enterprise Edition
Para instalar manualmente a edição MongoDB Enterprise a partir de .tgz, selecione a aba que corresponde ao processador do seu Mac e siga as seguintes etapas:
Baixar o tarball.
Baixe o tarball tgz do MongoDB Enterprise usando o link abaixo:
➤ Centro de downloads do MongoDB
Na menu suspenso Version, selecione a versão do MongoDB para baixar.
No menu suspenso Platform, selecione macOS ARM 64.
No menu suspenso Package, selecione tgz.
Clique em Download.
Verifique se os binários estão em um diretório listado em sua PATH variável de ambiente do.
Os binários do MongoDB estão no diretório bin/ do tarball. Você também pode:
Copie os binários para um diretório listado na sua variável
PATH, como/usr/local/bin. Substitua/path/to/the/mongodb-directory/pelo seu diretório de instalação.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 sua variável
PATH, como/usr/local/bin. Substitua/path/to/the/mongodb-directory/pelo seu diretório de instalação.sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/
Baixar o tarball.
Baixe o tarball tgz do MongoDB Enterprise usando o link abaixo:
➤ Centro de downloads do MongoDB
Na lista suspensa Version, selecione a versão do MongoDB para baixar.
No menu suspenso Platform, selecione macOS ARM 64.
No menu suspenso Package, selecione tgz.
Clique em Download.
Verifique se os binários estão em um diretório listado em sua PATH variável de ambiente do.
Os binários do MongoDB estão no diretório bin/ do tarball. Você também pode:
Copie os binários para um diretório listado na sua variável
PATH, como/usr/local/bin. Substitua/path/to/the/mongodb-directory/pelo seu diretório de instalação.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 sua variável
PATH, como/usr/local/bin. Substitua/path/to/the/mongodb-directory/pelo seu diretório de instalação.sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/
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 impactar negativamente a operação do MongoDB e devem ser ajustados. Consulte UNIX
ulimitConfigurações para implantações autogerenciadas para obter as configurações recomendadas para sua plataforma.Observação
Se o valorulimitpara 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 em que o processo mongod gravará os dados.
Por exemplo, para criar o diretório ~/data/db:
sudo mkdir -p ~/data/db
Crie o diretório de registro.
Você também deve criar o diretório em que o processo mongod gravará seu arquivo de log.
Por exemplo, para criar o diretório ~/data/log/mongodb:
sudo mkdir -p ~/data/log/mongodb
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á devem 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.
As etapas para executar o MongoDB Enterprise Edition dependem de você ter conexões TLS habilitadas ou não.
Para executar o MongoDB Enterprise Edition com conexões TLS ativadas, é possível escolher um dos seguintes métodos:
Execute com parâmetros de linha de mongod comando
Para executar o MongoDB Enterprise Edition como um processo em segundo plano, especifique as opções dbpath, logpath e fork:
mongod --dbpath ~/data/db --logpath ~/data/log/mongodb/mongo.log --fork
Execute com um arquivo de mongod configuração
Alternativamente, você pode armazenar os valores para dbpath, logpath, fork em um arquivo de configuração.
Execute o processo mongod na linha de comando, fornecendo o caminho para um arquivo de configuração com o parâmetro config:
mongod --config /usr/local/etc/mongod.conf
Para executar o MongoDB Enterprise Edition sem conexões TLS habilitadas, use GNU Screen e siga estas etapas:
Iniciar mongod
mongod --config /opt/homebrew/etc/mongod.conf
Verifique se o MongoDB foi iniciado com sucesso.
Para verificar se o mongod foi iniciado com êxito, execute o seguinte comando e verifique a lista de processos para um processo do mongod:
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.
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 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.
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.