移行に関するその他のトピック

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > WebLogic Integration > WebLogic Integration 移行ガイド > 移行に関するその他のトピック

WebLogic Integration 移行ガイド

移行に関するその他のトピック

この章の内容は以下のとおりです。

クラスタ化

クラスタ化は、BPM (Business Process Management) によってサポートされており、アプリケーション統合機能は、WebLogic Integration 2.1、2.1 SP1、および 7.0 で提供されています。7.0 クラスタアプリケーションのコンフィグレーション要件は、2.1 または 2.1 SP1 クラスタアプリケーションの要件とは異なっており、その結果 2.1 および 7.0 リリースの config.xml ファイルのクラスタ化セクションが異なります。また、WebLogic Integration 7.0 は WebLogic Integration によって提供された B2B 機能のクラスタ化をサポートしています。

WebLogic Integration クラスタアプリケーションをリリース 2.1 または 2.1 SP1 からリリース 7.0 に移行する場合、まずクラスタ化が使用可能な状態で新しい WebLogic Integration ドメインを作成し、次に手順 7． WebLogic Integration アプリケーションのコンポーネントの移行に記載する（JMS キューなどの）アプリケーション固有のエンティティを移行する必要があります。クラスタ化を使用可能にした状態で WebLogic Integration ドメインを作成する方法についての詳細は『WebLogic Integration ソリューションのデプロイメント』の「クラスタデプロイメントのコンフィグレーション」を参照してください。

クラスタ化に関連するコンフィグレーション要件は、次の BPM リソースではリリース 7.0 で変更されました。

JMS 接続ファクトリ
JMS サーバ
WebLogic Integration 7.0 の分散送り先である JMS 送り先BPM クラスタコンフィグレーションでは次の分散送り先が必要です。

クラスタ化に関連するコンフィグレーション要件は、次のアプリケーション統合リソースではリリース 7.0 で変更されました。

JMS 接続ファクトリ
JMS サーバ
WebLogic Integration 7.0 の分散送り先である JMS 送り先アプリケーション統合クラスタコンフィグレーションでは次の分散送り先が必要です。

詳細については『WebLogic Integration ソリューションのデプロイメント』の「WebLogic Integration クラスタについて」にある「JMS リソース」を参照してください。

Application Integration アダプタ EAR ファイルのコンフィグレーション

この節では、サンプル WebLogic Integration 7.0 アプリケーションで使用する Application Integration アダプタの EAR ファイルのコンフィグレーション手順を説明します。このサンプルは次にシナリオに基づきます。

Acme という WebLogic Integration 2.1 の顧客が WebLogic Integration アプリケーションを WebLogic Integration 7.0 に移行するとします。Acme アプリケーションには、ACME_DBMS というリレーショナルデータベースアダプタを使用する EastCoast.Sales.CustomerManagement というアプリケーションビューが 1 つ含まれています。ACME_DBMS アダプタは Acme の IT 開発者によって開発されました。

Acme アプリケーションの Application Integration アダプタ EAR ファイルのコンフィグレーションを行うには、次いずれかを実行します。

新しいドメインのコンフィグレーションファイルを編集する
WebLogic Server Deployer を呼び出す
クラスタ環境でアダプタ EAR ファイルをデプロイする場合、『WebLogic Integration ソリューションのデプロイメント』の「WebLogic Integration クラスタについて」にある「アダプタのデプロイメント」の手順に従います。

新しいドメインのコンフィグレーションファイルを編集する

（手順 5. 新しいドメインの作成およびデータベース情報のコンフィグレーションで作成した）新しいドメインの config.xml ファイルを開き、アダプタのコンフィグレーション情報を追加します。手順は、次のとおりです。

テキストエディタでアダプタ EAR ファイルをデプロイした WebLogic Integration 2.1 アプリケーション config.xml ファイルを開きます。
次の Aｃme の例のリストに示すとおり、（Application 要素の一部として）アダプタ EAR ファイルをデプロイするファイルのセクションをコピーします。

コードリスト 3-1 アダプタ EAR ファイルの WebLogic Integration 2.1 のデプロイ

<Application Deployed="true" Name="ACME_DBMS" Path="d:\ACME_DBMS.ear">
	<ConnectorComponent Name="ACME_DBMS"
		Targets="myserver"
		URI="ACME_DBMS.rar"/>
	<WebAppComponent Name="DbmsEventRouter"
		Targets="myserver"
		URI="DbmsEventRouter.war"/>
	<WebAppComponent Name="ACME_DBMS_Web"
		Targets="myserver"
		URI="ACME_DBMS_Web.war"/>
</Application>

