Oracle® Fusion Middleware

Oracle Service Busアップグレード・ガイド

11g リリース1 (11.1.1.7.0)

B61434-05(原本部品番号:E15032-05)

2013年6月

Oracle Fusion Middleware Oracle Service Busアップグレード・ガイド 11g リリース1 (11.1.1.7.0)

B61434-05

Copyright © 2001, 2013, Oracle and/or its affiliates.All rights reserved.

原本著者:  Rekha Kamath

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、Oracleまでご連絡ください。

このソフトウェアおよび関連ドキュメントが米国政府機関、もしくは米国政府機関に代わってこのソフトウェアをライセンスまたは使用する者に提供される場合は、次の注意が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、このソフトウェアまたはハードウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracleおよびその関連会社は一切の責任を負いかねます。

OracleはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 アップグレード・プロセスの概要

- 1.1 はじめに

- 1.2 Oracle Service Busアップグレード・プロセスのフロー・チャート

- 1.3 Oracle Service Busアップグレード・プロセスの手順

2 Oracle Service Bus 11g リリース1 (11.1.1.7.0)へのアップグレード

- 2.1 アップグレードの概要

- 2.2 Oracle Service Busアップグレードの開始点

- 2.3 Oracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードするための前提条件

- 2.3.1 環境のバックアップ

- 2.3.2 Oracle WebLogic Server 10.3.5へのパッチ適用

- 2.3.3 Oracle WebLogic Server 10.3.6へのパッチ適用

- 2.4 タスク1: 既存ドメインからの構成のエクスポート

- 2.5 タスク 2: セキュリティ構成のエクスポート

- 2.6 タスク3: Oracle Service Bus 11g リリース1 (11.1.1.7.0)のインストールおよび構成

- 2.7 タスク4: Oracle WebLogic Serverセキュリティの構成

- 2.8 タスク5: 他のOracle WebLogic Serverオブジェクトの再作成

- 2.9 タスク6: セキュリティ・データおよびポリシーのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート

- 2.10 タスク7: 構成JARファイルのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート

- 2.11 タスク8: 必要とされるOracle Service Busアップグレード後作業の実行

- 2.12 アップグレードの確認

3 アップグレードに関する考慮事項

- 3.1 AquaLogic Service Bus 2.6ユーザー用のアップグレードに関する考慮事項

- 3.1.1 統合開発環境

- 3.1.2 アラート・ルール

- 3.1.3 アラートからアラート宛先への参照の表示

- 3.1.4 アラート宛先に送信される詳細

- 3.1.5 アラート・ルールのインポート/エクスポートの変更

- 3.1.6 プロキシ・サービスのセッション対応アクセス制御の管理

- 3.1.7 トランスポートSDKとトランスポート・プロバイダに関する変更

- 3.1.7.1 ビジネス・サービス構成のメッセージの再試行回数

- 3.1.7.2 ビジネス・サービスの重複URIの削除

- 3.1.7.3 アプリケーション・エラーの再試行

- 3.1.7.4 HTTPSトランスポートの変更

- 3.1.7.5 設計環境でのトランスポート構成

- 3.2 AquaLogic Service Bus 3.0のアップグレードに関する考慮事項

- 3.2.1 Oracle Enterprise Pack for EclipseでのAquaLogic Service Bus 3.0ワークスペースのアップグレード

- 3.2.2 Java Message Serviceビジネス・サービスではJNDI サービス・アカウントが非推奨

- 3.2.3 パイプライン・アクションIDのアップグレード

- 3.2.4 パイプライン・モニタリングのレベル

- 3.2.5 強化された検証

- 3.3 Oracle Service Bus 10gのアップグレードに関する考慮事項

- 3.3.1 アラートのアップグレード

- 3.3.2 JCAエンドポイント構成

- 3.3.3 JMSビジネス・サービスの構成

- 3.3.4 グローバル操作設定

- 3.3.5 UDDI構成

- 3.4 リリース1 (11.1.1.6.0)以降におけるXMLでの復帰改行処理への変更

索引

はじめに

このマニュアルは、Oracle Service Busの11g リリース(11.1.1.7.0)へのアップグレードを担当するOracle Service Busシステム管理者を対象としています。読者が次の事項に関する知識を持っていることを前提としています。

- Oracle Service Bus構成

- Oracle WebLogic管理ドメインのコンセプト

- アップグレードするシステムの構成および予期される動作

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportから電子サポートにアクセスできます。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

関連ドキュメント

詳細は、Oracle Fusion Middleware 11gドキュメント・ライブラリにある次の関連ドキュメントを参照してください。

- Oracle Fusion Middleware Oracle Service Busインストレーション・ガイド

- Oracle Fusion Middleware Oracle Service Busコンセプトおよびアーキテクチャ

- Oracle Fusion Middleware Oracle Service Bus管理者ガイド

- Oracle Fusion Middleware Oracle Service Bus開発者ガイド

- Oracle Fusion Middleware Oracle Service Busデプロイメント・ガイド

- Oracle Fusion Middlewareアップグレード・プランニング・ガイド

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

斜体

イタリックは、ユーザーが特定の値を指定するプレースホルダー変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 アップグレード・プロセスの概要

この章では、Oracle Service Busの10gから11gへのアップグレード・プロセスの概要を示します。

この章では、次の項について説明します。

- はじめに

- Oracle Service Busアップグレード・プロセスのフロー・チャート

- Oracle Service Busアップグレード・プロセスの手順

注意:

Oracle Service Busドメインのインプレース・アップグレードはサポートされていません。

1.1 はじめに

Oracle Service Busのアップグレードを開始する前に、次の事項を確認してください:

- 『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のアップグレード・コンセプトを確認します

- アップグレードの開始点

1.2 Oracle Service Busアップグレード・プロセスのフロー・チャート

図1-1は、Oracle Service Busのアップグレード・プロセスを示しています。このチャートで、既存の環境で実行する必要のある手順を確認してください。

図1-1 Oracle Service Busアップグレード・プロセスのフロー・チャート

1.3 Oracle Service Busアップグレード・プロセスの手順

表1-1で、図1-1に示すアップグレード・プロセス・フロー・チャートの各手順について説明します。各手順の詳細情報の入手先も示します。

表1-1 Oracle Service Bus 11g アップグレード・プロセスの手順

手順

説明

詳細情報

『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のアップグレード・コンセプトを確認します。

『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』では、Oracle Fusion Middleware環境のアップグレード方法の概要を示します。

互換性に関する情報やミドルウェア・コンポーネントをサポートするデータベースのアップグレード手順が説明されています。

Oracle Fusion Middlewareアップグレード・プランニング・ガイド

アップグレードの開始点の理解

アップグレードをプランニングする前に、Oracle Service Busアップグレードでサポートされている開始点について理解しておく必要があります。

2.2項「Oracle Service Busアップグレードの開始点」

必要な前提条件を完了します。

アップグレードを開始する前に、必要な前提条件を満たす必要があります。

2.3項「Oracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードするための前提条件」

Oracle Service Bus構成JARファイルをエクスポートします。

既存のドメインから構成JARファイルをエクスポートします。

2.4項「タスク1: 既存ドメインからの構成のエクスポート」

既存ドメインからのセキュリティ構成をエクスポートします。

既存のドメインからセキュリティ構成をエクスポートします。

2.5項「タスク2: セキュリティ構成のエクスポート」

Oracle Service Bus 11g のインストールおよび構成

Oracle Service Bus 11g リリース1 (11.1.1)のインスタンスをインストールして構成します。

インストールおよび構成の完了後、管理サーバーと管理対象サーバーを起動します。

2.6項「タスク3: Oracle Service Bus 11g リリース1 (11.1.1.7.0)のインストールおよび構成」

Oracle WebLogic Serverセキュリティを構成します。

新しい11g ドメインで、Oracle WebLogicセキュリティ・フレームワークを構成します。

