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 Windows baixando e extraindo o arquivo zip.
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.
Método de instalação
Este tutorial instala o MongoDB no Windows extraindo de um arquivo zip. Você também pode instalar o MongoDB no Windows usando estes métodos:
Considerações
MongoDB Shell, mongosh
O MongoDB Shell (mongosh) não é instalado com o MongoDB Server. 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 oferece suporte às seguintes versões de 64bits do Windows na arquitetura x86_64:
Windows Server 2022
Windows 11
O MongoDB é compatível somente com as versões de 64 bits dessas plataformas.
Para obter mais informações, consulte Suporte à plataforma.
Observação
O MongoDB não é compatível ao subsistema do Windows para Linux (WSL). Para executar o MongoDB no Linux, use um sistema Linux compatível.
Virtualização
A Oracle oferece suporte experimental para o VirtualBox em hosts Windows onde o Hyper-V está sendo executado. No entanto, a Microsoft não oferece suporte ao VirtualBox no Hyper-V.
Desative o Hyper-V se quiser instalar o MongoDB no Windows com o VirtualBox.
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.
Captura de dados de diagnóstico em tempo integral
O MongoDB registra os dados de diagnóstico para ajudar na solução de problemas. Para obter detalhes, consulte Captura de dados de diagnóstico em tempo integral.
No Windows, para coletar dados do sistema, como disco, cpu e memória, o FTDC exige permissões de acesso da Microsoft dos seguintes grupos:
Usuários do monitor de desempenho
Usuários de registro de desempenho
Se o usuário executando o mongod e mongos não for um administrador, adicione-o a estes grupos para log dados FTDC. Para obter mais informações, consulte a documentação da Microsoft.
Instale o MongoDB Enterprise Edition
Procedimento
Siga estas etapas para instalar a edição MongoDB Enterprise a partir do arquivo zip.
Baixe o arquivozip.
Baixe o arquivo MongoDB .zip a partir do seguinte link:
➤
Centro de downloads do MongoDB
Na lista suspensa Version, selecione a versão do MongoDB para baixar.
No menu suspenso Platform, selecione Windows x64.
No menu suspenso Package, selecione zip.
Clique em Download.
(Opcional) Crie o arquivo de configuração.
Você pode criar um arquivo de configuração para especificar opções para MongoDB. Para fazer isso, crie um arquivo chamado mongod.cfg no diretório \bin\ dentro do diretório onde você extraiu os arquivos MongoDB (<install directory>\bin\mongod.cfg). Para obter mais informações sobre como criar um arquivo de configuração, consulte Arquivo de configuração.
Crie diretórios obrigatórios e opcionais.
O MongoDB precisa de um diretório de dados para armazenar seus dados. Por padrão, ele usa
C:\data\db, mas você pode especificar um local diferente em seu arquivo de configuração. Você pode criar o diretório de dados usando o prompt de comando do Windows:mkdir c:\data\db Se você especificou um caminho de registro no arquivo de configuração, crie o diretório de registro da mesma maneira.
Configurar MongoDB Enterprise Edition como Serviço do Windows
Você pode instalar e configurar o MongoDB como um Windows Service. Siga estas etapas:
Adicione
<install directory>\binà sua variável de ambientePATH.Abra um prompt de comando do Windows como Administrator, altere para seu diretório de instalação do MongoDB e execute
mongodcom os parâmetros--dbpath,--logpathe--install. Por exemplo, o seguinte comando instala o MongoDB como um serviço que utilizaC:\data\dbpara sua localização de dados eC:\data\log.txtpara o arquivo de log:mongod --dbpath=C:\data\db --logpath=C:\data\log.txt --install
Inicie MongoDB Enterprise Edition como Serviço do Windows
Para iniciar ou reiniciar manualmente o serviço MongoDB , use o console de Serviços:
No console de serviços, localize o serviço MongoDB.
Clique com o botão direito no serviço MongoDB e clique em Start.
You can also manually manage the service from the command line. To start the MongoDB service from the command line, open a Windows command prompt/interpreter (cmd.exe) as an Administrator, and run the following command:
Verifique se o MongoDB foi iniciado com sucesso.
Verifique seu arquivo de registro MongoDB para a seguinte linha:
[initandlisten] waiting for connections on port 27017
Você poderá ver avisos não críticos como resultado do processo. Contanto que você veja essa mensagem no registro do MongoDB, você pode ignorar com segurança esses avisos durante sua avaliação inicial do MongoDB.
Conecte-se ao servidor MongoDB.
Se ainda não tiver feito isso, siga as instruções de instalação do mongosh para baixar e instalar o MongoDB Shell (mongosh).
Adicione o caminho do binário mongosh.exe para sua variável de ambiente do PATH durante a instalação.
Abra um novo Command Interpreter e insira mongosh.exe para se conectar ao MongoDB.
Pare o MongoDB Enterprise Edition como Serviço do Windows
Para interromper ou pausar o serviço MongoDB , use o console de Serviços:
No console de serviços, localize o serviço MongoDB.
Clique com o botão direito do mouse no serviço MongoDB e clique em Stop ou Pause.
You can also manage the service from the command line. To stop the MongoDB service from the command line, open a Windows command prompt/interpreter (cmd.exe) as an Administrator, and run the following command:
net stop MongoDB
Remover MongoDB Enterprise Edition como Serviço do Windows
To remove the MongoDB service, first use the Services console to stop the service. Then open a Windows command prompt/interpreter (cmd.exe) as an Administrator, and run the following command:
sc.exe delete MongoDB
Inicie o MongoDB Enterprise Edition a partir do Command Interpreter
Open a Windows command prompt/interpreter (cmd.exe) as an Administrator.
Importante
Você deve abrir o prompt de comando como um Administrator.
Criar diretório do banco de dados.
Crie o diretório de dados onde MongoDB armazena dados. O caminho do diretório de dados padrão do MongoDB é o caminho absoluto \data\db no drive a partir do qual você inicia o MongoDB.
A partir do Command Interpreter, crie os diretórios de dados:
cd C:\ md "\data\db"
Inicie o banco de dados MongoDB.
Para iniciar o MongoDB, execute mongod.exe.
"C:\Program Files\MongoDB\Server\8.3\bin\mongod.exe" --dbpath="c:\data\db"
A opção --dbpath aponta para o diretório do seu banco de dados.
Se o servidor de banco de dados MongoDB estiver sendo executado corretamente, o Command Interpreter exibirá:
[initandlisten] waiting for connections
Importante
Depending on the Windows Defender Firewall settings on your Windows host, Windows may display a Security Alert dialog box about blocking "some features" of C:\Program Files\MongoDB\Server\8.3\bin\mongod.exe from communicating on networks. To remedy this issue:
Clique em Private Networks, such as my home or work network.
Clique em Allow access.
Para saber mais sobre segurança e MongoDB, consulte a Documentação de segurança.
Conecte-se ao MongoDB.
Se ainda não tiver feito isso, siga as instruções de instalação do mongosh para baixar e instalar o MongoDB Shell (mongosh).
Adicione o caminho do binário mongosh.exe para sua variável de ambiente do PATH durante a instalação.
Abra um novo Command Interpreter e insira mongosh.exe para se conectar ao MongoDB.
Para mais informações sobre conectar ao mongod utilizando mongosh.exe, como conectar-se a uma instância do MongoDB em execução em um host e/ou porta diferente, consulte Conectar-se a uma implantação.
Para obter informações sobre operações de CRUD (criar, ler, atualizar, excluir), consulte:
Consideraçõ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.exe 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.exe e o mongod.exe 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.
Liberações de pontos e .msi
Se você instalou o MongoDB com o instalador do Windows (.msi), o .msi é atualizado automaticamente dentro da mesma série de versões, como 7.2.1 para 7.2.2.
A atualização de uma série de versões completa, como 6.0 para 7.0, requer uma nova instalação.
Adicione os binários MongoDB ao PATH do sistema
Todos os exemplos de linha de comando neste tutorial usam caminhos absolutos para os binários do MongoDB . Você pode adicionar C:\Program Files\MongoDB\Server\8.3\bin ao seu sistema PATH para omitir o caminho completo para os binários MongoDB .