（手順 5. 新しいドメインの作成およびデータベース情報のコンフィグレーションで作成した）新しい WebLogic Integration 7.0 ドメインの config.xml ファイルを開き、Application 要素を貼り付けます。
次の図に太字で表示されているとおり、Application 要素に TwoPhase 属性を追加します。この要素の値を"true" に設定します。

コードリスト 3-2 Application 要素への TwoPhase 属性の追加

<Application Deployed="true" Name="ACME_DBMS" TwoPhase="true" Path="d:\ACME_DBMS.ear">

EAR ファイルの場所が変更された場合、次の図の太字で表示されたとおり、アダプタの Application 要素の Path 属性を更新します。

コードリスト 3-3 EAR ファイルのパスの更新

<Application Deployed="true" Name="ACME_DBMS" TwoPhase="true" Path="c:¥adk¥ACME_DBMS.ear">

警告: アダプタ EAR ファイルが WebLogic Integration 2.1 または WebLogic Integration 2.1 SP1 インストールのホームディレクトリにある場合（たとえば、Windows システムの %WLI_HOME%¥lib）、c:¥adk などの WebLogic Integration 2.1 インストール外の場所に移動することをお勧めします。

アダプタの Application 要素の Targets 要素の設定を（手順 5. 新しいドメインの作成およびデータベース情報のコンフィグレーションで作成した）新しいドメインのサーバ名と一致するよう更新します。たとえば、ドメインが WLI ドメインテンプレートから作成された場合、サーバ名は次のリストの例で太字表示されているとおり、myserver に設定されます。

コードリスト 3-4 Config.xml ファイルからのサーバ名の取得

<Domain Name="mydomain">
	<!-- Domain log -->
	<Log FileName="c:/bea/user_projects/mydomain/logs/mydomain.log" Name="mydomain"/>
	<Server ListenPort="7001"
		Name="myserver"
		TransactionLogFilePrefix="c:/bea/user_projects/mydomain/logs/" 
		NativeIOEnabled="true">
.
.
.
</Domain>

次のリストに太字で表示されているように、アダプタの Application 要素の Targets 属性の設定を更新します。

コードリスト 3-5 Targets 属性の更新

<Application Deployed="true" TwoPhase="true" Name="ACME_DBMS" Path="c:\adk\ACME_DBMS.ear">
	<ConnectorComponent Name="ACME_DBMS"
		Targets="myserver"
		URI="ACME_DBMS.rar"/>
	<WebAppComponent Name="DbmsEventRouter"
		Targets="myserver"
		URI="DbmsEventRouter.war"/>
	<WebAppComponent Name="ACME_DBMS_Web"
		Targets="myserver"
		URI="ACME_DBMS_Web.war"/>
</Application>

WebLogic Server Deployer を呼び出す

WebLogic Server Deployer コマンドラインユーティリティを使用してアダプタ EAR をデプロイします。たとえば、Windows システムの ACME_DBMS.ear ファイルをデプロイするには、次のコマンドを使用します。

java -classpath %BEA_HOME%¥weblogic700¥lib¥weblogic.jar
weblogic.Deployer -adminurl
http://wls_admin_host:wls_admin_port -user wls_admin_user
-password wls_admin_pass -verbose -stage -activate -source
c:¥adk¥ACME_DBMS.ear -name ACME_DBMS -targets server_name

表3-1 Deployer の例で使用される代替可能な文字列

文字列	説明
BEA_HOME	Windows システムの c:¥bea などの、BEA 製品ソフトウェアがインストールされるディレクトリ。
wls_admin_host	使用されている WebLogic Server インスタンスのホスト名または IP アドレス。
wls_admin_port	使用される WebLogic Server インスタンスのポート番号。
wls_admin_user	WebLogic Server Adminstration Console にログインするために使用するユーザ名（この名前は手順 5. 新しいドメインの作成およびデータベース情報のコンフィグレーションでドメインを作成するためにコンフィグレーションウィザードを使用したときに指定したユーザ名）。
wls_admin_pass	WebLogic Server Adminstration Console にログインするためのパスワード（手順 5. 新しいドメインの作成およびデータベース情報のコンフィグレーションでドメインを作成するためにコンフィグレーションウィザードを使用したときに指定したパスワード）。
server_name	手順 5. 新しいドメインの作成およびデータベース情報のコンフィグレーションで作成したドメインのサーバ名。

Deployer ユーティリティの詳細については、『WebLogic Server アプリケーションの開発』の「WebLogic Server デプロイメント」にある「デプロイメントツールおよび手順」を参照してください。このマニュアルは、BEA WebLogic Server マニュアルセットの次の URL にあります。

