1.1.7 sqcCtrlPolicy(ポリシーリモート操作コマンド)

■機能説明

配付先サーバに対して、運用管理クライアント上からリモートでポリシーの作成と適用を行います。

収集ポリシーの作成（sqcRPolicy：サーバ内リソース情報収集ポリシー）
収集ポリシーの作成（sqcAPolicy：レスポンス/稼働情報収集ポリシー）
収集ポリシーの適用（sqcSetPolicy）

注意

本コマンドは複数同時に実行しないでください。

ポイント

Systemwalker Service Quality Coordinator V13.3.0以降は、ポリシー適用コマンド実行時にサービス/デーモンの事前停止は不要です。

ただし、サービス/デーモンが動作中で各ミドルウェア等の性能データが収集中であった場合、それらはポリシー適用の実施中は一時的に停止され、終了後に再収集を開始します。

■実行に必要な権限

Administratorsグループに所属するユーザー権限が必要です。

注意

Windows Server 2008/Windows Vista以降の場合は、管理者権限で実行してください。

■実行環境

運用管理クライアントで実行可能です。

■記述形式

<運用管理クライアントインストールディレクトリ>\bin\sqcCtrlPolicy.exe

-e <操作コマンド種別> {-g <ポリシー配付グループ>,・・・ | -s <サーバ名>,・・・}

■オプション

-e <操作コマンド種別>

リモート操作するコマンド種別を指定します。

AP：収集ポリシー作成コマンド（sqcAPolicy：レスポンス/稼働情報収集ポリシー）
RP：収集ポリシー作成コマンド（sqcRPolicy：サーバ内リソース情報収集ポリシー）
SP：収集ポリシー適用コマンド（sqcSetPolicy)

-g <ポリシー配付グループ>: ポリシー配付グループフォルダ名を指定します。

-s <サーバ名>: リモート操作先のサーバを指定します。

■復帰値

0:正常終了

1:パラメーターエラー

2:サーバ処理エラー

3:通信エラー

10 :その他のエラー

エラーの詳細については、エラーメッセージを参照してください。

複数のエラーが発生した場合は、復帰値の最大値が帰ります。

例えば、リモート操作実行先サーバＡでサーバ処理エラー/リモート操作実行先サーバＢでその他エラーが発生した場合は、10が復帰値として帰ります。

■実行結果/出力形式

正常終了

標準出力に対し、正常終了メッセージを出力します。

(Success) : sqcCtrlPolicy succeeded.,000,サーバ名,時刻

-- リモート実行コマンド名 Command Log Start ----

～コマンド実行の結果～

-- リモート実行コマンド名 Command Log End ----

実行例

以下の定義でポリシーリモート操作を実施した場合

【操作サーバ】
wasabi1, wasabi2

【操作コマンド】
収集ポリシー作成（sqcRPolicy）

(Success) : sqcCtrlPolicy succeeded.,000,wasabi1,2007-12-25 00:00:00

-- sqcRPolicy Command Log Start ----

(Success) : Middleware product <Interstage Application Server> has been detected.

The configuration definitions for the detected middleware has been added.

(Success) : sqcRPolicy succeeded.

-- sqcRPolicy Command Log End ----

(Success) : sqcCtrlPolicy succeeded.,000,wasabi2,2007-12-25 00:00:00

-- sqcRPolicy Command Log Start ----

(Success) : Middleware product <Interstage Application Server> has been detected.

The configuration definitions for the detected middleware has been added.

(Success) : sqcRPolicy succeeded.

-- sqcRPolicy Command Log End ----

異常終了

標準エラー出力に対し、エラーメッセージを出力します。

(Error) ：メッセージ, エラー番号,サーバ名,時刻

-- リモート実行コマンド名 Command Log Start ----

～コマンド実行の結果～

-- リモート実行コマンド名 Command Log End ----

エラーメッセージと対応するエラー番号

エラー番号	メッセージ	内容
010	parameter error.(エラー詳細コード)	パラメーターの指定エラー
020	Server access error.(エラー詳細コード)	サーバ処理エラー
030	aborted connection error.(エラー詳細コード)	通信エラー
100	system error.(エラー詳細コード)	その他何らかのエラー

実行例

以下の定義でポリシーリモート操作を実施した場合

【操作サーバ】
wasabi1

【操作コマンド】
収集ポリシー適用（sqcSetPolicy）

【エラー例】
ファイル操作で失敗した場合

(Error) : system error.(XXX),100, wasabi1,2007-12-25 00:00:00

-- sqcSetPolicy Command Log Start ----

(Error ) : The file was not able to be created because of insufficient file access rights or disk space.

-- sqcSetPolicy Command Log End ----

※XXXは詳細コード

エラー時の対処について

エラー時の状況に応じて、以下の対処を実施します。

エラー番号	内容	対処の方法
010	パラメーターエラー	パラメーターを修正して、再実行
020	サーバ処理エラー	Manager、配付先サーバへの接続状況を確認後、再実行
030	通信エラー	Manager、配付先サーバへの接続状況を確認後、再実行
100	システムエラー	保守情報を採取し、技術員に連絡してください。

■使用例

以下の定義でポリシーリモート操作を実施する場合

【操作サーバ】
wasabi

【操作コマンド】
収集ポリシー作成（sqcRPolicy）

C:\Program Files\Fujitsu\SystemwalkerSQC-C\bin\sqcCtrlPolicy.exe -e RP -s wasabi