配付先サーバに対して、運用管理クライアント上からリモートでポリシーの作成と適用を行ないます。ポリシーの作成と適用は、sqcCtrlPolicy(ポリシーリモート操作コマンド)を実行します。以下、sqcCtrlPolicy(ポリシーリモート操作コマンド)について説明します。
■実行に必要な権限
【Windows版】
Administratorsグループに所属するユーザ権限が必要です。
■実行環境
運用管理クライアントで実行可能です。
■記述形式
<運用管理クライアントインストールディレクトリ>\bin\sqcCtrlPolicy.exe | -e <操作コマンド種別> {-g <ポリシー配付グループ>,・・・ | -s <サーバ名>,・・・} |
■機能説明
指定のサーバに対して、指定のコマンドを実行します。
本コマンドは、以下の場合に使用します。
収集ポリシーの作成（sqcRPolicy：サーバ内リソース情報収集ポリシー）
収集ポリシーの作成（sqcAPolicy：レスポンス/稼働情報収集ポリシー）
収集ポリシーの適用（sqcSetPolicy）
■オプション
リモート操作するコマンド種別を指定します。
AP：収集ポリシー作成コマンド（sqcAPolicy：レスポンス/稼働情報収集ポリシー）
RP：収集ポリシー作成コマンド（sqcRPolicy：サーバ内リソース情報収集ポリシー）
SP：収集ポリシー適用コマンド（sqcSetPolicy)
ポリシー配付グループフォルダ名を指定します。
リモート操作先のサーバを指定します。
ポイント
本バージョン（Systemwalker Service Quality Coordinator V13.3.0）からは、ポリシー適用コマンド実行時にサービス/デーモンの事前停止は不要となります。
ただし、サービス/デーモンが動作中で各ミドルウェア等の性能データがが収集中であった場合、それらはポリシー適用の実施中は一時的に停止され、終了後に再収集を開始します。
■復帰値
0:正常終了
1:パラメタエラー
2:サーバ処理エラー
3:通信エラー
10 :その他のエラー
エラーの詳細については、エラーメッセージを参照してください。
複数のエラーが発生した場合は、復帰値の最大値が帰ります。
例えば、リモート操作実行先サーバＡでサーバ処理エラー/リモート操作実行先サーバＢでその他エラーが発生した場合は、10が復帰値として帰ります。
■使用例
以下の定義でポリシーリモート操作を実施する場合
【操作サーバ】
wasabi
【操作コマンド】
収集ポリシー作成（sqcRPolicy）
C:\Program Files\SystemwalkerSQC-C\bin\sqcCtrlPolicy.exe -e RP -s wasabi |
■実行結果/出力形式
正常終了
標準出力に対し、正常終了メッセージを出力します。
(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 | システムエラー | 保守情報を採取し、技術員に連絡してください。 |
