レガシー モニタリングエージェントからの更新
- Cloud Managerへのプログラムによるアクセスのための OAuth 2.0認証はプレビュー機能として利用できます。
- 機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。 OAuth2.0 認証を使用するには、 Cloud Manager Public APIへのリクエストで使用する サービス アカウント を作成します。
オートメーションが管理せず、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 ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent をインストールします。
[ MongoDB Agent Installation Instructions ] ボックスには次の情報が表示されます。
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モーダルで提供されます。
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 | 必須 | 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"
MongoDB Agent のインストールを完了します。 Install Agent Instructionsモーダルで、 Doneをクリックします。
(任意)MongoDB Agent のバイナリと構成バックアップ ファイルの場所を変更します。
システム ポリシーやプラクティスによっては、MongoDB バイナリと Cloud Manager の構成バックアップ ファイルを%SystemDrive%\MMSMongoDB\versions
のデフォルトのロケーション以外に配置する必要がある場合があります。
注意
Windows は、 %SystemDrive%
環境変数を Windows をインストールしたドライブに設定します。 デフォルトでは、 C:
ドライブに Windows をインストールするように指示されます。 %SystemDrive%
を見つけるには、 PowerShell から次のコマンドを実行して発行します
get-childitem env:SystemDrive
これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。
MongoDB Agent バイナリの場所を変更するには
MongoDB Cloud Managerで、プロジェクトの Deployment ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの 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 8、Debian 9、Ubuntu 18.04、Ubuntu 20.04、または Ubuntu 22.04 を実行している x86_64 アーキテクチャでは、次のようにします。
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud 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://cloud.mongodb.com/download/agent/automation/mongodb-mms-automation-agent-manager-latest.amd64.ubuntu1604.deb
MongoDB Agent の構成ファイルを編集します。
MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成オプションを更新します。
キー | 値 |
---|---|
ProjectID プロジェクトの | |
プロジェクトのエージェント API キー。 |
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で Cloud Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB 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 ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
注意
この手順から、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
MongoDB Agent の構成ファイルを編集します。
MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成オプションを更新します。
キー | 値 |
---|---|
ProjectID プロジェクトの | |
プロジェクトのエージェント API キー。 |
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で Cloud Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成キーを追加します。
キー | 値 |
---|---|
プロキシ サーバーへの のURL (ホスト名とポート)。 |
MongoDB Agent に更新するには、次の手順に従います。
x 86 _ 64アーキテクチャでは:
rpm
パッケージを使用して RHEL / CentOS 6 .x を実行します。
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
注意
この手順から、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
MongoDB Agent の構成ファイルを編集します。
MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成オプションを更新します。
キー | 値 |
---|---|
ProjectID プロジェクトの | |
プロジェクトのエージェント API キー。 |
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で Cloud Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成キーを追加します。
キー | 値 |
---|---|
プロキシ サーバーへの のURL (ホスト名とポート)。 |
RHEL / CentOS 7 .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 ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
注意
この手順から、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
MongoDB Agent の構成ファイルを編集します。
MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成オプションを更新します。
キー | 値 |
---|---|
ProjectID プロジェクトの | |
プロジェクトのエージェント API キー。 |
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で Cloud Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB 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 ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
注意
この手順から開始するには、MongoDB Agent のインストール モーダルに従い、提供されたコマンドを にコピーします。
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
MongoDB Agent の構成ファイルを編集します。
MongoDB Agent をインストールしたディレクトリで、テキスト エディターで local.config ファイルを開きます。
vi <install-path>/local.config
次の構成オプションを更新します。
キー | 値 |
---|---|
ProjectID プロジェクトの | |
プロジェクトのエージェント API キー。 |
オプション: バイナリ、ログ、データ ディレクトリを作成します。
既存のモニタリングエージェント ユーザーが存在し、オートメーションを有効にする予定がない場合は、ログ ディレクトリのみを作成する必要があります。
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
に配置されています。 これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。
エージェント バイナリの場所を変更するには:
MongoDB Cloud Managerで、プロジェクトの Deployment ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの 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 ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
注意
この手順から、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
MongoDB Agent の構成ファイルを編集します。
MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成オプションを更新します。
キー | 値 |
---|---|
ProjectID プロジェクトの | |
プロジェクトのエージェント API キー。 |
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で Cloud Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB 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 ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
注意
この手順から、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
MongoDB Agent の構成ファイルを編集します。
MongoDB Agent をインストールしたディレクトリで、テキスト エディターで local.config ファイルを開きます。
vi <install-path>/local.config
次の構成オプションを更新します。
キー | 値 |
---|---|
ProjectID プロジェクトの | |
プロジェクトのエージェント API キー。 |
オプション: バイナリ、ログ、データ ディレクトリを作成します。
既存のモニタリングエージェント ユーザーが存在し、オートメーションを有効にする予定がない場合は、ログ ディレクトリのみを作成する必要があります。
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
に配置されています。 これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。
エージェント バイナリの場所を変更するには:
MongoDB Cloud Managerで、プロジェクトの Deployment ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの 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 / CentOS 7 .x/ 8 .x を実行中 rpm
パッケージ マネージャーを使用する場合
レガシー モニタリングエージェントの既存の構成オプションを追加します。
オートメーションがモニタリングエージェントを管理していなかった場合は、 Add Custom Configuration Options for your MongoDB Agent (Optional)ステップで以前に使用していたモニタリング設定を追加できます。
モニタリングエージェントに用意したオプションを追加するには、 Monitoring Configurationsセクションで次の手順を行います。
Settingボックスに任意の設定を入力し、 Valueボックスに対応する値を入力します。
複数のSettingを追加するには、 + Add Settingリンクをクリックします。 別の行が表示されます。
すべての設定が追加されるまで、繰り返します。
配置に必要な設定をすべて追加したら、[ Next ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
注意
この手順から、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
MongoDB Agent の構成ファイルを編集します。
MongoDB Agent をインストールしたディレクトリで、オートメーションエージェントの .config ファイルを希望のテキストエディタで開きます。
sudo vi /etc/mongodb-mms/automation-agent.config
次の構成オプションを更新します。
キー | 値 |
---|---|
ProjectID プロジェクトの | |
プロジェクトのエージェント API キー。 |
オプション: プロキシ サーバーを使用するように MongoDB Agent を構成します。
プロキシ サーバー経由で Cloud Manager に接続するように MongoDB Agent を構成するには、 httpProxy
環境変数でサーバーを指定する必要があります。
MongoDB 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 ] をクリックします。
をクリックできます。追加した設定を削除します。
重要
Cloud Manager は、これらの設定を検証しません。 設定と値が正しいことを確認します。
MongoDB Agent の最新バージョンをダウンロードします。
注意
この手順から、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
MongoDB Agent の構成ファイルを編集します。
MongoDB Agent をインストールしたディレクトリで、テキスト エディターで local.config ファイルを開きます。
vi <install-path>/local.config
次の構成オプションを更新します。
キー | 値 |
---|---|
ProjectID プロジェクトの | |
プロジェクトのエージェント API キー。 |
オプション: バイナリ、ログ、データ ディレクトリを作成します。
既存のモニタリングエージェント ユーザーが存在し、オートメーションを有効にする予定がない場合は、ログ ディレクトリのみを作成する必要があります。
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
に配置されています。 これらのファイルを別のディレクトリに保存する場合は、次の手順に従います。
エージェント バイナリの場所を変更するには:
MongoDB Cloud Managerで、プロジェクトの Deployment ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの 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 の更新が完了すると、次の状況が発生します。
オートメーションが以前にモニタリングエージェントを管理していなかった場合は、バックアップを有効化し、MongoDB 配置でモニタリングを行いました。
オートメーションが以前にモニタリングエージェントを管理していた場合は、このエージェントは有効化されるようになりました。 オートメーションがアクティブ化されていることを確認するには、次の手順を行います。
1MongoDB Cloud ManagerGoDeploymentMongoDB Cloud Managerで、プロジェクトの ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの Deployment をクリックします。
配置ページが表示されます。
2Servers ページに移動します。
配置の [ Servers ] タブをクリックします。
[ Servers ]ページが表示されます。
オートメーションを有効にする場合は、MongoDB プロジェクトに配置を追加します。