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.
Visão geral
Use este tutorial para instalar o MongoDB 8.2 Enterprise Edition no Windows usando o assistente de instalação padrão.
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.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.
Método de instalação
This tutorial installs MongoDB on Windows using the default MSI installation wizard. To install MongoDB using the msiexec.exe command-line tool instead, see Install MongoDB using msiexec.exe. The msiexec.exe tool is useful for system administrators who deploy MongoDB using automation.
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.2 A Enterprise Edition é compatível com as seguintes versões de 64 bits do Windows na arquitetura x86_64:
Windows Server 2022
Windows Server 2019
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
MongoDB logs diagnostic data to assist with troubleshooting. For details, see Full Time Diagnostic Data Capture.
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 não for um administrador, adicione-o a estes grupos para registrar dados FTDC. Para obter mais informações,mongos consulte a documentação da Microsoft.
Instale o MongoDB Enterprise Edition
Procedimento
Siga estas etapas para instalar a edição MongoDB Enterprise usando o assistente de instalação do Windows. O processo de instalação instala os binários do MongoDB e o arquivo de configuração padrão. O arquivo de configuração está localizado no diretório de instalação bin\mongod.cfg em.
Baixe o instalador.
Baixe o instalador do MongoDB .msi 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.
No menu suspenso Package, selecione msi.
Clique em Download.
Siga o assistente do instalador do MongoDB
O assistente orienta na instalação do MongoDB e do MongoDB Compass.
Choose Setup Type Você pode escolher o Complete (recomendado para a maioria dos usuários) ou tipo de configuração Custom. A opção Complete de configuração instala as ferramentas MongoDB e MongoDB no local padrão. A opção Custom de configuração permite a você especificar quais executáveis serão instalados e onde.
Service Configuration Você pode configurar o MongoDB como um serviço do Windows durante a instalação ou simplesmente instalar os binários.
Você pode configurar e iniciar o MongoDB como um serviço do Windows durante a instalação, e o serviço MongoDB será iniciado após a instalação bem-sucedida.
Selecione Install MongoD as a Service.
Selecione uma destas opções:
Run the service as Network Service user (Padrão)
Esta é uma conta de usuário do Windows que está incorporada ao Windows.
Run the service as a local or domain user
Para uma conta de usuário local existente, especifique um período (
.) para o Account Domain e especifique o Account Name e o Account Password para o usuário.Para um usuário de domínio existente, especifique o Account Domain, Account Name e Account Password para esse usuário.
Service Name. Especifique o nome do serviço. O nome padrão é
MongoDB. Se você já tiver um serviço com o nome especificado, deverá escolher outro nome.Data Directory. Especifique o diretório de dados, que corresponde a
--dbpath. Se o diretório não existir, o instalador criará o diretório e definirá o acesso do diretório para o usuário do serviço.Log Directory. Especifique o diretório Log, que corresponde ao
--logpath. Se o diretório não existir, o instalador criará o diretório e definirá o acesso do diretório para o usuário do serviço.
Se você optar por não configurar o MongoDB como um serviço do Windows, desmarque a opção Install MongoD as a Service.
Install MongoDB Compass Opcional. Para que o assistente instale o MongoDB Compass, selecione Install MongoDB Compass (Padrão).
Quando estiver pronto, clique em Install.
Se você instalou o MongoDB como um serviço do Windows
O serviço MongoDB começa após a instalação bem-sucedida. Configure a instância do MongoDB com o arquivo de configuração <install directory>\bin\mongod.cfg.
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 como conectar ao mongod usando o 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:
Se você não instalou o MongoDB como um serviço do Windows
Se você instalou apenas os executáveis e não instalou o MongoDB como um serviço do Windows, deverá iniciar manualmente a instância do MongoDB.
See Start MongoDB Enterprise Edition from the Command Interpreter for instructions.
Inicie o MongoDB Enterprise Edition a partir do Command Interpreter
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.2\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
Dependendo das configurações do Firewall do Windows Defender no seu host Windows, o Windows poderá exibir uma caixa de diálogo Security Alert referente ao bloqueio de "alguns recursos" referentes à comunicação de rede no C:\Program Files\MongoDB\Server\8.2\bin\mongod.exe. Para solucionar este problema:
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 como conectar ao mongod usando o 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:
Inicie MongoDB Enterprise Edition como Serviço do Windows
Você pode instalar e configurar o MongoDB como um Windows Service durante a instalação. O serviço MongoDB começa após a instalação bem-sucedida.
To start or restart the MongoDB service, use the Services console:
No console de serviços, localize o serviço MongoDB.
Clique com o botão direito no serviço MongoDB e clique em Start.
Você também pode gerenciar o serviço na linha de comando. Para iniciar o serviço MongoDB a partir da linha de comando, abra um prompt de comando/interpretador do Windows (cmd.exe) como Administrator e execute o seguinte comando:
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
To stop or pause the MongoDB service, use the Services console:
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.
Você também pode gerenciar o serviço na linha de comando. Para parar o serviço MongoDB da linha de comando, abra um prompt/interpretador de comando do Windows (cmd.exe) como um Administrator e execute o seguinte comando:
net stop MongoDB
Remover MongoDB Enterprise Edition como Serviço do Windows
Para remover o serviço MongoDB, primeiro use o console Serviços para interromper o serviço. Em seguida, abra um prompt de comando/interpretador do Windows (cmd.exe) como um Administrator e execute o seguinte comando:
sc.exe delete MongoDB
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 .msi atualiza automaticamente dentro de sua série de versões, como 4.2.1 4.2.2para.
A atualização de uma série de versões completa, como 4.0 para 4.2, requer uma nova instalação.
Adicione os binários MongoDB ao PATH do sistema
All command-line examples in this tutorial use absolute paths to the MongoDB binaries. You can add C:\Program
Files\MongoDB\Server\8.2\bin to your System PATH to omit the full path to the MongoDB binaries.