Docs 菜单
Docs 主页
/
MongoDB Ops Manager
/ /

从旧版监控代理进行更新

您有一个项目,其中包含受监控的 MongoDB 部署,但自动化并未托管,并且您希望更新到 MongoDB Agent。

注意

首先查看先决条件

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

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

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择 Windows - MSI。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

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

  • Base URL

    绑定到项目时必填。

  • Project ID (绑定到项目时必填)

  • API Key

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

警告

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

6
  1. 下载 MSI后,双击:

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

    注意

    在文件名中使用mongodb-mms-automation是一个传统项目,并不意味着在安装 MongoDB 助手时配置了自动化。

  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 密钥。

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

Install Agent Instructions 模式中,单击 Done

8

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

重要

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

单击 Next(连接)。

9

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

注意

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

get-childitem env:SystemDrive

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

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

  1. 依次单击 DeploymentAgentsDownloads & Settings

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

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

  4. 单击 Save(连接)。

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

    md \<newPath>

    重要

    确保运行 MongoDB Agent 的系统用户可以写入这个新目录。这通常是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>
10

使用此程序更新到 MongoDB Agent:

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

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择Debian 9 、 Ubuntu 16 .X/ 18 .X - DEB。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

从这一步开始,遵循 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

6

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

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

更新以下配置选项:

ProjectID (您的项目)。
项目的Agent API密钥
Ops Manager 应用程序的 URL(主机名和端口)。

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

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

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

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

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

添加以下配置键:

代理服务器的 URL(主机名和端口)。
8

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

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

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

发出以下命令:

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

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

重要

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

单击 Next(连接)。

11

Install Agent Instructions 模式中,单击 Done

12

在使用deb包运行Ubuntu 18 .x 的 zSeries 架构上:

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择Ubuntu 18 .X Z-Series (s 390 x) - DEB。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

从这一步开始,遵循 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

注意

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

6

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

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

更新以下配置选项:

ProjectID (您的项目)。
项目的Agent API密钥
Ops Manager 应用程序的 URL(主机名和端口)。

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

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

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

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

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

添加以下配置键:

代理服务器的 URL(主机名和端口)。
8

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

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

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

发出以下命令:

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

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

重要

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

单击 Next(连接)。

11

Install Agent Instructions 模式中,单击 Done

12

使用此程序更新到 MongoDB Agent:

在 x 86 _ 64架构上:

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

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择Amazon Linux - RPM。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

从这一步开始,遵循 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

注意

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

6

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

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

更新以下配置选项:

ProjectID (您的项目)。
项目的Agent API密钥
Ops Manager 应用程序的 URL(主机名和端口)。

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

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

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

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

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

添加以下配置键:

代理服务器的 URL(主机名和端口)。
8

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

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

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

发出以下命令:

sudo service mongodb-mms-automation-agent start
10

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

重要

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

单击 Next(连接)。

11

Install Agent Instructions 模式中,单击 Done

12

正在运行 RHEL( 7 .x、 8 .x 或9 .x)或CentOS ( 7 .x 或8 .x), SUSE12 、 SUSE15或Amazon Linux 2 :

使用rpm包:

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux2 - RPM。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

从这一步开始,遵循 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

6

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

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

更新以下配置选项:

ProjectID (您的项目)。
项目的Agent API密钥
Ops Manager 应用程序的 URL(主机名和端口)。

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

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

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

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

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

添加以下配置键:

代理服务器的 URL(主机名和端口)。
8

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

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

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

发出以下命令:

sudo service mongodb-mms-automation-agent start
10

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

重要

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

单击 Next(连接)。

11

Install Agent Instructions 模式中,单击 Done

12

使用tar存档:

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux 2 - TAR。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

从这一步开始,按照MongoDB Agent安装模式,将提供的命令复制到 .

从将运行 的托管上的系统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

注意

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

6

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

要安装MongoDB Agent ,请提取存档:

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

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

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

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

vi <install-path>/local.config

更新以下配置选项:

ProjectID (您的项目)。
项目的Agent API密钥
Ops Manager 应用程序的 URL(主机名和端口)。

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

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

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

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

vi <install-path>/local.config

添加以下配置键:

代理服务器的 URL(主机名和端口)。
10

如果您已有“监控代理”用户且不打算激活“自动化”,则只需创建日志目录。

创建以下目录来存储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. 依次单击 DeploymentAgentsDownloads & 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>
11