2.7項「タスク4: Oracle WebLogic Serverセキュリティの構成」

Oracle WebLogic Serverオブジェクトを再作成します。

新しいOracle Service Busドメインで、エクスポートできなかったOracle WebLogic Serverオブジェクトを再作成します(接続ファクトリ、キュー、トピックなどのJMSリソース)。

2.8項「タスク5: 他のOracle WebLogic Serverオブジェクトの再作成」

Oracle WebLogic Serverセキュリティの構成とその他のOracle WebLogic Serverオブジェクトを再作成します。

セキュリティ構成をOracle Service Bus 11g ドメインにインポートします。

2.9項「タスク6: セキュリティ・データおよびポリシーのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート」

Oracle Service Bus構成JARファイルをインポートします。

JARファイルをOracle Service Bus 11g R1ドメインにインポートします。

2.10項「タスク7: 構成JARファイルのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート」

アップグレード後に必要な手動作業を実行します。

アップグレード・プロセスでは、一部のアップグレード手順は自動化されています。しかし、多くの場合、手動による作業を追加で行う必要があります。

2.11項「タスク8: 必要とされるOracle Service Busアップグレード後作業の実行」

2 Oracle Service Bus 11g リリース1 (11.1.1.7.0)へのアップグレード

この章では、AquaLogic Service Bus (2.6および3.0)およびOracle Service Bus (10.3.1.0)をOracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードする方法を説明します。

この章では、次の項について説明します。

- アップグレードの概要

- Oracle Service Busアップグレードの開始点

- Oracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードするための前提条件

- タスク1: 既存ドメインからの構成のエクスポート

- タスク2: セキュリティ構成のエクスポート

- タスク3: Oracle Service Bus 11g リリース1 (11.1.1.7.0)のインストールおよび構成

- タスク4: Oracle WebLogic Serverセキュリティの構成

- タスク5: 他のOracle WebLogic Serverオブジェクトの再作成

- タスク6: セキュリティ・データおよびポリシーのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート

- タスク7: 構成JARファイルのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート

- タスク8: 必要とされるOracle Service Busアップグレード後作業の実行

- アップグレードの確認

注意:

アップグレードを進める前に、次の事項を確認してください:

- 『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のアップグレード・コンセプト

- 2.2項「Oracle Service Busアップグレードの開始点」

2.1 アップグレードの概要

AquaLogic Service Bus 2.6、2.6 RP1、3.0、Oracle Service Bus 10g リリース3 (10.3)および10g リリース3メンテナンス・パック1 (10.3.1)ドメインからOracle Service Bus 11g リリース1 (11.1.1.7.0)ドメインへの直接自動インプレース・アップグレードはサポートされていません。アップグレード・プロセスには、次の手順が含まれます。

- タスク1: 既存ドメインからの構成のエクスポート

- タスク2: セキュリティ構成のエクスポート

- タスク3: Oracle Service Bus 11g リリース1 (11.1.1.7.0)のインストールおよび構成

- タスク4: Oracle WebLogic Serverセキュリティの構成

- タスク5: 他のOracle WebLogic Serverオブジェクトの再作成

- タスク6: セキュリティ・データおよびポリシーのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート

- タスク7: 構成JARファイルのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート

- タスク8: 必要とされるOracle Service Busアップグレード後作業の実行

新しいOracle Service Busドメインへのアップグレードでは、クラスタリングされたドメインおよび非クラスタリングされたドメインの両方がサポートされています。

アップグレード・プロセスを開始する前に、Oracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードするための前提条件およびアップグレードに関する考慮事項の各項を参照してください。

表2-1に、AquaLogic Service BusまたはOracle Service Busの各バージョンが実行されるOracle WebLogic Serverのバージョンを示します。

表2-1 Oracle Service BusおよびOracle WebLogic Serverのバージョン

Service Busのバージョン

WebLogic Serverのバージョン

Oracle Service Bus 11g リリース1 (11.1.1.7.0)

10.3.6

Oracle Service Bus 11g リリース1 (11.1.1.6.0)

10.3.6

Oracle Service Bus 11g リリース1 (11.1.1.5.0)

10. 3.5

Oracle Service Bus 11g リリース1 (11.1.1.4.0)

10.3.4

Oracle Service Bus 11g リリース1 (11.1.1.3.0)

10.3.3

Oracle Service Bus 10g リリース3メンテナンス・パック1 (10.3.1)

10.3

Oracle Service Bus 10g リリース3 (10.3)

10.3

AquaLogic Service Bus 3.0

10.0 MP1

AquaLogic Service Bus RP1

9.2 MP2

AquaLogic Service Bus 2.6

9.2 MP1

2.2 Oracle Service Busアップグレードの開始点

サポートされている開始点は次のとおりです。

- AquaLogic Service Bus 2.6

- AquaLogic Service Bus 2.6 RP1

- AquaLogic Service Bus 3.0

- Oracle Service Bus 10g リリース3 (10.3)

- Oracle Service Bus 10g リリース3メンテナンス・パック1 (10.3.1)

注意:

AquaLogic Service Bus 2.6より前のバージョンからconfig.jarファイルをOracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードできません。

注意:

既存のOracle Service Bus 11g リリース1 (11.1.1.6.0)インストールがある場合は、『Oracle Fusion Middlewareパッチ適用ガイド』で指定されているとおりにパッチ・セット・インストーラを使用して、Oracle Service Bus 11g リリース1 (11.1.1.7.0)にOracle Service Bus 11g リリース1 (11.1.1.6.0)のパッチを適用する必要があります。

さらに、11g リリース1 (11.1.1.6.0)から11gリリース1 (11.1.1.7.0)へのドメイン移行を含む、すべてのパッチ適用後の手順を実行します。詳細は、『Oracle Fusion Middlewareパッチ適用ガイド』のOracle Fusion Middlewareコンポーネントの移行後の構成に関する項を参照してください。

2.3 Oracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードするための前提条件

この項では、次の節について説明します。

- 2.3.1項「環境のバックアップ」

- 2.3.2項「Oracle WebLogic Server 10.3.5へのパッチ適用」

- 2.3.3項「Oracle WebLogic Server 10.3.6へのパッチ適用」

2.3.1 環境のバックアップ

Oracle Service Busの最新バージョンにアップグレードする前に、OSB_HOMEまたはALSB_HOMEおよびドメイン(OSB_HOMEまたはALSB_HOMEの外部にある場合)を必ずバックアップしてください。

Oracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードした後で、前のインストール・バージョンのOracle Service Busに戻す場合、バックアップからOracle Service Bus環境をリストアする必要があります。

Oracle Service Busのサンプルに行ったカスタマイズを保存する場合は、構成サンプルをエクスポートして保存します。アップグレードした後、カスタマイズを元に戻すには、構成をインポートする必要があります。

2.3.2 Oracle WebLogic Server 10.3.5へのパッチ適用

Oracle WebLogic Server 10.3.5が実行されている環境から最新のOracle Service Busにアップグレードする場合、Oracle Fusion Middlewareのシステム要件と仕様のドキュメントのOracle WebLogic Server 11gリリース1 (10.3.5)によって必要とされるパッチに関する項での説明に従って2つのWebLogic Serverパッチをインストールする必要があります。

2.3.3 Oracle WebLogic Server 10.3.6へのパッチ適用

Oracle WebLogic Server 10.3.6が実行されている環境で最新のOracle Service Busにアップグレードする場合、Oracle Technology Networkの「Oracle SOA製品およびOracle AIA Foundation Packに関する既知の問題」ページでの説明に従って必要なWebLogic Serverパッチをインストールする必要があります。

http://www.oracle.com/technetwork/middleware/docs/aiasoarelnotesps6-1866030.html

2.4 タスク1: 既存ドメインからの構成のエクスポート

既存ドメインの構成をエクスポートするには、次の手順を実行します:

