在 Linux 上安装或卸载 mongot

下载 mongot tarball。

单击以下链接下载社区搜索 tarball。

(可选).验证 tarball 包的完整性。

有关详细信息，请参阅验证mongot包的完整性。

提取 mongot tarball。

运行以下命令以提取 tarball：

tar -zxvf mongot_community_0.53.0_linux_aarch64.tgz

tar -zxvf mongot_community_0.53.0_linux_x86_64.tgz

该 tarball 包含一个示例配置文件、mongot 启动程序脚本以及 MongoDB Search 和向量搜索许可证信息。

配置 mongod 以与 mongot 通信。

如果您有要使用的现有副本集，请配置以下 mongod 参数来路由搜索和MongoDB Vector Search 查询并托管索引。

示例，您可以将以下行添加到 mongod 配置文件中，然后重新启动 mongod：

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

有关设置 mongod 参数的更多信息，请参阅自管理部署的 MongoDB Server Parameters。有关搜索特定 setParameter 选项的详细信息，请参阅MongoDB Search 选项。

如果要使用密钥文件身份验证部署新的副本集，请按照部署具有密钥文件身份验证的自管理副本集。中的步骤进行操作。

为 MongoDB 部署上的 mongot进程创建用户。

mongot 必须能够通过具有searchCoordinator角色的用户连接到MongoDB 部署。

1. 以管理员用户身份连接到 mongosh。

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

2. 连接到 admin 数据库。

   运行以下命令以连接到 admin数据库：

   use admin

3. 创建 mongot 用户。

   要创建具有 searchCoordinator角色的用户：

   • 将 <mongot-username> 替换为 mongot 用户的用户名

   • 将 <mongot-password> 替换为在下一步中为 passwordFile 指定的密码

   • 运行以下命令：

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

创建密码文件。

为 mongot 创建密码文件，以连接到 mongod。

示例，选择您的操作系统并将 <mongot-password> 替换为您的密码。然后运行以下命令，创建名为 passwordFile 的文件：

echo -n "<mongot-password>" > passwordFile
chmod 400 passwordFile

echo|set /p="mongotPassword" > passwordFile

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

指定 mongot 配置选项。

您可以使用 YAML 配置文件配置 mongot。使用名为 config.default.yml 的附带示例配置文件或新的配置文件来定义配置。有关 mongot 配置选项的更多信息，请参阅 mongot 选项。

该 tarball 包含以下示例配置文件config.default.yml，具有默认的mongot 设置。您可以修改部署的设置：

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

使用 logging.logPath 指定 mongot 写入的日志文件的路径。如果您未指定日志文件路径，mongot 将日志记录到标准输出。

启动mongot进程。

运行随 Tarball 下载的 mongot 启动器脚本。该脚本位于 mongot-community 文件夹中。

更改为 mongot-community 文件夹：

cd <path-to-mongot>

要使用示例配置文件启动 mongot，请发出以下命令：

./mongot --config config.default.yml

验证 mongot 进程的运行状况。

要验证，请使用 HTTP 客户端或 curl 向 /health 终结点发送请求。例如，发送类似以下示例请求的 curl 请求：

curl localhost:8080/health

端点在响应中返回以下内容之一：

• SERVING, 如果 mongot 进程正在运行

  mongot 可能无法提供服务查询，因为它不检查索引的状态，而索引必须处于 Ready 状态才能提供服务查询。

• NOT_SERVING，如果 mongot 进程未运行

有关详细信息，请参阅验证 mongot 连接。

删除 mongotUser 用户

要删除 mongotUser 用户，运行以下命令：

use admin
db.dropUser("mongotUser")

有关详情，请参阅 db.dropUser()。

停止 mongot

要停止 mongot 二进制文件，请在运行该二进制文件的终端会话中使用 Ctrl + C。

删除所有配置文件

要删除 mongot 和 mongod 配置文件，请以 root 身份运行以下命令，或使用 sudo 并使用配置文件的完整路径：

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

删除密钥文件和密码文件

要删除密钥文件和密码文件，请使用密钥文件和密码文件的完整路径运行以下命令：

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

删除 的所有日志和日志目录 mongot

要删除 mongot 的日志和日志目录，请使用在 logging.logPath 中指定的日志目录的完整路径运行以下命令：

rm -rf /path/to/mongot-logs

删除数据目录 mongot

要删除存储 mongot 数据的数据目录，请使用 mongot数据目录的完整路径运行以下命令：

rm /path/to/mongot/data