■実行に必要な権限
【Windows版】
Administratorsグループに所属するユーザ権限が必要です。
【UNIX版】
システム管理者(スーパ・ユーザ)権限が必要です。
■実行環境
Enterprise Manager/Manager/Proxy Manager/Agentで実行可能です。
■記述形式
【Windows版】
<インストールディレクトリ>\bin\sqcSetPolicy.exe [-h <host name>] |
【UNIX版】
/opt/FJSVssqc/bin/sqcSetPolicy.sh [-h <host name>] |
■機能説明
ポリシーを適用します。-h オプションでシステム名を設定することができます。-h オプションを省略した場合は、ホスト名が設定されます。
ポイント
本バージョン(Systemwalker Service Quality Coordinator V13.3.0)からは、ポリシー適用コマンド実行時にサービス/デーモンの事前停止は不要となります。
ただし、サービス/デーモンが動作中で各ミドルウェア等の性能データがが収集中であった場合、それらはポリシー適用の実施中は一時的に停止され、終了後に再収集を開始します。
なお、-hオプションを使用する場合は、サービス/デーモンの停止が必要です。「第2章 常駐プロセス、起動と停止」 を参照して、サービス/デーモンを停止した上で実行してください。
■オプション
以下のようなクラスタ運用を行っており、管理対象のシステム名を変更したい場合には、本オプションで設定したいシステム名を指定します。
Managerで、かつManagerのサーバ内リソース情報を収集する場合(現用系と待機系のシステム名をひとつで管理したい場合)
Agentで、かつノード名引継ぎを実施しているシステムを別々の名前で管理したい場合
注意
既に本製品の運用環境が存在し、一度Agentが登録してある状況において、当コマンドの再投入またはAgentを再インストールする場合に、 -h オプションを使用する場合には、以前に使用していたシステム名を使用してください。
システム名を変更する必要がある場合には、「1.7.3 sqcPDBerase (データ削除コマンド)」で説明するデータ削除コマンドで、以前のシステム名の情報をPDBより削除してから行ってください。ただしこの場合、以前に取得された性能情報は参照できなくなります。
■終了ステータス
正常終了 0
異常終了 1
正常終了した場合には、以下のメッセージを出力します。
(Success) : sqcSetPolicy succeeded. |
sqcSetPolicyを実行したサーバに管理対象となるミドルウェアが検出された場合、以下のメッセージを出力します。
The policy has been set for the <middleware name> (Success) : sqcSetPolicy succeeded. |
<middleware name>には検出されたミドルウェアが表示されます。
異常終了した場合には、以下のメッセージを出力します。
(Error) : The file was not able to be created because of insufficient file access rights or disk space. |
ファイルアクセスエラー(アクセス権やディスクの空きなし等)です。
(Error) : There is an error in section [Section : XXX] of the template file sqcSetPolicy Template define error. |
テンプレートの定義に誤りがあります。
(Error) : DCM is running and so sqcSetPolicy can not be run. Please stop dcm and retry sqcSetPolicy. |
DCMサービス/デーモンが起動しています。
(Error) : There is no available policy to apply. |
適用する有効なポリシーが一つもありません。(sqcRPolicy/sqcAPolicyがまだ実行されていません)
注意
これらのエラーメッセージが表示された場合、その前に表示されたポリシー設定のメッセージのポリシーは有効になりません。
■使用例
【Windows版】
正常終了の場合 C:\Program Files\SystemwalkerSQC\bin>sqcSetPolicy This Computer Name is "XXXX" The policy has been set for the <YYYY> (Success) : sqcSetPolicy succeeded.
異常終了の場合 C:\Program Files\SystemwalkerSQC\bin>sqcSetPolicy This Computer Name is "XXXX" (Error ) : There is an error in section [Section:ZZZZ] of the template file. |
【UNIX版】
正常終了の場合 # cd /opt/FJSVssqc/bin/ # ./sqcSetPolicy.sh This Host Name is "XXXX" The policy has been set for the <YYYY> (Success) : sqcSetPolicy succeeded.
異常終了の場合 # cd /opt/FJSVssqc/bin/ # ./sqcSetPolicy.sh This Host Name is "XXXX" (Error) : There is an error in section [Section : ZZZZ] of the template file sqcSetPolicy Template define error. |
XXXXは、-h オプションで指定した名前が表示されます。-h オプションが省略された場合は、本コマンドを実行したシステムのホスト名が表示されます。
YYYYは、検出されたミドルウェアが表示されます。この行は、検出されたミドルウェア数分表示されます。
ZZZZは、テンプレートファイルにおいて定義に誤りのあるセクション名です。
■ファイル
本コマンドが成功すると、管理対象構成情報ファイルに記述された内容に応じて、以下のファイルが生成されます。
【Windows版】
<可変ファイル格納ディレクトリ>\control\ManagedConf_XXXX.xml |
XXXXは、-h オプションで指定した名前です。-h オプションが省略された場合は、本コマンドを実行したシステムのコンピュータ名です。
【UNIX版】
/etc/opt/FJSVssqc/ManagedConf_XXXX.xml |
XXXXは、-h オプションで指定した名前です。-h オプションが省略された場合は、本コマンドを実行したシステムのホスト名です。
ポイント
ポリシーを適用した後は、サービス/デーモンの起動、および、コンソールへの構成情報の取得反映操作が必要です。
起動については、「第2章 常駐プロセス、起動と停止」を、構成情報の取得反映操作については使用手引書(コンソール編)「1.2.2.3 Agents」をそれぞれ参照してください。