1. 11g リリース1 (11.1.1.7.0)にアップグレードするドメインのOracle Service Bus管理サーバーを起動します。

2. 管理サーバーのユーザー名とパスワードを使用して、Oracle Service Bus管理コンソールにログインします。

3. 「システム管理」→「リソースのエクスポート」を選択します。
「リソースのエクスポート」ページが表示されます。

4. エクスポートするプロジェクトまたはリソースを選択します。

- 「プロジェクトのエクスポート」を選択した場合、各リソースのチェック・ボックスを個別に選択解除することはできません。

1. プロジェクト・フォルダを展開します。プロジェクトに含まれる各リソースの名前、タイプ、最終変更日時、参照が表示されます。

2. エクスポートするプロジェクトまたはリソースに対応するチェック・ボックスを選択します。

3. エクスポートしないプロジェクトまたはリソースに対応するチェック・ボックスの選択を解除します。

- 「リソースのエクスポート」を選択した場合は、「依存関係を含める」チェック・ボックスを選択するか、選択解除します。このオプションを使用すると、このリソースが参照するその他のリソースをエクスポートできます。

5. 「エクスポート」をクリックしてJARファイルを作成します。

2.5 タスク 2: セキュリティ構成のエクスポート

Oracle WebLogic管理コンソールを使用して、既存ドメインからセキュリティ・データをエクスポートできます。セキュリティ・データをファイルにエクスポートするには、次の手順を実行します:

1. 管理サーバーのユーザー名とパスワードを使用して、Oracle WebLogic管理コンソールにログインします。

2. 左ペインで、「ドメイン構造」の下の「セキュリティ・レルム」を選択し、セキュリティ・データをエクスポートするレルムを選択します(myrealmなど)。

3. 「移行」タブを選択し、「エクスポート」タブをクリックしてデータをエクスポートします。

4. 「サーバー上のエクスポート・ディレクトリ」フィールドで、セキュリティ・データをエクスポートする管理サーバー上のディレクトリを指定します。

5. 「保存」をクリックします。
セキュリティ・データが、指定した場所のファイルに保存されます。

表2-2に、セキュリティ・データおよびデータを保存するセキュリティ・プロバイダのタイプをまとめます。

表2-2 セキュリティ・データとセキュリティ・プロバイダ

セキュリティ・データ

セキュリティ・プロバイダのタイプ

グループ定義

認証プロバイダ

ユーザー・アカウント

認証プロバイダ

ロール定義

ロール・マッピング・プロバイダ

サービス・アカウントのユーザー名とパスワード

ユーザー名およびパスワード資格証明マッピング・プロバイダ

PKI資格証明マップ・エントリ

PKI資格証明マッピング・プロバイダ

SAMLリライイング・パーティ

SAML資格証明マッピング・プロバイダV2

SAMLアサーティング・パーティ

SAML IDアサーション・プロバイダV2

信頼性のある証明書(SSLおよびWSS用)

証明書パス・プロバイダ(証明書レジストリ)

注意:

次の項で説明するように、エクスポートするプロバイダのセットはアップグレードするバージョンによって異なります。

AquaLogic Service Bus 2.6、2.6 RP1および3.0セキュリティ構成のエクスポート

AquaLogic Service Bus 2.5リリースで作業を開始する場合、PKI資格証明、ユーザー名/パスワード資格証明がWebLogic ServerレルムとALSB構成リポジトリに格納されています。したがって、これらの資格証明は、「タスク1: 既存ドメインからの構成のエクスポート」で生成され、エクスポートされた構成JARの一部としてエクスポートされます。JARを新しいドメインにインポートすると、JARファイルの内容に基づいてレルム・データが設定されます。つまり、AquaLogic Service Bus 2.6以降からアップグレードする場合は、PKI資格証明またはユーザー名/パスワード資格証明をエクスポートする必要はありません。

詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のセキュリティ・データの移行に関する章を参照してください。

AquaLogic Service Bus 2.6でのプロキシ・サービスとアクセス制御ポリシーのエクスポート

AquaLogic Service Bus 2.6以前のリリースからのエクスポートでは、エクスポートされたJARファイルにアクセス制御ポリシーは含まれません。まず、アクセス制御ポリシーを含むセキュリティ・レルムをOracle WebLogic Server 9.2上のAquaLogic Service Bus 2.6および2.6 RP1ドメインからOracle WebLogic Server 10.3.4上の新しいOracle Service Bus 11g リリース1 (11.1.1.7.0)ドメインにエクスポートする必要があります。

その後、構成JARファイルとともにプロキシ・サービスをAquaLogic Service Bus 2.6および2.6 RP1ドメインから新しいOracle Service Bus 11g リリース1 (11.1.1.7.0)ドメインにエクスポートする必要があります。詳細は、Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・ヘルプのセキュリティ・プロバイダからのデータのエクスポートに関する項を参照してください。

2.6 タスク3: Oracle Service Bus 11g リリース1 (11.1.1.7.0)のインストールおよび構成

Oracle Service Busをインストールおよび構成する場合は、『Oracle Fusion Middleware Oracle Service Busインストレーション・ガイド』を参照してください。

注意:

Oracle Service Busのインストールおよび構成後、管理サーバーと管理対象サーバーが起動して稼働していることを確認します。

Oracle Service BusでOracle Web Services Managerポリシーを使用する場合、Oracle WebLogicドメインの構成時にいずれかのOracle Service Busドメインを選択した後、Oracle Web Services Manager拡張テンプレートを選択する必要があります。

2.7 タスク4: Oracle WebLogic Serverセキュリティの構成

新しい11g リリース1 (11.1.1.7.0)ドメインで、SSLを使用するOracle WebLogicセキュリティ・フレームワーク、プロキシ・サービスおよびビジネス・サービスをサポートするために必要なセキュリティ・プロバイダを構成します。詳細は、『Oracle Fusion Middleware Oracle Service Bus開発者ガイド』のWebLogicセキュリティ・フレームワークの構成に関する項を参照してください。

構成をインポートする場合は、次の点に注意してください。

- 新しいドメインでPKI資格証明マッピング・プロバイダを使用する場合は、キーストアを新しいドメインにコピーし、そのキーストアを使用するようにPKI資格証明マッピング・プロバイダを構成します。

- ドメインで、_SERVICE_BUS_INBOUND_WEB_SERVICE_SECURITY_MBEAN_または_SERVICE_BUS_OUTBOUND_WEB_SERVICE_SECURITY_MBEAN_という名前のWebサービス・セキュリティ構成が変更されている場合、新しいドメインでも同じ変更を行います。たとえば、2ドメインでUseX509ForIdentity propertyプロパティを__SERVICE_BUS_INBOUND_WEB_SERVICE_SECURITY_MBEAN_ configuration(X.509トークンによるインバウンド認証をサポートするために必要)に追加した場合は、新しいドメインでもこのプロパティを追加します。詳細は、Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・ヘルプのX.509証明書を使用したIDの証明に関する項目を参照してください。

2.8 タスク5: 他のOracle WebLogic Serverオブジェクトの再作成

新しいOracle Service Busドメインで、「タスク1: 既存ドメインからの構成のエクスポート」でエクスポートできなかったOracle WebLogic Serverオブジェクトを再作成します。

- 接続ファクトリ、キュー、トピックなどのJMSリソース

- ワーク・マネージャ定義

- SNMPエージェントとトラップ宛先の設定

Oracle WebLogic Serverドメイン・リソースの構成の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』のWebLogic Serverシステム管理の概要に関する項を参照してください。

注意:

Oracle WebLogic Serverコンソールで、ドメイン・スコープのSNMPエージェントを構成する必要があります。Oracle WebLogic Server 10.xでは、SNMP機能が強化されています。SNMPの詳細は、『Oracle WebLogic SNMP管理ガイド』を参照してください。

