パッチ適用、パッチ配付、パラメーター設定、スクリプト実行、および、構成変更で、業務サーバに以下のスクリプト、または、コマンドを実行できます。
パッチ適用、パッチ配付、および、パラメーター設定の実行前／実行後スクリプト
スクリプト実行のスクリプト
構成変更のスクリプト実行、または、コマンド実行
実行するスクリプト、および、コマンドの注意事項を以下に示します。
スクリプト作成、および、コマンド指定時の注意事項
スクリプト、および、コマンドで使用できる復帰値について
スクリプトは、“0”を正常、“0”以外を異常として復帰値を出力するように作成することを推奨します。なお、復帰値に159～240の値は使用できません。
スクリプトのファイル名について
スクリプトのファイル名に使用できる文字列は、155文字以内の半角英数字、半角空白、および以下の記号です。
~ _ - . ( )
155文字を超えるファイル名のスクリプトを指定した場合、スクリプト実行時にエラーとなる場合があります。
なお、Windowsの場合は、スクリプトの拡張子を“.bat”または“.cmd”としてください。PowerShellで作成されたシェル・スクリプトは実行できません。
異なるプラットフォーム間でスクリプトを作成する場合の注意事項
異なるプラットフォーム間でスクリプトを作成する際は、OSに合わせて改行コードの変換が必要です。
Windowsでは改行コードはCRLF（キャリッジリターン＋ラインフィード）です。
Linuxでは改行コードはLF（ラインフィード）です。
使用できないコマンドについて
以下のコマンドはスクリプト内、および、コマンドから実行しないでください。これらのコマンドを実行すると、業務サーバにおいてスクリプト処理、および、コマンド処理が待機状態となり、スクリプトの処理が完了しない場合があります。
対話型処理が必要なコマンド【Windows/Linux/Solaris】
OSの再起動や停止が発生するコマンド【Windows/Linux/Solaris】
実行するとウィンドウが起動するコマンド【Windows】
ATコマンド【Windows】
フルスクリーン系のコマンド【Linux/Solaris】
実行ユーザーについて
スクリプト、および、コマンドは、業務サーバのOSの以下のユーザーで実行されます。
【Windows】LocalSystemアカウント
【Linux/Solaris】root
シングルユーザーモードについて【Linux/Solaris】
シングルユーザーモードでスクリプトまたはコマンドの実行時に、FJSVsglcfというサービスが自動登録されます。事前にFJSVsglcfというサービスが登録されていないことを確認してから実行してください。また、スクリプトまたはコマンドの実行後、FJSVsglcfのサービスは自動的に削除されます。
シングルユーザーモードへの切り替え時に、シングルユーザーモード用の以下のファイルが自動生成されます。元のファイルは、ファイル名の末尾に"_FJSVsglcf"が付加されたファイルに退避され、スクリプトまたはコマンドの実行後に退避されたファイルが復元されます。そのため、シングルユーザーモードで実行するスクリプトおよびコマンド内で、退避されたファイルを削除しないようにしてください。
【Linux】
Red Hat Enterprise Linux 5またはRed Hat Enterprise Linux 6の場合
/etc/inittab
Red Hat Enterprise Linux 7の場合
/etc/systemd/system/default.target
シングルユーザーモードへの切り替え、およびシングルユーザーモードからの切り替え時に、OSの再起動が行われます。以下に注意してください。
パッチ配付の実行後スクリプトをシングルユーザーモードで実行する場合、実行後スクリプトでOSの再起動が行われるため、ジョブ依頼時にOS再起動を指定する必要はありません。
global zoneに対してシングルユーザーモードでスクリプトまたはコマンドを実行する場合、global zoneのOSの再起動により、non-global zoneが停止または再起動されます。【Solaris】
対象サーバでシングルユーザーモードでのスクリプトまたはコマンドの実行を含むジョブが待機中、実行中または選択中(異常)の場合、新たにシングルユーザーモードでのスクリプトまたはコマンドの実行を含むジョブを依頼することはできません。
シングルユーザーモードで実行されたスクリプトまたはコマンドが1時間以内に完了しない場合、ジョブがエラー終了します。シングルユーザーモードでスクリプトまたはコマンドを実行する場合、1時間以内で完了するスクリプトまたはコマンドを指定してください。
非同期実行について【Windows/Linux/Solaris】
コマンド実行で非同期を使用する場合の注意事項を、以下に説明します。
正常復帰値の指定
非同期実行でコマンドを実行する場合、正常復帰値の指定は無視されます。
標準出力、標準エラー出力および復帰値の確認
非同期実行でコマンドを実行すると、ジョブ管理で標準出力、標準エラー出力、および復帰値を確認できません。
業務サーバがWindowsの場合は、業務サーバのログ(swcfmga_configuration_log)で標準出力および標準エラーを確認できます。業務サーバがLinuxおよびSolarisの場合は、業務サーバのログ(swcfmga_configuration_log)で標準出力、標準エラー、および復帰値を確認できます。
後処理でエラーや問題が発生する可能性がある
構成変更は、1つのサーバに複数の処理(コマンド実行、ファイル転送など)を連続して実施できます。前処理でコマンド実行の非同期を実施すると、後処理でエラーや問題が発生する可能性があります。
エラーや問題が発生する組み合わせを、以下に示します。
前処理： コマンド実行で非同期、かつマルチユーザーモード
後処理： コマンド実行またはスクリプト実行でシングルユーザーモード (問題)
後処理はシングルユーザーモードに遷移するために、OSを再起動します。前処理で実施した非同期のコマンド実行を中断する可能性があります。
後処理：OS再起動 (問題)
後処理はOSを再起動します。前処理で実施した非同期のコマンド実行を中断する可能性があります。
前処理： コマンド実行で非同期、かつシングルユーザーモード
後処理： サーバ稼働確認以外 (エラー)
前処理はシングルユーザーモードで非同期のコマンド実行を実施しています。その間にサーバ稼働確認以外の処理を実行できないため、処理がエラーになります。
後処理： サーバ稼働確認 (問題)
前処理はシングルユーザーモードで非同期のコマンド実行を実施しています。その間に後処理でサーバ稼働確認を実施すると、稼働していないと復帰します。
エラーや問題が発生する組み合わせを、以下に表で示します。
処理種別 | 後処理 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
コマンド実行 | スクリプト実行 | サーバ | OS再起動 | ファイル配布 | ファイル収集 | ||||||||
処理種別 | シングル | マルチ | シングル | マルチ | シングル | ||||||||
非同期 | 同期 | 非同期 | 同期 | 非同期 | |||||||||
前処理 | コマンド実行 | マルチ | 同期 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
非同期 | ○ | ○ | △ | △ | ○ | △ | ○ | △ | ○ | ○ | |||
シングル | 同期 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ||
非同期 | × | × | × | × | × | × | △ | × | × | × | |||
スクリプト実行 | マルチユーザー | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ||
シングルユーザー | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | |||
サーバ稼働確認 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | |||
OS再起動 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | |||
ファイル配布 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | |||
ファイル収集 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | |||
○： 問題なし
△： 問題が発生する可能性あり
×： エラーが発生する
エラー発生時のログ出力例
スクリプト、および、コマンドのエラー判定は、以下から選択できます。構成変更のスクリプト実行、および、コマンド実行は、正常と判断する復帰値を指定できます。
0を正常、0以外を異常と判断します。
全ての復帰値を正常と判断する。
スクリプト、および、コマンドが異常となった場合、ジョブの状態が"選択中(異常)"となります。[ジョブ管理]画面内の処理詳細で、スクリプトおよびコマンドの復帰値、標準出力、および、標準エラーが表示されます。この値を参考にして、スクリプトおよびコマンドの見直しを実施してください。
タイムアウト発生時の対処方法
スクリプト、および、コマンドの処理がハングアップなどにより終了しなくなった場合、または処理の途中で業務サーバが停止した場合、処理開始から12時間後にタイムアウトエラーとなり[処理詳細]画面に下記メッセージが表示されます。また、ジョブの状態が"選択中(異常)"となります。スクリプトおよびコマンドの見直しを行い、再試行、継続、または中止の操作を行ってください。
CFMGP20008 コマンド実行処理で異常が発生しました。[復帰値:0][コマンド:指定したスクリプトまたはコマンド][詳細:The operation component was successful.]
スクリプトの添付例
管理コンソールの[ジョブ管理]画面内の処理詳細で、登録したスクリプトをダウンロードすることができます。
以下に例を示します。
