Interstage Application Server 高信頼性システム運用ガイド

4.6.1.1 状態遷移プロシジャの修正

■状態遷移プロシジャのサンプル

　Interstageでは状態遷移プロシジャを利用し、Interstageの起動/停止および切り替え処理を行います。Interstageでは以下のディレクトリ配下に状態遷移プロシジャのサンプルを提供します。使用者は状態遷移プロシジャを環境に合わせて修正する必要があります。

　　　/opt/FJSVisas/etc/HA/SynfinityCLUSTER

　　　/opt/FJSVisas/etc/HA/PRIMECLUSTER

　Interstageでは以下の状態遷移プロシジャのサンプルを提供します。

• JMX_INTERSTAGE (Interstage JMXサービスの起動／停止用)
• IS_INTERSTAGE (Interstage起動／停止用)
• OTS_RMP_INTERSTAGE (データベース連携サービス リソース管理プログラム用)
• ODWU_INTERSTAGE (CORBAワークユニット用)
• TDWU_INTERSTAGE (トランザクションアプリケーション用)
• UTYWU_INTERSTAGE (ユーティリティワークユニット用)
• IJSERVER_INTERSTAGE (IJServer用)
• ES_INTERSTAGE (イベントサービス用)
• SOAP_INTERSTAGE (SOAPサービス用)
• IREP_INTERSTAGE (Smart Repository用)
• EBMS_INTERSTAGE(ebXML Message Service用)

■サンプルの利用方法

　使用者は以下の手順で状態遷移プロシジャの修正を行います。

1. 状態遷移プロシジャの複写
2. 状態遷移プロシジャの内容の修正

　修正を行った後、修正したプロシジャには実行権限を付与してください。

[状態遷移プロシジャの複写]

　Interstageより提供しているすべての状態遷移プロシジャのサンプルを使用者の任意のディレクトリ配下に以下の命名で複写してください。

　userApplication名.状態遷移プロシジャ名

　複写した状態遷移プロシジャのうち、以下の状態遷移プロシジャに関しては、修正を行う必要があります。

• userApplication名.JMX_INTERSTAGE
• userApplication名.ODWU_INTERSTAGE
• userApplication名.TDWU_INTERSTAGE
• userApplication名.IJSERVER_INTERSTAGE
• userApplication名.OTS_RMP_INTERSTAGE
• userApplication名.ES_INTERSTAGE
• userApplication名.IS_INTERSTAGE
• userApplication名.UTYWU_INTERSTAGE
• userApplication名.SOAP_INTERSTAGE
• userApplication名.EBMS_INTERSTAGE
• userApplication名.IREP_INTERSTAGE
  サンプルを複写するディレクトリはローカルディスク内に設定してください。
  また、プロシジャは各ノードで同一の位置に格納してください。

[状態遷移プロシジャの内容の修正]

　複写した状態遷移プロシジャの内容の修正方法を以下に説明します。

■userApplication名.JMX_INTERSTAGEの修正

　修正する必要はありません。

■userApplication名.IS_INTERSTAGEの修正

　ネーミングサービスおよびインタフェースリポジトリが何らかの異常で停止した場合でも、待機側に切り替えたくない場合は、状態遷移プロシジャ内のIS_ISV_WATCH_MODEに“0”を設定してください。通常は“1”が設定されており、切り替えの対象となっています。切り替えたい場合は、修正の必要はありません。


　ネーミングサービスおよびインタフェースリポジトリが異常終了してもクラスタサービスを切り替えたくない場合

　IS_ISV_WATCH_MODE="0"

　SOAPサービスのCORBA/SOAPクライアントゲートウェイを連動起動するために以下の環境変数を追加してください。
　環境変数JAVA_HOMEは、使用するJava環境に合わせてしてください。

　LD_LIBRARY_PATH=/opt/FSUNod/lib
　export LD_LIBRARY_PATH
　SOAP_HOME=/opt/FJSVsoap
　export SOAP_HOME
　JAVA_HOME=/opt/FJSVawjbk/jdk13
　export JAVA_HOME
　CLASSPATH=$CLASSPATH:/etc/opt/FSUNod/class/ODjava2.jar:/opt/FJSVj2ee/lib/isj2ee.jar:/opt/FJSVxmlpc/lib/xmlpro.jar:/opt/FJSVsoap/lib/issoap.jar:/opt/FJSVj2ee/jce1.2.1/lib/jce1_2_1.jar:/opt/FJSVj2ee/jce1.2.1/lib/local_policy.jar:/opt/FJSVj2ee/jce1.2.1/lib/sunjce_provider.jar:/opt/FJSVj2ee/jce1.2.1/lib/US_export_policy.jar
　export CLASSPATH