http://edocs.beasys.co.jp/e-docs/wls/docs70/programming/deploying.html

警告: DBMS Sample Adapter は WebLogic Integration のリリース 7.0 で変更されました。これにより、このアダプタのアプリケーションビューに影響する場合があります。詳細については『アダプタの開発』の「WebLogic Integration 7.0 へのアダプタの移行」にある「要求データを必要としないサービスに対する DBMS サンプルアダプタの変更」を参照してください。

Application Integration アダプタの移行の詳細については、『アダプタの開発』の「WebLogic Integration 7.0 へのアダプタの移行」を参照してください。

トラステッドリレーションシップ

WebLogic Server トラステッドリレーションシップのセキュリティモデルは、WebLogic Server のリリース 7.0 で変更されました。（クライアントとして機能している） WebLogic 7.0 サーバは、別のドメインの別の WebLogic 7.0 サーバを認証します。いずれのドメインも SecurityConfigurationMBean に同じ Credential 属性を持つ必要があります。異なる場合、次の例外が送出されます。java.lang.SecurityException Invalid Subject.

次のいずれかの方法でドメインの Credential 属性を変更できます。

WebLogic Server Administration Console を使用して資格を変更します。詳細については、『BEA WebLogic Server 管理者ガイド』を参照してください。このマニュアルは、BEA WebLogic Server マニュアルセットの次の URL にあります。
```
http://edocs.beasys.co.jp/e-docs/wls/docs70/admin.html
```
テキストエディタで config.xml ファイルを開き、次の要素の資格を変更します。
```
<SecurityConfiguration Credential=”foobar” Name=”mydomain”/>
```
注意: クリアテキスト資格は、最初に config.xml ファイルが生成されたときに暗号化されます。

新しい SerializedSystemIni.dat ファイルの生成

WebLogic Integration 7.0 サーバを開始したときに次のような例外が発生した場合、SerializedSystemIni.dat ファイルを再生成する必要があります。

weblogic.security.internal.FileUtilsException: Couldn't 
rename DOMAIN_HOME¥SerializedSystemIni.dat to
DOMAIN_HOME¥SerializedSystemIni.dat42698.old

これらのメッセージでは DOMAIN_HOME は手順 5. 新しいドメインの作成およびデータベース情報のコンフィグレーションで作成した新しいドメインのパス名を表します。

ドメインに新しい SerializedSystemIni.dat ファイルを生成するには、次の手順を実行します。

ドメインの存在するディレクトリに移動します。
```
cd DOMAIN_HOME
```
DOMAIN_HOME は手順 5. 新しいドメインの作成およびデータベース情報のコンフィグレーションで作成した新しいドメインのパス名を表します。
config.xml ファイルを開き、Credential 属性から暗号化されたセクションを削除します。たとえばリスト3-6に表示されているコンフィグレーションセクションを削除し、リスト3-7に表示されているコンフィグレーションセクションに置き換えます。

コードリスト 3-6 暗号化された Credential 要素

<EmbeddedLDAP
	Credential="{3DES}CUnX5jDsmxluwzO45cb+kErCo+3pa92oXcPZl8L23pwx" Name="mydomain"/>
	<SecurityConfiguration Credential="{3DES}aKaA3CEY4TIx" Name="mydomain"/>

コードリスト 3-7 Credential 要素から削除された暗号化箇所

<EmbeddedLDAP
	Credential="" Name="mydomain"/>
	<SecurityConfiguration Credential="" Name="mydomain"/>

fileRealm.properties ファイルのコピーを作成し、プラットフォームに合わせて適切なコマンドを実行してコピー fileRealm.properties.src を呼び出します。

Windows:

copy fileRealm.properties fileRealm.properties.src

UNIX:

cp fileRealm.properties fileRealm.properties.src

プラットフォームに合わせて適切なコマンドを実行して boot.properties ファイルを削除します。

Windows:
```
delete boot.properties
```
UNIX:
```
rm boot.properties
```

プラットフォームに合わせて適切なコマンドを実行して SerializedSystemIni.dat ファイルの名前を変更します。

Windows:

rename SerializedSystemIni.dat SerializedSystemIni.dat.old

UNIX:

mv SerializedSystemIni.dat SerializedSystemIni.dat.old

fileRealm.properties.src ファイルを開き、すべてのハッシュパスワードをクリアテキストパスワードに変更します（パスワードは user.user_name 要素によって設定されます。user_name は次のリストの一部に太字表示されているように、ユーザ ID を表す）。たとえばリスト3-8で暗号化されたパスワードを削除し、リスト3-9に示すように、テキストバージョンに置き換えます。

