WebLogic Portal 8.1 へのアップグレード

互換性モードから WebLogic Portal 8.1 へのアップグレード

この節では最初に、WebLogic Portal 互換性ドメイン内で実行するようにアップグレードされたアプリケーションを、通常の WebLogic Portal 8.1 ドメインで実行できるように移動する手順について説明します。

次に、アップグレードに関係する WebLogic Portal 8.1 の機能とアーキテクチャの詳細について説明します。新しいポータルフレームワークの特長には、Webflow のサポートや、ポータルサービス、コンテンツ管理、および Struts のサポートなどがあります。

始める前に

WebLogic Portal 7.0 (Service Pack 2) ドメインから、デフォルト設定のままの WebLogic Portal 8.1 ドメインに、直接移動することはできません。この手順では、互換性ドメインで実行可能なポータル Web アプリケーションが必要です。互換性ドメインの設定の詳細については、「ポータル互換性ドメインの作成」を参照してください。

upgradePortalFiles.cmd ユーティリティを実行し、アップグレードされたポータルおよびポートレットをアプリケーションに配置します。

特定の場所を指定する必要はなく、アップグレードツールが、ポータルのポートレットの参照が適切な場所になるようにポータルとポートレットを調整するので、ツールからの出力を web-app ディレクトリに直接コピーすると簡単です。

ポートレットが参照する JSP が、正しい相対パスに存在することを確認します。

互換性モードからアップグレードするための手順

ポータル互換性ドメインで実行中のアプリケーションを、デフォルト設定の WebLogic Portal 8.1 ドメインで実行できるように変換するには、以下の手順を実行します。

ドメインウィザードを使用して新しいドメインを作成し、[エクスプレス] オプションを選択します。

新しいドメインに、直接新しいアプリケーションディレクトリを作成します。たとえば、beaApps に作成します。

新しいポータルアプリケーションを作成します。

Workshop の [アプリケーション] タブで、アプリケーションを右クリックします。[インポート] を選択し、「8.1 互換性ドメインでの 7.0 アプリケーションのホスト」の手順を使用して再ホストした Web アプリケーションをウィザードを使用してインポートします。ダイアログで [Portal Web プロジェクト] を選択し、Web アプリケーションを参照します。[アプリケーションディレクトリにコピーする] オプションがチェックされていることを確認します。「このプロジェクトタイプで必要なファイルまたはディレクトリがありません。プロジェクトを更新しますか?」というメッセージが表示されます。[はい] を選択します。

WebLogic Workshop を使用して、次のファイルを削除します。

portal_taglib.jar
portlet_taglib.jar
portal_servlet.jar

これらの JAR ファイルには、WebLogic Portal 8.1 ではサポートされない com.bea.portal クラスが含まれています。このようなクラスを引き続き使用しないように、アプリケーションを見直し、必要に応じて書き換えてください。

アプリケーションが Pipeline コンポーネントを使用している場合は、この機能のサポートを追加します。[アプリケーション] タブで、アプリケーションを右クリックします。[インストール｜Pipeline サービス] を選択します。

元のアプリケーションに Webflow があり、互換性ドメインのアップグレード手順を実行した場合は、新しいプロジェクトで Webflow がすでにサポートされているはずです。そうではなく、Webflow のサポートが必要な場合は、プロジェクト (webApp) を右クリックし、[インストール｜Webflow タグライブラリ] を選択して追加します。

アプリケーションに、作成した EJB .jar または .war ファイルが必要な場合は、[アプリケーション] ペインで [モジュール] を右クリックし、[モジュールの追加...] を選択してファイルを参照し、[開く] をクリックします。

注意 : tools700.war または toolSupport.war は必要ありません。この手順を実行すると、アプリケーションに対して WebLogic 8.1 Administration Portal を利用できるようになります。

ポータル互換性ドメインアプリケーションの META-INF/data サブディレクトリから、新しいドメインの META-INF/data ディレクトリにデータファイルをインポートします。data ディレクトリは、コンポーネントごとにインポートする必要があります。