运行以下命令:

# 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
12

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

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

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

重要

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

单击 Next(连接)。

14

Install Agent Instructions 模式中,单击 Done

15

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

使用rpm包:

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择 RHEL/ CentOS ( 7 .X)、 SUSE12 、 Amazon Linux2 - RPM。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

从这一步开始,遵循 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

注意

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

6

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

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

更新以下配置选项:

ProjectID (您的项目)。
项目的Agent API密钥
Ops Manager 应用程序的 URL(主机名和端口)。

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

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

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

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

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

添加以下配置键:

代理服务器的 URL(主机名和端口)。
8

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

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

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

发出以下命令:

sudo service mongodb-mms-automation-agent start
10

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

重要

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

单击 Next(连接)。

11

Install Agent Instructions 模式中,单击 Done

12

使用tar存档:

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择 RHEL/ CentOS ( 7 .X) Power (ppc 64 le) - TAR。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

从这一步开始,遵循 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

注意

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

6

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

要安装MongoDB Agent ,请提取存档:

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

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

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

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

vi <install-path>/local.config

更新以下配置选项:

ProjectID (您的项目)。
项目的Agent API密钥
Ops Manager 应用程序的 URL(主机名和端口)。

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

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

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

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

vi <install-path>/local.config

添加以下配置键:

代理服务器的 URL(主机名和端口)。
10

如果您已有“监控代理”用户且不打算激活“自动化”,则只需创建日志目录。

创建以下目录来存储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. 依次单击 DeploymentAgentsDownloads & 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>
11

运行以下命令:

# 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
12

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

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

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

重要

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

单击 Next(连接)。

14

Install Agent Instructions 模式中,单击 Done

15

在 zSeries 架构上(管理MongoDB 4.4或更高版本的部署):

正在运行 RHEL( 7 .x、 8 .x 或9 .x)或使用rpm包管理器的CentOS ( 7 .x 或8 .x):

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择 RHEL 7 .X/ 8 X Z-Series (s 390 x) - RPM。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

从这一步开始,遵循 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

6

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

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

更新以下配置选项:

ProjectID (您的项目)。
项目的Agent API密钥
Ops Manager 应用程序的 URL(主机名和端口)。

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

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

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

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

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

添加以下配置键:

代理服务器的 URL(主机名和端口)。
8

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

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

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

发出以下命令:

sudo service mongodb-mms-automation-agent start
10

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

重要

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

单击 Next(连接)。

11

Install Agent Instructions 模式中,单击 Done

12

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

1
2

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

3

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

要为监控代理添加选项,请在Monitoring Configurations部分下:

  1. Setting框中键入所需的设置,并在Value框中键入相应的值。

  2. 要添加多个Setting ,请单击+ Add Setting链接。 出现另一行。

  3. 重复此操作,直到添加所有设置。

  4. 添加部署所需的所有设置后,单击Next

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

重要

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

4
  1. 单击View Agent Install InstructionsInstall Agent Instructions模式窗口打开。

  2. Select Your Server's Operating System菜单中,选择其他Linux - TAR。

  3. 单击NextInstall New MongoDB Agent模式窗口打开。

5

从这一步开始,遵循 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

注意

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

6

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

要安装MongoDB Agent ,请提取存档:

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

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

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

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

vi <install-path>/local.config

更新以下配置选项:

ProjectID (您的项目)。
项目的Agent API密钥
Ops Manager 应用程序的 URL(主机名和端口)。

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

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

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

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

vi <install-path>/local.config

添加以下配置键:

代理服务器的 URL(主机名和端口)。
10

如果您已有“监控代理”用户且不打算激活“自动化”,则只需创建日志目录。

创建以下目录来存储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. 依次单击 DeploymentAgentsDownloads & 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>
11

运行以下命令:

# 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
12

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

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

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

重要

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

单击 Next(连接)。

14

Final Steps模式下,旧版备份和监控代理将进入备用模式。 单击Finish

15

MongoDB Agent 更新完成后:

  • 如果自动化之前未托管您的监控代理,请在 MongoDB 部署上激活备份和/或监控

  • 如果自动化之前确实托管了您的监控代理,现在它已被激活。要验证自动化是否已激活,请单击Deployment Servers

  • 如果要激活自动化,请将部署添加到 MongoDB 项目。

  • 停止删除旧版监控代理。

  • 停止删除旧版备份代理。

后退

所有旧版助手