コードリスト 3-8 暗号化されたパスワードを持つ fileRealm.properties ファイルのリストの一部

group.ConfigureSystem=admin,joe,mary,guest,wlisystem
acl.lookup.weblogic.jndi.weblogic.fileSystem=everyone
acl.enablermonitor.WLCAdmin=admin
user.joe=0xa078cb45e6f6c4eefdd1f14495ff739b5536904c
group.DeleteTemplate=admin,joe,mary,guest,wlisystem
group.AdministerUser=admin,joe,mary,guest,wlisystem
group.Deployers=Administrators

コードリスト 3-9 クリアテキストのパスワードを持つ fileRealm.properties ファイルのリストの一部

group.ConfigureSystem=admin,joe,mary,guest,wlisystem
acl.lookup.weblogic.jndi.weblogic.fileSystem=everyone
acl.enablermonitor.WLCAdmin=admin
user.joe=password
group.DeleteTemplate=admin,joe,mary,guest,wlisystem
group.AdministerUser=admin,joe,mary,guest,wlisystem
group.Deployers=Administrators

プラットフォームに合わせて適切なコマンドを実行して SerializedSystemIni.dat ファイルの名前を変更します。
- Windows:
```
rename SerializedSystemIni.dat SerializedSystemIni.dat.old
```
- UNIX:
```
mv SerializedSystemIni.dat SerializedSystemIni.dat.old
```
FileRealm ユーティリティを使用して SerializedSystemIni.dat ファイルを再生成します。具体的には、次のコマンドを実行します。
```
java weblogic.security.internal.acl.FileRealm
fileRealm.properties SerializedSystemIni.dat
```

RosettaNet スキーマの変更点

WebLogic Integration では RosettaNet メッセージのスキーマ検証が提供されています。WebLogic Integration 2.1 および WebLogic Integration 2.1 SP1 の検証のスキーマは、W3C (World Wide Web Consortium) XSD (2000 XML Schema Definitions) スキーマに基づきます。WebLogic Integration 7.0 の検証のスキーマは、W3C (World Wide Web Consortium) XSD (2001 XML Schema Definitions) スキーマに基づきます。

RosettaNet メッセージは 2 つの部分で構成されています。メッセージヘッダ XML ドキュメント（サービス‐ヘッダ）および XML ビジネスドキュメントまたはペイロードです。メッセージヘッダ XML ドキュメントおよび XML ビジネスドキュメントの両方を検証するために使用する XSD スキーマは、W3C 2001 XSD スキーマを使用するようにコンバートされました。WebLogic Integration メッセージの検証のためのスキーマを開発した場合、2001 XSD スキーマを使用するように更新する必要があります（スキーマは、リスト3-11またはリスト3-12で示すスキーマ要素で始まる必要がある）。WebLogic Integration 7.0は、2001 XSD スキーマの RosettaNet メッセージの検証のみサポートしています。

RosettaNet メッセージの検証スキーマは、WLI_HOME¥lib¥xmlschema¥rosettanet ディレクトリにあります（WLI_HOME は WebLogic Integration ホームディレクトリを表す）。

2000 XSD スキーマは、次のリストのスキーマ要素から始まります。

コードリスト 3-10 2000 XSD スキーマ要素

<schema xmlns="http://www.w3.org/2000/10/XMLSchema">
	<!-- schema content goes here -->
</schema>

2001 XSD スキーマは、リスト3-11またはリスト3-12に示すスキーマ要素に類似したものから始まります。リスト3-12の XSD スキーマ要素は、XSD スキーマの要素を完全に修飾するためにネームスペース xsd を使用します。

コードリスト 3-11 2001 XSD スキーマ要素

<schema xmlns="http://www.w3.org/2001/XMLSchema">
	<!-- schema content goes here -->
</schema>

コードリスト 3-12 xsd ネームスペースの付いた 2001 XSD スキーマ要素

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<!-- schema content goes here -->
</schema>

xml: ネームスペース

WebLogic Integration 7.0 では xml: ネームスペースの使用をサポートしています。xml: ネームスペースは、次の属性名を含む標準 W3C ネームスペースです。

xml:lang －使用される自然言語を識別します。
xml:space －空白が要素にとって重要であるかを指定します。
xml:base － XML 文書の部分のベース URI を定義します。

WebLogic Integration 2.1 または 2.1 SP1 XSD スキーマファイルでは、次のように、xml:lang は文字列にコンバートされます。

<xsd:attribute name=”xml:lang” type=”xsd:string”/>

