JP1/Performance Management リファレンス
形式
jpcdbctrl setup -key サービスキー [-inst インスタンス名] [-lhost 論理ホスト名]
機能
jpcdbctrl setupコマンドは,Storeバージョン2.0の機能をセットアップするコマンドです。このコマンドを実行すると,StoreデータベースのデータがStoreバージョン2.0の形式に変換されます。また,データの保存期間がStoreバージョン2.0の設定に変換されます。
PDレコードタイプとPLレコードタイプのレコードでは,すべてのレコードが10日間保存される条件に設定されます。
PIデータベースのセットアップ後の保存期間は,次の表のようにセットアップ前の保存期間に対応して変換されます。
セットアップ前の保存期間
セットアップ後の保存期間 要約区分 分
(単位:日)時
(単位:日)日
(単位:週)週
(単位:週)月
(単位:月)1分間 1 − − − − 1時間 1 1 − − − 1日間 1 1 1 − − 2日間 2 2 1 − − 3日間 3 3 1 − − 4日間 4 4 1 − − 5日間 5 5 1 − − 6日間 6 6 1 − − 1週間 7 7 1 1 − 1か月間 31 31 5 5 1 1年間 366 366 54 54 12 (凡例) −:指定できない項目です。
なお,PFM - Agent 08-10以降の場合は,各PFM - Agentでの設定値になります。設定値の詳細については,各PFM - Agentのマニュアルを参照してください。
コマンドを実行できるホスト
- PFM - Manager
- PFM - Agent
実行権限
- Windowsの場合
- Administrators権限を持つユーザー
- UNIXの場合
- rootユーザー権限を持つユーザー
格納先ディレクトリ
- Windowsの場合
- インストール先フォルダ\tools\
- UNIXの場合
- /opt/jp1pc/tools/
引数
-key サービスキー
Storeバージョン2.0の機能をセットアップするStoreサービスのサービスキーを指定します。ここで指定できるサービスキーは,PFM - Agentのサービスキーだけです。PFM - Agentのサービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。
-inst インスタンス名
Storeバージョン2.0の機能をセットアップするインスタンス名を指定します。1〜32バイトの半角英数字で指定します。
このオプションは,Storeバージョン2.0の機能をセットアップするStoreサービスが,マルチインスタンスエージェントのStoreサービスの場合は必ず指定してください。シングルインスタンスエージェントの場合は指定できません。
-lhost 論理ホスト名
Storeバージョン2.0の機能をセットアップするStoreサービスの論理ホスト名を指定します。1〜32バイトの半角英数字で指定します。
このオプションを省略した場合は,物理ホストのStoreサービスにセットアップを行います。
注意事項
- コマンドを実行する前に,セットアップ対象となるPFM - Agentサービスだけ停止する必要があります。コマンド実行前にPFM - Agentサービスを停止してください。
- コマンドを実行する前に,データのバックアップを取得しておくことをお勧めします。
- コマンドの実行には,実行前のStoreデータベースが占有しているディスク容量と同量の空きディスク容量が必要です。
- コマンドを実行したあと,保存期間の設定を見直してください。PDレコードタイプやPLレコードタイプのレコードでは,保存期間がすべて10日に設定されるので注意してください。
戻り値
0 正常終了した。 1 引数の指定に誤りがある。 2 コマンドの実行権限がない。 4 指定されたサービスが停止されていない。 5 指定されたエージェントがインストールされていない。 10 コマンドが実行中である。 12 指定されたStoreサービスのバージョンがセットアップ処理の対象外である。 100 Performance Managementの環境が不正である。 102 指定された論理ホストまたはインスタンスがセットアップされていない。 200 メモリーが不足している。 210 ディスク容量が不足している。 211 ファイルまたはディレクトリにアクセスできない。 255 予期しないエラーが発生した。
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.