必ず行う設定
Interstage Information Integrator（以降、IIIと略します）と連携する場合、III連携定義ファイルの配置や、III連携用のリソースアダプタの配備などが必要になります。また、IIIのサーバ環境と運用管理環境(サーブレットを利用した接続形態)がセットアップされている必要があります。IIIのセットアップ方法については、IIIのセットアップガイドを参照してください。
注意
IIIの運用管理環境のWebアプリケーションは、必ずISIConsoleのIJServerクラスタに対して配備してください。その際、IIIの運用管理環境の動作に必要な環境設定をISIConsoleのIJServerクラスタに実施してください。
ISIのセットアップの手順は以下のとおりです。
III連携定義ファイルの配置
IIIに同梱されているIII連携定義ファイルを、ISIのインストール先にコピーします。コピーしたファイルには、Interstage運用グループから参照できるようにアクセス権限を設定してください。
/opt/FJSVifisv/sample/iii-cooperations.xml
/opt/FJSVesi/etc/jee/def/gui
リソースアダプタの配備
以下を実施して、アウトバウンドのIII連携で使用するリソースアダプタを配備します。
コネクタモジュールとコネクタリソースのターゲットには、作成されているすべてのISIサーバのIJServerクラスタを追加してください。
以下のコマンドを実行してリソースアダプタを配備してください。
/opt/FJSVisje6/glassfish/bin/asadmin deploy --target ISISrv /opt/FJSVifisv/adpt/isi/esiiiiadapter.rarISISrv：ISIサーバのIJServerクラスタ名
/opt/FJSVisje6/glassfish/bin/asadmin create-connector-connection-pool --raname esiiiiadapter --connectiondefinition javax.resource.cci.ConnectionFactory esiiiiadapter
/opt/FJSVisje6/glassfish/bin/asadmin create-connector-resource --target ISISrv --poolname esiiiiadapter esiiiiadapterISISrv：ISIサーバのIJServerクラスタ名
ISIサーバを複数作成している場合は、以下のコマンドを実行し、コネクタモジュールとコネクタリソースのターゲットに、作成されているISIサーバのすべてのIJServerクラスタを追加してください。create-application-refサブコマンドは本設定だけで使用してください。
/opt/FJSVisje6/glassfish/bin/asadmin create-application-ref --target ISISrv_Unit01 esiiiiadapter /opt/FJSVisje6/glassfish/bin/asadmin create-resource-ref --target ISISrv_Unit01 esiiiiadapter
ISISrv_Unit01：ISIサーバのIJServerクラスタ名
ISIサーバのIJServerクラスタに対するパスの追加
作成されているすべてのISIサーバのIJServerクラスタに対して、III連携に必要なパスを追加します。asadminコマンドを使用して、以下のパスをそれぞれ追加してください。
/opt/FJSVifisv/lib/f3jniapisires.jar
/opt/FJSVifisv/lib
III連携に必要なパスを設定する手順は以下のとおりです。以下の手順で使用するasadminコマンドの詳細は、“Interstage Application Server Java EE運用ガイド(Java EE 6編)”の“asadmin”を参照してください。Java VMの定義項目のプロパティである“isjee-classpath-suffix”は、本設定だけで使用してください。
asadmin getコマンドを使用して、現在の設定を確認します。
/opt/FJSVisje6/glassfish/bin/asadmin get ISISrv.java-config.isjee-classpath-suffix /opt/FJSVisje6/glassfish/bin/asadmin get ISISrv.java-config.native-library-path-suffix
実行例
/opt/FJSVisje6/glassfish/bin/asadmin get ISISrv.java-config.isjee-classpath-suffix ISISrv.java-config.isjee-classpath-suffix=/opt/FJSVesi/lib/esicore.jar${path.separator}/opt/FJSVesi/lib/log4j-1.2.15.jar${path.separator}/opt/FJSVfmsv/lib/fmsvapi.jar${path.separator}/opt/FJSVesi/lib/jdom.jar${path.separator}/opt/FJSVesi/lib/axis.jar${path.separator}/opt/FJSVesi/lib/commons-lang-2.3.jar${path.separator}/opt/FJSVesi/lib/commons-beanutils.jar${path.separator}/opt/FJSVesi/lib/commons-logging-1.0.4.jar${path.separator}/opt/FJSVfdcmn/lib/FeditPackage.jar /opt/FJSVisje6/glassfish/bin/asadmin get ISISrv.java-config.native-library-path-suffix ISISrv.java-config.native-library-path-suffix=/opt/FJSVesi/lib${path.separator}/opt/FJSVfdcmn/lib
asadmin getコマンドで確認した設定値の末尾に、設定するパスを追加し、asadmin setコマンドで設定します。
実行例
/opt/FJSVisje6/glassfish/bin/asadmin set ISISrv.java-config.isjee-classpath-suffix=/opt/FJSVesi/lib/esicore.jar\${path.separator}/opt/FJSVesi/lib/log4j-1.2.15.jar\${path.separator}/opt/FJSVfmsv/lib/fmsvapi.jar\${path.separator}/opt/FJSVesi/lib/jdom.jar\${path.separator}/opt/FJSVesi/lib/axis.jar\${path.separator}/opt/FJSVesi/lib/commons-lang-2.3.jar\${path.separator}/opt/FJSVesi/lib/commons-beanutils.jar\${path.separator}/opt/FJSVesi/lib/commons-logging-1.0.4.jar\${path.separator}/opt/FJSVfdcmn/lib/FeditPackage.jar\${path.separator}/opt/FJSVifisv/lib/f3jniapisires.jar /opt/FJSVisje6/glassfish/bin/asadmin set ISISrv.java-config.native-library-path-suffix=/opt/FJSVesi/lib\${path.separator}/opt/FJSVfdcmn/lib\${path.separator}/opt/FJSVifisv/lib
ISISrv：ISIサーバのIJServerクラスタ名
ISIサーバのIJServerクラスタに対する環境変数の設定
作成されているすべてのISIサーバのIJServerクラスタに対して、III連携に必要な環境変数を設定します。
設定方法の詳細は“Interstage Application Server Java EE運用ガイド(Java EE 6編)”の“Interstage Java EE 6 DASサービスの運用”の“環境変数の設定”を参照してください。
以下の環境変数を設定してください。
環境変数 | 設定するパス |
|---|---|
PATH | /opt/FJSVifisv/bin |
ESB連携サービス終了前出口を利用する場合の設定
ISIとIIIを連携する環境で、IIIのESB連携サービス終了前出口を使用する場合、以下の定義および設定を行ってください。
サービスエンドポイント定義の作成
インバウンドのSOAP(同期)のサービスエンドポイント定義を作成します。
作成方法は“ISI Studioヘルプ”を参照してください。
ヘッダ伝送定義の追加
ヘッダ伝送定義ファイルに以下の定義を追加します。
“サービスエンドポイント名”.receive.com.fujitsu.esi.adapter.iii.paththrough.IFI_ProcID=IFI_ProcID “サービスエンドポイント名”.receive.com.fujitsu.esi.adapter.iii.paththrough.IFI_PreProcID=IFI_PreProcID “サービスエンドポイント名”.receive.com.fujitsu.esi.adapter.iii.paththrough.IFI_OutputTarget=IFI_OutputTarget “サービスエンドポイント名”.receive.com.fujitsu.esi.adapter.msgid=com.fujitsu.esi.adapter.msgid “サービスエンドポイント名”.receive.com.fujitsu.esi.root.sequence.name=com.fujitsu.esi.root.sequence.name
ヘッダ伝送定義の詳細については、“ISI アプリケーション開発ガイド”の“ヘッダ伝送定義の詳細”を参照してください。
以下に、IIIのESB連携サービス終了前出口と連携するインバウンドのSOAPのサービスエンドポイント名が“EXIT_EP”の場合のヘッダ伝送定義の例を示します。
EXIT_EP.receive.com.fujitsu.esi.adapter.iii.paththrough.IFI_ProcID=IFI_ProcID EXIT_EP.receive.com.fujitsu.esi.adapter.iii.paththrough.IFI_PreProcID=IFI_PreProcID EXIT_EP.receive.com.fujitsu.esi.adapter.iii.paththrough.IFI_OutputTarget=IFI_OutputTarget EXIT_EP.receive.com.fujitsu.esi.adapter.msgid=com.fujitsu.esi.adapter.msgid EXIT_EP.receive.com.fujitsu.esi.root.sequence.name=com.fujitsu.esi.root.sequence.name
注意
IIIのESB連携サービス終了前出口と連携する場合、以下のヘッダキーに対する値を更新しないでください。
IFI_ProcID
IFI_PreProcID
IFI_OutputTarget
com.fujitsu.esi.adapter.msgid
com.fujitsu.esi.root.sequence.name
Formatmanager変換機能(ISIサーバ分離型)を使用しない場合の設定
Formatmanager変換機能(ISIサーバ分離型)を使用しない場合、IIIのセットアップ後に、環境設定ファイルの編集などが必要となります。
設定の手順は以下のとおりです。
環境設定ファイルの編集
環境設定ファイルを以下に示します。
/opt/FJSVesi/etc/def/properties/ESISystemConfig.properties
環境設定ファイルには、以下の内容を定義します。
定義名 | 意味 |
|---|---|
com.fujitsu.esi.formatmanager.compatibility | ISI運用管理コンソールにFormatmanagerサーバの起動・停止メニューを表示するかどうかを設定します。
|
環境設定ファイルの編集後、ISI運用管理コンソールを再起動してください。ISI運用管理コンソールの起動・停止方法は、“ISI Java EE運用ガイド”を参照してください。
ファイルの削除
以下のファイルを削除します。
/opt/FJSVfmsv/etc/.useformatmanagerserver
ISI Studioで定義をする場合の設定
ISI Studioを使用してIII連携の定義を操作する場合、ISIサーバから定義を取得する際に指定するユーザIDを、IIIの動作環境ファイルのdefuserに定義する必要があります（Information Integrator特権ユーザーの場合は必要ありません）。