Docs 菜单
Docs 主页
/
MongoDB Ops Manager
/
MongoDB 助手
/
安装

安装 MongoDB 助手来管理部署

您有一个项目，想要安装 MongoDB 助手来管理 MongoDB 部署。您还可以按照此工作流监控和备份 MongoDB 部署。

注意

首先查看先决条件

在安装 之前，请查看MongoDB Agent 先决条件MongoDB Agent 。

使用以下步骤在运行 Microsoft Windows 的 x86_64 架构上安装 MongoDB 助手：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment菜单中，选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从 Select Your Server's Operating System 菜单中，单击 Windows - MSI。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从 Install Agent 菜单中，单击 Windows - MSI。

3

下载 MongoDB 助手。

MongoDB Agent Installation Instructions 框会显示以下信息：

  • Base URL

    绑定到项目时必填。

  • Project ID （绑定到项目时必填）

  • API Key

    如果没有 API 密钥，请单击生成密钥。

后续步骤需要用到其中部分或全部值。复制这些值，然后将它们存储在便于稍后访问的位置。

4

安装 MongoDB 助手。

  1. 下载 MSI后，双击：

    mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi

  2. 如果出现安全警告，请单击 Run。

  3. 在 Configuration/Log Folder 步骤

    提供保存这些文件的目录。

  4. 在Key Type步骤中，选择Agent API Key以绑定到特定的项目。

  5. 输入相应的代理密钥。

    注意

    上一步描述的 MongoDB Agent Installation Instructions 模态中提供了这些密钥。

    • 在 Base URL 字段中输入您的 Base URL。

    • 在 Project ID 字段中输入您的项目 ID。

    • 在 Agent API Key 字段中键入您的代理 API 密钥。

    • 在 Agent API Key 字段中键入您的代理 API 密钥。

  6. 在 MongoDB Paths 步骤中，指定日志和备份目录

  7. 在 Windows Firewall Configuration 步骤中，单击首选防火墙配置。

    如果单击Configure firewall rules allowing access from only the specified |ipaddr| addresses. ，请在提供的框中键入必要的 IPv 4地址。

  8. （有条件） Windows启用 隐身模式 默认用于Windows防火墙。如果您尚未在安装MongoDB 助手的MongoDB Agent 托管上禁用它，系统会要求您禁用它。隐身模式会显着降低MongoDB Agent助手的性能和功能。 单击Disable Stealth Mode 。

  9. （有条件） Windows未启用 磁盘性能计数器 默认。如果您尚未为MongoDB托管启用磁盘性能计数器，请单击Enable Disk Performance Counters 。 MongoDB Agent使用这些计数器进行某些硬件监控活动。

  10. 单击 Install（连接）。

  11. 设置完成后，请单击 Finish。

下载MSI后，您可以运行无人值守安装。 可以在命令解释器或 PowerShell 中从命令行运行无人值守安装。 要了解有关无人值守安装的更多信息，请参阅有关 标准安装程序命令行选项 的 Microsoft 文档

要在无人值守的情况下从命令行运行MSI安装程序，请使用/q和/i标志以及必需和可选参数的组合来调用msiexec.exe ：

Parameter
必要性
值

MMSAPIKEY

必需

APIMongoDB Ops Manager项目的代理 密钥。

MMSBASEURL

必需

URLMongoDB Ops Manager托管的 。

MMSGROUPID

必需

MongoDB Ops Manager项目的唯一标识符。

CONFIGLOGDIR

Optional

MongoDB Ops Manager应将MongoDB Agent配置文件写入到的绝对文件路径。

LOGFILE

Optional

MongoDB Ops Manager应将MongoDB Agent日志写入到的绝对文件路径

MMSCONFIGBACKUP

Optional

MongoDB Ops Manager自动化配置备份JSON文件的绝对文件路径。

例子

要在无人值守的情况下安装MongoDB Agent助手，您可以使用以下选项调用 msiexec.exe：

msiexec.exe /q /i "C:\PATH\TO\mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi" MMSGROUPID=<GROUP.ID> MMSAPIKEY=<AGENT.API.ID> MMSBASEURL="<http://opsmanager.example.com:8080>" LOGFILE="C:\MMSData\Server\Log\automation-agent.log" MMSCONFIGBACKUP="C:\MMSData\MongoDB\mms-cluster-config-backup.json"
5

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

6

（可选）更改 MongoDB 助手二进制文件和配置备份文件的位置。

默认情况下，MongoDB 二进制文件和 Ops Manager 配置备份文件位于 %SystemDrive%\MMSMongoDB\versions。

注意

Windows将%SystemDrive%环境变量设置为安装Windows的驱动器。 默认，系统会引导您在C:驱动器上安装Windows 。 要查找%SystemDrive% ，请从 PowerShell 发出以下命令：

get-childitem env:SystemDrive

如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

更改 MongoDB 助手二进制文件的位置

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在 Download Directory 标题下方，单击 Download Directory (Windows) 中所示路径右侧的 。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行MongoDB Agent的每台托管上创建您指定的新目录。 使用Windows资源管理器移动文件，或从命令提示符或 PowerShell 发出以下命令：

    md \<newPath>

    重要

    确保运行 MongoDB 助手的系统用户可以写入这个新目录。这通常是 SYSTEM 用户，除非您更改了用户，否则不需要其他配置。

