AquaLogic Data Services Platform アプリケーションのバージョン 2.5 へのアップグレード

BEA AquaLogic Data Services Platform 2.0.n アプリケーションおよびプロジェクトは簡単にアップグレードできます。この章では、以下の移行作業の手順について説明します。

WebLogic Platform のインストールとコンフィグレーション

AquaLogic Data Services Platform をインストールする前に、サポート対象バージョンの WebLogic Platform 8.1 をインストールして正しくコンフィグレーションする必要があります。このリリースでサポートされるバージョンについては、AquaLogic Data Services Platform の『リリースノート』の「サポート対象のコンフィグレーション」を参照してください。

AquaLogic Data Services Platform 2.5 のインストールとデプロイメント

AquaLogic Data Services Platform 2.0x または 2.1 で作成したアプリケーションをアップグレードするには、まず AquaLogic Data Services Platform 2.5 をインストールする必要があります。プロダクション環境では、AquaLogic Data Services Platform で使用する WebLogic Platform 8.1 ドメインごとにこのインストールを実施する必要があります。

AquaLogic Data Services Platform 2.5 のインストール

このドキュメントの他の章 (「インストールの前提条件」以降の節) で説明されている準備、インストール、およびインストール後の手順に従ってください。

AquaLogic Data Services Platform のアップグレードオプション

最新バージョンの AquaLogic Data Services Platform へのアップグレードは、複数のステップに分かれています。

旧バージョンで作成したアプリケーションの 2.5 へのアップグレード

アプリケーションは、WebLogic Workshop を使用してアップグレードするか、AquaLogic Data Services Platform 2.5 変換ユーティリティを使用してアップグレードできます。

旧バージョンの AquaLogic Data Services Platform アプリケーションを Workshop を使用してアップグレードする

AquaLogic Data Services Platform 2.5 をインストールしたら、既存の AquaLogic Data Services Platform アプリケーションの複数の JAR ファイルをアップグレードする必要があります。アップグレードしないと、これらのアプリケーションを AquaLogic Data Services Platform 2.5 でデプロイすることができません。 WebLogic Workshop では、この更新プロセスが半自動化されています。 WebLogic Workshop でアプリケーションを開くと、一部の AquaLogic Data Services Platform JAR ファイルのバージョンが古いことを示すメッセージが表示され、アプリケーションを更新するかどうかを選択できます。

[はい] を選択するとファイルが更新されます。これにより、アプリケーションが自動的にビルドまたは再ビルドされます。

旧バージョンで作成したアプリケーションを変換ユーティリティを使用してアップグレードする

AquaLogic Data Services Platform 2.0 または 2.1 のアプリケーションがすでに EAR ファイルにパッケージ化されている場合は、コマンドラインユーティリティを使用してその EAR を AquaLogic Data Services Platform 2.5 にアップグレードできます。このユーティリティは、旧バージョンの以下の JAR の EAR ファイルを検査します。

ld-server.app.jar
ld-client.jar
LiquidDataControl.jar

これらのファイルが AquaLogic Data Services Platform 2.5 より前のバージョンであることが検知されると、そのファイルが 2.5 バージョンのファイルで置き換えられます。

Windows で EAR ファイルをアップグレードする

Windows ベースの AquaLogic Data Services Platform 2.0 または 2.1 の EAR ファイルを、変換移行ユーティリティを使用して AquaLogic Data Services Platform 2.5 にアップグレードするには、次の手順に従います。

対象となる EAR ファイルをバックアップします。
Windows の [ファイル名を指定して実行] コマンドを使用してコマンドウィンドウを開きます。
システムにまだ WebLogic Server 環境が設定されていない場合は設定します。

<WL_HOME>\server\bin\setWLSEnv.cmd

対象の EAR ファイルに対して変換コマンドラインユーティリティを実行します。次に例を示します。

<WL_HOME>\liquiddata\bin\convert.cmd myEAR.ear

UNIX システムで EAR ファイルをアップグレードする

UNIX ベースの AquaLogic Data Services Platform 2.0 の EAR ファイルを、変換移行ユーティリティを使用して AquaLogic Data Services Platform 2.5 にアップグレードするには、次の手順に従います。

対象となる EAR ファイルをバックアップします。
システムにまだ WebLogic Server 環境が設定されていない場合は設定します。

<WL_HOME>/server/bin/setWLSEnv.sh

対象の EAR ファイルに対して変換コマンドラインユーティリティを実行します。次に例を示します。

<WL_HOME>/liquiddata/bin/convert.sh myEAR.ear

2.0 で作成したプロジェクトの 2.5 へのアップグレード

バージョン 2.1 より前の AquaLogic Data Services Platform では、シーケンスを返す関数を管理するため、元のスキーマファイルの「arrayOf」型 (.xsd スキーマファイル) が追加で生成されていました。たとえば、XML 型の customer (customer.xsd) に対してデータサービスが作成されると、XML 型の arrayOfcustomer (arrayOfCustomer.xsd) が自動的に作成されていました。これにより、シーケンスを返す関数を呼び出すアプリケーションで arrayOf 型を使用できていました。

AquaLogic Data Services Platform 2.1 以降では、レコードのシーケンスを返す関数をこの方法で処理することは非推奨になりました。代わりに、シーケンス内の各項目をサービスデータオブジェクト (SDO) に変換する方法が採用され、 SDO の Java 配列がサポートされることになりました (SDO の詳細、およびシーケンス SDO の処理の詳細については、『クライアントアプリケーション開発者ガイド』を参照してください)。

バージョン 2.1 より前の AquaLogic Data Services Platform で作成した AquaLogic Data Services Platform プロジェクトについては、以下のどちらかを選択できます。

旧バージョンのプロジェクトをそのまま使用する。この場合、関数は従来の arrayOf 手法でシーケンスを返します。
プロジェクトを個別にアップグレードして、改善されたシーケンス処理手法を利用する。プロジェクトをアップグレードするには、[データサービスプロジェクトの移行] メニューオプションを使用します。

[データサービスプロジェクトの移行] オプションを表示するには、対象の AquaLogic Data Services Platform プロジェクトを右クリックします (図 5-3 を参照)。

インストール ガイド