Docs Menu
Docs Home
/
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)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. Select Your Server's Operating Systemメニューから Windows - MSI を選択します。

  3. [ Nextをクリックします。 [ Install 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 Agent がオートメーション構成された状態でインストールされていることを意味するものではありません。

  2. セキュリティ警告が表示された場合は、 Runをクリックします。

  3. Configuration/Log Folder手順で、 MSIファイルが保存されているディレクトリを入力します。

  4. Key Typeステップで、特定のプロジェクトにバインドするためのAgent API Keyを選択します。

  5. 適切なエージェント キーを入力します。

    注意

    これらのキーは、前のステップで説明したMongoDB Agent Installation Instructionsモーダルで提供されます。

    Agent API Keyを選択した場合は、次の内容を入力します。

    • Base URL

    • Project ID

    • Agent API Key

  6. MongoDB Pathsステップで、ログとバックアップ ディレクトリを指定します。

  7. Windows Firewall Configurationステップで、ご希望のファイアウォール構成を選択します。

    Configure firewall rules allowing access from only the specified |ipaddr| addresses.を選択した場合は、必要な IPv 4アドレスを表示されたボックスに入力します。

  8. (条件付き)Windows では スループット モード が有効化 デフォルトで Windows ファイアウォール 用。MongoDB Agent をインストールしている MongoDB ホストでこれを無効にしていない場合は、ここで無効にします。 ステイルス モードでは、MongoDB Agent のパフォーマンスと機能が大幅に低下します。 [ Disable Stealth Modeをクリックします。

  9. (条件付き)Windows では ディスク パフォーマンス カウンター は有効になりません デフォルトでは。MongoDB ホストでディスク パフォーマンス カウンターを有効にしていない場合は、 Enable Disk Performance Countersをクリックします。 MongoDB Agent は、ハードウェア モニタリング アクティビティの一部にこれらのカウンターを使用します。

  10. [Install] をクリックします。

  11. 設定が完了したら、 Finishをクリックします。

MSIをダウンロードしたら、自動インストールを実行できます。 コマンドプロンプトまたは PowerShell で、コマンドラインから自動インストールを実行します。 自動インストールの詳細については、 標準インストーラーのコマンドライン オプション に関する Microsoft のドキュメントを参照してください。

MSIコマンドラインから自動でmsiexec.exe インストーラーを実行するには、/q /iフラグと フラグ、および必須パラメータと任意パラメータの組み合わせを使用して を呼び出します。

Parameter
必要性
MMSAPIKEY
必須
APIMongoDB Ops Managerプロジェクトのエージェント キー。
MMSBASEURL
必須
MongoDB Ops Manager ホストのURL
MMSGROUPID
必須
MongoDB Ops Managerプロジェクトの一意の識別子。
CONFIGLOGDIR
任意
MongoDB Ops ManagerがMongoDB Agent構成ファイルを書き込む絶対ファイル パス。
LOGFILE
任意
MongoDB Ops ManagerがMongoDB Agentログを書き込む絶対ファイル パス
MMSCONFIGBACKUP
任意
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バイナリとMongoDB Ops Managerの構成バックアップ ファイルを %SystemDrive%\MMSMongoDB\versions のデフォルトのロケーション以外に配置する必要がある場合があります。

注意

Windows は、 %SystemDrive%環境変数を Windows をインストールしたドライブに設定します。 デフォルトでは、 C:ドライブに Windows をインストールするように指示されます。 %SystemDrive%を見つけるには、 PowerShell から次のコマンドを実行します。

get-childitem env:SystemDrive

これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。

MongoDB Agent バイナリの場所を変更するには

  1. [ Deploymentをクリックし、次にAgentsをクリックし、次にDownloads & Settingsをクリックします。

  2. Download Directory見出しの下にある [] をクリックします。Download Directory (Windows)に表示されているパスの右側にある)。

  3. パスを必要な新しいパスに変更します。

  4. [Save] をクリックします。

  5. MongoDB Agent を実行する各ホストに、指定した新しいディレクトリを作成します。 Windows Explorer を使用してファイルを移動するか、コマンドプロンプトまたは PowerShell から次のコマンドを実行します。

    md \<newPath>

    重要

    MongoDB Agent を実行するシステムユーザーがこの新しいディレクトリに書込みできることを確認します。 これは通常、 SYSTEMユーザーであり、ユーザーを変更した場合を除き、追加の構成は必要ありません。

MongoDB Agent の構成バックアップの場所を変更するには

  1. 希望のテキストエディタでMongoDB Agent の構成ファイルを開きます。

  2. mmsConfigBackup設定を構成バックアップ ファイルの新しいパスに変更します。 次の例のXを、バックアップが保存されているドライブ文字に置き換えます。

    mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json
  3. MongoDB Agent の構成ファイルを保存します。

  4. 構成バックアップ ファイルを新しいディレクトリに移動します。 Windows Explorer を使用してファイルを移動するか、コマンドプロンプトまたは PowerShell から次のコマンドを実行します。

    move %SystemDrive%\MMSMongoDB\versions\mms-cluster-config-backup.json \<newPath>
10

MongoDB Agent に更新するには、次の手順に従います。

Debian 9 、 Ubuntu 18.04を実行中x 86 _ 64アーキテクチャでは、 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)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. [ Select Your Server's Operating Systemメニューから、 Debian 9 、 Ubuntu 16 .X/ 18 .X - DEB を選択します。

  3. [ Nextをクリックします。 [ Install New MongoDB Agentモーダルが開きます。

5

この手順から、MongoDB Agent のインストール モーダルに従って、提供されたコマンドを Linux shell にコピーします。

MongoDB Agent を実行するホスト上のシステム 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 Agent をインストールしたディレクトリ内で、希望のテキストエディターで automation-agent.config ファイルを開きます。

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

次の構成オプションを更新します。

キー
ProjectID プロジェクトの
プロジェクトのエージェント API キー
URLMongoDB Ops ManagerApplication の (ホスト名とポート)。

オートメーションエージェント.configファイルに対する結果としての変更は、次のようになります。

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

プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy環境変数でサーバーを指定する必要があります。

MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで 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.04を実行している zSeries アーキテクチャでは、次のようになります。

1
2

更新プロセスを開始するには、 Update to MongoDB Agentページが開きます。 Introducing the MongoDB Agentステップが表示されます。 この手順を読み終えたら、 Next ] をクリックします。

3

オートメーションがバックアップまたはモニタリングエージェントを管理しなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. Select Your Server's Operating Systemメニューから Ubuntu 18 .X Z シリーズ(s 390 x) - DEB を選択します。

  3. [ Nextをクリックします。 [ Install New MongoDB Agentモーダルが開きます。

5

この手順から、MongoDB Agent のインストール モーダルに従って、提供されたコマンドを Linux shell にコピーします。

MongoDB Agent を実行するホスト上のシステム shell から、次のcurlコマンドを実行して、 IBM Z Series 用の Ubuntu 18.04のインストーラーをダウンロードします。

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 Agent をインストールしたディレクトリ内で、希望のテキストエディターで automation-agent.config ファイルを開きます。

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

次の構成オプションを更新します。

キー
ProjectID プロジェクトの
プロジェクトのエージェント API キー
URLMongoDB Ops ManagerApplication の (ホスト名とポート)。

オートメーションエージェント.configファイルに対する結果としての変更は、次のようになります。

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

プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy環境変数でサーバーを指定する必要があります。

MongoDB Agent をインストールしたディレクトリで、テキスト エディターで local.config ファイルを開きます。

vi <install-path>/local.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)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. Select Your Server's Operating Systemメニューから Amazon Linux - RPM を選択します。

  3. [ Nextをクリックします。 [ Install New MongoDB Agentモーダルが開きます。

5

この手順から、MongoDB Agent のインストール モーダルに従って、提供されたコマンドを Linux shell にコピーします。

MongoDB Agent を実行するホスト上のシステム shell から、次のcurlコマンドを実行して、 64 -bit x 86用の RHEL 6のインストーラーをダウンロードします。

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 Agent をインストールしたディレクトリ内で、希望のテキストエディターで automation-agent.config ファイルを開きます。

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

次の構成オプションを更新します。

キー
ProjectID プロジェクトの
プロジェクトのエージェント API キー
URLMongoDB Ops ManagerApplication の (ホスト名とポート)。

オートメーションエージェント.configファイルに対する結果としての変更は、次のようになります。

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

プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy環境変数でサーバーを指定する必要があります。

MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで 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) SUSE 12 、 SUSE 15 、または 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)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. Select Your Server's Operating Systemメニューから、RHEL/CentOS( 7 .X)、SUSE 12 、Amazon Linux 2 - RPM を選択します。

  3. [ Nextをクリックします。 [ Install New MongoDB Agentモーダルが開きます。

5

この手順から、MongoDB Agent のインストール モーダルに従って、提供されたコマンドを Linux shell にコピーします。

MongoDB Agent を実行するホスト上のシステム shell から、次のcurlコマンドを実行して、 64 -bit x 86用の RHEL 7のインストーラーをダウンロードします。

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 Agent をインストールしたディレクトリ内で、希望のテキストエディターで automation-agent.config ファイルを開きます。

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

次の構成オプションを更新します。

キー
ProjectID プロジェクトの
プロジェクトのエージェント API キー
URLMongoDB Ops ManagerApplication の (ホスト名とポート)。

オートメーションエージェント.configファイルに対する結果としての変更は、次のようになります。

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

プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy環境変数でサーバーを指定する必要があります。

MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで 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)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. Select Your Server's Operating Systemメニューから、RHEL/CentOS( 7 .X)、SUSE 12 、Amazon Linux 2 - TAR を選択します。

  3. [ Nextをクリックします。 [ Install New MongoDB Agentモーダルが開きます。

5

この手順から、MongoDB Agent のインストール モーダルに従って、提供されたコマンドを Linux shell にコピーします。

MongoDB Agent を実行するホスト上のシステム shell から、次のcurlコマンドを実行して、 64 -bit x 86の RHEL のインストーラーをダウンロードします。

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 プロジェクトの
プロジェクトのエージェント API キー
URLMongoDB Ops ManagerApplication の (ホスト名とポート)。

local.config ファイルへの変更は、次のようになります。

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

プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 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 Agent ログ
/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. [ Deploymentをクリックし、次にAgentsをクリックし、次に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>
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)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. Select Your Server's Operating Systemメニューから、RHEL/CentOS( 7 .X)、SUSE 12 、Amazon Linux 2 - RPM を選択します。

  3. [ Nextをクリックします。 [ Install New MongoDB Agentモーダルが開きます。

5

この手順から、MongoDB Agent のインストール モーダルに従って、提供されたコマンドを Linux shell にコピーします。

MongoDB Agent を実行するホスト上のシステム shell から、次のcurlコマンドを実行して、PowerPC 用の RHEL 7のインストーラーをダウンロードします。

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 Agent をインストールしたディレクトリ内で、希望のテキストエディターで automation-agent.config ファイルを開きます。

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

次の構成オプションを更新します。

キー
ProjectID プロジェクトの
プロジェクトのエージェント API キー
URLMongoDB Ops ManagerApplication の (ホスト名とポート)。

オートメーションエージェント.configファイルに対する結果としての変更は、次のようになります。

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

プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy環境変数でサーバーを指定する必要があります。

MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで 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)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. Select Your Server's Operating Systemメニューから RHEL/CentOS( 7 .X)Power(ppc 64 le)- TAR を選択します。

  3. [ Nextをクリックします。 [ Install New MongoDB Agentモーダルが開きます。

5

この手順から、MongoDB Agent のインストール モーダルに従って、提供されたコマンドを Linux shell にコピーします。

MongoDB Agent を実行するホスト上のシステム shell から、次のcurlコマンドを実行して、PowerPC 用の RHEL 7のインストーラーをダウンロードします。

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 プロジェクトの
プロジェクトのエージェント API キー
URLMongoDB Ops ManagerApplication の (ホスト名とポート)。

local.config ファイルへの変更は、次のようになります。

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

プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 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 Agent ログ
/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. [ Deploymentをクリックし、次にAgentsをクリックし、次に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>
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

Z Series アーキテクチャ(MongoDB 3.4以降の配置の管理)の場合

RHEL の実行( 7 .x) 8 .x、または9 .x)または CentOS( 7 .x または8 .x)では、 rpmパッケージ マネージャーを使用します。

1
2

更新プロセスを開始するには、 Update to MongoDB Agentページが開きます。 Introducing the MongoDB Agentステップが表示されます。 この手順を読み終えたら、 Next ] をクリックします。

3

オートメーションがバックアップまたはモニタリングエージェントを管理しなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. Select Your Server's Operating Systemメニューから、[ RHEL 7 .X/ 8 X Z シリーズ(s 390 x)- RPM を選択します。

  3. [ Nextをクリックします。 [ Install New MongoDB Agentモーダルが開きます。

5

この手順から、MongoDB Agent のインストール モーダルに従って、提供されたコマンドを Linux shell にコピーします。

shellを実行するホスト上のシステムMongoDB Agent から、次のcurl コマンドを実行して、RHEL7 .X/8 .X のIBM をダウンロードします。

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 Agent をインストールしたディレクトリ内で、希望のテキストエディターで automation-agent.config ファイルを開きます。

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

次の構成オプションを更新します。

キー
ProjectID プロジェクトの
プロジェクトのエージェント API キー
URLMongoDB Ops ManagerApplication の (ホスト名とポート)。

オートメーションエージェント.configファイルに対する結果としての変更は、次のようになります。

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

プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy環境変数でサーバーを指定する必要があります。

MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで 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

この手順を使用して、 debまたはrpmパッケージを使用していない Linux システムに MongoDB Agent への更新をインストールします。

1
2

更新プロセスを開始するには、 Update to MongoDB Agentページが開きます。 Introducing the MongoDB Agentステップが表示されます。 この手順を読み終えたら、 Next ] をクリックします。

3

オートメーションがバックアップまたはモニタリングエージェントを管理しなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたバックアップまたはモニタリングの設定を追加できます。

重要

Kerberos 認証を使用する配置

レガシーエージェントの次の設定のいずれも追加しないでください。

  • krb5Principal

  • krb5Keytab

レガシーエージェントは個別のデータベースユーザーとして Kerberos で認証されていました。 MongoDB Agent はレガシーエージェントの機能を組み合わせているため、単一のデータベースユーザーを使用します。 MongoDB Agent にアップグレードして Kerberos を引き続き使用するには、次の手順を実行する必要があります。

  1. MongoDB Agent 用に新しいKerberos ユーザー プリンシパルデータベースユーザーを作成します。

  2. 新しい Principal MongoDB Ops ManagerAuthentication & TLSMongoDB Agentファイルとキータブ ファイルを使用して、 設定内の エージェント認証構成 を更新します。

MongoDB Agent に更新した後に、従来の監視エージェントとバックアップエージェント ユーザーを削除できます。

バックアップエージェントモニタリングエージェントにあったオプションを追加するには、次の手順に従います。

  1. Backup Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  2. Monitoring Configurationsセクションの下:

    1. Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。

    2. 複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。

    3. すべての設定が追加されるまで、繰り返します。

  3. 配置に必要な設定をすべて追加したら、[ Next ] をクリックします。

をクリックできます。追加した設定を削除します。

重要

MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。

4
  1. [ View Agent Install Instructionsをクリックします。 [ Install Agent Instructionsモーダルが開きます。

  2. Select Your Server's Operating Systemメニューから [ Other Linux - TAR ] を選択します。

  3. [ Nextをクリックします。 [ Install New MongoDB Agentモーダルが開きます。

5

この手順から、MongoDB Agent のインストール モーダルに従って、提供されたコマンドを Linux shell にコピーします。

MongoDB Agent を実行するホスト上のシステム 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>を 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 プロジェクトの
プロジェクトのエージェント API キー
URLMongoDB Ops ManagerApplication の (ホスト名とポート)。

local.config ファイルへの変更は、次のようになります。

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

プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 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 Agent ログ
/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. [ Deploymentをクリックし、次にAgentsをクリックし、次に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>
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

MongoDB Agent の更新が完了すると、次の状況が発生します。

  • オートメーションが以前にモニタリングエージェントやバックアップエージェントを管理していなかった場合は、MongoDB 配置でバックアップモニタリングをアクティブ化します。

  • オートメーションが以前にモニタリングエージェントやバックアップエージェントを管理していた場合、それらは有効化されるようになりました。 有効化されていることを確認するには、 Deploymentをクリックします。 Servers

  • オートメーションを有効にする場合は、MongoDB プロジェクトに配置を追加します。

  • レガシー モニタリングエージェントを停止して削除します。

  • 従来のバックアップ エージェントを停止して削除します。

戻る

レガシーモニタリングエージェント