更改 MongoDB 助手配置备份的位置

  1. 用您首选的文本编辑器打开 MongoDB 助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。将 X 替换为存储备份的驱动器盘符。

    mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json

  3. 保存 MongoDB 助手配置文件。

  4. 将配置备份文件移至新目录。 使用 Windows 资源管理器移动文件，或从命令提示符或 PowerShell 发出以下命令：

    move %SystemDrive%\MMSMongoDB\versions\mms-cluster-config-backup.json \<newPath>
7

对每个 MongoDB 主机重复该安装步骤。

使用此步骤安装 MongoDB 助手：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

在运行Debian 9 / 10 / 11 / 12或Ubuntu 18.04 / 20.04 / 22的 x 86 _ 64架构上。 04 ：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击Debian 9 、 Ubuntu 16 .X/ 18 .X - DEB。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击Debian 9 、 Ubuntu 16 .X/ 18 .X - DEB。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 助手的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载Ubuntu18.04 /20.04 / 的安装程序22.04或Debian 9 / 10 / 11 / 12 ，其中64位 x 86 ：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager_latest_amd64.ubuntu1604.deb

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

该数据目录存储着 MongoDB 数据。对于现有 MongoDB 部署，请确保该目录由 mongodb 用户拥有。如果不存在 MongoDB 部署，请创建目录并设置所有者。

要创建数据目录并将所有者设置为 mongodb 用户，请执行以下操作：

sudo mkdir -p /data; sudo chown mongodb:mongodb /data
7

启动 MongoDB 助手。

发出以下命令：

sudo systemctl start mongodb-mms-automation-agent.service
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

在运行Ubuntu 20.04 / 22.04的 ARM 64架构上：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击Ubuntu 20 .x/ 22 .x - DEB (ARM)。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击Ubuntu 20 .x/ 22 .x - DEB (ARM)。

3

下载最新版本的 MongoDB 助手。

从这一步开始，按照MongoDB Agent安装模式并将提供的命令复制到命令行中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl Ubuntu20命令以下载.x/.x 的安装程序22- DEB (ARM)：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager_latest_arm64.ubuntu2204.deb

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

该数据目录存储着 MongoDB 数据。对于现有 MongoDB 部署，请确保该目录由 mongodb 用户拥有。如果不存在 MongoDB 部署，请创建目录并设置所有者。

要创建数据目录并将所有者设置为 mongodb 用户，请执行以下操作：

sudo mkdir -p /data; sudo chown mongodb:mongodb /data
7

启动 MongoDB 助手。

发出以下命令：

sudo systemctl start mongodb-mms-automation-agent.service
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

使用此步骤安装 MongoDB 助手：

在 x 86 _ 64架构上：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

使用rpm包运行 Amazon Linux：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击Amazon Linux - RPM。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击Amazon Linux - RPM。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的主机上的系统shell MongoDB Agent中，发出以下curl 命令以下载64 位 x86 的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

正在运行 RHEL（ 7 .x、 8 .x 或9 .x）或CentOS （ 7 .x 或8 .x）， SUSE12 、 SUSE15或Amazon Linux 2 ：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

使用rpm包：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux2 - RPM。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux2 - RPM。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的主机上的系统shell MongoDB Agent中，发出以下curl 7命令以下载适用于64 位 x 的 RHEL86 安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rhel<version>.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

使用tar存档：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux 2 - TAR。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux 2 - TAR。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载适用于64 位 x 的 RHEL86 安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_x86_64.tar.gz

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

提取MongoDB Agent 。

您可以将MongoDB Agent安装在任何目录中。 如果您想在解压缩之前将存档移动到另一个目录，可以这样做。

要安装MongoDB Agent ，请提取存档：

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64.tar.gz
5

切换到解压缩的二进制目录。

切换到解压缩MongoDB Agent二进制文件后创建的目录：

cd mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64
6

编辑 MongoDB 助手配置文件。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件：

vi <install-path>/local.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 local.config文件的最终更改应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件。

vi <install-path>/local.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

8

可选：创建二进制、日志和数据目录。

创建以下目录来存储MongoDB Agent所需的文件。

注意

在文件路径中使用 mongodb-mms-automation 是一项传统项目，并不平均值在安装MongoDB Agent时会配置自动化。

组件
默认目录
说明

二进制文件

/var/lib/mongodb-mms-automation

这些是MongoDB Agent管理的二进制文件。 其中包括MongoDB Agent 、 BI Connector和MongoDB二进制文件。

MongoDB 助手日志

/var/log/mongodb-mms-automation

这些是MongoDB Agent创建的日志文件。

MongoDB数据库

/data

这些是MongoDB Agent创建和管理的数据库。

运行以下命令以创建目录：

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

默认，助手二进制文件和MongoDB Ops Manager配置备份文件位于 /var/lib/mongodb-mms-automation。 如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

要更改代理二进制文件的位置：

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行代理的每台主机上创建您指定的新目录。

    sudo mkdir -m 755 -p /<newPath>

要更改助手配置备份的位置，请执行以下操作：

  1. 在您首选的文本编辑器中打开助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

  3. 保存代理配置文件。

  4. 将配置备份文件移至新目录。

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

为运行MongoDB Agent的系统用户分配权限。

运行以下命令：

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongod \
    -d /var/lib/mongo -s /bin/false \
    -c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

启动 MongoDB 助手。

在安装MongoDB Agent的目录中，以上一步中创建的系统用户身份发出以下命令：

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

12

对每个 MongoDB 主机重复该安装步骤。

