このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索の URL を出力します。
このスクリプトでは、e-docs マニュアルに必要なバナーを出力します。
このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索のパラメータを出力します。
WebLogic Integration 10.2 へのアップグレード
™ 8.1.x、8.5.x、および 9.x から WebLogic Integration 10.2 へのアップグレードに関する情報を説明します。次のトピックが含まれます。
WebLogic のアプリケーション環境のアップグレード 』を読んでおいてください。このガイドでは、アプリケーション環境を WebLogic 10.2 にアップグレードする手順を説明しています。アプリケーション環境には、アプリケーション、アプリケーションがデプロイされている WebLogic ドメイン、そのドメインに関連するすべてのアプリケーション データが含まれます。また、データベース サーバ、ファイアウォール、ロード バランサ、LDAP サーバなどの外部リソースが含まれることもあります。
file store、WseeFileStore、JMS サーバ WseeJmsServer、および関連する JMS モジュールなど、高度な Web サービスをサポートするためのリソースが追加される。 P13n) アプリケーションをサポートするために共有ライブラリ モジュールが追加される。 JWSQueueTransport EJB がドメインにある場合は削除される。 SQLAuthenticator セキュリティ プロバイダがドメインに追加される。
注意 : ユーザ portaladmin および weblogic は、SQLAuthenticator セキュリティ プロバイダに追加されます。ドメインがアップグレードされた後で、これらのユーザを DefaultAuthenticator セキュリティ プロバイダから削除できます。
pointbase.ini ファイルが更新され、PointBase v5.1 に対して database.home、documentation.home、および pbembedded.lic が設定される。 weblogic_eval に変更され、関連するデータ ソース JDBC ドライバ URL が対応して修正される。 setDomainEnv.cmd および setDomainEnv.sh に引き継がれる。
P13n) アプリケーションをサポートするために共有ライブラリ モジュールがアップグレードされる。 BEA WebLogic Server 10.0 の互換性について WebLogic ドメインのアップグレード 」を参照してください。
setDomainEnv.cmd ファイルを編集し、PRODUCTION_MODE=true を設定します。 JAVA_VENDOR=Sun を設定 (または setDomainEnv.cmd を編集して set WL_HOME=.... 行の後にこの設定を追加) します。 BEA_HOME\wlserver_10.0\common\bin\commEnv.cmd ファイルで定義します。
グラフィカル - 対話形式でドメインをアップグレードする場合、グラフィカル ユーザ インタフェースのドメイン アップグレード ウィザードを使用します。 サイレント - アップグレード要件をファイルに指定すると、ドメインを静的にアップグレードできます。
注意 : グラフィカル モードでアップグレード ウィザードを実行するコンソールでは、Java ベースの GUI をサポートしている必要があります。グラフィカル表示をサポートできないシステム上でグラフィカル モードでアップグレード ウィザードを開始しようとすると、アップグレード ウィザードの呼び出しに失敗し、エラー メッセージが表示されます。
スタート ｜すべてのプログラム ｜BEA ｜Tools ｜Domain Upgrade Wizard ]
注意 : この方法は、JDBC ドライバ クラスを指定するために環境をカスタマイズする必要がない場合にのみ使用できます。
ドメインのアップグレードに関する重要な注意事項
CLASSPATH 環境変数に、WL_HOME\server\bin を PATH 環境変数に追加する。ここで、WL_HOME は WebLogic Server のインストール ディレクトリの最上位レベルを指します。WL_HOME\server\bin\setWLSenv スクリプトを使用できます。
CLASSPATH 環境変数に追加されていることを確認する。
\common\bin\upgrade.cmd /common/bin/upgrade.sh BEA_HOME/user_projects/upgrade_logs ディレクトリに格納されます。
java weblogic.Upgrade [-type domain] [-out file]
-type および -out の 2 つの引数は省略可能です。これらの引数は、次のデフォルト値をオーバーライドする場合に指定します。
-type オプションでタイプを指定しない場合、ドメインのアップグレードが実行されます。 stdout) およびエラー メッセージが書き込まれる出力ファイル。-out オプションでファイルを指定しない場合、これらのメッセージはコマンド ウィンドウに書き込まれ、アップグレード プロセスの終了時にその概要が表示されます。
次へ ] をクリックして次のウィンドウに進みます。
WebLogic ドメインをアップグレードする手順
アップグレードするドメインの WebLogic バージョンを選択する。
ローカルのディレクトリ階層を移動して、アップグレード対象の WebLogic ドメインが格納されているディレクトリを選択する。
ウィザードによるドメインの調査状況を確認する。進行状況メッセージがウィンドウに表示される。
カスタム セキュリティ プロバイダが使用されているドメインを、そのセキュリティ プロバイダより先にアップグレードしようとすると、エラー メッセージが表示され、ウィザードが終了する。
このエラー メッセージが表示されたら、カスタム セキュリティ プロバイダをアップグレードしてから、ドメインのアップグレード手順を再開する。
調査が完了し、エラーが発生しなかった場合は、次のウィンドウが自動的に表示される。
新しいドメインで管理サーバとして機能するサーバを選択する。
注意 : ドメインで定義されているサーバが 1 つのみである場合、このウィンドウはスキップされる。このウィンドウは、アップグレードしているドメインに複数のサーバが存在する場合にのみ表示される。
ノード マネージャの認可を得るため、ユーザ名とパスワード (および確認パスワード) を入力する。
WebLogic Server 10.0 のノード マネージャでは、ドメインごとにユーザ名とパスワードを指定する必要がある。デフォルトのユーザ名とパスワードは
weblogic に設定されている。ノード マネージャを使用しない場合、デフォルトの値は変更せずにそのままにしておく。
注意 : バックアップされるのはドメインのディレクトリのみで、ファイルのパーミッションは保存されない。ドメインや外部アプリケーション、およびアプリケーション データベース リソースは別々のプロセスでバックアップしておくことが推奨される。
ウィザードによるドメイン情報や設定オプションの処理状況を確認する。進行状況メッセージがウィンドウに表示される。
処理が完了すると、次のウィンドウが自動的に表示される。
ウィザードによるドメインのバックアップ準備状況を確認する。進行状況メッセージがウィンドウに表示される。
処理が完了すると、次のウィンドウが自動的に表示される。
weblogic-domain-backup-domain.zip (domain はドメインの名前)。
ウィザードによるドメインのバックアップ状況を確認する。進行状況バーにバックアップ プロセスの完了割合が表示され、ウィンドウには進行状況のメッセージが表示される。
注意 : ウィザードで作成されるバックアップ ファイルは機密情報を含む場合があるため、ユーザが保護する必要がある。
バックアップ プロセスが完了すると、次のウィンドウが自動的に表示される。
ウィザードによるドメイン ディレクトリの再構築状況を確認する。進行状況メッセージがウィンドウに表示される。
処理が完了すると、次のウィンドウが自動的に表示される。
ウィザードによるコンフィグレーション設定のアップグレード状況を確認する。進行状況メッセージがウィンドウに表示される。
コンフィグレーション情報は後の手順まで保持されない。
コンフィグレーションのアップグレードが完了すると、次のウィンドウが自動的に表示される。
保存されているメッセージおよびトランザクション ログ フォーマットのアップグレード
ドメインに存在する永続メッセージ (JMS ファイルと JDBC ストア) およびトランザクション (JTA) ログのウィザードによるアップグレード状況を確認する。進行状況バーに完了割合が表示され、ウィンドウには進行状況のメッセージが表示される。
永続メッセージとトランザクション ログのアップグレード プロセスが完了すると、次のウィンドウが自動的に表示される。
Execute Upgrade of Required WebLogic Personalization Components
ウィザードによるパーソナライゼーション コンポーネントの更新状況を確認する。
RDBMS Authenticator セキュリティ プロバイダのアップグレード
非推奨の RDBMSAuthenticator を SQLAuthenticator に置換するかどうかを指定する。
注意 : このウィンドウは、アップグレード対象のドメインに RDBMSAuthenticator セキュリティ プロバイダが存在する場合にのみ表示される。
次へ ] をクリックして次のウィンドウに進む。
WLI ドメイン アップグレード プラグインの準備
ここで、ドメイン内の WebLogic Integration 固有リソースがアップグレードされる。
WLI ドメイン アップグレード プラグインの実行
ドメイン内の WebLogic Integration リソースのウィザードによるアップグレード状況を確認する。
ウィザードによるアップグレード済みコンフィグレーションの保存状況と、アップグレード プロセスで作成された一時ファイルの削除状況を確認する。進行状況メッセージがウィンドウに表示される。
注意 : リモートの管理対象サーバをアップグレードする際、そのコンフィグレーション情報は保存されない。
この処理が完了したら、[
次へ ] をクリックして次のウィンドウに進む。
次に進む前にドメイン データベースをアップグレードするかどうかを指定する。
ドメイン データベースはバックアップされない。ドメイン データベースのバックアップは、ドメインのアップグレードを開始する前に実行する必要がある。
オプションを選択したら、[
次へ ] をクリックして次に進む。
Associate DB Categories with Datasources
データベースのカテゴリと関連するデータ ソースが表に表示される。カテゴリは、ドメイン データベースを初期化する際に関連するデータ ソースとともに使用される。データ ソースが未定義と表示された場合、正しいデータ ソースを使用してカテゴリを更新できる。未定義のデータ ソースはスキップされ、アップグレードされない。ほとんどの場合、関連付けは正しいため、その他の変更は必要ない。
注意 : DB カテゴリをアップグレードするには、データ ソースがそのカテゴリに関連付けられ、未定義でないことを確認する必要がある。未定義のデータ ソースはスキップされ、アップグレードされない。
Initialize Category/Datasource Table
注意 : このウィンドウは、ドメイン データベースのアップグレードを選択した場合にのみ表示される。
ドメイン データベース スキーマ オブジェクトのアップグレードに向けたウィザードによる準備状況を確認する。
処理が完了すると、次のウィンドウが自動的に表示される。
注意 : このウィンドウは、ドメイン データベースのアップグレードを選択した場合にのみ表示される。
ウィザードによるドメイン データベースのアップグレード状況を確認する。
処理が完了すると、次のウィンドウが自動的に表示される。
さらなる検討を要する重要なメッセージなど、アップグレードの結果を確認する。
[
完了 ] をクリックして WebLogic アップグレード ウィザードを閉じる。
注意 : サイレント モードでは、WebLogic Server ドメインのみがアップグレードできます。
ドメインのアップグレードに関する重要な注意事項
CLASSPATH 環境変数に、WL_HOME\server\bin を PATH 環境変数に追加する。ここで、WL_HOME は WebLogic Server のインストール ディレクトリの最上位レベルを指します。WL_HOME\server\bin\setWLSenv スクリプトを使用できます。
CLASSPATH 環境変数に追加されていることを確認する。 サイレント アップグレード用 XML スクリプト リファレンス cd c:\bea\user_projects\domains\domain
domain はドメインの名前です。
-responses 引数と -out 引数は省略可能です。これらの引数は、次のデフォルト値をオーバーライドする場合に指定します。
-responses オプションでファイルを指定しない場合、アップグレード プロセスではデフォルト値が使用されます。デフォルト値と XML ファイル形式の詳細については、「サイレント アップグレード用 XML スクリプト リファレンス stdout) およびエラー メッセージが書き込まれる出力ファイル。-out 引数でファイルを指定しない場合、これらのメッセージはコマンド ウィンドウに書き込まれます。
startWeblogic.cmd ファイルの変数 JAVA_OPTIONS に -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0 フラグを追加する。set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% を
set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%
"-Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0"
SAVE_JAVA_OPTIONS="${JAVA_OPTIONS}" を
SAVE_JAVA_OPTIONS="${JAVA_OPTIONS}
-Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0"
WebLogic Integration 8.1 へのアップグレード 』を参照してください。 WebLogic ドメインのアップグレード 」を参照してください。
weblogic-application.xml ファイルにクラスローダ階層を指定する必要があります。 weblogic-application.xml ファイルに追加する必要がある。 <wls:library-ref>
<wls:library-name>sb-transport-control-10.0</wls:library-name>
<wls:specification-version>10.0</wls:specification-version>
<wls:implementation-version>10.0</wls:implementation-version>
</wls:library-ref>
weblogic-application.xml ファイルにこのエントリを追加できます。
src ディレクトリに移動される。
注意 : JPD または Process Proxy を使用してビジネス プロセスへの RMI コールを行う EJB プロジェクト、非 Web プロジェクト、または非ユーティリティ プロジェクトを含む 8.1.x または 8.5.x アプリケーションをアップグレードするとき、すべての非 Web プロジェクトまたは非ユーティリティ プロジェクトにプロセス ファセットを追加しないでください。かわりに、ライブラリ (プロセス ライブラリ) をプロジェクトの java ビルド パスに次のように追加します。
プロジェクト プロパティー Java のビルド・パス ] を選択します。 ライブラリーの追加 ｜プロセス ライブラリ ] をクリックします。
注意 : アップグレード後にアプリケーションをビルドすると、WLI 8.1.x または 8.5.x から 10.2 へアップグレードしたアプリケーションについて Eclipse のログに InvocationTargetException が記録されます。この例外を再現する手順は次のとおりです。
注意 : この例外を回避する手順は次のとおりです。
ウィンドウ｜設定｜検証 ] を選択し、[XML バリデータ] チェック ボックスを解除する。 Tutorial: Upgrading the WLI 8.1 or WLI 8.5 Application Source
Upgrading the 9.2 Application Source
注意 : 10.2 へのアップグレードが完了したら、アップグレード前に 9.x プロジェクトに対して手動で行ったすべての変更を再実行する必要があります。
注意 : コマンドライン ユーティリティを実行するときは、JRE の 1.5 実装を使用します。クラスパスに <%ECLIPSE_HOME%>/startup.jar が含まれていることを確認してください。
startup.jar を含むディレクトリのパス。Workspace Studio のデフォルトは次のとおりです。
BEA_HOME/workshop_10.2/workshop4WP/eclipse
WebLogic Server ルート フォルダの場所。デフォルトを次に示します。
-Dwlw.application=WORK_FILE
アップグレードが必要なアプリケーション。アップグレードする WebLogic Workshop 8.1 に対応する作業ファイル名で
WORK_FILE を置き換えます。
-application com.bea.workshop.upgrade81.upgradeStarter
このコマンドの実行に使用される Eclipse プラグインの拡張ポイント。
アップグレードしたアプリケーションを移動するターゲット ワークスペースの名前。バージョン 10.2 のアプリケーション ファイルを生成する任意のディレクトリを指定できます。
[-pluginCustomization PREFS_FILE]
アップグレードのオプションを設定するために使用されるプロパティ ファイルを指定します。複数のキーと値のペアを含むプロパティ ファイルの名前で
PREFS_FILE を置き換えます。次のプロパティを指定できます。
application には、実行時のプラグイン拡張ポイントを指定する。 weblogic.home には、WebLogic Server ルート フォルダの場所を指定する。 data には、アップグレードしたアプリケーションを配置するターゲット ワークスペースの名前を指定する。このパラメータの名前は Eclipse で提供され、上書きできません。 wlw.application には、アプリケーション作業ファイルの名前を指定する。 pluginCustomization には、複数のキーと値のペアを含むプロパティ ファイルの名前を指定する。
com.bea.wlw.workshop.upgrade81/upgradeHarnessAbortOnError=true/false
この属性を指定しないと、デフォルトは
false になります。この場合、エラーの後もアップグレードの続行が試行されます。
true に設定すると、エラーを検出したときにアップグレード プロセスが失敗します。このようなエラーはログ ファイルに出力されます。
com.bea.wlw.workshop.upgrade81/upgradeHarnessMessageLevel
この属性はメッセージ レベルを指定します。この属性を指定しない場合、アップグレード ツールではすべてのメッセージのログが記録されます。この属性には次の値を指定できます。
INFO : すべてのメッセージを表示。 WARNING : 警告、エラー、および致命的メッセージを表示し、情報メッセージを表示しない。 ERROR : エラーおよび致命的メッセージのみ表示。
com.bea.wlw.workshop.upgrade81/migrateJSPPreference=true/false
この属性を指定しないと、デフォルトは
false になります。
true に設定すると、アップグレード プロセスによって JSP ファイルが新しい Beehive アノテーションに移行されます。
com.bea.wlw.workshop.upgrade81/useJ2EESharedLibraries=true/false
この属性を
false に設定すると、アップグレードの際に Web アプリケーション ライブラリが WEB-INF/lib にコピーされます。デフォルトではアップグレード時に J2EE 共有ライブラリが使用されます。
com.bea.wlw.workshop.upgrade81/upgradeHarnessReportOnly=true/false
この属性を
true に設定すると、アップグレード レポートが生成されます。デフォルト設定の
false では、レポート生成とアップグレードの両方が実行されます。
com.bea.wlw.workshop.upgrade81/upgradeHarnessLogFile=<log file location>
この属性を使用して、アップグレード ログ ファイルの場所を指定します。デフォルト値は
<workspace location>/.metadata/upgrade.log です。
com.bea.wlw.workshop.upgrade81/upgradeProjectImportOverwrite=true/false
この属性を使用して、プロジェクト名が競合したときに既存のプロジェクトを上書きするかどうかを指定します。デフォルト値は
false です。
com.bea.wlw.workshop.upgrade81/upgradeProjectImportPrefix
この属性を使用して、インポートされるすべてのプロジェクトに付けるオプションのプレフィックスを指定します。
com.bea.wlw.workshop.upgrade81/upgraderPrefMoveResourceBundle = true/false
この属性を使用して、拡張子が
.properties のファイルを Web コンテンツ フォルダからソース ファイル フォルダにコピーするか移動するかを指定します。デフォルト値は
false です。
注意 : 9.x アプリケーションを WLI 10.2 にアップグレードするには、利用できるコマンドライン ユーティリティがないため、Workspace Studio を使用する必要があります。メタデータは IDE でプロジェクトを開くとアップグレードされます。
%BEA_HOME%/ tools/eclipse_pkgs/1.1/pkgs/eclipse/plugins/com.bea.workshop.upgrade81_1.0.20 フォルダにデプロイされた wlw-upgrade.jar にあります。
注意 : Ant タスクを実行するときは、次の Ant タスク例の classpathref 属性で指定されているように、<%ECLIPSE_HOME%>/startup.jar がタスクのクラスパスにあることを確認してください。
WebLogic Integration 8.1.x または 8.5.x アプリケーションのインポートとアップグレードが行われる Eclipse ワークスペース。
startup.jar を含む Eclipse ディレクトリ。
<%BEA_HOME%>\tools\eclipse_pkgs\1.1\eclipse_3.2.2
<%BEA_HOME%>\tools\eclipse_pkgs\1.1\pkgs
WebLogic Server ルート フォルダの場所。
<%BEA_HOME%>\wlserver_10.0
インポートまたはアップグレード時に使用されるオプションの環境設定ファイルの場所。
WebLogic Workshop 8.1.x または 8.5.x アプリケーションをインポートまたはアップグレードするための作業ファイルの場所。
注意 : WLI 9.x のアプリケーションを WLI 10.2 にアップグレードできる Ant タスクは存在しません。
UPGRADE_WORKSPACE_HOME\.metadata\upgrade.log
!SUBENTRY 1 com.bea.workshop.upgrade81 severity_level date time
!MESSAGE Upgrade-related message.
!SUBENTRY 1 com.bea.workshop.upgrade81 2 2 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 Workspace Studio upgrade documentation for more information.
!SUBENTRY 1 com.bea.workshop.upgrade81 1 1 2006-02-27 17:17:53.687
!MESSAGE The import "com.bea.control.JwsContext" needs to be updated.
確認済みの制限事項
build/EJB ディレクトリで使用可能になっている必要がある。 wli-process.xml、wli-subscriptions.xml、および wlw-manifest.xml が、build/processoutput/WEB-INF/ ディレクトリで使用可能になっている必要がある。
注意 : wlw-manifest.xml ファイルは、EAR ファイルで参照されるサーバ リソースに関する情報を提供します。サーバの管理者は wlw-manifest.xml ファイルを確認してデプロイメントの成功に必要なリソースを判別する必要があります。wlw-manifest.xml ファイルはエンタープライズ アプリケーションの META-INF/wlw-manifest.xml に生成されます。10.x では、各 Web アプリケーションの WEB-INF ディレクトリに生成されます。
UtilProject\build\classes\channeloutput ディレクトリに wli-channels.xml ファイルを含む。 表 2-2 に、WLI 9.2 以降に修正されたアップグレードに関する問題を示します。
内部 weblogic.apache.* クラスが誤ってパブリックとして記述されていた。
WLS Dante の JWS で Workshop 8.1 JWS スタイルのコールバックがサポートされた。この修正により、アップグレードのシナリオで WLS Dante の Web サービスが WLI Dijon の JPD とともに機能できる。
Sun™ の rmic コンパイラでマニフェスト クラスパスが無視される。
メッセージで
xs:anyType が確実に正しく処理されるようになった。
バージョン 8.1 の Web サービスを
xs:any ではなく
xs:anyType を指定した WSDL から生成した場合、その Web サービスではバージョン 9.2 へのアップグレード後に不正な XML ペイロードが送受信される。次のアノテーションをクラス レベルで Web サービスに適用することによって、
xs:anyType を正常に処理できるようになる。
@WildcardBinding(className="org.apache.xmlbeans.XmlObject",
binding=WildcardParticle.ANYTYPE)
9.2 Workshop IDE コンポーネントがインストールされていない場合、WLI 8.1 または Portal ドメインをアップグレードできない。
src/wlw から
src/workshop/runtime への実行時コードの移行。
サード パーティのコントロールをパッケージ化し、稼働中の Workshop/サーバにインストールして、そのコントロールを設計時 (Workshop 環境) およびサーバの実行時に利用できるようにするためのサポート。
8.1 アプリケーションの (PageFlowStack) PageFlowUtils.getPageFlowStack は PageFlowStack.get にアップグレードされないため、アップグレード後にスタックから PageFlowStack にキャストできない。
コールバック インタフェースが空の場合、WLI 8.1 カスタム コントロールがアップグレード後にコンパイルされない。
JDBC コントロールで array-max-length アノテーションの値として「all」がサポートされない。
サービス コントロールでクラスタ アドレスの JMS URL クエリ文字列を解析し、スタブを介して設定するためのサポートの追加。
ソースのアップグレードで、security-constraints 内で web-resource-collection 要素が複数ある web.xml の処理に失敗する。
MessageBuffer アノテーションを使用してアップグレードした JWS で、retryCount と retryDelay に不正な値が含まれる。
アノテーション処理におけるエラーが原因でビルドが完了しなかった場合でも、IDE では「ビルドが成功した」と誤って表示される。
アップグレードされた WLI ドメインがアップグレードされたワークリスト アプリケーションをサポートするように正しくコンフィグレーションされない。
不正なパッケージ名が原因で、アップグレード後に ebXML コントロールを持つ B2B アプリケーションがコンパイルに失敗する。
Portal フレームワーク : JDK 1.5 内部 DOM 3 パーサへの切り替え。
JPD から Portal のルール コントロールを呼び出すことができない。
