从旧版备份和监控代理进行更新

您有一个项目，其中包含受监控和备份的 MongoDB 部署，但自动化未对其进行管理，并且您希望将其更新到 MongoDB 助手。

注意

首先查看先决条件

如果您想开始或继续使用自动化来管理MongoDB 部署，请在更新到之前查看MongoDB Agent 先决条件 MongoDB Agent。

步骤

使用此过程可在运行 Microsoft Windows 的 x86_64 架构上更新到 MongoDB Agent：

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

旧版代理作为单独的数据库用户使用 Kerberos 进行身份验证。由于 MongoDB Agent 结合了旧版代理的功能，因此它使用单个数据库用户。要升级到 MongoDB Agent 并继续使用 Kerberos，您必须：

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

下载 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择 Windows - MSI。
单击Next 。 Install New MongoDB Agent模式窗口打开。

安装 MongoDB 助手。

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

Base URL
绑定到项目时必填。
Project ID （绑定到项目时必填）
API Key
如果没有 API 密钥，请单击生成密钥。

警告

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

运行 MongoDB Agent Windows 安装程序。

下载 MSI 后，双击：
mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi
注意
在文件名中使用mongodb-mms-automation是一个旧版问题，并不平均值在安装 MongoDB Agent 时配置了自动化。
如果出现安全警告，请单击 Run。
在Configuration/Log Folder步骤中，输入保存MSI文件的目录。
在Key Type步骤中，选择Agent API Key以绑定到特定的项目。
输入相应的代理密钥。
注意
上一步描述的 MongoDB Agent Installation Instructions 模态中提供了这些密钥。
如果选择了Agent API Key ，请键入：
- Base URL
- Project ID
- Agent API Key
在MongoDB Paths步骤中，指定日志和备份目录。
在Windows Firewall Configuration步骤中，选择您的首选防火墙配置。
如果您选择Configure firewall rules allowing access from only the specified |ipaddr| addresses. ，请在提供的框中键入必要的 IPv 4地址。
（有条件） Windows启用隐身模式默认用于Windows防火墙。如果您尚未在安装MongoDB 助手的MongoDB Agent 托管上禁用此功能，请立即禁用。隐身模式会显着降低MongoDB Agent助手的性能和功能。单击Disable Stealth Mode 。
（有条件） Windows未启用磁盘性能计数器默认。如果您尚未为MongoDB托管启用磁盘性能计数器，请单击Enable Disk Performance Counters 。 MongoDB Agent使用这些计数器进行某些硬件监控活动。
单击 Install（连接）。
设置完成后，请单击 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"

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

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

您的系统策略或实践可能要求 MongoDB 二进制文件和 Ops Manager 配置备份文件位于默认位置%SystemDrive%\MMSMongoDB\versions以外的位置。

注意

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

get-childitem env:SystemDrive

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

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

依次单击 Deployment、Agents 和 Downloads & Settings。
在 Download Directory 标题下方，单击 Download Directory (Windows) 中所示路径右侧的。
将路径更改为所需的新路径。
单击 Save（连接）。
在运行MongoDB Agent的每台托管上创建您指定的新目录。使用Windows资源管理器移动文件，或从命令提示符或 PowerShell 发出以下命令：
```
md \<newPath>
```
重要
确保运行 MongoDB Agent 的系统用户可以写入这个新目录。这通常是SYSTEM用户，除非您更改了用户，否则不需要其他配置。

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

用您首选的文本编辑器打开 MongoDB 助手配置文件。
将mmsConfigBackup设置更改为配置备份文件的新路径。将以下示例中的X替换为存储备份的驱动器盘符。
```
mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json
```
保存 MongoDB 助手配置文件。
将配置备份文件移至新目录。使用 Windows 资源管理器移动文件，或从命令提示符或 PowerShell 发出以下命令：
```
move %SystemDrive%\MMSMongoDB\versions\mms-cluster-config-backup.json \<newPath>
```

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

使用此程序更新到 MongoDB Agent：

在运行Debian 86 9 64 Ubuntu 18.04 、 Ubuntu 20.04或Ubuntu 22.04 ：

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

安装 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择Debian 9 、 Ubuntu 16 .X/ 18 .X - DEB。
单击Next 。 Install New MongoDB Agent模式窗口打开。

