AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

レガシーバックアップエージェントとモニタリングエージェントからの更新

オートメーションによって管理またはバックアップされた MongoDB 配置を含むプロジェクトがあり、MongoDB Agent に更新したいと考えています。

注意

最初に前提条件を確認する

オートメーションを開始または引き続き使用して MongoDB 配置を管理する場合は、MongoDB Agent に更新する前に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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

Cloud 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 ] ボックスには次の情報が表示されます。

  • 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モーダルで提供されます。

    • Project IDボックスにプロジェクト ID を入力します。

    • [ Agent API Keyボックスにエージェント API キーを入力します。

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

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

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

  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

必須

Cloud Manager プロジェクトのエージェントAPIキー。

MMSGROUPID

必須

Cloud Manager プロジェクトの一意の識別子です。

CONFIGLOGDIR

任意

Cloud Manager が MongoDB Agent 構成ファイルを書き込む絶対ファイル パス。

LOGFILE

任意

Cloud Manager が MongoDB Agent ログを書き込む絶対ファイル パス

MMSCONFIGBACKUP

任意

Cloud 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

MongoDB Agent のインストールを完了します。 Install Agent Instructionsモーダルで、 Doneをクリックします。

8

Install Agent Instructionsモーダルで、各配置をInstall the MongoDB AgentステップにVerifiedが表示するまで待機します。

重要

レガシー エージェントからのすべての認証 SCRAM、 LDAP 、および Kerberos 認証情報は更新後も保持されます。 すべての.pemキー ファイルも保持されます。

[Next] をクリックします。

9

システム ポリシーやプラクティスによっては、MongoDB バイナリと Cloud Manager の構成バックアップ ファイルを%SystemDrive%\MMSMongoDB\versionsのデフォルトのロケーション以外に配置する必要がある場合があります。

注意

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

get-childitem env:SystemDrive

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

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

  1. MongoDB Cloud Managerで、プロジェクトの Agents ページにGoします。

    1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

    2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

    3. サイドバーで、 Database見出しの下のAgentsをクリックします。

    [エージェント ]ページが表示されます。

  2. [Downloads & Settings] タブをクリックします。

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

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

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

  6. 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 8、Debian 9、Ubuntu 18.04、Ubuntu 20.04、または Ubuntu 22.04 を実行している x86_64 アーキテクチャでは、次のようにします。

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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

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

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

  2. Select Your Server's Operating Systemメニューから、Debian 8/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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.amd64.ubuntu1604.deb
6

MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。

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

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

キー

ProjectID プロジェクトの

プロジェクトのエージェント API キー

7

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

MongoDB 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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

Cloud 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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.ubuntu1804.deb
6

MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。

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

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

キー

ProjectID プロジェクトの

プロジェクトのエージェント API キー

7

プロキシ サーバー経由で Cloud 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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

Cloud 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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rpm
6

MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。

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

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

キー

ProjectID プロジェクトの

プロジェクトのエージェント API キー

7

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

MongoDB 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 / CentOS 7 .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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

Cloud 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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rhel7.rpm
6

MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。

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

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

キー

ProjectID プロジェクトの

プロジェクトのエージェント API キー

7

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

MongoDB 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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

Cloud 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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.rhel7_x86_64.tar.gz
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 キー

9

プロキシ サーバー経由で Cloud 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

デフォルトでは、エージェント バイナリと Cloud Manager 構成バックアップ ファイルは/var/lib/mongodb-mms-automationに配置されています。 これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。

エージェント バイナリの場所を変更するには:

  1. MongoDB Cloud Managerで、プロジェクトの Agents ページにGoします。

    1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

    2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

    3. サイドバーで、 Database見出しの下のAgentsをクリックします。

    [エージェント ]ページが表示されます。

  2. パスを変更します。

    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>
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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

Cloud 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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.ppc641e.rhel7.rpm
6

MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。

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

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

キー

ProjectID プロジェクトの

プロジェクトのエージェント API キー

7

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

MongoDB 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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

Cloud 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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.rhel7_ppc64le.tar.gz
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 キー

9

プロキシ サーバー経由で Cloud 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

デフォルトでは、エージェント バイナリと Cloud Manager 構成バックアップ ファイルは/var/lib/mongodb-mms-automationに配置されています。 これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。

エージェント バイナリの場所を変更するには:

  1. MongoDB Cloud Managerで、プロジェクトの Agents ページにGoします。

    1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

    2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

    3. サイドバーで、 Database見出しの下のAgentsをクリックします。

    [エージェント ]ページが表示されます。

  2. パスを変更します。

    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>
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 / 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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

Cloud 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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.s390x.rhel7.rpm
6

MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。

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

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

キー

ProjectID プロジェクトの

プロジェクトのエージェント API キー

7

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

MongoDB 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. 新しい MongoDB Agent Principal ファイルと Keytab ファイルを使用して、Cloud Manager Authentication & TLS設定のエージェント認証構成を更新します。

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 ] をクリックします。

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

重要

Cloud 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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.linux_x86_64.tar.gz
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 キー

9

プロキシ サーバー経由で Cloud 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

デフォルトでは、エージェント バイナリと Cloud Manager 構成バックアップ ファイルは/var/lib/mongodb-mms-automationに配置されています。 これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。

エージェント バイナリの場所を変更するには:

  1. MongoDB Cloud Managerで、プロジェクトの Agents ページにGoします。

    1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

    2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

    3. サイドバーで、 Database見出しの下のAgentsをクリックします。

    [エージェント ]ページが表示されます。

  2. パスを変更します。

    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>
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 配置でバックアップまたはモニタリングをアクティブ化します。

  • オートメーションが以前にモニタリングエージェントまたはバックアップエージェントをマネージドしていた場合、それらは有効化されます。有効化されていることを確認するには、次の手順を実行します。

    1
    1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

    2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

    3. サイドバーで、 Database見出しの下のServersをクリックします。

    [ Servers ]ページが表示されます。

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

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

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