新しい data サブディレクトリをインポートするには、Workshop の [アプリケーション] ペインで data ディレクトリを右クリックし、[インポート] を選択します。次に、ポータル互換性ドメインのディレクトリを参照し、[インポート] をクリックします。
個々のファイルを data の既存のサブディレクトリ (campaigns など) にマージするには、Workshop の [アプリケーション] ペインでサブディレクトリを右クリックし、[インポート] を選択します。次に、ポータル互換性ドメインのディレクトリを参照し、[インポート] をクリックします。このアプリケーションでは、古いポートレットファイルを使用しませんが、参照用にインポートすることもできます。

アップグレードしたポータルおよびポートレットを Web アプリケーションにコピーします。ポータルを <WEB-APP> ディレクトリに、ポートレットを <WEB-APP>/portlets ディレクトリに直接配置します。これらのディレクトリは、作成が必要な場合があります。

これは、アプリケーションの動作上は必要ではありませんが、upgradePortalFiles ツールはこの相対的な場所に存在すると想定しています。このため、異なる構造にする場合は、ポータルの netuix:portletInstance タグの contentUri 属性を変更する必要があります。アップグレードしたポートレットファイルの JSP の参照を確認し、指定されたパスが JSP の実際の場所と一致していない場合は修正します。ファイルシステムが同期化され、アップグレードしたポータルおよびポートレットが [アプリケーション] ペインの Web アプリケーションに表示されます。

WebLogic Workshop でアップグレードしたポータルを開き、アップグレードツールがポータルに適していない単純な単一カラムレイアウトを選択するので、必要に応じてレイアウトを修正します。

サーバを起動します。サーバによって「EJB not deploying」という語句を含むエラーメッセージが生成されます。これは、主に新しい接続プールとデータソースが元のアプリケーションのものと一致しないために発生します。これは、次の手順で修正します。

互換性ドメインの config.xml ファイルを基に、アプリケーションに必要な新しい接続プールとデータソースを作成します。サーバを実行している状態で WebLogic Console に移動し、以前のバージョンのアプリケーションにある config.xml と一致するように接続プールとデータソースを作成します。

WebLogic Console を使用してアプリケーションをデプロイします。

アプリケーションで必要となるサーバのクラスパスを追加します。

エラーが生成された場合は、com.bea.portal クラスへの参照を検索してください。新しいクラスへの参照に置き換える必要があります。

(省略可能) 次の手順では、Webflow をページフローと置き換え、ポータルアップグレードツールが生成した WebflowServlets を標準の WebLogic 8.1 ポータルと置き換えます。Webflow のサポートは、WebLogic 8.1 のアプリケーションに簡単に追加できるので、この手順は必須ではありません。

カタログ管理の追加

ポータルアプリケーションには、WebLogic Portal カタログ管理機能を追加できます。以下に説明する手順を実行すると、カタログのカテゴリとコンテンツ項目を作成し、管理できます。WebLogic Workshop Portal Extensions でカタログプロパティのセットを作成および管理し、以下の手順で追加するオンラインカタログ管理ツールでこれらを管理することもできます。

tools700.war を J2EE アプリケーションのルートフォルダにコピーします。

<WebLogic Platform 8.1>¥portal¥lib ディレクトリから tools700.war ファイルを、アプリケーションのエンタープライズディレクトリにコピーします。たとえば、サンプルのポータルアプリケーションにこの機能を追加するには、このファイルを samples¥portal¥portalApp にコピーします。次回このアプリケーションを WebLogic Workshop で開くと、カタログ管理ツールが自動的にデプロイされます。

注意 : 場所および Web アプリケーション名は、WebLogic Portal バージョン 8.1 で変更されています。

コマースサービスがアプリケーションにインストールされていない場合は、アプリケーションディレクトリを右クリックし、[インストール｜コマースサービス] を選択します。

図 3-3 コマースサービスの追加

次の手順で、コマース管理ツールをサポートする Webflow ファイルを新しいアプリケーションにコピーします。

WebLogic 8.1 のインストールディレクトリの ¥samples¥portal¥portalApp¥META-INF¥data ディレクトリに、webapps というディレクトリを作成し、そのディレクトリに tools700 というディレクトリを作成します。

WebLogic Portal 7.0 (Service Pack 2) ドメインの ¥beaApps¥sampleportal-project¥application-sync¥webapps¥tools¥ ディレクトリから、新しく作成した /webapps/tool700 ディレクトリに tools Webflow ファイルをコピーします。

