Hitachi

 Hitachi Application Server V10 コマンドリファレンス（Windows®用）

5.2.2　cprfstart

PRFデーモンの開始

書式

cprfstart [-h] [-PRFID PRF識別子] [-PrfTraceLevel
    PRFトレース取得レベル[,[PRFトレース取得レベル]...]]
    [-PrfTraceCount PRFトレースファイル数]
    [-PrfTraceFileSize PRFトレースファイルサイズ] 
    [-PrfTraceBufferSize PRFトレースバッファーサイズ]
    [-PrfRemakeBuffer] [-PrfNoBackUp [0|1]] [-PrfConsole {0|1}]
    [-PrfLogShiftTime PRFログシフト時刻]
    [-PrfLogFileSize PRFログサイズ] [-PrfLogFileCount PRFログ最大個数]

格納先

Application Serverインストールディレクトリー\common\PRF\bin\

機能

PRFデーモン（cprfd）を起動します。なお、PRFデーモンは、ほかのプロセスよりも先に起動してください。

PRFデーモンは開始後にカレントディレクトリーを移動します。移動先は、次のディレクトリーです。

PRFトレース出力ディレクトリー%PRFSPOOL%\utt\prf\PRF識別子\

実行権限

前提条件

環境変数

引数

-h

コマンドの使用方法を表示します。

-PRFID PRF識別子

PRF識別子には、asadminのcreate-prfサブコマンドでPRFを構築したときに付けたPRFサーバの名称を指定します。PRF識別子は1〜31文字の英数字、またはアンダースコア（_）で指定します。"TSC"や"tsc"、または"CTM"や"ctm"で始まる文字列は指定しないでください。

デフォルト値：PRF_ID

-PrfTraceLevel PRFトレース取得レベル [,[PRFトレース取得レベル]...]

-PrfTraceLevelを省略した場合は標準レベルで情報を出力します。

PRFトレース取得レベルを4バイトの16進数（8桁の値）で指定します。ここで4バイトの16進数の先頭に0xを付けることができますが、0xは無視されます。

各インデックス番号のレベル値をコンマ（,）区切りで左から複数指定できます。レベル値の指定を省略する場合は、値を記述しないでください。また、あるインデックス番号以降の値をすべて指定しない場合は、コンマ（,）の記述を省略してください。インデックス番号1のトレース取得レベルを（1）、インデックス番号2のPRFトレース取得レベルを（2）とした場合、PRFトレース取得レベルは「（1）,（2）,...」と指定します。

PRFトレース取得レベルの指定例を次に示します。

PRFトレース取得レベルの指定例

オプションの指定

インデックス番号1のPRFトレース取得レベルを指定する

-PrfTraceLevel 0x44445555

インデックス番号1とインデックス番号2のPRFトレース取得レベルを指定する

-PrfTraceLevel 0x44445555,0x55554444

インデックス番号2のPRFトレース取得レベルを指定する

-PrfTraceLevel ,0x55554444

各機能レイヤーでのPRFトレース取得レベルの割り当てについて説明します。

PRFトレース取得レベルは、インデックスごとに8桁の16進数で指定します。それぞれの桁には、機能レイヤーが2つずつ割り当てられています。16進数を2進数にした場合の上位2ビットに割り当てられている機能レイヤーを上位レイヤー、下位2ビットに割り当てられている機能レイヤーを下位レイヤーといいます。

桁ごとの上位レイヤー、下位レイヤーに割り当てられている機能レイヤーについて、次の表に示します。

インデックス

桁番号

上位レイヤー

下位レイヤー

インデックス1

1桁目

（なし）

Java EE Server

2桁目

（なし）

Java VM

5桁目

（なし）

uCosminexus TP1 Connector、TP1/Client/J

PRFトレース取得レベルを指定する場合は、桁ごとの上位レイヤー、下位レイヤーのPRFトレース取得レベルを「標準」「詳細」「保守」のどのレベルで取得するかを決め、それを16進数で指定します。上位レイヤーと下位レイヤーのPRFトレース取得レベルの組み合わせと指定値の対応を、次の表に示します。

なお、保守レベルは、障害発生時などの保守情報を取得するためのレベルです。通常は指定しないでください。

表5‒1　詳細レベルまたは保守レベルのトレース情報を取得する場合の指定値（cprfstartコマンド）

上位レイヤー

下位レイヤー

指定値

標準

標準

0

標準

詳細

1

標準

保守

2

詳細

標準

4

詳細

詳細

5

詳細

保守

6

保守

標準

8

保守

詳細

9

保守

保守

a

PRFトレース取得レベルの指定例を、次の表に示します。

インデックス

指定例

説明

インデックス1

00000000

インデックス1の各機能レイヤーの標準レベルのトレース情報を取得します。

10000000

Java EE Serverだけ詳細レベルのトレース情報を取得して、ほかの機能レイヤーは標準レベルのトレース情報を取得します。

11000000

Java EE ServerおよびJava VMの詳細レベルのトレース情報を取得します。
-PrfTraceCount PRFトレースファイル数

