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

4.2.5.2 スクリプトサンプルを実行するための定義ファイルの記述方法

　サンプルスクリプトはスクリプト実行時に、以下の定義ファイルを参照します。

• ワークユニットの起動を実行するための定義ファイル（wustart.txt）
• ワークユニットの停止を実行するための定義ファイル（wustop.txt）
• 配備を実行するための定義ファイル（deploy.txt）
• 配備解除を実行するための定義ファイル（undeploy.txt）
• 名前変換定義の更新を実行するための定義ファイル（nameconvert.txt）
• EJBアプリケーション環境定義の更新を実行するための定義ファイル（ejbupdate.txt）
• Webサーバコネクタの更新を実行するための定義ファイル（updatewebconnector.txt）

• Interstage Operation Toolを起動するためのスクリプトファイル（iplstart.vbs）

　以下に、スクリプトサンプルを実行するための定義ファイルの格納場所と記述方法について記述します。

■格納場所

定義ファイルは以下にあります。

C:\Interstage\sample\softwaredelivery\

/opt/FJSVisas/sample/softwaredelivery/

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

■ワークユニットの起動を実行するための定義ファイル（wustart.txt）

• ワークユニット起動の定義ファイルでは、パラメタとしてワークユニット名を指定します。詳細については“リファレンスマニュアル（コマンド編）”の“isstartwu”を参照してください。
• 「#」で始まる行はコメントとして無視され、「#」以外で始まる行に、ワークユニット名を指定します。
• 複数指定する場合は、改行で区切ってください。
• 空白文字列を含む場合でも、値をダブルクォーテーション("")で囲まないでください。
• 起動するワークユニットが無い場合は、コメント行以外は何も記述しないでください。

#===============================================================================
# WorkUnit Start Definition FILE
# <parameter>
# 1. Name of WorkUnit
#===============================================================================
WU001
WU002

■ワークユニットの停止を実行するための定義ファイル（wustop.txt）

• ワークユニット停止の定義ファイルでは、パラメタとしてワークユニット名を指定します。詳細については“リファレンスマニュアル（コマンド編）”の“isstopwu”を参照してください。
• 「#」で始まる行はコメントとして無視され、「#」以外で始まる行に、ワークユニット名を指定します。
• 複数指定する場合は、改行で区切ってください。
• 空白文字列を含む場合でも、値をダブルクォーテーション("")で囲まないでください。
• 停止するワークユニットが無い場合は、コメント行以外は何も記述しないでください。

#===============================================================================
# WorkUnit Stop Definition FILE
# <parameter>
# 1. Name of WorkUnit
#===============================================================================
WU001
WU002

■配備を実行するための定義ファイル（deploy.txt）

• 配備の定義ファイルでは、パラメタとしてワークユニット名と、配備するモジュールが格納されているパスを指定します。詳細については“リファレンスマニュアル（コマンド編）”の“ijsdeployment”を参照してください。
• 「#」で始まる行はコメントとして無視され、「#」以外で始まる行に、ワークユニット名と配備するモジュールが格納されているパスを「,（カンマ）」区切りで指定します。
• 複数指定する場合は、改行で区切ってください。
• 空白文字列を含む場合でも、値をダブルクォーテーション("")で囲まないでください。
• 配備するモジュールが無い場合は、コメント行以外は何も記述しないでください。

#===============================================================================
# Deploy Definition FILE
# <parameter>
# 1. Name of WorkUnit
# 2. Module Path
#===============================================================================
WU001,C:\temp\petstore\petstore.ear
WU002,C:\temp\CartBean\CartBean.jar

#===============================================================================
# Deploy Definition FILE
# <parameter>
# 1. Name of WorkUnit
# 2. Module Path
#===============================================================================
WU001,/tmp/petstore/petstore.ear
WU002,/tmp/CartBean/CartBean.jar

■配備解除を実行するための定義ファイル（undeploy.txt）

• 配備解除の定義ファイルでは、パラメタとしてワークユニット名と、配備解除するモジュール名を指定します。詳細については“リファレンスマニュアル（コマンド編）”の“ijsundeployment”を参照してください。
• 「#」で始まる行はコメントとして無視され、「#」以外で始まる行に、ワークユニット名と配備解除するモジュール名を「,（カンマ）」区切りで指定します。
• 複数指定する場合は、改行で区切ってください。
• 空白文字列を含む場合でも、値をダブルクォーテーション("")で囲まないでください。
• 配備解除するモジュールが無い場合は、コメント行以外は何も記述しないでください。

#===============================================================================
# Undeploy Definition FILE
# <parameter>
# 1. Name of WorkUnit
# 2. Name of Module
#===============================================================================
WU001,petstore.ear
WU002,CartBean.jar

■名前変換定義の更新を実行するための定義ファイル（nameconvert.txt）