このディレクトリの名前を tools700.war ファイルのコンテキストルートに変更します。デフォルトは tools700 です。

このツールを使用するには、Web ブラウザを開き、http://<hostname>:<port>/tools700 に移動し、[カタログ管理] をクリックします。

グループポータル

グループポータル定義はアップグレードできません。WebLogic Portal 8.1 の対応するメカニズムはデスクトップで、これにより一連のポータルコンポーネントが指定された対象者に提供されます。

Struts のサポート

この節では、リリース 8.1 の Struts のページフローを準備するために、WebLogic Portal 7.0 で Struts アプリケーションを開発するための一般的な情報を提供します。また、WebLogic Portal 8.1 で実行する Struts ベースのアプリケーションのアップグレードについても一般的なガイドラインを示します。

WebLogic Portal 7.0 での Struts アプリケーション

WebLogic Portal 8.1 では Struts 1.1 がサポートされます。Struts ベースのアプリケーションを開発する場合は、次のガイドラインに従います。

Struts アプリケーションは、ポートレットレベルに制限されています。Struts は、ページフレームワークとして使用しないでください。また、ポータルフレームワークでは使用しないでください。
Struts モジュール (サブアプリケーション) を使用し、モジュールのすべてのページを 1 つのディレクトリに保存します。モジュール間ではページを共有しません。
要求によってスコープを指定したアクションフォームを使用し、タイルなどの Struts プラグインの使用は避けます。

WebLogic Portal 8.1 での Struts のサポート

Struts ベースのアプリケーションコンフィグレーションファイルは、WebLogic Workshop の「ソースビュー」で編集できます。Struts に慣れている場合は、struts-config XML ファイルを編集し、更新したファイルを Java ページフローにマージできます。これらの更新したファイルは、Java ページフロー (.jpf) ファイルから生成された struts-config XML ファイルにマージされます。また、既存の Struts リソースをページフローファイルにマージすることもできます。

注意 : WebLogic Portal で Struts アプリケーションを実行する場合は、URL 書き換えのために JSP タグを変更する必要があります。

Struts アプリケーションを WebLogic Portal 8.1 のページフローにアップグレードする

ページフローアプリケーションは、Struts 1.1 でビルドされています。WebLogic Workshop には、ビジュアルな設計ツールがいくつかあり、ページフローの開発では双方向の編集が可能です。また、単一ファイルのモデルでも開発できます。

注意 : Struts アプリケーションからページフローに JSP ページをアップグレードするときは、ページフロー機能を利用するために JSP タグを変更する必要があります。

JSP タグの置換

「7.0 から 8.1 へのポータルのアップグレードに関するフレームワークのリファレンス」では、WebLogic Portal 8.1 で推奨していない JSP タグを示しています。可能であれば、代わりのタグを使うか、その他のリファクタリングを行ってください。

7.0 から 8.1 へのデータベースとメタデータファイルのアップグレード

この節では、WebLogic Portal のデータベースおよびメタデータファイルのアップグレード手順に関する一般的な情報について説明します。この節では、次のトピックについて説明します。

表 3-1 に、各手順を実行する状況を示します。

表 3-1

アップグレード方法	実行手順
PointBase を使用して、WebLogic Portal 8.1 ドメインに移動	1 から 4
PointBase を使用しないで、WebLogic Portal 8.1 ドメインに移動	2 から 4
PointBase を使用して、WebLogic Portal 7.0 アプリケーションをポータル互換性ドメインに移動	1、2、3 および 5
PointBase を使用しないで、WebLogic Portal 7.0 アプリケーションをポータル互換性ドメインに移動	2、3 および 5

アップグレードシナリオ

既存の PointBase データベースを WebLogic 8.1 に含まれている PointBase バージョンで使用するには、下記の手順 1 を実行します。Portal 7.0 を Portal 8.1 にアップグレードするには、手順 2 から 4 を実行します。互換性モードでの実行を予定している場合は、最後に手順 5 を実行します。

注意 : これらの手順では、WebLogic Server を起動し、実行する必要はありません。このため、データベースへの接続に XA JDBC ドライバを使用しません。

手順 1 : PointBase トリガのアップグレード

