Hitachi

uCosminexus Grid Processing Server 使用の手引


gprasget(障害情報収集コマンド)

〈このページの構成〉

形式

LinuxまたはAIXの場合

gprasget [ -l ] -t 収集情報出力先ディレクトリ [ uGPSディレクトリ ] [ -d データマネージャが管理するデータ格納ディレクトリ] [ -j ジョブマネージャが管理するデータ格納ディレクトリ] [ -n ノードマネージャが管理するデータ格納ディレクトリ1 [ -n ノードマネージャが管理するデータ格納ディレクトリ2]...]

Windowsの場合

gprasget [ -l ] -t 収集情報出力先ディレクトリ [ OpenTP1ディレクトリ ] [ -d データマネージャが管理するデータ格納ディレクトリ] [ -j ジョブマネージャが管理するデータ格納ディレクトリ] [ -n ノードマネージャが管理するデータ格納ディレクトリ1 [ -n ノードマネージャが管理するデータ格納ディレクトリ2]...]

機能

バッチジョブ分散実行システムが異常終了および無応答となった場合などに,障害調査を実施するための資料を一括して収集します。

オプション

-l

SPOOL_DIRパラメータ下のファイルなどの容量の大きい情報は取得しないで,コマンド実行結果などによって得られる情報だけを取得します。このオプションを省略した場合は,すべての保守資料を取得します。

-t 収集情報出力先ディレクトリ

収集した情報をtarのアーカイブファイルとして出力する出力先のディレクトリを指定します。

Linuxの場合

アーカイブファイルの名称は,UGPSM_RAS_ホスト名_yyyymmddhhmmss.tar.gz(ホスト名は情報を取得したホスト名,yyyymmddはコマンドを起動した年月日,hhmmssはコマンドを起動した24時間制のローカルタイムでの時刻)となります。

AIXの場合

アーカイブファイルの名称は,UGPSM_RAS_ホスト名_yyyymmddhhmmss.tar.Z(ホスト名は情報を取得したホスト名,yyyymmddはコマンドを起動した年月日,hhmmssはコマンドを起動した24時間制のローカルタイムでの時刻)となります。

Windowsの場合

収集した情報をディレクトリとして出力する出力先のディレクトリを絶対パスで指定します。

収集した保守情報ファイルを格納するディレクトリの名称は,UGPSM_RAS_ホスト名_yyyymmddhhmmss(ホスト名は情報を取得したホスト名,yyyymmddはコマンドを起動した年月日,hhmmssはコマンドを起動した24時間制のローカルタイムでの時刻)となります。

収集情報出力先ディレクトリは,259文字を超えるとディレクトリ作成エラーになります。なお,このディレクトリに格納するディレクトリやファイルのフルパス名の長さが259文字を超えた場合,そのファイルは収集されません。

uGPSディレクトリ

uGPSディレクトリを指定します。

このオプションの指定とGPDIR環境変数の設定に従って,次のとおりuGPSディレクトリの値が設定されます。

GPDIR環境変数の設定

このオプションの指定

あり

なし

あり

このオプションの指定値

GPDIR環境変数での設定値

なし

このオプションの指定値

デフォルト値(/var/opt/ugpsm)

OpenTP1ディレクトリ

OpenTP1ディレクトリを指定します。

このオプションを省略した場合は,DCDIR環境変数で設定された値が仮定されます。

-d データマネージャが管理するデータ格納ディレクトリ

データマネージャのユーザサービス定義で指定したUGPSM_DIR環境変数の値を指定します。

LinuxまたはAIXの場合

このオプションを省略した場合は,UGPSM_DIR環境変数のデフォルト値(/var/opt/ugpsm)が仮定されます。

Windowsの場合

このオプションを省略した場合は,次に示すUGPSM_DIR環境変数のデフォルト値が仮定されます。

%ALLUSERSPROFILE%\HITACHI\ugpsm

  • %ALLUSERSPROFILE%のデフォルトは「システムドライブ\ProgramData」です。

-j ジョブマネージャが管理するデータ格納ディレクトリ

ジョブマネージャのユーザサービス定義で指定したUGPSM_DIR環境変数の値を指定します。

LinuxまたはAIXの場合

このオプションを省略した場合は,UGPSM_DIR環境変数のデフォルト値(/var/opt/ugpsm)が仮定されます。

Windowsの場合

このオプションを省略した場合は,次に示すUGPSM_DIR環境変数のデフォルト値が仮定されます。