　LD_LIBRARY_PATH=/opt/FSUNod/lib:/opt/FJSVsoap/tools
　export LD_LIBRARY_PATH
　SOAP_HOME=/opt/FJSVsoap
　export SOAP_HOME
　JAVA_HOME=/opt/FJSVawjbk/jdk13
　export JAVA_HOME
　CLASSPATH=$CLASSPATH:/etc/opt/FJSVod/class/ODjava2.jar:/opt/FJSVj2ee/lib/isj2ee.jar:/opt/FJSVxmlpc/lib/xmlpro.jar:/opt/FJSVsoap/lib/issoap.jar:/opt/FJSVj2ee/jce1.2.1/lib/jce1_2_1.jar:/opt/FJSVj2ee/jce1.2.1/lib/local_policy.jar:/opt/FJSVj2ee/jce1.2.1/lib/sunjce_provider.jar:/opt/FJSVj2ee/jce1.2.1/lib/US_export_policy.jar
　export CLASSPATH

■userApplication名.ODWU_INTERSTAGE/userApplication名.TDWU_INTERSTAGE/userApplication名.IJSERVER_INTERSTAGE/userApplication名.UTYWU_INTERSTAGEの修正

　運用ノードで起動するワークユニットおよび切り替え時に引き継ぐワークユニットを設定します。ワークユニットごとの状態遷移プロシジャは以下のとおりです。

• CORBAアプリケーションのワークユニットの場合、userApplication名.ODWU_INTERSTAGE
• トランザクションアプリケーションのワークユニットの場合、userApplication名.TDWU_INTERSTAGE
• IJServerワークユニットの場合、userApplication名.IJSERVER_INTERSTAGE
• ユーティリティワークユニットの場合、userApplication名.UTYWU_INTERSTAGE

　状態遷移プロシジャ内のWU_NAMEにワークユニット名を以下のように記述してください。

　WU1、WU2を起動および事前起動したい場合

　WU_NAME="WU1 WU2"

　注意)記述するワークユニット名は半角ブランクで区切ってください。

■userApplication名.OTS_RMP_INTERSTAGEの修正

　当該状態遷移プロシジャにより、運用ノードで起動するリソース管理プログラムおよび切り替え時に動作するリソース管理プログラムを設定します。そのため、状態遷移プロシジャ内の“DEF_NAME”にリソース管理プログラムとリソース定義名を以下のように記述してください。

　/home/ots/resource1をresource1で、/home/ots/resource2をresource2で起動したい場合

　DEF_NAME="/home/ots/resource1 resource1 /home/ots/resource resource2"

　また、JTS用のリソース管理プログラムを使用する場合には、“JTS_USE”に“TRUE”を設定してください。

　JTSをクラスタ環境で使用したい場合

　JTS_USE="TRUE"

　注意)記述する項目は半角ブランクで区切ってください。

■userApplication名.ES_INTERSTAGEの修正

　イベントチャネルに「イベントサービス起動時にイベントチャネルを自動起動しない」という設定を行った場合は、当該状態遷移プロシジャにより、運用ノードで起動する、および切り替え時に動作するイベントチャネルを設定する必要があります。状態遷移プロシジャ内の“ES_CHNL”に起動するイベントチャネルグループ名を記述してください。
　ただし、すべてのイベントチャネルに初期値（省略値）である「イベントサービス起動時にイベントチャネルを自動起動する」という設定を行っている場合、当該状態遷移プロシジャを登録する必要はありません。
　また、不揮発運用を行うイベントチャネルの場合、ユニットはイベントチャネル起動時に自動起動されるため、記述する必要はありません。

　イベントチャネルグループmix1、mix2、mix3を起動したい場合

　ES_CHNL="mix1 mix2 mix3"

　注意)記述する項目は半角ブランクで区切ってください。

■userApplication名.SOAP_INTERSTAGEの修正

　使用するJava環境に合わせて環境変数JAVA_HOMEを設定します。

　JDK1.3を使用する場合

　JAVA_HOME=/opt/FJSVawjbk/jdk13

■userApplication名.EBMS_INTERSTAGEの修正

　使用するJava環境に合わせて環境変数JAVA_HOMEを設定します。

　JDK1.3を使用する場合

　JAVA_HOME=/opt/FJSVawjbk/jdk13

■userApplication名.IREP_INTERSTAGEの修正

　使用する共用ディスクパスを設定します。

　共用ディスクパスを“/repository”として指定する場合

DIRECTORY=/repository

注) 共用ディスクパスには、リソース登録済みのパスを指定してください。