WebLogic 8.1 には、最新リリースの PointBase (4.4) が含まれています。PointBase 4.3 では、データベーストリガの実装が書き換えられています。このため、バージョン 8.1 の WebLogic ドメインで使用するには、PointBase データベースをアップグレードするために以下の手順を実行する必要があります。

WebLogic Server を停止します。

7.0 PointBase データベースファイルのバックアップコピーを作成します。これには、..¥<7.0 domain name>¥pointbase ディレクトリにある 2 つのデータファイル (*$1.wal および *.dbn) をコピーするだけです。該当するすべてのドメインに対して、バックアップコピーまたはデータファイルを作成します。

対象の 7.0 ドメインディレクトリに移動し、次のディレクトリの startPBConsole db_settings.properties ファイルを実行して、PointBase Console を起動します。

..¥bea70¥weblogic70¥portal¥bin¥win32¥

PointBase Console で次のファイルを開き、[SQL｜Execute All] を選択して、SQL を実行します。

..¥bea81¥weblogic81¥portal¥upgrade¥drop_70_triggers.sql

PointBase Console を停止します。

..¥<7.0 domain name>¥pointbase ディレクトリの 7.0 PointBase データファイルを次の 8.1 アップグレードディレクトリにコピーします。

..¥bea81¥weblogic81¥portal¥upgrade¥pointbase

..¥bea81¥weblogic81¥portal¥upgrade ディレクトリに移動し、PointBase サーバおよび PointBase Console を起動します。

..¥bea81¥weblogic81¥common¥bin¥startPointBase.cmd -ini=pointbase¥pointbase.ini
..¥bea81¥weblogic81¥common¥bin¥startPointBaseConsole

PointBase Console で次のファイルを開き、[SQL｜Execute All] を選択して、SQL を実行します。

..¥bea81¥weblogic81¥portal¥upgrade¥create_70_triggers.sql

PointBase Console と PointBase サーバを停止します。

手順 2 : WebLogic Portal 7.0 スキーマのアップグレード

以下の手順で、7.0 のデータベーススキーマを 8.1 に対応させます。

7.0 データベースをバックアップします。

..¥weblogic81¥portal¥upgrade ディレクトリに移動します。

7.0 のデータベース設定を使用して、db_settings.properties を更新します。

スクリプト upgrade_db_schema_to_81 を実行します。

ログファイル (upgrade_db_schema_to_81.log) を確認し、アップグレードが正常に行われたことを確認します。

Sybase データベースの場合は、7.0 から 8.1 へのアップグレードスクリプトを実行します。

WebLogic Portal 7.0 アップグレードスクリプトは、bea¥weblogic700¥portal¥db¥sybase¥125¥migrate¥migrate_to_125.sql にあります。

PointBase の場合は、..¥weblogic81¥portal¥upgrade¥pointbase¥*$1.wal および *.dbn ファイルを 8.1 ドメインにコピーします。8.1 ドメインが wlpCompatability という名前でない場合は、ドメインで使用する PointBase データベース名と一致するように、*$1.wal および *.dbn ファイルの名前を変更する必要があります。

これで、データベースが WebLogic Portal 8.1 にアップグレードされました。

注意 : PointBase の場合は、2 つのエラー (下記の例) が発生します。この 2 つのエラーは、ユーザ WEBLOGIC を再作成しようとしたときに生成されたものなので、無視することができます。

SQL> Error Message: User WEBLOGIC already exists in the database.

手順 3 : Application-Sync ファイルのアップグレード

Xerces にアップグレードすると、いくつかのファイルで xsi:schemaLocation をアップグレードする必要があります。通常、これらのファイルは次のようなディレクトリにあります。

..¥bea70¥weblogic700¥user-projects¥portalDomain¥beaApps¥portalApp-project¥application-sync

7.0 application-sync ディレクトリ、およびそのサブディレクトリとファイルを、8.1 ドメインの場所にコピーします。application-sync は、..¥META-INF¥data と対応する階層に存在する必要があります。

例 :
..¥bea81¥user_projects¥applications¥portalApp¥META-INF¥application-sync
..¥bea81¥user_projects¥applications¥portalApp¥META-INF¥data
..¥bea81¥weblogic81¥portal¥upgrade ディレクトリから、コマンドラインで次のコマンドを入力して、スクリプトを実行します。
UpgradeApplicationSyncFiles c:¥bea81¥user_projects¥applications¥testApp¥META-INF¥

