Você pode instalar o processo MongoDB Search e MongoDB pesquisa vetorial, mongot, no MongoDB Community Edition. O processo mongot está disponível para implantação para todas as distribuições Linux, como Red Hat, Ubuntu, Debian, SUSE e Amazon Linux, como um tarball com a extensão .tgz.
Observação
Para integrar rapidamente uma implantação para experimentação, consulte os seguintes tutoriais para implantações autogerenciadas:
Antes de começar
Para instalar o mongot em uma implantação autogerenciada, você deve ter os seguintes pré-requisitos:
MongoDB Community Edition v8.2 ou posterior.
Consulte Instalar a MongoDB Community Edition para obter tutoriais de instalação.
Observação
Você deve ter o MongoDB 8.2 ou posterior para executar o processo MongoDB Search e MongoDB pesquisa vetorial com uma implantação autogerenciada autônoma. Se você implantar com o operador MongoDB Controllers para Kubernetes, precisará do MongoDB 8.3 ou posterior. Para mais informações, consulte Compatibilidade e requisitos para
mongot.Um conjunto de réplicas iniciadas com controle de acesso ao arquivo-chave.
Procedimento
Baixe o tarball mongot.
Clique no link a seguir para baixar o tarball Pesquisar na comunidade.
Para arquiteturas ARM, use o tarball compatível com ARM.
Para arquiteturas AMD x86_64, use o tarball compatível com AMD x86-64.
(opcional). Verifique a integridade do pacote tarball.
Consulte Verificar a integridade dos pacotes mongot para obter mais informações.
Extraia o tarball mongot.
Execute o seguinte comando para extrair o tarball:
tar -zxvf mongot_community_0.53.0_linux_aarch64.tgz
tar -zxvf mongot_community_0.53.0_linux_x86_64.tgz
Observação
Se o seu navegador descompactar automaticamente o arquivo como parte das transferências, a extensão do arquivo será .tar.
O tarball contém um arquivo de configuração de exemplo, o script do iniciador do mongot e informações de licença do MongoDB Search e da pesquisa vetorial.
Configure mongod para se comunicar com mongot.
Se você tiver um conjunto de réplica existente que deseja usar, configure os parâmetros mongod a seguir para rotear as queries do Search e do MongoDB Vector Search e gerenciar índices.
Parâmetro | Descrição |
|---|---|
| O endereço do host de |
| O endereço do host de Você deve especificar o mesmo endereço em |
| Especifica se a autenticação está habilitada para o servidor de gerenciamento de índice de pesquisa |
| Especifica se o RGPC está ativado para o MongoDB Search |
Por exemplo, você pode adicionar as seguintes linhas ao seu arquivo de configuração do mongod e então reiniciar o mongod:
setParameter: searchIndexManagementHostAndPort: localhost:27028 mongotHost: localhost:27028 skipAuthenticationToSearchIndexManagementServer: false useGrpcForSearch: true
Consulte Parâmetros do servidor MongoDB para uma implantação autogerenciada para obter mais informações sobre como definir os parâmetros mongod. Para obter informações detalhadas sobre as opções setParameter específicas de pesquisa, consulte Opções de pesquisa do MongoDB.
Se quiser implantar um novo conjunto de réplicas com autenticação de arquivo de chave, siga as etapas em Implantar conjunto de réplicas autogerenciado com autenticação de arquivo de chave.
Crie um usuário para o processo mongot em sua implantação do MongoDB.
mongot deve ser capaz de se conectar à sua implantação do MongoDB por meio de um usuário com a função searchCoordinator.
Conecte-se a
mongoshcomo usuário administrador.mongosh --port 27017 -u <your_admin_username> -p <your_admin_password> Conecta-se ao banco de dados
admin.Execute o seguinte comando para conectar ao banco de dados do
admin:use admin Crie seu usuário
mongot.Para criar um usuário com a função
searchCoordinator:Substitua
<mongot-username>por um nome de usuário para o seu usuáriomongotSubstitua
<mongot-password>pela senha que você especificar em seupasswordFilena próxima etapaExecute o seguinte comando:
db.createUser( { user: <mongot-username>, pwd: <mongot-password>, roles: [ "searchCoordinator"] } )
Crie seu arquivo de senha.
Crie um arquivo de senha para mongot se conectar a mongod.
Por exemplo, selecione seu sistema operacional e substitua <mongot-password> por sua senha. Em seguida, execute o seguinte comando para criar um arquivo chamado passwordFile:
echo -n "<mongot-password>" > passwordFile chmod 400 passwordFile
Observação
O sinalizador -n impede uma nova linha à direita.
echo|set /p="mongotPassword" > passwordFile
[System.IO.File]::WriteAllText("passwordFile", "mongotPassword")
Especifique suas opções de configuração do mongot.
Você pode configurar o mongot com um arquivo de configuração YAML. Use o arquivo de configuração de amostra incluído chamado config.default.yml ou um novo arquivo de configuração para definir a configuração. Para mais informações sobre as opções de configuração do mongot, consulte Opções do mongot.
O tarball contém o seguinte arquivo de configuração de amostra, config.default.yml, com as configurações padrão do mongot. Você pode modificar as configurações do seu sistema:
Aviso
Dependendo da topologia do sistema, pode ser necessário vincular o servidor de query do mongot a uma interface acessível a partir do Cluster MongoDB. Embora a vinculação ao endereço IP 0.0.0.0 seja permitida, ela expõe o servidor a todas as redes públicas e acarreta o risco de acesso não autorizado.
Para aumentar a segurança, considere restringir server.grpc.address a interfaces específicas que sejam controladas e protegidas na camada de rede, como localhost ou outros endereços internos confiáveis.
syncSource: replicaSet: hostAndPort: "localhost:27017" # Replace with the mongod host and port. username: mongotUser # Replace with mongod username enabled with "searchCoordinator" role. passwordFile: "/etc/mongot/secrets/passwordFile" # Replace with path to password file for the above user. tls: false storage: dataPath: "/var/lib/mongot" # Replace with the path where you want mongot to store search data. server: grpc: address: "localhost:27028" # Replace with the address and port for mongot listen server tls: mode: "disabled" metrics: enabled: true address: "localhost:9946" healthCheck: address: "localhost:8080" logging: verbosity: INFO
Observação
O diretório dataPath no seu arquivo de configuração deve ser gravável pelo usuário que executa mongot.
Use logging.logPath para especificar o caminho do arquivo de log que mongot grava. Se você não especificar um caminho de arquivo de log, mongot fará o log para a saída padrão.
Inicie o processo de mongot.
Execute o script do iniciador mongot que você baixou com o tarball. O roteiro está na pasta mongot-community.
Alterar para a pasta mongot-community:
cd <path-to-mongot>
Para iniciar o mongot com o arquivo de configuração de amostra, emita o seguinte comando:
./mongot --config config.default.yml
Verifique a integridade do processo mongot.
Para verificar, envie uma solicitação usando um cliente HTTP ou curl para o ponto de extremidade /health. Por exemplo, envie uma solicitação curl semelhante à seguinte solicitação de amostra:
curl localhost:8080/health
O endpoint retorna uma das seguintes opções na resposta:
SERVING, se o processomongotestiver em execuçãomongotpode não servir queries, pois não verifica o status dos índices, que devem estar no estadoReadypara servir queries.NOT_SERVING, se o processomongotnão estiver em execução
Para obter detalhes adicionais, consulte Verifique sua conexão mongot.
Desinstalar o MongoDB Search e o MongoDB Vector Search
Para remover o MongoDB Search e o MongoDB pesquisa vetorial de um sistema, você deve remover mongot, os arquivos de configuração e quaisquer diretórios contendo dados e logs. A seção a seguir orienta você nas etapas necessárias.
Descarte o usuário mongotUser
Para soltar o usuário do mongotUser, execute os seguintes comandos:
use admin db.dropUser("mongotUser")
Para obter detalhes, consulte db.dropUser().
Remova todos os logs e o diretório de logs de mongot
Para remover os logs e o diretório de logs do mongot, execute o seguinte comando usando o caminho completo para o diretório de logs especificado em logging.logPath:
rm -rf /path/to/mongot-logs