Update from the legacy Backup and Monitoring Agents

登录 Cloud Manager。

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

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

Optional: Add any existing configuration options for your legacy Agents.

If Automation did not manage your Backup or Monitoring Agents, you can add any Backup or Monitoring settings you had before at the Add Custom Configuration Options for your MongoDB Agent (Optional) step.

To add options that you had for your 备份代理 and 监控代理:

1. Under the Backup Configurations section:

   1. Type the desired setting in the Setting box and its corresponding value in the Value box.

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

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

2. Under the Monitoring Configurations section:

   1. Type the desired setting in the Setting box and the corresponding value in the Value box.

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

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

3. 添加部署所需的所有设置后，单击Next 。

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

安装 MongoDB 助手。

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

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

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

下载最新版本的 MongoDB 助手。

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

curl -OL https://cloud.mongodb.com/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

更新以下配置选项：

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

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

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

vi <install-path>/local.config

添加以下配置键：

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

If you have existing Monitoring Agent and/or Backup Agent users and do not plan on activating Automation, you only need to create the log directory.

创建以下目录来存储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

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

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

1. 在MongoDB Cloud Manager中， Go项目的 Deployment 页面。

   1. 如果尚未显示，请从导航栏的 Organizations 菜单中选择包含所需项目的组织。

   2. 如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。

   3. 如果 Deployment（数据库部署）页面尚未出现，请单击侧边栏中的 Deployment（数据库）。

      显示“部署”页面。

2. 单击部署的Agents标签页。

   显示“代理”页面。

3. 更改路径。

   1. 单击 Downloads & Settings（连接）。

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

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

   4. 单击 Save（连接）。

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

      sudo mkdir -m 755 -p /<newPath>

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

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

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

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

3. 保存代理配置文件。

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

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

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

单击 Next（连接）。

完成 MongoDB 助手的安装。

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

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