在 PowerPC 架构上的 RHEL/ CentOS ( 7 .x) 上（管理MongoDB 3.4或更高版本的部署）：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

使用rpm包：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - RPM。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - RPM。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL7 for PowerPC 的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc64le.rhel<version>.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

使用tar存档：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - TAR。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - TAR。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL7 for PowerPC 的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_ppc64le.tar.gz

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

提取MongoDB Agent 。

您可以将MongoDB Agent安装在任何目录中。 如果您想在解压缩之前将存档移动到另一个目录，可以这样做。

要安装MongoDB Agent ，请提取存档：

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le.tar.gz
5

切换到解压缩的二进制目录。

切换到解压缩MongoDB Agent二进制文件后创建的目录：

cd mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le
6

编辑 MongoDB 助手配置文件。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件：

vi <install-path>/local.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 local.config文件的最终更改应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件。

vi <install-path>/local.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

8

可选：创建二进制、日志和数据目录。

创建以下目录来存储MongoDB Agent所需的文件。

注意

在文件路径中使用 mongodb-mms-automation 是一项传统项目，并不平均值在安装MongoDB Agent时会配置自动化。

组件
默认目录
说明

二进制文件

/var/lib/mongodb-mms-automation

这些是MongoDB Agent管理的二进制文件。 其中包括MongoDB Agent 、 BI Connector和MongoDB二进制文件。

MongoDB 助手日志

/var/log/mongodb-mms-automation

这些是MongoDB Agent创建的日志文件。

MongoDB数据库

/data

这些是MongoDB Agent创建和管理的数据库。

运行以下命令以创建目录：

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

默认，助手二进制文件和MongoDB Ops Manager配置备份文件位于 /var/lib/mongodb-mms-automation。 如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

要更改代理二进制文件的位置：

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行代理的每台主机上创建您指定的新目录。

    sudo mkdir -m 755 -p /<newPath>

要更改助手配置备份的位置，请执行以下操作：

  1. 在您首选的文本编辑器中打开助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

  3. 保存代理配置文件。

  4. 将配置备份文件移至新目录。

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

为运行MongoDB Agent的系统用户分配权限。

运行以下命令：

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongod \
    -d /var/lib/mongo -s /bin/false \
    -c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

启动 MongoDB 助手。

在安装MongoDB Agent的目录中，以上一步中创建的系统用户身份发出以下命令：

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

12

对每个 MongoDB 主机重复该安装步骤。

在 zSeries 架构上（管理MongoDB 4.4或更高版本的部署）：

正在运行 RHEL（ 7 .x、 8 .x 或9 .x）或使用rpm包管理器的CentOS （ 7 .x 或8 .x）：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL 7 .X/ 8 X Z-Series (s 390 x) - RPM。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL 7 .X/ 8 X Z-Series (s 390 x) - RPM。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL.X/.X7 8forIBM zSeries 的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.rhel<version>.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

在运行RHEL（ 8 .x 或9 .x）或Amazon Linux 2的 ARM 64架构上：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

