Install or Uninstall mongot on Linux

Download the mongot tarball.

Hacer clic en el siguiente enlace para descargar el tarball de Buscar en la Community.

(Optional). Verify the integrity of the tarball package.

See Verify Integrity of mongot Packages for more information.

Extract the mongot tarball.

Ejecuta el siguiente comando para extraer el archivo tar:

tar -zxvf mongot_community_0.53.0_linux_aarch64.tgz

tar -zxvf mongot_community_0.53.0_linux_x86_64.tgz

The tarball contains a sample configuration file, the mongot launcher script, and MongoDB Search and Vector Search license information.

Configure mongod to communicate with mongot.

Si se desea utilizar un set de réplicas existente, se deben configurar los siguientes parámetros mongod para enrutar las queries de búsqueda y MongoDB Vector Search y gestionar los índices.

Por ejemplo, puede añadir las siguientes líneas a su archivo de configuración mongod y luego reiniciar mongod:

setParameter:
   searchIndexManagementHostAndPort: localhost:27028
   mongotHost: localhost:27028
   skipAuthenticationToSearchIndexManagementServer: false
   useGrpcForSearch: true

See MongoDB Server Parameters for a Self-Managed Deployment for more information on setting mongod parameters. For detailed information about search-specific setParameter options, see MongoDB Search Options.

If you want to deploy a new replica set with keyfile authentication, follow the steps in Deploy Self-Managed Replica Set With Keyfile Authentication.

Create a user for the mongot process on your MongoDB deployment.

mongot must be able to connect to your MongoDB deployment through a user with the searchCoordinator role.

1. Conéctese a mongosh como el usuario administrador.

   mongosh --port 27017 -u <your_admin_username> -p <your_admin_password>

2. Conéctese a la base de datos admin.

   Ejecute el siguiente comando para conectarse a la base de datos admin:

   use admin

3. Cree su usuario mongot.

   Para crear un usuario con el rol searchCoordinator:

   • Se debe sustituir <your-mongot-username> por un nombre de usuario para el usuario mongot

   • Reemplace <your-mongot-password> con la contraseña que especificó en su passwordFile

   • Ejecute el comando

   db.createUser(
      {
         user: <mongot_username>,
         pwd: <mongot_password>,
         roles: [ "searchCoordinator"]
      }
   )

Cree su archivo de contraseñas.

Crea un archivo de contraseña para mongot para conectarte a mongod.

Por ejemplo, se debe seleccionar el sistema operativo y reemplazar <mongot_password> con la contraseña. A continuación, se debe ejecutar el siguiente comando para crear un archivo llamado passwordFile:

echo -n "mongotPassword" > passwordFile
chmod 400 passwordFile

echo|set /p="mongotPassword" > passwordFile

[System.IO.File]::WriteAllText("passwordFile", "mongotPassword")

Specify your mongot configuration options.

You can configure mongot with a YAML configuration file. Use the included sample configuration file named config.default.yml or a new configuration file to define the configuration. For more information on mongot configuration options, see mongot Options.

The tarball contains the following sample configuration file, config.default.yml, with the default mongot settings. You can modify the settings for your deployment:

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

Inicie el proceso de mongot.

Ejecuta el script del lanzador mongot que descargó con el tarball. El script se encuentra en la carpeta mongot-community.

Cambie a la carpeta mongot-community:

cd <path-to-mongot>

Para comenzar mongot con el archivo de configuración de muestra, emite el siguiente comando:

./mongot --config config.default.yml

Verify the health of the mongot process.

To verify, send a request by using a HTTP client or curl to the /health endpoint. For example, send a curl request similar to the following sample request:

curl localhost:8080/health

El endpoint devuelve uno de los siguientes en la respuesta:

• SERVING, if the mongot process is running

  mongot might not serve queries as it doesn't check the status of the indexes, which must be in Ready state to serve queries.

• NOT_SERVING, if the mongot process isn't running

Drop the mongotUser user

Para descartar al usuario mongotUser, ejecute los siguientes comandos:

use admin
db.dropUser("mongotUser")

For details, see db.dropUser().

Detiene el mongot

Para detener el binario mongot, utilice Ctrl + C en la sesión de terminal en la que se está ejecutando.

Remueve cualquier archivo de configuración

To remove the mongot and mongod configuration files, run the following commands as root or with sudo by using the full path to your configuration files:

sudo rm /path/to/config.default.yml
sudo rm /path/to/mongod.conf

Remueve el archivo de claves y el archivo de contraseñas

Para remover el archivo de claves y el archivo de contraseñas, ejecuta los siguientes comandos utilizando la ruta completa al archivo de claves y al archivo de contraseñas:

rm /path/to/keyfile
rm /path/to/passwordFile

Remove any logs and the log directory for mongot

Para remover los registros y el directorio de registros de mongot, ejecuta el siguiente comando utilizando la ruta completa al directorio de registros:

rm -rf /path/to/mongot-logs

Remove the data directory for mongot

Para remover el directorio de datos que almacena los datos de mongot, se debe ejecutar el siguiente comando utilizando la ruta completa al directorio de datos mongot:

rm /path/to/mongot/data