jpcdbctrl setup

形式

jpcdbctrl setup    -key サービスキー
                  [-inst インスタンス名
                  [-lhost 論理ホスト名

機能

jpcdbctrl setupコマンドは,Storeバージョン2.0の機能をセットアップするコマンドです。このコマンドを実行すると,StoreデータベースのデータがStoreバージョン2.0の形式に変換されます。また,データの保存期間がStoreバージョン2.0の設定に変換されます。

PDレコードタイプとPLレコードタイプのレコードでは,すべてのレコードが10日間保存される条件に設定されます。

PIデータベースのセットアップ後の保存期間は,次の表のようにセットアップ前の保存期間に対応して変換されます。

セットアップ前の保存期間
 
 
セットアップ後の保存期間
要約区分

(単位:日)

(単位:日)

(単位:週)

(単位:週)

(単位:月)
1分間1
1時間11
1日間111
2日間221
3日間331
4日間441
5日間551
6日間661
1週間7711
1か月間3131551
1年間366366545412

(凡例) -:指定できない項目です。

なお,PFM - Agent 08-10以降の場合は,各PFM - Agentでの設定値になります。設定値の詳細については,各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サービスにセットアップを行います。

注意事項

戻り値

0正常終了した。
1引数の指定に誤りがある。
2コマンドの実行権限がない。
4指定されたサービスが停止されていない。
5指定されたエージェントがインストールされていない。
10コマンドが実行中である。
12指定されたStoreサービスのバージョンがセットアップ処理の対象外である。
100Performance Managementの環境が不正である。
102指定された論理ホストまたはインスタンスがセットアップされていない。
200メモリーが不足している。
210ディスク容量が不足している。
211ファイルまたはディレクトリにアクセスできない。
255予期しないエラーが発生した。