アップグレードスクリプトを実行するときは、META-INF ディレクトリの絶対パスを指定する必要があります。ファイルは、..¥META-INF¥application-sync ディレクトリ (およびそのサブディレクトリ) から読み込まれ、次に xsi:schemaLocation パラメータへの変更に従って、..¥META-INF¥data ディレクトリに書き込まれます。..¥META-INF¥data がすでに存在する場合は、間違ってファイルを上書きしないように、ディレクトリ名を変更するように求められます。なお、ソースファイルが変更されたり、..¥META-INF¥application-sync ディレクトリから移動されることはありません。

次のアップグレードスクリプトを実行します。

UpgradeApplicationSyncFiles c:¥bea81¥user_projects¥applications¥testApp¥META-INF¥

対応するログファイル (upgradeApplicationSyncFiles.log) を確認し、アップグレードが正常に行われたことを確認します。同じ情報が、コンソールにも表示されます。

手順 4 : ポータルファイルとポートレットファイルのアップグレード

次のディレクトリにあるスクリプトを使用して、.portal ファイルおよび .portlet ファイルをアップグレードします。

..¥weblogic81¥portal¥upgrade

アップグレードディレクトリ (..¥weblogic81¥portal¥upgrade) から、コマンドラインで次のコマンドを入力して、スクリプトを実行します。

upgradePortalFiles -i<ソースディレクトリまたはソースファイル> -o<出力ディレクトリ>

たとえば、コードリスト 3-1 は、sampleportal-project ディレクトリが C:¥old というディレクトリにコピーされ、変換されたポータルファイルおよびポートレットファイル用に C:¥new というディレクトリが作成された場合の出力を示しています。

注意 : upgradePortalFiles スクリプトは、すべてのサブフォルダを順番に参照し .portal および .portlet ファイルを探します。ソースファイルは変更されません。

コードリスト 3-1 upgradePortalFiles スクリプトの実行

C:¥weblogic81¥portal¥upgrade>upgradePortalFiles -iC:¥old -oC:¥new

C:¥weblogic81¥portal¥upgrade>REM echo off

C:¥weblogic81¥portal¥upgrade>C:/jdk141_03/bin/java -cp

C:/weblogic81/portal/lib/netuix/ejb/netuix_util.jar;C:/weblogic81/portal/lib/netuix/ejb/netuix.jar;C:/weblogic81/portal/lib/netuix/system/netuix_system.jar;C:/weblogic81/p13n/lib/p13n_system.jar;C:/weblogic81/server/lib/weblogic.jar com.bea.netuix.migration.PortalMigration -iC:¥old -oC:¥new

Processing file Bookmarks.portlet

Transformed version of Bookmarks.portlet was valid.

Saving file...

Processing file CompanyProfiles.portlet

Transformed version of CompanyProfiles.portlet was valid.

Saving file...

Processing file CustomerService.portlet

Transformed version of CustomerService.portlet was valid.

Saving file...

Processing file Dictionary.portlet

Transformed version of Dictionary.portlet was valid.

Saving file...

Processing file Email.portlet

Transformed version of Email.portlet was valid.

Saving file...

Processing file GroupToDo.portlet

Transformed version of GroupToDo.portlet was valid.

Saving file...

Processing file MyNewsletters.portlet

Transformed version of MyNewsletters.portlet was valid.

Saving file...

Processing file MyToDo.portlet

Transformed version of MyToDo.portlet was valid.

Saving file...

Processing file Newsletters.portlet

Transformed version of Newsletters.portlet was valid.

Saving file...

Processing file Portfolio.portlet

Transformed version of Portfolio.portlet was valid.

Saving file...

Processing file PrimaryCampaign.portlet

Transformed version of PrimaryCampaign.portlet was valid.

Saving file...

Processing file QuickLinks.portlet

Transformed version of QuickLinks.portlet was valid.

Saving file...

Processing file Quote.portlet

Transformed version of Quote.portlet was valid.

Saving file...

Processing file ReviewNewsletters.portlet

Transformed version of ReviewNewsletters.portlet was valid.

Saving file...

Processing file SecondaryCampaign.portlet

Transformed version of SecondaryCampaign.portlet was valid.

