FUJITSU Software
Interstage Service Integrator V9.5.1
トラブルシューティング集
Windows/Solaris/Linux
J2X1-7902-01Z0(01)
2014年7月
まえがき
本書の目的
本書は、Interstage Service Integrator(以降、ISIと略します)製品を使用中に発生しうる既知のトラブルについて、事例・現象と解決方法
を説明しています。
本書の構成
本書は、以下の構成になっています。
第1章 障害調査資料の採取方法
ISIの障害調査資料の採取方法について説明します。
第2章 インストール・アンインストール時の異常
ISIのインストール・アンインストール時に異常が発生した場合の対処について説明します。
第1部 J2EE実行環境編
第3章 セットアップ時の異常
ISIのセットアップ時に異常が発生した場合の対処について説明します。
第4章 ISI運用管理コンソール操作時の異常
ISIのISI運用管理コンソール操作時に異常が発生した場合の対処について説明します。
第5章 ISIクライアント利用時の異常
ISIのISI StudioまたはFormatmanagerクライアント利用時に異常が発生した場合の対処について説明します。
第6章 ISI運用時の異常
ISIの運用時に異常が発生した場合の対処について説明します。
第7章 サービス連携時の異常
ISIの各種サービス連携時に異常が発生した場合の対処について説明します。
第8章 データ変換時の異常
ISIの各種データ変換実行時に異常が発生した場合の対処について説明します。
第9章 バックアップ・リストア時の異常
ISIのバックアップ・リストア時に異常が発生した場合の対処について説明します。
第10章 BPEL利用時の異常
ISIのBPEL利用時の異常が発生した場合の対処について説明します。
第2部 Java EE実行環境編
第11章 セットアップ時の異常
ISIのセットアップ時に異常が発生した場合の対処について説明します。
第12章 ISI運用管理コンソール操作時の異常
ISIのISI運用管理コンソール操作時に異常が発生した場合の対処について説明します。
第13章 ISIクライアント利用時の異常
ISIのISI StudioまたはFormatmanagerクライアント利用時に異常が発生した場合の対処について説明します。
第14章 ISI運用時の異常
ISIの運用時に異常が発生した場合の対処について説明します。
第15章 サービス連携時の異常
ISIの各種サービス連携時に異常が発生した場合の対処について説明します。
-i-
第16章 データ変換時の異常
ISIの各種データ変換実行時に異常が発生した場合の対処について説明します。
第17章 バックアップ・リストア時の異常
ISIのバックアップ・リストア時に異常が発生した場合の対処について説明します。
第18章 BPEL利用時の異常
ISIのBPEL利用時の異常が発生した場合の対処について説明します。
お願い
・ このマニュアルは、予告なしに変更されることがあります。
・ このマニュアルを無断で他に転用しないようお願いします。
・ このマニュアルに記載されたデータの使用に起因する第三者の特許権、およびその他の権利の侵害については、当社はその責
を負いません。
2014年7月 第2.1版
2014年4月 第2版
2014年2月 初版
Copyright 2014 FUJITSU LIMITED
変更履歴
変更内容
変更箇所
FJQSS(資料採取ツール)について、ポイントに追加しました。
1.1
データ変換時に意図した変換ができない場合の対処を追加しました。
8.2.8
16.2.6
- ii -
版数
第2.1版
目　次
第1章 障害調査資料の採取方法................................................................................................................................................1
1.1 一括情報採取ツール.......................................................................................................................................................................... 1
1.2 コアダンプの採取................................................................................................................................................................................ 1
1.2.1 Solarisでのコアダンプ採取.......................................................................................................................................................... 2
1.2.2 Linuxでのコアダンプ採取............................................................................................................................................................2
第2章 インストール・アンインストール時の異常........................................................................................................................... 3
2.1 インストール時の異常..........................................................................................................................................................................3
2.1.1 環境変数の設定に失敗した場合................................................................................................................................................ 3
2.1.2 簡易セットアップに失敗した場合.................................................................................................................................................3
2.1.3 ターミナルサービスが実行モードの場合のエラー......................................................................................................................4
2.1.4 セットアップステータスでハングアップした場合.......................................................................................................................... 4
2.1.5 サービスの登録に失敗しハングアップした場合......................................................................................................................... 4
2.1.6 インストール時に権限エラーが出力された場合......................................................................................................................... 5
2.1.7 インストール時にinstall.shが実行できない場合.......................................................................................................................... 5
2.1.8 インストール時にバージョンエラーが表示される場合................................................................................................................ 5
2.1.9 セキュリティモードの設定に失敗した場合.................................................................................................................................. 6
2.2 アンインストール時の異常...................................................................................................................................................................7
2.2.1 アンインストールの失敗後、インストール、アンインストールができない場合.............................................................................7
第1部 J2EE実行環境編.............................................................................................................................................................8
第3章 セットアップ時の異常........................................................................................................................................................9
3.1 セットアップに失敗する....................................................................................................................................................................... 9
3.1.1 データベースのセットアップに失敗する...................................................................................................................................... 9
3.1.2 ISIサーバのセットアップ/ISIサーバの追加/JMS-Rキューの追加に失敗する......................................................................... 10
3.1.3 ISIサーバ連携構成(キュー間転送)のセットアップに失敗する................................................................................................ 10
3.2 アンセットアップに失敗する.............................................................................................................................................................. 11
3.2.1 データベースのアンセットアップに失敗する............................................................................................................................. 11
第4章 ISI運用管理コンソール操作時の異常............................................................................................................................. 12
4.1 ログインに失敗する........................................................................................................................................................................... 12
4.1.1 ログイン時の異常....................................................................................................................................................................... 12
4.2 実行モニタの表示が正しくない........................................................................................................................................................ 12
4.2.1 登録したシーケンス定義、サービスエンドポイント定義が表示されない..................................................................................12
第5章 ISIクライアント利用時の異常.......................................................................................................................................... 13
5.1 ISIの定義に関する異常....................................................................................................................................................................13
5.1.1 ISIの定義の登録でエラーダイアログが表示される.................................................................................................................. 13
5.1.2 ISIの定義の配置でエラーダイアログが表示される.................................................................................................................. 14
5.1.3 ISIの定義の取得でエラーダイアログが表示される.................................................................................................................. 14
5.1.4 ISIサービスシミュレートでエラーダイアログが表示される.........................................................................................................15
5.1.5 ISIの定義の配置で定義が配置されない.................................................................................................................................. 15
5.1.6 登録した定義が反映されない....................................................................................................................................................15
5.2 Formatmanagerの変換テーブルに関する異常................................................................................................................................ 16
5.2.1 変換テーブル生成でエラーダイアログが表示される................................................................................................................16
5.2.2 変換テーブル取得でエラーダイアログが表示される................................................................................................................16
5.3 Formatmanagerの定義に関する異常............................................................................................................................................... 16
5.3.1 Formatmanagerクライアントが正しく動作しない.........................................................................................................................16
第6章 ISI運用時の異常........................................................................................................................................................... 17
6.1 ISIの定義変更時のトラブル..............................................................................................................................................................17
6.1.1 ISIの定義変更が実行結果に反映されない..............................................................................................................................17
6.2 非同期メッセージング構成のISIサーバ運用時のトラブル.............................................................................................................. 17
6.2.1 メッセージがサービス提供側アプリケーションへ届かない....................................................................................................... 17
6.2.2 メッセージを送信したが、シーケンス処理が開始されない.......................................................................................................18
- iii -
6.2.3 シーケンス終了時にエラーメッセージが出力される................................................................................................................. 18
6.3 シーケンスリトライに関するトラブル...................................................................................................................................................18
6.3.1 非同期メッセージング構成のISIサーバで、シーケンスリトライが実行されない.......................................................................18
6.4 ISIの起動/停止に関するトラブル......................................................................................................................................................19
6.4.1 Interstageの起動に失敗する場合.............................................................................................................................................. 19
6.5 クラスタシステムに関するトラブル..................................................................................................................................................... 19
6.5.1 ワークユニットが異常終了してもクラスタシステムが切り替わらない......................................................................................... 19
第7章 サービス連携時の異常.................................................................................................................................................. 20
7.1 メッセージの送受信に失敗する........................................................................................................................................................20
7.1.1 アダプタ連携共通...................................................................................................................................................................... 20
7.1.1.1 ISIサーバから、サービス提供側アプリケーションへの接続に失敗する........................................................................... 20
7.1.1.2 サービス利用側アプリケーションから、ISIサーバへの接続に失敗する........................................................................... 20
7.1.2 CORBA連携時...........................................................................................................................................................................20
7.1.2.1 ISIからCORBAサーバに接続できない.............................................................................................................................. 20
7.1.2.2 CORBAクライアントからISIサーバに接続できない............................................................................................................20
7.1.2.3 コンポーネントトランザクションサーバアプリケーションからのデータを取得できない...................................................... 20
7.1.2.4 ISIからメッセージを受信したCORBAサーバ側で電文長が0になっている...................................................................... 21
7.1.3 DB連携時...................................................................................................................................................................................21
7.1.3.1 ISIからDBへのアクセスに失敗する....................................................................................................................................21
7.1.4 SOAP連携時.............................................................................................................................................................................. 21
7.1.4.1 SOAPメッセージを送信すると、クライアントにSOAP Faultが返ってくる............................................................................21
7.1.5 ファイル転送連携時................................................................................................................................................................... 21
7.1.5.1 ファイル監視アダプタで、ファイルが受信されない............................................................................................................ 21
7.1.5.2 ファイル監視アダプタの実行で、“FTS-SV-33010”、“ESI-API-40031”のエラーが発生する..........................................22
7.1.5.3 ISIからのFTP送信に失敗する............................................................................................................................................ 22
7.1.6 MQD連携時............................................................................................................................................................................... 22
7.1.6.1 MQDシステムからメッセージが受信されない.................................................................................................................... 22
7.1.7 MQ連携時.................................................................................................................................................................................. 23
7.1.7.1 ISIが受信したメッセージのMsgIdの値が正しくない.......................................................................................................... 23
7.1.7.2 連携処理が失敗する.......................................................................................................................................................... 23
7.1.7.3 インバウンドのMQアダプタが異常終了する...................................................................................................................... 23
7.1.7.4 アウトバウンドのMQアダプタが異常終了する....................................................................................................................23
7.1.8 III連携時.................................................................................................................................................................................... 23
7.1.8.1 IIIとのメッセージ送受信で異常が発生する....................................................................................................................... 23
7.1.9 ISIクライアント連携時................................................................................................................................................................. 23
7.1.9.1 ISIクライアントからISIサーバに接続できない.................................................................................................................... 23
7.2 アダプタの起動で失敗する...............................................................................................................................................................24
7.2.1 ファイル監視アダプタが起動しない（ファイル転送連携時）..................................................................................................... 24
7.2.2 MQアダプタが起動しない（MQ連携時）................................................................................................................................... 24
7.2.3 MQD受信が起動しない（MQD利用時）................................................................................................................................... 24
第8章 データ変換時の異常...................................................................................................................................................... 25
8.1 起動/停止に失敗する....................................................................................................................................................................... 25
8.1.1 Formatmanager変換機能が起動しない.....................................................................................................................................25
8.2 メッセージが正しく変換されない.......................................................................................................................................................25
8.2.1 リソースの変更内容が、実行結果に反映されない................................................................................................................... 25
8.2.2 変換結果が文字化けする..........................................................................................................................................................25
8.2.3 Formatmanagerメディエータファンクションの実行が必ずエラーになる....................................................................................26
8.2.4 KindCode=2,ReasonCode=0x101d、KindCode=3,ReasonCode=0x1027 の変換エラーが発生する.......................................26
8.2.5 変換処理時間が長くなる........................................................................................................................................................... 26
8.2.6 KindCode=2,ReasonCode=0x8004、KindCode=3,ReasonCode=0x8007 の変換エラーが発生する.......................................26
8.2.7 エンティティ(<、>、&、'、")が変換されない......................................................................................... 26
8.2.8 意図した変換ができない............................................................................................................................................................26
第9章 バックアップ・リストア時の異常....................................................................................................................................... 27
9.1 リストア時の異常................................................................................................................................................................................ 27
9.1.1 JMS-Rキューの再作成に失敗する............................................................................................................................................27
- iv -
9.1.2 ISIの起動に失敗する.................................................................................................................................................................27
9.2 リストア後の異常................................................................................................................................................................................ 27
9.2.1 ISIサーバのセットアップに失敗する..........................................................................................................................................27
9.3 移行後の異常....................................................................................................................................................................................27
9.3.1 ISI運用管理コンソールのログイン後の画面が表示されない................................................................................................... 27
9.3.2 メッセージが変換されない......................................................................................................................................................... 28
第10章 BPEL利用時の異常.....................................................................................................................................................29
10.1 ビジネス・プロセス実行時の異常....................................................................................................................................................29
10.1.1 ビジネス・プロセス実行機能がハングアップする.................................................................................................................... 29
10.1.2 CorrelationSetによるインスタンスのルーティングが異常となる............................................................................................... 29
10.1.3 BPEL起動アプリケーションでビジネス・プロセスを呼び出すと例外が発生する................................................................... 29
10.1.4 ビジネス・プロセス実行機能を配備したIJServerクラスタのサーバログにlog4jのエラーメッセージが出力される.................30
10.1.5 強制停止時の対処...................................................................................................................................................................30
10.1.6 IJServerクラスタ起動時にエラーとなる.................................................................................................................................... 30
10.1.7 BPEL起動アプリケーションが動作しない(J2EE実行環境だけ)............................................................................................. 30
10.1.8 BPEL起動アプリケーションがエラー復帰する........................................................................................................................ 30
10.1.9 想定しないタイムアウトが発生する.......................................................................................................................................... 30
10.1.10 InvokeによるWebサービス呼び出しが失敗する................................................................................................................... 31
10.2 ビジネス・プロセス実行環境作成時の異常....................................................................................................................................31
10.2.1 BPEL定義を配備できない.......................................................................................................................................................31
10.2.2 BPEL起動アプリケーションが作成できない............................................................................................................................31
第2部 Java EE実行環境編...................................................................................................................................................... 32
第11章 セットアップ時の異常....................................................................................................................................................33
11.1 セットアップに失敗する................................................................................................................................................................... 33
11.1.1 ISI実行環境/ISI運用管理コンソールのセットアップに失敗する............................................................................................ 33
第12章 ISI運用管理コンソール操作時の異常........................................................................................................................... 40
12.1 ログインに失敗する......................................................................................................................................................................... 40
12.1.1 ログイン時の異常..................................................................................................................................................................... 40
12.2 実行モニタの表示が正しくない...................................................................................................................................................... 40
12.2.1 登録したシーケンス定義、サービスエンドポイント定義が表示されない................................................................................40
12.3 ISI運用管理コンソールの表示がおかしい.....................................................................................................................................40
12.3.1 ISI運用管理コンソールの画面が英語で表示される...............................................................................................................40
第13章 ISIクライアント利用時の異常........................................................................................................................................ 42
13.1 ISIの定義に関する異常..................................................................................................................................................................42
13.1.1 ISIの定義の登録でエラーダイアログが表示される................................................................................................................ 42
13.1.2 ISIの定義の配置でエラーダイアログが表示される................................................................................................................ 43
13.1.3 ISIの定義の取得でエラーダイアログが表示される................................................................................................................ 43
13.2 Formatmanagerの変換テーブルに関する異常.............................................................................................................................. 44
13.2.1 変換テーブル生成でエラーダイアログが表示される..............................................................................................................44
13.2.2 変換テーブル取得でエラーダイアログが表示される..............................................................................................................44
第14章 ISI運用時の異常......................................................................................................................................................... 45
14.1 ISIの定義変更時のトラブル............................................................................................................................................................45
14.1.1 ISIの定義変更が実行結果に反映されない............................................................................................................................45
14.2 非同期メッセージング構成のISIサーバ運用時のトラブル............................................................................................................ 45
14.2.1 メッセージを送信したが、シーケンス処理が開始されない.....................................................................................................45
14.2.2 ISIサーバに接続できない........................................................................................................................................................45
第15章 サービス連携時の異常................................................................................................................................................ 47
15.1 メッセージの送受信に失敗する......................................................................................................................................................47
15.1.1 アダプタ連携共通.................................................................................................................................................................... 47
15.1.1.1 ISIサーバから、サービス提供側アプリケーションへの接続に失敗する......................................................................... 47
15.1.1.2 サービス利用側アプリケーションから、ISIサーバへの接続に失敗する......................................................................... 47
15.1.2 SOAP連携時............................................................................................................................................................................ 47
-v-
15.1.2.1 SOAPメッセージを送信すると、クライアントにSOAP Faultが返ってくる..........................................................................47
15.1.2.2 SOAPメッセージを送信すると、HTTP復帰コード500が返ってくる..................................................................................48
15.1.3 MQ連携時................................................................................................................................................................................ 48
15.1.3.1 ISIが受信したメッセージのMsgIdの値が正しくない........................................................................................................ 48
15.1.3.2 連携処理が失敗する........................................................................................................................................................ 48
15.1.3.3 インバウンドのMQアダプタが異常終了する.................................................................................................................... 48
15.1.3.4 アウトバウンドのMQアダプタが異常終了する..................................................................................................................49
15.1.4 III連携時.................................................................................................................................................................................. 49
15.1.4.1 IIIとのメッセージ送受信で異常が発生する..................................................................................................................... 49
15.1.5 MQD連携時............................................................................................................................................................................. 49
15.1.5.1 MQDシステムからメッセージが受信されない.................................................................................................................. 49
15.2 アダプタの起動で失敗する.............................................................................................................................................................49
15.2.1 MQアダプタが起動しない（MQ連携時）................................................................................................................................. 49
15.2.2 MQD受信が起動しない（MQD利用時）................................................................................................................................. 49
第16章 データ変換時の異常.................................................................................................................................................... 50
16.1 起動/停止に失敗する..................................................................................................................................................................... 50
16.1.1 Formatmanager変換機能が起動しない...................................................................................................................................50
16.2 メッセージが正しく変換されない.....................................................................................................................................................50
16.2.1 リソースの変更内容が、実行結果に反映されない................................................................................................................. 50
16.2.2 変換結果が文字化けする........................................................................................................................................................50
16.2.3 Formatmanagerメディエータファンクションの実行が必ずエラーになる..................................................................................51
16.2.4 KindCode=2,ReasonCode=0x101d、KindCode=3,ReasonCode=0x1027 の変換エラーが発生する.....................................51
16.2.5 変換処理時間が長くなる......................................................................................................................................................... 51
16.2.6 意図した変換ができない..........................................................................................................................................................51
第17章 バックアップ・リストア時の異常..................................................................................................................................... 52
17.1 リストア時の異常.............................................................................................................................................................................. 52
17.1.1 ISIの起動に失敗する...............................................................................................................................................................52
17.2 リストア後の異常.............................................................................................................................................................................. 52
17.2.1 ISIサーバのセットアップに失敗する........................................................................................................................................52
第18章 BPEL利用時の異常.....................................................................................................................................................53
18.1 ビジネス・プロセス実行時の異常....................................................................................................................................................53
18.1.1 ビジネス・プロセス実行機能がハングアップする.................................................................................................................... 53
18.1.2 CorrelationSetによるインスタンスのルーティングが異常となる............................................................................................... 53
18.1.3 BPEL起動アプリケーションでビジネス・プロセスを呼び出すと例外が発生する................................................................... 53
18.1.4 ビジネス・プロセス実行機能を配備したIJServerクラスタのサーバログにlog4jのエラーメッセージが出力される.................54
18.1.5 強制停止時の対処...................................................................................................................................................................54
18.1.6 IJServerクラスタ起動時にエラーとなる.................................................................................................................................... 54
18.1.7 BPEL起動アプリケーションが動作しない(J2EE実行環境だけ)............................................................................................. 54
18.1.8 BPEL起動アプリケーションがエラー復帰する........................................................................................................................ 54
18.1.9 想定しないタイムアウトが発生する.......................................................................................................................................... 54
18.1.10 InvokeによるWebサービス呼び出しが失敗する................................................................................................................... 55
18.2 ビジネス・プロセス実行環境作成時の異常....................................................................................................................................55
18.2.1 BPEL定義を配備できない.......................................................................................................................................................55
18.2.2 BPEL起動アプリケーションが作成できない............................................................................................................................55
索引........................................................................................................................................................................................ 56
- vi -
第1章 障害調査資料の採取方法
ここでは、ISIの障害調査資料の採取方法について説明します。
1.1 一括情報採取ツール
Interstage Service Integrator運用中にトラブルが発生した場合は、iscollectinfoコマンドで調査資料を採取します。iscollectinfoコマンド
を、一括情報採取ツールと呼びます。トラブル発生時は、技術員に連絡する前に、本コマンドを使用して調査資料を採取してください。
iscollectinfoは以下の場所に格納されています。
<INSDIR>\bin\collect
/opt/FJSVisco/bin
一括情報採取ツールを使用する前に環境変数スクリプトを実行し環境変数を設定してください。環境変数スクリプトの詳細については
“ISI リファレンス”の“コマンドリファレンス”にある“環境変数の設定”を参照してください。
環境変数を設定していない場合、Interstage Service Integratorが出力する障害情報が採取されない場合があります。
一括情報採取ツールで採取する情報を、以下に示します。
・ Interstage Service Integratorが出力する障害情報
一括情報採取ツールの詳細については“ISI リファレンス”の “iscollectinfo”コマンドを参照してください。
注意
・ 一括情報採取ツールは、トラブルが発生したISIサーバ上で実行してください。
・ 一括情報採取ツールを使用する際は、調査資料の格納先に十分な空き容量があることを確認後、一括情報採取ツールを実行し
てください。容量が不足している状態で一括情報採取ツールを実行した場合は、調査資料の採取に失敗することがあります。
・
一括情報採取ツールで採取した資料を退避する際は、パーミッションやタイムスタンプなどのファイル情報をそのまま複写するよう
必ず cp -pR コマンドで複写してください。
ポイント
一括情報採取ツールで採取されたディレクトリ配下を圧縮し技術員に連絡してください。
FJQSS(資料採取ツール)により、iscollectinfoコマンドと同じ情報を採取できます。FJQSSについては、オンラインマニュアルの“APS
\FJQSS”フォルダを参照してください。
1.2 コアダンプの採取
アプリケーションが異常終了(プロセスが消滅)したときに、各OS上に用意されたコアダンプを採取することにより、異常終了の原因を調
査することができる場合があります。
-1-
1.2.1 Solarisでのコアダンプ採取
ここでは、Solaris上でのコアダンプ採取のための注意事項を説明します。
コアダンプが出力されない場合の確認
コアダンプが出力されない場合の原因として、システムリソース等の問題がまず考えられます。カレントディレクトリの書込み権、ディス
ク容量、limit(1)コマンド結果を確認してください。
1.2.2 Linuxでのコアダンプ採取
ここでは、Linux上でのコアダンプ採取のための注意事項を説明します。
コアダンプが出力されない場合の確認
コアダンプが出力されない場合の原因として、システムリソース等の問題がまず考えられます。カレントディレクトリの書込み権、ディス
ク容量、limit(1)コマンド結果を確認してください。
また、Linuxではハード/OSの出荷時もしくはOSのUpdate適用により、デフォルトでコアダンプの出力が設定されていない場合がありま
す。以下を実施してコアダンプが出力されるようにしてください。
コアダンプ出力設定方法
isstartコマンドでInterstageを起動させる場合
sh(bash)で"ulimit -c unlimited"コマンド実行後、Interstageを起動させます。ワークユニット起動ユーザがInterstage起動ユーザと違
う場合は、ワークユニット起動前に"ulimit -c unlimited"コマンドを実行してから、ワークユニットを起動させます。
RCプロシジャでOS起動時に自動的にInterstageが起動するように設定されている場合
以下の方法を実施することで、OS再起動後にコアダンプが出力されるようになります。
/etc/init.d/functionsファイルに、以下のとおり記述されていますので、
ulimit -S -c 0 >/dev/null 2>&1
または、
ulimit -S -c ${DAEMON_COREFILE_LIMIT:-0} >/dev/null 2>&1
または、
corelimit="ulimit -S -c ${DAEMON_COREFILE_LIMIT:-0}"
上記の設定で"0"または、"${DAEMON_COREFILE_LIMIT:-0}"を、"unlimited"に変更してください。
例）
ulimit -S -c unlimited >/dev/null 2>&1
/etc/rc2.d/S99startisに、以下の（※）の記述を追加してください。
#!/bin/sh# Interstage Application Server
# S99starttis : Interstage Application Server start procedure
OD_HOME=/opt/FJSVod
export OD_HOME
ulimit -c unlimited
（※）
/opt/FJSVod/bin/odalive > /dev/null
while [ "$?" != "0" ]
do
sleep 1
/opt/FJSVod/bin/odalive > /dev/null
done
/opt/FJSVtd/bin/isstart
-2-
第2章 インストール・アンインストール時の異常
ここでは、ISIのインストール・アンインストール時に異常が発生した場合の対処について説明します。
2.1 インストール時の異常
2.1.1 環境変数の設定に失敗した場合
インストール時に環境変数の設定に失敗した場合は、環境変数の設定ができなかったことを示すダイアログが表示されます。
環境変数が設定できませんでした。
インストール終了後、以下のファイルを参照し、環境変数PATHを設定してください。
<INSDIR>\path.txt
以下の手順に従ってシステム環境変数を設定してください。
1. 環境変数の設定画面を表示します。
Windows Server 2003、およびWindows XPの場合
[スタート]メニューの[コントロールパネル]－[システム]－[詳細設定]の[環境変数]ボタンをクリックします。
Windows Server 2008、Windows Vistaの場合、およびWindows 7の場合
[スタート]メニューの[コントロールパネル]－[システム]－[システムの詳細設定]の[環境変数]ボタンをクリックします。
Windows Server 2012、およびWindows 8の場合
[スタート]画面(Windows 8の場合は[アプリ]画面)の[コントロールパネル]－[システムとセキュリティ]－[システム]－[システムの詳
細設定]の[環境変数]ボタンをクリックします。
2. 存在しないパス等、不要と判断されるパスが設定されている場合、不要なパスを削除し、以下のファイルに記述されているPATH
変数の設定を、システム環境変数に追加します。
“<INSDIR>\path.txt”
3. システムを再起動します。
2.1.2 簡易セットアップに失敗した場合
インストール時に簡易セットアップに失敗した場合は、簡易セットアップに失敗したことを示すダイアログが表示されます。
原因として、資源の枯渇等で簡易セットアップが正常に実行できなかった等の理由が考えられます。
以下の対処を実施してください。
Interstage Service Integratorの簡易セットアップの処理中にエラーが発生しました。
以下のファイルを参照し、完了していないセットアップ処理を再度実行してください。
<INSDIR>\var\setup\esibatchsetup.log
対処方法
“<INSDIR>\var\setup\esibatchsetup.log”を参照し、失敗しているセットアップ内容を確認して、再度セットアップ作業を実施してく
ださい。
セットアップの詳細は、“ISI 導入ガイド”の“セットアップの概要”を参照してください。
Interstage Service Integratorの簡易セットアップの処理中にエラーが発生しました。
以下のファイルを参照し、完了していないセットアップ処理を再度実行してください。
/opt/FJSVesi/var/setup/esibatchsetup.log
-3-
対処方法
“/opt/FJSVesi/var/setup/esibatchsetup.log”を参照し、失敗しているセットアップ内容を確認して、再度セットアップ作業を実施してく
ださい。
セットアップの詳細は、“ISI 導入ガイド”の“セットアップの概要”を参照してください。
2.1.3 ターミナルサービスが実行モードの場合のエラー
以下の場合、ターミナルサービスが実行モードの可能性があります。
・ 以下のメッセージが出力された場合
「エラー番号:0x80040702 詳細:dllのロードに失敗しました。:odautosetup」
・ イベントビューアにメッセージihs00012が出力された場合
・ インストールに失敗し、「エラー: is20102:INTERSTAGEの起動に失敗しました 理由コード(10)」のポップアップが出力される。
上記の場合、ISI、およびInterstage Application Serverをアンインストールしたあと、以下のコマンドを実行して、ターミナルサービスをイ
ンストールモードに変更し、再度ISIをインストールしてください。
CHANGE USER /INSTALL
ISIのインストール完了後、以下のコマンドを実行して、ターミナルサービスを実行モードに変更してください。
CHANGE USER /EXECUTE
2.1.4 セットアップステータスでハングアップした場合
セットアップステータス表示中に“Alt”キーを押下しながら“C”キーを押下(Alt+C)、または[Cancel]、[キャンセル]をクリックした場合、
サービスの登録処理に失敗したことを表すポップアップメッセージが表示され、ISIのインストールがハングアップすることがあります。
このような状態になった場合は、ISI、およびInterstage Application Serverの資産・情報を削除したあと、ISIを再インストールしてくださ
い。ISI、およびInterstage Application Serverの資産・情報の削除方法は、以下のラベルのDVD-ROMに格納されている“HowToDel.txt”
を参照してください。
■DVD-ROMのラベル(ISI Standard Editionの場合)
[Windows Server x86 Editions版]
“Interstage Service Integrator Standard Edition メディアパック V9.5.1 サーバパッケージ”
[Windows Server x64 Editions版]
“Interstage Service Integrator Standard Edition メディアパック (64bit) V9.5.1 サーバパッケージ”
■DVD-ROMのラベル(ISI Enterprise Editionの場合)
[Windows Server x86 Editions版]
“Interstage Service Integrator Enterprise Edition メディアパック V9.5.1 サーバパッケージ”
[Windows Server x64 Editions版]
“Interstage Service Integrator Enterprise Edition メディアパック (64bit) V9.5.1 サーバパッケージ”
■ISIの資産・情報の削除方法
“<DVDドライブ>:\ISI\HowToDel.txt”
■Interstage Application Serverの資産・情報の削除方法
“<DVDドライブ>:\APS\HowToDel.txt”
2.1.5 サービスの登録に失敗しハングアップした場合
インストール先フォルダ名に使用できない文字、および記号を指定してインストールすると、サービス登録に失敗して、ISIのインストー
ルがハングアップすることがあります。
このような状態になった場合は、ISI、およびInterstage Application Serverの資産・情報を削除したあと、ISIを再インストールしてくださ
-4-
い。ISI、およびInterstage Application Serverの資産・情報の削除方法は、以下のラベルのDVD-ROMに格納されている“HowToDel.txt”
を参照してください。
■DVD-ROMのラベル(ISI Standard Editionの場合)
[Windows Server x86 Editions版]
“Interstage Service Integrator Standard Edition メディアパック V9.5.1 サーバパッケージ”
[Windows Server x64 Editions版]
“Interstage Service Integrator Standard Edition メディアパック (64bit) V9.5.1 サーバパッケージ”
■DVD-ROMのラベル(ISI Enterprise Editionの場合)
[Windows Server x86 Editions版]
“Interstage Service Integrator Enterprise Edition メディアパック V9.5.1 サーバパッケージ”
[Windows Server x64 Editions版]
“Interstage Service Integrator Enterprise Edition メディアパック (64bit) V9.5.1 サーバパッケージ”
■ISIの資産・情報の削除方法
“<DVDドライブ>:\ISI\HowToDel.txt”
■Interstage Application Serverの資産・情報の削除方法
“<DVDドライブ>:\APS\HowToDel.txt”
2.1.6 インストール時に権限エラーが出力された場合
インストール時に必要な、Administrator権限をもったグループに所属するユーザでログインしていない場合、以下のメッセージが出力
されます。
この製品をインストールまたはアンインストールするための権限がありません。
インストールに関する操作は、Administrator、またはAdministrator権限をもったグループに所属するユーザで行ってください。
インストールを行う前には、“ISI 導入ガイド”の“インストール前の作業”も参照してください。
2.1.7 インストール時にinstall.shが実行できない場合
インストール時に、install.shシェルスクリプトが実行できないことを示す、以下のメッセージが表示された場合。
DVD-ROM上のディレクトリから実行できません。
DVD-ROM上のディレクトリから、install.shシェルスクリプトを実行しています。
任意のディレクトリ上から、DVD-ROMに格納されているinstall.shにDVD-ROMのディレクトリを指定して実行してください。
例）
# cd / <RETURN>
# /cdrom/cdrom0/install.sh /cdrom/cdrom0<RETURN>
2.1.8 インストール時にバージョンエラーが表示される場合
インストール時に、以下のメッセージが表示された場合。
このディストリビューションのバージョンには対応していません。
OSのバージョンとは異なるバージョン用のインストールCDを使用してインストールしようとしています。
インストール環境に合ったインストールCDを使用してインストールしてください。
-5-
2.1.9 セキュリティモードの設定に失敗した場合
インストール時に、セキュリティモードの設定に失敗する場合、以下の原因が考えられます。
必要に応じた対処を行ってください。
システム全体のプロセス数が最大数を超えている
インストール時に、セキュリティモードの設定で以下のメッセージが出力された場合、原因として、システム全体のプロセス数が最大数
を超えた等の理由が考えられます。
ERROR: SETUP-CMD-40003: System error occurred. DETAIL=Pipe file open error. msg=Resource temporarily unavailable
以下の対処を実施してください。なお、作業は管理者権限で行ってください。
1. カーネルパラメタの編集
「/etc/system」ファイルに以下のパラメタを有効にしている場合は、無効にしてください。
max_nprocs
「/etc/sysctl.conf」ファイルに以下のパラメタを有効にしている場合は、無効にしてください。
kernel.threads-max
2. システムの再起動
カーネルパラメタ変更後、システムを再起動してください。
3. ISIの停止
セキュリティモードを設定する前に、ISIを停止してください。
停止方法については、“ISI 運用ガイド”の“ISIサーバの運用管理”を参照してください。
4. Interstage運用グループ変更コマンドの実行
esisetsecuritymodeコマンドでセキュリティモードを設定してください。
esisetsecuritymodeコマンドについては、“ISI リファレンス”を参照してください。
esisetsecuritymode -g グループ名
5. イベントサービスのセットアップ
ismodifyserviceコマンドでイベントサービスをセットアップしてください。
ismodifyserviceコマンドについては、“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照してください。
ismodifyservice -a ES
6. Interstageの起動
以下の順序でInterstageを起動してください。
a.JMXサービスの起動
JMXサービスを起動します。JMXサービスは以下のコマンドで起動します。
ismngconsolestartコマンドについては、“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照してください。
ismngconsolestart
b.Interstageの起動
Interstageを起動します。Interstageは以下のコマンドで起動します。
isstartコマンドについては、“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照してください。
-6-
isstart
7. 簡易セットアップの実行
必要に応じて簡易セットアップを実施してください。
簡易セットアップについては、“ISI 導入ガイド”の“簡易セットアップ”を参照してください。
一時ファイルが削除されずに残っている
何らかの原因により以下のログ出力サービスの一時ファイルが削除されずに残っている可能性があります。ログ出力サービスが停止し
ていることを確認し、以下のファイルを削除してください。ログ出力サービスの停止方法は、“ISI リファレンス”の“apfwstoplog”コマンド
を参照してください。
/var/opt/FJSVapclg/.apfwlogservice.xxxx
(xxxxはPID)
2.2 アンインストール時の異常
2.2.1 アンインストールの失敗後、インストール、アンインストールができない場合
アンインストールに失敗した場合、不要な資源や情報が残ることによりその後、インストール、アンインストールができなくなる場合があ
ります。
このような状態になった場合、DVD-ROMに格納されている“HowToDel.txt”を参照してISI、およびInterstage Application Serverの資
産・情報を削除したあと、ISIを再インストールしてください。
-7-
第1部 J2EE実行環境編
第3章 セットアップ時の異常................................................................................................................................9
第4章 ISI運用管理コンソール操作時の異常..................................................................................................... 12
第5章 ISIクライアント利用時の異常.................................................................................................................. 13
第6章 ISI運用時の異常................................................................................................................................... 17
第7章 サービス連携時の異常.......................................................................................................................... 20
第8章 データ変換時の異常.............................................................................................................................. 25
第9章 バックアップ・リストア時の異常............................................................................................................... 27
第10章 BPEL利用時の異常.............................................................................................................................29
-8-
第3章 セットアップ時の異常
ここでは、ISIのセットアップ時に異常が発生した場合の対処について説明します。
3.1 セットアップに失敗する
3.1.1 データベースのセットアップに失敗する
データベース環境のセットアップ、アンセットアップ時に、以下のメッセージが表示されセットアップもアンセットアップもできない状態に
なった場合
・ セットアップ時
INFO: SETUP-CMD-00002: Setup is already running
INFO: SETUP-CMD-00001: Setup was successful
・ アンセットアップ時
INFO: SETUP-CMD-00003: Setup does not run
INFO: SETUP-CMD-00001: Setup was successful
以下の手順でデータベースのアンセットアップを実施し、再度セットアップを行ってください。
1. 以下のファイルが存在するか確認してください。
<INSDIR>\etc\setup\esijmsrsetup.conf
/etc/opt/FJSVesi/setup/esijmsrsetup.conf
2. １のファイルが存在しない場合は、以下のファイルを１のファイルにコピーしてください。
<INSDIR>\etc\esijmsrsetup.conf
/etc/opt/FJSVesi/esijmsrsetup.conf
3. esiunsetup_dbenvコマンドに「-f」オプションを指定して実行し、データベースをアンセットアップしてください。
4. 再度、データベースのセットアップを実施してください。
データベース環境のセットアップ時に、以下のメッセージが表示された場合
Exception in thread "main" java.lang.UnsupportedClassVersionError: Bad version number in .class file
:
:
ERROR: SETUP-CMD-30001: Failed to execute command(detail=symjddefds)
ERROR: SETUP-CMD-30004: Failed to set up
以下の手順で再度セットアップを行ってください。
1. 環境変数CLASSPATHに設定されているSymfoware JDBCドライバファイル名を以下のように変更してください。
[変更前]
<Symfoware Serverクライアントインストールディレクトリ>\JDBC\fjjdbc\lib\fjsymjdbc4.jar
[変更後]
<Symfoware Serverクライアントインストールディレクトリ>\JDBC\fjjdbc\lib\fjsymjdbc2.jar
-9-
2. Symfoware JDBCネーミングサービスを再起動してください。
3. 再度、データベースのセットアップを実施してください。
3.1.2 ISIサーバのセットアップ/ISIサーバの追加/JMS-Rキューの追加に失敗する
ISIサーバのセットアップ、ISIサーバの追加、JMS-Rキューの追加に失敗する場合、以下の原因が考えられます。
必要に応じた対処を行ってください。
データベースが停止している
以下のエラーが発生し、セットアップに失敗した場合、データベースが停止している可能性があります。データベース起動後、再度セッ
トアップしてください。
ES: エラー: es21299: [111253] データベースでエラーが発生しました。: INFO=[SymfoWARE ODBC Driver] JYP1010E サーバ接続要求
が拒否されました．
JMS-Rキューの最大個数を超過した
マシンで作成可能なJMS-Rキューの最大個数を超過した場合、以下のエラーが発生しセットアップに失敗します。“ISI 導入ガイド”の
“JMS-Rキューの作成”を参照し、JMS-Rキューの追加を行ってください。
ES: エラー: es21102: [071192] メッセージ格納DBテーブルの割当て数(xx)を越えました。
ES: エラー: es21103: [010415] メッセージ格納DBテーブルの割当てに失敗しました。
3.1.3 ISIサーバ連携構成(キュー間転送)のセットアップに失敗する
キュー間転送機能のセットアップに失敗し、再度セットアップしてもキュー間転送機能を起動できない場合、キュー間転送の環境と
キュー間転送定義セットの間で不整合が発生している可能性があります。
以下の手順を実施して、キュー間転送の環境をすべて削除した後に、“ISI 導入ガイド”の“ISIサーバ連携構成のセットアップ(キュー
間転送)”の“セットアップの流れと作業”の「セットアップの実行」以降の手順を再度行ってください。
1. キュー間転送定義の削除
以下のコマンドを実行し、キュー間転送定義を削除します。
esiqctdefclear
2. CORBAサービスからキュー間転送機能の削除
以下のコマンドを実行し、CORBAサービスからキュー間転送機能を削除します。
mqdnsgwrlsserver <自マシンのホストID>
以下のコマンドを実行し、「<他マシンのホストID>NSGWSERVERNAME」が登録されているか確認してください。
odlistns
「<他マシンのホストID>NSGWSERVERNAME」が登録されている場合は、以下のコマンドを実行して削除してください。
OD_or_adm -d -n <他マシンのホストID>NSGWSERVERNAME
3. キュー間転送定義情報の削除
以下のファイルを削除します。
<INSDIR>\var\qctmng\current_host.def
/opt/FJSVesi/var/qctmng/current_host.def
- 10 -
4. キュー間転送の環境再構築
以下のコマンドを実行し、キュー間転送の環境を削除します。
esiunsetenv_qctenv
キュー間転送の環境を削除したあと、以下のコマンドを実行し、キュー間転送の環境を作成します。
esisetenv_qctenv
3.2 アンセットアップに失敗する
3.2.1 データベースのアンセットアップに失敗する
JMS-Rキューの追加でデータベーススペースを追加した状態で、esiunsetup_dbenv コマンドを用いてデータベースの削除を行った場
合、コマンド実行時に以下のエラーが表示されデータベースが削除されません。
rdbddlex -d ESIMESSAGEDB "C:\Interstage\ISI\var\setup\db\dropdatabase.ddl"
qdg12226e:データベース削除文の実行で重症エラーを検出しました 詳細メッセージ='JYP4383E 指定されたデータベースにはデータベー
ススペースが定義されているので削除できません．' エラーが発生した文の先頭位置=1 (システム名=RDBESI)
qdg02201u:rdbddlexが異常終了しました 復帰コード 01 (システム名=RDBESI)
ERROR: SETUP-CMD-30001: Failed to execute command(detail=rdbddlex)
上記メッセージが出力された場合、以下の手順により追加したデータベーススペースを削除して、再度データベースを削除してくださ
い。
1. ISIで使用しているデータベース（デフォルトはESIMESSAGEDB）に追加したデータベーススペースが設定されているか確認し、
設定されている場合はデータベーススペースを削除してください。
2.
<INSDIR>\etc\esijmsrsetup.conf を <INSDIR>\etc\setup\esijmsrsetup.conf にコピーしてください。
/etc/opt/FJSVesi/esijmsrsetup.conf を /etc/opt/FJSVesi/setup/esijmsrsetup.conf にコピーしてください。
3. esiunsetup_dbenvコマンドに「-f」オプションを指定して実行し、データベースを削除してください。
- 11 -
第4章 ISI運用管理コンソール操作時の異常
ここでは、ISI運用管理コンソール操作時に異常が発生した場合の対処について説明します。
4.1 ログインに失敗する
4.1.1 ログイン時の異常
以下のエラーが出力される場合があります。
・ Internet Explorer 6以外の場合
Internet Explorerではこのページは表示できません
・ Internet Explorer 6の場合
サーバが見つからないか、DNSエラーです
上記エラーが出力される場合、ISI運用管理コンソールが動作するために必要なサービスが起動されていない可能性があります。“ISI
運用ガイド”の“ISI運用管理コンソールの起動”を参照し、ISI運用管理コンソールを起動してください。
4.2 実行モニタの表示が正しくない
4.2.1 登録したシーケンス定義、サービスエンドポイント定義が表示されない
ISI運用管理コンソールにログイン中に、シーケンス定義やエンドポイント定義を変更した場合、以下の現象が発生します。
・登録した定義情報が表示されない
・削除した定義情報が表示されている
いったんログアウト後、再度ログインしてください。実行モニタに最新の状態が反映されます。
- 12 -
第5章 ISIクライアント利用時の異常
ここでは、ISI StudioまたはFormatmanagerクライアントの利用時に異常が発生した場合の対処について説明します。
5.1 ISIの定義に関する異常
5.1.1 ISIの定義の登録でエラーダイアログが表示される
定義の登録で以下の内容のエラーダイアログが表示される場合
サーバ接続に失敗しました。接続先を見直してください。
または、接続先のWebサーバが起動しているか確認してください。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ 接続先の指定に誤りがあります。接続先を確認してください。
・ Webサーバが停止している可能性があります。Webサーバが起動しているかどうか確認してください。
・ ISI運用管理コンソールが停止している可能性があります。ワークユニット「ESIAdminServer」が起動しているかどうか確認してくだ
さい。
定義の登録で以下の内容のエラーダイアログが表示される場合
ISI Studioからのリクエストによる定義の登録に失敗しました。
ISIサーバ側のトレースログを確認してください。
以下のトレースログを確認してください。
<INSDIR>\var\log\trace\trace.log
/opt/FJSVesi/var/log/trace/trace.log
定義の登録で以下の内容のエラーダイアログが表示される場合
ISI Studioからのリクエストによる定義検証に失敗しました。
ISIサーバ側のトレースログを確認してください。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ ISI定義の必須項目の設定が不足している可能性があります。必須項目を設定してください。
・ ディスクに十分な空き領域がない可能性があります。空き領域を確認してください。
以下のトレースログを確認してください。
<INSDIR>\var\log\trace\trace.log
/opt/FJSVesi/var/log/trace/trace.log
- 13 -
定義の登録で以下の内容のエラーダイアログが表示される場合
定義エラーが存在します。対象プロジェクトの更新を行い、ISI問題を確認してください。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ ISI定義の必須項目の設定が不足している可能性があります。必須項目を設定してください。
・ 登録対象のISIプロジェクトに対する権限がない可能性があります。権限を確認してください。
5.1.2 ISIの定義の配置でエラーダイアログが表示される
定義の配置で以下の内容のエラーダイアログが表示される場合
定義の配置に失敗しました。
ISIサーバ側のトレースログを確認してください。
以下のトレースログを確認してください。
<INSDIR>\var\log\trace\trace.log
/opt/FJSVesi/var/log/trace/trace.log
下記の原因が考えられます。原因ごとに対処を行ってください。
・ 配置先情報ファイルに誤りがある可能性があります。配置先情報ファイルを確認してください。
・ サーバ環境の登録先のISIプロジェクトに、一意でないISIサーバ名が指定されたサービスエンドポイント定義が存在する可能性が
あります。一意のISIサーバ名が指定されたサービスエンドポイント定義にして、全置換えで定義を登録しなおしてください。
5.1.3 ISIの定義の取得でエラーダイアログが表示される
定義の取得で以下の内容のエラーダイアログが表示される場合
サーバ接続に失敗しました。接続先を見直してください。
または、接続先のWebサーバが起動しているか確認してください。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ 接続先の指定に誤りがあります。接続先を確認してください。
・ Webサーバが停止している可能性があります。Webサーバが起動しているかどうか確認してください。
・ ISI運用管理コンソールが停止している可能性があります。ワークユニット「ESIAdminServer」が起動しているかどうか確認してくだ
さい。
定義の取得で以下の内容のエラーダイアログが表示される場合
ISI Studioからのリクエストによる定義取得に失敗しました。
ISIサーバ側のトレースログを確認してください。
以下のトレースログを確認してください。
<INSDIR>\var\log\trace\trace.log
- 14 -
/opt/FJSVesi/var/log/trace/trace.log
定義の取得で以下の内容のエラーダイアログが表示される場合
ISI Studioでエラーが発生しました。[詳細=内部エラーが発生しました。]
ISI Studio環境が異常状態です。環境を確認してください。
下記の原因が考えられます。原因の対処を行ってください。
・ ワークスペースにISI定義を書き込み出来ない可能性があります。IS Studioを再起動してください。
5.1.4 ISIサービスシミュレートでエラーダイアログが表示される
ISIサービスシミュレートで以下の内容のエラーダイアログが表示される場合
サービスエンドポイント定義にESIServer以外のISIサーバが指定されています。
サービスエンドポイント定義で指定するISIサーバはESIServerを指定してください。
下記の原因が考えられます。原因の対処を行ってください。
・ サービスエンドポイント定義に「ESIServer」以外のISIサーバが指定されています。サーバ環境が定義を分けた運用の場合、実行
するシーケンスが含まれるISIプロジェクトのサービスエンドポイント定義で「ESIServer」以外のISIサーバが指定されていると、ISI
サービスシミュレートができません。サービスエンドポイント定義で指定するISIサーバは「ESIServer」を指定してください。
5.1.5 ISIの定義の配置で定義が配置されない
下記の原因が考えられます。原因の対処を行ってください。
・ ISI定義を分けて運用する設定を行っている場合には、ISI運用管理コンソールの再起動を行っていない可能性があります。ISI運
用管理コンソールの起動・停止については、“ISI 運用ガイド”の“ISI運用管理コンソールのヘルプ”を参照してください。
5.1.6 登録した定義が反映されない
下記の原因が考えられます。原因の対処を行ってください。
・ 異なるISIプロジェクトからサーバに定義を登録された可能性があります。誤って定義をサーバに登録してしまった場合、サーバの
backupディレクトリ配下に、定義を登録したISIクライアントのIPアドレスごとにディレクトリが作成されます。そこから定義をリストアで
きます。バックアップした定義をリストアする方法は、“ISI リファレンス”の“esidefrestore”を参照してください。
バックアップした定義は、以下のディレクトリ配下に格納されます。
“<INSDIR>\var\temp\backup”
“/opt/FJSVesi/var/temp/backup”
【バックアップファイル名】
backupディレクトリ配下に、定義を登録したISIクライアントのIPアドレスごとにディレクトリが作成されます。以下は、IPアドレスが
“10.10.10.100”のISIクライアントから登録した例です。
例）
“<INSDIR>\var\temp\backup\10.10.10.100”
“/opt/FJSVesi/var/temp/backup/10.10.10.100”
この配下に、“yyyyMMdd_HHmmssSSS.zip”(ミリ秒までの日時のzip形式)というファイル名でバックアップファイルが作成されます。
例）“20091025_094015234.zip”
ISI 定 義 を 分 け て 運 用 す る 場 合 、 こ の 配 下 に 、 登 録 対 象 の ISI プ ロ ジ ェ ク ト 名 が 追 加 さ れ た “ ISI プ ロ ジ ェ ク ト 名
- 15 -
_yyyyMMdd_HHmmssSSS.zip”(ミリ秒までの日時のzip形式)というファイル名でバックアップファイルが作成されます。
例）“ISIprj_20091025_094015234.zip”
5.2 Formatmanagerの変換テーブルに関する異常
5.2.1 変換テーブル生成でエラーダイアログが表示される
変換テーブル生成で以下の内容のエラーダイアログが表示される場合
FTPサーバへの接続に失敗しました。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ サーバ転送先設定が誤っている可能性があります。メニューの「設定」＞「サーバ転送先設定」を選択し、「サーバ転送先設定」ダ
イアログの「サーバ名」、「ログイン」、「パスワード」が正しく設定されているか確認してください。
・ 転送先のFTPサーバが起動していない可能性があります。FTPサーバを起動してください。
5.2.2 変換テーブル取得でエラーダイアログが表示される
変換テーブルの取得に失敗する場合、以下の原因が考えられます。
必要に応じた対処を行ってください。
FTPサーバの設定が誤っている
変換テーブル取得で以下の内容のエラーダイアログが表示される場合
FTPサーバへの接続に失敗しました。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ サーバ転送先設定が誤っている可能性があります。メニューの「設定」＞「サーバ転送先設定」を選択し、「サーバ転送先設定」ダ
イアログの「サーバ名」、「ログイン」、「パスワード」が正しく設定されているか確認してください。
・ 取得元のFTPサーバが起動していない可能性があります。FTPサーバを起動してください。
ファイルが破損している
変換テーブル取得で以下の内容のエラーダイアログが表示される場合
変換テーブルの取得に失敗しました。
変換テーブルのファイルが破損している可能性があります。TABLEINFO.FCVファイルのファイルサイズが0バイトではないことを確認
してください。ファイルサイズが0バイトの場合は変換テーブルファイルが破損しています。正しい変換テーブルファイルを配置してくだ
さい。
5.3 Formatmanagerの定義に関する異常
5.3.1 Formatmanagerクライアントが正しく動作しない
「データベースのアクセス中にエラーが発生しました」と表示される、またはFormatmanagerクライアントが起動しない、または[変換パラ
メタID情報ファイル出力]画面で出力ボタンを押下しても処理が終了しない場合は、Windowsシステムディレクトリに他のバージョンの
JDK/JREが存在している可能性があります。
Windowsシステムディレクトリに他のバージョンのJDK/JREが存在していないか確認してください。
- 16 -
第6章 ISI運用時の異常
ここでは、ISIの運用時に異常が発生した場合の対処について説明します。
6.1 ISIの定義変更時のトラブル
6.1.1 ISIの定義変更が実行結果に反映されない
以下の原因が考えられます。必要に応じた対処を行ってください。
・ ISIの定義が配置されていない可能性があります。定義の配置については、“ISI アプリケーション開発ガイド”の“定義の作成と登
録”を参照してください。
・ メディエータファンクション定義が登録されていない可能性があります。esideflistコマンドを使用して、メディエータファンクション定
義が登録されているか確認してください。登録されていない場合は、esidefaddコマンドを使用して配置しようとするワークディレクト
リに対してメディエータファンクション定義を登録してください。esideflistコマンド、およびesidefaddコマンドの詳細は、“ISI リファレ
ンス”の“esideflist”コマンド、および“esidefadd”コマンドを参照してください。
・ 異なるISIプロジェクトからサーバに定義を登録・配置された可能性があります。誤って定義をサーバに登録・配置してしまった場
合、サーバのbackupディレクトリ配下に、定義を登録したISIクライアントのIPアドレスごとにディレクトリが作成されます。そこから定
義をリストアできます。リストアした定義を配置してください。バックアップした定義をリストアする方法は、“ISI リファレンス”の
“esidefrestore”を参照してください。定義を配置する方法は、“ISI リファレンス”の“esidefdeploy”を参照してください。
バックアップした定義は、以下のディレクトリ配下に格納されます。
“<INSDIR>\var\temp\backup”
“/opt/FJSVesi/var/temp/backup”
【バックアップファイル名】
backupディレクトリ配下に、定義を登録したISIクライアントのIPアドレスごとにディレクトリが作成されます。以下は、IPアドレスが
“10.10.10.100”のISIクライアントから登録した例です。
例）
“<INSDIR>\var\temp\backup\10.10.10.100”
“/opt/FJSVesi/var/temp/backup/10.10.10.100”
この配下に、“yyyyMMdd_HHmmssSSS.zip”(ミリ秒までの日時のzip形式)というファイル名でバックアップファイルが作成されます。
例）“20091025_094015234.zip”
ISI 定 義 を 分 け て 運 用 す る 場 合 、 こ の 配 下 に 、 登 録 対 象 の ISI プ ロ ジ ェ ク ト 名 が 追 加 さ れ た “ ISI プ ロ ジ ェ ク ト 名
_yyyyMMdd_HHmmssSSS.zip”(ミリ秒までの日時のzip形式)というファイル名でバックアップファイルが作成されます。
例）“ISIprj_20091025_094015234.zip”
6.2 非同期メッセージング構成のISIサーバ運用時のトラブル
6.2.1 メッセージがサービス提供側アプリケーションへ届かない
メッセージがサービス提供側アプリケーションへ届かない場合、キューの読み込みが停止している可能性があります。キュー読み込み
稼動状態の確認後、キューの読み込みが停止している場合はキュー読み込みを起動してください。
1. キュー読み込み稼動状態の確認方法
ISI運用管理コンソールの[実行モニタ]画面でキュー滞留件数を表示し、キュー読み込み稼動状態の項目が“停止”となってい
な い か 確 認 し て く だ さ い 。 ま た 、 キ ュ ー 読 み 込 み 稼 動 状 態 は esiqueuereadstatus コ マ ン ド で も 確 認 す る こ と が で き ま す。
esiqueuereadstatusコマンドの詳細は“ISI リファレンス”を参照してください。
- 17 -
2. キュー読み込みの起動
ISI運用管理コンソールの[実行モニタ]画面でキュー滞留件数を表示し、キュー読み込み起動を実行してください。以下の条件
をすべて満たす場合、キュー読み込みの起動に失敗します。キュー読み込みの起動に失敗する場合は、再度異常メッセージの
リカバリ・削除の手順から対処してください。
－ 順番保証運用を行っている。
－ 異常メッセージのリカバリ・削除が行われていない。
また、キュー読み込みの起動はesiqueuereadstartコマンドでもできます。esiqueuereadstartコマンドの詳細は“ISI リファレンス”を参
照してください。
6.2.2 メッセージを送信したが、シーケンス処理が開始されない
メッセージを送信したが、シーケンス処理が開始されない場合、キューの読み込みが停止している可能性があります。キュー読み込み
稼動状態の確認後、キューの読み込みが停止している場合はキュー読み込みを起動してください。
1. キュー読み込み稼動状態の確認方法
ISI運用管理コンソールの[実行モニタ]画面でキュー滞留件数を表示し、キュー読み込み稼動状態の項目が“停止”となってい
な い か 確 認 し て く だ さ い 。 ま た 、 キ ュ ー 読 み 込 み 稼 動 状 態 は esiqueuereadstatus コ マ ン ド で も 確 認 す る こ と が で き ま す。
esiqueuereadstatusコマンドの詳細は“ISI リファレンス”を参照してください。
2. キュー読み込みの起動
ISI運用管理コンソールの[実行モニタ]画面でキュー滞留件数を表示し、キュー読み込み起動を実行してください。以下の条件
をすべて満たす場合、キュー読み込みの起動に失敗します。キュー読み込みの起動に失敗する場合は、再度異常メッセージの
リカバリ・削除の手順から対処してください。
－ 順番保証運用を行っている。
－ 異常メッセージのリカバリ・削除が行われていない。
また、キュー読み込みの起動はesiqueuereadstartコマンドでもできます。esiqueuereadstartコマンドの詳細は“ISI リファレンス”を参
照してください。
6.2.3 シーケンス終了時にエラーメッセージが出力される
シーケンス終了時に以下のエラーメッセージが出力される場合があります。
JMS:INFO:jms2551: Local transaction timeout has occurred. METHOD 'ChannelUtil.local_commit', EXCEPTION
'org.omg.CORBA.COMM_FAILURE: CORBA_Request_get_response vmcid: 0x464a0000 minor code: 2501 completed: No'
JMS:ERROR:jms2113: Operation 'commit' failed.
上記エラーが発生する場合、トランザクションのタイムアウトが発生しています。
下記の比較式で示されるように、シーケンス処理にかかる時間が、JMSのローカルトランザクションタイムアウト時間とCORBAサービス
のクライアントのタイムアウト時間より小さくなるようにチューニングしてください。
シーケンス処理にかかる時間 ＜ JMSのローカルトランザクションタイムアウト時間 ＜ CORBAサービスのクライアントのタイムアウト
時間
・ JMSのローカルトランザクションタイムアウト時間の設定方法については、“Interstage Application Server J2EE ユーザーズガイド(旧
版互換)”の“イベントチャネル動作環境の変更”を参照してください。
・ CORBAサービスのクライアントのタイムアウト時間の設定方法については、“Interstage Application Server チューニングガイド”の
“period_receive_timeout”パラメタを参照してください。
6.3 シーケンスリトライに関するトラブル
6.3.1 非同期メッセージング構成のISIサーバで、シーケンスリトライが実行されない
非同期メッセージング構成のISIサーバで、シーケンスリトライを実行する場合はISIサーバのチューニングが必要です。
- 18 -
サービスエンドポイントの通信方式が非同期である場合、シーケンスのリトライ回数はInterstage Application Serverの“異常時のメッセー
ジ退避機能”のリトライカウントで設定します。リトライカウントは以下の２箇所を指定してください。
・ [Interstage管理コンソール] > [Interstage Application Server] > [システム] > [ワークユニット] > [ESIServer] > [ESIInboundQueue.jar]
> [ESIInboundQueue] > [アプリケーション環境定義]の[異常時メッセージ退避定義]の[リトライカウント]を指定します。
・ [Interstage管理コンソール] > [Interstage Application Server] > [システム] > [ワークユニット] > [ESIServer_Outbound] >
[ESISendQueue.jar] > [ESISendQueue] > [アプリケーション環境定義]の[異常時メッセージ退避定義]の[リトライカウント]を指定しま
す。
また、互換モードのISIサーバを運用している場合、シーケンスのリトライ回数はシーケンス定義で指定してください。指定方法の詳細
については“ISI Studio ヘルプ”の“シーケンス情報を設定する”を参照してください。
6.4 ISIの起動/停止に関するトラブル
6.4.1 Interstageの起動に失敗する場合
Interstageの起動時に以下のメッセージが出力された場合、Interstageの初期化に失敗している可能性があります。Interstageの初期化
処理が失敗した原因を取り除いて、再度初期化処理を行ってください。
ERROR: is20102:INTERSTAGE unable to start
Reason code(3)
6.5 クラスタシステムに関するトラブル
6.5.1 ワークユニットが異常終了してもクラスタシステムが切り替わらない
ワークユニットはクラスタシステムの監視対象外です。異常終了したワークユニットの自動再起動は、ワークユニット定義で設定してくだ
さい。
ワークユニットの自動再起動については、“Interstage Application Server 運用ガイド(基本編)”を参照してください。
- 19 -
第7章 サービス連携時の異常
ここでは、ISIの各種サービス連携時に異常が発生した場合の対処について説明します。
7.1 メッセージの送受信に失敗する
7.1.1 アダプタ連携共通
7.1.1.1 ISIサーバから、サービス提供側アプリケーションへの接続に失敗する
以下の原因が考えられます。必要に応じた対処を行ってください。
・ サービスエンドポイント定義の設定に誤りがある可能性があります。サービスエンドポイント定義の内容に誤りがないか確認してくだ
さい。
・ サービス提供側アプリケーションが起動していない場合があります。サービス提供側のアプリケーションが起動しているかどうか確
認してください。
・ ISIがインストールされているサーバとは別のサーバと通信している場合、正しく通信が行われていない可能性があります。ネット
ワーク、ファイアウォールの設定を見直してください。
7.1.1.2 サービス利用側アプリケーションから、ISIサーバへの接続に失敗する
以下の原因が考えられます。必要に応じた対処を行ってください。
・ サービス利用側アプリケーションで設定されている、ISIサーバのアドレスが間違っている可能性があります。サービス利用側アプ
リケーションの設定に誤りがないか確認してください。
・ ISIがインストールされているサーバとは別のサーバから通信している場合、正しく通信が行われていない可能性があります。ネット
ワーク、ファイアウォールの設定を見直してください。
・ アダプタ、ISIサーバが起動していない可能性があります。アダプタ、ISIサーバが起動しているかどうか確認してください。
7.1.2 CORBA連携時
7.1.2.1 ISIからCORBAサーバに接続できない
ISIからCORBAサーバに接続できない場合は、以下の原因が考えられます。必要に応じた対処を行ってください。
・ 接続先サーバの名前解決に失敗している場合があります。システムログもしくはイベントログを参照して、odで始まるメッセージが
同時刻に出力されていないか確認してください。
・ サービスエンドポイント定義に設定されている、ポート番号に誤りがある可能性があります。システムログもしくはイベントログを参照
して、odで始まるメッセージが同時刻に出力されていないか確認してください。
7.1.2.2 CORBAクライアントからISIサーバに接続できない
CORBAクライアントからISIサーバに接続できない場合、ネーミングサービスの設定に誤りがある可能性があります。
ネーミングサービスの設定を確認してください。ネーミングサービスの設定については、“ISI 導入ガイド”の“CORBAクライアントの設
定”を参照してください。
7.1.2.3 コンポーネントトランザクションサーバアプリケーションからのデータを取得できない
コンポーネントトランザクションサーバアプリケーションは、オペレーションの型としてlongおよびoneway voidのみ用意されています。し
かし、ISIのCORBAアダプタで連携する場合、サーバアプリケーションの復帰値はvoid型である必要があります。
コンポーネントトランザクションサーバアプリケーションと連携する場合は、long型の復帰値を受け取るカスタムアダプタを作成してくだ
さい。
- 20 -
7.1.2.4 ISIからメッセージを受信したCORBAサーバ側で電文長が0になっている
ペイロードが空の状態でCORBAアダプタからデータが送信された可能性があります。シーケンスの処理内容、およびサービス利用側
アプリケーションが送信したデータを見直して、CORBAアダプタへ送信されるデータが空になっていないか確認してください。
7.1.3 DB連携時
7.1.3.1 ISIからDBへのアクセスに失敗する
ISIからDBへのアクセスに失敗する場合、以下の原因が考えられます。必要に応じた対処を行ってください。
・ JDBCデータソースの情報に誤りがあるか、変更された可能性があります。JDBCデータソースの情報を確認の上、DBアダプタが動
作しているワークユニットを再起動してください。
・ 対象のDBサーバ用のJDBCドライバがインストールされていないか、JDBCドライバが設定されていない可能性があります。JDBCド
ライバの設定を見直してください。JDBCドライバの設定方法については、“ISI 導入ガイド”の“データベースアダプタ利用時の設
定”を参照してください。
7.1.4 SOAP連携時
7.1.4.1 SOAPメッセージを送信すると、クライアントにSOAP Faultが返ってくる
SOAPメッセージを送信時、クライアントにSOAP Faultが返ってくる場合、以下の原因が考えられます。必要に応じた対処を行ってくだ
さい。
送信先のURLに誤りがある
サービス利用側アプリケーションで設定している送信先のURLに誤りがある可能性があります。送信先のURLが、以下のアドレス
になっているか確認してください。
－ “SOAP”サービスエンドポイントに送信する場合
http://ホスト名:ポート番号/esisoap/ESISoapMsgServer?サービスエンドポイント名
追加SOAPアダプタを指定する場合、“esisoap”の部分が“esisoap_識別子”に変わります。
－ 互換機能の“JAX-RPC”サービスエンドポイントに送信する場合
http://ホスト名:ポート番号/esisoap/services/ESISoapRpcProvider
Webサーバ（FJapache）起動していない
Webサーバ（FJapache）起動していない可能性があります。Interstage Application Serverのマニュアルを参照し、Webサーバを起動
してください。
応答電文はSOAPの形式になっていない
応答電文はSOAPの形式になっていない可能性があります。ISIのSOAPアダプタでは、共通メッセージのペイロードのXMLがSOAP
電文（Envelope含む）になっていることを前提としています。応答電文の形式も、SOAP電文の形式となるようにシーケンスを設計し
てください。
サポートされていない形式のSOAPメッセージを送信している
サポートされていない形式のSOAPメッセージを送信している可能性があります。ISIのSOAPアダプタは、SOAPの1.1に対応してい
ます。
7.1.5 ファイル転送連携時
7.1.5.1 ファイル監視アダプタで、ファイルが受信されない
ファイル監視アダプタで、ファイルが受信されない場合、以下の原因が考えられます。必要に応じた対処を行ってください。
- 21 -
サービスエンドポイント定義の設定に誤りがある
サービスエンドポイント定義の設定に誤りがある可能性があります。正しいファイルパスが設定されているか、確認してください。相
対パスは指定できません。
ファイルの読み込み権限が不足している可能性があります
受信対象のファイルもしくはディレクトリに、Interstage運用グループのユーザで読み込み可能な権限を付与してください。
取得間隔が長いため、ファイル受信が実行されていない
取得間隔が長いため、ファイル受信が実行されていない可能性があります。
ファイル監視アダプタの監視間隔は、デフォルトで5分の設定です。設定値を変更したい場合は、“ISI 導入ガイド”の“ファイル監視
の設定”を参考に、監視間隔を変更してください。
7.1.5.2 ファイル監視アダプタの実行で、“FTS-SV-33010”、“ESI-API-40031”のエラーが発
生する
ファイル監視アダプタの実行で“FTS-SV-33010”、“ESI-API-40031”のエラーが発生する場合，以下の原因が考えられます。必要に応
じた対処を行ってください。
・ 「クライアントのメッセージ保証」で作成した退避用JMSキューで使用するユニットが容量不足となっている可能性があります。退避
用JMSキューにデータが残ったままになっていないか、ご確認ください。
・ Unix系システムの場合、OSのカーネルパラメタのチューニングが行われていない可能性があります。OSのカーネルパラメタのチュー
ニングが行われていない場合、カーネルパラメタのチューニングについては、“ISI 導入ガイド”の“カーネルの編集”を参照してく
ださい。
7.1.5.3 ISIからのFTP送信に失敗する
FTPサーバがない、FTPサーバの設定に誤りがある
ISIからのFTP送信に失敗する場合、サービス提供側にFTPサーバがないか、FTPサーバの設定に誤りがある可能性があります。
サービスエンドポイント定義で設定したユーザID、パスワード、ディレクトリにFTP送信が実行できるか、OSのFTPコマンドを使用して
確認してください。
FTPサーバの設定が正しい
以下の条件の場合、FTP送信時に“FTS-SV-34003”のエラーが発生する場合があります。
－ FTP送信のサービスエンドポイントにて、[転送結果の確認]チェックボックスをオンにしている、かつ
－ FTP送信先のサーバにて、定期的にファイルを取得するアプリケーションが動作している
上記条件の場合、FTP送信が完了した直後に、ファイルを取得するアプリケーションがファイルを取得し、削除することがあります。
この場合、ISIから転送結果を確認した時にFTP送信先のサーバでファイルが見つからないため、“FTS-SV-34003”のエラーが発生
します。
ファイル転送は正常終了しているため、再度FTP送信を行うとメッセージが冗送する可能性があります。FTP送信先のサーバで該
当するファイルが受信済みかどうかを確認してください。
上記エラーを回避するには、FTP送信のサービスエンドポイントにて、[転送結果の確認]チェックボックスをオフにします。
[転送結果の確認]チェックボックスをオフにする方法については、“ISI Studio ヘルプ”の“FTPの定義”を参照してください。
7.1.6 MQD連携時
7.1.6.1 MQDシステムからメッセージが受信されない
MQD連携において、連携対象のMQDシステムからISIでメッセージを受信できない場合、連携対象のMQDシステムが起動していな
い可能性があります。
連携対象のMQDシステムを起動したあと、インバウンドのMQDアダプタを再起動してください。
- 22 -
7.1.7 MQ連携時
7.1.7.1 ISIが受信したメッセージのMsgIdの値が正しくない
バイナリ型の値を変換する際の文字コードが正しく指定されていない可能性があります。ISIの環境設定ファイルの以下のキー値が、
使用しているMQキュー・マネージャーのCodedCharSetId属性に指定した文字セットの内容と一致しているか、確認してください。
キー値：com.fujitsu.esi.mqmd.transcharset
設定の詳細については、“ISI 導入ガイド”の“環境のカスタマイズ”を参照してください。
7.1.7.2 連携処理が失敗する
変換エラーなどで連携処理（シーケンス）が失敗した場合、インバウンドのMQアダプタは停止します。
システムログまたはイベントログを参照して、エラーになった原因を取り除き、停止したインバウンドのMQアダプタを再起動してくださ
い。
インバウンドのMQアダプタの再起動方法については、“ISI 運用ガイド”の“起動”を参照してください。
7.1.7.3 インバウンドのMQアダプタが異常終了する
システムログまたはイベントログを参照して、エラーになった原因を取り除き、インバウンドのMQアダプタを起動してください。
受信元のWebSphere MQのキューからのメッセージの受信が完了する前に異常終了した場合、メッセージの冗送が発生する場合があ
ります。ISIでは冗送を検知できないため、サービス提供側アプリケーションで冗送を検知・対処してください。
インバウンドのMQアダプタの再起動方法については、“ISI 運用ガイド”の“起動”を参照してください。
7.1.7.4 アウトバウンドのMQアダプタが異常終了する
アウトバウンドのMQアダプタは、異常終了時に自動的に再起動します。システムログまたはイベントログを参照して、エラーになった原
因を確認し、必要に応じて対処を行ってください。
7.1.8 III連携時
7.1.8.1 IIIとのメッセージ送受信で異常が発生する
ISIからIIIサーバに接続できない場合は、以下の原因が考えられます。必要に応じた対処を行ってください。
・ IIIサーバが起動していない可能性があります。IIIサーバが起動しているか確認してください。
・ IIIの環境がセットアップされていない可能性があります。IIIの“サーバの環境”と“サービスバス連携入力・出力の環境”がセットアッ
プされているか確認してください。IIIの環境のセットアップ方法についてはIIIのセットアップガイドを参照してください。
7.1.9 ISIクライアント連携時
7.1.9.1 ISIクライアントからISIサーバに接続できない
ISIクライアントからISIサーバに接続できない場合は、以下の原因が考えられます。必要に応じた対処を行ってください。
・ ISIクライアントにサービスエンドポイント定義がインポートされていない可能性があります。ISIクライアントの運用環境にサービスエ
ンドポイント定義がインポートされているか確認してください。
・ od10925のメッセージが出力されている場合は、ISIクライアントのシステム日付が変更されたことによるタイムアウトが発生した可能
性があります。Interstageを停止せずにシステム日付を変更していないか確認してください。
- 23 -
7.2 アダプタの起動で失敗する
7.2.1 ファイル監視アダプタが起動しない（ファイル転送連携時）
ファイル監視アダプタが起動しない場合、以下の原因が考えられます。必要に応じた対処を行ってください。
ファイル監視アダプタのWindowsサービスが開始のままになっている
ファイル監視アダプタが異常終了した場合、ファイル監視アダプタのWindowsサービスが開始のままになっている場合があります。
「Interstage Service Integrator File Transfer Service」の動作状態を確認し、「状態」が「開始」の場合は「esiftsstop」コマンドもしくはISI
運用管理コンソールからファイル監視アダプタを停止後、再度起動してください。
制御ファイルが残っている
制御ファイルが残っているために、ファイル監視アダプタが起動しない可能性があります。サーバダウンや、プロセスダウンにより
ファイル監視アダプタが異常終了した場合、制御ファイルが残ってしまう場合があります。以下の制御ファイルが存在する場合、削
除してください。
%ESI_HOME%\var\lock\esiftsservice.lock
/opt/FJSVesi/var/lock/esiftsservice.lock
7.2.2 MQアダプタが起動しない（MQ連携時）
MQアダプタが起動しない場合、以下の原因が考えられます。必要に応じた対処を行ってください。
インバウンドルーティング名が指定されていない
インバウンドのMQアダプタが起動しない場合、インバウンドMQアダプタ設定ファイルにインバウンドのMQアダプタで使用するイン
バウンドルーティング名が指定されていない可能性があります。“ISI 導入ガイド”の“MQアダプタ利用時の設定”を参照してインバ
ウンドルーティング名が正しく設定されているか確認してください。
キュー・マネージャーが起動していない
インバウンドのMQアダプタまたはアウトバウンドのMQアダプタが起動しない場合、WebSphere MQのキュー・マネージャーが起動
していない可能性があります。MQアダプタのセットアップ時に指定したWebSphere MQのキュー・マネージャーを起動してください。
WebSphere MQのキュー・マネージャーの起動方法は、WebSphere MQの関連マニュアルを参照してください。
7.2.3 MQD受信が起動しない（MQD利用時）
MQD受信が起動しない場合、以下の原因が考えられます。必要に応じた対処を行ってください。
インバウンドルーティング名が指定されていない
MQD受信環境定義ファイルにインバウンドルーティング名が指定されていない可能性があります。“ISI 導入ガイド”の“MQD受信
の設定”を参照してインバウンドルーティング名が正しく設定されているか確認してください。
- 24 -
第8章 データ変換時の異常
ここでは、ISIの各種データ変換実行時に異常が発生した場合の対処について説明します。
8.1 起動/停止に失敗する
8.1.1 Formatmanager変換機能が起動しない
Formatmanager変換機能が起動しない場合、以下の原因が考えられます。
・ 変換テーブルが登録されていない。
・ 変換テーブルが破損している。
・ 異なるバージョンの変換テーブルが配置されている。
システムログもしくはイベントログを参照して、FM-SVで始まるメッセージを確認し、“ISI メッセージ集”を参照の上、対処してください。
8.2 メッセージが正しく変換されない
8.2.1 リソースの変更内容が、実行結果に反映されない
Formatmanagerの変換テーブルや利用者プログラムなどのリソースを変更したが、実行結果に反映されない場合、以下の原因が考え
られます。必要に応じた対処を行ってください。
活性変更コマンドが実行されていない
活性変更コマンドが実行されていない可能性があります。
“ISI 運用ガイド”の“Formatmanagerの運用管理”を参照して、活性変更コマンドを実行してください。
注意
FEDITシステムパラメタ定義ファイルの以下の定義文の設定を変更した場合は、活性変更コマンドでは有効になりません。
Formatmanager変換機能を再起動してください。
－ CharCodeConversionRule
－ UseCharsetManager
Formatmanager変換機能が再起動されていない
Formatmanager変換機能（ISIサーバ一体型の場合はISIサーバ）が再起動されていない可能性があります。
活性変更コマンドで変更できない設定については、Formatmanager変換機能（ISIサーバ一体型の場合はISIサーバ）を再起動させ
ることにより変更を反映させる必要があります。
Formatmanager変換機能の再起動方法については、“ISI 導入ガイド”の“Formatmanagerの設定“を参照してください。
8.2.2 変換結果が文字化けする
メッセージの変換結果が文字化けする場合、以下の原因が考えられます。必要に応じた対処を行ってください。
変換定義とデータが合っていない
ユーザ固有フォーマットのフォーマット変換の場合は、基準となる文字コードが変換テーブルの文字コードで決定されます。“ISI ア
プリケーション開発ガイド”の“変換定義の開発”を参照して、変換テーブルの文字コード、変換定義内容、メッセージの文字コード
を確認してください。
また、“ISI 導入ガイド”の“Formatmanagerの設定”を参照して、CSVファイルの文字コードを確認してください。
- 25 -
例としては、基準となる文字コードがUNICODE(UCS-2BE)の設定であるのにEBCDIC ASCIIのデータが入力された場合は、EBCDIC
ASCIIのコードがUTF-8の全角空白とみなされ空白に置き換えられてしまうために、文字化けのように見えてしまうことがあります。
環境設定が正しく行われていない
XML文書のフォーマット変換の場合、文字コードは環境設定ファイルで決定されます。“ISI 導入ガイド”の“Formatmanagerの設
定”を参照して、文字コードの設定を確認してください。
8.2.3 Formatmanagerメディエータファンクションの実行が必ずエラーになる
Formatmanager変換機能（ISIサーバ分離型）を使用している環境で、メディエータファンクションの実行がエラーになる場合、
Formatmanager変換機能が起動していない可能性があります。システムログもしくはイベントログを参照してFM-FUNCで始まるメッセー
ジを確認し、“ISI メッセージ集”を参照の上、対処してください。
8.2.4 KindCode=2,ReasonCode=0x101d、
KindCode=3,ReasonCode=0x1027 の変換エラーが発生する
該当する変換エラーが発生した場合、変換定義とデータが合っていない可能性があります。これにより定義数以上のワーニングが発
生し、変換エラーとなっています。入力データと変換定義が一致しているか確認してください。また、定義数については以下を確認し
てください。
・ ユーザ固有フォーマットのフォーマット変換の場合は、FEDITシステムパラメタ定義ファイルのWarningLimit定義文の設定値を確
認してください。
・ XML文書のフォーマット変換の場合は、環境設定ファイルのWarningLimit定義文の設定値を確認してください。
8.2.5 変換処理時間が長くなる
変換処理時間が長くなる場合、以下の原因が考えられます。必要に応じた対処を行ってください。
・ 変換定義とデータが合っていないため大量のワーニングが発生している可能性があります。入力データと変換定義が一致してい
るか確認してください。
・ ユーザ固有フォーマットのフォーマット変換の場合は、FEDITシステムパラメタ定義ファイルのWarningLimit定義文に負の値(全て
のワーニングを出力する指定)が設定されていないか確認してください。
・ XML文書のフォーマット変換の場合は、環境設定ファイルのWarningLimit定義文に負の値(全てのワーニングを出力する指定)が
設定されていないか確認してください。
8.2.6 KindCode=2,ReasonCode=0x8004、KindCode=3,ReasonCode=0x8007
の変換エラーが発生する
該当する変換エラーが発生した場合、数値属性（N属性、9属性、C属性、P属性）のデータ項目に数値以外のデータ（英字や漢字な
ど）が入力されている可能性があります。入力データと変換定義が一致しているか確認してください。
8.2.7 エンティティ(&lt;、&gt;、&amp;、&apos;、&quot;)が変換されない
XML文書のフォーマット変換においてXML用利用者プログラムを使用している場合、エンティティ(&lt;、&gt;、&amp;、&apos;、&quot;)
の変換は行われません。XML用利用者プログラムを使用している場合にエンティティの変換を行いたい場合は、XML用利用者プロ
グラム内で変換処理を行うようにしてください。
8.2.8 意図した変換ができない
システムロケールがUTF-8以外の環境では、ISI Studioで定義するシーケンス定義中のステップ名にマルチバイト文字を使用できませ
ん。ステップ名にマルチバイト文字を使用すると、メッセージが正しく変換されない場合がありますので、ステップ名を確認してくださ
い。
- 26 -
第9章 バックアップ・リストア時の異常
ここでは、バックアップ・リストア時やバックアップ・リストアを利用した移行時に異常が発生した場合の対処について説明します。
9.1 リストア時の異常
9.1.1 JMS-Rキューの再作成に失敗する
リストア時のJMS-Rキューの再作成に失敗する場合、必要な資源がリストアされていない可能性があります。“ISI 運用ガイド”の“リスト
ア手順”を参照し、必要な資源をすべてリストアしてください。
9.1.2 ISIの起動に失敗する
ISIの起動に失敗する場合、以下の原因が考えられます。必要に応じた対処を行ってください。
・ 必要な資源がリストアされていない可能性があります。“ISI 運用ガイド”の“リストア手順”を参照し、必要な資源をすべてリストアし
てください。
・ 非同期メッセージング(メッセージ保証あり)構成のISIサーバの起動に失敗する場合、JMS-Rキューの再作成を行っていない可能
性があります。“ISI 運用ガイド”の“リストア手順”を参照し、JMS-Rキューの再作成を行ってください。
・
Interstage運用グループの設定を行っていない可能性があります。“ISI 運用ガイド”の“Interstage運用グループの変更”を参照し、
Interstage運用グループの設定を行ってください。
9.2 リストア後の異常
9.2.1 ISIサーバのセットアップに失敗する
リストアを行ったあと、ISIサーバのセットアップ、アンセットアップで以下のメッセージが表示され、セットアップもアンセットアップもでき
ない状態になった場合
・ セットアップ時
INFO: SETUP-CMD-00002: Setup is already running
INFO: SETUP-CMD-00001: Setup was successful
・ アンセットアップ時
ERROR: SETUP-CMD-30001: Failed to execute command(detail=isj2eeadmin)
ERROR: SETUP-CMD-30004: Failed to set up
以下の原因が考えられます。必要に応じた対処を行ってください。
・ 必要な資源がリストアされていない可能性があります。“ISI 運用ガイド”の“リストア手順”を参照し、必要な資源をすべてリストアし
てください。
・ バックアップ時の運用環境と異なる環境がセットアップされている状態でリストアを行ったため、環境に不整合が生じている可能性
があります。ISIのインストール直後、またはISIをアンセットアップした状態でリストアを行ってください。
9.3 移行後の異常
9.3.1 ISI運用管理コンソールのログイン後の画面が表示されない
V9.2からの移行を行ったあと、ISI運用管理コンソールにログインし、ログイン後の画面が正しく表示されない場合、ISI運用管理コンソー
ルの再作成を行っていない可能性があります。“ISI 導入ガイド”の“ISI V9.2からの移行”の“移行後の作業”を参照し、ISI運用管理コ
ンソールを再作成してください。
- 27 -
9.3.2 メッセージが変換されない
V9.2からの移行を行ったあと、Formatmanager変換機能を使用したシーケンスを実行してもメッセージが変換されない場合、ISIサー
バ、SOAPアダプタに対してFormatmanagerの環境設定を行っていない可能性があります。“ISI 導入ガイド”の“ISI V9.2からの移行”の
“移行後の作業”を参照し、ISIサーバ、SOAPアダプタに対してFormatmanagerの環境設定を行ってください。
- 28 -
第10章 BPEL利用時の異常
ここでは、ISIのBPEL利用時の異常が発生した場合の対処について説明します。
10.1 ビジネス・プロセス実行時の異常
10.1.1 ビジネス・プロセス実行機能がハングアップする
BPEL定義に異常がある場合、ビジネス・プロセス実行機能がハングアップする場合があります。これは、異常なBPEL定義によりビジネ
ス・プロセスがリトライ動作を続けるためで、このとき、以下のどれかのメッセージが出力される場合があります。
本現象が発生した場合、正常に動作しているビジネス・プロセスの完了を待ってからIJServerクラスタを停止し、再度IJServerクラスタと
サーバインスタンスを起動して該当するBPEL定義を配備解除してください。BPEL定義は、以下のメッセージの対処により修正してく
ださい。各メッセージの対処については“ISI メッセージ集”を参照してください。
・ WSBPEL-17208
・ WSBPEL-17211
・ WSBPEL-20201
・ WSBPEL-27242
・ WSBPEL-27244
10.1.2 CorrelationSetによるインスタンスのルーティングが異常となる
BPEL定義でCorrelationSetによるインスタンスのルーティングを定義したにもかかわらず、期待どおりのルーティングが行われない場
合、以下の原因が考えられます。BPEL定義を確認し修正してください。
・ CorrelationSetのプロパティの設定に誤りがある、または設定していない。
・ インスタンスとメッセージを関連付けるための識別子が一意なものではない。
・ Invoke/Receive/Replyのプロパティビューの[相関]の定義に誤りがある。
10.1.3 BPEL起動アプリケーションでビジネス・プロセスを呼び出すと例外が発生する
BPEL起動アプリケーションで、ビジネス・プロセスを呼び出すと以下の例外が発生する場合があります。
・ java.lang.NumberFormatException
・ java.lang.IllegalArgumentException
・ java.lang.StringIndexOutOfBoundsException
この場合、BPEL定義のAssignにおける変数のコピーで、代入元と代入先の変数型の組合せに誤りがある可能性があります。BPEL定
義を確認し、BPEL定義を修正してください。
Assignにおける代入元と代入先の変数型の組合せについては、“ISI アプリケーション開発ガイド”の “BPEL定義の作成/編集”の
“Assign”を参照してください。
Invokeから実行するWebサービスがJava EEで作成されている場合、以下の例外が発生する場合があります。
・ javax.xml.ws.soap.SOAPFaultException
例外の詳細メッセージがselectionFailure の場合、取得したWSDLの修正を行っていない可能性があります。WSDLを確認し、WSDL
とBPEL定義を修正してください。
WSDLの修正については、“ISI アプリケーション開発ガイド”の“BPEL機能のアプリケーション開発”の“BPEL定義の開発”の“Webサー
ビスのWSDL取得”を参照してください。
- 29 -
10.1.4 ビジネス・プロセス実行機能を配備したIJServerクラスタのサーバログにlog4j
のエラーメッセージが出力される
ビジネス・プロセス実行機能を配備したIJServerクラスタを停止すると、IJServerクラスタのサーバログに以下に示すlog4jのエラーメッセー
ジが出力される場合がありますが、運用に支障はありません。
log4j:ERROR LogMananger.repositorySelector was null likely due to error in class reloading, using NOPLoggerRepository
10.1.5 強制停止時の対処
ビジネス・プロセス実行機能を配備したIJServerクラスタとサーバインスタンスを強制停止した場合や、マシンがダウンした場合、BPEL
定義の実行は中断します。BPEL定義の実行に対してリカバリが必要な場合、詳細な実行ログを参照して対処してください。詳細な実
行ログにはBPEL定義中の各要素の実行開始と終了が記録してあります。
詳細な実行ログは、通常採取していません。採取する場合は、“ISI アプリケーション開発ガイド”の“BPEL機能のアプリケーション開
発”の“BPEL定義の開発”の“ビジネス・プロセス実行機能のログ設定”を参照して設定を変更してください。
詳細な実行ログの例を以下に示します。
2010-11-09
2010-11-09
2010-11-09
2010-11-09
2010-11-09
14:26:41.475
14:26:41.737
14:26:41.760
14:26:41.810
14:26:41.865
FSP_INTS-ESI_WSBPEL-SV
FSP_INTS-ESI_WSBPEL-SV
FSP_INTS-ESI_WSBPEL-SV
FSP_INTS-ESI_WSBPEL-SV
FSP_INTS-ESI_WSBPEL-SV
INFO
INFO
INFO
INFO
INFO
00001
00001
00001
00001
00001
BPEL001
BPEL001
BPEL001
BPEL001
BPEL001
0000000000000000000
0000000000000000000
0000000000000000000
0000000000000000000
0000000000000000000
---------------------
Receive ----- START ----Sequence main START ----Assign Assign01 START ----Assign Assign01 END ----Invoke Invoke01 START -----
この例の場合、BPEL定義のプロセス名がBPEL001の、名前がInvoke01 のInvoke要素の実行中だったと判断できます。
10.1.6 IJServerクラスタ起動時にエラーとなる
IJServerクラスタの起動時に、システムログに“WSBPEL-40407”のメッセージが出力されずエラーとなる場合、IJServerクラスタの“クラス
パスのサフィックス”と“ネイティブライブラリパスのサフィックス”を見直してください。
設定値については、“ISI 導入ガイド”の“BPEL機能のセットアップ”の“ビジネス・プロセス実行環境の作成”の“ビジネス・プロセス実行
環境のセットアップ”を参照してください。
10.1.7 BPEL起動アプリケーションが動作しない(J2EE実行環境だけ)
J2EE実行環境上でBPEL起動アプリケーションが動作しない場合、クラスパスの設定が行われていない可能性があります。J2EE実行
環境上でBPEL起動アプリケーションを実行するときには、クラスパスの設定が必要です。
“Interstage Application Server J2EE ユーザーズガイド(旧版互換)”の“Webサービス編”の“Webサービスの運用”の“Webサービス(ク
ライアント機能)の運用方法”を参照してください。
なお、Java EE実行環境上でBPEL起動アプリケーションを運用する場合、本設定は必要ありません。
10.1.8 BPEL起動アプリケーションがエラー復帰する
BPEL起動アプリケーションがエラー復帰する場合、以下の対処を実施してください。
・ ビジネス・プロセス実行機能が実行状態かどうか確認してください。実行されていない場合は、実行してください。
・ BPEL起動アプリケーションが実行するBPEL定義が配備済みかどうか確認してください。配備されていない場合は配備してくださ
い。
・ ビジネス・プロセス実行機能が動作しているマシンのシステムログの内容を確認して対処してください。
10.1.9 想定しないタイムアウトが発生する
BPEL定義の実行時に以下のメッセージが出力される場合があります。
・ ISJEE_OM1020
・ ISJEE_OM1005
- 30 -
・ IJServer12044
これらのタイムアウトが想定していないときに発生している場合、以下の対処を実施してください。
“BPEL定義の実行時間のタイムアウト”、“アプリケーション最大処理時間”、および“Webサーバコネクタの送受信タイムアウト”の値を
見直してください。これらの値は以下の大小関係である必要があります。
“BPEL定義の実行時間のタイムアウト”
＜
“アプリケーション最大処理時間”
＜
“Webサーバコネクタの送受信タイムアウト”
詳細は、“ISI 導入ガイド”の“BPEL機能のセットアップ”の“ビジネス・プロセス実行環境の作成”の“ビジネス・プロセス実行環境のセッ
トアップ”を参照してください。
10.1.10 InvokeによるWebサービス呼び出しが失敗する
BPEL定義の実行時に以下のメッセージが出力される場合があります。
・ WSBPEL-40204
ISIのSOAPのエンドポイントを呼び出す場合、サービスエンドポイントからWSDLを生成します。WSDLエクスポート時にスキーマファイ
ルにSOAPのスキーマを指定していないか確認してください。このWSDLを使用してBPELのInvokeからISIのエンドポイントを呼び出し
た場合、WSBPEL-40204のエラーメッセージとなる場合があります。
10.2 ビジネス・プロセス実行環境作成時の異常
10.2.1 BPEL定義を配備できない
BPEL定義を配備できない。または、BPEL定義の配備操作を実行しても配備が完了しない場合は、以下の対処を実施してください。
ビジネス・プロセス実行環境が起動しているかどうか確認してください。起動していない場合は、ビジネス・プロセス実行環境を起動し
たのちに、システムログ/イベントログで配備が成功したか確認してください。
配備に失敗している場合は、WSBPEL-50000番台のメッセージが出力されています。“ISI メッセージ集”を参照して対処してください。
10.2.2 BPEL起動アプリケーションが作成できない
BPEL起動アプリケーション作成時に以下のエラーメッセージが出力される場合、以下の対処を実施してください。
・ J2EE実行環境のBPEL起動アプリケーション作成時
－ isws11226
・ Java EE実行環境のBPEL起動アプリケーション作成時
－ JAXWS1162
－ JAXWS1179
－ JAXWS1180
－ JAXWS1160
BPEL定義のWSDL定義が参照している外部ファイルの参照方法に誤りがあります。正しい参照方法になるように、BPEL定義を修正
してください。参照方法の詳細については、“ISI アプリケーション開発ガイド”の“BPEL機能のアプリケーション開発”の“BPELエディ
タによるBPEL定義の作成方法”の“WSDL定義の編集”の“外部ファイルの参照に関する注意事項”を参照してください。
- 31 -
第2部 Java EE実行環境編
第11章 セットアップ時の異常............................................................................................................................33
第12章 ISI運用管理コンソール操作時の異常................................................................................................... 40
第13章 ISIクライアント利用時の異常................................................................................................................ 42
第14章 ISI運用時の異常................................................................................................................................. 45
第15章 サービス連携時の異常........................................................................................................................ 47
第16章 データ変換時の異常............................................................................................................................ 50
第17章 バックアップ・リストア時の異常............................................................................................................. 52
第18章 BPEL利用時の異常.............................................................................................................................53
- 32 -
第11章 セットアップ時の異常
ここでは、ISIのセットアップ時に異常が発生した場合の対処について説明します。
11.1 セットアップに失敗する
11.1.1 ISI実行環境/ISI運用管理コンソールのセットアップに失敗する
ISIサーバ、アダプタまたはISI運用管理コンソールのセットアップもアンセットアップもできない状態になった場合
Interstage Java EE管理コンソールなどを使用して、isisetupコマンドで作成したリソースを削除した場合、以下のようなメッセージが出力
されてセットアップもアンセットアップもできない状態となります。
・ セットアップ時のメッセージ出力例
C:\>isisetup create-console
ERROR: SETUP-CMD-50007: ISI Management Console already exists.
ERROR: SETUP-CMD-50001: Command failed.
・ アンセットアップ時のメッセージ出力例
C:\>isisetup delete-console
asadmin list-clusters --interactive=false ISIConsole
asadmin: ERROR: ISJEE_TARGET1001: Cannot determine type for target : ISIConsole
asadmin: ERROR: ISJEE_CLI137: Command list-clusters failed.
ERROR: SETUP-CMD-50020: An error occurred when command was executed.
ERROR: SETUP-CMD-50001: Command failed.
・ セットアップ時のメッセージ出力例
# isisetup create-console
ERROR: SETUP-CMD-50007: ISI Management Console already exists.
ERROR: SETUP-CMD-50001: Command failed.
・ アンセットアップ時のメッセージ出力例
# isisetup delete-console
asadmin list-clusters --interactive=false ISIConsole
asadmin: ERROR: ISJEE_TARGET1001: Cannot determine type for target : ISIConsole
asadmin: ERROR: ISJEE_CLI137: Command list-clusters failed.
ERROR: SETUP-CMD-50020: An error occurred when command was executed.
ERROR: SETUP-CMD-50001: Command failed.
このような状態となった場合は、以下の手順でリソースを全て削除してから、再度セットアップを行ってください。
1. Interstage Application Serverのコマンドを使用して、問題が発生している対象のリソースを削除してください。
表11.1 ISIサーバをアンセットアップする場合の削除対象リソース
リソース種別
IJServerクラスタ
リソース名
・ ISI実行環境名を省略した場合
ISISrv
・ ISI実行環境名を指定した場合
ISISrv_ISI実行環境名
・ ISI実行環境名を省略した場合
- 33 -
リソース種別
リソース名
ISIDP
・ ISI実行環境名を指定した場合
ISIDP_ISI実行環境名
エンタープライズアプリケーション
・ ISI実行環境名を省略した場合
ISISrv
・ ISI実行環境名を指定した場合
ISISrv_ISI実行環境名
コネクタモジュール
・ ISI実行環境名を省略した場合
esisoapadapter-DEFAULT
・ ISI実行環境名を指定した場合
esisoapadapter-ISI実行環境名
コネクタ接続プール
・ ISI実行環境名を省略した場合
esisoapadapter-DEFAULT
・ ISI実行環境名を指定した場合
esisoapadapter-ISI実行環境名
ライフサイクルモジュール
・ ISI実行環境名を省略した場合
ESILCModule-ISISrv
・ ISI実行環境名を指定した場合
ESILCModule-ISISrv_ISI実行環境名
表11.2 任意の名前で作成したJMSキューをアンセットアップする場合の削除対象リソース
リソース種別
物理格納先
リソース名
JMSキュー名
R_JMSキュー名
EJBモジュール
ISIJMSMDB-JMSキュー名
JMS送信先リソース
jms/JMSキュー名
jms/R_JMSキュー名
スレッドプール
ISIJMSMDB-JMSキュー名
表11.3 インバウンドのMQアダプタをアンセットアップする場合の削除対象リソース
リソース種別
IJServerクラスタ
リソース名
・ ISI実行環境名を省略した場合
ISIMQI_MQ識別子
・ ISI実行環境名を指定した場合
ISIMQI_MQ識別子_ISI実行環境名
EJBモジュール
・ ISI実行環境名を省略した場合
ESIMQInboundMessageDrivenBean-ISIMQI_MQ識別子
・ ISI実行環境名を指定した場合
ESIMQInboundMessageDrivenBean-ISIMQI_MQ識別子_ISI実行環境
名
- 34 -
リソース種別
コネクタモジュール
リソース名
・ ISI実行環境名を省略した場合
ESIMQInboundResourceAdapter-ISIMQI_MQ識別子
・ ISI実行環境名を指定した場合
ESIMQInboundResourceAdapter-ISIMQI_MQ識別子_ISI実行環境名
ライフサイクルモジュール
・ ISI実行環境名を省略した場合
ESILCModule-ISIMQI_MQ識別子
・ ISI実行環境名を指定した場合
ESILCModule-ISIMQI_MQ識別子_ISI実行環境名
表11.4 アウトバウンドのMQアダプタ(Oneway方式)をアンセットアップする場合の削除対象リソース
リソース種別
リソース名
・ ISI実行環境名を省略した場合
IJServerクラスタ
ISIMQO_MQ識別子
・ ISI実行環境名を指定した場合
ISIMQO_MQ識別子_ISI実行環境名
・ ISI実行環境名を省略した場合
EJBモジュール
ESIMQSendBean-ISIMQO_MQ識別子
・ ISI実行環境名を指定した場合
ESIMQSendBean-ISIMQO_MQ識別子_ISI実行環境名
コネクタモジュール
・ ISI実行環境名を省略した場合
esimqadapter-DEFAULT(注)
・ ISI実行環境名を指定した場合
esimqadapter-ISI実行環境名(注)
コネクタ接続プール
・ ISI実行環境名を省略した場合
esimqadapter-DEFAULT(注)
・ ISI実行環境名を指定した場合
esimqadapter-ISI実行環境名(注)
ライフサイクルモジュール
・ ISI実行環境名を省略した場合
ESILCModule-ISIMQO_MQ識別子
・ ISI実行環境名を指定した場合
ESILCModule-ISIMQO_MQ識別子_ISI実行環境名
注：他のアウトバウンドのMQアダプタがない場合だけ削除してください。
表11.5 インバウンドのMQDアダプタをアンセットアップする場合の削除対象リソース
リソース種別
CORBAワークユニット
リソース名
・ ISI実行環境名を省略した場合
ISIMQDL_MQD識別子
・ ISI実行環境名を指定した場合
ISIMQDL_MQD識別子_ISI実行環境名
- 35 -
リソース種別
ユーティリティワークユニット
リソース名
・ ISI実行環境名を省略した場合
ISIMQDI_MQD識別子
・ ISI実行環境名を指定した場合
ISIMQDI_MQD識別子_ISI実行環境名
オブジェクトリファレンス
・ ISI実行環境名を省略した場合
ISIMQDL_MQD識別子
・ ISI実行環境名を指定した場合
ISIMQDL_MQD識別子_ISI実行環境名
インプリメンテーションリポジトリ
・ ISI実行環境名を省略した場合
ISIMQDL_MQD識別子
・ ISI実行環境名を指定した場合
ISIMQDL_MQD識別子_ISI実行環境名
表11.6 アウトバウンドのMQDアダプタをアンセットアップする場合の削除対象リソース
リソース種別
CORBAワークユニット
リソース名
・ ISI実行環境名を省略した場合
ISIMQDO_MQD識別子
・ ISI実行環境名を指定した場合
ISIMQDO_MQD識別子_ISI実行環境名
オブジェクトリファレンス
・ ISI実行環境名を省略した場合
ISIMQDO_MQD識別子
・ ISI実行環境名を指定した場合
ISIMQDO_MQD識別子_ISI実行環境名
インプリメンテーションリポジトリ
・ ISI実行環境名を省略した場合
ISIMQDO_MQD識別子
・ ISI実行環境名を指定した場合
ISIMQDO_MQD識別子_ISI実行環境名
コネクタモジュール
・ ISI実行環境名を省略した場合
esimqdadapter-DEFAULT
・ ISI実行環境名を指定した場合
esimqdadapter-ISI実行環境名
コネクタ接続プール
・ ISI実行環境名を省略した場合
esimqdadapter-DEFAULT
・ ISI実行環境名を指定した場合
esimqdadapter-ISI実行環境名
表11.7 ISI運用管理コンソールをアンセットアップする場合の削除対象リソース
リソース種別
IJServerクラスタ
リソース名
ISIConsole
- 36 -
リソース種別
リソース名
Webアプリケーション
isiconsole
ライフサイクルモジュール
ESILCModule-ISIConsole
各種のリソースを削除するコマンドは以下の通りです。各コマンドの詳細は“Interstage Application Server リファレンスマニュアル
(コマンド編)”を参照してください。
－ IJServerクラスタの削除
asadminコマンドを実行してIJServerクラスタを削除します。
実行例
asadmin delete-cluster ISISrv_ISI実行環境名
－ エンタープライズアプリケーションの削除
asadminコマンドを実行してエンタープライズアプリケーションを削除します。
実行例
asadmin undeploy --force --target domain ISISrv_ISI実行環境名
－ EJBモジュールの削除
asadminコマンドを実行してEJBモジュールを削除します。
実行例
asadmin undeploy --force --target domain ESIMQSendBean-ISIMQO_MQ識別子_ISI実行環境名
－ Webアプリケーションの削除
asadminコマンドを実行してWebアプリケーションを削除します。
実行例
asadmin undeploy --force --target domain isiconsole
－ コネクタモジュールの削除
asadminコマンドを実行してコネクタモジュールを削除します。
実行例
asadmin undeploy --cascade --target domain esisoapadapter-ISI実行環境名
－ コネクタ接続プールの削除
asadminコマンドを実行してコネクタ接続プールを削除します。
実行例
asadmin delete-connector-connection-pool --cascade=true esisoapadapter-ISI実行環境名
－ ライフサイクルモジュールの削除
asadminコマンドを実行してライフサイクルモジュールを削除します。
実行例
asadmin delete-lifecycle-module --target domain ESILCModule-ISISrv_ISI実行環境名
－ 物理格納先の削除
imqcmdコマンドを実行してJMS送信先リソースを削除します。
実行例
- 37 -
imqcmd destroy dst -b localhost:ポート番号 -t q -n JMSキュー名 -u admin
ポート番号はメッセージブローカのポート番号を指定してください。
－ JMS送信先リソースの削除
asadminコマンドを実行してJMS送信先リソースを削除します。
実行例
asadmin delete-resource-ref --target ISIDP_ISI実行環境名 jms/JMSキュー名
asadmin delete-jms-resource --target ISISrv_ISI実行環境名 jms/JMSキュー名
－ スレッドプールの削除
asadminコマンドを実行してスレッドプールを削除します。
実行例
asadmin delete-threadpool --target ISISrv_ISI実行環境名 ISIJMSMDB-JMSキュー名
－ CORBAワークユニットの削除
isdelwudefコマンドを実行してCORBAワークユニットを削除します。
実行例
isdelwudef ISIMQDL_MQD識別子_ISI実行環境名
－ ユーティリティワークユニットの削除
isdelwudefコマンドを実行してユーティリティワークユニットを削除します。
実行例
isdelwudef ISIMQDI_MQD識別子_ISI実行環境名
－ オブジェクトリファレンスの削除
OD_or_admコマンドを実行してオブジェクトリファレンスを削除します。
実行例
OD_or_adm -d -n ISIMQDL_MQD識別子_ISI実行環境名
－ インプリメンテーションリポジトリの削除
OD_impl_instコマンドを実行してインプリメンテーションリポジトリを削除します。
実行例
OD_impl_inst -d -r ISIMQDL_MQD識別子_ISI実行環境名
2. isisetupコマンドに「-f」オプションを指定してアンセットアップを実行してください。
ISI運用管理コンソールアンセットアップ時の実行例
C:\>isisetup delete-console -f
asadmin undeploy --interactive=false --force --target ISIConsole isiconsole
asadmin: ERROR: ISJEE_CLI171: Command undeploy failed : APPDEP1010: Trying to undeploy application from domain
failed; APPDEP1013: Component [isiconsole] is not registered.
asadmin delete-lifecycle-module --interactive=false --target ISIConsole ESILCModule-ISIConsole
asadmin: ERROR: ISJEE_TARGET1001: Cannot determine type for target : ISIConsole
asadmin: ERROR: ISJEE_CLI137: Command delete-lifecycle-module failed.
asadmin delete-cluster --interactive=false ISIConsole
asadmin: ERROR: ISJEE_OM2024: Cluster ISIConsole does not exist.
- 38 -
asadmin: ERROR: ISJEE_CLI137: Command delete-cluster failed.
INFO: SETUP-CMD-00101: Command executed successfully.
# isisetup delete-console -f
asadmin undeploy --interactive=false --force --target ISIConsole isiconsole
asadmin: ERROR: ISJEE_CLI171: Command undeploy failed : APPDEP1010: Trying to undeploy application from domain
failed; APPDEP1013: Component [isiconsole] is not registered.
asadmin delete-lifecycle-module --interactive=false --target ISIConsole ESILCModule-ISIConsole
asadmin: ERROR: ISJEE_TARGET1001: Cannot determine type for target : ISIConsole
asadmin: ERROR: ISJEE_CLI137: Command delete-lifecycle-module failed.
asadmin delete-cluster --interactive=false ISIConsole
asadmin: ERROR: ISJEE_OM2024: Cluster ISIConsole does not exist.
asadmin: ERROR: ISJEE_CLI137: Command delete-cluster failed.
INFO: SETUP-CMD-00101: Command executed successfully.
- 39 -
第12章 ISI運用管理コンソール操作時の異常
ここでは、ISI運用管理コンソール操作時に異常が発生した場合の対処について説明します。
12.1 ログインに失敗する
12.1.1 ログイン時の異常
以下のエラーが出力される場合があります。
・ Internet Explorer 6以外の場合
Internet Explorerではこのページは表示できません
・ Internet Explorer 6の場合
サーバが見つからないか、DNSエラーです
上記エラーが出力される場合、ISI運用管理コンソールが動作するために必要なサービスが起動されていない可能性があります。“ISI
Java EE運用ガイド”の“ISI運用管理コンソールの起動”を参照し、ISI運用管理コンソールを起動してください。
12.2 実行モニタの表示が正しくない
12.2.1 登録したシーケンス定義、サービスエンドポイント定義が表示されない
ISI運用管理コンソールにログイン中に、シーケンス定義やエンドポイント定義を変更した場合、以下の現象が発生します。
・登録した定義情報が表示されない
・削除した定義情報が表示されている
いったんログアウト後、再度ログインしてください。実行モニタに最新の状態が反映されます。
12.3 ISI運用管理コンソールの表示がおかしい
12.3.1 ISI運用管理コンソールの画面が英語で表示される
サーバOS上のロケールに日本語が設定されていない場合、ISI運用管理コンソールの画面上の文字が英語表記になる場合がありま
す。日本語表記にしたい場合は、以下の操作を行なってください。
・ Interstage Java EE Node Agentサービスの停止
Interstage Java EE Node Agentサービスを停止します。
実行例
/opt/FJSVisjee/bin/ijnastop
・ OSロケールの設定
OSロケールを日本語環境に設定します。
・ Interstage Java EE Node Agentサービスの起動
Interstage Java EE Node Agentサービスを起動します。
実行例
/opt/FJSVisjee/bin/ijnastart
- 40 -
ijnastopコマンド、およびijnastartコマンドの詳細については、“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照
してください。
- 41 -
第13章 ISIクライアント利用時の異常
ここでは、ISI StudioまたはFormatmanagerクライアントの利用時に異常が発生した場合の対処について説明します。
13.1 ISIの定義に関する異常
13.1.1 ISIの定義の登録でエラーダイアログが表示される
定義の登録で以下の内容のエラーダイアログが表示される場合
サーバ接続に失敗しました。接続先を見直してください。
または、接続先のWebサーバが起動しているか確認してください。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ 接続先の指定に誤りがあります。接続先を確認してください。
・ Webサーバが停止している可能性があります。Webサーバが起動しているかどうか確認してください。
・ ISI運用管理コンソールが停止している可能性があります。IJServerクラスタ「ISIConsole」が起動しているかどうか確認してください。
定義の登録で以下の内容のエラーダイアログが表示される場合
ISI Studioからのリクエストによる定義の登録に失敗しました。
ISIサーバ側のトレースログを確認してください。
以下のトレースログを確認してください。
<INSDIR>\var\log\trace\trace.log
/opt/FJSVesi/var/log/trace/trace.log
定義の登録で以下の内容のエラーダイアログが表示される場合
ISI Studioからのリクエストによる定義検証に失敗しました。
ISIサーバ側のトレースログを確認してください。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ ISI定義の必須項目の設定が不足している可能性があります。必須項目を設定してください。
・ ディスクに十分な空き領域がない可能性があります。空き領域を確認してください。
以下のトレースログを確認してください。
<INSDIR>\var\log\trace\trace.log
/opt/FJSVesi/var/log/trace/trace.log
定義の登録で以下の内容のエラーダイアログが表示される場合
- 42 -
定義エラーが存在します。対象プロジェクトの更新を行い、ISI問題を確認してください。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ ISI定義の必須項目の設定が不足している可能性があります。必須項目を設定してください。
・ 登録対象のISIプロジェクトに対する権限がない可能性があります。権限を確認してください。
13.1.2 ISIの定義の配置でエラーダイアログが表示される
定義の配置で以下の内容のエラーダイアログが表示される場合
定義の配置に失敗しました。
ISIサーバ側のトレースログを確認してください。
以下のトレースログを確認してください。
<INSDIR>\var\log\trace\trace.log
/opt/FJSVesi/var/log/trace/trace.log
下記の原因が考えられます。原因ごとに対処を行ってください。
・ 配置先情報ファイルに誤りがある可能性があります。配置先情報ファイルを確認してください。
・ サーバ環境の登録先のISIプロジェクトに、一意でないISIサーバ名が指定されたサービスエンドポイント定義が存在する可能性が
あります。一意のISIサーバ名が指定されたサービスエンドポイント定義にして、全置換えで定義を登録しなおしてください。
13.1.3 ISIの定義の取得でエラーダイアログが表示される
定義の取得で以下の内容のエラーダイアログが表示される場合
サーバ接続に失敗しました。接続先を見直してください。
または、接続先のWebサーバが起動しているか確認してください。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ 接続先の指定に誤りがあります。接続先を確認してください。
・ Webサーバが停止している可能性があります。Webサーバが起動しているかどうか確認してください。
・ ISI運用管理コンソールが停止している可能性があります。IJServerクラスタ「ISIConsole」が起動しているかどうか確認してください。
定義の取得で以下の内容のエラーダイアログが表示される場合
ISI Studioからのリクエストによる定義取得に失敗しました。
ISIサーバ側のトレースログを確認してください。
以下のトレースログを確認してください。
<INSDIR>\var\log\trace\trace.log
- 43 -
/opt/FJSVesi/var/log/trace/trace.log
定義の取得で以下の内容のエラーダイアログが表示される場合
ISI Studioでエラーが発生しました。[詳細=内部エラーが発生しました。]
ISI Studio環境が異常状態です。環境を確認してください。
下記の原因が考えられます。原因の対処を行ってください。
・ ワークスペースにISI定義を書き込み出来ない可能性があります。IS Studioを再起動してください。
13.2 Formatmanagerの変換テーブルに関する異常
13.2.1 変換テーブル生成でエラーダイアログが表示される
変換テーブル生成で以下の内容のエラーダイアログが表示される場合
FTPサーバへの接続に失敗しました。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ サーバ転送先設定が誤っている可能性があります。メニューの「設定」＞「サーバ転送先設定」を選択し、「サーバ転送先設定」ダ
イアログの「サーバ名」、「ログイン」、「パスワード」が正しく設定されているか確認してください。
・ 転送先のFTPサーバが起動していない可能性があります。FTPサーバを起動してください。
13.2.2 変換テーブル取得でエラーダイアログが表示される
変換テーブル取得で以下の内容のエラーダイアログが表示される場合
FTPサーバへの接続に失敗しました。
下記の原因が考えられます。原因ごとに対処を行ってください。
・ サーバ転送先設定が誤っている可能性があります。メニューの「設定」＞「サーバ転送先設定」を選択し、「サーバ転送先設定」ダ
イアログの「サーバ名」、「ログイン」、「パスワード」が正しく設定されているか確認してください。
・ 取得元のFTPサーバが起動していない可能性があります。FTPサーバを起動してください。
- 44 -
第14章 ISI運用時の異常
ここでは、ISIの運用時に異常が発生した場合の対処について説明します。
14.1 ISIの定義変更時のトラブル
14.1.1 ISIの定義変更が実行結果に反映されない
以下の原因が考えられます。必要に応じた対処を行ってください。
・ ISIの定義が配置されていない可能性があります。定義の配置については、“ISI アプリケーション開発ガイド”の“定義の作成と登
録”を参照してください。
・ メディエータファンクション定義が登録されていない可能性があります。isideflistコマンドを使用して、メディエータファンクション定
義が登録されているか確認してください。登録されていない場合は、isidefaddコマンドを使用して配置しようとするワークディレクト
リに対してメディエータファンクション定義を登録してください。isideflistコマンド、およびisidefaddコマンドの詳細は、“ISI リファレン
ス”の“isideflist”コマンド、および“isidefadd”コマンドを参照してください。
14.2 非同期メッセージング構成のISIサーバ運用時のトラブル
14.2.1 メッセージを送信したが、シーケンス処理が開始されない
メッセージを送信したが、シーケンス処理が開始されない場合、以下の原因が考えられます。必要に応じた対処を行ってください。
インバウンドのJMSキューからのメッセージ読み込みが停止している。
メッセージの読み込み稼動状態の確認後、メッセージの読み込みが停止している場合はメッセージ読み込みを起動してください。
－ メッセージ読み込み稼動状態の確認方法
メッセージ読み込み稼動状態はisiqueuereadstatusコマンドで確認することができます。isiqueuereadstatusコマンドの詳細は“ISI
リファレンス”を参照してください。
－ メッセージ読み込みの起動
メッセージ読み込みの起動はisiqueuereadstartコマンドで行います。isiqueuereadstartコマンドの詳細は“ISI リファレンス”を
参照してください。以下の条件をすべて満たす場合、メッセージ読み込みの起動に失敗します。メッセージ読み込みの起
動に失敗する場合は、再度異常メッセージのリカバリ・削除の手順から対処してください。
- 異常メッセージのリカバリ・削除が行われていない。
- インバウンドのJMSキューに対応するリカバリキューにメッセージ退避できない。
14.2.2 ISIサーバに接続できない
非同期メッセージング構成のインバウンドアダプタ(本バージョンではカスタムアダプタ)からISIサーバに接続できない場合、以下の原
因が考えられます。必要に応じた対処を行ってください。
動作に必要なサービスが停止している。
“Interstage Java EE Node Agentサービス”、“IJServerクラスタ”、または“メッセージブローカ”が停止している可能性があります。
“Interstage Java EE Node Agentサービス”、“IJServerクラスタ”はInterstage Java EE管理コンソールまたはコマンドで起動状態を確
認できます。“メッセージブローカ”の起動状態の確認は、imqcmd list svcサブコマンドを使用してください。詳細は、“Interstage
Application Server Java EE運用ガイド”と“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照してください。
メッセージブローカの設定値を超過した。
送信したメッセージが、メッセージブローカ作成時に指定したプロパティの値を超過していないか確認してください。システムログに
出力されるエラーの詳細情報に“IJMQ”から始まる文字列がある場合、このIJMQから始まる文字列は、Interstage Application Server
のメッセージに対応しています。“Interstage Application Server メッセージ集”を参照して原因を調査してください。メッセージブロー
カの設定値を変更しなければならない場合は、以下の手順で実施してください。セットアップ、アンセットアップの詳細については、
“ISI Java EE導入ガイド”を参照してください。
- 45 -
1. ISIサーバが動作している、IJServerクラスタを停止します。
停止方法については、“Interstage Application Server Java EE運用ガイド”の“IJServerクラスタの起動/停止/運用状態表示”を
参照してください。
2. セットアップ済の、JMSキューをアンセットアップします。
isisetup delete-jms -n JMSキュー名 [-u ISI実行環境名]
3. メッセージブローカを停止します。
/etc/init.d/ijmq_<ポート番号> stop
4. ISI実行環境とメッセージブローカの関連付けを解除します。
isisetup delete-broker-ref [-u ISI実行環境名]
5. メッセージブローカを削除します。
isisetup delete-broker [-port ポート番号]
6. メッセージブローカに設定する情報を記載したファイルを修正後、メッセージブローカを作成します。
isisetup create-broker [-port ポート番号] [-p パスワード] [-f ファイル名]
7. ISI実行環境とメッセージブローカの関連付けを追加します。
isisetup create-broker-ref [-port ポート番号] [-u ISI実行環境名]
8. 非同期メッセージング機能で使用するJMSキューをセットアップします。
isisetup create-jms -i -n JMSキュー名 [-f ファイル名] [-u ISI実行環境名]
9. ISIサーバが動作する、IJServerクラスタを起動します。
起動方法については、“Interstage Application Server Java EE運用ガイド”の“IJServerクラスタの起動/停止/運用状態表示”を
参照してください。
メッセージブローカの設定値を超過した場合、システムログに出力されるメッセージの例を以下に示します。
－ 物理格納先に接続できるプロデューサの最大数を超過
Aug 29 19:25:30 isi08 ESI: ERROR: ESI-API-60003: ### ### JMSの操作でエラーが発生しました。[詳細情報
=com.sun.messaging.jms.JMSException: [ADD_PRODUCER_REPLY(19)] IJMQ_C4036: A broker error occurred. :[409]
IJMQ_B4183: Producer can not be added to destination ISIInboundQueue [Queue], limit of 3 producers would be exceeded
user=guest, broker=isi08:7676(60012)]
－ 物理格納先に格納できるメッセージの最大サイズを超過したメッセージを送信
Aug 29 15:21:18 isi08 ESI: ERROR: ESI-API-60003: ### ### JMSの操作でエラーが発生しました。[詳細情報
=com.sun.messaging.jms.JMSException: IJMQ_C4095: Message exceeds the single message size limit for the broker or
destination: ISIInboundQueue user=guest, broker=isi08:7676(60012)]
－ 物理格納先に格納できるメッセージの最大件数を超過
Aug 30 11:34:29 isi08 ESI: ERROR: ESI-API-60003: ### ### JMSの操作でエラーが発生しました。[詳細情報
=com.sun.messaging.jms.ResourceAllocationException: IJMQ_C4096: Destination is full and is rejecting new messages:
ISIInboundQueue user=guest, broker=isi08:7676(56420)]
－ メッセージブローカのヒープサイズが不足
Aug 30 10:41:41 isi08 ESI: ERROR: ESI-API-60003: ### ### JMSの操作でエラーが発生しました。[詳細情報
=com.sun.messaging.jms.JMSException: IJMQ_C4001: Write packet failed. - cause: java.net.SocketException: パイプが
切断されました。]
- 46 -
第15章 サービス連携時の異常
ここでは、ISIの各種サービス連携時に異常が発生した場合の対処について説明します。
15.1 メッセージの送受信に失敗する
15.1.1 アダプタ連携共通
15.1.1.1 ISIサーバから、サービス提供側アプリケーションへの接続に失敗する
以下の原因が考えられます。必要に応じた対処を行ってください。
・ サービスエンドポイント定義の設定に誤りがある可能性があります。サービスエンドポイント定義の内容に誤りがないか確認してくだ
さい。
・ サービス提供側アプリケーションが起動していない場合があります。サービス提供側のアプリケーションが起動しているかどうか確
認してください。
・ ISIがインストールされているサーバとは別のサーバと通信している場合、正しく通信が行われていない可能性があります。ネット
ワーク、ファイアウォールの設定を見直してください。
15.1.1.2 サービス利用側アプリケーションから、ISIサーバへの接続に失敗する
以下の原因が考えられます。必要に応じた対処を行ってください。
・ サービス利用側アプリケーションで設定されている、ISIサーバのアドレスが間違っている可能性があります。サービス利用側アプ
リケーションの設定に誤りがないか確認してください。
・ ISIがインストールされているサーバとは別のサーバから通信している場合、正しく通信が行われていない可能性があります。ネット
ワーク、ファイアウォールの設定を見直してください。
・ アダプタ、ISIサーバが起動していない可能性があります。アダプタ、ISIサーバが起動しているかどうか確認してください。
15.1.2 SOAP連携時
15.1.2.1 SOAPメッセージを送信すると、クライアントにSOAP Faultが返ってくる
SOAPメッセージを送信時、クライアントにSOAP Faultが返ってくる場合、以下の原因が考えられます。必要に応じた対処を行ってくだ
さい。
送信先のURLに誤りがある
サービス利用側アプリケーションで設定している送信先のURLに誤りがある可能性があります。送信先のURLが、以下のアドレス
になっているか確認してください。
http://ホスト名:ポート番号/esisoap_ISI実行環境名/ESISoapMsgServer?サービスエンドポイント名
Webサーバ（FJapache）が起動していない
Webサーバ（FJapache）が起動していない可能性があります。Interstage Application Serverのマニュアルを参照し、Webサーバを起
動してください。
応答電文はSOAPの形式になっていない
応答電文はSOAPの形式になっていない可能性があります。ISIのSOAPアダプタでは、共通メッセージのペイロードのXMLがSOAP
電文（Envelope含む）になっていることを前提としています。応答電文の形式も、SOAP電文の形式となるようにシーケンスを設計し
てください。
サポートされていない形式のSOAPメッセージを送信している
サポートされていない形式のSOAPメッセージを送信している可能性があります。ISIのSOAPアダプタは、SOAPの1.2に対応してい
ます。
- 47 -
15.1.2.2 SOAPメッセージを送信すると、HTTP復帰コード500が返ってくる
SOAPメッセージを送信時、クライアントにHTTP復帰コードが500かつSOAP1.2のSOAP Fault以外のメッセージが返ってくる場合、以下
の原因が考えられます。必要に応じた対処を行ってください。
応答電文のサイズが0になっている
応答電文のサイズが0になっている可能性があります。ISIのSOAPアダプタでは共通メッセージのペイロードがSOAP電文(Envelope
含む)になっていることを前提としています。ペイロードをクリアしていないか確認してください。
送信電文がSOAPの形式になっていない
クライアントからISIへの送信電文がSOAPの形式になっていない可能性があります。クライアントプログラムを見直してください。
この場合、応答電文がSOAP1.1のSOAPFaultとなる可能性があります。以下に例を示します。
HTTP/1.1 500 Internal Server Error
Date: Fri, 15 Jun 2012 11:57:40 GMT
Content-Type: text/xml
Connection: close
Transfer-Encoding: chunked
150
<ns2:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3="http://www.w3.org/2003/05/soapenvelope"><faultcode>ns2:Server</faultcode><faultstring>com.ctc.wstx.exc.WstxParsingException: Unexpected close tag
&lt;/S:Body_HOGE&gt;; expected &lt;/S:Body&gt;.
at [row,col {unknown-source}]: [1,196]</faultstring></ns2:Fault>
0
15.1.3 MQ連携時
15.1.3.1 ISIが受信したメッセージのMsgIdの値が正しくない
バイナリ型の値を変換する際の文字コードが正しく指定されていない可能性があります。ISIの環境設定ファイルの以下のキー値が、
使用しているMQキュー・マネージャーのCodedCharSetId属性に指定した文字セットの内容と一致しているか、確認してください。
キー値：com.fujitsu.esi.mqmd.transcharset
設定の詳細については、“ISI Java EE導入ガイド”の“環境のカスタマイズ”を参照してください。
15.1.3.2 連携処理が失敗する
変換エラーなどで連携処理（シーケンス）が失敗した場合、インバウンドのMQアダプタのメッセージ受信機能が停止することがありま
す。
メッセージ受信機能が停止した場合には、システムログまたはイベントログを参照して、エラーになった原因を取り除き、インバウンドの
MQアダプタを停止し、再起動してください。
インバウンドのMQアダプタの停止方法については、“ISI Java EE運用ガイド”の“停止”を参照してください。起動方法については、“ISI
Java EE運用ガイド”の“起動”を参照してください。
15.1.3.3 インバウンドのMQアダプタが異常終了する
システムログまたはイベントログを参照して、エラーになった原因を取り除き、インバウンドのMQアダプタを停止し、再起動してくださ
い。
受信元のWebSphere MQのキューからのメッセージの受信が完了する前に異常終了した場合、メッセージの冗送が発生する場合があ
ります。ISIでは冗送を検知できないため、サービス提供側アプリケーションで冗送を検知・対処してください。
インバウンドのMQアダプタの停止方法については、“ISI Java EE運用ガイド”の“停止”を参照してください。起動方法については、“ISI
Java EE運用ガイド”の“起動”を参照してください。
- 48 -
15.1.3.4 アウトバウンドのMQアダプタが異常終了する
システムログまたはイベントログを参照して、エラーになった原因を取り除き、アウトバウンドのMQアダプタを停止し、再起動してくださ
い。
アウトバウンドのMQアダプタの停止方法については、“ISI Java EE運用ガイド”の“停止”を参照してください。起動方法については、
“ISI Java EE運用ガイド”の“起動”を参照してください。
15.1.4 III連携時
15.1.4.1 IIIとのメッセージ送受信で異常が発生する
ISIからIIIサーバに接続できない場合は、以下の原因が考えられます。必要に応じた対処を行ってください。
・ IIIサーバが起動していない可能性があります。IIIサーバが起動しているか確認してください。
・ IIIの環境がセットアップされていない可能性があります。IIIの“サーバの環境”と“サービスバス連携入力・出力の環境”がセットアッ
プされているか確認してください。IIIの環境のセットアップ方法についてはIIIのセットアップガイドを参照してください。
15.1.5 MQD連携時
15.1.5.1 MQDシステムからメッセージが受信されない
MQD連携において、連携対象のMQDシステムからISIでメッセージを受信できない場合、連携対象のMQDシステムが起動していな
い可能性があります。
連携対象のMQDシステムを起動したあと、MQD受信を再起動してください。
15.2 アダプタの起動で失敗する
15.2.1 MQアダプタが起動しない（MQ連携時）
MQアダプタが起動しない場合、以下の原因が考えられます。必要に応じた対処を行ってください。
インバウンドルーティング名、サービスエンドポイント名がどちらも指定されていない
インバウンドのMQアダプタが正常に起動しない場合、インバウンドMQアダプタ設定ファイルにインバウンドのMQアダプタで使用
するインバウンドルーティング名、サービスエンドポイント名がどちらも指定されていない可能性があります。“ISI Java EE導入ガイ
ド”の“MQアダプタ利用時の設定”を参照してインバウンドルーティング名、サービスエンドポイント名が正しく設定されているか確
認してください。
15.2.2 MQD受信が起動しない（MQD利用時）
MQD受信が起動しない場合、以下の原因が考えられます。必要に応じた対処を行ってください。
インバウンドルーティング名が指定されていない
MQD受信環境定義ファイルにインバウンドルーティング名が指定されていない可能性があります。“ISI Java EE導入ガイド”の“MQD
連携利用時の設定”を参照してインバウンドルーティング名が正しく設定されているか確認してください。
- 49 -
第16章 データ変換時の異常
ここでは、ISIの各種データ変換実行時に異常が発生した場合の対処について説明します。
16.1 起動/停止に失敗する
16.1.1 Formatmanager変換機能が起動しない
Formatmanager変換機能が起動しない場合、以下の原因が考えられます。
・ 変換テーブルが登録されていない。
・ 変換テーブルが破損している。
・ 異なるバージョンの変換テーブルが配置されている。
システムログもしくはイベントログを参照して、FM-SVで始まるメッセージを確認し、“ISI メッセージ集”を参照の上、対処してください。
16.2 メッセージが正しく変換されない
16.2.1 リソースの変更内容が、実行結果に反映されない
Formatmanagerの変換テーブルや利用者プログラムなどのリソースを変更したが、実行結果に反映されない場合、以下の原因が考え
られます。必要に応じた対処を行ってください。
活性変更コマンドが実行されていない
活性変更コマンドが実行されていない可能性があります。
“ISI Java EE運用ガイド”の“Formatmanagerの運用管理”を参照して、活性変更コマンドを実行してください。
注意
FEDITシステムパラメタ定義ファイルの以下の定義文の設定を変更した場合は、活性変更コマンドでは有効になりません。
Formatmanager変換機能を再起動してください。
－ CharCodeConversionRule
－ UseCharsetManager
Formatmanager変換機能が再起動されていない
Formatmanager変換機能（ISIサーバ一体型の場合はISIサーバ）が再起動されていない可能性があります。
活性変更コマンドで変更できない設定については、Formatmanager変換機能（ISIサーバ一体型の場合はISIサーバ）を再起動させ
ることにより変更を反映させる必要があります。
Formatmanager変換機能の再起動方法については、“ISI Java EE導入ガイド”の“Formatmanagerの設定“を参照してください。
16.2.2 変換結果が文字化けする
メッセージの変換結果が文字化けする場合、以下の原因が考えられます。必要に応じた対処を行ってください。
変換定義とデータが合っていない
ユーザ固有フォーマットのフォーマット変換の場合は、基準となる文字コードが変換テーブルの文字コードで決定されます。“ISI ア
プリケーション開発ガイド”の“変換定義の開発”を参照して、変換テーブルの文字コード、変換定義内容、メッセージの文字コード
を確認してください。
また、“ISI Java EE導入ガイド”の“Formatmanagerの設定”を参照して、CSVファイルの文字コードを確認してください。
- 50 -
環境設定が正しく行われていない
XML文書のフォーマット変換の場合、文字コードは環境設定ファイルで決定されます。“ISI Java EE導入ガイド”の“Formatmanager
の設定”を参照して、文字コードの設定を確認してください。
16.2.3 Formatmanagerメディエータファンクションの実行が必ずエラーになる
Formatmanager変換機能（ISIサーバ分離型）を使用している環境で、メディエータファンクションの実行がエラーになる場合、
Formatmanager変換機能が起動していない可能性があります。システムログもしくはイベントログを参照してFM-FUNCで始まるメッセー
ジを確認し、“ISI メッセージ集”を参照の上、対処してください。
16.2.4 KindCode=2,ReasonCode=0x101d、
KindCode=3,ReasonCode=0x1027 の変換エラーが発生する
該当する変換エラーが発生した場合、変換定義とデータが合っていない可能性があります。これにより定義数以上のワーニングが発
生し、変換エラーとなっています。入力データと変換定義が一致しているか確認してください。また、定義数については以下を確認し
てください。
・ ユーザ固有フォーマットのフォーマット変換の場合は、FEDITシステムパラメタ定義ファイルのWarningLimit定義文の設定値を確
認してください。
・ XML文書のフォーマット変換の場合は、環境設定ファイルのWarningLimit定義文の設定値を確認してください。
16.2.5 変換処理時間が長くなる
変換処理時間が長くなる場合、以下の原因が考えられます。必要に応じた対処を行ってください。
・ 変換定義とデータが合っていないため大量のワーニングが発生している可能性があります。入力データと変換定義が一致してい
るか確認してください。
・ ユーザ固有フォーマットのフォーマット変換の場合は、FEDITシステムパラメタ定義ファイルのWarningLimit定義文に負の値(全て
のワーニングを出力する指定)が設定されていないか確認してください。
・ XML文書のフォーマット変換の場合は、環境設定ファイルのWarningLimit定義文に負の値(全てのワーニングを出力する指定)が
設定されていないか確認してください。
16.2.6 意図した変換ができない
システムロケールがUTF-8以外の環境では、ISI Studioで定義するシーケンス定義中のステップ名にマルチバイト文字を使用できませ
ん。ステップ名にマルチバイト文字を使用すると、メッセージが正しく変換されない場合がありますので、ステップ名を確認してくださ
い。
- 51 -
第17章 バックアップ・リストア時の異常
ここでは、バックアップ・リストア時やバックアップ・リストアを利用した移行時に異常が発生した場合の対処について説明します。
17.1 リストア時の異常
17.1.1 ISIの起動に失敗する
ISIの起動に失敗する場合、以下の原因が考えられます。必要に応じた対処を行ってください。
・ 必要な資源がリストアされていない可能性があります。“ISI Java EE運用ガイド”の“リストア手順”を参照し、必要な資源をすべてリ
ストアしてください。
17.2 リストア後の異常
17.2.1 ISIサーバのセットアップに失敗する
リストアを行ったあと、ISIサーバのセットアップ、アンセットアップで以下のメッセージが表示され、セットアップもアンセットアップもでき
ない状態になった場合は、以下の原因が考えられます。必要に応じた対処を行ってください。
・ 必要な資源がリストアされていない可能性があります。“ISI Java EE運用ガイド”の“リストア手順”を参照し、必要な資源をすべてリ
ストアしてください。
・ バックアップ時の運用環境と異なる環境がセットアップされている状態でリストアを行ったため、環境に不整合が生じている可能性
があります。ISIのインストール直後、またはISIをアンセットアップした状態でリストアを行ってください。
- 52 -
第18章 BPEL利用時の異常
ここでは、ISIのBPEL利用時の異常が発生した場合の対処について説明します。
18.1 ビジネス・プロセス実行時の異常
18.1.1 ビジネス・プロセス実行機能がハングアップする
BPEL定義に異常がある場合、ビジネス・プロセス実行機能がハングアップする場合があります。これは、異常なBPEL定義によりビジネ
ス・プロセスがリトライ動作を続けるためで、このとき、以下のどれかのメッセージが出力される場合があります。
本現象が発生した場合、正常に動作しているビジネス・プロセスの完了を待ってからIJServerクラスタを停止し、再度IJServerクラスタと
サーバインスタンスを起動して該当するBPEL定義を配備解除してください。BPEL定義は、以下のメッセージの対処により修正してく
ださい。各メッセージの対処については“ISI メッセージ集”を参照してください。
・ WSBPEL-17208
・ WSBPEL-17211
・ WSBPEL-20201
・ WSBPEL-27242
・ WSBPEL-27244
18.1.2 CorrelationSetによるインスタンスのルーティングが異常となる
BPEL定義でCorrelationSetによるインスタンスのルーティングを定義したにもかかわらず、期待どおりのルーティングが行われない場
合、以下の原因が考えられます。BPEL定義を確認し修正してください。
・ CorrelationSetのプロパティの設定に誤りがある、または設定していない。
・ インスタンスとメッセージを関連付けるための識別子が一意なものではない。
・ Invoke/Receive/Replyのプロパティビューの[相関]の定義に誤りがある。
18.1.3 BPEL起動アプリケーションでビジネス・プロセスを呼び出すと例外が発生する
BPEL起動アプリケーションで、ビジネス・プロセスを呼び出すと以下の例外が発生する場合があります。
・ java.lang.NumberFormatException
・ java.lang.IllegalArgumentException
・ java.lang.StringIndexOutOfBoundsException
この場合、BPEL定義のAssignにおける変数のコピーで、代入元と代入先の変数型の組合せに誤りがある可能性があります。BPEL定
義を確認し、BPEL定義を修正してください。
Assignにおける代入元と代入先の変数型の組合せについては、“ISI アプリケーション開発ガイド”の “BPEL定義の作成/編集”の
“Assign”を参照してください。
Invokeから実行するWebサービスがJava EEで作成されている場合、以下の例外が発生する場合があります。
・ javax.xml.ws.soap.SOAPFaultException
例外の詳細メッセージがselectionFailure の場合、取得したWSDLの修正を行っていない可能性があります。WSDLを確認し、WSDL
とBPEL定義を修正してください。
WSDLの修正については、“ISI アプリケーション開発ガイド”の“BPEL機能のアプリケーション開発”の“BPEL定義の開発”の“Webサー
ビスのWSDL取得”を参照してください。
- 53 -
18.1.4 ビジネス・プロセス実行機能を配備したIJServerクラスタのサーバログにlog4j
のエラーメッセージが出力される
ビジネス・プロセス実行機能を配備したIJServerクラスタを停止すると、IJServerクラスタのサーバログに以下に示すlog4jのエラーメッセー
ジが出力される場合がありますが、運用に支障はありません。
log4j:ERROR LogMananger.repositorySelector was null likely due to error in class reloading, using NOPLoggerRepository
18.1.5 強制停止時の対処
ビジネス・プロセス実行機能を配備したIJServerクラスタとサーバインスタンスを強制停止した場合や、マシンがダウンした場合、BPEL
定義の実行は中断します。BPEL定義の実行に対してリカバリが必要な場合、詳細な実行ログを参照して対処してください。詳細な実
行ログにはBPEL定義中の各要素の実行開始と終了が記録してあります。
詳細な実行ログは、通常採取していません。採取する場合は、“ISI アプリケーション開発ガイド”の“BPEL機能のアプリケーション開
発”の“BPEL定義の開発”の“ビジネス・プロセス実行機能のログ設定”を参照して設定を変更してください。
詳細な実行ログの例を以下に示します。
2010-11-09
2010-11-09
2010-11-09
2010-11-09
2010-11-09
14:26:41.475
14:26:41.737
14:26:41.760
14:26:41.810
14:26:41.865
FSP_INTS-ESI_WSBPEL-SV
FSP_INTS-ESI_WSBPEL-SV
FSP_INTS-ESI_WSBPEL-SV
FSP_INTS-ESI_WSBPEL-SV
FSP_INTS-ESI_WSBPEL-SV
INFO
INFO
INFO
INFO
INFO
00001
00001
00001
00001
00001
BPEL001
BPEL001
BPEL001
BPEL001
BPEL001
0000000000000000000
0000000000000000000
0000000000000000000
0000000000000000000
0000000000000000000
---------------------
Receive ----- START ----Sequence main START ----Assign Assign01 START ----Assign Assign01 END ----Invoke Invoke01 START -----
この例の場合、BPEL定義のプロセス名がBPEL001の、名前がInvoke01 のInvoke要素の実行中だったと判断できます。
18.1.6 IJServerクラスタ起動時にエラーとなる
IJServerクラスタの起動時に、システムログに“WSBPEL-40407”のメッセージが出力されずエラーとなる場合、IJServerクラスタの“クラス
パスのサフィックス”と“ネイティブライブラリパスのサフィックス”を見直してください。
設定値については、“ISI Java EE導入ガイド”の“BPEL機能のセットアップ”の“ビジネス・プロセス実行環境の作成”の“ビジネス・プロ
セス実行環境のセットアップ”を参照してください。
18.1.7 BPEL起動アプリケーションが動作しない(J2EE実行環境だけ)
J2EE実行環境上でBPEL起動アプリケーションが動作しない場合、クラスパスの設定が行われていない可能性があります。J2EE実行
環境上でBPEL起動アプリケーションを実行するときには、クラスパスの設定が必要です。
“Interstage Application Server J2EEユーザーズガイド(旧版互換)”の“Webサービス編”の“Webサービスの運用”の“Webサービス(クラ
イアント機能)の運用方法”を参照してください。
なお、Java EE実行環境上でBPEL起動アプリケーションを運用する場合、本設定は必要ありません。
18.1.8 BPEL起動アプリケーションがエラー復帰する
BPEL起動アプリケーションがエラー復帰する場合、以下の対処を実施してください。
・ ビジネス・プロセス実行機能が実行状態かどうか確認してください。実行されていない場合は、実行してください。
・ BPEL起動アプリケーションが実行するBPEL定義が配備済みかどうか確認してください。配備されていない場合は配備してくださ
い。
・ ビジネス・プロセス実行機能が動作しているマシンのシステムログの内容を確認して対処してください。
18.1.9 想定しないタイムアウトが発生する
BPEL定義の実行時に以下のメッセージが出力される場合があります。
・ ISJEE_OM1020
・ ISJEE_OM1005
- 54 -
・ IJServer12044
これらのタイムアウトが想定していないときに発生している場合、以下の対処を実施してください。
“BPEL定義の実行時間のタイムアウト”、“アプリケーション最大処理時間”、および“Webサーバコネクタの送受信タイムアウト”の値を
見直してください。これらの値は以下の大小関係である必要があります。
“BPEL定義の実行時間のタイムアウト”
＜
“アプリケーション最大処理時間”
＜
“Webサーバコネクタの送受信タイムアウト”
詳細は、“ISI Java EE導入ガイド”の“BPEL機能のセットアップ”の“ビジネス・プロセス実行環境の作成”の“ビジネス・プロセス実行環
境のセットアップ”を参照してください。
18.1.10 InvokeによるWebサービス呼び出しが失敗する
BPEL定義の実行時に以下のメッセージが出力される場合があります。
・ WSBPEL-40204
ISIのSOAPのエンドポイントを呼び出す場合、サービスエンドポイントからWSDLを生成します。WSDLエクスポート時にスキーマファイ
ルにSOAPのスキーマを指定していないか確認してください。このWSDLを使用してBPELのInvokeからISIのエンドポイントを呼び出し
た場合、WSBPEL-40204のエラーメッセージとなる場合があります。
18.2 ビジネス・プロセス実行環境作成時の異常
18.2.1 BPEL定義を配備できない
BPEL定義を配備できない。または、BPEL定義の配備操作を実行しても配備が完了しない場合は、以下の対処を実施してください。
ビジネス・プロセス実行環境が起動しているかどうか確認してください。起動していない場合は、ビジネス・プロセス実行環境を起動し
たのちに、システムログ/イベントログで配備が成功したか確認してください。
配備に失敗している場合は、WSBPEL-50000番台のメッセージが出力されています。“ISI メッセージ集”を参照して対処してください。
18.2.2 BPEL起動アプリケーションが作成できない
BPEL起動アプリケーション作成時に以下のエラーメッセージが出力される場合、以下の対処を実施してください。
・ J2EE実行環境のBPEL起動アプリケーション作成時
－ isws11226
・ Java EE実行環境のBPEL起動アプリケーション作成時
－ JAXWS1162
－ JAXWS1179
－ JAXWS1180
－ JAXWS1160
BPEL定義のWSDL定義が参照している外部ファイルの参照方法に誤りがあります。正しい参照方法になるように、BPEL定義を修正
してください。参照方法の詳細については、“ISI アプリケーション開発ガイド”の“BPEL機能のアプリケーション開発”の“BPELエディ
タによるBPEL定義の作成方法”の“WSDL定義の編集”の“外部ファイルの参照に関する注意事項”を参照してください。
- 55 -
索　引
[F]
Formatmanagerの定義に関する異常...................................... 16
Formatmanagerの変換テーブルに関する異常..................16,44
[I]
ISI運用管理コンソールの表示がおかしい............................. 40
ISIの起動/停止に関するトラブル............................................ 19
ISIの定義に関する異常......................................................13,42
ISIの定義変更時のトラブル................................................17,45
[あ]
アダプタの起動で失敗する................................................ 24,49
アンインストール時の異常......................................................... 7
アンセットアップに失敗する.....................................................11
移行後の異常.......................................................................... 27
一括情報採取ツール.................................................................1
インストール時の異常................................................................ 3
[か]
起動/停止に失敗する......................................................... 25,50
クラスタシステムに関するトラブル............................................19
コアダンプの採取.......................................................................1
[さ]
実行モニタの表示が正しくない.......................................... 12,40
シーケンスリトライに関するトラブル......................................... 18
セットアップに失敗する......................................................... 9,33
[は]
ビジネス・プロセス実行環境作成時の異常....................... 31,55
ビジネス・プロセス実行時の異常....................................... 29,53
非同期メッセージング構成のISIサーバ運用時のトラブル17,45
[ま]
メッセージが正しく変換されない........................................ 25,50
メッセージの送受信に失敗する......................................... 20,47
[ら]
リストア後の異常..................................................................27,52
リストア時の異常..................................................................27,52
ログインに失敗する............................................................. 12,40
- 56 -

はいしゃうんちく其の四 "タバコいつやめるの？？"

Weekly Report 中東・北アフリカの政治・治安情勢 （4/8－15，2013）

聴覚刺激は視覚的時間知覚の正確性・安定性を高めるのか

INTEC TECHNICAL JOURNAL

納入書取扱いのお願い - 余市町ホームページ

企業の合併・買収に耐えうるソフトウェア開発手法

若い人に伝えたい論文作成と投稿の心得

No.148 - 日本統計学会

経路積分 - あもんノート

ネイマンの標本調査理論とその周辺（下