下载最新版本的 MongoDB 助手。

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

从将运行 MongoDB 助手的主机上的 Shell 中，发出以下 curl 命令来下载 Ubuntu 18.04/20.04/22.04 或 Debian 9/10/11（适用于 64 位 x86 架构）的安装程序：

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 。

编辑 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>

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

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

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

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

添加以下配置键：

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

准备数据目录。

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

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

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

启动 MongoDB 助手。

发出以下命令：

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

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

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

在使用deb包运行Ubuntu 18.04的 zSeries 架构上：

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

安装 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择Ubuntu 18 .X Z-Series (s 390 x) - DEB。
单击Next 。 Install New MongoDB Agent模式窗口打开。

下载最新版本的 MongoDB 助手。

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

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

curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.ubuntu1804.deb

注意

编辑 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>

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

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

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

vi <install-path>/local.config

添加以下配置键：

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

准备数据目录。

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

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

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

启动 MongoDB 助手。

发出以下命令：

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

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

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

使用此程序更新到 MongoDB Agent：

在 x 86 _ 64架构上：

使用rpm包运行 RHEL/ CentOS 6 .x：

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

安装 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择Amazon Linux - RPM。
单击Next 。 Install New MongoDB Agent模式窗口打开。

下载最新版本的 MongoDB 助手。

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

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

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

注意

编辑 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>

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

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

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

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

添加以下配置键：

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

准备数据目录。

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

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

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

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

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

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

使用rpm包：

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

安装 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux2 - RPM。
单击Next 。 Install New MongoDB Agent模式窗口打开。

下载最新版本的 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

注意

编辑 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>

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

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

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

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

添加以下配置键：

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

准备数据目录。

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

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

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

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

使用tar存档：

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

安装 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux 2 - TAR。
单击Next 。 Install New MongoDB Agent模式窗口打开。

下载最新版本的 MongoDB 助手。

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

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

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

注意

提取MongoDB Agent 。

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

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

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

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

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

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

编辑 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>

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

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

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

vi <install-path>/local.config

添加以下配置键：

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

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

如果您已有监控代理和/或备份代理用户，且不打算激活自动化，则只需创建日志目录。

创建以下目录来存储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。如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

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

依次单击 Deployment、Agents 和 Downloads & Settings。
在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。
将路径更改为所需的新路径。
单击 Save（连接）。
在运行代理的每台主机上创建您指定的新目录。
```
sudo mkdir -m 755 -p /<newPath>
```

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

在您首选的文本编辑器中打开助手配置文件。
将 mmsConfigBackup 设置更改为配置备份文件的新路径。
```
mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
```
保存代理配置文件。
将配置备份文件移至新目录。
```
sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
```

为运行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

启动 MongoDB 助手。

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

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

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

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

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

使用rpm包：

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

安装 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux2 - RPM。
单击Next 。 Install New MongoDB Agent模式窗口打开。

下载最新版本的 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.ppc641e.rhel<version>.rpm

注意

编辑 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>

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

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

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

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

添加以下配置键：

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

准备数据目录。

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

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

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

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

使用tar存档：

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

安装 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - TAR。
单击Next 。 Install New MongoDB Agent模式窗口打开。

下载最新版本的 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.rhel7_ppc64le.tar.gz

注意

提取MongoDB Agent 。

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

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

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

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

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

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

编辑 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>

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

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

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

vi <install-path>/local.config

添加以下配置键：

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

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

如果您已有监控代理和/或备份代理用户，且不打算激活自动化，则只需创建日志目录。

创建以下目录来存储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。如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

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

依次单击 Deployment、Agents 和 Downloads & Settings。
在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。
将路径更改为所需的新路径。
单击 Save（连接）。
在运行代理的每台主机上创建您指定的新目录。
```
sudo mkdir -m 755 -p /<newPath>
```

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

在您首选的文本编辑器中打开助手配置文件。
将 mmsConfigBackup 设置更改为配置备份文件的新路径。
```
mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
```
保存代理配置文件。
将配置备份文件移至新目录。
```
sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
```

为运行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

启动 MongoDB 助手。

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

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

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

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

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

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

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