Saving file...

Processing file WebSearch.portlet

Transformed version of WebSearch.portlet was valid.

Saving file...

Processing file WhatsHot.portlet

Transformed version of WhatsHot.portlet was valid.

Saving file...

Processing file WorldNews.portlet

Transformed version of WorldNews.portlet was valid.

Saving file...

Processing file sampleportal.portal

Transformed version of sampleportal.portal was valid.

Saving file...

PortalMigration completed successfully.

C:¥weblogic81¥portal¥upgrade>

入力引数 (-i) には、そのディレクトリ、またはそのサブディレクトリにポータルやポートレットがあるディレクトリを指定します。7.0 EBCC プロジェクトディレクトリを指定することが予期されていますが、必須ではありません。入力引数にディレクトリが指定されていると、ツールはそのディレクトリおよびすべてのサブディレクトリを走査して、拡張子が .portal または .portlet のファイルを探します。検索された各ファイルは、7.0 スキーマに対して検証されています。検証が正常に終了すると、適切な XSLT が適用されます。変換が成功した場合は、新しいドキュメントが 8.1 スキーマに対して検証されます。ファイルは、下記に示す出力ディレクトリに書き込まれます。入力引数には、特定の .portal または .portlet ファイルを指定することもできます。この場合は、指定されたファイルのみが上記のように処理され、下記のように出力されます。

出力引数 (-o) には、ディレクトリを指定します。このディレクトリの下に「portal」という名前のディレクトリが作成され、入力ディレクトリで見つかったすべてのポータルは、バージョン 8.1 の検証を正常終了すると、変換後にここに書き込まれます。portal ディレクトリの下に、「portlets」という名前のディレクトリが作成され、入力ディレクトリで見つかったすべてのポートレットは、変換された後に検証され、ここに書き込まれます。変換されても、8.1 検証に失敗したポータルまたはポートレットは、ファイルタイプに応じて、出力 portal ディレクトリまたは出力 portlet ディレクトリの下にある「failed-verification」という名前のディレクトリに書き込まれます。ソースファイルは変更されたり、移動されることはありません。

ファイルのアップグレードが完了すると、出力ディレクトリは次のようになります。

<出力ディレクトリ>

|
|-- portal (ここに、有効な 8.1 ポータルファイルが保存されます)

|
|-- failed-verification (8.1 検証に失敗したポータル)
|
|-- portlets (ここに、有効な 8.1 ポートレットファイルが保存されます)

______________|
______________|-- failed-verification (8.1 検証に失敗したポートレット)

手順 5 : ENTITLEMENT_RULESET レコードのアップグレード

このアップグレード手順は、互換性モードでの実行を計画している場合のみ必要です。

application-sync ディレクトリ内のファイルに対するアップグレードのときと同じように、データベースに存在するレコードにも、新しい xsi:schemaLocation を正しく反映するために更新が必要です。具体的には、これらのレコードは、ENTITLEMENT_RULESET テーブルにあります。

以下の手順でデータベース内の ENTITLEMENT_RULESET レコードをアップグレードします。

7.0 データベースをバックアップします。

PointBase の場合のみ : ..¥bea81¥weblogic81¥portal¥upgrade ディレクトリに移動し、PointBase サーバおよび PointBase Console を起動します。

..¥bea81¥weblogic81¥common¥bin¥startPointBase.cmd 
-ini=pointbase¥pointbase.ini

PointBase サーバを起動するには、次のようにパラメータを渡すことが必要になる場合があります。 -port=9095

..¥bea81¥weblogic81¥portal¥upgrade に移動します。

7.0 のデータベース設定を使用して、upgrade.properties を更新します。

スクリプト upgradeEntitlementRulesets を実行します。

upgradeEntitlementRulesets.log ファイルを確認し、アップグレードが正常に行われたことを確認します。同じ情報が、コンソールにも表示されます。

PointBase の場合 : PointBase サーバを停止します。

手順 6 : 既存の行動追跡データのアップグレード

アップグレードされたアプリケーションに既存の行動追跡データを保存して、再利用するには、以下の手順を実行します。

既存の行動追跡データをアーカイブします。

新しいリリースのデータベースに、新しいスキーマを作成します。

新しいスキーマを指すように、行動追跡の接続プール設定を変更します。