• 名前変換定義更新の定義ファイルでは、パラメタとしてワークユニット名、更新するモジュール名、および名前変換ファイルが格納されているパスを指定します。名前変換定義を更新するための事前準備については名前変換定義ファイルの事前準備を参照してください。
• 「#」で始まる行はコメントとして無視され、「#」以外で始まる行に、ワークユニット名と更新するモジュール名を「,（カンマ）」区切りで指定します。
• 複数指定する場合は、改行で区切ってください。
• 空白文字列を含む場合でも、値をダブルクォーテーション("")で囲まないでください。
• 更新する名前変換定義が無い場合は、コメント行以外は何も記述しないでください。

#===============================================================================
# Name Convert Definition FILE
# <parameter>
# 1. Name of WorkUnit
# 2. Name of Module
# 3. Path of interstage.xml
#===============================================================================
WU001,petstore.ear,C:\temp\petstore\interstage.xml
WU002,CartBean.jar,C:\temp\CartBean\interstage.xml

#===============================================================================
# Name Convert Definition FILE
# <parameter>
# 1. Name of WorkUnit
# 2. Name of Module
# 3. Path of interstage.xml
#===============================================================================
WU001,petstore.ear,/tmp/petstore/interstage.xml
WU002,CartBean.jar,/tmp/CartBean/interstage.xml

■EJBアプリケーション環境定義の更新を実行するための定義ファイル（ejbupdate.txt）

• EJBアプリケーション環境定義更新の定義ファイルでは、パラメタとしてワークユニット名、更新するEJBアプリケーション名、およびEJBアプリケーションの環境定義ファイルが格納されているパスを指定します。EJBアプリケーション環境定義の更新をするための事前準備についてはEnterprise Bean定義ファイルの事前準備を参照してください。
• 「#」で始まる行はコメントとして無視され、「#」以外で始まる行に、ワークユニット名、更新するEJBアプリケーション名、およびEJBアプリケーションの環境定義ファイルを「,（カンマ）」区切りで指定します。
• 複数指定する場合は、改行で区切ってください。
• 空白文字列を含む場合でも、値をダブルクォーテーション("")で囲まないでください。
• 更新するEJBアプリケーション環境定義が無い場合は、コメント行以外は何も記述しないでください。

#===============================================================================
# EJB Application Update Definition FILE
# <parameter>
# 1. Name of WorkUnit
# 2. Name of Application
# 3. Path of EJB application definition file
#===============================================================================
WU001,TheAccount,C:\temp\petstore\TheAccount.xml
WU002,CartBean,C:\temp\CartBean\CartBean.xml

#===============================================================================
# EJB Application Update Definition FILE
# <parameter>
# 1. Name of WorkUnit
# 2. Name of Application
# 3. Path of EJB application definition file
#===============================================================================
WU001,TheAccount,/tmp/petstore/TheAccount.xml
WU002,CartBean,/tmp/CartBean/CartBean.xml

■Webサーバコネクタ定義の更新を実行するための定義ファイル（updatewebconnector.txt）

• Webサーバコネクタ定義更新の定義ファイルでは、パラメタとしてWebサーバコネクタ定義ファイル名を指定します。Webサーバコネクタの更新をするための事前準備についてはWebサーバコネクタ定義ファイルの事前準備を参照してください。
• 「#」で始まる行はコメントとして無視され、「#」以外で始まる行に、Webサーバコネクタ定義ファイル名を「,（カンマ）」区切りで指定します。
• 複数指定する場合は、改行で区切ってください。
• 空白文字列を含む場合でも、値をダブルクォーテーション("")で囲まないでください。
• 更新するWebサーバコネクタ定義が無い場合は、コメント行以外は何も記述しないでください。

#===============================================================================
# Web Server Connector Update Definition FILE
# <parameter>
# 1. Path of Definition File of Web Server Connector
#===============================================================================
C:\temp\WU001\webconnector001.xml
C:\temp\WU002\webconnector002.xml

#===============================================================================
# Web Server Connector Update Definition FILE
# <parameter>
# 1. Path of Definition File of Web Server Connector
#===============================================================================
/tmp/WU001/webconnector001.xml
/tmp/WU002/webconnector002.xml

■Interstage Operation Toolを起動するためのスクリプトファイル（iplstart.vbs）

• 本スクリプトファイルは、資源の適用方法にIPL適用を選択する場合のみ必要となります。
• Interstage Operation Toolを起動するためのスクリプトファイルです。Windows Script Host(WSH)およびWindows Management Instrumentation(WMI)を使用しています。WSHおよびWMIの詳細はMicrosoftのホームページを参照してください。
• 本スクリプトファイルでは、Interstage Operation Toolの起動処理を実行します。
• Interstage Operation Toolが起動処理中の場合、デフォルトで3秒間隔で最大100回、起動完了をチェックします。チェックの間隔、およびチェック回数をカスタマイズしたい場合は、それぞれスクリプトの先頭で定義している「RetryCount」および「RetryInterval」の値を変更してください。
• スクリプトの処理に失敗した場合、サンプルスクリプトと同じファイルにログが出力されます。
• 本スクリプトはOSの機能を利用しているため、Interstage Application Serverのメッセージはログ出力されません。

' ----- Time out settings -----
Const RetryCount = 100
Const RetryInterval = 3000
' -----------------------------