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.3 ou posterior.
Consulte Instalar a MongoDB Community Edition para obter tutoriais de instalação.
Observação
Você deve ter o MongoDB 8.3 ou posterior para executar o processo do MongoDB Search e da pesquisa vetorial do MongoDB, seja usando uma implantação autônoma autogerenciada ou implantando com o operador do MongoDB Controllers for Kubernetes. Para obter mais informações, consulte Compatibilidade e requisitos para
mongot.Um conjunto de réplicas iniciadas com controle de acesso ao arquivo-chave.
Procedimento
Baixar o tarball mongot.
Baixe o tarball mais recente da pesquisa na Community para a arquitetura do seu sistema no Centro de Download da pesquisa MongoDB Community.
Para baixar uma versão específica da linha de comando, substitua {VERSION_NUMBER} pela versão de mongot que você deseja e execute o comando para a arquitetura do seu sistema:
wget https://downloads.mongodb.org/mongodb-search-community/{VERSION_NUMBER}/mongot_community_{VERSION_NUMBER}_linux_aarch64.tgzwget https://downloads.mongodb.org/mongodb-search-community/{VERSION_NUMBER}/mongot_community_{VERSION_NUMBER}_linux_x86_64.tgz(opcional). Verifique a integridade do pacote tarball.
Consulte Verificar a integridade dos pacotes mongot para obter mais informações.
Extraia o tarball mongot.
Substitua {VERSION_NUMBER} pela versão de mongot que você baixou e execute o comando para a arquitetura do seu sistema para extrair o tarball:
tar -zxvf mongot_community_{VERSION_NUMBER}_linux_aarch64.tgztar -zxvf mongot_community_{VERSION_NUMBER}_linux_x86_64.tgzObservaçã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 o mongod para se comunicar com o 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: trueConsulte 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.
Observação
Os parâmetros mongotHost, searchIndexManagementHostAndPort e useGrpcForSearch são definidos apenas na inicialização. Não é possível alterá-los em tempo de execução com setParameter. Para apontar mongod para uma instância mongot diferente, atualize esses parâmetros no arquivo de configuração mongod e reinicie mongod.
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 adminCrie 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>" > passwordFilechmod 400 passwordFileObservaçã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. scramAuth: username: mongotUser # Replace with mongod username enabled with "searchCoordinator" role. authSource: admin # Replace with the database to authenticate the user against. passwordFile: "/etc/mongot/secrets/passwordFile" # Replace with path to password file for the above user. tls: enabled: falsestorage: 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: INFOObservação
O diretório dataPath no seu arquivo de configuração deve ser gravável pelo usuário que executa mongot.
A configuração de amostra usa autenticação SCRAM com o bloco scramAuth. Você deve configurar exatamente um mecanismo de autenticação para a fonte de sincronização: SCRAM ou X.509. Para autenticar com um certificado de cliente TLS em vez de um nome de usuário e senha, use o bloco x509. Para ambos os mecanismos, incluindo a configuração de syncSource.router de cluster, consulte Configurar autenticação e autorização para mongot.
Esta amostra executa mongot e mongod no mesmo hospedar, portanto, ele vincula server.grpc.address a localhost e desativa o TLS. Se você executar mongot e mongod em hospedares separados, conclua as seguintes etapas em vez disso:
Ligue
server.grpc.addressa uma interface de rede quemongodpossa alcançar, em vez delocalhost.Defina os parâmetros
mongod,mongotHostesearchIndexManagementHostAndPortpara esse endereço.Habilitar TLS para a origem de sincronização e conexões gRPC. Executar sem TLS é apropriado apenas quando
mongotemongodsão executados no mesmo hospedar. Para configurar o TLS, consulte Configurar criptografia TLS paramongot.
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.ymlVerifique a integridade do processo mongot.
Para verificar, envie uma solicitação usando um HTTP cliente ou curl para o ponto de extremidade /health. Por exemplo, envie uma solicitação curl semelhante à seguinte solicitação de amostra:
curl localhost:8080/healthO 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 admindb.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