TuxedoドメインIDをOracle WebLogic Serverユーザーとして追加します(これは、Tuxedoサービスへの要求を正常に呼び出すための要件です)。

構成にTuxedoトランスポート・ベースのサービスが含まれている場合は、WTCのローカル・アクセス・ポイント・リソースとリモート・アクセス・ポイント・リソースを構成します。

詳細は、Tuxedoの相互運用ソリューションの「TuxedoトランスポートのためのOracle WebLogic Tuxedo Connectorの構成」を参照してください。

2.9 タスク6: セキュリティ・データおよびポリシーのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート

Oracle WebLogic管理コンソールを使用して、「タスク2: セキュリティ構成のエクスポート」でエクスポートしたセキュリティ・データを新しいOracle Service Busドメインにインポートします。詳細は、Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・ヘルプのセキュリティ・プロバイダへのデータのインポートに関する項を参照してください。

注意:

各セキュリティ・プロバイダのセキュリティ情報を個別にインポートします。

AquaLogic Service Bus 2.6でのプロキシ・サービスとアクセス制御ポリシーのインポート

まず、Oracle WebLogic Server 9.2を使用するAquaLogic Service Bus 2.6および2.6 RP1ドメインのセキュリティ・レルムとともにアクセス制御ポリシーを、Oracle WebLogic Server 10.3.4を使用するOracle Service Bus 11g リリース1 (11.1.1.7.0)ドメインにエクスポートする必要があります。

その後、構成jarとともにプロキシ・サービスをAquaLogic Service Bus 2.6および2.6 RP1ドメインからOracle Service Bus 11g リリース1 (11.1.1.7.0)ドメインにエクスポートする必要があります。詳細は、Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・ヘルプのセキュリティ・プロバイダへのデータのインポートに関する項を参照してください。

2.10 タスク7: 構成JARファイルのOracle Service Bus 11g リリース1 (11.1.1.7.0)へのインポート

次の手順を実行して、前に古いドメインからエクスポートしたJARファイルをOracle Service Bus 11g リリース1 (11.1.1.7.0)にインポートする必要があります。

1. 管理サーバーのユーザー名とパスワードを使用して、Oracle Service Busコンソールにログインします。

2. 「作成」をクリックして新しいセッションを作成するか、または「編集」をクリックして既存のセッションに入ります。

3. 「システム管理」→「リソースのインポート」を選択します。
「リソースのインポート」ページが表示されます。

4. 「タスク1: 既存ドメインからの構成のエクスポート」でエクスポートしたプロジェクトまたはリソースJARファイルを選択します。

1. 「ファイル名」フィールドで「参照」をクリックして、JARファイルが格納されているディレクトリを見つけます。

2. JARファイルを選択して、「開く」をクリックします。

5. 「次へ」をクリックします。
「リソースのインポート - リソースJARファイル」ページが表示されます。

6. 「依存関係を含める」を選択して、リソースJARファイルをインポートし、関連するすべてのリソースが確実にインポートされるようにします。

7. インポートするプロジェクトまたはリソースのチェック・ボックスは選択し、インポートしないプロジェクトまたはリソースのチェック・ボックスは選択解除します。

8. 「インポート」をクリックします。
「インポートのサマリー」ページが表示されます。このページには、インポートしたファイルのサマリーとそのステータスが表示されます。

9. チェンジ・センターで「アクティブ化」をクリックします。「セッションのアクティブ化」ページが表示され、セッション名、ユーザー名、および説明のフィールドが示されます。

2.11 タスク8: 必要とされるOracle Service Busアップグレード後作業の実行

Oracle Service Busドメイン構成の一部の変更は自動化されていないため、手動で実装する必要があります。詳細は、「アップグレードに関する考慮事項」を参照してください。

Oracle Service Busプロジェクトの開発に使用したワークスペースを前のリリースからアップグレードすることはできません。このため、次のいずれかの手順を実行して、ワークスペースをアップグレードする必要があります。

注意:

Oracle Service Bus 11g リリース1 (11.1.1)は、Oracle Enterprise Pack for Eclipse (OEPE)統合開発環境(IDE)を使用しています。詳細は、『Oracle Fusion Middleware Oracle Service Bus管理者ガイド』の相互運用性のシナリオと考慮事項を参照してください。

- Oracle Enterprise Pack for Eclipseを使用してOracle Service Bus 11g リリース1 (11.1.1.7.0)で新しいワークスペースを作成してから、前のリリースのワークスペースからconfig.jarファイルをエクスポートします。

- Oracle Enterprise Pack for Eclipse for Oracle Service Bus 11g リリース1 (11.1.1.7.0)を使用して、エクスポートした構成JARファイルを新しいワークスペースにインポートします。インポート・プロセスにより、構成JARファイルは自動的にアップグレードされます。かわりに、構成JARファイルを11g リリース1 (11.1.1.7.0)上のOracle Service Busサーバーにインポートして、構成JARファイルをアップグレードすることも可能です。その後、構成JARファイルをサーバーからエクスポートし、Oracle Enterprise Pack for Eclipse for Oracle Service Bus 11g リリース1 (11.1.1.7.0)を使用して、ワークスペースにインポートします。

注意:

どの構成JARを11g リリース1 (11.1.1.7.0) IDEにインポートしても操作設定および管理設定が削除されます。これらの設定を保持するには、まず構成JARファイルをコンソールにインポートしてから前述の説明に従ってエクスポートして11g リリース1 (11.1.1.7.0) IDEにインポートします。後で構成をIDEからコンソールに移行するときに、操作設定の保持を有効にすると、最初の手順でインポートした操作設定が保持されるようになります。

2.12 アップグレードの確認

アップグレードが正常に行われたことを確認するには、Oracle Service Bus管理コンソールにアクセスし、ログイン・ウィンドウの左下部で新しいバージョン番号を探します(図2-1を参照)。

図2-1 Oracle Service Bus管理コンソール

Oracle Service Bus Administrationコンソールは、次のURLを参照してください。

http://administration_server_hostname:administration_server_port_number/sbconsole

3 アップグレードに関する考慮事項

この章では、Oracle Service Busの様々な構成アーティファクトをOracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードする上での考慮事項について説明します。

内容は次のとおりです。

- AquaLogic Service Bus 2.6ユーザー用のアップグレードに関する考慮事項

- AquaLogic Service Bus 3.0のアップグレードに関する考慮事項

- Oracle Service Bus 10gのアップグレードに関する考慮事項

- リリース1 (11.1.1.6.0)以降におけるXMLでの復帰改行処理への変更

3.1 AquaLogic Service Bus 2.6ユーザー用のアップグレードに関する考慮事項

AquaLogic Service Bus 2.6構成を使用している場合は、次の項をお読みください。

- 統合開発環境

- アラート・ルール

- アラートからアラート宛先への参照の表示

- アラート宛先に送信される詳細

- アラート・ルールのインポート/エクスポートの変更

- プロキシ・サービスのセッション対応アクセス制御の管理

- トランスポートSDKとトランスポート・プロバイダに関する変更

3.1.1 統合開発環境

AquaLogic Service Busコンソールで使用可能な多くのデザインタイム機能は、Oracle Service Bus統合開発環境(IDE)であるOracle Enterprise Pack for Eclipseで使用できます。

コンソールのかわりにIDEを使用する場合、AquaLogic Service Bus 2.6構成JARを11g リリース1 (11.1.1.7.0) IDEに直接インポートします。JARファイルの11g リリース1 (11.1.1.7.0) IDEへのインポートは、 『Oracle Fusion Middleware Oracle Service Bus管理者ガイド』のリソースのインポートに関する項を参照してください。

注意:

どの構成JARを11g リリース1 (11.1.1.7.0) IDEにインポートしても操作設定および管理設定が削除されます。これらの設定を保持するには、まず構成JARファイルをコンソールにインポートしてから前述の説明に従ってエクスポートして11g リリース1 (11.1.1.7.0) IDEにインポートします。後で構成をIDEからコンソールに移行するときに、操作設定の保持を有効にすると、最初の手順でインポートした操作設定が保持されるようになります。