PRFトレースファイルの面数を3〜256の範囲で指定します。

正常停止中と前回強制停止後の再起動中に、PRFトレースファイルをバックアップします。PRFトレースファイルサイズの合計値が大きい場合、バックアップ処理でPRFデーモンの起動や停止に時間が掛かることがあります。そのため、ドメイン管理サーバでプロセス監視する場合、デフォルトの監視時間ではタイムアウトが発生する場合があります。タイムアウトが発生した場合には、監視時間を長くしてください。

デフォルト値：4

-PrfTraceFileSize PRFトレースファイルサイズ

PRFトレースファイルの１ファイル当たりの最大容量を1024〜1048576（単位：キロバイト）の範囲で指定します。ファイル容量を1メガバイトとする場合、1024と指定します。実際のファイルサイズは、この値より多少の増減があります。増減の中で増分の幅は、最大で「-PrfTraceBufferSize指定値−32キロバイト」です。

-PrfNoBackUpオプションに0を指定した場合、正常停止中と前回強制停止後の再起動中に、PRFトレースファイルをバックアップします。PRFトレースファイルサイズの合計値が大きい場合、バックアップ処理でPRFデーモンの起動や停止に時間がかかることがあります。そのため、-PrfNoBackUpオプションに0を指定してドメイン管理サーバでプロセス監視する場合、デフォルトの監視時間ではタイムアウトが発生する場合があります。タイムアウトが発生した場合には、監視時間を長くしてください。

デフォルト値：8192

デフォルト値の8192より小さい値を指定する場合は、-PrfTraceBufferSizeもデフォルト値より小さい値を指定してください。

-PrfTraceBufferSize PRFトレースバッファーサイズ

共用メモリーに確保するバッファーサイズを512〜102400（単位：キロバイト）の範囲で指定します。このオプションには、-PrfTraceFileSizeで指定した値よりも大きい値は指定できません。

バッファー領域が不足するとKFCT26999-Wメッセージが出力され、PRFトレースが欠落する場合があります。そのため、メッセージが出力されなくなるまでバッファー領域を拡張してください。

デフォルト値：8192

-PrfRemakeBuffer

共用メモリーを再作成して起動します。再作成できない場合にはエラーとなります。

-PrfNoBackUp [0|1]

PRFデーモンの起動時、および停止時にPRFトレースファイルをバックアップするかを指定します。

値に0を指定した場合、PRFトレースファイルをバックアップします。PRFトレースファイルをコピーするため、PRFデーモンの起動、および停止に時間が掛かることがあります。障害発生後、PRFトレースがラップするまでの間にPRFトレースファイルを採取できない場合は、値に0を指定してください。なお、ドメイン管理サーバを使用している時は、障害発生後にPRFトレースファイルを含むsnapshotログを自動的に収集します。

値に1を指定した場合、PRFトレースファイルをバックアップしません。

PRFトレースファイルをバックアップするタイミング、バックアップの有無、および-PRFNoBackUpオプションの関係は次のようになります。

実行コマンド

前回開始したPRFデーモンの終了状態

PRFトレースファイルのバックアップ

-PrfNoBackUp 0

-PrfNoBackUp 1

cprfstart

正常終了

しない

しない

強制終了または異常終了

する

しない

cprfstop

終了状態に依存しない

する

しない

cprfstop -Force

終了状態に依存しない

しない

しない

デフォルト値：1

-PrfConsole {0|1}

Windowsのデスクトップからcprfstartコマンドを実行した場合、PRFデーモンのDOSプロンプトを表示するかどうかを指定します。このオプションはWindows以外のOSでは効果はありません。

指定できる値を次に示します。

  • 1

    DOSプロンプトを表示します。

  • 0

    DOSプロンプトを表示しません。

デフォルト値：0

-PrfLogShiftTime PRFログシフト時刻

PRFが出力するログファイルを時刻でシフトさせる場合のシフト時刻を指定します。ログのシフトは、ログファイルにログを出力するタイミングでシフトします。このため、ログの出力がない場合、ログはシフトされません。

指定できる値を次に示します。

  • 000000〜235959

デフォルト値：000000

-PrfLogFileSize PRFログサイズ

PRFが出力するログファイルサイズの上限をメガバイト単位で指定します。

指定できる値を次に示します。

  • 1〜100

デフォルト値：10

-PrfLogFileCount PRFログファイル最大個数

PRFが出力するログファイルの最大個数を指定します。

指定できる値を次に示します。

  • 1〜32

デフォルト値：8

戻り値

戻り値

説明

0

PRFデーモンが正常に起動しました。

1

PRFデーモンの起動に失敗しました。PRFSPOOL環境変数が設定されていません。

上記以外

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと、再度コマンドを実行してください。エラーメッセージは標準エラー出力、ログファイルに出力します。

注意事項

ページの先頭へ

Copyright (C) 2014, 2017, Hitachi, Ltd.

Copyright (C) 2013, Oracle and/or its affiliates. All rights reserved.