安装 MongoDB 助手以仅监控或备份部署
您有一个项目,想要安装 MongoDB Agent 来监控和/或备份 MongoDB 部署。您选择此时不管理 MongoDB 部署。
使用以下步骤在运行 Microsoft Windows 的 x86_64 架构上安装 MongoDB 助手:
下载 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、Debian 9、Ubuntu 18.04、Ubuntu 20.04 或 Ubuntu 22.04 的 x86_64 架构上:
下载最新版本的 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>
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
在运行 Ubuntu 18的 zSeries 架构上。 04使用deb
包:
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载 Ubuntu 18的安装程序。 04 (适用于 IBM zSeries):
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.ubuntu1804.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:
下载最新版本的 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
包:
下载最新版本的 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
存档:
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载适用于64位 x 86的 RHEL 安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-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 。 6或更高版本的部署):
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
使用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.ppc641e.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
存档:
下载最新版本的 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.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):
重要
从版本11开始。 0 。 5 。 6967 - 1 ,当您使用deb
或rpm
包安装 MongoDB 助手时,该包不会将 MongoDB 二进制文件添加到PATH
环境变量中。
如果您的部署取决于 PATH
中是否存在 MongoDB 二进制文件,则必须手动将 MongoDB 二进制文件的路径添加到 PATH
中。要了解如何更新环境变量,请参阅操作系统文档。
下载最新版本的 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 :
下载最新版本的 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
存档运行 RHEL( 8 .x 或9 .x)或 Amazon Linux 2 :
下载最新版本的 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.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 系统。
下载最新版本的 MongoDB 助手。
从这一步开始,遵循 MongoDB 助手安装模式并将提供的命令复制到 Linux Shell 中。
从将运行 MongoDB 助手的主机上的系统 Shell 中,发出以下curl
命令以下载通用64位 Linux 的安装程序:
curl -OL https://<OpsManagerHost>:<Port>/download/agent/automation/mongodb-mms-automation-agent-manager-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