2.21.1　OracleDB exporterの設定

■ 監視対象を追加するための準備

Windowsの場合と共通です。「1.23.1(4)(a)監視対象を追加する（必須）」の「■監視対象を追加するための準備」を参照してください。

■ OracleDB exporterの設定

1. ユニット定義ファイルを作成する。

   コピー元のユニット定義ファイルをコピーし，コピー先のファイル名にリネームします。

   作成したユニット定義ファイルのオーナーおよびオーナーグループはroot，アクセス権は644にします。

   コピー元のファイル名：OracleDB exporterの配置先/oracledb_exporter_linux/jp1ima/conf/oracledb_exporter_@@instance@@.service.model

   コピー先のファイル名：

   • 物理ホスト運用の場合

     OracleDB exporterの配置先/oracledb_exporter_linux/jp1ima/conf/oracledb_exporter_インスタンス名^※.service

   • 論理ホスト運用の場合

     OracleDB exporterの配置先/oracledb_exporter_linux/jp1ima/conf/oracledb_exporter_インスタンス名^※_論理ホスト名.service

   注※

   インスタンス名は，「1.23.1(4)(a)監視対象を追加する（必須）」の「■監視対象を追加するための準備」で決めた名称を指定します。

2. ユニット定義ファイルを更新する。

   手順1.で作成したユニット定義ファイルの次の値を表のとおりに変更します。

   変更する値	指定する値
   @@instance@@	物理ホスト運用の場合 「1.23.1(4)(a)監視対象を追加する（必須）」の「■監視対象を追加するための準備」の手順1.で決めた名称に置換する。 論理ホスト運用する場合 「1.23.1(4)(a)監視対象を追加する（必須）」の「■監視対象を追加するための準備」の手順1.で決めた名称「_論理ホスト名」を付与した値に置換する。
   @@oracledb_exporter_installdir@@	OracleDB exporterの配置先に置換する。
   @@port@@	「1.23.1(4)(a)監視対象を追加する（必須）」の「■監視対象を追加するための準備」の手順2.で決めたポート番号に置換する。 論理ホストの場合は論理ホスト名も指定し，--web.listen-address="論理ホスト名:ポート番号"となるように置換する。
   @@installdir2@@	「1.23.1(4)(a)監視対象を追加する（必須）」の「■監視対象を追加するための準備」の手順3.で確認したディレクトリに置換する。
   @@data_source_name@@	「1.23.1(4)(a)監視対象を追加する（必須）」の「■監視対象を追加するための準備」の手順4.で確認した内容に置換する。

3. ユニット定義ファイルをsystemdに登録する。

   手順2.で更新したユニット定義ファイルを次のディレクトリ配下にコピー^※します。論理ホスト運用の場合は，クラスタを構成する両ノードでコピーします。

   コピー先のディレクトリ：/usr/lib/systemd/system

   注※

   移動ではなくコピーしてください。移動した場合，SELinuxのパーミッションが正しく設定されず，サービスが正しく起動されない場合があります。

   ユニット定義ファイルをコピー先のディレクトリにコピーした後，次のコマンドを実行し，systemdをリロードします。論理ホスト運用の場合は，クラスタを構成する両ノードでコマンドを実行します。

   systemctl daemon-reload

   物理ホスト運用でOS起動時に自動起動させたい場合は，次のコマンドを実行します。論理ホスト運用の場合は，自動起動させません。

   systemctl enable サービス名

4. ログディレクトリを作成する。

   OracleDB exporterの配置先にログディレクトリを作成します。

   作成したディレクトリのオーナーおよびオーナーグループはroot，アクセス権は700にします。

   • 物理ホスト運用の場合

     OracleDB exporterの配置先/oracledb_exporter_linux/jp1ima/logs/oracledb_exporter/インスタンス名^※

   • 論理ホスト運用の場合

     OracleDB exporterの配置先/oracledb_exporter_linux/jp1ima/logs/oracledb_exporter/インスタンス名^※_論理ホスト名

   注※

   インスタンス名は，「1.23.1(4)(a)監視対象を追加する（必須）」の「■監視対象を追加するための準備」で決めた名称を指定します。

5. Oracle Databaseへの接続に使用するユーザーのパスワードを登録する。

   Oracle Databaseへの接続に使用するユーザーのパスワードをjimasecretコマンドで登録します。

   • 物理ホスト運用の場合

     jimasecret -add -key OracleDB.user.ユーザー名 -s パスワード

   • 論理ホスト運用の場合

     jimasecret -add -key OracleDB.user.ユーザー名 -s パスワード -l 共有ディレクトリ

   同一ユーザー名でパスワードが異なるユーザーを登録したい場合は，ホスト名とサービス名を含むキーを使用することができます。

   jimasecretコマンドの詳細については，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイル・APIリファレンス」の「jimasecret」（1.　コマンド）を参照してください。

6. クラスタソフトにサービスを登録する。

   クラスタ構成の場合は，クラスタソフトにサービスを登録します。

7. OracleDB exporterサービスを起動する。

   systemctl startコマンドでOracleDB exporterのサービスを起動します。

   クラスタ構成の場合はクラスタソフトからサービスを起動します。

8. OracleDB exporterで性能情報が取得できることを確認する。

   curlコマンドやブラウザーで次のURLにアクセスし，性能情報が取得できているか確認してください。

   http://ホスト名:ポート/metrics

   ホスト名にはOracleDB exporterを起動しているホスト，ポートにはOracleDB exporterのリッスンポートを指定します。

■ Prometheusの設定

Windowsの場合と共通です。「1.23.1(4)(a)監視対象を追加する（必須）」の「■Prometheusの設定」を参照してください。

■ インテリジェント統合管理基盤の設定

Windowsの場合と共通です。「1.23.1(4)(a)監視対象を追加する（必須）」の「■インテリジェント統合管理基盤の設定」を参照してください。

■ Prometheusの設定

Windowsの場合と共通です。「1.23.1(4)(d)監視対象を削除する（オプション）」の「■Prometheusの設定」を参照してください。

■ Prometheusの設定

Windowsの場合と共通です。「1.23.1(4)(d)監視対象を削除する（オプション）」の「■クラスタソフトからOracleDB exporterを削除」を参照してください。

■ OracleDB exporterの設定

1. 削除する監視対象のOracleDB exporterサービスを停止する。

   systemctl startコマンドでOracleDB exporterのサービスを停止します。

2. ユニット定義ファイルを削除する。

   次に示すユニット定義ファイルを削除します。

   • 物理ホスト運用の場合

     oracledb_exporter_インスタンス名_service

   • 論理ホスト運用の場合

     oracledb_exporter_インスタンス名_論理ホスト名_service

   論理ホスト運用の場合はクラスタを構成する両ノードで削除してください。

3. systemctlを更新する。

   次のコマンドを実行し，systemctlを更新します。

   systemctl daemon-reload

   論理ホスト運用の場合はクラスタを構成する両ノードで削除してください

4. Oracle Databaseへの接続に使用するユーザーのパスワードを削除する。

   ほかのOracleDB exporterで同じユーザーを使用していない場合は，登録済みのパスワードをjimasecretコマンドで削除します。

   • 物理ホスト運用の場合

     jimasecret -rm -key OracleDB.user.ユーザー名

   • 論理ホスト運用の場合

     jimasecret -rm -key OracleDB.user.ユーザー名 -s パスワード -l 共有ディレクトリ

   ホスト名やリスナー名を含むキーを指定して登録した場合は，そのキーを指定してください。