3.4.1 パフォーマンスデータの格納先の変更

PFM - Agent for Enterprise Applicationsで収集したパフォーマンスデータは,PFM - Agent for Enterprise ApplicationsのAgent StoreサービスのStoreデータベースで管理しています。ここではパフォーマンスデータの格納先の変更方法について説明します。

<この項の構成>
(1) jpcconf db define(jpcdbctrl config)コマンドを使用して設定を変更する
(2) jpcsto.iniファイルを編集して設定を変更する(Storeバージョン1.0の場合だけ)

(1) jpcconf db define(jpcdbctrl config)コマンドを使用して設定を変更する

Storeデータベースで管理されるパフォーマンスデータの,次のデータ格納先ディレクトリを変更したい場合は,jpcconf db define(jpcdbctrl config)コマンドで設定します。Storeデータベースの格納先ディレクトリを変更する前に収集したパフォーマンスデータが必要な場合は,jpcconf db define(jpcdbctrl config)コマンドの-moveオプションを使用してください。jpcconf db define(jpcdbctrl config)コマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」を参照してください。

注※ Storeバージョン2.0使用時だけ設定できます。

jpcconf db define(jpcdbctrl config)コマンドで設定するオプション名,設定できる値の範囲などを次の表に示します。

表3-8 パフォーマンスデータの格納先を変更するコマンドの設定項目

説明オプション名設定できる値(Storeバージョン1.0)設定できる値(Storeバージョン2.0)デフォルト値
パフォーマンスデータの作成先ディレクトリsd1~127バイトのフルパス名1~214バイトのフルパス名※1/opt/jp1pc/agtm/store/インスタンス名
パフォーマンスデータの作成先ディレクトリ(論理ホスト運用の場合)sd1~127バイトのフルパス名1~214バイトのフルパス名※1環境ディレクトリ2/jp1pc/agtm/store/インスタンス名
パフォーマンスデータの退避先ディレクトリ(フルバックアップ)bd1~127バイトのフルパス名1~211バイトのフルパス名※3/opt/jp1pc/agtm/store/インスタンス名/backup
パフォーマンスデータの退避先ディレクトリ(フルバックアップ。論理ホスト運用の場合)bd1~127バイトのフルパス名1~211バイトのフルパス名※3環境ディレクトリ2/jp1pc/agtm/store/インスタンス名/backup
パフォーマンスデータの退避先ディレクトリ(部分バックアップ)pbd1~214バイトのフルパス名※1/opt/jp1pc/agtm/store/インスタンス名/partial
パフォーマンスデータの退避先ディレクトリ(部分バックアップ。論理ホスト運用の場合)pbd1~214バイトのフルパス名※1環境ディレクトリ2/jp1pc/agtm/store/インスタンス名/partial
パフォーマンスデータを退避する場合の最大世代番号bs1~91~95
パフォーマンスデータのエクスポート先ディレクトリdd1~127バイトのフルパス名1~127バイトのフルパス名/opt/jp1pc/agtm/store/インスタンス名/dump
パフォーマンスデータのエクスポート先ディレクトリ(論理ホスト運用の場合)dd1~127バイトのフルパス名1~127バイトのフルパス名環境ディレクトリ2/jp1pc/agtm/store/インスタンス名/dump
パフォーマンスデータのインポート先ディレクトリid1~222バイトのフルパス名※4/opt/jp1pc/agtm/store/インスタンス名/import
パフォーマンスデータのインポート先ディレクトリ(論理ホスト運用の場合)id1~222バイトのフルパス名※4環境ディレクトリ2/jp1pc/agtm/store/インスタンス名/import
(凡例)
-:設定できない
注※1
相対パスで設定している場合には,設定したディレクトリのパスの長さが,絶対パスで214バイト以内である必要があります。
注※2
環境ディレクトリは,論理ホスト作成時に指定した共有ディスク上のディレクトリです。
注※3
相対パスで設定している場合には,設定したディレクトリのパスの長さが,絶対パスで211バイト以内である必要があります。
注※4
相対パスで設定している場合には,設定したディレクトリのパスの長さが,絶対パスで222バイト以内である必要があります。