JARファイルのエクスポートについては、「タスク2: セキュリティ構成のエクスポート」を参照してください。

3.1.2 アラート・ルール

AquaLogic Service Bus 3.0以降のサービス・レベル合意(SLA)アラート・ルール機能は、以前のリリースとは若干異なります。これらの変更は、実行時の評価やアラートの発行方法には影響しません。ただし、以下の変更点に注意してください。

- AquaLogic Service Bus 2.6では、アラート・ルール・リソースは個々のリソースとして作成され、個別に保持されていました。Oracle Service Bus 11g リリース1 (11.1.1.6.0)では、アラート・ルールはサービス定義に含まれています。アラート・ルールがサービス定義に含まれ、リソースそのものではなくなっているため、これはAquaLogic Service Busコンポーネントの「参照」ページと「参照先」ページでのアラート・ルールの表示に影響を及ぼしています。参照の表示方法については、『Oracle Fusion Middleware Oracle Service Bus管理者ガイド』の「参照」ページの表示に関する項を参照してください。

- 様々な宛先に関するアラートの内容が少し変更されていることに注意してください。アラート宛先については、『Oracle Fusion Middleware Oracle Service Bus管理者ガイド』のアラート宛先に関する項を参照してください。

- AquaLogic Service Bus 3.0以降では、アラート・ルールの名前を変更すると、元の名前でこれまでに発行されたアラートについて、コンソールの「アラート・サマリー」ページと「拡張SLAアラート履歴」ページのルール定義にアクセスできなくなります。

3.1.3 アラートからアラート宛先への参照の表示

AquaLogic Service Busコンソールでアラート・ルールの各エントリを区別できたAquaLogic Service Bus 2.6以前のバージョンでは、プロキシ・サービスおよびビジネス・サービスからアラート・ルールを介したアラート宛先への参照が保持され、1つの参照として表示されます。たとえば、プロキシ・サービスで、複数のアラート・ルールと複数のパイプライン・アラート・アクションが同じアラート宛先を使用する場合、そのアラート宛先の「参照元」ページには、アラート宛先のエントリが1つだけ表示されます。詳細については、『Oracle Fusion Middleware Oracle Service Bus管理者ガイド』のアラート宛先に関する項を参照してください。

AquaLogic Service Bus 3.0以降のリリースでは、アラートは個別のリソースではなくなっているため、アラートからアラート宛先への参照を表示する方法がAquaLogic Service Bus 3.0以降のリリースとは異なります。Consoleの2つのページが影響を受けます。「アラート宛先」ページの「参照元」フィールドに、宛先を参照しているアラート・ルールが表示されなくなります。かわりに、「参照元」フィールドにアラートを含むサービスが表示されます。この二次的な影響として、同じアラート宛先を参照する複数のアラート(SLAアラートまたはパイプライン・アラート)がサービスに含まれている場合、関連付けられたサービスが「参照元」フィールドに1回だけ示されます。このページには、参照情報が含まれなくなっています。かわりに、関連付けられたサービスの「サービス・サマリー」ページの「参照」フィールドに参照先のアラート宛先が含まれています。詳細については、『Oracle Fusion Middleware Oracle Service Bus管理者ガイド』のアラート宛先に関する項を参照してください。

3.1.4 アラート宛先に送信される詳細

AquaLogic Service Bus 2.6以前と同様に、SLAアラートが構成された宛先に発行されると、アラートの詳細にルールIDが含まれます。ただし、AquaLogic Service Bus 3.0以降のリリースでは、ルールIDの値は親サービスの親サービスのグローバル名とアラート・ルール名の組合せに設定されます。SNMPトラップの場合、AquaLogic Service Bus 2.6以前と同様に、ルールIDは64文字に切り捨てられます。

3.1.5 アラート・ルールのインポート/エクスポートの変更

AquaLogic Service Bus 2.6では、インポート時にアラートを既存のアラートとマージしていましたが、AquaLogic Service Bus 3.0以降のリリースでは、保持/上書きのセマンティクスが提供されます。この機能により、アラートの名前が同じかどうかに関係なく、既存のすべてのアラートを保持することも、上書きすることもできます。

3.1.6 プロキシ・サービスのセッション対応アクセス制御の管理

この項で説明する手順を実行する前に、セキュリティ・レルムを構成する必要があります。

AquaLogic Service Bus 2.6からエクスポートされたJARには、アクセス制御ポリシーは含まれていません。Oracle Service Bus 11g リリース1 (11.1.1.7.0)では、AquaLogic Service Bus 2.6リリースから構成JARをインポートする前に、「インポート前」アクセス制御ポリシーを使用し、11g リリース1 (11.1.1.7.0)へのJARのインプレース・アップグレードを実行します。インプレース・アップグレードを実行するために、プリプロセッサが各プロキシ・サービスに管理可能なすべての認可プロバイダを問い合せて、適用可能なアクセス制御ポリシーのリストを取得します。次に、これらのポリシーをプロキシ・サービスのサービス定義に挿入します。これは、ベスト・エフォート・ベースで実行されます。

管理可能な認可プロバイダとは、PolicyEditorMBeanインタフェースを実装する認可プロバイダです。このようなプロバイダはOracle WebLogic ServerおよびOracle AquaLogic Service Busコンソールで格納されたポリシーを追加、変更、または削除できるようにする読込み/書込みAPIを公開します。

トランスポート・レベルのポリシーと、デフォルトのメッセージ・レベルのポリシーの場合、システムはPolicyEditorMBeanを公開しているプロバイダだけを問い合せて、適用可能なポリシーを取得し、それらのポリシーをサービス定義に挿入します。

操作メッセージ・レベルのポリシーの場合、システムはPolicyListerMBeanを実装しているプロバイダを問い合せることができます。プロバイダがPolicyListerMBeanインタフェースを実装していない場合、操作レベルのポリシーは取得されません。

インプレース・アップグレードが完了すると、認可プロバイダから取得したアクセス制御ポリシーを含め、構成JARが11g リリース1 (11.1.1.7.0)タイプであるかのように、インポート・プロセスが進行します。表3-1に、適用可能なパラメータとインポート・プロセスの結果の様々な組合せを示します。この結果はインポート・プロセスの結果であり、構成のインポート後に実行された内容を示しているわけではありません。

表3-1 適用可能なパラメータとインポートの結果

インポートするconfig.jarのバージョン

プロキシ

コア・リポジトリ内のACL

ポリシーを保持

セッションのサービス定義内のACL

説明

2.6

新規

該当なし(いいえ)

該当なし(いいえ)

管理可能な認可プロバイダから取得

JARを11g リリース1 (11.1.1.7.0)にアップグレードします。このアップグレードには、管理可能なすべての認可プロバイダから適用可能なすべてのACLを取得することが含まれます。セッションのサービス定義には、認可プロバイダから直接取得した構成JARのACLが含まれます。

2.6

既存

いいえ

いいえ

管理可能な認可プロバイダから取得

JARを11g リリース1 (11.1.1.7.0)にアップグレードします。セッションのサービス定義には、認可プロバイダから直接取得した構成JARのACLが含まれます。

2.6

既存

いいえ

いいえ

なし

JARを11g リリース1 (11.1.1.7.0)にアップグレードします。セッションのサービス定義には、ACLは含まれていません。

2.6

既存

はい

いいえ

管理可能な認可プロバイダから取得

JARを11g リリース1 (11.1.1.7.0)にアップグレードします。セッションのサービス定義には、認可プロバイダから直接取得した構成JARのACLが含まれます。

2.6

既存

はい

はい

構成フレームワーク内のコア・リポジトリから取得

JARを11g リリース1 (11.1.1.7.0)にアップグレードします。セッションのサービス定義には、コア・リポジトリのACLが保持されます。

