|
|
このドキュメントでは、WebLogic Integration™ 8.1 から WebLogic Integration 9.2 または 9.2 MP1 へのアップグレードについて説明します。次のトピックが含まれます。
アップグレード プロセスを開始する前に、『WebLogic のアプリケーション環境のアップグレード』を読んでおいてください。このガイドでは、アプリケーション環境を WebLogic 9.2 にアップグレードする手順を説明しています。アプリケーション環境には、アプリケーション、アプリケーションがデプロイされている WebLogic ドメイン、そのドメインに関連するすべてのアプリケーション データが含まれます。また、データベース サーバ、ファイアウォール、ロード バランサ、LDAP サーバなどの外部リソースが含まれることもあります。
WebLogic 9.2 アップグレード ウィザードでは、WebLogic Integration 8.1 SP4、8.1 SP5、8.1 SP6、8.5、8.5 SP5、および 8.5 SP6 (このドキュメントでは 8.1.x および 8.5.x と示すこともある) で作成されたドメインのみをアップグレードできます。
ドメインのアップグレード時にウィザードで実行される手順の概要を次に示します。
file store、WseeFileStore、JMS サーバ WseeJmsServer、および関連する JMS モジュールなど、高度な Web サービスをサポートするためのリソースが追加される。JWSQueueTransport EJB がドメインにある場合は削除される。P13n) アプリケーションをサポートするために共有ライブラリ モジュールが追加される。WebLogic Integration 9.2.1 ライブラリ モジュールも参照してください。SQLAuthenticator セキュリティ プロバイダがドメインに追加される。 | 注意 : | ユーザ portaladmin および weblogic は、SQLAuthenticator セキュリティ プロバイダに追加されます。ドメインがアップグレードされた後で、これらのユーザを DefaultAuthenticator セキュリティ プロバイダから削除できます。 |
PointBase 関連の環境設定は、アップグレード済みのドメイン スクリプト setDomainEnv.cmd および setDomainEnv.sh に引き継がれます。
アップグレード スクリプトの実行中にエラーが生じることがあります。エラーの修正手順は次のとおりです。
ドメインのアップグレード プロセスの詳細やアップグレード時の注意事項については、http://edocs.beasys.co.jp/e-docs/common/docs92/upgrade/upgrade_dom.html にある「WebLogic ドメインのアップグレード」を参照してください。
WebLogic Integration 9.2 では、アプリケーションを含む 8.1.x または 8.5.x を 9.2 にアップグレードするための一連のユーティリティが提供されます。この節では、WebLogic Integration を使用して構築されたアプリケーションをアップグレードする方法について説明します。
アップグレード時には、アプリケーションのロジックや目的は変更されません。WebLogic Integration によって、9.2 に対応するようにコードが移行されます。このとき、アプリケーションが Eclipse フレームワークと互換性を持つようにしたり、Javadoc アノテーションを JSR-175 準拠のアノテーションに変換したりといった変更が行われることもあります。
アプリケーションのアップグレードは 3 段階のプロセスです。
ユーザ アプリケーションをアップグレードするために、インポート ウィザードまたはコマンド ライン ユーティリティの使用を選択できます。これらはいずれも BEA Workshop for WebLogic Platform で提供されます。Ant タスクを使用することもできます。この後の節ではこれらのメソッドについて説明します。
| Notes: |
weblogic-application.xml ファイルにクラスローダ階層を指定する必要があります。
BEA Workshop for WebLogic Platform に含まれるインポート ウィザードを使用して、アプリケーションを 9.2 にアップグレードすることができます。このウィザードでは、既存の 8.1 アプリケーションのロジックや目的は変更されません。また、ソース リポジトリからアプリケーションが抽出されることもありません。8.1 のソース情報が 9.2 のソースとプロジェクト モデルに移行されます。ただし、8.1 Javadoc アノテーションは、9.2 で特別な処理が必要ないためそのまま保持されます。これらのアノテーションは保持されるため、アプリケーションがアップグレードされた後に必要な手動の処理があれば行います。
インポート ウィザードによって実行されるタスクの一部を次に示します。
src ディレクトリに移動される。| 注意 : | JPD または Process Proxy を使用して JPD への RMI コールを行う EJB プロジェクト、非 Web プロジェクト、または非ユーティリティ プロジェクトを含む 8.x アプリケーションをアップグレードするとき、すべての非 Web プロジェクトまたは非ユーティリティ プロジェクトにプロセス ファセットを追加しないでください。かわりに、ライブラリ (プロセス ライブラリ) をプロジェクトの java ビルド パスに次のように追加します。 |
BEA Workshop for WebLogic Platform には、アプリケーション全体を WebLogic Integration 9.2 で実行できるように変換するコマンド ライン ユーティリティも用意されています。
このユーティリティではファイルのチェック アウトや削除は行われません。新たにアップグレードされたファイルの自動チェック インも行われません。移行のために、基本的なファイルが WebLogic Workshop 9.2 ワークスペースにコピーされるだけです。
| 注意 : | When you run the command line utility, use JRE 1.5. Ensure that the classpath includes .コマンド ライン ユーティリティを実行するときは、クラスパスに <%ECLIPSE_HOME%>/startup.jar が含まれていることを確認してください。 |
アプリケーションをアップグレードするコマンドを次に示します。
java -cp %ECLIPSE_HOME%/startup.jar
-Dwlw.application=%WORK_FILE%
-Dweblogic.home=%WL_HOME%
org.eclipse.core.launcher.Main
-application com.bea.wlw.upgrade.upgradeStarter
-data %WORKSPACE%
-pluginCustomization %PREFS_FILE%
Ant タスクを使用して WebLogic Integration 9.2 にアップグレードすることができます。
コマンド ラインからのアップグレードには Ant タスクが含まれます。Ant タスクのクラスは、 wlw-upgrade.jar にあり、このデプロイされた ./<WORKSHOP_HOME>/eclipse/plugins/com.bea.wlw.upgrade_9.2.0 フォルダにあります。
| 注意 : | Ant タスクを実行するときは、次の Ant タスク例の classpathref 属性で指定されているように、<%ECLIPSE_HOME%>/startup.jar がタスクのクラスパスにあることを確認してください。 |
<target name="workshopUpgrade">
<echo message="${workshop.home}/eclipse"/>
<path id="eclipse.classpath"> <fileset dir="${workshop.home}/eclipse/plugins"
includes="com.bea.wlw.**/wlw-upgrade.jar"/> </path> <taskdef name="upgradeTask"
classname="com.bea.wlw.upgrade.cmdline.UpgradeTask"
classpathref="eclipse.classpath"/><upgradeTask data=%WORKSPACE%
eclipseHome=%ECLIPSE_HOME%
weblogicHome=%WL_HOME%
pluginCustomization=%PREFS_FILE%
wlwApplication=%WORK_FILE%/>
WebLogic Integration 9.2 では、選択したアップグレード プロセスに関係なく、アップグレードによる変更、エラー、および警告に関してログが生成されます。ウィザードを使用した場合は、このログがダイアログに表示されるため、プロセスの完了前に確認することができます。
ログ ファイルはアップグレードの完了後に生成され、次の場所に保存されます。
<UPGRADE_WORKSPACE_HOME\.metadata\upgrade.log
!SUBENTRY 1 com.bea.wlw.upgrade severity_level date time
!MESSAGE Upgrade-related message.
重大度レベルには同じ意味の 2 つの数字が含まれます。日付と時刻のエントリは、アップグレードがいつ試行されたかを示します。アップグレード関連のメッセージは、処理内容、警告内容、または発生したエラーを示します。次に、2 つのログ エントリを示します。
!SUBENTRY 2 com.bea.wlw.upgrade 2 1 2006-02-27 17:17:53.687
!MESSAGE The 9.2 control context only supports a subset of the 8.1 control context APIs. Please see the Workshop for WebLogic upgrade documentation for more information.
!SUBENTRY 1 com.bea.wlw.upgrade 1 1 2006-02-27 17:17:53.687
!MESSAGE The import "com.bea.control.JwsContext" needs to be updated.
アップグレードしたアプリケーションをデプロイしようとしているときに、システムが停止することがあります。停止の詳細については、『WebLogic Integration リリース ノート』の「確認済みの制限事項」の節を参照してください。
WebLogic Integration 9.2.0.0 または 9.2.1.0 のステートフル JPD アプリケーションから 9.2.2.0 にアップグレードする際に次のエラー メッセージが表示されることがあります。
java.io.InvalidClassException: javax.xml.namespace.QName; local class
incompatible: stream classdesc serialVersionUID = 4418622981026545151, local class serialVersionUID = -9120448754896609940
ドメインをアップグレードした後、サーバの再起動の前に、実行しているシステムに推奨されるシステムのソリューションは次に示す順序で行ってください。
プロセスを正常に実行するには、domain_home\bin ディレクトリの -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0 フラグを startWeblogic.cmd ファイルの変数 JAVA_OPTIONS に追加する。set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% を
set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%
-Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0
-Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0"
アップグレードが完了したら、アップグレードしたアプリケーションを構築およびデプロイして、アップグレードが正常に行われたかどうかを確認することができます。次のように必要なファイルが移動されたこと、つまり適切な場所に用意されたことを確認できます。
  
|