(2) jpcsto.iniファイルを編集して設定を変更する(Storeバージョン1.0の場合だけ)

Storeバージョン1.0使用時は,jpcsto.iniを直接編集して変更できます。

(a) jpcsto.iniファイルの設定項目

jpcsto.iniファイルで編集するラベル名,設定できる値の範囲などを次の表に示します。

表3-9 パフォーマンスデータの格納先の設定項目(jpcsto.iniの[Data Section]セクション)

説明ラベル名設定できる値(Storeバージョン1.0)※1デフォルト値
パフォーマンスデータの作成先ディレクトリStore Dir※21~127バイトのフルパス名/opt/jp1pc/agtm/store/インスタンス名
パフォーマンスデータの作成先ディレクトリStore Dir※21~127バイトのフルパス名環境ディレクトリ3/jp1pc/agtm/store/インスタンス名
パフォーマンスデータの退避先ディレクトリ(フルバックアップ)Backup Dir※21~127バイトのフルパス名/opt/jp1pc/agtm/store/インスタンス名/backup
パフォーマンスデータの退避先ディレクトリ(フルバックアップ。論理ホスト運用の場合)Backup Dir※21~127バイトのフルパス名環境ディレクトリ3/jp1pc/agtm/store/インスタンス名/backup
パフォーマンスデータを退避する場合の最大世代番号Backup Save1~95
パフォーマンスデータのエクスポート先ディレクトリDump Dir※21~127バイトのフルパス名/opt/jp1pc/agtm/store/インスタンス名/dump
パフォーマンスデータのエクスポート先ディレクトリ(論理ホスト運用の場合)Dump Dir※21~127バイトのフルパス名環境ディレクトリ3/jp1pc/agtm/store/インスタンス名/dump
(凡例)
-:設定できない
注※1
  • ディレクトリ名は,すべてフルパス名で指定してください。
  • 指定できる文字は,次の文字を除く,半角英数字,半角記号および半角空白です。
    ; , * ? ' " < > |
  • 指定値に誤りがある場合,Agent Storeサービスは起動できません。
注※2
Store Dir,Backup Dir,およびDump Dirには,それぞれ重複したディレクトリを指定できません。
注※3
環境ディレクトリは,論理ホスト作成時に指定した共有ディスク上のディレクトリです。

(b) jpcsto.iniファイルの編集前の準備

(c) jpcsto.iniファイルの編集手順

手順を次に示します。

  1. PFM - Agent のサービスを停止する。
    ローカルホストでPFM -Agentのプログラムおよびサービスが起動されている場合は,すべて停止してください。
  2. テキストエディターなどで,jpcsto.iniファイルを開く。
  3. パフォーマンスデータの格納先ディレクトリなどを変更する。
    次に示す網掛け部分を,必要に応じて修正してください。

    [図データ]

    注意
    • 行頭および「=」の前後には空白文字を入力しないでください。
    • 各ラベルの値の「.」は,Agent StoreサービスのStoreデータベースのデフォルト格納先ディレクトリ(/opt/jp1pc/agtm/store/インスタンス名)を示します。格納先を変更する場合,その格納先ディレクトリからの相対パスか,または絶対パスで記述してください。
    • Storeデータベースの格納先を変更する場合,指定するディレクトリを事前に作成してください。
    • jpcsto.iniファイルには,データベースの格納先ディレクトリ外にも,定義情報が記述されています。[Data Section]セクション以外の値は変更しないようにしてください。[Data Section]セクション以外の値を変更すると,Performance Managementが正常に動作しなくなることがあります。
  4. jpcsto.iniファイルを保存して閉じる。
  5. Performance Managementのプログラムおよびサービスを起動する。
注意
この手順でStoreデータベースの保存先ディレクトリを変更した場合,パフォーマンスデータファイルは変更前のディレクトリから削除されません。これらのファイルが不要な場合は,次に示すファイルだけを削除してください。
  • 拡張子が.DBであるすべてのファイル
  • 拡張子が.IDXであるすべてのファイル