ターゲットのOracle Service Bus 11g リリース1 (11.1.1.7.0)システムに認可プロバイダが存在しない場合、インポート・プロセスは認可プロバイダ用のインポート済ACLを無視して、警告を表示します。この場合、セッションを破棄するか、インポート・タスクを元に戻し、認可プロバイダをサーバーに追加してから再度インポートできます。また、Oracle Service Busこそでセキュリティ・パラメータのダミー更新操作を実行することもできます。この場合、システムによってベスト・エフォート・ベースで競合が自動修正されます。これらの変更はアトミックであり、セッションを破棄すれば元に戻すことができます。

セキュリティ・パラメータの更新の詳細は、『Oracle Fusion Middleware Oracle Service Bus管理者ガイド 』のメッセージ・レベルのセキュリティ構成に関する項を参照してください。

3.1.7 トランスポートSDKとトランスポート・プロバイダに関する変更

次の変更は、Oracle Service Bus 構成に影響を及ぼすことがあります。

- ビジネス・サービス構成のメッセージの再試行回数

- ビジネス・サービスの重複URIの削除

- アプリケーション・エラーの再試行

- HTTPSトランスポートの変更

- 設計環境でのトランスポート構成

3.1.7.1 ビジネス・サービス構成のメッセージの再試行回数

AquaLogic Service Bus 2.6では、メッセージの再試行回数は、ビジネス・サービスのURIのリストに適用されます。Oracle Service Bus 11g リリース1 (11.1.1.7.0)では、再試行回数は個々のURLエンドポイントに適用されます。アップグレード・プロセスでは、2.6の動作が次のように維持されます。

new_retries = N-1 + old_retries*N

ここで、NはURIの総数を表し、old_retriesは2.6の再試行回数を表します。

たとえば、AquaLogic Service Bus 2.6でビジネス・サービスの3つのURLを構成しており、再試行回数が1回であるとします。2.6の再試行メカニズムでは、3つのURLがすべて試行されます。再試行の遅延後、3つのURLがすべて再試行されます。3.0で同じ動作を実現するために、再試行回数が5回に変更されます。これは、(3 -1) + (1*3) = 5という式を適用して取得された値です。最終的な結果はまったく同じです。つまり、3つのURLが1回試行され(5回の再試行のうち、2回を使用)、再試行の遅延後、3つのURLがもう一度試行されます(5回の再試行のうち、残りの3回を使用)。

構成されているURLが1つしかない場合は、以前の動作と新しい動作は同じであり、アップグレード時に再試行回数が変更されることはありません。

詳細は、『Oracle Fusion Middleware Oracle Service Bus管理者ガイド 』のビジネス・サービス: 作成と管理に関する項を参照してください。

3.1.7.2 ビジネス・サービスの重複URIの削除

ビジネス・サービスをOracle Service Bus 11g リリース1 (11.1.1.7.0)にインポートするときに、インポート・プロセスで2.6構成の重複URIが削除されます。URIがランダムな重みベースのロード・バランシング・アルゴリズムを使用し、重みが設定されている場合、重みは適宜調整されます。たとえば、ビジネス・サービスが以下のURIと重みで構成されているとします。

- URI_A 1

- URI_B 3

- URI_A 1

ビジネス・サービスを11g リリース1 (11.1.1.7.0)にアップグレードすると、このURIのセットは次のように変更されます。

- URI_A 2

- URI_B 3

ビジネス・サービスが他のアルゴリズムで構成されている場合は、アップグレード時に重複URIが削除され、その他の変更は行われません。

ロード バランシング アルゴリズムのパラメータの設定の詳細は、『Oracle Fusion Middleware Oracle Service Bus管理者ガイド 』のビジネス・サービス: 作成と管理に関する項を参照してください。

3.1.7.3 アプリケーション・エラーの再試行

アウトバウンド・リクエストの送信時に配信エラーが発生した場合、Oracle Service BusではSOAPフォルトなどのアプリケーション・エラーのエンドポイントURIを再試行するかどうかを指定できます。これは、通信エラーの再試行には影響を及ぼしません。この新しいオプションは、ビジネス・サービスの「トランスポート構成」ページに用意されています。詳細は、『Oracle Fusion Middleware Oracle Service Bus管理者ガイド 』の「トランスポート構成」ページに関する項を参照してください。再試行回数を超えるとエラーが発生します。

2.6の動作を維持するには、デフォルト値をtrueに設定して新しいタグを追加します。

<xs:element name="retry-application-errors" type="xs:boolean"  minOccurs="0"/>

このタグは、プロバイダ構成でdeclare-application-errorフラグがtrueに設定されているトランスポート・エンド・ポイントにのみ追加されます。

3.1.7.4 HTTPSトランスポートの変更

AquaLogic Service Bus 3.0以降のコンソールでは、HTTPとHTTPSの切替えを簡略化するために、HTTPSトランスポート構成が削除され、その機能が3.0のインバウンドHTTPトランスポート・プロバイダに追加されています。11g リリース1 (11.1.1.7.0)のHTTPトランスポート構成ページには、HTTPSを有効にするチェック・ボックスがあります。

新しい要素であるuse-httpsがHTTPトランスポートのインバウンド・プロパティのスキーマに追加されます。

<xs:element name="use-https" type="xs:boolean" minOccurs="0"/>

既存のHTTPSトランスポート構成は、このフラグがtrueに設定されたHTTPトランスポートにアップグレードされます。

注意:

この機能を適用できるのは、HTTPプロキシ・サービスのみです。

3.1.7.5 設計環境でのトランスポート構成

以前のリリースでは、AquaLogic Service BusのトランスポートはAquaLogic Service Busコンソールからしか構成できませんでした。ALSB 3.0では、Eclipseでトランスポートを設計できます。詳細は、Oracle Fusion Middleware Oracle Service BusトランスポートSDKユーザー・ガイドのWorkshop for WebLogic用のOracle Service Busトランスポートの開発に関する説明を参照してください。

3.2 AquaLogic Service Bus 3.0のアップグレードに関する考慮事項

AquaLogic Service Bus 3.0を使用している場合は、次の項をお読みください。

- Oracle Enterprise Pack for EclipseでのAquaLogic Service Bus 3.0ワークスペースのアップグレード

- Java Message Serviceビジネス・サービスではJNDI サービス・アカウントが非推奨

- パイプライン・アクションIDのアップグレード

- パイプライン・モニタリングのレベル

- 強化された検証

3.2.1 Oracle Enterprise Pack for EclipseでのAquaLogic Service Bus 3.0ワークスペースのアップグレード

AquaLogic Service Bus 3.0ワークスペースをOracle Service Bus Oracle Enterprise Pack for Eclipseにアップグレードするには、次の手順を実行します:

注意:

ワークスペースをアップグレードすると、ALSB 3.0のWorkSpace Studio 1.1では開けなくなります。

1. ALSB 3.0でWorkSpace Studio 1.1を開始してアップグレードするワークスペースを開きます。

2. ALSBパースペクティブとすべてのエディタを閉じます。

3. すべてのプロジェクトを閉じます。

4. WorkSpace Studio 1.1を閉じます。

5. ワークスペースをバックアップします。

6. 11g リリース1 (11.1.1.6.0)でOracle Enterprise Pack for Eclipseを起動し、アップグレードするワークスペースを開きます。

7. アップグレードが開始するのを待ちます。Oracle Enterprise Pack for Eclipse for Oracle Service Bus 11g リリース1 (11.1.1.7.0)でAquaLogic Service Bus 3.0ワークスペースを開く場合、アップグレード・プロセスが開始されるまで少し時間がかかります。アップグレードが完了して確認ダイアログが表示されるまで、ワークスペースを編集しないでください。

8. プロジェクトをアップグレードしたら、Oracle Service Busパースペクティブを開き、新しくアップグレードしたプロジェクトとアーティファクトで作業を続けます。

