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

Instalar ou desinstalar 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.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.

1

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.

2

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

3

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.

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.

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

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 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 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 admin
db.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.yml
sudo 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/keyfile
rm /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