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