Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Instale ou desinstale o mongot no Linux

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:

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.

1

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.tgz
2

Consulte Verificar a integridade dos pacotes mongot para obter mais informações.

3

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.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.

4

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

searchIndexManagementHostAndPort

O endereço do host de mongot.

mongotHost

O endereço do host de mongot.

Você deve especificar o mesmo endereço em searchIndexManagementHostAndPort e mongotHost.

skipAuthenticationToSearchIndexManagementServer

Especifica se a autenticação está habilitada para o servidor de gerenciamento de índice de pesquisa

useGrpcForSearch

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.

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.

5

mongot deve ser capaz de se conectar à sua implantação do MongoDB por meio de um usuário com a função searchCoordinator.

  1. Conecte-se a mongosh como usuário administrador.

    mongosh --port 27017 -u <your_admin_username> -p <your_admin_password>
  2. Conecta-se ao banco de dados admin.

    Execute o seguinte comando para conectar ao banco de dados do admin :

    use admin
  3. 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ário mongot

    • Substitua <mongot-password> pela senha que você especificar em seu passwordFile na próxima etapa

    • Execute o seguinte comando:

    db.createUser( { user: <mongot-username>, pwd: <mongot-password>, roles: [ "searchCoordinator"] })
6

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 passwordFile

Observação

O sinalizador -n impede uma nova linha à direita.

7

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: INFO

Observaçã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.address a uma interface de rede que mongod possa alcançar, em vez de localhost.

  • Defina os parâmetros mongod, mongotHost e searchIndexManagementHostAndPort para esse endereço.

  • Habilitar TLS para a origem de sincronização e conexões gRPC. Executar sem TLS é apropriado apenas quando mongot e mongod são executados no mesmo hospedar. Para configurar o TLS, consulte Configurar criptografia TLS para 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.

8

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
9

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/health

O endpoint retorna uma das seguintes opções na resposta:

  • SERVING, se o processo mongot estiver em execução

    mongot pode não servir queries, pois não verifica o status dos índices, que devem estar no estado Ready para servir queries.

  • NOT_SERVING, se o processo mongot não estiver em execução

Para obter detalhes adicionais, consulte Verifique sua conexão mongot.

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.

1

Para soltar o usuário do mongotUser, execute os seguintes comandos:

use admindb.dropUser("mongotUser")

Para obter detalhes, consulte db.dropUser().

2

Para interromper o binário mongot, use Ctrl + C na sessão do terminal em que ele está sendo executado.

3

Para remover os arquivos de configuração mongot e mongod, execute os seguintes comandos como root ou com sudo usando o caminho completo para seus arquivos de configuração:

sudo rm /path/to/config.default.ymlsudo rm /path/to/mongod.conf
4

Para remover o arquivo de chave e o arquivo de senha, execute os seguintes comandos usando o caminho completo para o arquivo de chave e o arquivo de senha:

rm /path/to/keyfilerm /path/to/passwordFile
5

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
6

Para remover o diretório de dados que armazena dados mongot, execute o seguinte comando usando o caminho completo para o diretório de dados mongot :

rm /path/to/mongot/data