レガシー モニタリングエージェントからの更新
オートメーションが管理せず、MongoDB Agent に更新したい MongoDB 配置を監視対象とするプロジェクトがあります。
注意
最初に前提条件を確認する
MongoDB 配置の管理のためにオートメーションを開始または継続する場合は、MongoDB Agent に更新する前に MongoDB Agent の前提条件を確認してください。
手順
Microsoft Windows を実行している x86_64 アーキテクチャ上の MongoDB Agent に更新するには、次の手順を使用します。
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent をインストールします。
[ MongoDB Agent Installation Instructions ] ボックスには次の情報が表示されます。
Base URL
プロジェクトへのバインディングに必要です。
Project ID (プロジェクトへのバインディングに必要)
API Key
API キーを持っていない場合は、クリックしますキーの生成。
警告
これらの値の一部またはすべてが後の手順で必要になります。 これらの値をコピーして、後でアクセスできるように保存します。
MongoDB Agent Windows インストーラーを実行します。
MSI
をダウンロードしたら、次のダブルクリックを行います。mongodb-mms-automation-agent-<VERSION>.windows_x86_64.msi
注意
ファイル名での
mongodb-mms-automation
の使用はレガシー アーティファクトであり、MongoDB Agent がオートメーション構成された状態でインストールされていることを意味するものではありません。セキュリティ警告が表示された場合は、 Runをクリックします。
Configuration/Log Folderステップで
これらのファイルが保存されるディレクトリを指定します。
Key Typeステップで、特定のプロジェクトにバインドするためのAgent API Keyを選択します。
適切なエージェント キーを入力します。
注意
これらのキーは、前のステップで説明したMongoDB Agent Installation Instructionsモーダルで提供されます。
Base URLフィールドに
Base URL
を入力します。Project IDフィールドにプロジェクト ID を入力します。
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 Agent をインストールしている MongoDB ホストでこれを無効にしていない場合は、ここで無効にします。 ステイルス モードでは、MongoDB Agent のパフォーマンスと機能が大幅に低下します。 [ Disable Stealth Modeをクリックします。
(条件付き)Windows では ディスク パフォーマンス カウンター は有効になりません デフォルトでは。MongoDB ホストでディスク パフォーマンス カウンターを有効にしていない場合は、 Enable Disk Performance Countersをクリックします。 MongoDB Agent は、ハードウェア モニタリング アクティビティの一部にこれらのカウンターを使用します。
[Install] をクリックします。
設定が完了したら、 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"
(任意)MongoDB Agent のバイナリと構成バックアップ ファイルの場所を変更します。
システム ポリシーやプラクティスによっては、 MongoDBバイナリとMongoDB Ops Managerの構成バックアップ ファイルを %SystemDrive%\MMSMongoDB\versions
のデフォルトのロケーション以外に配置する必要がある場合があります。
注意
Windows は、 %SystemDrive%
環境変数を Windows をインストールしたドライブに設定します。 デフォルトでは、 C:
ドライブに Windows をインストールするように指示されます。 %SystemDrive%
を見つけるには、 PowerShell から次のコマンドを実行して発行します
get-childitem env:SystemDrive
これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。
MongoDB Agent バイナリの場所を変更するには
[ Deploymentをクリックし、次にAgentsをクリックし、次にDownloads & Settingsをクリックします。
Download Directory見出しの下にある [] をクリックします。 ( Download Directory (Windows)に表示されているパスの右側にある)。
パスを必要な新しいパスに変更します。
[Save] をクリックします。
MongoDB Agent を実行する各ホストに、指定した新しいディレクトリを作成します。 Windows Explorer を使用してファイルを移動するか、コマンドプロンプトまたは PowerShell から次のコマンドを実行します。
md \<newPath> 重要
MongoDB Agent を実行するシステムユーザーがこの新しいディレクトリに書込みできることを確認します。 これは通常、
SYSTEM
ユーザーであり、ユーザーを変更した場合を除き、追加の構成は必要ありません。
MongoDB Agent の構成バックアップの場所を変更するには
希望のテキストエディタでMongoDB Agent の構成ファイルを開きます。
mmsConfigBackup
設定を構成バックアップ ファイルの新しいパスに変更します。 次の例のX
を、バックアップが保存されているドライブ文字に置き換えます。mmsConfigBackup=X:\<newPath>\mms-cluster-config-backup.json MongoDB Agent の構成ファイルを保存します。
構成バックアップ ファイルを新しいディレクトリに移動します。 Windows Explorer を使用してファイルを移動するか、コマンドプロンプトまたは PowerShell から次のコマンドを実行します。
move %SystemDrive%\MMSMongoDB\versions\mms-cluster-config-backup.json \<newPath>
MongoDB Agent に更新するには、次の手順に従います。
Debian 9 、 Ubuntu 18.04を実行中x 86 _ 64アーキテクチャでは、 Ubuntu 20.04 、またはUbuntu 22.04 :
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
この手順から、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
に置き換えます。
MongoDB Agent の構成ファイルを編集します。
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>
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで automation-agent.config ファイルを開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成キーを追加します。
キー | 値 |
---|---|
プロキシ サーバーへの のURL (ホスト名とポート)。 |
Ubuntu 18 .x を実行中の zSeries アーキテクチャでは、 deb
パッケージを使用して次のようにします。
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
この手順から、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
に置き換えます。
MongoDB Agent の構成ファイルを編集します。
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>
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで automation-agent.config ファイルを開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成キーを追加します。
キー | 値 |
---|---|
プロキシ サーバーへの のURL (ホスト名とポート)。 |
MongoDB Agent に更新するには、次の手順に従います。
x 86 _ 64アーキテクチャでは:
RHEL の実行( 7 .x) 8 .x、または9 .x)または CentOS( 7 .x または8 .x) SUSE 12 、 SUSE 15 、または Amazon Linux 2 :
rpm
パッケージを使用する場合:
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
この手順から、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
に置き換えます。
MongoDB Agent の構成ファイルを編集します。
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>
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで automation-agent.config ファイルを開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成キーを追加します。
キー | 値 |
---|---|
プロキシ サーバーへの のURL (ホスト名とポート)。 |
tar
アーカイブの使用:
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
この手順から開始するには、MongoDB Agent のインストール モーダルに従い、提供されたコマンドを にコピーします。
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
に置き換えます。
MongoDB Agent の構成ファイルを編集します。
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>
オプション: バイナリ、ログ、データ ディレクトリを作成します。
既存のモニタリングエージェント ユーザーが存在し、オートメーションを有効にする予定がない場合は、ログ ディレクトリのみを作成する必要があります。
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
に配置されています。 これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。
エージェント バイナリの場所を変更するには:
[ 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
PowerPC アーキテクチャ上の RHEL / CentOS( 7 .x)の場合(MongoDB 3.4以降の配置の管理):
rpm
パッケージを使用する場合:
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
この手順から、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
に置き換えます。
MongoDB Agent の構成ファイルを編集します。
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>
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで automation-agent.config ファイルを開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成キーを追加します。
キー | 値 |
---|---|
プロキシ サーバーへの のURL (ホスト名とポート)。 |
tar
アーカイブの使用:
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
この手順から、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
に置き換えます。
MongoDB Agent の構成ファイルを編集します。
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>
オプション: バイナリ、ログ、データ ディレクトリを作成します。
既存のモニタリングエージェント ユーザーが存在し、オートメーションを有効にする予定がない場合は、ログ ディレクトリのみを作成する必要があります。
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
に配置されています。 これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。
エージェント バイナリの場所を変更するには:
[ 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
Z Series アーキテクチャ(MongoDB 4.0以降の配置の管理)の場合
RHEL の実行( 7 .x) 8 .x、または9 .x)または CentOS( 7 .x または8 .x)では、 rpm
パッケージ マネージャーを使用します。
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
この手順から、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
に置き換えます。
MongoDB Agent の構成ファイルを編集します。
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>
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で MongoDB Ops Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB Agent をインストールしたディレクトリ内、希望するテキストエディターで automation-agent.config ファイルを開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成キーを追加します。
キー | 値 |
---|---|
プロキシ サーバーへの のURL (ホスト名とポート)。 |
この手順を使用して、 deb
またはrpm
パッケージを使用していない Linux システムに MongoDB Agent への更新をインストールします。
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
MongoDB Ops Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
この手順から、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
に置き換えます。
MongoDB Agent の構成ファイルを編集します。
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>
オプション: バイナリ、ログ、データ ディレクトリを作成します。
既存のモニタリングエージェント ユーザーが存在し、オートメーションを有効にする予定がない場合は、ログ ディレクトリのみを作成する必要があります。
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
に配置されています。 これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。
エージェント バイナリの場所を変更するには:
[ 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
次のステップ
MongoDB Agent の更新が完了すると、次の状況が発生します。