使用 rpm包管理器运行 RHEL（ 8 .x 或9 .x）或Amazon Linux 2 ：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 8 .X/ 9 .X)、 Amazon Linux2 、 Amazon Linux 2023 - RPM (ARM)。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 8 .X/ 9 .X)、 Amazon Linux2 、 Amazon Linux 2023 - RPM (ARM)。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL（.x8 9或.x）或Amazon Linux2 for ARM{464 的安装程序:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

使用tar存档：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 8 .X/ 9 .X)、 Amazon Linux 2 、 Amazon Linux 2023 - TAR (ARM)。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 8 .X/ 9 .X)、 Amazon Linux 2 、 Amazon Linux 2023 - TAR (ARM)。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL（.x8 9或.x）或Amazon Linux2 for ARM{464 的安装程序:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.amzn2_aarch64.tar.gz

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

提取MongoDB Agent 。

您可以将MongoDB Agent安装在任何目录中。 如果您想在解压缩之前将存档移动到另一个目录，可以这样做。

要安装MongoDB Agent ，请提取存档：

tar -xvzf mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64.tar.gz
5

切换到解压缩的二进制目录。

切换到解压缩MongoDB Agent二进制文件后创建的目录：

cd mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64
6

编辑 MongoDB 助手配置文件。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件：

vi <install-path>/local.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 local.config文件的最终更改应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件。

vi <install-path>/local.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

8

可选：创建二进制、日志和数据目录。

创建以下目录来存储MongoDB Agent所需的文件。

注意

在文件路径中使用 mongodb-mms-automation 是一项传统项目，并不平均值在安装MongoDB Agent时会配置自动化。

组件
默认目录
说明

二进制文件

/var/lib/mongodb-mms-automation

这些是MongoDB Agent管理的二进制文件。 其中包括MongoDB Agent 、 BI Connector和MongoDB二进制文件。

MongoDB 助手日志

/var/log/mongodb-mms-automation

这些是MongoDB Agent创建的日志文件。

MongoDB数据库

/data

这些是MongoDB Agent创建和管理的数据库。

运行以下命令以创建目录：

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

默认，助手二进制文件和MongoDB Ops Manager配置备份文件位于 /var/lib/mongodb-mms-automation。 如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

要更改代理二进制文件的位置：

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行代理的每台主机上创建您指定的新目录。

    sudo mkdir -m 755 -p /<newPath>

要更改助手配置备份的位置，请执行以下操作：

  1. 在您首选的文本编辑器中打开助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

  3. 保存代理配置文件。

  4. 将配置备份文件移至新目录。

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

为运行MongoDB Agent的系统用户分配权限。

运行以下命令：

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongod \
    -d /var/lib/mongo -s /bin/false \
    -c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

启动 MongoDB 助手。

在安装MongoDB Agent的目录中，以上一步中创建的系统用户身份发出以下命令：

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

12

对每个 MongoDB 主机重复该安装步骤。

使用此过程可安装不使用deb或rpm软件包的Linux系统。

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击“Other Linux - TAR”（其他 Linux - TAR）。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击“Other Linux - TAR”（其他 Linux - TAR）。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载通用 位64 Linux的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

提取MongoDB Agent 。

您可以将MongoDB Agent安装在任何目录中。 如果您想在解压缩之前将存档移动到另一个目录，可以这样做。

要安装MongoDB Agent ，请提取存档：

tar -xvzf mongodb-mms-automation-agent-<VERSION>.linux_x86_64.tar.gz
5

切换到解压缩的二进制目录。

切换到解压缩MongoDB Agent二进制文件后创建的目录：

cd mongodb-mms-automation-agent-<VERSION>.linux_x86_64
6

编辑 MongoDB 助手配置文件。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件：

vi <install-path>/local.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 local.config文件的最终更改应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件。

vi <install-path>/local.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

8

可选：创建二进制、日志和数据目录。

创建以下目录来存储MongoDB Agent所需的文件。

注意

在文件路径中使用 mongodb-mms-automation 是一项传统项目，并不平均值在安装MongoDB Agent时会配置自动化。

组件
默认目录
说明

二进制文件

/var/lib/mongodb-mms-automation

这些是MongoDB Agent管理的二进制文件。 其中包括MongoDB Agent 、 BI Connector和MongoDB二进制文件。

MongoDB 助手日志

/var/log/mongodb-mms-automation

这些是MongoDB Agent创建的日志文件。

MongoDB数据库

/data

这些是MongoDB Agent创建和管理的数据库。

运行以下命令以创建目录：

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

默认，助手二进制文件和MongoDB Ops Manager配置备份文件位于 /var/lib/mongodb-mms-automation。 如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

要更改代理二进制文件的位置：

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行代理的每台主机上创建您指定的新目录。

    sudo mkdir -m 755 -p /<newPath>

要更改助手配置备份的位置，请执行以下操作：

  1. 在您首选的文本编辑器中打开助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

  3. 保存代理配置文件。

  4. 将配置备份文件移至新目录。

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

为运行MongoDB Agent的系统用户分配权限。

运行以下命令：

# Create mongodb user and group if they do not exist
if ! sudo /usr/bin/id -g mongodb &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongodb
fi
# Create mongodb user if they do not exist and assign
# them to the mongodb group
if ! sudo /usr/bin/id mongodb &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongodb \
    -d /var/lib/mongo -s /bin/false \
    -c mongodb mongodb > /dev/null 2>&1
fi
# Grant the mongodb:mongodb user and group permissions
# to manage deployments.
sudo chown mongodb:mongodb /var/lib/mongodb-mms-automation
sudo chown mongodb:mongodb /var/log/mongodb-mms-automation
sudo chown mongodb:mongodb /data
10

启动 MongoDB 助手。

在安装MongoDB Agent的目录中，以上一步中创建的系统用户身份发出以下命令：

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

12

对每个 MongoDB 主机重复该安装步骤。

使用以下步骤在运行 Microsoft Windows 的 x86_64 架构上安装 MongoDB 助手：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从 Select Your Server's Operating System 菜单中，单击 Windows - MSI。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从 Install Agent 菜单中，单击 Windows - MSI。

3

下载 MongoDB 助手。

MongoDB Agent Installation Instructions 框会显示以下信息：

  • Base URL

    绑定到项目时必填。

  • Project ID （绑定到项目时必填）

  • API Key

    如果没有 API 密钥，请单击生成密钥。

后续步骤需要用到其中部分或全部值。复制这些值，然后将它们存储在便于稍后访问的位置。

4

安装 MongoDB 助手。

  1. 下载 MSI 后，双击：

    mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi

  2. 如果出现安全警告，请单击 Run。

  3. 在 Configuration/Log Folder 步骤

    提供保存这些文件的目录。

  4. 在Key Type步骤中，选择Agent API Key以绑定到特定项目。

  5. 输入相应的代理密钥。

    注意

    上一步描述的 MongoDB Agent Installation Instructions 模态中提供了这些密钥。

    • 在 Base URL 字段中输入您的 Base URL。

    • 在 Project ID 字段中输入您的项目 ID。

    • 在 Agent API Key 字段中键入您的代理 API 密钥。

    • 在 Agent API Key 字段中键入您的代理 API 密钥。

  6. 在 MongoDB Paths 步骤中，指定日志和备份目录

  7. 在 Windows Firewall Configuration 步骤中，单击首选防火墙配置。

    如果单击Configure firewall rules allowing access from only the specified |ipaddr| addresses. ，请在提供的框中键入必要的IPv 4地址。

  8. （有条件）Windows 启用 隐身模式 默认用于 Windows 防火墙。如果您尚未在安装MongoDB 助手的MongoDB Agent 主机上禁用它，系统会要求您禁用它。隐身模式会显着降低MongoDB Agent助手的性能和功能。 单击Disable Stealth Mode 。

  9. （有条件） Windows未启用 磁盘性能计数器 默认。如果您尚未为MongoDB托管启用磁盘性能计数器，请单击Enable Disk Performance Counters 。 MongoDB Agent使用这些计数器进行某些硬件监控活动。

  10. 单击 Install（连接）。

  11. 设置完成后，请单击 Finish。

下载MSI后，您可以运行无人值守安装。 可以在命令解释器或 PowerShell 中从命令行运行无人值守安装。 要了解有关无人值守安装的更多信息，请参阅有关 标准安装程序命令行选项 的 Microsoft 文档

要在无人值守的情况下从命令行运行MSI安装程序，请使用/q和/i标志以及必需和可选参数的组合来调用msiexec.exe ：

Parameter
必要性
值

MMSAPIKEY

必需

APIMongoDB Ops Manager项目的代理 密钥。

MMSBASEURL

必需

URLMongoDB Ops Manager托管的 。

MMSGROUPID

必需

MongoDB Ops Manager项目的唯一标识符。

CONFIGLOGDIR

Optional

MongoDB Ops Manager应将MongoDB Agent配置文件写入到的绝对文件路径。

LOGFILE

Optional

MongoDB Ops Manager应将MongoDB Agent日志写入到的绝对文件路径

MMSCONFIGBACKUP

Optional

MongoDB Ops Manager自动化配置备份JSON文件的绝对文件路径。

例子

要在无人值守的情况下安装MongoDB Agent助手，您可以使用以下选项调用 msiexec.exe：

msiexec.exe /q /i "C:\PATH\TO\mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi" MMSGROUPID=<GROUP.ID> MMSAPIKEY=<AGENT.API.ID> MMSBASEURL="<http://opsmanager.example.com:8080>" LOGFILE="C:\MMSData\Server\Log\automation-agent.log" MMSCONFIGBACKUP="C:\MMSData\MongoDB\mms-cluster-config-backup.json"
5

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

6

（可选）更改 MongoDB 助手二进制文件和配置备份文件的位置。

默认情况下，MongoDB 二进制文件和 Ops Manager 配置备份文件位于 %SystemDrive%\MMSMongoDB\versions。

注意

Windows将%SystemDrive%环境变量设置为安装Windows的驱动器。 默认，系统会引导您在C:驱动器上安装Windows 。 要查找%SystemDrive% ，请从 PowerShell 发出以下命令：

get-childitem env:SystemDrive

如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

更改 MongoDB 助手二进制文件的位置

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在 Download Directory 标题下方，单击 Download Directory (Windows) 中所示路径右侧的 。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行MongoDB Agent的每台托管上创建您指定的新目录。 使用Windows资源管理器移动文件，或从命令提示符或 PowerShell 发出以下命令：

    md \<newPath>

    重要

    确保运行 MongoDB 助手的系统用户可以写入这个新目录。这通常是 SYSTEM 用户，除非您更改了用户，否则不需要其他配置。

更改 MongoDB 助手配置备份的位置

  1. 用您首选的文本编辑器打开 MongoDB 助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。将 X 替换为存储备份的驱动器盘符。

    mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json

  3. 保存 MongoDB 助手配置文件。

  4. 将配置备份文件移至新目录。 使用 Windows 资源管理器移动文件，或从命令提示符或 PowerShell 发出以下命令：

    move %SystemDrive%\MMSMongoDB\versions\mms-cluster-config-backup.json \<newPath>
7

对每个 MongoDB 主机重复该安装步骤。

使用此步骤安装 MongoDB 助手：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

在运行Debian 9 / 10 / 11 / 12或Ubuntu 18.04 / 20.04 / 22的 x 86 _ 64架构上。 04 ：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击Debian 9 、 Ubuntu 16 .X/ 18 .X - DEB。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击Debian 9 、 Ubuntu 16 .X/ 18 .X - DEB。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 助手的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载Ubuntu18.04 /20.04 / 的安装程序22.04或Debian 9 / 10 / 11 / 12 ，其中64位 x 86 ：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager_latest_amd64.ubuntu1604.deb

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

该数据目录存储着 MongoDB 数据。对于现有 MongoDB 部署，请确保该目录由 mongodb 用户拥有。如果不存在 MongoDB 部署，请创建目录并设置所有者。

要创建数据目录并将所有者设置为 mongodb 用户，请执行以下操作：

sudo mkdir -p /data; sudo chown mongodb:mongodb /data
7

启动 MongoDB 助手。

发出以下命令：

sudo systemctl start mongodb-mms-automation-agent.service
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

在运行Ubuntu 20.04 / 22.04的 ARM 64架构上：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击Ubuntu 20 .x/ 22 .x - DEB (ARM)。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击Ubuntu 20 .x/ 22 .x - DEB (ARM)。

3

下载最新版本的 MongoDB 助手。

从这一步开始，按照MongoDB Agent安装模式并将提供的命令复制到命令行中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl Ubuntu20命令以下载.x/.x 的安装程序22- DEB (ARM)：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager_latest_arm64.ubuntu2204.deb

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

该数据目录存储着 MongoDB 数据。对于现有 MongoDB 部署，请确保该目录由 mongodb 用户拥有。如果不存在 MongoDB 部署，请创建目录并设置所有者。

要创建数据目录并将所有者设置为 mongodb 用户，请执行以下操作：

sudo mkdir -p /data; sudo chown mongodb:mongodb /data
7

启动 MongoDB 助手。

发出以下命令：

sudo systemctl start mongodb-mms-automation-agent.service
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

使用此步骤安装 MongoDB 助手：

在 x 86 _ 64架构上：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

使用rpm包运行 Amazon Linux：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击Amazon Linux - RPM。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击Amazon Linux - RPM。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的主机上的系统shell MongoDB Agent中，发出以下curl 命令以下载64 位 x86 的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

正在运行 RHEL（ 7 .x、 8 .x 或9 .x）或CentOS （ 7 .x 或8 .x）， SUSE12 、 SUSE15或Amazon Linux 2 ：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

使用rpm包：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux2 - RPM。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux2 - RPM。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的主机上的系统shell MongoDB Agent中，发出以下curl 7命令以下载适用于64 位 x 的 RHEL86 安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rhel<version>.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

使用tar存档：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux 2 - TAR。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux 2 - TAR。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载适用于64 位 x 的 RHEL86 安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_x86_64.tar.gz

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

提取MongoDB Agent 。

您可以将MongoDB Agent安装在任何目录中。 如果您想在解压缩之前将存档移动到另一个目录，可以这样做。

要安装MongoDB Agent ，请提取存档：

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64.tar.gz
5

切换到解压缩的二进制目录。

切换到解压缩MongoDB Agent二进制文件后创建的目录：

cd mongodb-mms-automation-agent-<VERSION>.rhel7_x86_64
6

编辑 MongoDB 助手配置文件。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件：

vi <install-path>/local.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 local.config文件的最终更改应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件。

vi <install-path>/local.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

8

可选：创建二进制、日志和数据目录。

创建以下目录来存储MongoDB Agent所需的文件。

注意

在文件路径中使用 mongodb-mms-automation 是一项传统项目，并不平均值在安装MongoDB Agent时会配置自动化。

组件
默认目录
说明

二进制文件

/var/lib/mongodb-mms-automation

这些是MongoDB Agent管理的二进制文件。 其中包括MongoDB Agent 、 BI Connector和MongoDB二进制文件。

MongoDB 助手日志

/var/log/mongodb-mms-automation

这些是MongoDB Agent创建的日志文件。

MongoDB数据库

/data

这些是MongoDB Agent创建和管理的数据库。

运行以下命令以创建目录：

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

默认，助手二进制文件和MongoDB Ops Manager配置备份文件位于 /var/lib/mongodb-mms-automation。 如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

要更改代理二进制文件的位置：

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行代理的每台主机上创建您指定的新目录。

    sudo mkdir -m 755 -p /<newPath>

要更改助手配置备份的位置，请执行以下操作：

  1. 在您首选的文本编辑器中打开助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

  3. 保存代理配置文件。

  4. 将配置备份文件移至新目录。

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

为运行MongoDB Agent的系统用户分配权限。

运行以下命令：

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongod \
    -d /var/lib/mongo -s /bin/false \
    -c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

启动 MongoDB 助手。

在安装MongoDB Agent的目录中，以上一步中创建的系统用户身份发出以下命令：

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

12

对每个 MongoDB 主机重复该安装步骤。

在 PowerPC 架构上的 RHEL/ CentOS ( 7 .x) 上（管理MongoDB 3.4或更高版本的部署）：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

使用rpm包：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - RPM。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - RPM。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL7 for PowerPC 的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc64le.rhel<version>.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

使用tar存档：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - TAR。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - TAR。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL7 for PowerPC 的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_ppc64le.tar.gz

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

提取MongoDB Agent 。

您可以将MongoDB Agent安装在任何目录中。 如果您想在解压缩之前将存档移动到另一个目录，可以这样做。

要安装MongoDB Agent ，请提取存档：

tar -xvzf mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le.tar.gz
5

切换到解压缩的二进制目录。

切换到解压缩MongoDB Agent二进制文件后创建的目录：

cd mongodb-mms-automation-agent-<VERSION>.rhel7_ppc64le
6

编辑 MongoDB 助手配置文件。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件：

vi <install-path>/local.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 local.config文件的最终更改应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件。

vi <install-path>/local.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

8

可选：创建二进制、日志和数据目录。

创建以下目录来存储MongoDB Agent所需的文件。

注意

在文件路径中使用 mongodb-mms-automation 是一项传统项目，并不平均值在安装MongoDB Agent时会配置自动化。

组件
默认目录
说明

二进制文件

/var/lib/mongodb-mms-automation

这些是MongoDB Agent管理的二进制文件。 其中包括MongoDB Agent 、 BI Connector和MongoDB二进制文件。

MongoDB 助手日志

/var/log/mongodb-mms-automation

这些是MongoDB Agent创建的日志文件。

MongoDB数据库

/data

这些是MongoDB Agent创建和管理的数据库。

运行以下命令以创建目录：

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

默认，助手二进制文件和MongoDB Ops Manager配置备份文件位于 /var/lib/mongodb-mms-automation。 如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

要更改代理二进制文件的位置：

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行代理的每台主机上创建您指定的新目录。

    sudo mkdir -m 755 -p /<newPath>

要更改助手配置备份的位置，请执行以下操作：

  1. 在您首选的文本编辑器中打开助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

  3. 保存代理配置文件。

  4. 将配置备份文件移至新目录。

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

为运行MongoDB Agent的系统用户分配权限。

运行以下命令：

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongod \
    -d /var/lib/mongo -s /bin/false \
    -c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

启动 MongoDB 助手。

在安装MongoDB Agent的目录中，以上一步中创建的系统用户身份发出以下命令：

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

12

对每个 MongoDB 主机重复该安装步骤。

在 zSeries 架构上（管理MongoDB 4.4或更高版本的部署）：

正在运行 RHEL（ 7 .x、 8 .x 或9 .x）或使用rpm包管理器的CentOS （ 7 .x 或8 .x）：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL 7 .X/ 8 X Z-Series (s 390 x) - RPM。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL 7 .X/ 8 X Z-Series (s 390 x) - RPM。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL.X/.X7 8forIBM zSeries 的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.rhel<version>.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

在运行RHEL（ 8 .x 或9 .x）或Amazon Linux 2的 ARM 64架构上：

重要

从版本 11.0.5.6967-1开始，当您使用 deb 或 rpm 包安装MongoDB Agent时，该包不会将MongoDB二进制文件添加到 PATH 环境变量中。

如果您的部署取决于 PATH 中是否存在 MongoDB 二进制文件，则必须手动将 MongoDB 二进制文件的路径添加到 PATH 中。要了解如何更新环境变量，请参阅操作系统文档。

使用 rpm包管理器运行 RHEL（ 8 .x 或9 .x）或Amazon Linux 2 ：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 8 .X/ 9 .X)、 Amazon Linux2 、 Amazon Linux 2023 - RPM (ARM)。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 8 .X/ 9 .X)、 Amazon Linux2 、 Amazon Linux 2023 - RPM (ARM)。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL（.x8 9或.x）或Amazon Linux2 for ARM{464 的安装程序:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.rpm

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

编辑 MongoDB 助手配置文件。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 automation-agent.config 文件的修改结果应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
5

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装 MongoDB 助手的目录中，使用首选文本编辑器打开 automation-agent.config 文件：

sudo vi /etc/mongodb-mms/automation-agent.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

6

准备数据目录。

数据目录存储MongoDB数据，必须由mongod用户拥有。 对于现有MongoDB 部署，请确保mongod用户为该目录的所有者。 如果不存在MongoDB 部署，请创建目录并设立所有者。

以下命令创建一个数据目录并将所有者设立为mongod用户：

sudo mkdir /data; sudo chown mongod:mongod /data
7

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start
8

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

9

对每个 MongoDB 主机重复该安装步骤。

使用tar存档：

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击 RHEL/ CentOS ( 8 .X/ 9 .X)、 Amazon Linux 2 、 Amazon Linux 2023 - TAR (ARM)。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击 RHEL/ CentOS ( 8 .X/ 9 .X)、 Amazon Linux 2 、 Amazon Linux 2023 - TAR (ARM)。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载RHEL（.x8 9或.x）或Amazon Linux2 for ARM{464 的安装程序:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.amzn2_aarch64.tar.gz

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

提取MongoDB Agent 。

您可以将MongoDB Agent安装在任何目录中。 如果您想在解压缩之前将存档移动到另一个目录，可以这样做。

要安装MongoDB Agent ，请提取存档：

tar -xvzf mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64.tar.gz
5

切换到解压缩的二进制目录。

切换到解压缩MongoDB Agent二进制文件后创建的目录：

cd mongodb-mms-automation-agent-<VERSION>.amzn2_aarch64
6

编辑 MongoDB 助手配置文件。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件：

vi <install-path>/local.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 local.config文件的最终更改应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件。

vi <install-path>/local.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

8

可选：创建二进制、日志和数据目录。

创建以下目录来存储MongoDB Agent所需的文件。

注意

在文件路径中使用 mongodb-mms-automation 是一项传统项目，并不平均值在安装MongoDB Agent时会配置自动化。

组件
默认目录
说明

二进制文件

/var/lib/mongodb-mms-automation

这些是MongoDB Agent管理的二进制文件。 其中包括MongoDB Agent 、 BI Connector和MongoDB二进制文件。

MongoDB 助手日志

/var/log/mongodb-mms-automation

这些是MongoDB Agent创建的日志文件。

MongoDB数据库

/data

这些是MongoDB Agent创建和管理的数据库。

运行以下命令以创建目录：

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

默认，助手二进制文件和MongoDB Ops Manager配置备份文件位于 /var/lib/mongodb-mms-automation。 如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

要更改代理二进制文件的位置：

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行代理的每台主机上创建您指定的新目录。

    sudo mkdir -m 755 -p /<newPath>

要更改助手配置备份的位置，请执行以下操作：

  1. 在您首选的文本编辑器中打开助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

  3. 保存代理配置文件。

  4. 将配置备份文件移至新目录。

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

为运行MongoDB Agent的系统用户分配权限。

运行以下命令：

# Create mongod user and group if they do not exist
if ! sudo /usr/bin/id -g mongod &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongod
fi
# Create mongod user if they do not exist and assign
# them to the mongod group
if ! sudo /usr/bin/id mongod &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongod \
    -d /var/lib/mongo -s /bin/false \
    -c mongod mongod > /dev/null 2>&1
fi
# Grant the mongod:mongod user and group permissions
# to manage deployments.
sudo chown mongod:mongod /var/lib/mongod-mms-automation
sudo chown mongod:mongod /var/log/mongod-mms-automation
sudo chown mongod:mongod /data
10

启动 MongoDB 助手。

在安装MongoDB Agent的目录中，以上一步中创建的系统用户身份发出以下命令：

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

12

对每个 MongoDB 主机重复该安装步骤。

使用此过程可安装不使用deb或rpm软件包的Linux系统。

1

登录 Ops Manager 应用程序。

2

开始或管理部署。

如果您的项目没有任何部署，您会看到开始提示。

  1. 从 Build New Deployment 菜单中选择要添加的部署类型：

  2. 如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机，您会在 Create New Deployment 页面顶部看到一条横幅。

    单击 see instructions（管理员）链接。

  3. 从Select Your Server's Operating System菜单中，单击“Other Linux - TAR”（其他 Linux - TAR）。

  4. 单击 Next（连接）。

  1. 单击“管理现有部署”。

  2. 从Install Agent菜单中，单击“Other Linux - TAR”（其他 Linux - TAR）。

3

下载最新版本的 MongoDB 助手。

从这一步开始，遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。

从将运行 的托管上的系统shell MongoDB Agent中，发出以下curl 命令以下载通用 位64 Linux的安装程序：

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz

注意

将 <OpsManagerHost>:<Port> 替换为MongoDB Ops Manager应用程序的主机名和端口。 如果存在，则将<version>替换为操作系统的主要版本。 示例，对于 RHEL 7 .x，将<version>替换为7 。

4

提取MongoDB Agent 。

您可以将MongoDB Agent安装在任何目录中。 如果您想在解压缩之前将存档移动到另一个目录，可以这样做。

要安装MongoDB Agent ，请提取存档：

tar -xvzf mongodb-mms-automation-agent-<VERSION>.linux_x86_64.tar.gz
5

切换到解压缩的二进制目录。

切换到解压缩MongoDB Agent二进制文件后创建的目录：

cd mongodb-mms-automation-agent-<VERSION>.linux_x86_64
6

编辑 MongoDB 助手配置文件。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件：

vi <install-path>/local.config

更新以下配置选项：

键
值

mmsGroupId

ProjectID （您的项目）。

mmsApiKey

项目的Agent API密钥。

mmsbaseurl

Ops Manager 应用程序的 URL（主机名和端口）。

对 local.config文件的最终更改应如下所示：

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
7

可选：配置 MongoDB 助手以使用代理服务器。

要将 MongoDB 助手配置为通过代理服务器连接到 Ops Manager，必须在 httpProxy 环境变量中指定该服务器。

在安装MongoDB Agent助手的目录中，使用首选文本编辑器打开 local.config文件。

vi <install-path>/local.config

添加以下配置键：

键
值

httpProxy

代理服务器的 URL（主机名和端口）。

8

可选：创建二进制、日志和数据目录。

创建以下目录来存储MongoDB Agent所需的文件。

注意

在文件路径中使用 mongodb-mms-automation 是一项传统项目，并不平均值在安装MongoDB Agent时会配置自动化。

组件
默认目录
说明

二进制文件

/var/lib/mongodb-mms-automation

这些是MongoDB Agent管理的二进制文件。 其中包括MongoDB Agent 、 BI Connector和MongoDB二进制文件。

MongoDB 助手日志

/var/log/mongodb-mms-automation

这些是MongoDB Agent创建的日志文件。

MongoDB数据库

/data

这些是MongoDB Agent创建和管理的数据库。

运行以下命令以创建目录：

sudo mkdir -m 755 -p /var/lib/mongodb-mms-automation
sudo mkdir -m 755 -p /var/log/mongodb-mms-automation
sudo mkdir -m 755 -p /data

默认，助手二进制文件和MongoDB Ops Manager配置备份文件位于 /var/lib/mongodb-mms-automation。 如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

要更改代理二进制文件的位置：

  1. 依次单击 Deployment、Agents 和 Downloads & Settings。

  2. 在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。

  3. 将路径更改为所需的新路径。

  4. 单击 Save（连接）。

  5. 在运行代理的每台主机上创建您指定的新目录。

    sudo mkdir -m 755 -p /<newPath>

要更改助手配置备份的位置，请执行以下操作：

  1. 在您首选的文本编辑器中打开助手配置文件。

  2. 将 mmsConfigBackup 设置更改为配置备份文件的新路径。

    mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json

  3. 保存代理配置文件。

  4. 将配置备份文件移至新目录。

    sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
9

为运行MongoDB Agent的系统用户分配权限。

运行以下命令：

# Create mongodb user and group if they do not exist
if ! sudo /usr/bin/id -g mongodb &>/dev/null; then
  sudo /usr/sbin/groupadd -r mongodb
fi
# Create mongodb user if they do not exist and assign
# them to the mongodb group
if ! sudo /usr/bin/id mongodb &>/dev/null; then
  sudo /usr/sbin/useradd -M -r -g mongodb \
    -d /var/lib/mongo -s /bin/false \
    -c mongodb mongodb > /dev/null 2>&1
fi
# Grant the mongodb:mongodb user and group permissions
# to manage deployments.
sudo chown mongodb:mongodb /var/lib/mongodb-mms-automation
sudo chown mongodb:mongodb /var/log/mongodb-mms-automation
sudo chown mongodb:mongodb /data
10

启动 MongoDB 助手。

在安装MongoDB Agent的目录中，以上一步中创建的系统用户身份发出以下命令：

nohup ./mongodb-mms-automation-agent \
  --config=local.config \
  >> /var/log/mongodb-mms-automation/automation-agent-fatal.log 2>&1 &
11

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中：

  1. 单击 Verify Agent 以确保 MongoDB 助手可以连接到 Ops Manager。

  2. 单击 Done（连接）。

12

对每个 MongoDB 主机重复该安装步骤。

后退

安装

来年

监控或备份部署