%ALLUSERSPROFILE%\HITACHI\ugpsm

  • %ALLUSERSPROFILE%のデフォルトは「システムドライブ\ProgramData」です。

-n ノードマネージャが管理するデータ格納ディレクトリ

ノードマネージャのユーザサービス定義で指定したUGPSM_DIR環境変数の値を指定します。このオプションを複数指定することで,複数のノードマネージャが管理するデータ格納ディレクトリを指定できます。ノードマネージャが管理するデータ格納ディレクトリは,50まで指定できます。

LinuxまたはAIXの場合

このオプションを省略したときは,UGPSM_DIR環境変数のデフォルト値(/var/opt/ugpsm)が仮定されます。

Windowsの場合

このオプションを省略した場合は,次に示すUGPSM_DIR環境変数のデフォルト値が仮定されます。

%ALLUSERSPROFILE%\HITACHI\ugpsm

  • %ALLUSERSPROFILE%のデフォルトは「システムドライブ\ProgramData」です。

戻り値

LinuxまたはAIXの場合

戻り値

内容

出力メッセージ

0

正常終了

KAKJ1712-I

コマンドが正常終了しました。

1

root権限以外で実行

KAKJ1745-E

rootで実行してください。

2

必須オプションの指定なし,または不当オプションを指定

KAKJ1700-E

オプションの指定に誤りがあります。

3

コマンドの処理で使用するディレクトリまたはファイルが存在しない

KAKJ1559-E

uGPSディレクトリが不正です。

KAKJ1713-E

ファイルが存在しませんでした。

4

次のディレクトリが存在しない

  • uGPSディレクトリ

  • 収集情報出力先ディレクトリ

  • データマネージャが管理するデータ格納ディレクトリ

  • ジョブマネージャが管理するデータ格納ディレクトリ

  • ノードマネージャが管理するデータ格納ディレクトリ

KAKJ1501-E

指定したディレクトリがフルパス指定ではありません。

KAKJ1714-E

ディレクトリが存在しませんでした。

5

圧縮ファイルの作成に失敗

KAKJ1748-E

ファイル出力の処理でエラーが発生しました。

6

一時作業用ディレクトリの作成に失敗

KAKJ1715-E

作業用ディレクトリの作成に失敗しました。

8

内部で呼び出すコマンドでエラーが発生

KAKJ1516-E

ファイルのアーカイブ処理もしくは圧縮処理,またはディレクトリの作成に失敗しました。

KAKJ1738-E

コマンドの実行でエラーが発生しました。

9

ノードマネージャが管理するデータ格納ディレクトリ数の上限を超えている

KAKJ1730-E

指定されたノードマネージャ管理データ格納ディレクトリ数が上限を超えました。

注※ パラメータエラー時には,使用方法を示すKAKJ1772-Iが出力されます。

Windowsの場合

戻り値

内容

出力メッセージ

0

正常終了

KAKJ1712-I

2

パラメータエラー

KAKJ1700-E

  • 必須オプションの指定がありません。

  • 不当なオプションを指定しました。

3

ファイルまたはディレクトリエラー

KAKJ1713-E

OpenTP1ディレクトリまたはDCDIR環境変数に設定されたディレクトリ配下にbin\dcrasgetコマンドが存在しません(処理は続行し,TP1情報以外を採取します)。

4

KAKJ1714-E

次のディレクトリが存在しません(絶対パス指定ではない場合も含みます)。

  • 収集情報出力先ディレクトリ

  • メッセージログ出力先ディレクトリ

  • トレース出力先ディレクトリ

  • グリッドバッチ管理データ格納ディレクトリ

  • スプールディレクトリ

  • エラーログ出力先ディレクトリ

「収集情報出力先ディレクトリ」が存在しないときを除いて,処理は続行し,採取できる情報を採取します。

6

KAKJ1715-E

作業用ディレクトリの作成に失敗しました。

7

KAKJ1716-E

OpenTP1ディレクトリの指定が省略されましたが,DCDIR環境変数が設定されていません(処理は続行し,TP1情報以外を採取します)。

8

内部エラー

KAKJ1901-E

システムコールエラーが発生しました。

KAKJ1902-E

メモリ不足が発生しました。

KAKJ1903-E

プログラム論理エラーが発生しました。

KAKJ1904-E

設定ファイル解析処理でフォーマット不正を検出しました。

9

条件エラー

KAKJ1730-E

指定されたノードマネージャ管理データ格納ディレクトリ数が上限を超えました。

注意事項