WebLogic Integration 7.0 XSD スキーマファイルでは、xml:lang の値は xml: ネームスペースによって決定されます。メッセージの検証のために独自のスキーマを開発した場合、次のリストに示すように、xml:lang 属性を変更してください。

<xsd:attribute ref=”xml:lang”/>

デフォルトでは WebLogic Integration 7.0 は、xml: ネームスペース XSD スキーマを次の標準 xml: ネームスペース URL でからではなく、ローカルファイルシステムから取得します。

http://www.w3.org/2001/xml.xsd

ローカルファイルシステムでネームスペースをルックアップすることにより、パフォーマンスが向上し、ネットワークトラフィックが軽減されます。

URL からではなくローカルファイルシステムからスキーマを取得することにより、WebLogic Integration 7.0 ではネットワークトラフィックを軽減してパフォーマンスを向上させることができます。たとえば、次のリストに示すように、0A1_MS_V02_00_FailureNotification.xsd スキーマによって schemaLocation 属性値を schemas/xml.xsd に設定します。この設定により、xml: ネームスペーススキーマは、ローカルファイルシステムから取得されます。

コードリスト 3-13 ローカルスキーマを使用した 0A1_MS_V02_00_FailureNotification.xsd

<?xml version = "1.0" encoding = "UTF-8"?>
<xsd:schema xmlns:xsd = "http://www.w3.org/2001/XMLSchema">
<xsd:import namespace = "http://www.w3.org/XML/1998/namespace"
schemaLocation = "schemas/xml.xsd"/>
.
.
.

リスト3-14では、schemaLocation 属性の値は http://www.w3.org/2001/xml.xsd です。この設定が使用された場合、WebLogic Integration では、URL を使用して xml: ネームスペーススキーマが取得されます。

コードリスト 3-14 URL スキーマを使用した 0A1_MS_V02_00_FailureNotification.xsd

<?xml version = "1.0" encoding = "UTF-8"?>
<xsd:schema xmlns:xsd = "http://www.w3.org/2001/XMLSchema">
<xsd:import namespace = "http://www.w3.org/XML/1998/namespace"
schemaLocation = "http://www.w3.org/2001/xml.xsd"/>
.
.
.

URL から xml: ネームスペースを検証する場合、WLI_HOME¥lib¥xmlschema¥rosettanet ディレクトリの XSD スキーマファイルを標準の xml: ネームスペース URL に schemaLocation 属性の値を設定する XSD スキーマファイルセットに置き換えることができます。手順は、次のとおりです。

プラットフォームに合わせて適切なコマンドを実行して、RosettaNet XSD スキーマディレクトリに移動します。
- Windows:
```
cd WLI_HOME¥lib¥xmlschema¥rosettanet
```
- UNIX:
```
cd WLI_HOME/lib/xmlschema/rosettanet
```
いずれのコマンドラインの場合でも、WLI_HOME は、WebLogic Integration ホームディレクトリを表します。
プラットフォームに合わせて適切なコマンドを実行して、バックアップディレクトリを作成します。
- Windows:
```
md backup
```
- UNIX:
```
mkdir backup
```
プラットフォームに合わせて適切なコマンドを実行して、ローカル xml: ネームスキーマファイルにポイントする XSD スキーマファイルをバックアップディレクトリに移動します。
- Windows:
```
move *.xsd backup
```
- UNIX:
```
mv *.xsd backup
```
標準の xml: ネームスペース URL にポイントする XSD スキーマファイルを抽出します。
```
jar xvf schemas.jar
```

追加の 2001 XSD スキーマの変更点

独自のメッセージ検証のスキーマを開発する場合、スキーマに次の変更を加える必要がある場合があります。

appInfo 要素を documentation 要素に置き換えます。この置き換えは DTD グラマーでの変更に対応するために WebLogic Integration 7.0 スキーマで行われました。
次の例のリストのとおり、content=゛elementOnly゛および content=゛textOnly゛属性を削除します。

コードリスト 3-15 2000 XSD スキーマの例（WebLogic Integration 2.1 または 2.1 SP1）

<xsd:complexType content = "elementOnly">
<xsd:choice>
	<xsd:element ref = "GlobalLocationIdentifier"/>
	<xsd:group ref = "StreetAddress"/>
	<xsd:group ref = "GlobalLocationIdAndStreetAddress"/>
</xsd:choice>

コードリスト 3-16 2001 XSD スキーマの例（WebLogic Integration 7.0）

<xsd:complexType>
<xsd:choice>
	<xsd:element ref = "GlobalLocationIdentifier"/>
	<xsd:group ref = "StreetAddress"/>
	<xsd:group ref = "GlobalLocationIdAndStreetAddress"/>
</xsd:choice>