Interstage Application Server 運用ガイド(基本編)

4.2.5.1 スクリプトサンプルの概要

■格納場所

サンプルは以下にあります。

C:\Interstage\sample\softwaredelivery\isapplyresource.bat

/opt/FJSVisas/sample/softwaredelivery/isapplyresource.sh

　Windows Server 2003 for Itanium-based Systemsのサーバに対しては、Systemwalker Software Deliveryと連携しての資源配布は行えないため、スクリプトサンプルはInterstageに同梱されていません。

■記述形式

　サンプルにはInterstageのアプリケーション配備の手順が命令として記述されています。
　各処理は、処理内容により以下の形式でコメントが付けられています。

rem ============================================
rem 数字. 英語の説明文
rem ============================================

#============================================
# 数字. 英語の説明文
#============================================

■使用方法

• 下記の“処理概要”から使用する機能を判断し、それ以外の部分は削除またはコメントアウトして使用してください
• 必要に応じて、その他のカストマイズを行ってください

■処理概要

　各処理の概要を説明します。

コメント	処理内容
1. Set ON or OFF	IS_START Interstageを起動する場合は"ON"、起動しない場合は"OFF"を指定します。 IS_OPERATION_TOOL_START Interstage Operation Toolを起動する場合は"ON"、起動しない場合は"OFF"を指定します。 資源の適用方法にIPL適用を選択する場合のみ、"ON"を指定します。
2. Set information of WorkUnit and environment	STORAGE_DIR Systemwalker Software Deliveryにより資源が適用されるパスを記述します。 LOG_FILE_DIR スクリプトの実行結果を出力するログファイルが作成されるパスを指定します LOG_FILE 上記のログファイル名を指定します。 各テキストファイルの指定 スクリプトを実行するための引数となる定義ファイルを指定します。 詳細については"スクリプトサンプルを実行するための定義ファイルの記述方法"を参照してください。 LD_LIBRARY_PATH 「9. Update EJB Application Definition」でEJBアプリケーション環境定義の更新を行うための環境変数を指定します。 詳細については"J2EE ユーザーズガイド"の"動作環境の確認"の"EJBサービス運用コマンドを利用する場合の設定"を参照してください。
3. Environment Check	実行環境のチェック
4. Start Interstage	Interstageを起動します
5. Stop WorkUnit	ワークユニットを停止します。 指定されたワークユニットがすでに停止している場合は処理に失敗します。
6. Undeploy J2EE Module	J2EEアプリケーションを配備解除します。
7. Deploy J2EE Module	J2EEアプリケーションを配備します。
8. Update Name Conversion File	名前変換定義を更新します
9. Update EJB Application Definition	EJBアプリケーション環境設定を更新します
10. Update Web Server Connector	Webサーバコネクタの環境設定を更新します。 指定されたWebサーバコネクタ定義が存在しない場合は処理に失敗します。
11. Start WorkUnit	ワークユニットを起動します。 ワークユニットがすでに起動している場合は処理に失敗します。
12. Notify Result	Systemwalker Software Deliveryに結果を通知します

■ログ出力

スクリプト内で指定されたファイルに出力されます。詳細は処理概要を参照してください。

　“Update Name Conversion File”（名前変換定義の更新）はOSのコマンドによって行われるため、Interstage Application Serverのメッセージはログ出力されません。

■資源配付・適用時に必要な資源一覧

　サンプルスクリプトを使用して資源の配付・適用を行なう際に必要な資源の一覧を以下に示します。資源配付・適用時に必要な資源でスクリプトサンプルを実行するための定義ファイル以外の資源については、“Interstageの配付資源の準備”を参照してください。

コメント	必要な資源
1. Set ON or OFF	必要な資源はありません
2. Set information of WorkUnit and environment	必要な資源はありません
3. Environment Check	必要な資源はありません
4. Start Interstage	Interstage Operation Toolを起動するためのスクリプトファイル
5. Stop WorkUnit	ワークユニットの停止を実行するための定義ファイル（wustop.txt）
6. Undeploy J2EE Module	配備解除を実行するための定義ファイル（undeploy.txt）
7. Deploy J2EE Module	配備を実行するための定義ファイル（deploy.txt） J2EEアプリケーション
8. Update Name Conversion File	名前変換定義の更新を実行するための定義ファイル（nameconvert.txt） 名前変換定義ファイル
9. Update EJB Application Definition	EJBアプリケーション環境定義の更新を実行するための定義ファイル（ejbupdate.txt） Enterprise Bean定義ファイル
10. Update Web Server Connector	Webサーバコネクタの更新を実行するための定義ファイル（updatewebconnector.txt） Webサーバコネクタ定義ファイル
11. Start WorkUnit	ワークユニットの起動を実行するための定義ファイル（wustart.txt）
12. Notify Result	必要な資源はありません

■多階層IJServerの配置先ごとに有効な処理

　多階層IJServerの場合、配置先となる各サーバグループ（または単体運用のサーバ）はWebサーバコネクタ、Servletコンテナ、EJBコンテナのいずれかまたは複数が配置されます。
配置されるIJServerの部分によって、サンプルスクリプトの有効となる処理が異なります。

以下に、配置先ごとに有効は処理の一覧を示します。

コメント	配置先の種類
	Webサーバコネクタ	Servletコンテナ	EJBコンテナ
1. Set ON or OFF	○	○	○
2. Set information of WorkUnit and environment	○	○	○
3. Environment Check	○	○	○
4. Start Interstage	○	○	○
5. Stop WorkUnit	×	○	○
6. Undeploy J2EE Module	×	○	○
7. Deploy J2EE Module	×	○	○
8. Update Name Conversion File	×	○	○
9. Update EJB Application Definition	×	×	○
10. Update Web Server Connector	○	×	×
11. Start WorkUnit	×	○	○
12. Notify Result	○	○	○

　○：有効な処理
　×：無効な処理

■スクリプトサンプルを利用する場合の注意事項

• スクリプトは後スクリプトとして配付してください。後スクリプトについては"Systemwalker Software Delivery 運用手引書"を参照してください。
• スクリプトサンプルを使用する場合、スクリプトサンプルの「2. Set information of WorkUnit and environment」に指定するテキストファイルは、後スクリプトではなく、アプリケーション資源本体の一部として配付する必要があります。
• スクリプトの実行結果のログファイルは、自動的には削除されません。必要に応じて手動で削除する必要があります。
• 「Set information of WorkUnit and environment」で指定する文字列に空白文字列を含む場合でも、値をダブルクォーテーション("")で囲まないでください。
• 資源の適用方法にIPL適用を選択する場合に必要な設定については、資源の適用方法にIPL適用を選択する場合の設定に記載している設定を行なってください。IPL適用については"Systemwalker Software Delivery 運用手引書"を参照してください。