形式
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のマニュアルを参照してください。
コマンドを実行できるホスト
実行権限
格納先ディレクトリ
引数
-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サービスにセットアップを行います。
注意事項
戻り値
0 | 正常終了した。 |
1 | 引数の指定に誤りがある。 |
2 | コマンドの実行権限がない。 |
4 | 指定されたサービスが停止されていない。 |
5 | 指定されたエージェントがインストールされていない。 |
10 | コマンドが実行中である。 |
12 | 指定されたStoreサービスのバージョンがセットアップ処理の対象外である。 |
100 | Performance Managementの環境が不正である。 |
102 | 指定された論理ホストまたはインスタンスがセットアップされていない。 |
200 | メモリーが不足している。 |
210 | ディスク容量が不足している。 |
211 | ファイルまたはディレクトリにアクセスできない。 |
255 | 予期しないエラーが発生した。 |