JP1/Performance Management - Agent Option for Enterprise Applications
PFM - Agent for Enterprise Applicationsで収集したパフォーマンスデータは,PFM - Agent for Enterprise ApplicationsのAgent StoreサービスのStoreデータベースで管理しています。ここではパフォーマンスデータの格納先の変更方法について説明します。
- <この項の構成>
- (1) jpcdbctrl configコマンドを使用して設定を変更する
- (2) jpcsto.iniファイルを編集して設定を変更する(Storeバージョン1.0の場合だけ)
(1) jpcdbctrl configコマンドを使用して設定を変更する
Storeデータベースで管理されるパフォーマンスデータの,次のデータ格納先ディレクトリを変更したい場合は,jpcdbctrl configコマンドで設定します。Storeデータベースの格納先ディレクトリを変更する前に収集したパフォーマンスデータが必要な場合は,jpcdbctrl configコマンドの-moveオプションを使用してください。jpcdbctrl configコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」を参照してください。
- 保存先ディレクトリ
- バックアップ先ディレクトリ
- エクスポート先ディレクトリ
- 部分バックアップ先ディレクトリ※
- インポート先ディレクトリ※
- 注※ Storeバージョン2.0使用時だけ設定できます。
jpcdbctrl configコマンドで設定するオプション名,設定できる値の範囲などを次の表に示します。
表3-8 パフォーマンスデータの格納先を変更するコマンドの設定項目
説明 オプション名 設定できる値(Storeバージョン1.0) 設定できる値(Storeバージョン2.0) デフォルト値 パフォーマンスデータの作成先ディレクトリ sd 1〜127バイトのフルパス名 1〜214バイトのフルパス名※1 /opt/jp1pc/agtm/store/インスタンス名 パフォーマンスデータの作成先ディレクトリ(論理ホスト運用の場合) sd 1〜127バイトのフルパス名 1〜214バイトのフルパス名※1 環境ディレクトリ※2/jp1pc/agtm/store/インスタンス名 パフォーマンスデータの退避先ディレクトリ(フルバックアップ) bd 1〜127バイトのフルパス名 1〜211バイトのフルパス名※3 /opt/jp1pc/agtm/store/インスタンス名/backup パフォーマンスデータの退避先ディレクトリ(フルバックアップ。論理ホスト運用の場合) bd 1〜127バイトのフルパス名 1〜211バイトのフルパス名※3 環境ディレクトリ※2/jp1pc/agtm/store/インスタンス名/backup パフォーマンスデータの退避先ディレクトリ(部分バックアップ) pbd − 1〜214バイトのフルパス名※1 /opt/jp1pc/agtm/store/インスタンス名/partial パフォーマンスデータの退避先ディレクトリ(部分バックアップ。論理ホスト運用の場合) pbd − 1〜214バイトのフルパス名※1 環境ディレクトリ※2/jp1pc/agtm/store/インスタンス名/partial パフォーマンスデータを退避する場合の最大世代番号 bs 1〜9 1〜9 5 パフォーマンスデータのエクスポート先ディレクトリ dd 1〜127バイトのフルパス名 1〜127バイトのフルパス名 /opt/jp1pc/agtm/store/インスタンス名/dump パフォーマンスデータのエクスポート先ディレクトリ(論理ホスト運用の場合) dd 1〜127バイトのフルパス名 1〜127バイトのフルパス名 環境ディレクトリ※2/jp1pc/agtm/store/インスタンス名/dump パフォーマンスデータのインポート先ディレクトリ id − 1〜222バイトのフルパス名※4 /opt/jp1pc/agtm/store/インスタンス名/import パフォーマンスデータのインポート先ディレクトリ(論理ホスト運用の場合) id − 1〜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を直接編集して変更できます。
jpcsto.iniファイルで編集するラベル名,設定できる値の範囲などを次の表に示します。
表3-9 パフォーマンスデータの格納先の設定項目(jpcsto.iniの[Data Section]セクション)
説明 ラベル名 設定できる値(Storeバージョン1.0)※1 デフォルト値 パフォーマンスデータの作成先ディレクトリ Store Dir※2 1〜127バイトのフルパス名 /opt/jp1pc/agtm/store/インスタンス名 パフォーマンスデータの作成先ディレクトリ Store Dir※2 1〜127バイトのフルパス名 環境ディレクトリ※3/jp1pc/agtm/store/インスタンス名 パフォーマンスデータの退避先ディレクトリ(フルバックアップ) Backup Dir※2 1〜127バイトのフルパス名 /opt/jp1pc/agtm/store/インスタンス名/backup パフォーマンスデータの退避先ディレクトリ(フルバックアップ。論理ホスト運用の場合) Backup Dir※2 1〜127バイトのフルパス名 環境ディレクトリ※3/jp1pc/agtm/store/インスタンス名/backup パフォーマンスデータを退避する場合の最大世代番号 Backup Save 1〜9 5 パフォーマンスデータのエクスポート先ディレクトリ Dump Dir※2 1〜127バイトのフルパス名 /opt/jp1pc/agtm/store/インスタンス名/dump パフォーマンスデータのエクスポート先ディレクトリ(論理ホスト運用の場合) Dump Dir※2 1〜127バイトのフルパス名 環境ディレクトリ※3/jp1pc/agtm/store/インスタンス名/dump
- (凡例)
- −:設定できない
- 注※1
- ディレクトリ名は,すべてフルパス名で指定してください。
- 指定できる文字は,次の文字を除く,半角英数字,半角記号および半角空白です。
; , * ? ' " < > |
- 指定値に誤りがある場合,Agent Storeサービスは起動できません。
- 注※2
- Store Dir,Backup Dir,およびDump Dirには,それぞれ重複したディレクトリを指定できません。
- 注※3
- 環境ディレクトリは,論理ホスト作成時に指定した共有ディスク上のディレクトリです。
- Storeデータベースの格納先ディレクトリを変更する場合は,変更後の格納先ディレクトリを事前に作成しておいてください。
- Storeデータベースの格納先ディレクトリを変更すると,変更前に収集したパフォーマンスデータを使用できなくなります。変更前に収集したパフォーマンスデータが必要な場合は,次に示す手順でデータを引き継いでください。
- jpcctrl backupコマンドでStoreデータベースに格納されているパフォーマンスデータのバックアップを採取する。
- 「3.4.1(2)(c) jpcsto.iniファイルの編集手順」に従ってStoreデータベースの格納先ディレクトリを変更する。
- jpcrestoコマンドで変更後のディレクトリにバックアップデータをリストアする。
手順を次に示します。
- PFM - Agent のサービスを停止する。
ローカルホストでPFM -Agentのプログラムおよびサービスが起動されている場合は,すべて停止してください。
- テキストエディターなどで,jpcsto.iniファイルを開く。
- パフォーマンスデータの格納先ディレクトリなどを変更する。
次に示す網掛け部分を,必要に応じて修正してください。
注意
- 行頭および「=」の前後には空白文字を入力しないでください。
- 各ラベルの値の「.」は,Agent StoreサービスのStoreデータベースのデフォルト格納先ディレクトリ(/opt/jp1pc/agtm/store/インスタンス名)を示します。格納先を変更する場合,その格納先ディレクトリからの相対パスか,または絶対パスで記述してください。
- Storeデータベースの格納先を変更する場合,指定するディレクトリを事前に作成してください。
- jpcsto.iniファイルには,データベースの格納先ディレクトリ外にも,定義情報が記述されています。[Data Section]セクション以外の値は変更しないようにしてください。[Data Section]セクション以外の値を変更すると,Performance Managementが正常に動作しなくなることがあります。
- jpcsto.iniファイルを保存して閉じる。
- Performance Managementのプログラムおよびサービスを起動する。
- 注意
- この手順でStoreデータベースの保存先ディレクトリを変更した場合,パフォーマンスデータファイルは変更前のディレクトリから削除されません。これらのファイルが不要な場合は,次に示すファイルだけを削除してください。
- 拡張子が.DBであるすべてのファイル
- 拡張子が.IDXであるすべてのファイル
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.