安装 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择 RHEL 7 .X/ 8 X Z-Series (s 390 x) - RPM。
单击Next 。 Install New MongoDB Agent模式窗口打开。

下载最新版本的 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

注意

编辑 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>

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

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

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

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

添加以下配置键：

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

准备数据目录。

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

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

启动 MongoDB 助手。

发出以下命令：

sudo service mongodb-mms-automation-agent start

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

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

使用此过程可在不使用MongoDB Agent Linuxdeb或rpm 包的系统上安装更新。

登录 Ops Manager 应用程序。

在通知横幅中，单击 Update All Agents（更新所有代理）。

Update to MongoDB Agent页面打开，可开始更新进程。显示Introducing the MongoDB Agent步骤。读完此步骤后，单击Next 。

可选：为您的旧版代理添加任何现有配置选项。

如果自动化未托管您的备份或监控代理，您可以在Add Custom Configuration Options for your MongoDB Agent (Optional)步骤添加之前的任何备份或监控设置。

重要

使用 Kerberos 身份验证的部署

请勿从代理的旧版中添加以下任一设置：

krb5Principal
krb5Keytab

为 MongoDB 助手创建新的Kerberos 用户主体和数据库用户。
使用新的 MongoDB Agent 主体和 Keytab 文件更新 Ops Manager Authentication & TLS设置中的代理身份验证。

更新到 MongoDB Agent 后，您可以删除旧版监控和备份代理用户。

要为备份代理和监控代理添加选项，请执行以下操作：

在Backup Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
在Monitoring Configurations部分下：
1. 在Setting框中键入所需的设置，并在Value框中键入相应的值。
2. 要添加多个Setting ，请单击+ Add Setting链接。出现另一行。
3. 重复此操作，直到添加所有设置。
添加部署所需的所有设置后，单击Next 。

您可以单击删除已添加的所有设置。

重要

Ops Manager 不会验证任何这些设置。确保设置和值正确。

安装 MongoDB 助手。

单击View Agent Install Instructions 。 Install Agent Instructions模式窗口打开。
从Select Your Server's Operating System菜单中，选择其他Linux - TAR。
单击Next 。 Install New MongoDB Agent模式窗口打开。

下载最新版本的 MongoDB 助手。

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

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

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

注意

提取MongoDB Agent 。

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

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

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

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

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

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

编辑 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>

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

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

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

vi <install-path>/local.config

添加以下配置键：

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

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

如果您已有监控代理和/或备份代理用户，且不打算激活自动化，则只需创建日志目录。

创建以下目录来存储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。如果要将这些文件存储在不同的目录中，请按照以下步骤操作：

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

依次单击 Deployment、Agents 和 Downloads & Settings。
在Download Directory标题下方，单击Download Directory (Linux)中所示路径右侧的铅笔图标。
将路径更改为所需的新路径。
单击 Save（连接）。
在运行代理的每台主机上创建您指定的新目录。
```
sudo mkdir -m 755 -p /<newPath>
```

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

在您首选的文本编辑器中打开助手配置文件。
将 mmsConfigBackup 设置更改为配置备份文件的新路径。
```
mmsConfigBackup=/<newPath>/mms-cluster-config-backup.json
```
保存代理配置文件。
将配置备份文件移至新目录。
```
sudo mv /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json /<newPath>
```

为运行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

启动 MongoDB 助手。

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

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

验证 MongoDB Agent 是否正在运行。

在Install Agent Instructions模态中，等待每个部署在Install the MongoDB Agent步骤中显示Verified 。

重要

更新后，旧版助手中的所有凭证身份验证SCRAM、 LDAP和Kerberos档案都将保留。所有.pem密钥文件也将保留。

单击 Next（连接）。

完成 MongoDB 助手的安装。

在 Install Agent Instructions 模式中，单击 Done。

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

后续步骤

MongoDB Agent 更新完成后：

如果自动化以前没有托管您的监控和/或备份代理，请在 MongoDB 部署上激活备份和/或监控。
如果自动化之前确实托管您的监控和/或备份代理，它们现在已被激活。要验证它们是否已激活，请单击Deployment Servers 。
如果要激活自动化，请将部署添加到 MongoDB 项目。
停止并删除旧版监控代理。
停止并删除旧版备份代理。

后退

旧版监控代理

来年

托管和非托管代理