| Interstage Application Server 移行ガイド |
|
目次
索引
|
| 第4章 Interstage Application Server V5からの移行 |
ここでは、以前のバージョン・レベルのEJBサービスからの移行について説明します。
運用方法の種類として、Interstage V5で提供されていた高速呼出し機能、およびV5.1で提供されたIJServer (Light EJBコンテナ機能)の運用方法、またはV6で提供されたIJServerの運用方法があり、選択する運用方法によって移行方法が異なります。
大きく分けて以下の2種類の移行方法があります。
特に移行作業は必要ありません。
上書きインストールを行うことで、旧環境がそのまま引き継がれます。
V6から提供されている機能は使用できません。
旧環境を引き継ぐためにはバックアップ作業、およびリストア作業が必要になります。
cpコマンドなどを使用して、以下のファイルのバックアップを行ってください。
- /opt/FJSVejb/etc/* (helpディレクトリは除く)
- /opt/FJSVj2ee/var/deployment/deployed/ejbapp または、
- ejbmakeapfolderコマンドで作成したディレクトリ配下の全ファイル
注)EJBサービス資源のバックアップを行う前に、コンポーネントトランザクションサービス資源とCORBAサービス資源のバックアップ、またはLight EJBコンテナ機能を使用していた場合にはejbinfocontainerコマンドですべてのEJBコンテナ定義のバックアップを行う必要があります。
また、リストア作業では、ejbmakeacontainerコマンド、およびejbinstallebコマンドを使用して、バックアップしておいた資源のリストアを行います。Light EJBコンテナ機能を使用する場合には、バックアップしたすべてのEJBコンテナを作成する必要があります。
バックアップとリストア作業の詳細については、旧バージョンの“Interstage運用ガイド”を参照してください。
従来の運用方法に対して下表のような差異があるため、移行の際は留意が必要です。
なお、V6で提供されたIJServerに対するセットアップ、および運用操作はInterstage管理コンソールを用いて簡単に行うことができます。
以下に、それぞれの運用方法の違いを表で表します。
|
|
高速呼出し機能 |
旧バージョンにおけるIJServer |
Interstage V6 |
|---|---|---|---|
|
クライアントの環境設定 |
以下のファイルをクラスパスに設定します。
|
以下のファイルをクラスパスに設定します。
|
以下のファイルをクラスパスに設定します。
(fjcontainer64.jarを使用することも可能ですが、特にJDKによってクラスパスを変更する必要はありません。) |
|
配備 |
以下のツールを使用して配備を実行します。
配備実行後にカストマイズツールを使用して、Java VM外から呼び出されるBeanを1つだけ“高速に呼び出すBean”に定義し、Java VM内で呼び出されるBeanを“高速に呼び出されるBean”に定義します。 |
以下のツールを使用してIJServer(またはLight EJBコンテナ)を作成します。
以下のツールを使用してIJServerに対してWebアプリケーション/EJBアプリケーションを配備します。
IJServerに配備されたEJBアプリケーションは、同一Java VM上で動作します。ServletとEJBは別Java VMで動作します。 |
以下のツールを使用してIJServerを作成して、IJServerに対してWebアプリケーション/EJBアプリケーションを配備します。IJServerに配備されたEJBアプリケーションは同一Java VM上で動作します。
IJServerには以下の4種類のIJServerを選択できます。
|
|
カスタマイズ |
以下のツールを使用してEJBアプリケーションをカスタマイズします。
|
以下のツールを使用してEJBアプリケーションをカスタマイズします。
または以下のツールを起動し、配備済みのEJBアプリケーションを選択してカスタマイズします。
|
以下のツールを使用して配備済みのEJBアプリケーションを選択してカスタマイズします。
|
|
運用 |
以下のツールを使用して高速に呼び出されるBeanを登録したワークユニットを定義します。
定義したワークユニットは以下のツールを使用して起動します。
|
IJServerを定義するとワークユニットも自動的に定義されます。
|
Interstage V6ではIJServerは以下のように位置付けています。 「J2EEアプリケーションを運用するワークユニットをIJServerと呼びます。(IJServerとワークユニットは１対１の関係を持ちます。) IJServerはJ2EEアプリケーションの配備対象であり、起動/停止の単位です。」 以下のツールを使用してIJServerを起動します。
|
|
リソ｜ス定義 |
以下のツールを使用してJ2EEの各種リソースを定義します。
|
以下のツールを使用してJ2EEの各種リソースを定義します。
|
|
旧バージョンでMessage-driven Beanを運用する場合、カストマイズツールによるJMSコネクションファクトリ名とDestination名の定義が必須でした。
V6では、JMSコネクションファクトリ名とDestination名を定義しなかった場合、以下のデフォルト設定で動作します。
Topicの場合:TopicCF001
Queueの場合:QueueCF001
EJBアプリケーション名をデフォルトのDestination名とします。
また、旧バージョンにおいて、トランザクション管理種別に“Container”が指定されていてトランザクション属性が設定されていないEJBアプリケーションは、運用することができませんでした。
V6では、コンテナが自動的に“Required”が指定されたものとしてトランザクションの制御を行います。
以下の機能群は、V6より非推奨機能となりました。いずれも旧資産との互換は保証されていますが、次期バージョンでは提供されない可能性があるため、代替機能への移行を推奨します。
なお、これらの機能に対する定義操作は、Interstage管理コンソールではサポートされていません。
STATEFUL Session Beanの無通信監視機能をサポートしたことにより、セションタイムアウト機能は非推奨機能となっています。
Interstage管理コンソールからは定義できません。
下位互換性の考慮としてV6でセションタイムアウト機能を使用する場合は、セションタイムアウト機能を使用していたEJBアプリケーション実行環境を、カストマイズツールの運用コマンドを使用して移出し、V6のEJBアプリケーション実行環境に移入してください。
詳細は“J2EEユーザーズガイド”の“運用コマンドを使用してカスタマイズする方法”を参照してください。
下位互換性のために、旧資産をそのまま使用する場合には引き続きサポートされます。
代替機能である“STATEFUL Session Beanの無通信監視機能”については、J2EEユーザーズガイドの“STATEFUL Session Beanの無通信監視機能”を参照してください。
セションタイムアウト機能を使用する場合は、STATEFUL Session Beanの無通信監視機能を使用することはできません。
EJBのトランザクションタイムアウト機能は非推奨機能となっています。
Interstage管理コンソールからは定義できません。
下位互換性の考慮としてV6でトランザクションタイムアウト機能を使用する場合は、トランザクションタイムアウト機能を使用していたEJBアプリケーション実行環境を、カストマイズツールの運用コマンドを使用して移出し、V6のEJBアプリケーション実行環境に移入してください。
詳細は“J2EEユーザーズガイド”の“運用コマンドを使用してカスタマイズする方法”を参照してください。
トランザクションタイムアウトの代わりにワークユニットの時間監視機能を使用してください。
ワークユニットの時間監視をIJServerワークユニット作成時に設定する場合は、[詳細設定] > [ワークユニット設定]から、また作成済みのIJServerワークユニットに対して設定する場合は、[ワークユニット] > [環境設定] > [ワークユニット設定]から“アプリケーション最大処理時間”を設定してください。
Interstage管理コンソールの詳細については、Interstage管理コンソールのヘルプを参照してください。
IJServerの最大メモリ量をIJServerワークユニット作成時に設定する場合は、[詳細設定] > [ワークユニット設定]から、また作成済みのIJServerワークユニットに対して設定する場合は、[ワークユニット] > [環境設定] >[ワークユニット設定]から“JavaVMオプション”において以下を指定してください。
Interstage管理コンソールの詳細については、Interstage管理コンソールのヘルプを参照してください。
-Xmx[最大メモリ量]m
V5で指定可能であったワークユニット定義項目のEJBアプリケーション最大メモリ量(Maximum Memory for EJB Application)は、ワークユニットの設定項目に表示されません。
V5で提供されたIJServerでは同時処理数のデフォルトは40でしたが、V6で提供されたIJServerでは同時処理数の最大値が64/最小値が16で動作します。
同時処理数の最大値/最小値は、Interstage管理コンソールの[ワークユニット] > [EJBコンテナ設定]の“同時処理数”で設定可能です。
V5でサポートしていた以下の性能オプションについては、デフォルトで動作します。
Interstage管理コンソールで指定する必要はありません。
STATELESS Session Beanのインスタンス数を定義する必要がなくなりました。
STATELESS Session Beanのインスタンスは、STATELESS Session Beanへの初回アクセス時に“同時処理数の最大値”に指定された値の数だけ作成されます。
Interstage V5、Interstage V5.1、またはInterstage V6でメッセージの番号とテキストを改善したことにより、以前のバージョン・レベルで出力されていたメッセージ番号およびメッセージテキストと、出力内容が異なる場合があります。
以前のバージョン・レベルのメッセージを出力したい場合は、以下の設定を行ってください。
|
項目 |
設定内容 |
|
定義ファイル格納ディレクトリ |
|
|
定義ファイル |
FJEJBconfig.properties |
|
指定するキー名 |
“MsgNoCompatible”(固定) |
|
指定する値 |
“V4”または“V5”または“V51”を指定します。 |
上記ファイルが存在しない場合や指定するキー名、または、値が違っている場合は、Interstage V6、Interstage V5.1、Interstage V5で改善されたメッセージ内容が出力されます。
以下に、改善されたメッセージについて表で示します。
【Interstage V5で改善されたメッセージ】
|
旧メッセージ番号 |
新メッセージ番号 |
|
EJB1023 |
EJB1081 |
【Interstage V5.1で改善されたメッセージ】
|
旧メッセージ番号 |
新メッセージ番号 |
|
EJB1020 |
EJB1096 |
|
EJB1024 |
EJB1092、EJB1093 |
|
EJB1029 |
EJB1094 |
|
EJB1038 |
EJB1095 |
|
EJB1204 |
EJB1247、 EJB1248、 EJB1249 |
【Interstage V6で改善されたメッセージ】
|
旧メッセージ番号 |
新メッセージ番号 |
|
EJB1079 |
IJServer21131 |
また、以下の英語メッセージについては、V6でスペルミスを修正しています。
|
旧メッセージ |
新メッセージ |
|
EJB: ERROR: EJB1056: The transaction attribute in this method is not specificate: NAME=%s1 METHOD =%s2 |
EJB: ERROR: EJB1056: The transaction attribute in this method is not specified: NAME=%s1 METHOD =%s2 |
|
EJB: INFO: EJB1063: Status of the transaction maked rollback : NAME=%s1 METHOD =%s2 |
EJB: INFO: EJB1063: Status of the transaction marked rollback : NAME=%s1 METHOD =%s2 |
|
EJB: ERROR: EJB1094: Session time-out is occured: NAME=%1 CODE=%2 |
EJB: ERROR: EJB1094: Session time-out is occurred: NAME=%1 CODE=%2 |
|
EJB: ERROR: EJB1096: System Exception is occured during business method called: NAME=%1 METHOD=%2 CODE=%3 |
EJB: ERROR: EJB1096: System Exception is occurred during business method called: NAME=%1 METHOD=%2 CODE=%3 |
|
EJB: ERROR: EJB1249: JTS Exception is occured when you get JDBCConnection: METHOD=%1 RESOURCE=%2 |
EJB: ERROR: EJB1249: JTS Exception is occurred when you get JDBCConnection: METHOD=%1 RESOURCE=%2 |
V5で各ファイルに出力されていた以下の情報については、IJServerのログ(Windows(R)システムの場合、J2EE共通ディレクトリ\ijserver\[IJServer名]\log配下のファイル、Solaris OE/Linuxシステムの場合、/opt/FJSVj2ee/var/deployment/ijserver/[IJServer名]/log配下のファイル)に出力されます。
なお、従来から出力しているイベントログのメッセージについては、従来通りイベントログにもメッセージが出力されます。
(注1)
connectorのログ出力先を、従来(V5以前)と同じ場所に出力する場合は、以下を設定してください。
|
定義ファイル格納ディレクトリ |
|
|
定義ファイル |
jca.properties |
|
指定するキー名 |
log.file.option |
|
指定する値 |
V5 |
log.file.option=V5
EJBアプリケーション名に":"を使用することはできません。V5で":"を使用していた場合には、配備時にEJBアプリケーション名を変更してください。
なお、名前を変更したEJBアプリケーション名を、アプリケーション名を変更せずにlookupする場合には、名前変換機能を使用してください。
|
目次
索引
|
