安装 MongoDB 助手来管理部署
您有一个项目,想要安装 MongoDB 助手来管理 MongoDB 部署。您还可以按照此工作流监控和备份 MongoDB 部署。
使用以下步骤在运行 Microsoft Windows 的 x86_64 架构上安装 MongoDB 助手:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从 Install Agent 菜单中,单击 Windows - MSI。
下载 MongoDB 助手。
MongoDB Agent Installation Instructions 框会显示以下信息:
Base URL
绑定到项目时必填。
Project ID (绑定到项目时必填)
API Key
如果没有 API 密钥,请单击生成密钥。
后续步骤需要用到其中部分或全部值。复制这些值,然后将它们存储在便于稍后访问的位置。
安装 MongoDB 助手。
下载
MSI
后,双击:mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi
如果出现安全警告,请单击 Run。
在 Configuration/Log Folder 步骤
提供保存这些文件的目录。
在Key Type步骤中,选择Agent API Key以绑定到特定的项目。
输入相应的代理密钥。
注意
上一步描述的 MongoDB Agent Installation Instructions 模态中提供了这些密钥。
在 Base URL 字段中输入您的
Base URL
。在 Project ID 字段中输入您的项目 ID。
在 Agent API Key 字段中键入您的代理 API 密钥。
在 Agent API Key 字段中键入您的代理 API 密钥。
在 MongoDB Paths 步骤中,指定日志和备份目录
在 Windows Firewall Configuration 步骤中,单击首选防火墙配置。
如果单击Configure firewall rules allowing access from only the specified |ipaddr| addresses. ,请在提供的框中键入必要的 IPv 4地址。
(有条件)Windows 启用 隐身模式 默认用于 Windows 防火墙。如果您尚未在安装 MongoDB 助手的 MongoDB 主机上禁用此功能,系统会要求您禁用此功能。隐身模式会显着降低 MongoDB 助手的性能和功能。单击Disable Stealth Mode 。
(有条件)Windows 未启用 磁盘性能计数器 默认情况下。如果您尚未为 MongoDB 主机启用磁盘性能计数器,请单击 。Enable Disk Performance Counters MongoDB 助手使用这些计数器进行某些硬件监控活动。
单击 Install(连接)。
设置完成后,请单击 Finish。
下载MSI
后,您可以运行无人值守安装。 可以在命令解释器或 PowerShell 中从命令行运行无人值守安装。 要了解有关无人值守安装的更多信息,请参阅有关 标准安装程序命令行选项 的 Microsoft 文档
要在无人值守的情况下从命令行运行MSI
安装程序,请使用/q
和/i
标志以及必需和可选参数的组合来调用msiexec.exe
:
Parameter | 必要性 | 值 |
---|---|---|
MMSAPIKEY | 必需 | Ops Manager 项目的代理API密钥。 |
MMSBASEURL | 必需 | Ops Manager 主机的URL 。 |
MMSGROUPID | 必需 | MongoDB Ops Manager项目的唯一标识符。 |
CONFIGLOGDIR | Optional | MongoDB Ops Manager应将MongoDB Agent配置文件写入到的绝对文件路径。 |
LOGFILE | Optional | MongoDB Ops Manager应将MongoDB Agent日志写入到的绝对文件路径 |
MMSCONFIGBACKUP | Optional | 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 助手二进制文件和配置备份文件的位置。
默认情况下,MongoDB 二进制文件和 Ops Manager 配置备份文件位于 %SystemDrive%\MMSMongoDB\versions
。
注意
Windows 将%SystemDrive%
环境变量设置为安装 Windows 的驱动器。默认情况下,系统会引导您在 驱动器上安装 Windows。要查找C:
%SystemDrive%
,请从 PowerShell 发出以下命令:
get-childitem env:SystemDrive
如果要将这些文件存储在不同的目录中,请按照以下步骤操作:
更改 MongoDB 助手二进制文件的位置
依次单击 Deployment、Agents 和 Downloads & Settings。
在 Download Directory 标题下方,单击 Download Directory (Windows) 中所示路径右侧的 。
将路径更改为所需的新路径。
单击 Save(连接)。
在运行 MongoDB 助手的每台主机上创建您指定的新目录。使用 Windows 资源管理器移动文件,或从命令提示符或 PowerShell 发出以下命令:
md \<newPath> 重要
确保运行 MongoDB 助手的系统用户可以写入这个新目录。这通常是
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 助手:
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
在运行 Debian 8/9/10/11 或 Ubuntu 18.04/20.04/22.04 的 x86_64 架构上:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从 Install Agent 菜单中,单击 Debian 8/9、Ubuntu 16.X/18.X - DEB。
下载最新版本的 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>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
使用此步骤安装 MongoDB 助手:
在 x 86 _ 64架构上:
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
使用rpm
包运行 Amazon Linux:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 Amazon Linux - RPM。
下载最新版本的 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>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
运行 RHEL( 7 .x、 8 .x 或9 .x)或 CentOS( 7 .x 或8 .x)、SUSE 12 、SUSE 15或 Amazon Linux 2 :
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
使用rpm
包:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 7 .X)、SUSE 12 、Amazon Linux 2 - RPM。
下载最新版本的 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>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
使用tar
存档:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 7 .X)、SUSE 12 、Amazon Linux 2 - TAR。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载适用于64位 x 86的 RHEL 安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_x86_64.tar.gz
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 local.config 文件:
vi <install-path>/local.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 local.config 文件的最终更改应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
可选:创建二进制目录、日志目录和数据目录。
创建以下目录来存储 MongoDB Agent 所需的文件。
注意
在文件路径中使用mongodb-mms-automation
是一项旧版项目,并不MEAN着在安装 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
默认情况下,代理二进制文件和 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 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
在 PowerPC 架构上的 RHEL/CentOS ( 7 .x) 上(管理 MongoDB 3 。 4或更高版本的部署):
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
使用rpm
包:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 7 .X) Power (ppc 64 le) - RPM。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载 RHEL 7 for PowerPC 的安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc64le.rhel<version>.rpm
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
使用tar
存档:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 7 .X) Power (ppc 64 le) - TAR。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载 RHEL 7 for PowerPC 的安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_ppc64le.tar.gz
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 local.config 文件:
vi <install-path>/local.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 local.config 文件的最终更改应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
可选:创建二进制目录、日志目录和数据目录。
创建以下目录来存储 MongoDB Agent 所需的文件。
注意
在文件路径中使用mongodb-mms-automation
是一项旧版项目,并不MEAN着在安装 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
默认情况下,代理二进制文件和 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 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
在 zSeries 架构上(管理 MongoDB 4 . 0或更高版本的部署):
使用rpm
软件包管理器运行 RHEL( 7 .x、 8 .x 或9 .x)或 CentOS( 7 .x 或8 .x):
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL 7 .X/ 8 X Z-Series (s 390 x) - RPM。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载 RHEL 7 .X/ 8 .X for IBM zSeries 的安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.rhel<version>.rpm
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
在运行 RHEL( 8 .x 或9 .x)或 Amazon Linux 2的 ARM 64架构上:
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
使用 rpm 软件包管理器运行 RHEL( 8 .x 或9 .x)或 Amazon Linux 2 :
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
从 Build New Deployment 菜单中选择要添加的部署类型:
如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机,您会在 Create New Deployment 页面顶部看到一条横幅。
单击 see instructions(管理员)链接。
从Select Your Server's Operating System菜单中,单击 RHEL/CentOS ( 8 .X/ 9 .X)、Amazon Linux 2 、Amazon Linux 2023 - RPM (ARM)。
单击 Next(连接)。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 8 .X/ 9 .X)、Amazon Linux 2 、Amazon Linux 2023 - RPM (ARM)。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载适用于 ARM 64的 RHEL( 8 .x 或9 .x)或 Amazon Linux 2的安装程序。 :
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.rpm
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
使用tar
存档:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
从 Build New Deployment 菜单中选择要添加的部署类型:
如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机,您会在 Create New Deployment 页面顶部看到一条横幅。
单击 see instructions(管理员)链接。
从Select Your Server's Operating System菜单中,单击 RHEL/CentOS ( 8 .X/ 9 .X)、Amazon Linux 2 、Amazon Linux 2023 - TAR (ARM)。
单击 Next(连接)。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 8 .X/ 9 .X)、Amazon Linux 2 、Amazon Linux 2023 - TAR (ARM)。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载适用于 ARM 64的 RHEL( 8 .x 或9 .x)或 Amazon Linux 2的安装程序。 :
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.amzn2_aarch64.tar.gz
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 local.config 文件:
vi <install-path>/local.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 local.config 文件的最终更改应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
可选:创建二进制目录、日志目录和数据目录。
创建以下目录来存储 MongoDB Agent 所需的文件。
注意
在文件路径中使用mongodb-mms-automation
是一项旧版项目,并不MEAN着在安装 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
默认情况下,代理二进制文件和 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 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
使用此过程可安装不使用deb
或rpm
软件包的 Linux 系统。
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击“Other Linux - TAR”(其他 Linux - TAR)。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载通用64位 Linux 的安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 local.config 文件:
vi <install-path>/local.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 local.config 文件的最终更改应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
可选:创建二进制目录、日志目录和数据目录。
创建以下目录来存储 MongoDB Agent 所需的文件。
注意
在文件路径中使用mongodb-mms-automation
是一项旧版项目,并不MEAN着在安装 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
默认情况下,代理二进制文件和 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
使用以下步骤在运行 Microsoft Windows 的 x86_64 架构上安装 MongoDB 助手:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从 Install Agent 菜单中,单击 Windows - MSI。
下载 MongoDB 助手。
MongoDB Agent Installation Instructions 框会显示以下信息:
Base URL
绑定到项目时必填。
Project ID (绑定到项目时必填)
API Key
如果没有 API 密钥,请单击生成密钥。
后续步骤需要用到其中部分或全部值。复制这些值,然后将它们存储在便于稍后访问的位置。
安装 MongoDB 助手。
下载
MSI
后,双击:mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi
如果出现安全警告,请单击 Run。
在 Configuration/Log Folder 步骤
提供保存这些文件的目录。
在Key Type步骤中,选择Agent API Key以绑定到特定项目。
输入相应的代理密钥。
注意
上一步描述的 MongoDB Agent Installation Instructions 模态中提供了这些密钥。
在 Base URL 字段中输入您的
Base URL
。在 Project ID 字段中输入您的项目 ID。
在 Agent API Key 字段中键入您的代理 API 密钥。
在 Agent API Key 字段中键入您的代理 API 密钥。
在 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 助手使用这些计数器进行某些硬件监控活动。
单击 Install(连接)。
设置完成后,请单击 Finish。
下载MSI
后,您可以运行无人值守安装。 可以在命令解释器或 PowerShell 中从命令行运行无人值守安装。 要了解有关无人值守安装的更多信息,请参阅有关 标准安装程序命令行选项 的 Microsoft 文档
要在无人值守的情况下从命令行运行MSI
安装程序,请使用/q
和/i
标志以及必需和可选参数的组合来调用msiexec.exe
:
Parameter | 必要性 | 值 |
---|---|---|
MMSAPIKEY | 必需 | Ops Manager 项目的代理API密钥。 |
MMSBASEURL | 必需 | Ops Manager 主机的URL 。 |
MMSGROUPID | 必需 | MongoDB Ops Manager项目的唯一标识符。 |
CONFIGLOGDIR | Optional | MongoDB Ops Manager应将MongoDB Agent配置文件写入到的绝对文件路径。 |
LOGFILE | Optional | MongoDB Ops Manager应将MongoDB Agent日志写入到的绝对文件路径 |
MMSCONFIGBACKUP | Optional | 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 助手二进制文件和配置备份文件的位置。
默认情况下,MongoDB 二进制文件和 Ops Manager 配置备份文件位于 %SystemDrive%\MMSMongoDB\versions
。
注意
Windows 将%SystemDrive%
环境变量设置为安装 Windows 的驱动器。默认情况下,系统会引导您在 驱动器上安装 Windows。要查找C:
%SystemDrive%
,请从 PowerShell 发出以下命令:
get-childitem env:SystemDrive
如果要将这些文件存储在不同的目录中,请按照以下步骤操作:
更改 MongoDB 助手二进制文件的位置
依次单击 Deployment、Agents 和 Downloads & Settings。
在 Download Directory 标题下方,单击 Download Directory (Windows) 中所示路径右侧的 。
将路径更改为所需的新路径。
单击 Save(连接)。
在运行 MongoDB 助手的每台主机上创建您指定的新目录。使用 Windows 资源管理器移动文件,或从命令提示符或 PowerShell 发出以下命令:
md \<newPath> 重要
确保运行 MongoDB 助手的系统用户可以写入这个新目录。这通常是
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 助手:
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
在运行 Debian 8/9/10/11 或 Ubuntu 18.04/20.04/22.04 的 x86_64 架构上:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从 Install Agent 菜单中,单击 Debian 8/9、Ubuntu 16.X/18.X - DEB。
下载最新版本的 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>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
使用此步骤安装 MongoDB 助手:
在 x 86 _ 64架构上:
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
使用rpm
包运行 Amazon Linux:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 Amazon Linux - RPM。
下载最新版本的 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>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
运行 RHEL( 7 .x、 8 .x 或9 .x)或 CentOS( 7 .x 或8 .x)、SUSE 12 、SUSE 15或 Amazon Linux 2 :
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
使用rpm
包:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 7 .X)、SUSE 12 、Amazon Linux 2 - RPM。
下载最新版本的 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>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
使用tar
存档:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 7 .X)、SUSE 12 、Amazon Linux 2 - TAR。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载适用于64位 x 86的 RHEL 安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_x86_64.tar.gz
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 local.config 文件:
vi <install-path>/local.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 local.config 文件的最终更改应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
可选:创建二进制目录、日志目录和数据目录。
创建以下目录来存储 MongoDB Agent 所需的文件。
注意
在文件路径中使用mongodb-mms-automation
是一项旧版项目,并不MEAN着在安装 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
默认情况下,代理二进制文件和 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 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
在 PowerPC 架构上的 RHEL/CentOS ( 7 .x) 上(管理 MongoDB 3 。 4或更高版本的部署):
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
使用rpm
包:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 7 .X) Power (ppc 64 le) - RPM。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载 RHEL 7 for PowerPC 的安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc64le.rhel<version>.rpm
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
使用tar
存档:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 7 .X) Power (ppc 64 le) - TAR。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载 RHEL 7 for PowerPC 的安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.rhel7_ppc64le.tar.gz
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 local.config 文件:
vi <install-path>/local.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 local.config 文件的最终更改应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
可选:创建二进制目录、日志目录和数据目录。
创建以下目录来存储 MongoDB Agent 所需的文件。
注意
在文件路径中使用mongodb-mms-automation
是一项旧版项目,并不MEAN着在安装 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
默认情况下,代理二进制文件和 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 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
在 zSeries 架构上(管理 MongoDB 4 . 0或更高版本的部署):
使用rpm
软件包管理器运行 RHEL( 7 .x、 8 .x 或9 .x)或 CentOS( 7 .x 或8 .x):
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL 7 .X/ 8 X Z-Series (s 390 x) - RPM。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载 RHEL 7 .X/ 8 .X for IBM zSeries 的安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.rhel<version>.rpm
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
在运行 RHEL( 8 .x 或9 .x)或 Amazon Linux 2的 ARM 64架构上:
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
使用 rpm 软件包管理器运行 RHEL( 8 .x 或9 .x)或 Amazon Linux 2 :
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
从 Build New Deployment 菜单中选择要添加的部署类型:
如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机,您会在 Create New Deployment 页面顶部看到一条横幅。
单击 see instructions(管理员)链接。
从Select Your Server's Operating System菜单中,单击 RHEL/CentOS ( 8 .X/ 9 .X)、Amazon Linux 2 、Amazon Linux 2023 - RPM (ARM)。
单击 Next(连接)。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 8 .X/ 9 .X)、Amazon Linux 2 、Amazon Linux 2023 - RPM (ARM)。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载适用于 ARM 64的 RHEL( 8 .x 或9 .x)或 Amazon Linux 2的安装程序。 :
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.aarch64.amzn2.rpm
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 automation-agent.config 文件:
sudo vi /etc/mongodb-mms/automation-agent.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 automation-agent.config 文件的修改结果应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
使用tar
存档:
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
从 Build New Deployment 菜单中选择要添加的部署类型:
如果 Ops Manager 在 Create New Deployment 页面上无法检测到任何已安装 MongoDB 助手的主机,您会在 Create New Deployment 页面顶部看到一条横幅。
单击 see instructions(管理员)链接。
从Select Your Server's Operating System菜单中,单击 RHEL/CentOS ( 8 .X/ 9 .X)、Amazon Linux 2 、Amazon Linux 2023 - TAR (ARM)。
单击 Next(连接)。
单击托管现有部署。
从Install Agent菜单中,单击 RHEL/CentOS ( 8 .X/ 9 .X)、Amazon Linux 2 、Amazon Linux 2023 - TAR (ARM)。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载适用于 ARM 64的 RHEL( 8 .x 或9 .x)或 Amazon Linux 2的安装程序。 :
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.amzn2_aarch64.tar.gz
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 local.config 文件:
vi <install-path>/local.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 local.config 文件的最终更改应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
可选:创建二进制目录、日志目录和数据目录。
创建以下目录来存储 MongoDB Agent 所需的文件。
注意
在文件路径中使用mongodb-mms-automation
是一项旧版项目,并不MEAN着在安装 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
默认情况下,代理二进制文件和 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 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
使用此过程可安装不使用deb
或rpm
软件包的 Linux 系统。
开始或管理部署。
如果您的项目没有任何部署,您会看到开始提示。
单击托管现有部署。
从Install Agent菜单中,单击“Other Linux - TAR”(其他 Linux - TAR)。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载通用64位 Linux 的安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz
注意
将<OpsManagerHost>:<Port>
替换为 Ops Manager 应用程序的主机名和端口。如果存在,则将<version>
替换为操作系统的主要版本。例如,对于 RHEL 7 .x,将<version>
替换为7
。
编辑 MongoDB 助手配置文件。
在安装 MongoDB 助手的目录中,使用首选文本编辑器打开 local.config 文件:
vi <install-path>/local.config
更新以下配置选项:
键 | 值 |
---|---|
ProjectID (您的项目)。 | |
项目的代理 API 密钥。 | |
Ops Manager 应用程序的 URL(主机名和端口)。 |
对 local.config 文件的最终更改应如下所示:
mmsGroupId=<Project ID> mmsApiKey=<agent API key> mmsBaseUrl=<application URL>
可选:创建二进制目录、日志目录和数据目录。
创建以下目录来存储 MongoDB Agent 所需的文件。
注意
在文件路径中使用mongodb-mms-automation
是一项旧版项目,并不MEAN着在安装 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
默认情况下,代理二进制文件和 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