3.2.2 Java Message Serviceビジネス・サービスではJNDI サービス・アカウントが非推奨

Oracle Service Bus 11g リリース1 (11.1.1.7.0)では、jndi-service-accountは非推奨です。11g リリース1 (11.1.1.7.0)にアップグレードした後、Oracle Service Bus Java Message Service (JMS)ビジネス・サービスはJMSおよびJNDIの両方のためにjms-service-accountを使用します。

Oracle Service BusのJMSビジネス・サービスでどのようにJNDIアカウントとJMSアカウントを移行するかを次の表に示します。

表3-2 JMSビジネス・サービスのJMSおよびJNDIアカウントの移行

アップグレード前のjms-service-account

アップグレード前のjndi-service-account

アップグレード後のjms-service-account

sa-1

sa-1

sa-1

sa-1

sa-2

sa-1

sa-1

—

sa-1

—

sa-2

sa-2

3.2.3 パイプライン・アクションIDのアップグレード

11g リリース1 (11.1.1.7.0)にアップグレードした後、パイプラインでのすべてのアクションに一意のIDが割り当てられます。

3.2.4 パイプライン・モニタリングのレベル

11g リリース1 (11.1.1.7.0)のプロキシ・サービスでは、新しいモニタリング・フラグを使用して、収集する統計のレベルを制御します。次の3つのレベルがあります。

- Service - 大まかな統計。

- Pipeline - AquaLogic Service Bus 3.0で収集されていた統計と同じレベル。

- Action - 詳細な統計。

モニタリング・フラグの値はアップグレードによりPipelineに設定されます。

3.2.5 強化された検証

Oracle Service Bus 11g リリース1 (11.1.1.7.0)から、次の領域で検証ルールがより厳格になっており、その結果、設計時エラーまたは実行時エラーが発生する場合があります:

- WSDLおよびサービスの検証の強化: 以前のリリースからOracle Service Bus 11g リリース1 (11.1.1.7.0)にアップグレードすると、次のような競合メッセージが出力されることがあります。

- [OSB Kernel:398022]該当するマッピングがWSDL操作のサービス定義内で見つかりません: OPERATION-NAME

- [OSB Kernel:398034]2つの操作は同じ着信メッセージを予期しているため、メッセージ本文と異なるセレクタを使用する必要があります

この場合は、エラー・メッセージの指示に従ってWSDLまたはサービスを更新します。

- 分割-結合の検証の強化: AquaLogic Service Bus 3.0では、分割-結合で、初期化されていない変数への挿入アクションが許可されていました。Oracle Service Bus 11g リリース1 (11.1.1.7.0)では、このような挿入アクションは失敗し、次のエラーが表示されます。

Variable 'VARIABLE-NAME' is being referenced before it has been initialized with a value.: Fault [{http://docs.oasis-open.org/wsbpel/2.0/process/executable}uninitializedVariable]

分割-結合がAquaLogic Service Bus 3.0では機能するのにOracle Service Bus 11g リリース1 (11.1.1.7.0)では前述のエラーで失敗する場合、挿入前に変数を初期化するように分割-結合を編集します。

- JMSプロキシ・サービスおよびビジネス・サービスURIの検証の強化: Oracle Service Bus 11g リリース1 (11.1.1.7.0)より前のバージョンでは、ホストおよびポートを指定せずにJMSプロキシ・サービスおよびビジネス・サービスURIを入力できました。Oracle Service Bus 11g リリース1 (11.1.1.7.0)では、次の検証が適用されます。

- JMSプロキシ・サービスURIのホストとポートは省略できます。省略すると、実行前に確認ダイアログが表示されます。

- JMSビジネス・サービスURIのホストとポートは必ず指定する必要があります。

3.3 Oracle Service Bus 10gのアップグレードに関する考慮事項

Oracle Service Bus 10g リリース3メンテナンス・パック1 (10.3.1)またはOracle Service Bus 10gリリース3 (10.3)を使用している場合、次のアップグレードに関する考慮事項をお読みください。

- アラートのアップグレード

- JCAエンドポイント構成

- JMSビジネス・サービスの構成

- グローバル操作設定

- UDDI構成

3.3.1 アラートのアップグレード

アップグレードでは、既存の動作が次のように保持されます。

- アラート・ログ有効フラグがアラート宛先にデフォルトで追加され、デフォルト値はtrueです。

- アラート宛先がないSLA定義およびパイプライン・アラート定義は、次のようにアップグレードされます。

- アップグレード・プロセスの一部として新しいアラート宛先が作成されます。アップグレードされるサービスと同じプロジェクトの下に作成され、AlertDestinationForLoggingという名前が付けられます。このアラート宛先は、アラート・ログのみが有効になっています。同じプロジェクトの下に、このアップグレード・ロジックに従うサービスが複数ある場合、これらのサービスは同じアラート宛先を共有します。

- アラート宛先のないSLA定義およびパイプライン・アラート定義は、この新しいアラート宛先を参照するようにアップグレードされます。

3.3.2 JCAエンドポイント構成

JCAエンドポイント構成は、新規構成を使用するようにアップグレードされます。JCA WSIF拡張のあるWSDLは、Oracle Service Bus 11gアダプタ・アーティファクトにアップグレードされます。たとえば、JCAファイル、抽象WSDLおよび具体WSDLでは、JCA 10g wsdlをWSDL 11gおよびJCAファイルにアップグレードするためのインタフェースが提供されます。その他のアップグレードは次のとおりです。

構成JARのアップグレード

インポートされたOracle Service Bus config.jarファイルがJCAアップグレーダでスキャンされてから、JCA WSDL (WSIF JCA拡張のあるOracle SOA 10g WSDL)とconfig.jarファイル内のJCAサービスがアップグレードされます。

注意:

JCAサービスに関連付けられているJCA WSDLのみアップグレードされます。どのJCAサービスでも使用されていないJCA WSDLは、アップグレードされません。

JCA WSDLのアップグレード

インポートされたconfig.jarファイル内のJCA WSDLはアップグレードされます。JCAリソースおよび抽象WSDLはJCA WSDLから生成されます。具体WSDLは抽象WSDLとJCAリソースから生成されます。具体WSDLは次のルールに基づいて生成されます。

- ターゲット・ネームスペースは抽象WSDLと同じである必要があります。

- WSIF JCAバインディングのある10g内のJCA(具体)WSDLは、JCAバインディングを含むJCAリソース、10g WSDLの抽象部分を含む抽象WSDL、および抽象WSDLで定義されているportTypeに基づくSOAPバインディングを含む具体WSDLにアップグレードされます。10gのJCA WSDLに基づくJCAサービスは、SOAPバインディングを含む具体WSDLに基づくようにアップグレードされ、JCAリソースへの参照も持つようになります。

- バインディング・セクションにはSOAP 1.1バインディングが含まれます。

- SOAP 1.1バインディング・スタイルはドキュメントです。

- SOAP 1.1バインディング・セクションには抽象WSDLのすべての操作が含まれます。

- 各バインディング操作について、SOAP 1.1操作要素はsoapAction属性が操作名に設定された状態で生成されます。

- 各バインディング操作の入力および出力要素について、属性がリテラルを使用するように設定されたSOAP 1.1 body要素が生成されます。

- 抽象WSDLで定義されたヘッダー・メッセージを持つ特定のAQユースケースをサポートするために、SOAP header要素は操作の入力バインディング・セクションに対して生成されます。AQ抽象WSDLにはWSDLメッセージ名"Header_msg"が含まれ、メッセージには"Header"という名前の単一部分が含まれることが想定されます。

- サービス・セクションは、生成されたバインディングのポートで作成されます。生成されるポートには、location属性が次のように設定されたSOAP 1.1 address要素が含まれます。

jca://<adapter_connection_factory_jndi>

注意:

Oracle Service Bus 10gのJCA以外(http、jmsなど)のサービス・タイプ・プロキシ/ビジネス・サービスは、JCAバインディングを持つWSDLに基づき、同じWSDLがJCAサービス・タイプ・プロキシ/ビジネス・サービスで使用されていない場合、WSDLはアップグレードされないため、インポート時に競合します。SOAPバインディングなど、JCA以外のバインディングを持つようにWSDLを手動で修正して、競合を回避する必要があります。

例3-1 JCA具体WSDL

<?xml version="1.0"?>
<definitions name="db-inbound-concrete"
targetNamespace="http://xmlns.oracle.com/pcbpel/adapter/db/db_inbound/"
xmlns:tns="http://xmlns.oracle.com/pcbpel/adapter/db/db_inbound/"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<import namespace="http://xmlns.abc.com/pcbpel/adapter/db/db_inbound/"
location="inbound.wsdl"/>
<binding name="db-inbound_binding" type="tns:db-inbound_ptt">
<soap:binding style="document"
transport="http://www.abc.com/wli/sb/transports/jca"/>
<operation name="receive">
<soap:operation soapAction="receive"/>
<input name="receive">
<soap:body use="literal"/>
</input>
</operation>
</binding>

<service name="db-inbound">
<port name="db-inbound_pt" binding="tns:db-inbound_binding">
<soap:address location="jca://eis/DB/OSBJCADBConnection"/>
</port>
</service>
</definitions>

構成jar内の既存のJCA WSDLは具体WSDLで更新されます。

JCAサービスのアップグレード

構成JAR内の各JCAサービスは、JCAトランスポート固有の構成の変更で更新されます。生成されたJCAリソースへの参照は、JCAトランスポート固有の構成セクションに追加されます。エンドポイント構成で定義された他のすべてのプロパティは同じままになります。JCAサービスには、同じWSDLとバインディングに対する同じ依存関係が含まれますが、WSDLの内容は、生成された具体WSDLを含むように更新されます。

TopLinkマッピング・ファイルの内容

TopLinkマッピング・ファイルの内容は、エンドポイント構成から抽出されます。XMLリソースが作成され、エンドポイント構成から抽出されたTopLinkマッピング・ファイルの内容はXMLリソースの内容として格納されます。XMLリソースの名前は、エンドポイント構成内のアクティブ化/相互作用プロパティで指定されたTopLinkマッピング・ファイル名から「.xml」ファイル拡張子を除いたものになります。生成されたTopLinkマッピング・ファイルXMLリソースへの依存性は、このJCAサービスのJCAファイル・リソース内で生成されます。

ヘッダーのあるAQアダプタWSDLのアップグレード

SOA 11g より前は、AQアダプタWSDL内のHeader要素定義は、WSDL自体のターゲット・ネームスペースと同じネームスペースで定義されます。SOA 11g では、AQアダプタはWSDLのHeader要素のターゲット・ネームスペースを変更しました。新しいネームスペースは、次に示すように固定のネームスペースです:

http://xmlns.oracle.com/pcbpel/adapter/aq/headers/payloadheaders/

OSB JCAトランスポート・アップグレーダは、前述の新しい固定ターゲット・ネームスペースに一致するようにAQアダプタWSDLのHeader要素のターゲット・ネームスペースを自動的に変更します。

手動アップグレード

10gで使用されていたJCAアダプタ・ヘッダーは、NormalizedMessageプロパティで使用できます。AQアダプタにペイロード・ヘッダーが必要な場合、11g ではNormalizedMessageヘッダー・プロパティが使用されます。ペイロード・ヘッダーが必要な場合、キュー・ヘッダーとペイロード・ヘッダーはNormalizedMessageヘッダーを介して転送されます。

ヘッダー・サポートの変更により、一部のOracle Service Bus 10g構成は手動でアップグレードする必要があります。具体的には、パイプラインが11g に存在しないメッセージ・ヘッダー・タイプにアクセスしている場合は、トランスポート・ヘッダーを介してヘッダーにアクセスするように構成をアップグレードする必要があります。

3.3.3 JMSビジネス・サービスの構成

リクエスト/レスポンス・パターンを使用するJMSビジネス・サービス(MessageIDおよびCorrelationIDベースの相関)は、新しい構成を使用するようにアップグレードされます。既存の「レスポンスが必要」フラグは、「レスポンス・キュー」プロパティ・オプションによって機能が拡張されました。「レスポンス・キュー」プロパティ・オプションの値には、「なし」、「リクエストURIごとに1つ」または「すべてのリクエストURIに対して1つ」を指定できます。次の表に、既存の値がどのようにアップグレードされたかを示します。

表3-3 JMSビジネス・サービス構成

レスポンスが必要

レスポンス・キュー

True

すべてのリクエストURIに対して1つ

False

なし

「レスポンスが必要」の値がtrueに設定されている場合、Oracle Service Bus 11gでも同じ値が使用され、「レスポンス・キュー」オプションは、すべてのリクエストURIに対して1つに設定されます。

アップグレード前のサービスで「レスポンスが必要」の値がtrueに設定されている場合、各ターゲットにおいて、「レスポンス・キュー」オプションは、新しい構成レスポンスURIを持つすべての「すべてのリクエストURIに対して1つ」に対して「1つ」に設定されます。スタンドアロン・ドメインでは、このターゲットは単一サーバーです。既存のコネクション・ファクトリおよびレスポンスJNDI名が新しいレスポンスURI構成にマージされます。レスポンスURIフォーマットは、ビジネス・サービスの最初のサービスURIの使用可能ホスト/ポート情報で作成され、コネクション・ファクトリおよびレスポンス・キューJNDI名が付加されます。ホスト/ポート情報は常に最初のサービスURIから取得されます。最初のサービスURIには、コネクション・ファクトリも含まれます。これは、レスポンスの構成済コネクション・ファクトリが空白の場合に取得されます。

レスポンスURIのフォーマットは、'jms://<ip>:<port>,<ip>:<port>/<connection-factory-jndi-name>/<response-queue-jndi-name>'です。

3.3.4 グローバル操作設定

結果キャッシュ要素を含まないグローバル操作設定リソースをインポートする場合、デフォルト値がtrueの新しい結果キャッシュ要素が追加されます。

3.3.5 UDDI構成

UDDI関連要素はServices.xsdのServiceEntry要素から新しい要素uddiConfigurationに移動しました。この要素は、UDDIからインポートされるビジネス・サービスに使用されます。

アップグレード後、同期中に古い名前のWSDLがある場合、この名前が使用されます。ただし、WSDLがない場合は、新しい命名規則で新しいWSDLが作成されます。

サービスのサービス・キーとサービス名は、uddiConfiguration要素の一部として保存されます。

3.4 リリース1 (11.1.1.6.0)以降におけるXMLでの復帰改行処理への変更

XMLドキュメントでの復帰改行文字の処理を修正するために、Apache XMLBeansが更新されました。更新されたのは、XMLBeansが復帰改行文字(\r)を適切にエスケープしなかったためです。ドキュメントに&#13;が含まれる場合はXMLBeansへと解析される際に適切にエスケープ解除されて\rになりましたが、\rがストリーム・アウトされる際は、エスケープされませんでした。その結果、XMLでは\rが無効であるため、無効なXMLドキュメントが生成されていました。XMLBeansの修正後、\rは適切に&#13;にエスケープされるようになりました。

バージョン11g リリース1 (11.1.1.6.0)以降にアップグレードする場合、現在、前述の問題に対する回避策を実施しているのであれば、復帰改行文字の処理方法を修正する必要があります。たとえば、回避策として&#13;に2回のエスケープを行って&amp;#13;に変換し、ストリーム・アウトの際に&#13;に戻るようにしている場合、検証エラーを回避するために2回目のエスケープを取り除く必要があります。

索引
O

O

Oracle Fusion Middlewareアップグレード・プランニング・ガイド, 1.3

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2013, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。