Oracle® Fusion Middleware Oracle SOA Suite、WebCenter PortalおよびADFアップグレード・ガイド

11g リリース1 (11.1.1.6.0)

B55926-05(原本部品番号:E10127-06)

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

1 Oracle SOA Suite、WebCenterおよびADFのアップグレード処理の概要

- 1.1 Oracle SOA Suite、WebCenterおよびADFのアップグレード処理のフロー・チャート

- 1.2 Oracle SOA SuiteおよびWebCenterのアップグレード処理における各ステップの説明

第I部 Oracle SOA Suite、WebCenterおよびADFのアップグレード準備

2 Oracle SOA Suite、WebCenterおよびADFのサポートされるアップグレードの開始点

- 2.1 Oracle SOA Suite、WebCenterおよびADFのサポートされるアップグレードの開始点の概要

- 2.2 Oracle SOA Suite 10g リリース2(10.1.2)ユーザー向けの情報

3 10gユーザーのためのOracle SOA Suite、WebCenterおよびADFの情報

- 3.1 Oracle ADFユーザー向けの情報

- 3.2 Oracle SOA Suiteユーザー向けの情報

- 3.2.1 OC4JとOracle WebLogic ServerにおけるOracle SOA Suiteの比較

- 3.2.2 OC4JとOracle WebLogic ServerにおけるOracle SOA Suiteディレクトリ構造の比較

- 3.2.3 Oracle SOA Suiteエンタープライズ・デプロイメントのアップグレード

- 3.2.4 Oracle Application Server 10gおよびOracle Fusion Middleware 11gにおけるOracle BAMおよびOracle B2B

- 3.3 Oracle WebCenterユーザー向けの情報

- 3.3.1 Oracle WebCenterおよびOracle Enterprise Content Management Suiteの新規製品名

- 3.3.2 OC4JとOracle WebLogic ServerにおけるOracle WebCenterの比較

- 3.3.3 OC4JとOracle WebLogic ServerにおけるOracle WebCenterディレクトリ構造の比較

4 Oracle BPEL長時間実行プロセスに関する特別な考慮事項

- 4.1 Oracle BPEL Process Manager長時間実行プロセスとは

- 4.2 長時間実行プロセスの2通りのアップグレード方法

- 4.2.1 長時間実行プロセスに対するアップグレード時の同時並行アプローチの使用

- 4.2.2 長時間実行プロセスに対する猶予期間と強制終了の使用

第II部 Oracle SOA Suite、WebCenterおよびADF環境のアップグレード

5 Oracle ADF 10g環境のアップグレード

- 5.1 タスク1: ADFアプリケーションに使用するOracle Fusion Middleware 11gトポロジの決定

- 5.2 タスク2: ADFアプリケーションに使用するOracle WebLogic Serverドメインのインストールおよび構成

- 5.2.1 Oracle JDeveloperを使用する開発ドメインのインストールおよび構成

- 5.2.2 JDeveloperを使用しないドメインのインストールおよび構成

- 5.2.3 Java Required Files(JRF)ドメイン・テンプレートの使用方法

- 5.2.3.1 JRFテンプレートを使用した新規ドメインの作成

- 5.2.3.2 JRFテンプレートを使用した既存ドメインの拡張

- 5.2.3.3 既存のOracle WebLogic ServerインスタンスのADF 11gランタイムへのアップグレード

6 Oracle SOA Suite 10g環境のアップグレード

- 6.1 タスク1: Oracle SOAトポロジの決定

- 6.2 タスク2: Oracle SOA SuiteスキーマをホストするOracleデータベースのアップグレード(必要な場合)

- 6.3 タスク3: リポジトリ作成ユーティリティによる11g SOAスキーマのインストール

- 6.3.1 Oracle SOA Suiteのアップグレード準備としてのリポジトリ作成ユーティリティの実行

- 6.3.2 Oracle SOA Suiteのアップグレードに必要なスキーマの選択

- 6.4 タスク4: Oracle SOA Suite 11g中間層のインストールと構成

- 6.5 タスク5: SOAコンポーネントのスキーマのアップグレード(必要な場合)

- 6.5.1 タスク5a: アップグレード・アシスタントの実行によるOracle SOAスキーマのアップグレード

- 6.5.2 タスク5b: B2Bスキーマのアップグレード(必要な場合)

- 6.5.2.1 B2Bスキーマのアップグレードに関する一般的な情報

- 6.5.2.2 Oracle B2B 10g中間層への必要なパッチ・セットの適用

- 6.5.2.3 Oracle WebLogic Server管理コンソールにおける最大メッセージ・サイズ属性の設定

- 6.5.2.4 B2Bスキーマのアップグレードの実行

- 6.5.3 タスク5c: BAMスキーマのアップグレード(必要な場合)

- 6.5.3.1 Oracle BAMスキーマのアップグレードの注意点

- 6.5.3.2 以前のバージョンのOracle BAMからのアップグレードについて

- 6.5.3.3 Oracle BAMスキーマが含まれているOracleデータベースへの必要なパッチ・セットの適用

- 6.5.3.4 Oracle BAMスキーマのアップグレードの実行

- 6.5.3.5 中断されたOracle BAMスキーマのアップグレードからのリカバリと再試行

- 6.5.3.6 Oracle BAMアップグレード・ログ・ファイルの検索および構成

- 6.6 タスク6: SOAアプリケーションのサポートに必要なJava EE機能の構成

- 6.7 タスク7: SOAコンポーネントに必要なアップグレード後タスクの実行

- 6.7.1 Identity Managementコンポーネントを使用するためのOracle SOA Suite 11gの構成

- 6.7.2 Oracle Human Workflowにおける大/小文字区別について

7 Oracle WebCenter 10g環境のアップグレード

- 7.1 タスク1: Oracle WebCenter Portal 11gトポロジの決定

- 7.2 タスク2: WebCenterスキーマをホストするOracleデータベースのアップグレード(必要な場合)

- 7.3 タスク3: リポジトリ作成ユーティリティによるOracle WebCenter Portal 11gスキーマのインストール

- 7.3.1 Oracle WebCenterのアップグレード準備としてのリポジトリ作成ユーティリティの実行

- 7.3.2 Oracle WebCenter Portal 11gに必要なスキーマの選択

- 7.4 タスク4: Oracle WebCenter Portal 11g中間層のインストールと構成

- 7.5 タスク5: WebCenterアプリケーションのサポートに必要なJava EE機能の構成

- 7.6 タスク6: WebCenterサービスのバックエンド・コンポーネントのアップグレード

- 7.6.1 Oracle WebCenter Discussionsのアップグレード

- 7.6.2 Oracle Content Serverのアップグレード

- 7.6.2.1 Oracle WebCenter Content Server 11gへのアップグレード

- 7.6.2.2 Oracle Content Server 10.1.3.5.1へのアップグレード

- 7.6.3 Oracle WebCenter Wiki and Blog Serverデータの移行

第III部 Oracle SOA Suite、Oracle WebCenterおよびADFアプリケーションのアップグレード

8 Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要

- 8.1 タスク1: サンプル・アプリケーションでのアップグレード手順の確認

- 8.2 タスク2: アプリケーションがOracle Application Server 10g上で正常に稼働していることの確認

- 8.3 タスク3: アップグレードするアプリケーションのタイプに固有の考慮事項の確認

- 8.4 タスク4: 10g環境から11g環境へのアップグレードが完了していることの確認

- 8.5 タスク5: Oracle JDeveloper 11gのインストールと起動

- 8.6 タスク6: Oracle Jdeveloperでアプリケーションを開いてアップグレード

- 8.7 タスク7: 使用しているアプリケーションのコンポーネントに関するアップグレード情報の検索

- 8.8 タスク8: アプリケーションの確認および再コンパイル

- 8.9 タスク9: アプリケーションのデプロイ

9 すべてのOracle SOAアプリケーションのアップグレード時の考慮事項

- 9.1 すべての外部パートナが使用可能であることの確認

- 9.2 Oracle SOA Suiteアプリケーションに対するOracle JDeveloper 11g移行ウィザードの使用

- 9.3 すべてのJavaアプリケーションに関連するアップグレード・タスク

- 9.4 すべてのOracle SOA Suiteアプリケーションに関連するアップグレード・タスク

- 9.4.1 Oracle Fusion Middleware 11gにおけるOracle SOA Suite APIの変更について

- 9.4.1.1 Oracle Business Rules用のOracle Fusion Middleware Java APIへのアップグレード

- 9.4.1.1.1 11gにおけるOracle Business Rules SDKおよびAPIの変更の概要

- 9.4.1.1.2 開発環境でのディクショナリへのアクセス

- 9.4.1.1.3 本番環境でのリポジトリへのアクセス

- 9.4.1.1.4 RLコードの生成

- 9.4.1.1.5 WebDAVのOracle Business Rulesプロジェクトのアップグレード

- 9.4.1.2 Oracle SOA Suite用のOracle Fusion Middleware Infrastructure Management Java APIへのアップグレード

- 9.4.2 依存JARファイルに関するプロジェクトの確認

- 9.4.3 Webサービス用のプロキシ設定を必要とするアプリケーションのアップグレード

- 9.4.4 移行ウィザードによってアップグレードされないbuild.xmlおよびbuild.propertiesファイルの再作成

- 9.4.5 UDDIに登録されているリソースを使用するプロジェクトのアップグレード

- 9.4.5.1 アップグレード前にserviceKeyエンドポイントが使用可能であることの確認

- 9.4.5.2 orauddiプロトコルの変更

- 9.4.6 Oracle SOA Suiteのユーザー定義(カスタム)XPath関数のアップグレード

- 9.4.7 Oracle SOA Suite 11gのファイル・ネーミング規則の理解

- 9.4.8 Oracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法

- 9.4.8.1 Oracle SOA Suiteコマンドライン・アップグレード・ツールの使用の利点

- 9.4.8.2 Oracle JDeveloper 11gでのOracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法

- 9.4.8.3 Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用してHuman Workflowアプリケーションをアップグレードする場合の制限

- 9.4.8.4 Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用したBPELまたはESBプロジェクトのアップグレード

- 9.4.8.5 Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用した複数のBPELプロジェクトの単一コンポジットへの統合

- 9.4.8.6 Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用したOracle Enterprise Service Bus(ESB)プロジェクトのアップグレード

- 9.4.8.7 ESBリポジトリのドメイン値マップ(DVM)と相互参照(XREF)のアップグレード

- 9.4.9 Oracle SOA Suite 10g相互参照(XREF)ランタイム・データの11gへのアップグレード

- 9.4.9.1 XREFランタイム・データのアップグレード手順

- 9.4.9.2 XREFランタイム・データ・アップグレード時のその他のタスクと考慮事項

10 Oracle BPEL Process Managerアプリケーションのアップグレード

- 10.1 Oracle BPEL Process Managerアプリケーションの移行後の手動アップグレード・ステップ

- 10.1.1 外部参照のための不足しているバインディング情報の指定

- 10.1.2 Oracle BPEL Process Managerテスト・スイートを使用した問題の修正

- 10.1.3 アップグレード後のOracle BPEL Process Managerデプロイメント・プランの使用方法

- 10.1.4 Oracle BPEL Process Managerプロジェクトのフォルト・ポリシーのアップグレード

- 10.1.5 BPELフォルダのない10gプロジェクトのアップグレード

- 10.1.6 EJBへのWSIFバインディングを使用するプロジェクトのアップグレード後のステップ

- 10.1.7 異なるバインディングのアップグレード

- 10.2 Oracle BPEL Process Managerアプリケーションに関するその他の考慮事項

- 10.2.1 bpel.xmlデプロイメント・ディスクリプタの新しいプロパティと非推奨プロパティの確認

- 10.2.2 Oracle BPEL Process Managerプロジェクトのユーザー定義(カスタム)XPath関数のアップグレード

- 10.2.3 複数のBPEL実装のサポートに関する変更

- 10.2.4 非同期サービスで相関セットを使用するプロジェクトをアップグレードする場合のプロパティ・ファイル名の確認

- 10.2.5 transaction=participateプロパティを使用したプロジェクトのアップグレード

- 10.2.6 Oracle BPEL Process Manager 11gでのドメイン・ディスクリプタ・プロパティの指定

- 10.2.7 複数のOracle BPEL Process Managerドメインを使用するアプリケーションのアップグレード

- 10.2.8 暗号化と復号化の使用

- 10.2.9 アップグレード前のプロセスID、プロジェクト名およびBPELファイル名表記規則の確認

- 10.2.10 Oracle BPEL Process Manager 11g XPath関数のネームスペース接頭辞の確認

- 10.2.11 複数のタスクを持つOracle BPEL Process Managerプロジェクトのアップグレード

- 10.2.12 動的パートナ・リンクのアップグレード

11 Oracle Business Activity Monitoringアプリケーションのアップグレード

- 11.1 Oracle BAMユーザー、グループおよびその他のLDAP情報の11gへの移行

- 11.2 アップグレード後のOracle BAMアクション・フォーム・テンプレートの検証

- 11.3 Oracle BAM外部データソースのアップグレード

- 11.4 Oracle BAMレポートのイメージのアップグレード

- 11.5 11gでのOracle BAM Webサービスの使用方法

- 11.5.1 Oracle BAM 11gでのWebサービス・クライアントの使用方法

- 11.5.2 Oracle BAMアラートからのWebサービスの起動

- 11.5.3 Oracle BAM 11gでのManualRuleFire Webサービスの使用方法

- 11.5.4 Oracle BAM 11gの新しいWebサービスのサポート

- 11.6 Oracle BAMセンサー・アクションのアップグレード

- 11.7 Oracle BAM 11gへのエンタープライズ・リンク計画のアップグレード

- 11.8 Oracle BAM 11gへのアップグレード時のその他の考慮事項

- 11.8.1 アップグレード後のOracle BAMアラート・アクションの使用

- 11.8.2 アップグレード後のOracle BAMエンタープライズ・メッセージ・ソースの再作成

12 Oracle B2Bアプリケーションのアップグレード

- 12.1 Oracle B2B 11gにアップグレードされない機能

- 12.1.1 ホストおよびパートナのセキュリティ証明書

- 12.1.2 コールアウト・ライブラリJARファイル

- 12.1.3 交換プロトコル・パラメータの識別子

- 12.1.4 AS2-1.1チャネルの受信者プロパティ

- 12.1.5 汎用TCPチャネル

- 12.1.6 PositionalFlatFileドキュメント

- 12.2 Oracle B2B 11gへのアップグレード後に変更される機能

- 12.2.1 「ドキュメント・プロトコル・リビジョン」および「ドキュメント・タイプ」フィールド

- 12.2.2 MLLPチャネルの交換プロトコル・パラメータ

- 12.2.3 チャネル・パスワード

- 12.2.4 Oracle B2B 11gで必須のOracle B2B 10gのオプション・フィールド

- 12.2.5 インバウンドおよびアウトバウンド・パートナ・アグリーメント

- 12.2.6 RosettaNetアウトバウンド・メッセージ

- 12.3 Oracle B2B 11gのアップグレード後タスク

- 12.3.1 インバウンドおよびアウトバウンド・メッセージ用のMLLPチャネルの構成

- 12.3.2 Oracle B2Bメタデータの移行

- 12.3.3 B2B関連のOracle BPELプロセスのアップグレード時の考慮事項

13 Oracle Web Services ManagerのポリシーおよびOC4Jセキュリティ環境のアップグレード

- 13.1 Oracle Web Services Manager(WSM)のポリシーのアップグレード

- 13.1.1 アップグレード前のタスク

- 13.1.1.1 Oracle WSM 10gのゲートウェイに関する注意

- 13.1.1.2 サード・パーティ・ソフトウェアに関する注意

- 13.1.2 Oracle WSM 10gの事前定義ポリシーのアップグレード

- 13.1.3 Oracle WSMのカスタム・ポリシーのアップグレード

- 13.2 Oracle Containers for J2EE(OC4J)セキュリティ環境のアップグレード

- 13.2.1 アップグレード前のタスク

- 13.2.2 メッセージ保護付き匿名認証(WS-Security 1.0)

- 13.2.2.1 OC4J 10g

- 13.2.2.2 Oracle WSM 11g

- 13.2.3 メッセージ整合性付き匿名認証(WS-Security 1.0)

- 13.2.3.1 OC4J 10g

- 13.2.3.2 Oracle WSM 11g

- 13.2.4 メッセージの機密保持付き匿名認証(WS-Security 1.0)

- 13.2.4.1 OC4J 10g

- 13.2.4.2 Oracle WSM 11g

- 13.2.5 メッセージ保護付きユーザー名トークン(WS-Security 1.0)

- 13.2.5.1 OC4J 10g

- 13.2.5.2 Oracle WSM 11g

- 13.2.6 メッセージ保護付きSAMLトークン(送信者保証)を使用したID伝播(WS-Security 1.0)

- 13.2.6.1 OC4J 10g

- 13.2.6.2 Oracle WSM 11g

- 13.2.7 メッセージ保護付きSAMLトークン(キーのホルダー)を使用したID伝播(WS-Security 1.0)

- 13.2.7.1 OC4J 10g

- 13.2.7.2 Oracle WSM 11g

- 13.2.8 メッセージ保護付き相互認証(WS-Security 1.0)

- 13.2.8.1 OC4J 10g

- 13.2.8.2 Oracle WSM 11g

- 13.2.9 SSL上のユーザー名トークン

- 13.2.9.1 OC4J 10g

- 13.2.9.2 Oracle WSM 11g

- 13.2.10 SSL上のSAMLトークン(送信者保証)を使用したID伝播(WS-Security 1.0)

- 13.2.10.1 OC4J 10g

- 13.2.10.2 Oracle WSM 11g

- 13.2.11 ログ情報

- 13.2.11.1 OC4J 10g

- 13.2.11.2 Oracle WSM 11g

14 その他のOracle SOA Suiteテクノロジのアップグレード

- 14.1 Oracle Enterprise Service Busに関連するアップグレード・タスク

- 14.1.1 サービスとして公開されないOracle Enterprise Service Busルーティング・ルールのアップグレード

- 14.1.2 Oracle Enterprise Service Busのドメイン値マップ(DVM)と相互参照のアップグレード

- 14.1.3 SOAPヘッダーのあるOracle Enterprise Service BusプロジェクトのOracle Mediator 11gへのアップグレード

- 14.1.4 同じネームスペースを使用する複数のルーティング・サービスを持つプロジェクトのアップグレード

- 14.1.5 非同期ルーティングを使用するためのルーティング・サービスのアップグレード

- 14.1.6 Oracle Enterprise Service Busのメッセージ・ヘッダーのフィルタリングまたは設定のアップグレード

- 14.1.7 ESBプロジェクトをアップグレードする前の「ESBサーバーと同期」コマンドの使用

- 14.2 Technology Adaptersに関連するアップグレード・タスク

- 14.2.1 Oracle JDeveloper 11gのアダプタ構成ウィザードを使用したアダプタの確認

- 14.2.2 アダプタ・ヘッダー変数のアップグレード

- 14.2.3 アダプタJCAファイルの非管理接続情報のアップグレード

- 14.2.4 Technology Adapterのアップグレード後の説明の欠落

- 14.2.5 インバウンド同期リクエスト/リプライ・ユースケースのアップグレード

- 14.2.6 アウトバウンド・デキューを使用するプロジェクトのアップグレード

- 14.2.7 AQアダプタ・ヘッダーのアップグレード

- 14.2.8 Technology Adapterヘッダーをアップグレードする際のその他のステップ

- 14.2.9 ペイロード・ヘッダー機能に依存するコンポジット・アプリケーションのアップグレード

- 14.2.10 AQアウトバウンド・リクエスト/リプライ・シナリオのアップグレード

- 14.2.11 ストアド・プロシージャに使用されるデータベース・アダプタのアップグレード

- 14.3 ヒューマン・ワークフロー・タスクに関連するアップグレード・タスク

- 14.3.1 関連するヒューマン・ワークフロー・タスクのタスク詳細のアップグレード

- 14.3.2 共通ヒューマン・ワークフロー・タスクを共有する複数プロジェクトのアップグレード

- 14.3.3 アップグレード後のヒューマン・ワークフロー・タスクの編集

- 14.4 Oracle Business Rulesに関連するアップグレード・タスク

- 14.5 Oracle SOA Suiteクライアント・アプリケーションのアップグレード

15 Oracle WebCenterアプリケーションのアップグレード時の考慮事項

- 15.1 WebCenterアプリケーションのアップグレードについて

- 15.1.1 WebCenterアプリケーションのアップグレードに関するタスク

- 15.1.2 WebCenterアプリケーションのテンプレートについて

- 15.2 WebCenterアプリケーションのアップグレードの前提条件

- 15.3 WebCenterコンシューマ・アプリケーションのアップグレード

- 15.3.1 アプリケーションのアップグレード準備

- 15.3.1.1 アプリケーションのバックアップ

- 15.3.1.2 Oracle Content DBに依存しているアプリケーションの準備

- 15.3.1.3 ポートレットが含まれているアプリケーションの準備

- 15.3.2 WebCenterアプリケーションのアップグレード

- 15.3.3 アプリケーションのアップグレード後タスクの実行

- 15.3.3.1 カスタマイズ可能なコンポーネントのアプリケーション設定の構成

- 15.3.3.2 アプリケーションのMDSからプロジェクト・ディレクトリへのリソース・カタログの移動

- 15.3.3.3 Oracle Portal接続のアップグレード

- 15.3.3.4 ADFセキュリティの構成

- 15.3.3.5 事前構成済ポートレット・プロデューサのプロデューサ登録のアップグレード

- 15.3.3.6 アプリケーションの再デプロイ

- 15.4 ポートレット・プロデューサのアップグレード

- 15.4.1 WebCenterコンシューマ・アプリケーションとポートレット・プロデューサの互換性の判断

- 15.4.2 ポートレット・プロデューサ・アプリケーションのアップグレード

- 15.4.2.1 JSR168ポートレット・プロデューサのJSR286へのアップグレードについて

- 15.4.2.2 JDeveloperで作成されたポートレット・プロデューサのアップグレード

- 15.4.2.3 JDeveloper以外で作成されたポートレット・プロデューサのアップグレード

- 15.4.2.3.1 EARファイルからのJDeveloperアプリケーションの作成

- 15.4.2.3.2 WARファイルからのJDeveloperアプリケーションの作成

- 15.4.2.4 事前構成されたポートレット・プロデューサのアップグレード

- 15.4.2.4.1 デフォルトの場所からのカスタマイズ内容の移行

- 15.4.2.4.2 デフォルト以外の場所からのカスタマイズ内容の移行

- 15.4.3 ポートレット・プロデューサのアップグレード後タスクの実行

- 15.4.3.1 カスタマイズ内容の移行

- 15.4.3.2 ポートレット・プロデューサ・アプリケーションの再デプロイ

- 15.5 データの移行

- 15.5.1 Oracle WebCenter Wiki and Blog Serverからのデータの移行

- 15.5.2 Oracle Content DBからのデータの移行

16その他のOracle WebCenterアップグレードの詳細

- 16.1 アップグレード後のWebCenterアプリケーションの自動変更

- 16.1.1 カスタマイズ可能コンポーネントの変更

- 16.1.1.1 一般的な変更

- 16.1.1.2 Panel Customizableの変更

- 16.1.1.3 Show Detail Frame

- 16.1.2 外部アプリケーションの変更

- 16.1.2.1 Oracle Application Server 10gとOracle Fusion Middleware 11g間の外部アプリケーションの変更の概要

- 16.1.2.2 外部アプリケーションのアップグレードに関する変更

- 16.1.3 ポートレット・コンポーネントの変更

- 16.1.3.1 ポートレット・タグの変更

- 16.1.3.2 属性変更

- 16.2 コンテンツ統合接続: 外部アプリケーションへの資格証明の移行

- 16.3 事前構成されたポートレット・プロデューサ: カスタマイズ内容の保存先

- 16.3.1 WSRPポートレット・プロデューサ

- 16.3.2 Webクリッピング・ポートレット・プロデューサ

- 16.3.3 OmniPortletおよびその他のPDK-Javaポートレット・プロデューサ

- 16.3.4 OmniPortletリポジトリの変更

- 16.4 JSR 168ポートレット・プロデューサのJSR 286への移行: ポートレット要素の処理

A 例: SOA Order Bookingのアップグレードと再デプロイ

- A.1 SOA Order Bookingアプリケーションについて

- A.2 タスク1: SOA Order Bookingと外部パートナが稼働していることの確認

- A.2.1 タスク1a: SOA Order BookingがOracle Application Server 10g リリース3(10.1.3.4)に正常にデプロイされていることの確認

- A.2.2 タスク1b: SOA Order BookingがOracle Application Server 10g リリース3(10.1.3.4)で現在稼働していることの確認

- A.2.3 タスク1c: すべての外部パートナが使用可能であることの確認

- A.3 タスク2: Oracle Fusion Middleware SOA Suiteのインストールとアップグレード

- A.4 タスク3: Oracle WebLogic Suite管理コンソールを使用した必要なリソースの構成

- A.4.1 タスク3a: SOADEMOデータ・ソースの作成

- A.4.2 タスク3b: DbAdapterアプリケーションの構成

- A.4.2.1 DbAdapterアプリケーションの新規アウトバウンド接続プールの作成

- A.4.2.2 DbAdapterアプリケーションの新規接続プールの構成

- A.4.3 タスク3c: SOA Order Booking JMSリソースの作成

- A.4.3.1 SOA Order Bookingデモ用のJMSキューの作成

- A.4.3.2 SOA Order Bookingデモ用のJMSコネクション・ファクトリの作成

- A.4.3.3 JmsAdapterアプリケーション用のアウトバウンド接続プールの作成

- A.4.3.4 JmsAdapter接続プールの構成

- A.4.3.5 変更されたJmsAdapterアプリケーションの再デプロイ

- A.5 タスク4: Oracle JDeveloper 11gのインストール

- A.6 タスク5: Oracle JDeveloperリリース11の接続の設定

- A.6.1 タスク5a: Oracle JDeveloper 11gの起動

- A.6.2 タスク5b: 必要なOracle JDeveloper拡張機能があることの確認

- A.6.3 タスク5c: SOADEMOスキーマへの接続の作成

- A.6.4 タスク5d: Oracle WebLogic Serverへの接続の作成

- A.7 タスク6: SOA Order BookingアプリケーションをOracle JDeveloper 11gで開き、アプリケーション・プロジェクトを移行

- A.7.1 アプリケーションを開いて移行

- A.7.2 移行ログ・ファイルの表示

- A.8 タスク7: Oracle Fusion Middleware 11gでの各アプリケーション・プロジェクトのコンパイルとデプロイ

- A.8.1 CreditService、RapidServiceおよびCustomerServiceプロジェクトについて

- A.8.2 SelectManufacturer

- A.8.3 DHLShipment

- A.8.4 FulfillmentESB

- A.8.4.1 Oracle JDeveloper 11gでのFulfillmentESBプロジェクトの変更

- A.8.4.2 FulfillmentESBプロジェクトのコンパイルおよびデプロイ

- A.8.5 CreditService

- A.8.5.1 CreditService Webサービスのアップグレード

- A.8.5.2 CreditServiceプロジェクトのコンパイルおよびデプロイ

- A.8.6 RapidService

- A.8.6.1 RapidService WebサービスのOC4J JAX-RPCからOracle WebLogic Server JAX-WSへのアップグレード

- A.8.6.2 RapidServiceプロジェクトのコンパイルおよびデプロイ

- A.8.7 CustomerService

- A.8.7.1 特定のCustomerServiceプロジェクト・クラス・ファイルの変更

- A.8.7.2 CustomerServiceプロジェクトのpersistence.xmlファイルの変更

- A.8.7.3 CustomerServiceプロジェクトのコンパイルおよびデプロイ

- A.8.8 SOAOrderBooking

- A.8.8.1 SOAOrderBookingプロジェクトの変更

- A.8.8.2 (オプション)アップグレードされたWebサービスを使用するためのSOAOrderBookingの変更

- A.8.8.3 SOAOrderBookingプロジェクトのコンパイルおよびデプロイ

- A.8.9 OrderBookingESB

- A.8.9.1 OrderBookingESBプロジェクトの変更

- A.8.9.2 OrderBookingESBプロジェクトのコンパイルおよびデプロイ

- A.8.10 ApproveOrderTaskForm

- A.9 タスク8: Fusion Middleware ControlでのSOA Order Bookingアプリケーションのテスト

B Oracle Business Rulesのディクショナリおよびプロジェクトのアップグレード

- B.1 Oracle JDeveloperを使用したOracle Business Rulesディクショナリの移行

- B.2 ルール・マイグレータ・ツールを使用したOracle Business Rulesディクショナリの移行

- B.3 MigrateRuleRepositoryとOracle Business Rules SDKを使用したディクショナリの移行

- B.3.1 Oracle Business Rules SDKを使用したディクショナリの移行方法

- B.3.2 MigrateRuleRepository APIについての留意事項

- B.3.2.1 入力プロパティ

- B.3.2.2 出力プロパティ

- B.4 Oracle Business Rulesの手動移行タスク

- B.4.1 JAXB 1.0からJAXB 2.0への移行方法

- B.4.2 RL関数の移行方法

- B.4.3 手動移行についての留意事項

Oracle® Fusion Middleware

Oracle SOA Suite、WebCenter PortalおよびADFアップグレード・ガイド

11g リリース1 (11.1.1.6.0)

B55926-05(原本部品番号:E10127-06)

2012年7月

Oracle Fusion Middleware Oracle SOA Suite、WebCenter PortalおよびADFアップグレード・ガイド, 11g リリース1 (11.1.1.6.0)

B55926-05

Copyright © 2009, 2012, Oracle and/or its affiliates.All rights reserved.

原本著者:  Showvik Roychowdhuri

原本協力著者: Liz Lynch, Savita Thakur, Thomas Van Raalte

原本協力者: Tal Broda, Paul Dickson, Robert Donat, Bruno Henriques, Jay Kasi, Yogeshwar Kuntawar, HT Ma, Sankar Mani, Michael Meiner, William Norcott, Sundari Revanur, Michael Rubino, Reza Shafii, Vishal Sharma, Sitaraman Swaminathan, Arun Thomas

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

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

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

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 Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

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

はじめに

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

- 対象読者

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

- 関連ドキュメント

- 表記規則

対象読者

このマニュアルは、Oracle Fusion Middlewareインスタンスのインストール、保守およびアップグレードを担当するOracle Fusion Middlewareシステム管理者を対象としています。ここでは、読者に次の知識があることを前提としています。

- Oracle Fusion Middlewareのシステム管理および構成

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

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

オラクル社のアクセシビリティへの取組みの詳細は、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=accid=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=accid=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

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

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

- 『Oracle Fusion Middleware Oracle SOA Suite and Oracle Business Process Management Suiteインストレーション・ガイド』

- Oracle Fusion Middlewareの管理者ガイド

注意:

Oracle Fusion Middlewareのアップグレードに関するドキュメントの詳細は、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のミドルウェア環境のアップグレードに関するドキュメント・ロードマップの項を参照してください。

表記規則

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

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

1 Oracle SOA Suite、WebCenterおよびADFのアップグレード処理の概要

この章では、Oracle SOA Suite、WebCenterおよびADF のアップグレード処理の概要を説明します。詳細は、次の各項を参照してください。

- Oracle SOA Suite、WebCenterおよびADFのアップグレード処理のフロー・チャート

- Oracle SOA SuiteおよびWebCenterのアップグレード処理における各ステップの説明

1.1 Oracle SOA Suite、WebCenterおよびADFのアップグレード処理のフロー・チャート

図1-1に、Oracle SOA、WebCenterおよびADFのアップグレード処理のフロー・チャートを示します。このチャートを確認して、実行する必要のあるタスクを理解しておきます。手順は、既存のOracle Application Serverのバージョンによって異なります。

図1-1 Oracle SOA SuiteおよびWebCenterのアップグレード処理のフロー・チャート

「図1-1 Oracle SOA SuiteおよびWebCenterのアップグレード処理のフロー・チャート」の説明

1.2 Oracle SOA SuiteおよびWebCenterのアップグレード処理における各ステップの説明

表1-1では、図1-1に示したアップグレード処理のフロー・チャートの各ステップについて説明します。この表では、処理における各ステップの詳細について、その参照先も示します。

表1-1 Oracle SOA SuiteおよびWebCenterのアップグレード処理における各ステップの説明

ステップ

説明

詳細情報

『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』の概要を確認

『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』には、既存のOracle Application Server 10g環境全体をOracle Fusion Middlewareにアップグレードする方法の概要が記載されています。

また、互換性情報やミドルウェア・コンポーネントをサポートとするデータベースのアップグレード方法についても説明しています。

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

開始点と11gのトポロジを確認

アップグレードを実施する前に、新機能、サポートされている開始点、Oracle Fusion Middleware 11gの推奨トポロジについて理解する必要があります。

Oracle Fusion Middleware 11gでは、Oracle WebLogic Serverベースの新しいアーキテクチャが採用されました。アップグレードを開始する前に、11gの新機能に習熟しておく必要があります。

第I部「Oracle SOA Suite、WebCenterおよびADFのアップグレード準備」

第3章「10gユーザーのためのOracle SOA Suite、WebCenterおよびADFの情報」

SOAおよびWebCenterスキーマ用のデータベースを準備

Oracle SOA SuiteおよびWebCenterコンポーネントにはスキーマが必要で、これらのスキーマをデータベースにインストールする必要があります。

そのため、SOAまたはWebCenter環境のアップグレードを開始する前に、使用しているデータベースがサポート対象のバージョンであるかを確認し、Oracle Fusion Middlewareのメタデータ・リポジトリ作成ユーティリティを使用して新しい11gスキーマをインストールする必要があります。

SOA環境

- 第6.2項「タスク2: Oracle SOA SuiteスキーマをホストするOracleデータベースのアップグレード(必要な場合)」

- 第6.3項「タスク3: リポジトリ作成ユーティリティによる11g SOAスキーマのインストール」

WebCenter環境

- 第7.2項「タスク2: WebCenterスキーマをホストするOracleデータベースのアップグレード(必要な場合)」

- 第7.3項「タスク3: リポジトリ作成ユーティリティによるOracle WebCenter Portal 11gスキーマのインストール」

BPEL長時間実行プロセスに対する方針を検討

Oracle BPEL Process Manager長時間実行プロセスをサポートしている場合、Oracle SOA Suite環境をアップグレードする際のオプションについて検討してください。

第4章「Oracle BPEL長時間実行プロセスに関する特別な考慮事項」

11g SOA、WebCenterまたはADFをインストールしてMiddlewareホームを作成

適切なソフトウェア・ツールを使用して、次のタスクを実行します。

- Oracle WebLogic ServerのインストールとMiddlewareホームの作成

- Oracle Fusion MiddlewareソフトウェアのインストールとOracleホームの作成

- 最新のFusion Middlewareパッチ・セットの適用

- ドメインの構成

- ドメインの確認

SOA環境

- 第6.4項「タスク4: Oracle SOA Suite 11g中間層のインストールと構成」

WebCenter環境

- 第7.4項「タスク4: Oracle WebCenter Portal 11g中間層のインストールと構成」

ADF環境

- 第5.2項「タスク2: ADFアプリケーションに使用するOracle WebLogic Serverドメインのインストールおよび構成」

アップグレード・アシスタントを使用してSOAスキーマをアップグレード

Oracle Business Activity MonitoringまたはOracle B2Bを使用している場合、アップグレード・アシスタントを使用してBAMおよびB2Bのスキーマをアップグレードします。

第6.5項「タスク5: SOAコンポーネントのスキーマのアップグレード(必要な場合)」

アプリケーションをサポートするようにWebLogic Server構成タスクを実行

Oracle WebLogic Serverのプロパティまたは設定を手動で変更します。データ・ソースやアプリケーションに必要なその他のJava EEリソースを作成します。

『Oracle Fusion Middleware Java EEアップグレード・ガイド』

SOAまたはWebCenterの手動構成タスクを実行

Oracle SOAまたはWebCenterアプリケーションをサポートするために、新しいOracle WebLogic Server環境で構成タスクの実行が必要になることがあります。

ADF環境を説明どおりにインストールして構成している場合は、ADFアプリケーションをサポートするために手動の構成タスクが必要になることはほとんどありません。

第9章「すべてのOracle SOAアプリケーションのアップグレード時の考慮事項」

第15章「Oracle WebCenterアプリケーションのアップグレード時の考慮事項」

11g Web層をインストールおよび構成

適切なソフトウェア・インストーラおよび構成ウィザードを使用して、Oracle HTTP ServerとOracle Web Cache Web層コンポーネントをインストールして構成します。

『Oracle Fusion Middleware Java EEアップグレード・ガイド』のタスク1: Oracle HTTP Server (OC4Jあり)の使用方法とOracle WebLogic Serverの使用方法の違いに関する項

アップグレード・アシスタントを使用してWeb層コンポーネントをアップグレード

Oracle Fusion Middlewareアップグレード・アシスタントを使用して、既存のOracle Application Server Web層コンポーネントから新しくインストールしたOracle Fusion Middleware Web層コンポーネントに構成データをコピーします。

『Oracle Fusion Middleware Java EEアップグレード・ガイド』のWebサーバーおよびJava EE環境のアップグレードに関する項

Oracle JDeveloper 11gをインストールおよび構成

Oracle JDeveloper 11g リリース1 (11.1.1.6.0)は、Oracle Technology Network(OTN)からダウンロードするか、またはOracle Fusion Middlewareに付属しているCDからZIPファイルをコピーできます。

第8.5項「タスク5: Oracle JDeveloper 11gのインストールと起動」

Oracle JDeveloperリリース11gでアプリケーションを開いて移行

Oracle JDeveloper 11gには、Oracle Application Server 10gアプリケーションをOracle Fusion Middleware 11g リリース1 (11.1.1.6.0)用に再コンパイルできるようにするための変換を支援する移行機能が用意されています。

第8.6項「タスク6: Oracle JDeveloperでアプリケーションを開いてアップグレード」

アプリケーション・プロジェクトを再コンパイル

JDeveloper 11gを使用してアプリケーション・ソースを再コンパイルし、コンパイル・エラーがないかどうかを確認する必要があります。

第8.8項「タスク8: アプリケーションの確認および再コンパイル」

Oracle Fusion Middleware 11gでアプリケーションを正常に実行するのに必要なその他のコード変更を実装

アプリケーションに必要な特定のテクノロジまたはサービスを識別し、考慮事項を確認します。

アプリケーションをOracle Fusion Middleware 11gへ再デプロイ

JDeveloperを使用してアプリケーションをデプロイするか、あるいはEARファイルを作成し、asctlコマンドラインまたはOracle Enterprise Manager Fusion Middleware Controlを使用してアプリケーションをデプロイできます。

第8.9項「タスク9: アプリケーションのデプロイ」

再デプロイしたアプリケーションを検証

再デプロイしたアプリケーションが適切に動作し、再デプロイ時にエラーが発生していないことを確認します。

なし

第I部

Oracle SOA Suite、WebCenterおよびADFのアップグレード準備

第I部は次の章で構成されています。

- 第2章「Oracle SOA Suite、WebCenterおよびADFのサポートされるアップグレードの開始点」

- 第3章「10gユーザーのためのOracle SOA Suite、WebCenterおよびADFの情報」

- 第4章「Oracle BPEL長時間実行プロセスに関する特別な考慮事項」

2 Oracle SOA Suite、WebCenterおよびADFのサポートされるアップグレードの開始点

Oracle SOA Suite、WebCenterおよびADF 11gのサポートされるアップグレードの開始点の詳細は、次の項を参照してください。

- Oracle SOA Suite、WebCenterおよびADFのサポートされるアップグレードの開始点の概要

- Oracle SOA Suite 10g リリース2(10.1.2)ユーザー向けの情報

2.1 Oracle SOA Suite、WebCenterおよびADFのサポートされるアップグレードの開始点の概要

このマニュアルでは、表2-1に示すOracle Application Serverの各リリースおよび各インストール・タイプからのアップグレード方法について説明します。

表2-1 このマニュアルでサポートされているリリースとインストール・タイプ

リリース

インストール・タイプ

説明または注意

最新のパッチセット

10g リリース3 (10.1.3.1.0)

すべてのインストール・タイプ

このリリースで、Oracle SOA Suiteのコンポーネントが組み込まれました。

10g リリース3 (10.1.3.5)

10g リリース3 (10.1.3.2.0)

すべてのインストール・タイプ

このリリースで、Oracle WebCenterのコンポーネントが組み込まれました。

10g リリース3 (10.1.3.5)

表2-1に示したパッチセットは、このマニュアルが発行された時点で使用可能であった最新のパッチセットです。インストールに使用可能な最新のパッチセットのリストについては、次のMy Oracle Support(旧称OracleMetaLink)を参照してください。

http://support.oracle.com/

注意:

現在Oracle Fusion Middleware 11gを実行している場合は、Oracle Fusion Middlewareパッチ・ガイドを参照してください。このマニュアルには、最新のOracle Fusion Middlewareパッチの適用に関する情報が記載されています。

このドキュメントでは、Oracle Fusion Middleware 11gのドキュメント・ライブラリで提供されている他のアップグレード・ガイドと同様に、Oracle Application Server 10gから最新のOracle Fusion Middleware 11g リリースにアップグレードするための手順が説明されています。

2.2 Oracle SOA Suite g リリース2 (10.1.2)ユーザー向けの情報

Oracle BPEL Process ManagerまたはOracle BAM 10g リリース2 (10.1.2)を使用する場合は、プロジェクトを10g リリース3 (10.1.3)に移行した後に、Oracle Fusion Middleware 11gにアップグレードする必要があります。Oracle BPEL Process Manager 10g リリース2 (10.1.2)を10g リリース3 (10.1.3)に移行する方法の詳細は、次を参照してください。

- 10gリリース3 (10.1.3.1)の『Oracle BPEL Process Managerインストレーション・ガイド』のOracle BPEL Process Managerの移行に関する項

- 10gリリース3 (10.1.3.1)の『Oracle BPEL Process Manager開発者ガイド』のワークフロー定義の10.1.2から10.1.3.1への移行に関する項

3 10gユーザーのためのOracle SOA Suite、WebCenterおよびADFの情報

この章では、Oracle Fusion Middleware 11gで使用できるOracle SOA Suite、WebCenterおよびADFソフトウェアの概要を示します。次の項では、これらのテクノロジのアーキテクチャとディレクトリ構造について、10g リリース3(10.1.3)とOracle Fusion Middleware 11gで比較しています。

- Oracle ADFユーザー向けの情報

- Oracle SOA Suiteユーザー向けの情報

- Oracle WebCenterユーザー向けの情報

3.1 Oracle ADFユーザー向けの情報

Oracle Application Server 10g リリース3 (10.1.3)で提供されていたOracle Application Development Framework (ADF)は、Java EE標準に準拠して構築されたエンドツーエンドのアプリケーション・フレームワークであり、サービス指向アプリケーションの実装を簡素化し加速化する、オープンソースのテクノロジでした。

ADFアプリケーションのデプロイと管理に必要な開発環境と実行時環境は、多くの点で他のJava EEアプリケーションで必要とされる環境と似ています。10gで使用できるJava EE環境の種類と、これらの環境をOracle Fusion Middleware 11gにアップグレードする方法の詳細は、『Oracle Fusion Middleware Java EEアップグレード・ガイド』を参照してください。

一般的なJava EE環境とADFアプリケーションがサポートされる環境の違いは、 ADFランタイム・ライブラリが使用可能かどうかです。

- Oracle Application Server 10gでは、ADFアプリケーションのサポートに必要なADFランタイム・ライブラリがOC4Jの各インスタンスで自動的に提供されました。

- Oracle Fusion Middleware 11gでは、ADFランタイム・ライブラリは、Oracle WebLogic Serverドメインにデフォルトでは含まれていません。ただし、任意にドメインを構成または拡張し、Javaランタイム・ファイル(JRF)を含めることができます。Oracle ADFランタイム・ライブラリは、JRFコンポーネントの一部として含まれます。

図3-1では、OC4JとOracle WebLogic ServerにおけるOracle ADFアプリケーションのサポート方法を比較しています。Oracle WebLogic ServerドメインはJavaランタイム・ファイル(JRF)ドメイン・テンプレートを使用して拡張できます。このテンプレートには、必要なOracle ADFライブラリと他の重要なOracle固有テクノロジが含まれています。

図3-1 OC4JおよびOracle WebLogic ServerにおけるOracle ADFアプリケーションのサポート

「図3-1 OC4JおよびOracle WebLogic ServerにおけるOracle ADFアプリケーションのサポート」の説明

Oracle ADFをサポートするドメインの拡張の詳細は、『Oracle Fusion Middleware管理者ガイド』の第17章「環境のスケーリング」を参照してください。

Oracle Application Server 10gとは異なり、Oracle HTTP Serverは、Oracle WebLogic Serverへのリクエストをルーティングするために自動的にインストールおよび構成されるわけではありません。かわりに、Web層およびユーティリティのCD-ROMを使用して、Oracle HTTP ServerおよびOracle Web Cacheを別のOracleホームにインストールします。詳細は、『Oracle Fusion Middleware Java EEアップグレード・ガイド』のWebサーバーおよびJava EE環境のアップグレードに関する項を参照してください。

3.2 Oracle SOA Suiteユーザー向けの情報

Oracle Application Server 10g リリース3 (10.1.3)で用意されていたインストール・オプションでは、(Oracle BAMを除く)Oracle Service Oriented Architecture (SOA)システム・コンポーネントをOracle Application Serverインストールの一部としてインストールおよび構成できました。その後で、Oracle JDeveloperを使用して、SOAコンポーネントがインストールされているOC4Jインスタンス上で、SOAアプリケーションを開発およびデプロイすることができました。

Oracle Fusion Middlewareの場合も同様に、Oracle SOAインフラストラクチャと、Oracle BAMを含むシステム・コンポーネントをサポートする Oracle WebLogic Serverドメインをインストールおよび構成できます。

詳細は、次の各項を参照してください。

- OC4JとOracle WebLogic ServerにおけるOracle SOA Suiteの比較

- OC4JとOracle WebLogic ServerにおけるOracle SOA Suiteディレクトリ構造の比較

- Oracle SOA Suiteエンタープライズ・デプロイメントのアップグレード

- Oracle Application Server 10gおよびOracle Fusion Middleware 11gにおけるOracle BAMおよびOracle B2B

3.2.1 OC4JとOracle WebLogic ServerにおけるOracle SOA Suiteの比較

図3-2は、SOAシステム・コンポーネントがOC4J 10gインスタンスの一部としてどのようにインストールされるかと、Oracle Fusion Middleware Oracle SOA Suite 11gをインストールし構成した場合にSOAコンポーネントが管理対象サーバーにどのようにインストールされるかを示し、比較しています。

SOAシステム・コンポーネントには一連のSOAスキーマが必要です。これはリポジトリ作成ユーティリティ(RCU)を使用してインストールします。RCUによりインストールされるスキーマの詳細は、『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

図3-2 OC4JインスタンスとOracle WebLogic ServerドメインにインストールされるOracle SOA Suite

「図3-2 OC4JインスタンスとOracle WebLogic ServerドメインにインストールされるOracle SOA Suite」の説明

3.2.2 OC4JとOracle WebLogic ServerにおけるOracle SOA Suiteディレクトリ構造の比較

Oracle SOA Suiteをインストールして構成する際、SOAシステム・コンポーネントをサポートするよう拡張したOracle WebLogic Serverドメインを作成します。結果として、ディスク上のファイルは、SOAドメイン・ディレクトリ構造と、SOAコンポーネントのバイナリ・ファイルおよびサポート・ファイルを含むSOA Oracleホーム、Oracle Enterprise Manager Fusion Middleware ControlおよびJava Required Files(JRF)を含むOracle共通ホームの構成になります。

SOA Oracleホームは、 Middlewareホーム内にインストールする必要があります。Oracle comonは自動的にインストールされます。

これは、Oracle Application Server 10g リリース3 (10.1.3)のインストール時にOracleホームが単独で作成されていたことと対照的です。

図3-3は、Oracle SOA Suiteドメインのインストールおよび構成後のディレクトリ構造を示しています。

図3-3 Oracle Fusion Middleware SOA Suiteインストール後のディレクトリ構造

「図3-3 Oracle Fusion Middleware SOA Suiteインストール後のディレクトリ構造」の説明

3.2.3 Oracle SOA Suiteエンタープライズ・デプロイメントのアップグレード

このマニュアル内の手順は、基本的なOracle SOA Suite環境をアップグレードするステップを示しています。このマニュアルの内容を確認した後は、この知識をより複雑な本番環境に適用できます。

クラスタ化と高可用性を利用した本番環境を設定する手順の詳細は、『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』を参照してください。

エンタープライズ・デプロイメントのアップグレード時に実行する必要がある主なタスクの概要は、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のエンタープライズ・デプロイメントの計画に関する項を参照してください。

3.2.4 Oracle Application Server 10gおよびOracle Fusion Middleware 11gにおけるOracle BAMおよびOracle B2B

Oracle BAM 10gおよびOracle B2Bは、その他のOracle SOA Suiteコンポーネントとは異なり、個別にインストールおよび構成されていました。

Oracle BAMはMicrosoftプラットフォームでのみサポートされ、Oracle B2Bは他のOracle SOA Suite 10gコンポーネントとは別のサーバーにインストールされていました。

Oracle Fusion Middleware 11gでは、Oracle BAM 11gとOracle B2B 11gは、その他のOracle SOA Suiteコンポーネントと統合されています。Oracle BAMは同じOracle WebLogic Serverドメインの一部としてデプロイでき、Oracle B2Bはその他のOracle SOA Suiteコンポーネントとともに自動でインストールおよび構成されます。

3.3 Oracle WebCenterユーザー向けの情報

Oracle Application Server 10g リリース3 (10.1.3)で用意されていたインストール・オプションでは、WebCenterシステム・コンポーネントをOracle Application Serverインストールの一部としてインストールおよび構成できました。その後で、Oracle JDeveloperを使用して、WebCenterシステム・コンポーネントがインストールされているOC4Jインスタンス上で、WebCenterアプリケーションを開発およびデプロイすることができました。

Oracle Fusion Middlewareの場合も同様に、WebCenterシステム・コンポーネントをサポートするOracle WebLogic Serverドメインをインストールおよび構成できます。

詳細は、次の各項を参照してください。

- Oracle WebCenterおよびOracle Enterprise Content Management Suiteの新規製品名

- OC4JとOracle WebLogic ServerにおけるOracle WebCenterの比較

- OC4JとOracle WebLogic ServerにおけるOracle WebCenterディレクトリ構造の比較

3.3.1 Oracle WebCenterおよびOracle Enterprise Content Management Suiteの新規製品名

Oracle Fusion Middleware 11g リリース1 (11.1.1.6.0)では、Oracle WebCenterとOracle Universal Content Managementがリブランドされました。表3-1は、古い製品名および用語と新しい製品名および用語の対応を示します。

注意:

このガイドでは、製品名がリリース番号11.1.1.6.0または11gで修飾されているか、11.1.1.6.0固有の機能について解説している場合以外は古い用語を使用します。

表3-1 古い用語とリリース11.1.1.6.0用語の対応

旧名称

リリース11.1.1.6.0での新名称

製品名の変更

Oracle WebCenter

Oracle WebCenter Portal

Oracle Universal Content Management

Oracle WebCenter Content

Oracle Content Server

Oracle WebCenter Contentサーバー

Oracle WebCenter Discussions

Oracle WebCenter PortalのDiscussion Server

ドキュメント内の機能名変更

WebCenterアプリケーション

WebCenter Portal: Frameworkアプリケーション/Frameworkアプリケーション

WebCenterポータル・アプリケーションは、Frameworkアプリケーション、ポートレット・プロデューサ・アプリケーションおよびSpacesアプリケーションの包括的な用語です。

WebCenterドメイン

WebCenter Portalドメイン

3.3.2 OC4JとOracle WebLogic ServerにおけるOracle WebCenterの比較

図3-4は、Oracle WebCenterシステム・コンポーネントがOC4J 10gインスタンスの一部としてどのようにインストールされるかと、Oracle Fusion Middleware 11gをインストールし構成した場合にOracle WebCenterコンポーネントが管理対象サーバーにどのようにインストールされるかを示し、比較しています。

WebCenterシステム・コンポーネントには一連のWebCenterスキーマが必要です。これはリポジトリ作成ユーティリティ(RCU)を使用してインストールします。RCUによりインストールされるスキーマの詳細は、『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

図3-4 OC4JとOracle WebLogic ServerにインストールされたOracle WebCenter

「図3-4 OC4JとOracle WebLogic Server上にインストールされたOracle WebCenter」の説明

3.3.3 OC4JとOracle WebLogic ServerにおけるOracle WebCenterディレクトリ構造の比較

Oracle WebCenterをインストールして構成する際、WebCenterシステム・コンポーネントをサポートするよう拡張したOracle WebLogic Serverドメインを作成します。結果として、ディスク上のファイルは、WebCenterドメイン・ディレクトリ構造と、WebCenterコンポーネントのバイナリ・ファイルおよびサポート・ファイルを含むWebCenter Oracleホームの構成になります。WebCenter Oracleホームは、SOA Oracleホームと同様に、Middleware Oracleホーム内に作成する必要があります。

これは、Oracle Application Server 10g リリース3(10.1.3)のインストール時にOracleホームが単独で作成されていたことと対照的です。

図3-5は、Oracle SOA Suiteドメインのインストールおよび構成後のディレクトリ構造を示しています。

図3-5 Oracle Fusion Middleware WebCenterインストール後のディレクトリ構造

「図3-5 Oracle Fusion Middleware WebCenterインストール後のディレクトリ構造」の説明

4 Oracle BPEL長時間実行プロセスに関する特別な考慮事項

Oracle SOA Suite 11g環境のアップグレードを始める前に、この章の情報を使用して、Oracle BPEL Process Manager長時間実行プロセスに対するアップグレードの影響を考慮する必要があるかどうかを確認してください。

- Oracle BPEL Process Manager長時間実行プロセスとは

- 長時間実行プロセスの2通りのアップグレード方法

4.1 Oracle BPEL Process Manager長時間実行プロセスとは

他のBPELプロセスと同様、長時間実行プロセスも、サービスにアクセスして値または結果をOracle BPEL Process Managerに戻します。ただし、他のプロセスと異なる点は、長時間実行プロセスでは値が戻されるまでに比較的長時間かかる場合があることです。

たとえば、外部タスクを起動して顧客注文を処理するように設計されたこのプロセスは、注文の処理を開始する非同期バックエンド・アプリケーションを起動します。バックエンド・アプリケーションは注文の承認のためユーザーと対話します。注文が承認されると、バックエンド・アプリケーションはプロセスへのコールバックを実行し、プロセスはクライアント・アプリケーションへのコールバックを実行します。このタイプの複合プロセスが長時間実行プロセスの一例です。

長時間実行プロセスは、既存のOracle BPEL Process Manager 10g環境を停止するタイミングや、Oracle BPEL Process Manager 11g環境を開始するタイミングを考慮する必要があるため、アップグレード計画に影響を及ぼします。長時間実行プロセスがすべて正常終了してから既存のOracle BPEL Process Manager 10g環境を停止して終了し、11g環境の使用を開始することが理想的です。

4.2 長時間実行プロセスの2通りのアップグレード方法

Oracle SOA Suiteは、広範囲にわたって組織や企業をサポートしています。そのため、すべての環境を満たせる最良のアップグレード戦略を決定することは容易ではありません。しかし、長時間実行プロセスについては、検討できる2つの解決策があります。ここで説明する2つの解決策がすべてのお客様に適しているわけではありません。組織にとってどれが最良の戦略か確信が持てない場合は、これらの解決策の代替となる解決策についてOracleサポートにお問い合せください。

- 長時間実行プロセスに対するアップグレード時の同時並行アプローチの使用

- 長時間実行プロセスに対する猶予期間と強制終了の使用

4.2.1 長時間実行プロセスに対するアップグレード時の同時並行アプローチの使用

長時間実行プロセスに対する同時並行アプローチでは、長時間実行プロセスがタスクを終了するまでOracle Application Server 10g環境を稼働したまま、Oracle Fusion Middleware 11g環境へアップグレードします。

表4-1に、アップグレード時のOracle BPEL Process Manager長時間実行プロセスをサポートする同時並行アプローチを検討している場合に使用するアップグレード処理の概要を示します。

表4-1 長時間実行プロセスに同時並行アプローチを使用するステップ

ステップ番号

タスク

詳細情報

1

新しいOracle Fusion Middleware 11g環境をインストールして構成します。

第6章「Oracle SOA Suite 10g環境のアップグレード」

2

Oracle JDeveloper 11gでアプリケーションをアップグレードします。

第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」

3

Oracle Fusion Middleware 11gにアプリケーションをデプロイします。

第8.9項「タスク9: アプリケーションのデプロイ」

4

クライアント・アプリケーションをコピーしてアップグレードし、Oracle Fusion Middleware 11gにデプロイしたアプリケーションを使用してテストします。

第14.5項「Oracle SOA Suiteクライアント・アプリケーションのアップグレード」

5

Oracle BPEL Process Manager 10gのすべてのプロセスをリタイアします。これにより、新しいプロセスの開始は阻止され、既存の10gプロセスは終了するまで許可されます。

Oracle Application Server 10g リリース3 (10.1.3.1.0)の『Oracle SOA Suite開発者ガイド』にある、プロセス・ライフサイクルの管理方法に関する項(次に示すOracle Technology Network (OTN)から入手できます)

http://www.oracle.com/technology/documentation

6

10gシステムが稼働している状態で10gのクライアント・アプリケーションを停止し、アップグレードしたアプリケーション・クライアントを開始すると、リクエストが新しい11gのOracle BPEL Process Managerに送られます。

Oracle Fusion Middlewareの管理者ガイドにある、Oracle Fusion Middlewareの起動と停止に関する項

7

10gのすべての長時間実行プロセスを完了まで監視します。

Oracle Application Server 10g リリース3 (10.1.3.1.0)の『Oracle SOA Suite開発者ガイド』にある、「インスタンス」タブを使用したプロセス・インスタンスの監視に関する項(次に示すOracle Technology Network(OTN)から入手できます)

http://www.oracle.com/technology/documentation

8

Oracle BPEL Process Manager 10gを停止して終了します。

- Oracle Application Server 10g リリース3 (10.1.3.1.0)の『Oracle BPEL Process Managerクイック・スタート・ガイド』にある、Oracle BPEL Process Managerコンポーネントの起動と停止に関する項

- Oracle Application Server 10g リリース3(10.1.3.1.0)の『Oracle Application Server管理者ガイド』にある、アプリケーション・サーバー・インスタンスの起動と停止に関する項

Oracle Application Server 10g リリース3(10.1.3)のドキュメントは、次に示すOracle Technology Network(OTN)から入手できます。

http://www.oracle.com/technology/documentation

4.2.2 長時間実行プロセスに対する猶予期間と強制終了の使用

Oracle BPEL Process Manager長時間実行プロセスの数が多くない、長時間実行プロセスがビジネス・モデルにとってクリティカルではない、またはアップグレードのタイミングや期間に余裕がある場合は、長時間実行プロセスに対するアップグレード時の同時並行アプローチの代替として、この項で説明するアプローチを検討します。

この代替する猶予期間アプローチは、長時間実行プロセスがクライアント・メッセージを受信するまで完了できない場合も使用できます。たとえば、クライアントがメッセージを送信してプロセスを開始した後、プロセスの途中で別のメッセージを送信すると、同時並行アプローチのプロセスは終了しません。これは、プロセスが11gにアップグレードされたクライアントに依存しているためです。そのため、10gシステムは2番目のクライアント・メッセージを受信しません。

表4-2に、長時間実行プロセスに対する同時並行アプローチの代替方法を検討している場合に使用するアップグレード処理の概要を示します。

表4-2 長時間実行プロセスに猶予期間と強制終了アプローチを使用するステップ

ステップ番号

タスク

詳細情報

1

新しいOracle Fusion Middleware 11g環境をインストールして構成します。

第6章「Oracle SOA Suite 10g環境のアップグレード」

2

Oracle JDeveloper 11gでアプリケーションをアップグレードします。

第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」

3

Oracle Fusion Middleware 11gにアプリケーションをデプロイします。

第8.9項「タスク9: アプリケーションのデプロイ」

4

クライアント・アプリケーションをコピーしてアップグレードし、Oracle Fusion Middleware 11gにデプロイしたアプリケーションを使用してテストします。

第14.5項「Oracle SOA Suiteクライアント・アプリケーションのアップグレード」

5

Oracle BPEL Process Manager 10gのすべてのプロセスをリタイアします。これにより、新しいプロセスの開始は阻止され、既存の10gプロセスは終了するまで許可されます。

Oracle Application Server 10g リリース3 (10.1.3.1.0)の『Oracle SOA Suite開発者ガイド』にある、プロセス・ライフサイクルの管理方法に関する項(次に示すOracle Technology Network (OTN)から入手できます)

http://www.oracle.com/technology/documentation

6

Oracle Application Server 10g環境の猶予期間を定義し、停止する期限を設定して、Oracle Fusion Middleware 11g環境をカットオーバーします。

Oracle Application Server 10g Oracle BPEL Controlを使用して長時間実行プロセスを監視します。この情報を使用して、Oracle Fusion Middleware 11gにアップグレードする適切な時期を決定します。

7

事前設定された期限に、すべての既存のOracle BPEL Process Managerのプロセス・インスタンスを中断します。

次の2つの方法でプロセスを中断できます。

- BPEL Controlからのインスタンスの削除
詳細は、Oracle Application Server 10g リリース3(10.1.3.1.0)の『Oracle SOA Suite開発者ガイド』にある、「インスタンス」タブを使用したプロセス・インスタンスの監視に関する項を参照してください。次に示すOracle Technology Network(OTN)から入手できます。

http://www.oracle.com/technology/documentation

- すべてのアクティブ・インスタンスを検出して中断するJavaプログラムの作成
この方法には、インスタンスcom.oracle.bpel.client.IInstanceHandleのabort()メソッドを使用できます。

詳細は、10g リリース3(10.1.3)のOracle BPEL Process ManagerクライアントのJava APIリファレンスを参照してください。

8

Oracle Application Server 10g環境を停止して終了します。

- Oracle Application Server 10g リリース3 (10.1.3.1.0)の『Oracle BPEL Process Managerクイック・スタート・ガイド』にある、Oracle BPEL Process Managerコンポーネントの起動と停止に関する項

- Oracle Application Server 10g リリース3(10.1.3.1.0)の『Oracle Application Server管理者ガイド』にある、アプリケーション・サーバー・インスタンスの起動と停止に関する項

Oracle Application Server 10g リリース3(10.1.3)のドキュメントは、次に示すOracle Technology Network(OTN)から入手できます。

http://www.oracle.com/technology/documentation

9

アップグレードされた新しいクライアント・アプリケーションを起動して展開します。このアプリケーションにより、新しいOracle BPEL Process Manager 11gにリクエストが送られます。

Oracle Fusion Middlewareの管理者ガイドにある、Oracle Fusion Middlewareの起動と停止に関する項

第II部

Oracle SOA Suite、WebCenterおよびADF環境のアップグレード

第II部は次の章で構成されています。

- 第5章「Oracle ADF 10g環境のアップグレード」

- 第6章「Oracle SOA Suite 10g環境のアップグレード」

- 第7章「Oracle WebCenter 10g環境のアップグレード」

5 Oracle ADF 10g環境のアップグレード

この章では、Oracle Application Server 10gのOracle ADF環境を、Oracle Fusion Middleware 11gの同等の環境にアップグレードする方法について説明します。

詳細は、次の各項を参照してください。

- タスク1: ADFアプリケーションに使用するOracle Fusion Middleware 11gトポロジの決定

- タスク2: ADFアプリケーションに使用するOracle WebLogic Serverドメインのインストールおよび構成

5.1 タスク1: ADFアプリケーションに使用するOracle Fusion Middleware 11gトポロジの決定

アップグレード処理を開始する前に、新しいOracle Fusion Middleware 11g環境のトポロジを決定します。

詳細は、第3.1項「Oracle ADFユーザー向けの情報」を参照してください。

5.2 タスク2: ADFアプリケーションに使用するOracle WebLogic Serverドメインのインストールおよび構成

Oracle Fusion Middleware 11gにアップグレードする前に、Oracle Application Server 10gに対して設定したトポロジと同様のOracle Fusion Middleware環境をインストールする必要があります。

詳細は、次の各項を参照してください。

- Oracle JDeveloperを使用する開発ドメインのインストールおよび構成

- JDeveloperを使用しないドメインのインストールおよび構成

- Java Required Files(JRF)ドメイン・テンプレートの使用方法

5.2.1 Oracle JDeveloperを使用する開発ドメインのインストールおよび構成

Oracle WebLogic Serverは、Oracle JDeveloper Studioの一部として入手可能です。そのため、統合開発環境(IDE)としてOracle JDeveloper Studioを使用している場合は、Oracle JDeveloperのインストールの一部としてOracle WebLogic Serverをインストールできます。

Oracle JDeveloper StudioでのOracle WebLogic Serverのインストールおよび構成の手順の詳細は、『Oracle Fusion Middleware Oracle JDeveloperインストレーション・ガイド』のOracle JDeveloper Studio Editionのインストールに関する項を参照してください。

5.2.2 JDeveloperを使用しないドメインのインストールおよび構成

アプリケーションの開発にOracle JDeveloperを使用していない場合、Oracle WebLogic Serverソフトウェアと Oracle Fusion Middleware Application Developerソフトウェア・スイートをインストールできます。

Application Developerインストーラを使用すると、Java Required Files(JRF)およびOracle Enterprise Manager Fusion Middleware Controlドメイン・テンプレートを使用してドメインを構成する必要のあるソフトウェアをインストールできます。JRFテンプレートの詳細は、第5.2.3項「Java Required Files(JRF)ドメイン・テンプレートの使用方法」を参照してください。

Oracle Fusion Middleware Application Developerソフトウェアのインストールと構成の詳細は、『Oracle Fusion Middleware Application Developerインストレーション・ガイド』を参照してください。

5.2.3 Java Required Files(JRF)ドメイン・テンプレートの使用方法

Oracle WebLogic Serverを構成する場合は、ドメイン・テンプレートを使用して各ドメインを構成します。Oracle Fusion Middleware 11gで使用可能なドメイン・テンプレートの1つとして、Java Required Files(JRF)テンプレートがあります。

JRFテンプレートには、重要なOracleライブラリ、および多数のOC4Jアプリケーションが依存するAPIの新規バージョンをサポートするその他の機能が含まれています。

アップグレードされたOC4Jアプリケーションで重要なJRFテンプレートのAPIのタイプについては、『Oracle Fusion Middleware Java EEアップグレード・ガイド』のJava Required Files(JRF)ドメイン・テンプレートで使用可能なAPIに関する項を参照してください。

JRFテンプレートを使用してドメインを作成または拡張するには、次を参照します。

- JRFテンプレートを使用した新規ドメインの作成

- JRFテンプレートを使用した既存ドメインの拡張

- 既存のOracle WebLogic ServerインスタンスのADF 11gランタイムへのアップグレード

5.2.3.1 JRFテンプレートを使用した新規ドメインの作成

JRFテンプレートを使用して新規Oracle WebLogic Serverドメインを作成する方法は複数あります。

- Oracle JDeveloper 11gインストーラを使用した開発ドメインのインストールおよび構成
このドメインはJRFテンプレートを使用して自動的に作成されます。

- Application Developer、Oracle SOA Suite、WebCenter、Oracle Identity Management、またはOracle Portal、Forms、ReportsおよびDiscovererドメインをインストールし、構成します。
任意のOracle Fusion Middlewareソフトウェア・スイートを構成する際、構成ツールが実行中であれば、JRFテンプレートを選択できます。

詳細は、該当するOracle Fusion Middlewareインストレーション・ガイドを参照してください。

5.2.3.2 JRFテンプレートを使用した既存ドメインの拡張

JRFテンプレートを使用して既存のドメインを拡張するには、次のいずれかの方法を使用します。

- Oracle JDeveloper 11gインストーラを使用します。
Oracle JDeveloperインストーラで、カスタム・インストールを選択し、次にADFランタイム・コンポーネントを選択します。この手順では、ADFランタイムjarファイルとドメイン・テンプレートをサーバー環境にインストールできます。

詳細は、『Oracle Fusion Middleware Oracle JDeveloperインストレーション・ガイド』を参照してください。

- Fusion Middleware構成ウィザードをOracle SOA Suite、WebCenter、Oracle Identity ManagementまたはOracle Portal、Forms、ReportsおよびDiscovererのOracleホームから実行します。
ドメインを拡張するオプションを選択し、表示される使用可能なテンプレートのリストからJRFテンプレートを選択します。

詳細は、該当するOracle Fusion Middlewareインストレーション・ガイドを参照してください。

- Oracle Enterprise Manager Fusion Middleware ControlまたはApplyJRF WebLogic Scripting Tool(WLST)コマンドを使用して、JRFテンプレートを既存のWebLogicサーバー・インスタンスに適用します。
詳細は、『Oracle Fusion Middleware管理者ガイド』の管理対象サーバーまたはクラスタへのOracle JRFテンプレートの適用に関する項を参照してください。

5.2.3.3 既存のOracle WebLogic ServerインスタンスのADF 11gランタイムへのアップグレード

Oracle Fusion Middleware 11gがリリースされるより先に、Oracle JDeveloper 11g(11.1.1.0.x)のバージョンがOracleの顧客に提供されています。

Oracle JDeveloper 11g(11.1.1.0.x)を使用してOracle WebLogic Serverドメインをインストールおよび構成してある場合は、Oracle Fusion Middleware 11gと新しいOracle JDeveloper 11g(11.1.1.1.0)のほうがOracle ADFランタイム・ソフトウェアのバージョンが新しいことに注意してください。

既存のOracle WebLogic ServerドメインをOracle ADF 11gランタイム・ソフトウェアでアップグレードする手順は、次のとおりです。

1. アップグレード対象のOracle WebLogic Serverインスタンスのアンインストーラを開始します。
Oracle WebLogic Serverのアンインストーラは次の場所にあります。

UNIXシステムの場合

WLS_HOME/wlserver_10.3/uninstall/uninstall.sh

Windowsシステムの場合

WLS_HOME\wlserver_10.3\uninstall\uninstall.cmd

ヘッドレス・サーバー(LinuxやUNIXベースのシステムなど)では、DISPLAY変数をVNCやXmingなどのXサーバーに設定することが必要な場合があります。

2. JDeveloper 11g(11.1.1.0.x)Studio Edition 11.1.1.0.0を選択します。

3. WebLogic Server内の選択をすべて解除します。

4. 「次へ」をクリックし、アンインストールを実行します。必要な場合は、「詳細」ボタンをクリックしてアンインストールされた内容を確認できます。

5. JDeveloper 11.1.1.1.0インストーラを開始します。

6. ADFランタイムの新規バージョンをインストールするOracle WebLogic Serverインスタンスを選択します。

7. すべての選択を解除し、「Application Development Framework Runtime」のみを選択します。
これにより、JDeveloperとADFのフォルダが自動的に選択されます。

8. クラスのロード問題を回避するには、すべてのEARファイルを再構築します。

6 Oracle SOA Suite 10g環境のアップグレード

この章では、Oracle SOA Suite環境をOracle Application Server 10gからOracle Fusion Middleware 11gにアップグレードする方法について説明します。

この環境とアプリケーションのアップグレードには、次のタスクが含まれます。

- タスク1: Oracle SOAトポロジの決定

- タスク2: Oracle SOA SuiteスキーマをホストするOracleデータベースのアップグレード(必要な場合)

- タスク3: リポジトリ作成ユーティリティによる11g SOAスキーマのインストール

- タスク4: Oracle SOA Suite 11g中間層のインストールと構成

- タスク5: SOAコンポーネントのスキーマのアップグレード(必要な場合)

- タスク6: SOAアプリケーションのサポートに必要なJava EE機能の構成

- タスク7: SOAコンポーネントに必要なアップグレード後タスクの実行

6.1 タスク1: Oracle SOAトポロジの決定

アップグレード処理を開始する前に、新しいOracle Fusion Middleware 11g環境のトポロジを決定します。

詳細は、第3.2項「Oracle SOA Suiteユーザー向けの情報」を参照してください。

このマニュアルでは、基本的なOracle SOA Suite環境のアップグレード手順を示しています。このマニュアルの内容を確認した後は、この知識をより複雑な本番環境に適用できます。

クラスタ化と高可用性を利用した本番環境を設定する手順の詳細は、『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』を参照してください。

エンタープライズ・デプロイメントのアップグレード時に実行する必要がある主なタスクの概要は、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のエンタープライズ・デプロイメントの計画に関する項を参照してください。

6.2 タスク2: Oracle SOA SuiteスキーマをホストするOracleデータベースのアップグレード(必要な場合)

Oracle SOA Suite環境をアップグレードする場合は、Oracle SOA Suiteスキーマの格納先のデータベースのバージョンがOracle Fusion Middleware 11gでサポートされることを確認しておく必要があります。

新しいデータベースをインストールするか、または既存のデータベースをサポートされているバージョンにアップグレードできます。

アップグレードに複数のデータベースが含まれる場合は、このアップグレードを続行する前に、ソース・データベースとターゲット・データベースの両方のアップグレードが必要な場合があります。たとえば、Oracle BAMのアップグレードには、別々のソース・データベースとターゲット・データベースが含まれる場合があります。

データベースがOracle Fusion Middleware 11gの要件を満たしているかどうかを確認する手順については、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のデータベースのアップグレードと準備に関する項を参照してください。

6.3 タスク3: リポジトリ作成ユーティリティによる11g SOAスキーマのインストール

Oracle SOA Suiteをアップグレードする場合は、リポジトリ作成ユーティリティを使用してスキーマをデータベースにインストールします。

リポジトリ作成ユーティリティはグラフィカルなコマンドライン・ツールであり、Oracle Fusion Middlewareデータベース・スキーマをデータベース内に作成して管理するために使用します。

詳細は、次の各項を参照してください。

- Oracle SOA Suiteのアップグレード準備としてのリポジトリ作成ユーティリティの実行

- Oracle SOA Suiteのアップグレードに必要なスキーマの選択

6.3.1 Oracle SOA Suiteのアップグレード準備としてのリポジトリ作成ユーティリティの実行

リポジトリ作成ユーティリティ(RCU)を開始するには、rcuコマンドを実行します。このコマンドは、リポジトリ作成ユーティリティCDのルート・ディレクトリまたは(ディスクにOracle SOA Suiteソフトウェアをインストール済の場合は)Oracle SOA SuiteのOracleホームのbinディレクトリにあります。

RCUへのアクセスおよび実行方法の詳細手順は、『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

リポジトリ作成ユーティリティの実行時に選択するスキーマの詳細は、第6.3.2項「Oracle SOA Suiteのアップグレードに必要なスキーマの選択」を参照してください。

リポジトリ作成ユーティリティによってインストールされるOracle SOA Suiteスキーマの詳細は、『Oracle Fusion Middleware管理者ガイド』のメタデータ・リポジトリ・スキーマに関する項を参照してください。

6.3.2 Oracle SOA Suiteのアップグレードに必要なスキーマの選択

リポジトリ作成ユーティリティを使用して、スキーマを必要とするすべてのOracle Fusion Middlewareソフトウェア・コンポーネントに必要なスキーマをインストールできます。ただし、すべてのスキーマをインストールする必要があるのは、Oracle Fusion Middlewareの完全な環境をインストールし、すべてのOracle Fusion Middlewareコンポーネント・スキーマに同じデータベースを使用する計画がある場合にかぎられます。

Oracle SOA Suiteのアップグレードでは、リポジトリ作成ユーティリティから要求されたときに、次のスキーマを選択する必要があります(図6-1を参照)。

- AS共通スキーマ・カテゴリでメタデータ・サービス・スキーマを選択します。
このスキーマは、一部のOracle Fusion Middlewareコンポーネントや、MDSをサポートするカスタム・アプリケーションに必要なOracle Fusion Middlewareのメタデータ・サービス(MDS)をサポートします。詳細は、『Oracle Fusion Middleware管理者ガイド』のMDSリポジトリに関する項を参照してください。

- SOAインフラストラクチャ・カテゴリ全体のスキーマを選択します。
これらのスキーマは、Oracle SOA Suiteコンポーネントに必要です。

図6-1 Oracle SOA Suiteのアップグレードに必要なスキーマの選択

「図6-1 Oracle SOA Suiteのアップグレードに必要なスキーマの選択」の説明

6.4 タスク4: Oracle SOA Suite 11g中間層のインストールと構成

Oracle Fusion Middleware 11gにアップグレードする前に、Oracle Application Server 10gに対して設定したトポロジと同様のOracle Fusion Middleware 11g環境をインストールおよび構成する必要があります。

Oracle SOA Suite中間層のインストールと構成の手順の詳細は、次のドキュメントを参照してください。

- 『Oracle Fusion Middlewareインストレーション・プランニング・ガイド』

- 『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteクイック・インストレーション・ガイド』

- Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイド

表6-1は、Oracle SOA Suite中間層のインストールと構成時に実行する必要がある主なステップの概要と、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteクイック・インストレーション・ガイド』の各ステップで実行する特定の手順の参照先を示しています。

ここで説明する手順では、最新バージョンのOracle WebLogic ServerおよびOracle Fusion Middleware 11gのダウンロード作業が完了していることを前提としています。詳細は、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』の最新のOracle WebLogic ServerおよびOracle Fusion Middleware 11gソフトウェアの取得に関する項を参照してください。

表6-1 Oracle SOA Suite中間層のインストールと構成に必要となる主なステップ

ステップ番号

説明

項

マニュアル名

1

Oracle WebLogic ServerのインストールとMiddlewareホームの作成

グラフィカル・モードでのインストレーション・プログラムの実行に関する項

Oracle Fusion Middleware Oracle WebLogic Serverインストレーション・ガイド

2

Oracle SOA SuiteソフトウェアのインストールとOracle SOA SuiteのOracleホームの作成

Oracle SOA SuiteおよびOracle Business Process Management Suiteのインストールに関する項

『Oracle Fusion Middleware Oracle SOA Suite and Oracle Business Process Management Suiteインストレーション・ガイド』

3

Oracle SOA Suiteドメインの構成

Oracle SOA Suiteの構成に関する項

『Oracle Fusion Middleware Oracle SOA Suite and Oracle Business Process Management Suiteインストレーション・ガイド』

4

Oracle WebLogic Serverドメインの開始

サーバーの起動に関する項

『Oracle Fusion Middleware Oracle SOA Suite and Oracle Business Process Management Suiteインストレーション・ガイド』

5

インストールの確認

インストールの確認および構成に関する項

『Oracle Fusion Middleware Oracle SOA Suite and Oracle Business Process Management Suiteインストレーション・ガイド』

6.5 タスク5: SOAコンポーネントのスキーマのアップグレード(必要な場合)

Oracle B2BまたはOracle BAMコンポーネントをアップグレードする場合は、Oracle Fusion Middlewareアップグレード・アシスタントを実行し、これらのコンポーネントのスキーマを11gにアップグレードする必要があります。

Oracle Fusion Middlewareアップグレード・アシスタントによって、Oracle Application Server 10g環境の多様なアップグレード作業が自動化されます。

アップグレード・アシスタントは、Oracle Fusion MiddlewareのOracleホームのbinディレクトリに自動的にインストールされます。アップグレードする10gの各スキーマに対してアップグレード・アシスタントを1回実行します。

注意:

基本インストール・オプションを使用してインストールした10g リリース3 (10.1.3.1.0)のOracleホームをアップグレードする場合は、アップグレード・アシスタントを実行する必要はありません。10g リリース3 (10.1.3.1.0)の基本インストール・オプションを選択した場合、Oracle Fusion Middlewareアップグレード・アシスタントでアップグレード可能なコンポーネントはインストールされません。

詳細は、次の各項を参照してください。

- タスク5a: アップグレード・アシスタントの実行によるOracle SOAスキーマのアップグレード

- タスク5b: B2Bスキーマのアップグレード(必要な場合)

- タスク5c: BAMスキーマのアップグレード(必要な場合)

6.5.1 タスク5a: アップグレード・アシスタントの実行によるOracle SOAスキーマのアップグレード

グラフィカル・ユーザー・インタフェースを使用してアップグレード・アシスタントを起動する手順は、次のとおりです。

注意:

アップグレード・アシスタントのコマンドライン・インタフェースを使用して、Oracle Application Server 10gのOracleホームをアップグレードすることもできます。詳細は、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のアップグレード・アシスタントのコマンドライン・インタフェースの使用に関する項を参照してください。

1. ディレクトリを、Oracle SOA SuiteインストールのORACLE_HOME/binディレクトリに変更します。

2. 次のコマンドを入力してアップグレード・アシスタントを起動します。
UNIXシステムの場合

./ua

Windowsシステムの場合

ua.bat

図6-2に示すように、アップグレード・アシスタントの「ようこそ」画面が表示されます。

図6-2 アップグレード・アシスタントの「ようこそ」画面

「図6-2 アップグレード・アシスタントの「ようこそ」画面」の説明

3. 「次へ」をクリックすると、「操作の指定」画面が表示されます(図6-3)。
アップグレード・アシスタントで使用可能なオプションは、アップグレード・アシスタントを起動したOracleホームに固有です。Oracle SOA SuiteおよびWebCenterのOracleホームからアップグレード・アシスタントを起動した場合、「操作の選択」画面に表示されるオプションは、Oracle SOA SuiteおよびWebCenterのOracleホームに対して有効なオプションです。

図6-3 SOAアップグレードにおけるアップグレード・アシスタントの「操作の指定」画面

「図6-3 SOAアップグレードにおけるアップグレード・アシスタントの「操作の指定」画面」の説明

6.5.2 タスク5b: B2Bスキーマのアップグレード(必要な場合)

Oracle B2Bスキーマのアップグレードの詳細は、次の項を参照してください。

- B2Bスキーマのアップグレードに関する一般的な情報

- Oracle B2B 10g中間層への必要なパッチ・セットの適用

- Oracle WebLogic Server管理コンソールにおける最大メッセージ・サイズ属性の設定

- B2Bスキーマのアップグレードの実行

6.5.2.1 B2Bスキーマのアップグレードに関する一般的な情報

Oracle Application Server 10g リリース2(10.1.2)を使用していて、Oracle Application Server Integration B2Bをアップグレードする場合は、データベースのB2Bスキーマをアップグレードする必要があります。

関連項目:

Oracle Technology NetworkのOracle Application Server 10g リリース2 (10.1.2)ドキュメント・ライブラリにある『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』

http://www.oracle.com/technology/documentation/

B2Bスキーマを10g リリース2 (10.1.2)からアップグレードする場合は、ソフトウェア・パッチを10g リリース2 (10.1.2)インストールに適用した後、B2B 10gスキーマをデータベースからエクスポートする必要があります。エクスポートしたデータは、ディスク上のZIPファイルに保存されます。その後、Oracle Fusion Middleware 11gコンポーネント・スキーマが含まれているデータベースにデータをインポートできます。

6.5.2.2 Oracle B2B 10g中間層への必要なパッチ・セットの適用

Oracle B2Bスキーマのアップグレードを実行する前に、必要なパッチ・セットをOracle Application Server Integration B2B 10g リリース2(10.1.2)中間層に適用する必要があります。

次の手順で実行する、取引パートナ・アグリーメントのエクスポートで使用するJavaコマンドを有効にするために、このパッチ・セットが必要になります。

アップグレードに対するパッチ・セットの要件や、以前のOracle Application Serverリリースとの互換性に対するパッチ・セットの要件の詳細は、『Oracle Fusion Middlewareリリース・ノート』を参照してください。

6.5.2.3 Oracle WebLogic Server管理コンソールにおける最大メッセージ・サイズ属性の設定

Oracle B2B 10gスキーマからエクスポートしたカスタマ・データは、非常に大きなZIPファイルとしてディスクに保存される場合があります。大きなファイルをOracle Fusion Middleware 11gメタデータ・リポジトリ・データベースに正常にインポートできるようにするために、SOA SuiteコンポーネントがデプロイされるWebLogic管理対象サーバーのデフォルトの「最大メッセージ・サイズ」の一般プロトコル属性を変更してください。

このタスクを実行する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールにログインします。

http://localhost:7001/console

2. コンソールの左ペインで、「環境」を展開して「サーバー」を選択します。

3. 「サーバーの概要」ページで、構成するサーバー・インスタンスを選択します。ほとんどの場合、SOAコンポーネントをホストする管理対象サーバーはsoa_server1です。

4. 「プロトコル」をクリックし、ネットワーク・プロトコルの一般接続設定を表示します。

5. 「最大メッセージ・サイズ」プロパティまでスクロールし、このプロパティを200000000に設定します。

6.5.2.4 B2Bスキーマのアップグレードの実行

注意:

この手順では、第6.4項「タスク4: Oracle SOA Suite 11g中間層のインストールと構成」の説明に従って、新しいOracle Fusion Middleware 11g環境をインストールおよび構成していることを前提としています。

B2Bスキーマをアップグレードする手順は、次のとおりです。

1. 必要なパッチ・セットをOracle Application Server Integration B2B 10g リリース2(10.1.2)中間層に適用します。
詳細は、第6.5.2.2項「Oracle B2B 10g中間層への必要なパッチ・セットの適用」を参照してください。

2. 次の手順で、10g リリース2 (10.1.2)取引パートナ・アグリーメントを外部ZIPファイルにエクスポートします。

1. Oracle Application Server Integration B2BのOracleホームで次のコマンドを実行し、デプロイされている10g リリース2(10.1.2)取引パートナ・アグリーメントをエクスポートします。

java -ms1024M -mx1024M oracle.tip.repos.export.Export 11g

このJavaコマンドにより、次のディレクトリが作成されます。このディレクトリにはエクスポートされたデータが含まれています。

Windowsシステムの場合

%TEMP%/export.zip

UNIXシステムの場合

/tmp/export.zip

2. 次のディレクトリをOracle Fusion Middleware 11gのOracleホームに作成します。これは、10gのOracleホームと同じホスト上にすることも異なるホスト上にすることも可能です。
Windowsシステムの場合

ORACLE_HOME\b2b\upgrade

UNIXシステムの場合

ORACLE_HOME/b2b/upgrade

3. 作成したディレクトリにexport.zipファイルをコピーします。

3. Oracle WebLogic Server管理コンソールを使用して、SOAコンポーネントの管理対象サーバー(soa_server1など)の「最大メッセージ・サイズ」のプロパティの値を大きくします。
詳細は、第6.5.2.3項「Oracle WebLogic Server管理コンソールにおける最大メッセージ・サイズ属性の設定」を参照してください。

4. BAMアプリケーションをホストするOracle WebLogic Serverドメイン内の管理サーバーと管理対象サーバーを停止します。
詳細は、『Oracle Fusion Middleware管理者ガイド』のOracle Fusion Middlewareの起動と停止に関する項を参照してください。

5. 「タスク5a: アップグレード・アシスタントの実行によるOracle SOAスキーマのアップグレード」の説明に従って、アップグレード・アシスタントを起動します。

6. 「操作の指定」画面(図6-3)で「B2Bスキーマのアップグレード」を選択します。

7. B2Bスキーマのアップグレード時に入力が必要なアップグレード・アシスタントの画面と、各画面のオプションの説明は、表6-2を参照してください。
Oracle B2B 10gスキーマとカスタマ・データが含まれているZIPファイルの場所を要求するプロンプトは表示されません。かわりに、アップグレード・アシスタントによって、ステップ2で指定した場所のZIPファイルが自動的に検出されます。

8. 「ターゲット・データベースの指定」画面の後は、アップグレード・アシスタントによって次のタスクが実行され、各タスクの進捗状況が表示されます。

- アップグレード対象のコンポーネントとスキーマが検査され、それらを正常にアップグレードできることが検証されます。

- アップグレード対象コンポーネントのサマリーが提供されます。これによって、ユーザーは、アップグレード・アシスタントが目的のコンポーネントとスキーマをアップグレードしていることを確認できます。

- 進捗画面が表示されます。これによって、ユーザーは、アップグレードの進行状況を確認できます。

- アップグレード時に発生したエラーや問題に関するアラートが表示されます。

関連項目:

アップグレード・アシスタントの実行時に発生する問題のトラブルシューティング手順の詳細は、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のアップグレードのトラブルシューティングに関する項を参照してください。

- 「アップグレードの終了」画面が表示され、アップグレードの完了が通知されます。

9. Oracle B2Bスキーマのアップグレードの完了後、Oracle B2B 11gが稼働しているOracle WebLogic Serverドメイン内の管理サーバーおよびOracle SOA Suite管理対象サーバーを起動します。

表6-2 B2Bスキーマのアップグレード時に入力が必要なアップグレード・アシスタントの画面

アップグレード・アシスタントの画面

説明

ターゲット・データベースの指定

この画面を使用して、リポジトリ作成ユーティリティでOracle B2B 11gスキーマをインストールしたデータベースの接続詳細を入力します。

- ターゲット・データベース・タイプ: このドロップダウン・リストから「Oracle」を選択し、Oracle B2BスキーマをOracleデータベースにアップグレードします。

- 接続文字列: 接続文字列を次の形式で入力します。

host:port:SID

例:

host3:1521:soaDB3

- ユーザー名: データベース・ユーザー名を入力します。SYSを入力する場合は、文字列SYS as SYSDBAを入力してください。

- パスワード: データベース・ユーザーのパスワード。

スキーマ名の指定

この画面を使用して、Oracle B2B 11gスキーマ名を選択し、スキーマのパスワードを入力します。

これは、11gリポジトリ作成ユーティリティを使用してB2Bスキーマをインストールした際に定義したパスワードです。

6.5.3 タスク5c: BAMスキーマのアップグレード(必要な場合)

Oracle BAMスキーマをアップグレードするには、次の項を参照してください。

- Oracle BAMスキーマのアップグレードの注意点

- 以前のバージョンのOracle BAMからのアップグレードについて

- Oracle BAMスキーマが含まれているOracleデータベースへの必要なパッチ・セットの適用

- Oracle BAMスキーマのアップグレードの実行

- 中断されたOracle BAMスキーマのアップグレードからのリカバリと再試行

- Oracle BAMアップグレード・ログ・ファイルの検索および構成

6.5.3.1 Oracle BAMスキーマのアップグレードの注意点

Oracle Business Activity Monitoringをアップグレードする場合、データベース内のBAMスキーマをアップグレードする必要があります。

Oracle BAMスキーマのアップグレードでは、次の点に注意してください。

- この手順では、リポジトリ作成ユーティリティがすでに実行され、サポートされているデータベースに新しいOracle BAM 11gスキーマがすでに作成されていると想定しています。Oracle BAM 11gスキーマの作成時には、既存のOracle BAM 10gスキーマは上書きされません。

- Oracle BAMスキーマをアップグレードするには、Oracle BAM 10gスキーマが含まれているデータベースと、Oracle BAM 11gスキーマが含まれているデータベースを識別する必要があります。

- 10gスキーマと11gスキーマは同じデータベースに格納することも別々のデータベースに格納することも可能ですが、どちらの場合にも、ソースおよびターゲット・データベースを識別する必要があります。

6.5.3.2 以前のバージョンのOracle BAMからのアップグレードについて

Oracle Application Server 10g リリース2(10.1.2)を使用していて、Oracle Business Activity MonitoringをOracle Fusion Middleware 11gにアップグレードする場合は、最初にOracle Application Server 10g リリース3(10.1.3)にアップグレードする必要があります。

Oracle Technology NetworkのOracle Application Server 10g リリース3 (10.1.3.1.0)ドキュメント・ライブラリにある『Oracle Business Activity Monitoringインストレーション・ガイド』のインストールのアップグレードに関する項を参照してください。

http://www.oracle.com/technology/

6.5.3.3 Oracle BAMスキーマが含まれているOracleデータベースへの必要なパッチ・セットの適用

Oracle BAMスキーマをアップグレードする前に、Oracle BAM 10gスキーマが含まれているOracleデータベースにパッチ・セットを適用する必要があります。

アップグレードに対するパッチ・セットの要件や、以前のOracle Application Serverリリースとの互換性に対するパッチ・セットの要件の詳細は、『Oracle Fusion Middlewareリリース・ノート』を参照してください。

6.5.3.4 Oracle BAMスキーマのアップグレードの実行

BAMスキーマをアップグレードする手順は、次のとおりです。

1. BAMアプリケーションをホストするOracle WebLogic Serverドメイン内の管理サーバーと管理対象サーバーを停止します。
詳細は、『Oracle Fusion Middleware管理者ガイド』のOracle Fusion Middlewareの起動と停止に関する項を参照してください。

2. 「タスク5a: アップグレード・アシスタントの実行によるOracle SOAスキーマのアップグレード」の説明に従って、アップグレード・アシスタントを起動します。

3. 「操作の指定」画面で「BAMスキーマ」を選択します(図6-3)。

4. Oracle BAMスキーマのアップグレード時に入力が必要なアップグレード・アシスタントの画面と、各画面のオプションの説明は、表6-3を参照してください。

5. 「スキーマ名の指定」画面の後は、アップグレード・アシスタントによって次のタスクが実行され、各タスクの進捗状況が表示されます。

- アップグレード対象のコンポーネントとスキーマが検査され、それらを正常にアップグレードできることが検証されます。

- アップグレード対象コンポーネントのサマリーが提供されます。これによって、ユーザーは、アップグレード・アシスタントが目的のコンポーネントとスキーマをアップグレードしていることを確認できます。

- 進捗画面が表示されます。これによって、ユーザーは、アップグレードの進行状況を確認できます。

- アップグレード時に発生したエラーや問題に関するアラートが表示されます。

関連項目:

アップグレード・アシスタントの実行時に発生する問題のトラブルシューティング手順の詳細は、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のアップグレードのトラブルシューティングに関する項を参照してください。

- 「アップグレードの終了」画面が表示され、アップグレードの完了が通知されます。

表6-3 BAMスキーマのアップグレード時に入力が必要なアップグレード・アシスタントの画面

アップグレード・アシスタントの画面

説明

ソース・データベースの指定

この画面を使用して、Oracle BAM 10gスキーマが含まれているデータベースのデータベース接続詳細を入力します。

ターゲット・データベースの詳細の指定

この画面を使用して、Oracle Fusion Middlewareのリポジトリ作成ユーティリティで作成したOracle BAM 11gスキーマが含まれているデータベースのデータベース接続詳細を入力します。

スキーマ名の指定

この画面を使用して、Oracle BAM 11gスキーマを選択し、BAMスキーマのパスワードを入力します。これは、スキーマをデータベースにインストールした際にリポジトリ作成ユーティリティで設定したOracle BAMスキーマ・パスワードです。

コンポーネントの調査

このページには、調査フェーズの進行状況が表示されます。このフェーズ中に、アップグレード・アシスタントによってソースおよびターゲット・スキーマが検証されます。

6.5.3.5 中断されたOracle BAMスキーマのアップグレードからのリカバリと再試行

なんらかの理由でOracle BAMスキーマのアップグレードが中断された場合、アップグレード手順を再試行する前に、いくつかのリカバリ・ステップを実行する必要があります。

注意:

Oracle Business Activity Monitoring(BAM)スキーマをアップグレードする手順は、『Oracle Fusion Middleware Oracle SOA Suite、WebCenter PortalおよびADFアップグレード・ガイド』に記載されています。

Oracle BAMスキーマのアップグレード中に、アップグレード・アシスタントにより、ソース・データベースからのOracle BAMスキーマのエクスポート、Oracle Fusion Middleware 11gスキーマをホストするデータベースへのOracle BAMスキーマのインポートなど、いくつかのタスクが自動的に実行されます。アップグレード・アシスタントでは、Oracle Data Pumpを使用してエクスポートおよびインポート操作が行われます。

Oracle BAMスキーマのアップグレードが中断された場合(アップグレード中にアップグレード・アシスタントを終了した場合、データベースが停止した場合など)、次の手順を使用してアップグレードの中断からリカバリできます。

1. Oracle BAM 11gスキーマをホストするデータベースに接続します。
アップグレード・アシスタントからデータベースに接続する際に使用した同じユーザーとパスワードを使用します。

例:

connect sys/mypassword as sysdba

2. 次のSQLコマンドを入力して、Oracle Data Pumpジョブが現在実行中かどうかを確認します。

SELECT * FROM DBA_DATAPUMP_JOBS;

3. Oracle Data Pumpジョブが実行中の場合は、次のステップに進む前に、ジョブが完了するまで待機します。

4. 次のSQLコマンドを入力して、エクスポート・プロセス中に作成された特定のデータベースを削除します。

DROP TABLE ORACLEBAM1013_EXPORT;

表が存在する場合、アップグレード手順が正常に実行されないため、アップグレードを再試行できません。

5. アップグレード・アシスタントを再実行してOracle BAMのアップグレードを再試行します。

6.5.3.6 Oracle BAMアップグレード・ログ・ファイルの検索および構成

アップグレード・アシスタントを使用してOracle BAMをアップグレードする場合、アップグレード・アシスタントではMorpheusコマンドライン・ユーティリティを使用して11gスキーマのアップグレードおよびレポート変換が行われるため、アップグレードされた10gスキーマをOracle BAM 11gで使用できます。

Morpheusコマンドライン・ユーティリティは、Oracle SOA Suite 11g Oracleホーム内の次のフォルダにあります。

- Windowsシステムの場合

ORACLE_HOME\bam\bin\morpheus.bat

- UNIXシステムの場合

ORACLE_HOME/bam/bin/morpheus

BAMアップグレードによってmorpheusユーティリティが実行される場合、Morpheus関連のログ・メッセージはすべて、.outファイル拡張子で識別されるアップグレード出力ログ・ファイルに記録されます。このファイルはORACLE_HOME/upgrade/logsフォルダにあります。

次の構成ファイルを変更して、アップグレード・ログ・レベルを構成できます。

ORACLE_HOME/bam/bin/morpheus.logging.properties

6.6 タスク6: SOAアプリケーションのサポートに必要なJava EE機能の構成

Oracle WebLogic Serverのインストール時にインストールされるSOAシステム・コンポーネントだけでなく、デプロイするアプリケーションのサポートに必要なその他のOracle WebLogic Server機能も構成する必要があります。

たとえば、アプリケーションに必要なデータソース、JMSリソースまたはその他のサービスを定義することが必要な場合があります。Oracle WebLogic Serverドメインで提供されるリソースおよびサービスは、Oracle SOA Suiteアプリケーションを含むすべてのJavaベース・アプリケーションに共通です。

詳細は、『Oracle Fusion Middleware Java EEアップグレード・ガイド』を参照してください。

6.7 タスク7: SOAコンポーネントに必要なアップグレード後タスクの実行

アップグレードしたコンポーネントによっては、次のようなアップグレード後タスクが必要になります。

- Identity Managementコンポーネントを使用するためのOracle SOA Suite 11gの構成

- Oracle Human Workflowにおける大/小文字区別について

6.7.1 Identity Managementコンポーネントを使用するためのOracle SOA Suite 11gの構成

Oracle Application Server 10g環境がOracle Internet DirectoryなどのOracle Identity Managementコンポーネントに依存していた場合、またはサード・パーティのLDAPサーバーを使用していた場合は、それらのコンポーネントを新しいOracle Fusion Middleware 11g環境に関連付けることができます。

具体的には、 Oracle Enterprise Manager Fusion Middleware Controlを使用して LDAPディレクトリをOracle Fusion Middlewareに関連付けることにより、LDAPディレクトリをOracle WebLogic Serverドメインの資格証明ストアまたはポリシー・ストアとして使用できます。

詳細は、次の項を参照してください。

- 『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』のOracle Enterprise Managerを使用したドメイン・ストアの再関連付け

- 『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のLDAP認証プロバイダの構成に関する項

6.7.2 Oracle Human Workflowにおける大/小文字区別について

Oracle Human Workflow 10gとOracle Human Workflow 11gでは、ユーザー名、グループ名およびアプリケーション・ロール名の大/小文字区別について、サポートしているデフォルトの動作が異なります。

- Oracle Human Workflow 11gでは次のとおりです。

- デフォルトでは、Human Workflowコンポーネント内のすべてのユーザー名では大/小文字を区別せず、すべてのユーザー名は小文字で格納されます。

- デフォルトでは、すべてのグループ名およびアプリケーション・ロール名では常に大/小文字を区別します。

- Oracle Workflow 10g リリース3(10.1.3)では、ユーザー名の大/小文字をデフォルトでは区別し、すべてのユーザー名はシードされているとおりの大/小文字で格納されていました。

両方の環境の互換性を保つため、11gの大/小文字区別は10g リリース3(10.1.3)と同様に設定する必要があります。

ユーザー名で大/小文字を区別しないという動作は、workflow-identity-config.xmlで変更できます。caseSensitiveプロパティにより、ユーザー名で大/小文字を区別するかどうかが指定されます。このフラグは、MBeanブラウザを使用してアップグレードする必要があります。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の大/小文字区別に関する項を参照してください。

7 Oracle WebCenter 10g環境のアップグレード

この章では、Oracle WebCenter環境をOracle Application Server 10gからOracle Fusion Middleware 11gにアップグレードする方法について説明します。

この環境とアプリケーションのアップグレードには、次のタスクが含まれます。

- タスク1: Oracle WebCenter Portal 11gトポロジの決定

- タスク2: WebCenterスキーマをホストするOracleデータベースのアップグレード(必要な場合)

- タスク3: リポジトリ作成ユーティリティによるOracle WebCenter Portal 11gスキーマのインストール

- タスク4: Oracle WebCenter Portal 11g中間層のインストールと構成

- タスク5: WebCenterアプリケーションのサポートに必要なJava EE機能の構成

- タスク6: WebCenterサービスのバックエンド・コンポーネントのアップグレード

注意:

この章では、該当する箇所で最近商標変更されたOracle WebCenter Portal製品名を使用しています。詳細は、第3.3.1項「Oracle WebCenterおよびOracle Enterprise Content Management Suiteの新規製品名」を参照してください。

7.1 タスク1: Oracle WebCenter Portal 11gトポロジの決定

アップグレード処理を開始する前に、新しいOracle Fusion Middleware 11g環境のトポロジを決定します。

詳細は、第3.3項「Oracle WebCenterユーザー向けの情報」を参照してください。

7.2 タスク2: Oracle WebCenterスキーマをホストするOracleデータベースのアップグレード(必要な場合)

Oracle WebCenter環境をアップグレードする場合は、スキーマのインストール先となるデータベースのバージョンがOracle Fusion Middleware 11gでサポートされることを確認しておく必要があります。

新しいデータベースをインストールするか、または既存のデータベースをサポートされているバージョンにアップグレードできます。

データベースがOracle Fusion Middleware 11gの要件を満たしているかどうかを確認する手順については、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』のデータベースのアップグレードと準備に関する項を参照してください。

7.3 タスク3: リポジトリ作成ユーティリティによるOracle WebCenter Portal 11gスキーマのインストール

Oracle WebCenterをアップグレードする場合は、リポジトリ作成ユーティリティを使用して、「タスク2: WebCenterスキーマをホストするOracleデータベースのアップグレード(必要な場合)」で識別して準備したデータベースにスキーマをインストールします。

詳細は、次の各項を参照してください。

- Oracle WebCenterのアップグレード準備としてのリポジトリ作成ユーティリティの実行

- Oracle WebCenter Portal 11gに必要なスキーマの選択

7.3.1 Oracle WebCenterのアップグレード準備としてのリポジトリ作成ユーティリティの実行

リポジトリ作成ユーティリティを開始するには、rcuコマンドを実行します。このコマンドは、リポジトリ作成ユーティリティCDのルート・ディレクトリまたは(ディスクにOracle WebCenter Portalソフトウェアをインストール済の場合は)Oracle WebCenter PortalのOracleホームのbinディレクトリにあります。

RCUへのアクセスおよび実行方法の詳細手順は、『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

リポジトリ作成ユーティリティの実行時に選択するスキーマの詳細は、第7.3.2項「Oracle WebCenter Portal 11gに必要なスキーマの選択」を参照してください。

リポジトリ作成ユーティリティによってインストールされるOracle WebCenter Portalスキーマの詳細は、『Oracle Fusion Middleware管理者ガイド』のメタデータ・リポジトリ・スキーマに関する項を参照してください。

7.3.2 Oracle WebCenter Portal 11gに必要なスキーマの選択

RCUを使用して、スキーマを必要とするすべてのOracle Fusion Middlewareソフトウェア・コンポーネントに必要なスキーマをインストールできます。ただし、すべてのスキーマをインストールする必要があるのは、Oracle Fusion Middlewareの完全な環境をインストールし、すべてのOracle Fusion Middlewareコンポーネント・スキーマに同じデータベースを使用する計画がある場合にかぎられます。

Oracle WebCenterのアップグレードでは、リポジトリ作成ユーティリティから要求されたときに、次のスキーマを選択する必要があります(図7-1を参照)。

- AS共通スキーマ・カテゴリでメタデータ・サービス・スキーマを選択します。
このスキーマは、Oracle WebCenter Spacesコンポーネントに必要とされるOracle Fusion Middlewareメタデータ・サービス(MDS)をサポートします。

- WebCenter Portalカテゴリ全体のスキーマを選択します。
これらのスキーマは、様々なOracle WebCenter Portal 11g製品でサポートされています。

図7-1 Oracle WebCenter Portal 11gに必要なスキーマの選択

「図7-1 Oracle WebCenter Portal 11gに必要なスキーマの選択」の説明

7.4 タスク4: Oracle WebCenter Portal 11g中間層のインストールと構成

Oracle Fusion Middleware 11gにアップグレードする前に、Oracle Application Server 10gに対して設定したトポロジと同様のOracle Fusion Middleware環境をインストールする必要があります。

Oracle Fusion Middlewareのインストール手順の詳細は、次のドキュメントを参照してください。

- Oracle Fusion Middlewareインストレーション・プランニング・ガイド

- Oracle Fusion Middleware Oracle WebCenter Portalクイック・インストレーション・ガイド

- Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイド

表7-1は、Oracle WebCenter Portal中間層のインストールと構成時に実行する必要がある主なステップの概要と、Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイドの各ステップで実行する特定の手順の参照先を示しています。

ここで説明する手順では、最新バージョンのOracle WebLogic ServerおよびOracle Fusion Middleware 11gのダウンロード作業が完了していることを前提としています。詳細は、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』の最新のOracle WebLogic ServerおよびOracle Fusion Middleware 11gソフトウェアの取得に関する項を参照してください。

表7-1 Oracle WebCenter Portal中間層のインストールと構成に必要となる主なステップ

ステップ番号

説明

項

マニュアル名

1

Oracle WebLogic ServerのインストールとMiddlewareホームの作成

グラフィカル・モードでのインストレーション・プログラムの実行に関する項

Oracle Fusion Middleware Oracle WebLogic Serverインストレーション・ガイド

2

Oracle WebCenter PortalのインストールとWebCenter PortalのOracleホームの作成

「Oracle WebCenter Portalのインストール」

Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイド

3

Oracle WebCenter Portalドメインの構成

「Oracle WebCenter Portalの構成」

Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイド

4

Oracle WebLogic Serverドメインの開始

サーバーの起動に関する項

Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイド

5

インストールの確認

"インストールの確認"

Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイド

7.5 タスク5: WebCenterアプリケーションのサポートに必要なJava EE機能の構成

Oracle WebLogic Serverのインストール時にインストールされるOracle WebCenter Portal 11gシステム・コンポーネントのみでなく、デプロイするWebCenterアプリケーションのサポートに必要なその他のOracle WebLogic Server機能も構成する必要があります。

たとえば、アプリケーションに必要なデータソース、JMSリソースまたはその他のサービスを定義することが必要な場合があります。Oracle WebLogic Serverドメインで提供されるリソースおよびサービスは、WebCenterアプリケーションを含むすべてのJavaベース・アプリケーションに共通です。

詳細は、『Oracle Fusion Middleware Java EEアップグレード・ガイド』を参照してください。

7.6 タスク6: WebCenterサービスのバックエンド・コンポーネントのアップグレード

Oracle WebCenterでは、WebCenterアプリケーションに含めるソーシャル・ネットワーキング機能および個人の生産性向上のための機能を実現する一連のWebCenterサービスが用意されています。これらのサービスの中には、DocumentsやDiscussionsなど、バックエンド・コンポーネントに依存しているものもあります。この項では、Oracle WebCenter Portal 11gを使用するために準備が必要となる可能性のあるバックエンド・サーバーについて説明します。

この項の内容は、次のとおりです。

- Oracle WebCenter Discussionsのアップグレード

- Oracle Content Serverのアップグレード

- Oracle WebCenter Wiki and Blog Serverデータの移行

7.6.1 Oracle WebCenter Discussionsのアップグレード

注意:

この項では、該当する箇所で最近商標変更されたOracle WebCenter Portal製品名を使用しています。詳細は、第3.3.1項「Oracle WebCenterおよびOracle Enterprise Content Management Suiteの新規製品名」を参照してください。

WebCenterアプリケーションでDiscussionsサービスおよびAnnouncementsサービスを使用している場合、Oracle WebCenter PortalのDiscussion Server 11gをインストールし、既存のOracle WebCenter Discussions 10.1.3.xサーバーのデータベース・スキーマをOracle WebCenter PortalのDiscussion Server 11gにアップグレードする必要があります。

表7-2は、Oracle WebCenter PortalのDiscussion Server 11gへのOracle WebCenter Discussions 10.1.3.xのアップグレードに関するタスクを示したものです。

表7-2 Oracle WebCenter Discussionsをアップグレードするためのタスク

ステップ

必須/オプション

Oracle WebCenter Discussionsデータベース・スキーマのバックアップ

必須

SSO関連のシステム・プロパティの削除

必須(SSOが構成されている場合のみ)

Oracle WebCenter PortalのDiscussion Server 11gのインストール(インストールされていない場合)

必須

Oracle WebCenter Discussions 10.1.3.xで使用されるデータ・ストアからデータを読み取るためのOracle WebCenter PortalのDiscussion Server 11gのデータベース接続の変更

必須

Jive Forumsアップグレード・コンソールを使用したDiscussionsサーバーのアップグレード

必須

WS-Securityの構成

必須(SAMLが有効な場合のみ)

SSOの再構成

必須(SSOを有効にする必要がある場合のみ)

この項では、Oracle WebCenter Discussions 10.1.3.xからOracle WebCenter PortalのDiscussion Server 11gにアップグレードする方法について説明します。

Oracle WebCenter Discussions 10.1.3.xサーバーのアップグレードを準備する手順は、次のとおりです。

1. Oracle WebCenter Discussions 10gのデータベース・スキーマをバックアップします。

ヒント:

データベース・スキーマへのパスを検索するには、Oracle WebCenter Discussions管理コンソールに管理者としてログオンします。コンソールの上部にある「システム」リンクから、「システム情報」ページに移動します。このページの「データソース情報」セクションには、接続URLやユーザー名など、データベース・スキーマの様々な詳細が表示されます。

2. SSO関連のシステム・プロパティが構成されている場合は、削除します。

注意:

Oracle WebCenter PortalのDiscussion Server 11gでは、シングル・サインオン(SSO)構成がOracle WebCenter Discussions 10.1.3.xから変更されました。SSOがOracle WebCenter Discussions 10.1.3.xサーバー用に構成され、SSO関連のシステム・プロパティがOracle固有のSSOカスタム・クラスに設定されている場合は、SSO関連のエラーを回避するために、Oracle WebCenter PortalのDiscussion Server 11gをインストールする前にSSO構成を無効にする必要があります。Discussionsサーバーをアップグレードした後、SSO認証が必要な場合はSSOを再構成する必要があります。

SSO関連のシステム・プロパティを削除する手順は、次のとおりです。

1. 次のURL形式を使用して、Oracle WebCenter Discussions管理コンソールに管理者としてログオンします。

http://host:port/owc_discussions/admin

hostおよびportは、Oracle WebCenter Discussions 10gサーバーからデプロイされているサーバーおよびポート番号を表します。

2. Jive Forum管理コンソールの「システム」ページの右側にあるナビゲーション・パネルで、「システム・プロパティ」をクリックします。

3. Jiveプロパティ・ページの「すべてのプロパティ」で、AuthFactory.classNameシステム・プロパティがSSOのOracle固有のカスタム・クラスoracle.jive.sso.OracleSSOAuthFactoryに設定されている場合は、このシステム・プロパティを削除します。

4. UserManager.classNameシステム・プロパティがSSOのOracle固有のカスタム・クラスoracle.jive.sso.OracleSSOUserManagerに設定されている場合は、このシステム・プロパティを削除します。

Oracle WebCenter Discussions 10.1.3.xサーバーをOracle WebCenter PortalのDiscussion Server 11gにアップグレードする手順は、次のとおりです。

1. Oracle WebCenter PortalのDiscussion Server 11gがインストールされていることを確認します。
WebCenter Portal 11gのインストール中、またはその後のWebCenter Portalドメインの拡張中にOracle WebCenter PortalのDiscussion Server 11gのインストールを選択できます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイドを参照してください。

2. Oracle WebCenter Discussions 10.1.3.xサーバーで使用されるデータソースからデータを読み取るように、Oracle WebCenter PortalのDiscussion Server 11gのデータベース接続を変更します。データベース接続を編集するには、Oracle WebLogic Server管理コンソールを使用するか、またはOracle WebCenter Discussions 10.1.3.xサーバーのデータベース・スキーマをエクスポートまたはインポートします。
データベースのエクスポートおよびインポート・コマンドを使用してデータベース接続を構成するには、Oracle WebCenter Discussions 10.1.3.xサーバーのデータベース・スキーマをダンプ・ファイルにエクスポートします。その後、ダンプ・ファイルの内容を、Oracle WebCenter PortalのDiscussion Server 11gのRCUインストール中にインストールされたデータベース・スキーマにインポートします。

Oracle WebLogic Server管理コンソールを使用してデータベース接続を編集する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールに管理者としてログオンします。次のURL形式を使用します。

http://host:port/console

hostおよびportは、Oracle WebLogic Serverがインストールされているホスト名およびポート番号を表します。デフォルトでは、ポート番号は7001です。

2. Oracle WebLogic Server管理コンソールの「ドメイン構造」で、「サービス」→「データ・ソース」に移動します。

3. データ・ソースの概要ページの「データ・ソース」表で、「OWC_DiscussionsDS」接続リンクをクリックします。

4. 「DiscussionsDS」ページの「設定」で、「接続プール」タブをクリックします。
Oracle WebCenter Discussions 10.1.3.xサーバー・データ・ストアからデータを読み取るように、Oracle WebCenter PortalのDiscussion Server 11gのデータベース接続を変更します。

5. 「接続プール」タブの「URL」フィールドで、Oracle WebCenter Discussions 10.1.3.xで使用されるデータベースを指すようにJDBC URLを変更します。

6. 「プロパティ」フィールドで、ユーザー名をOracle WebCenter Discussions 10.1.3.xのデータベースへの接続に使用されるユーザー名に変更します。

7. 「パスワード」フィールドで、パスワードをOracle WebCenter Discussions 10.1.3.xのデータベースへの接続に使用されるパスワードに変更します。

8. 「保存」をクリックします。

3. Oracle WebCenter PortalのDiscussion Server 11gがデプロイされているWC_Collaboration管理対象サーバーを再起動します。

4. Oracle WebCenter PortalのDiscussion Server 11gに管理者としてログオンします。URL形式は、http://host:port/owc_discussionsを使用します。

5. Jive Forumsアップグレード・コンソールが表示される場合は、コンソールに管理者としてログオンします。

6. Jive Forumsアップグレード・コンソールで、データベースおよびJive Forum構成ファイルをバックアップしたかどうか、およびjiveHomeディレクトリの場所を確認するチェック・ボックスをすべて選択します。(図7-2)

図7-2 Jive Forumsアップグレード・コンソール

「図7-2 Jive Forumsアップグレード・コンソール」の説明

7. アップグレードの開始をクリックして、Discussionsサーバーのデータベース・スキーマをアップグレードします。
すべてのアップグレード・タスクが完了すると、確認メッセージが表示されます。

8. Oracle WebCenter PortalのDiscussion Server 11gがデプロイされているWC_Collaboration管理対象サーバーを再起動します。

9. 新しくアップグレードされたDiscussionsサーバーにアクセスします。

10. このDiscussionsサーバーをWebCenterアプリケーションと組み合せて使用する場合は、Oracle WebCenter PortalのDiscussion ServerおよびWebCenterアプリケーションでWeb Servicesセキュリティ(WS-Security)信頼認証を構成します。WS-Securityにより、WebCenterアプリケーションとDiscussionsサーバーの間に信頼関係が確立されます。
WS-Securityの構成方法の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための管理者ガイドのWS-Securityの構成に関する項を参照してください。

11. 必要に応じて、Oracle WebCenter PortalのDiscussion ServerのSSOを再構成します。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための管理者ガイドのシングル・サインオンの構成に関する項を参照してください。

7.6.2 Oracle Content Serverのアップグレード

注意:

この項では、該当する箇所で最近商標変更されたOracle WebCenter Portal製品名を使用しています。詳細は、第3.3.1項「Oracle WebCenterおよびOracle Enterprise Content Management Suiteの新規製品名」を参照してください。

Oracle WebCenter Portal 11gでは、外部コンテンツ・リポジトリとしてOracle Content Server 10.1.3.5.1およびOracle WebCenter Content Server 11gをサポートしています。すでにOracle Content Server 10gがインストールされている場合は、サポートされているバージョンにアップグレードする必要があります。

注意:

機能のフルセットを利用するためには、Oracle WebCenter Portal 11gのコンテンツ・リポジトリとしてOracle Content Server 11gを使用することをお薦めします。Oracle Content Server 10.1.3.5.1を使用した場合、アクセスできるのは機能のサブセットに対してのみです。詳細は、『Oracle Fusion Middlewareパッチ適用ガイド』のOracle Universal Content Management 10のアップグレードに関する項を参照してください。

アップグレードするOracle Content Serverのバージョンに応じて、次の項を参照してください。

- Oracle WebCenter Content Server 11gへのアップグレード

- Oracle Content Server 10.1.3.5.1へのアップグレード

7.6.2.1 Oracle WebCenter Content Server 11gへのアップグレード

Oracle WebCenter Content Server 11gを使用する手順は、次のとおりです。

1. 既存のOracle Content Server 10gインストールをContent Server 11gにアップグレードします。詳細は、Oracle Fusion Middleware Oracle WebCenter Contentアップグレード・ガイドを参照してください。
Oracle Content Serverがインストールされていない場合は、Oracle WebCenter Content Server 11gをインストールしてください。詳細は、Oracle WebCenter Contentインストレーション・ガイドを参照してください。

2. Content Server 11gをOracle WebCenter Portal用に構成します。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための管理者ガイドのContent Serverの構成の前提条件に関する項を参照してください。

3. FrameworkFoldersを無効にし、folders_gを有効にします。
Oracle Content Server 10gをOracle WebCenter Content Server 11gにアップグレードすると、FrameworkFoldersが有効になりすぐに使用できます。Content Server 11gをWebCenter Portal 11g用に構成するには、FrameworkFoldersを無効にしてfolders_gを有効にする必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための管理者ガイドの必須コンポーネントの有効化に関する項を参照してください。

注意:

Content Server 11gの場合、コントリビューション・フォルダ(Folders_gコンポーネント)のかわりにフォルダ・インタフェースとしてフォルダ(FrameworkFoldersコンポーネント)をお薦めします。しかし、WebCenter PortalではまだFolders_gフォルダ機能が使用されます。したがって、Content Server 11gをWebCenter Portalのコンテンツ・リポジトリとして使用するには、Folders_gを有効にしてFrameworkFoldersを無効にする必要があります。Content Server 11gインスタンス上で両方を有効にすることはできません。

7.6.2.2 Oracle Content Server 10.1.3.5.1へのアップグレード

既存のOracle Content Server 10gインストールにOracle Content Server 10.1.3.5.1へのパッチを適用するには、最新のUpdateBundleとFolders_gコンポーネントをインストールする必要があります。このために必要な手順は、次のとおりです。

1. 次のサイトから最新のUpdateBundleであるCS10gR35UpdateBundleコンポーネントをダウンロードします。
http://support.oracle.com

2. 最新のUpdateBundleをインストールし、次にFolders_gをインストールします。
更新バンドルには、Folders_gを含む他の様々なコンポーネントのzipファイルが格納されています。更新バンドルをインストールすると、zipファイルは次のディレクトリに抽出されます。

content_server_install_home/custom/CS10gR35UpdateBundle/extras

インストールの詳細は、次のサイトに掲載されているContent Serverコンポーネントの使用ガイドの、コンポーネントのアップロードに関する項を参照してください。

http://download.oracle.com/docs/cd/E10316_01/cs/cs_doc_10/documentation/developer/using_components_10en.pdf

3. 必要に応じて、Oracle Content Server 10.1.3.5.1を構成します。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための管理者ガイドのOracle Content Server 10.1.3.5.1の構成に関する項を参照してください。

7.6.3 Oracle WebCenter Wiki and Blog Serverデータの移行

Wikiおよびブログ機能をサポートするために、WebCenter Portal 11gはOracle Content Server 11gに依存しているのに対し、Oracle WebCenter 10gはOracle WebCenter Wiki and Blog Serverに依存しています。Oracle WebCenter 10g環境でOracle WebCenter Wiki and Blog Serverが構成されている場合、すべてのWikiデータおよびブログ・データをContent Server 11gに移行する必要があります。詳細は、第15.5.1項「Oracle WebCenter Wiki and Blog Serverからのデータの移行」を参照してください。

第III部

Oracle SOA Suite、Oracle WebCenterおよびADFアプリケーションのアップグレード

第III部は次の章で構成されています。

- 第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」

- 第9章「すべてのOracle SOAアプリケーションのアップグレード時の考慮事項」

- 第10章「Oracle BPEL Process Managerアプリケーションのアップグレード」

- 第11章「Oracle Business Activity Monitoringアプリケーションのアップグレード」

- 第12章「Oracle B2Bアプリケーションのアップグレード」

- 第13章「Oracle Web Services ManagerのポリシーおよびOC4Jセキュリティ環境のアップグレード」

- 第14章「その他のOracle SOA Suiteテクノロジのアップグレード」

- 第15章「Oracle WebCenterアプリケーションのアップグレード時の考慮事項」

- 第16章「その他のOracle WebCenterアップグレードの詳細」

8 Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要

Oracle Fusion Middleware環境をインストールしてアップグレードした後は、Oracle Application Server 10g リリース2(10.1.2)および10g リリース3(10.1.3)のアプリケーションをアップグレードして、新規のOracle Fusion Middlewareトポロジに再デプロイできます。

この章では、Oracle SOA Suite、WebCenterおよびJava EEアプリケーションをOracle Fusion Middleware 11gへ移行し再デプロイするための推奨プロセスについて説明します。

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

- タスク1: サンプル・アプリケーションでのアップグレード手順の確認

- タスク2: アプリケーションがOracle Application Server 10g上で正常に稼働していることの確認

- タスク3: アップグレードするアプリケーションのタイプに固有の考慮事項の確認

- タスク4: 10g環境から11g環境へのアップグレードが完了していることの確認

- タスク5: Oracle JDeveloper 11gのインストールと起動

- タスク6: Oracle Jdeveloperでアプリケーションを開いてアップグレード

- タスク7: 使用しているアプリケーションのコンポーネントに関するアップグレード情報の検索

- タスク8: アプリケーションの確認および再コンパイル

- タスク9: アプリケーションのデプロイ

8.1 タスク1: サンプル・アプリケーションでのアップグレード手順の確認

カスタムOracle SOA Suite、Oracle WebCenterまたはOracle ADFアプリケーションのアップグレードを開始する前に、典型的なサンプル・アプリケーションのアップグレードで、ひととおりの手順を確認することを検討してください。

- 大規模なアップグレードを実行する前にサンプル Oracle ADFアプリケーションのアップグレードを試す場合は、Oracle Technology Network(OTN)から情報を入手できます。ここでは、ADF Facesコンポーネントを使用するADF 10.1.3 JSFアプリケーションである SRDemoサンプル・アプリケーションをOracle JDeveloper 11gへ移行する方法の詳細が説明されています。
詳細は、 Oracle Technology Network (OTN)で提供されている10.1.3 SRDemoサンプルの11gへの移行に関する説明を参照してください。

http://www.oracle.com/technology/products/jdev/tips/muench/1013srdemo/index.html

- サンプルOracle SOA Suite 10gアプリケーションのアップグレードのステップ全体を確認する場合は、付録A「例: SOA Order Bookingのアップグレードと再デプロイ」を参照してください。

8.2 タスク2: アプリケーションがOracle Application Server 10g上で正常に稼働していることの確認

Oracle Application Server 10gアプリケーションをOracle Fusion Middleware 11gに再デプロイする前に、アプリケーションがOracle Application Server 10g上に正常にデプロイされていて、アプリケーションの全コンポーネントが現在稼働していることを確認する必要があります。

特に、アプリケーションが依存している外部参照が現在稼働していて、使用できる状態であることを確認する必要があります。たとえば、外部Webサービスに依存するアプリケーションがある場合、11gのアップグレードと再デプロイの処理を開始するときに、それらのWebサービスは稼働中である必要があります。

このステップは次の2つの理由から必要になります。

- Oracle Fusion Middleware 11gのアップグレードおよび再デプロイの失敗の原因となる10g環境の問題がアプリケーションに含まれていないことの確認。

- アプリケーションのソース・コードの外部参照を再定義するために必要な作業量の削減。
たとえば、Oracle Enterprise Service Busプロジェクトで外部BPELプロセスを呼び出す場合、10g リリース3(10.1.3)のBPELプロセスが稼働していて、Oracle Enterprise Service Busアプリケーションをアップグレードする際に使用できる状態であることが重要です。

使用できる状態になっていない場合、外部参照が新しい11g BPELプロセスを指すようにアップグレード前にOracle Enterprise Service Busプロジェクトを変更する必要があります。外部参照が使用できない場合、Oracle JDeveloper 11gへのアップグレードは失敗します。

Oracle JDeveloper 11gの開発機能によって、Oracle JDeveloper 11gにアップグレードした後にこのタスクを実行すると、外部参照の再定義プロセスがより容易になり、一部が自動化されます。

特定のデモ・アプリケーション(SOA Order Bookingデモ・アプリケーション)の外部パートナを識別および確認する方法の例は、A.2.3項「タスク1c: すべての外部パートナが使用可能であることの確認」を参照してください。

8.3 タスク3: アップグレードするアプリケーションのタイプに固有の考慮事項の確認

各10gアプリケーションのアップグレード・プロセスを開始する前に、Oracle Application Server 10g上でアプリケーションを開発およびデプロイする際に使用したテクノロジとOracle SOA SuiteおよびWebCenterの機能のリストを作成します。

次に、このマニュアルの他の章に記載されている、アプリケーションに関連する情報を確認します。他の章には、Oracle SOA SuiteおよびWebCenterの特定の機能をOracle Fusion Middleware 11gにアップグレードする際に必要な情報が記載されています。

各章は、アプリケーションを開発およびデプロイする際に使用したコンポーネントおよび各種テクノロジ別にまとめられています。したがって、特定のタイプのアプリケーションに該当する章および項を参照できます。

8.4 タスク4: 10g環境から11g環境へのアップグレードが完了していることの確認

アプリケーションを11gにアップグレードする前に、Oracle SOA Suite、WebCenterおよびADFの各環境についてアップグレード・タスクを実行する必要があります。詳細は、第II部「Oracle SOA Suite、WebCenterおよびADF環境のアップグレード」を参照してください。

特に、環境のアップグレードの一部として次の作業を完了していることが必要です。

- 新しいOracle Fusion Middleware 11g環境が稼働していることの確認。

- OC4J構成設定のOracle Fusion Middleware 11gへの適用。これには、Oracle Fusion Middleware 11gに再デプロイするアプリケーションに必要なデータ・ソースやシステム・プロパティなどの構成設定が含まれます。

注意:

Oracle B2B関連のBPELプロジェクト・ノートをアップグレードする前に、第12.3.3項「B2B関連のOracle BPELプロセスのアップグレード時の考慮事項」を参照してください。

8.5 タスク5: Oracle JDeveloper 11gのインストールと起動

Oracle JDeveloper 11gのダウンロード、インストールおよび起動についての手順は、『Oracle Fusion Middleware Oracle JDeveloperインストレーション・ガイド』を参照してください。

Oracle JDeveloper 11gを起動後、開発するアプリケーションに対するOracle JDeveloperの拡張子が適切であることを確認します。詳細は、次の項を参照してください。

- 第9.2項「Oracle SOA Suiteアプリケーションに対するOracle JDeveloper 11g移行ウィザードの使用」

- 第15.2項「WebCenterアプリケーションのアップグレードの前提条件」

注意:

アプリケーション設定をJDeveloper 10.1.3.xから移行する場合は、Oracle JDeveloper 11gを初めて起動する前に、Oracle JDeveloper 10.1.3.xからWebCenterアプリケーションを終了して削除し、WebCenter Oracle JDeveloper 11gの拡張機能をインストールします。

アプリケーションをOracle JDeveloperから削除するには、アプリケーション・ナビゲータでアプリケーション名を右クリックし、ショートカット・メニューから「削除」を選択します。アプリケーションを削除すると、アプリケーションはOracle JDeveloperのみから削除され、ディスクからは削除されません。

8.6 タスク6: Oracle Jdeveloperでアプリケーションを開いてアップグレード

Oracle Application Server 10gのOracle SOA Suite、WebCenterおよびADFのアプリケーションにはそれぞれ、Oracle JDeveloper 10gワークスペース・ファイル(.jws)があります。以前のバージョンのOracle JDeveloperのワークスペースを開くと、移行ウィザードによってアプリケーションが自動的にOracle Fusion Middleware 11gにアップグレードされます。

この方法では、より少ない時間と労力で、Oracle Fusion Middleware 11gでサポートされている新しいバージョンのJavaテクノロジに移行することができます。

次の手順に従って、Oracle JDeveloper 10gワークスペースをOracle JDeveloper 11gで開きます。

1. Oracle JDeveloper 10g リリース3(10.1.3.1.0)で管理できるプロジェクトのコピーを、ディスク上の別のフォルダまたはディレクトリに保存します。
Oracle JDeveloperでは、すべてのプロジェクト・ディレクトリについて、Oracle JDeveloper 11gにインポートしアップグレードする際、バックアップを取ります。それでも、最善の開発方法として、アップグレード処理の開始前に作業のバックアップを取ることをお薦めします。

Oracle JDeveloperでは、プロジェクト・ディレクトリのみバックアップが取られ、ワークスペース・ファイル(.jws)はバックアップが取られません。また、ワークスペースをOracle JDeveloper 11gで開いてアップグレードした後は、アップグレードしたワークスペースのコピーを以前のバージョンのOracle JDeveloperで開くことはできなくなります。

したがって、元のアプリケーションまたはプロジェクトをリストアする必要がある場合は、アプリケーション・ディレクトリ構造全体のアップグレード前の独自のバックアップからアプリケーションをリストアすることをお薦めします。

2. 「ファイル」メニューから「開く」を選択し、Oracle JDeveloper 10gの.jwsファイルを選択します。
ワークスペース・ファイルを選択するときは、常に使用可能なディレクトリ・ロケーションでアプリケーション・ソース・コードを使用できるようにします。たとえば、ネットワーク・ドライブ・パス(\\110.34.40.43\share\Samples\mysample.jwsなど)に格納されているプロジェクトはアップグレードしないでください。

移行ウィザードのステップ1の「ようこそ」ページが表示されます。

3. 画面の指示に従い、プロジェクト・ファイルおよび選択したJavaテクノロジをOracle JDeveloperリリース11gおよびOracle Fusion Middleware 11gに移行します。

4. Oracle JDeveloperのホーム・ディレクトリ内の次のディレクトリにあるアプリケーション移行ログ・ファイルを確認します。
UNIXシステムの場合

JDEV_HOME/JDeveloper/upgrade/logs/

Windowsシステムの場合

JDEV_HOME\JDeveloper\upgrade\logs\

注意:

個別のOracle JDeveloper 10gプロジェクト(.jpr)ファイルをアップグレードすることもできます。ただし、.jprファイルをアップグレードする際には次の手順に従うことをお薦めします。

1. Oracle JDeveloper 11gを起動します。

2. Oracle JDeveloper 11gで新しいアプリケーションを作成します。

3. .jprファイルが新しく作成したアプリケーション内のプロジェクトになるように、ファイルをアプリケーション内から開きます。

8.7 タスク7: 使用しているアプリケーションのコンポーネントに関するアップグレード情報の検索

ここでは、Oracle SOA Suite、WebCenterおよびADFアプリケーションをアップグレードして、Oracle Fusion Middleware 11gに再デプロイするための手順の概要を説明します。

ここで説明する一般的なタスクの他にも、実行する必要のあるアップグレード・タスクや重要な考慮事項があります。

Oracle SOA Suite、WebCenterおよびADFの各アプリケーションに関係する特別な考慮事項について、このマニュアルの他の章を参照して確認してください。

各章は、アプリケーションを開発およびデプロイする際に使用したコンポーネントおよび各種テクノロジ別にまとめられています。したがって、特定のタイプのアプリケーションに該当する章および項を参照できます。

8.8 タスク8: アプリケーションの確認および再コンパイル

Oracle JDeveloper 11gでアプリケーションを開いた後、次のタスクを実行する必要があります。

1. Oracle JDeveloper 11gの「ファイル」メニューから「すべて保存」を選択し、すべてのプロジェクトを選択したワークスペースに保存します。

2. 「ビルド」メニューから「すべてメイク」を選択し、ワークスペース内のすべてのプロジェクトを再コンパイルするか、一度に1つのプロジェクトを右クリックして「project_nameのメイク」を選択します。

3. Oracle JDeveloperのウィンドウ下部に表示されるコンパイラ・メッセージのウィンドウの出力を確認します。

4. 各コンパイラ・エラーのエラー・アイコンをダブルクリックして、問題のコードを調査します。
詳細は、Oracle Fusion Middleware 11gドキュメント・ライブラリにある適切な開発者向けドキュメントを参照してください。Oracle Fusion Middleware 11gドキュメント・ライブラリは、次の場所にあるOracle Technology Network(OTN)から入手できます。

http://www.oracle.com/technology/documentation/

8.9 タスク9: アプリケーションのデプロイ

入手可能なリソースを確認し、アプリケーションの各プロジェクトを正常に再コンパイルした後は、このアプリケーションをOracle Fusion Middleware 11gにデプロイできます。

アプリケーションのデプロイの詳細は、次のリソースを参照してください。

- Java EEアプリケーションのOracle WebLogic Serverへのデプロイの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。

- Oracle ADF アプリケーションのデプロイの詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』のFusion Webアプリケーションのデプロイに関する項を参照してください。

- Oracle Fusion Middleware環境でのアプリケーションのデプロイに関する一般情報は、『Oracle Fusion Middleware管理者ガイド』のデプロイメント・プロセスの理解に関する項を参照してください。

9 すべてのOracle SOAアプリケーションのアップグレード時の考慮事項

この章では、Oracle SOAアプリケーションをOracle Fusion Middleware 11gにアップグレードする際に重要な追加情報について説明します。

Oracle SOA Suite、WebCenterおよびADFの各アプリケーションのアップグレード時に必要となる主なタスクは、第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」で説明しています。

ここでは、Oracle SOAアプリケーションのアップグレードのみに該当するタスクについて説明します。

- すべての外部パートナが使用可能であることの確認

- 第9.2項「Oracle SOA Suiteアプリケーションに対するOracle JDeveloper 11g移行ウィザードの使用」

- 第9.3項「すべてのJavaアプリケーションに関連するアップグレード・タスク」

- 第9.4項「すべてのOracle SOA Suiteアプリケーションに関連するアップグレード・タスク」

9.1 すべての外部パートナが使用可能であることの確認

Oracle SOA Suiteアプリケーションを11gにアップグレードする前に、外部パートナが(リモートWebサービスの形態で)稼働していて使用可能であることを確認する必要があります。

Oracle JDeveloper 11gがこれらの外部パートナにアクセスでき、Oracle BPEL Process Managerと、10gにデプロイされているOracle Enterprise Service Busの各サービスにアクセスできることが必要です。アクセスできない場合、アプリケーション内のプロジェクトを11gに正しく移行できません。

必要なWebサービスが使用可能であることを確認するには、11gへの移行前にOracle SOA Suiteアプリケーションの各プロジェクトを調査する必要があります。たとえば、各プロジェクトのOracle BPEL Process Manager構成ファイルを確認し、これらの構成ファイルから参照されているWebサービスのURIが有効で稼働していることを確認します。

9.2 Oracle SOA Suiteアプリケーションに対するOracle JDeveloper 11g移行ウィザードの使用

Oracle JDeveloper 11gでOracle Application Server 10g Oracle SOA Suiteアプリケーションを開くと、Oracle JDeveloper移行ウィザードによって、Oracle Fusion Middleware 11gへの自動アップグレードが試行されます。

ただし、Oracle JDeveloper 移行ウィザードで自動的に実行できるタスクには制限があります。移行ウィザードの使用前または使用後にOracle SOA Suiteアプリケーションで必要となる可能性のある手動タスクのタイプについては、この章の該当する項を参照してください。

最新のパッチ・セットの適用

最もよい結果を得るために、11gにアップグレードする前に、Oracle SOA Suite環境に最新のパッチ・セットを適用し、最新のOracle JDeveloper 10g リリース3 (10.1.3)を使用することをお薦めします。

Oracle JDeveloperとOracle SOA Suiteのバージョン・レベルの統一

原則として、 Oracle SOA SuiteとOracle JDeveloperは常に同時にインストールを更新して、これらのOracle製品を同じバージョンで実行するようにしてください。

Oracle JDeveloperに必要なSOAコンポジット・エディタ拡張機能がインストールされていることの確認

Oracle SOA Suiteアプリケーションを11gにアップグレードするには、Oracle JDeveloper 11gに対応するOracle SOAコンポジット・エディタ拡張機能がインストールされている必要があります。

この拡張機能がインストールされていることを確認するには、Oracle JDeveloperの「ヘルプ」メニューから「バージョン情報」を選択し、「バージョン」タブをクリックします。コンポーネントのリストに「SOAコンポジット・エディタ」というエントリが表示されます。

「バージョン情報」ダイアログ・ボックスの「バージョン」タブにこのコンポーネントが表示されない場合は、「バージョン情報」ダイアログを閉じて、「ヘルプ」メニューから「更新の確認」を選択します。更新の確認ウィザードを使用して、最新バージョンの「SOAコンポジット・エディタ」拡張機能を検索し、インストールします。

9.3 すべてのJavaアプリケーションに関連するアップグレード・タスク

Oracle SOA Suiteアプリケーションをアップグレードする前に、『Oracle Fusion Middleware Java EEアップグレード・ガイド』を参照してください。このガイドには、標準Java EEアプリケーションのOracle WebLogic Serverへのアップグレードに関する情報が記載されています。

アプリケーションにカスタムJavaコードが含まれている場合は、『Oracle Fusion Middleware Java EEアップグレード・ガイド』に記載されている手順と推奨事項に従ってJavaコードを確認してください。

9.4 すべてのOracle SOA Suiteアプリケーションに関連するアップグレード・タスク

Oracle SOA SuiteアプリケーションをOracle Fusion Middleware 11gにアップグレードする際には、次の説明を参照してください。

- Oracle Fusion Middleware 11gにおけるOracle SOA Suite APIの変更について

- 依存JARファイルに関するプロジェクトの確認

- Webサービス用のプロキシ設定を必要とするアプリケーションのアップグレード

- 移行ウィザードによってアップグレードされないbuild.xmlおよびbuild.propertiesファイルの再作成

- UDDIに登録されているリソースを使用するプロジェクトのアップグレード

- Oracle SOA Suiteのユーザー定義(カスタム)XPath関数のアップグレード

- Oracle SOA Suite 11gのファイル・ネーミング規則の理解

- Oracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法

- Oracle SOA Suite 10g相互参照(XREF)ランタイム・データの11gへのアップグレード

9.4.1 Oracle Fusion Middleware 11gにおけるOracle SOA Suite APIの変更について

表9-1は、Oracle SOA Suiteアプリケーションで使用できるAPIを示しています。この表には、Oracle Application Server 10gの各APIについて、Oracle Fusion Middleware 11gにおける変更の概要と、各APIを使用するアプリケーションのアップグレードに関する詳細の参照先が記載されています。

表9-1 Oracle Fusion Middleware 11gにおけるOracle SOA Suite APIの変更の概要

10gのAPI

11gに対するアクション

11gのJava関連ドキュメント

Oracle Application Server Integration B2B Callouts Java API

Oracle Fusion Middleware 11g用に更新されましたが、新しい11gバージョンは10gと下位互換性があります。

Oracle Fusion Middleware B2BコールアウトJava APIリファレンス

Oracle BPEL Process Manager Workflow Services API

Oracle Fusion Middleware 11g用に更新されましたが、新しい11gバージョンは10gと下位互換性があります。

Oracle Fusion Middleware Oracle SOA Suiteワークフロー・サービスJava APIリファレンス

Oracle Business Rules Java API

第9.4.1.1項「Oracle Business Rules用のOracle Fusion Middleware Java APIへのアップグレード」を参照してください。

Oracle Fusion Middleware Oracle Business RulesのJava APIリファレンス

Oracle BPEL Process Manager Client Java API

第9.4.1.2項「Oracle SOA Suite用のOracle Fusion Middleware Infrastructure Management Java APIへのアップグレード」を参照してください。

第9.4.1.2項「Oracle SOA Suite用のOracle Fusion Middleware Infrastructure Management Java APIへのアップグレード」を参照してください。

Oracle BPEL Process Manager Sensor API

Oracle Fusion Middleware 11g用に更新されましたが、新しい11gバージョンは10gと下位互換性があり、新しいInfrastructure Management Java APIの一部です。

『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BPEL Process Managerセンサーの使用に関する項

9.4.1.1 Oracle Business Rules用のOracle Fusion Middleware Java APIへのアップグレード

次の項では、Oracle Business Rules 11gのSDKとAPIの概要を示し、Oracle Business Rules APIへのアップグレードに関する手順を説明します。

- 11gにおけるOracle Business Rules SDKおよびAPIの変更の概要

- 開発環境でのディクショナリへのアクセス

- 本番環境でのリポジトリへのアクセス

- RLコードの生成

- WebDAVのOracle Business Rulesプロジェクトのアップグレード

9.4.1.1.1 11gにおけるOracle Business Rules SDKおよびAPIの変更の概要

Oracle Fusion Middleware11gでは、Oracle Business RulesのSDKとAPIが大幅に改善されています。

Oracle Application Server 10gでは、開発者は、リポジトリへのアクセスとRuleSessionインスタンスの作成および使用を手動で管理する必要がありました。Oracle Fusion Middleware 11gでは、Decision Point APIとデジション関数機能により、ルールの定義と実行を容易にするインタフェースと実装が提供されます。

Oracle Business Rules 11gにアップグレードする際には、最初に『Oracle Fusion Middleware Oracle Business Rulesユーザーズ・ガイド』を参照してこれらの新機能の使用方法を確認してください。

ただし、11gでも従来と同様にOracle Business Rules SDKを使用する場合は、次の項に、Oracle Business Rules 10g SDKを11g SDKに直接変換する方法を示します。

ここで説明するすべてのクラスは、rulesdk2.jarファイルに格納されており、oracle.rules.sdk2パッケージの下にあります。

9.4.1.1.2 開発環境でのディクショナリへのアクセス

Oracle Business Rules 10gでは、アプリケーション開発者は、アプリケーションの開発中にはファイルベースのリポジトリを使用し、本番環境でWebDAVリポジトリの使用に切り替えるのが一般的でした。

Oracle Business Rules 11gでは、MDSにデプロイ可能な形式にパッケージ化する前に、ルール・ディクショナリ・ファイルに直接アクセスできます。

次の例では、10gで開発モードでディクショナリにアクセスするために必要なコード(例9-1)と、11gで必要なコード(例9-2)を比較します。

一般的には、従来のように RuleRepositoryに直接アクセスするのではなく、 Decision Point APIを使用してください。

例9-1 Oracle Business Rules 10gを使用した開発環境でのディクショナリへのアクセス

String path; // the path to the file repository
Locale locale; // the desired Locale
// The following code assumes that the path and locale have been set appropriately
RepositoryType rt =
RepositoryManager.getRegisteredRepositoryType("oracle.rules.sdk.store.jar");
RuleRepository repos = RepositoryManager.createRuleRepositoryInstance(rt);
RepositoryContext rc = new RepositoryContext();
rc.setLocale(locale);
rc.setProperty("oracle.rules.sdk.store.jar.path", path);
repos.init(rc);

例9-2 Oracle Business Rules 11gを使用した開発環境でのディクショナリへのアクセス

protected static final String DICT_LOCATION ="C:\\scratch\\CarRental.rules";
...
RuleDictionary dict = null;
Reader reader = null;
try {
reader = new FileReader(new File(DICT_LOCATION));
dict = RuleDictionary.readDictionary(reader, new
DecisionPointDictionaryFinder(null));
List<SDKWarning> warnings = new ArrayList<SDKWarning>();
dict.update(warnings);
if (warnings.size() > 0 ) {
System.err.println("Validation warnings: " + warnings);
}
} catch (SDKException e){
System.err.println(e);
} catch (FileNotFoundException e){
System.err.println(e);
} catch (IOException e){
System.err.println(e);
} finally {
if (reader != null) {
try { reader.close(); } catch (IOException ioe)
{ioe.printStackTrace();}
}
}

9.4.1.1.3 本番環境でのリポジトリへのアクセス

Oracle Business Rules 10gでは、推奨される本番リポジトリはWebDAVでした。

Oracle Business Rules 11gでは、WebDAVはサポートされなくなり、メタデータ・サービス(MDS)が推奨リポジトリになります。また、ディクショナリの名前とバージョンは、(Javaクラスのネーミング方式と同様に)パッケージと名前に置き換えられました。

Oracle Business Rules 10gのバージョンでは、真のバージョニングは提供されませんでした。Oracle Business Rules 11gでは、バージョンを指定する方法として単に名前を変更します。たとえば、名前がfoo.bar.MyDict、バージョンが2の10gのディクショナリは、11gではfoo.barとしてパッケージ化され、MyDict2という名前が付きます。

次の例では、10gで本番モードでディクショナリにアクセスするために必要なコード(例9-3)と、11gで必要なコード(例9-4)を比較します。

例9-3 Oracle Business Rules 10gを使用した本番環境でのディクショナリへのアクセス

String url; // the URL for the WebDAV repository
Locale locale; // the desired Locale
// The following code assumes that the url and locale have been set appropriately
RepositoryType rt =
RepositoryManager.getRegisteredRepositoryType("oracle.rules.sdk.store.webdav");
RuleRepository repos = RepositoryManager.createRuleRepositoryInstance(rt);
RepositoryContext rc = new RepositoryContext();
rc.setLocale(locale);
rc.setProperty("oracle.rules.sdk.store.webdav.url", url);
repos.init(rc);
RuleDictionary dictionaryWithInitialVersion =
repos.loadDictionary(dictionaryName);
RuleDictionary dictionarySpecificVersion = repos.loadDictionary(dictionaryName,
dictionaryVersion);

例9-4 Oracle Business Rules 11gを使用した本番環境でのディクショナリへのアクセス

import static
oracle.rules.sdk2.repository.RepositoryManager.createRuleRepositoryInstance;
import static
oracle.rules.sdk2.repository.RepositoryManager.getRegisteredRepositoryType;
import static oracle.rules.sdk2.store.mds.Keys.CONNECTION;
...
private static final String DICT_PKG = "oracle.middleware.rules.demo";
private static final String DICT_NAME = "CarRental";
private static final DictionaryFQN DICT_FQN =
new DictionaryFQN(DICT_PKG, DICT_NAME);
...
RuleRepository repo =
createRuleRepositoryInstance(getRegisteredRepositoryType(CONNECTION));
repo.init(new RepositoryContext() {{
setDictionaryFinder(new DecisionPointDictionaryFinder(null));
}});
RuleDictionary dict = repo.load(DICT_FQN);

9.4.1.1.4 RLコードの生成

次の例は、Oracle Business Rules 10gでRLコードを生成するために必要なコードを示しています。11gでも、このコードは同じです。

//init a rule session
String rsname = "vehicleRent";
String dmrl = dict.dataModelRL();
String rsrl = dict.ruleSetRL( rsname );

9.4.1.1.5 WebDAVのOracle Business Rulesプロジェクトのアップグレード

WebDAVを含むOracle Business Rules 10gプロジェクトをアップグレードする場合は、Oracle Business Rules 11gへのアップグレードにJava JDKを使用することをお薦めします。JVMとしてOracle JRockitを使用している場合、アップグレード・プロセスが停止してしまいます。

9.4.1.2 Oracle SOA Suite用のOracle Fusion Middleware Infrastructure Management Java APIへのアップグレード

Oracle SOA Suite 11gでは、Oracle SOA Suite 10gで提供されていたいくつかのAPIを置換する、新しいインフラストラクチャ管理APIが導入されています。

新しいAPIの詳細は、Oracle Fusion Middleware 11gのドキュメント・ライブラリで提供されている『Oracle Fusion Middlewareリリース・ノート』を参照してください。

9.4.2 依存JARファイルに関するプロジェクトの確認

カスタムJARファイル・ライブラリの参照に依存するOracle SOA Suiteアプリケーションをアップグレードする場合は、Oracle JDeveloper 11gでアプリケーションを開いてアップグレードするときに、これらの参照は自動的にアップグレードされない可能性があることに注意してください。

このため、これらの依存タイプに関してプロジェクトを確認し、アップグレード後に、Oracle JDeveloper 11gの「プロジェクト・プロパティ」ダイアログで「ライブラリとクラスパス」リンクを選択して、不足している参照を追加してください。

9.4.3 Webサービス用のプロキシ設定を必要とするアプリケーションのアップグレード

会社のファイアウォールの外にあるWebサービス・リソースを使用するアプリケーションをアップグレードする場合は、アップグレード・プロセスがプロキシ設定にアクセスしてアプリケーションのアップグレード中に適切な調整を行えるように、構成ファイルを変更する必要があります。

アップグレード処理中にプロキシを使用するようにOracle JDeveloper 11gを構成する手順は、次のとおりです。

1. JDEV_HOME/binディレクトリで、次のファイルを検索します。

ant-sca-upgrade.xml

2. ファイルを編集し、次の設定を変更して、アップグレードするアプリケーションのWebサービス・アドレスを解決するために必要なプロキシ・サーバーとポートを識別できるようにします。

<jvmarg value="-Dhttp.proxySet=true"/>
<jvmarg value="-Dhttp.proxyHost=PROXY_SERVER"/>
<jvmarg value="-Dhttp.proxyPort=PROXY_PORT"/>

これらの設定を変更する場所は、ファイル内に2つあります。ESBプロジェクトをOracle Mediator 11gにアップグレードする場合にプロキシを設定するために使用する場所と、Oracle BPEL Process Managerプロジェクトをアップグレードする場合に使用する場所です。

3. Oracle JDeveloper 11gを終了してから再起動して変更を有効にし、Oracle JDeveloper 11gでアプリケーションを開いてアップグレードします。

9.4.4 移行ウィザードによってアップグレードされないbuild.xmlおよびbuild.propertiesファイルの再作成

Oracle JDeveloper 11gでアプリケーションを開いてアップグレードする場合、アプリケーションのプロジェクトに関連付けられているbuild.xmlファイルとbuild.propertiesファイルはアップグレードされません。

このため、アップグレード後にOracle JDeveloper 11gでこれらのファイルを再作成する必要があります。

9.4.5 UDDIに登録されているリソースを使用するプロジェクトのアップグレード

次の情報は、Oracle BPEL Process ManagerまたはOracle Enterprise Service Bus 10gのプロパティが、Oracle Service Registry(OSR)など、Universal Description, Discover and Integration(UDDI)レジストリに登録されているリモート・リソースを使用する場合に重要です。

詳細は、次の各項を参照してください。

- アップグレード前にserviceKeyエンドポイントが使用可能であることの確認

- orauddiプロトコルの変更

9.4.5.1 アップグレード前にserviceKeyエンドポイントが使用可能であることの確認

10g リリース3(10.1.3)のプロジェクトがOSRのserviceKeyを使用するエンドポイントURLを参照している場合は、アプリケーションをアップグレードする際に、エンドポイントURLが使用可能であることを確認する必要があります。使用可能でないと、アプリケーションのアップグレードは失敗します。このような失敗を回避するために、エンドポイントURLが使用可能であることを確認し、必要に応じて、bpel.xmlまたはルーティング・サービスでアクセス可能な新しいURLを指し示すようにエンドポイントURLを変更してください。

9.4.5.2 orauddiプロトコルの変更

Oracle Application Server 10g リリース3(10.1.3)では、Oracle BPEL Process ManagerとOracle Enterprise Service Busのプロジェクトは、uddiプロトコルを使用してOSRからリソース参照を取得していました。Oracle Fusion Middleware 11gでは、Oracle BPEL Process ManagerとOracle Mediatorのプロジェクトはorauddiプロトコルを使用します。

このため、Oracle BPEL Process ManagerまたはOracle Enterprise Service Busのプロジェクトをアップグレードする前に、次のことを実行する必要があります。

1. サービス・レジストリを使用して登録されているサービスを変更し、Oracle Fusion Middleware 11gでサポートされる新しいバインディングを使用するようにします。
たとえば、OSRで次の手順を実行します。

1. Oracle Service Registryにログインします。

2. 「検索」タブで、「ビジネス」をクリックします。

3. 「名前の追加」をクリックして、名前別にビジネスを検索します。

4. 検索結果で、変更するビジネスの名前をクリックします。

5. 「ビジネスの表示」ページの左側のペインで、変更するサービスを右クリックし、コンテキスト・メニューから「バインディングの追加」を選択します。

6. 「バインディングの追加」ページの「タイプ」ドロップダウン・メニューから「wsdlDeployment」を選択します。「アクセス・ポイント」フィールドにURLを入力します。
例:

http://machine:port/Proj_ep?WSDL/

7. 「バインディングの追加」をクリックします。

8. 「変更の保存」をクリックします。

2. Oracle JDeveloper 11gで、アプリケーションを開いてアップグレードします。

3. Oracle JDeveloperで、アップグレードしたプロジェクトのcomposite.xmlファイルを編集し、リソース・パレットの「UDDIレジストリ」オプションを使用してエンドポイントURLを構成します。

UDDIレジストリの詳細は、次のURLを参照してください。

http://www.oracle.com/technology/tech/soa/uddi/index.html

9.4.6 Oracle SOA Suiteのユーザー定義(カスタム)XPath関数のアップグレード

Oracle JDeveloper 11gでアプリケーションを開いてアップグレードする場合、アプリケーション・プロジェクトのカスタムXPath関数は、自動的にアップグレードされません。

このため、アプリケーションをアップグレードした後、すべてのXPath関数クラスをサーバーのクラスパスにコピーし、サーバーの構成ファイルに関数を登録する必要があります。Oracle JDeveloperの移行ウィザードではサーバー情報を想定できないため、このステップは手動で行う必要があります。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のユーザー定義XPath拡張関数の作成に関する項を参照してください。

9.4.7 Oracle SOA Suite 11gのファイル・ネーミング規則の理解

SOAコンポジット・アプリケーションをアップグレードする前に、アプリケーションまたはプロジェクトの名前が数字で始まらないことを確認してください。

たとえば、110.JMStoJMSHeadersという名前の10gサンプル・アプリケーションをアップグレードしようとすると、Oracle JDeveloperではcomposite.xmlを開こうとしたときに構文検証エラーが表示されます。

この問題を回避するには、アプリケーションをアップグレードする前に、アプリケーションの名前を変更して番号を削除します。

9.4.8 Oracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法

次の各項では、Oracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法について説明します。

- Oracle SOA Suiteコマンドライン・アップグレード・ツールの使用の利点

- Oracle JDeveloper 11gでのOracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法

- Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用してHuman Workflowアプリケーションをアップグレードする場合の制限

- Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用したBPELプロジェクトまたはESBプロジェクトのアップグレード

- Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用した複数のBPELプロジェクトの単一コンポジットへの統合

- Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用したOracle Enterprise Service Bus(ESB)プロジェクトのアップグレード

- ESBリポジトリのドメイン値マップ(DVM)と相互参照(XREF)のアップグレード

9.4.8.1 Oracle SOA Suiteコマンドライン・アップグレード・ツールの使用の利点

Oracle SOA Suiteコマンドライン・アップグレード・ツールには、次の利点があります。

- コマンドライン・ツールを使用して、スクリプトまたはその他のコマンドライン自動化ツールによりアプリケーションのアップグレード作業を自動化できます。

- コマンドライン・ツールにより、Oracle BPEL Process ManagerのプロジェクトとOracle Enterprise Service Bus 10gのプロジェクトの両方がOracle Mediator 11gにアップグレードされます。

- コマンドライン・ツールを使用して、複数のBPELプロジェクトをマージして単一コンポジットを作成できます。これは、Oracle JDeveloperの移行ウィザードでは実行できません。

- JDeveloperと同じコードベースが使用されているため、SOAプロジェクト・コンテンツの処理に関する機能はJDeveloperモードとまったく同じです。

9.4.8.2 Oracle JDeveloper 11gでのOracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法

Oracle SOA Suiteコマンドライン・アップグレード・ツールは、Oracle JDeveloperの移行ウィザードと互換性があります(いくつかの制限はあります)。このため、アップグレード・プロセス全体にわたって(アップブレード、コンパイル、パッケージおよびデプロイ)コマンドライン・モードを使用することも、Oracle JDeveloperに移動することもできます。また、両方のツールを使用して機能の制限を回避することもできます。

ただし、コマンドライン・ツールでは、SOAプロジェクト・アーチファクトのみがアップグレードされることに注意してください。他のOracle JDeveloperのアーチファクト(.jpr、.jwsファイルなど)は無視されます。

この制限を回避するために、次の点に留意してください。

- Oracle SOA Suiteコマンドライン・アップグレード・ツールは、BPELスーツケース・ディレクトリ(BPELサブディレクトリまたはBPELファイルをホストするディレクトリ)からコマンドラインで指定されたターゲット・ディレクトリにファイルをコピーします。

- このコピー・アクションでは、.jprまたは.jwsファイルはコピーされません。アップグレード後のターゲット・ディレクトリには、アップグレードされたSOAプロジェクト・コンテンツのみが格納されています。

- Oracle JDeveloperでこの問題を解決するには、新しいアプリケーションまたは新しいプロジェクトを作成し、新たにアップグレードされたコンポジット・ディレクトリをプロジェクト・ディレクトリとして定義します。

9.4.8.3 Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用してHuman Workflowアプリケーションをアップグレードする場合の制限

Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用してOracle Human Workflowプロジェクトを含むアプリケーションをアップグレードする場合は、アップグレードされたタスク・フォームごとに個別のプロジェクトが作成されることに注意してください。

この結果のプロジェクトはOracle ADFプロジェクトで、Oracle ADFはコマンドライン・デプロイメントおよびOracle JDeveloperデプロイメントをサポートしていません。このため、Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用した後、アップグレードされたプロジェクトをOracle JDeveloper 11gで開いて、JDeveloperからデプロイする必要があります。

アップグレードされたプロジェクトをOracle JDeveloperで開く方法の詳細は、第9章「Oracle JDeveloper 11gでのOracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法」を参照してください。

9.4.8.4 Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用したBPELまたはESBプロジェクトのアップグレード

Oracle SOA Suiteコマンドライン・アップグレード・ツールの実行に必要なファイルは、Oracle JDeveloper 11gのインストール時とOracle SOA Suite 11gのインストール時に自動的にインストールされます。

- Oracle SOA Suite 11gのインストール中には、必要なXMLファイルがOracle SOA SuiteのOracleホームのbinディレクトリにインストールされます。

- Oracle JDeveloper 11gのインストール中には、必要なXMLファイルがOracle JDeveloperホームのbinディレクトリにインストールされます。

このディレクトリ内のこれらのファイルとApache Antを使用して、10g リリース3(10.1.3)SOAプロジェクトを11gに移行できます。

注意:

この手順では、Oracle SOA SuiteインストールのOracleホームからOracle SOA Suiteコマンドライン・アップグレード・ツールを実行していると想定しています。

このツールをOracle JDeveloperホームから実行している場合は、次の手順のORACLE_HOMEをJDEV_HOMEに置換してください。

Antプロジェクトを使用するには、次の手順を実行します。

1. Oracle SOA Suite Oracleホームへのパスとして定義されるようにORACLE_HOME環境変数を設定します。

2. 次のスクリプトを実行して、コマンドライン・ツールで必要な他の環境変数を設定します。
UNIXシステムの場合

. ORACLE_HOME/bin/soaversion.sh

Windowsシステムの場合

ORACLE_HOME\bin\soaversion.cmd

3. 次のようにAntプロジェクトを実行します。

ant -f ORACLE_HOME/bin/ant-sca-upgrade.xml
-Dsource sourceDir
-Dtarget targetDir
-DappName app_name
-Drevision 1.0
bpel_or_mediator_identifier

Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用する例は、例9-5および例9-6を参照してください。

各コマンドライン引数の説明は、表9-2を参照してください。

4. アップグレードの完了後、移行されたソースを検証するSCAコンパイラ(ant-sca-compile.xml)を実行します。
SCAアップグレードでは、どのような場合でもすべてのアーチファクトが生成されるわけではないため、SCAコンパイラによってエラーまたは警告が生成され、その修正方法が示されます。詳細については、SCAコンパイラを確認してください。

5. SCAコンパイラからクリーン・パスを取得した後、ant-sca-package.xmlツールを使用してアプリケーションをパッケージ化します。
次に、ant-sca-deploy.xmlを使用してアプリケーションをデプロイできます。デプロイメントの後、サーバーでプロジェクトをテストできます。

ただし、多くの場合は、アップグレードされたプロジェクトをOracle JDeveloper 11gで開きます。ここから、アプリケーション・プロジェクトを容易に確認、検証、および必要に応じて更新できます。

詳細は、第9.4.8.2項「Oracle JDeveloper 11gでのOracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法」を参照してください。

例9-5 UNIXオペレーティング・システム上のコマンドラインの例

ant -f /Disk03/Oracle/Middleware/SOA_home/bin/ant-sca-upgrade.xml
-Dsource /disk03/myProjects/my_bpel_app/
-Dtarget /disk03/my11gProjects/my_bpel_app/
-Drevision 1.0
-DappName my_bpel_app
bpel

例9-6 Windowsオペレーティング・システム上のコマンドラインの例

ant -f C:\Oracle\Middleware\SOA_home\bin\ant-sca-upgrade.xml
-Dsource C:\myProjects/my_bpel_app/
-Dtarget C:\my11gProjects/my_bpel_app/
-Drevision 1.0
-DappName my_bpel_app
bpel

表9-2 Oracle SOA Suiteコマンドライン・アップグレード・ツール引数の概要

コマンドライン引数

説明

-Dsource

Oracle SOA Suite 10gプロジェクト・ファイルが格納されているディレクトリの完全修飾名およびパス。

Oracle BPEL Process Managerプロジェクトの場合は、bpelフォルダになります。bpelフォルダをホストする親ディレクトリです。

Oracle Enterprise Service Busプロジェクトの場合は、Oracle Enterprise Service Busプロジェクト・フォルダになります。

-Dtarget

アップグレードされたプロジェクト・ファイルを含むディレクトリの完全修飾名およびパス。

Oracle SOA Suiteコマンドライン・アップグレード・ツールはOracle BPEL Process Managerプロジェクト・ファイルをアップグレードし、この引数で指定されているターゲット・ディレクトリのサブディレクトリに、新しいアップグレードされたファイルを生成します。

-DappName

Oracle SOA Suiteコマンドライン・アップグレード・ツールはこの値を使用して、ターゲット・ディレクトリ内にアプリケーションのサブディレクトリを作成します。その後、アップグレードされたファイルをアプリケーションのサブディレクトリにコピーします。

-Drevision

情報が必要

bpel_or_mediator_identifier

次の2つの値のいずれかになります。

- bpel: Oracle BPEL Process Manager 11gにアップグレードするOracle BPEL Process Managerプロジェクトを識別します。

- mediator: Oracle Mediator 11gにアップグレードするOracle Enterprise Service Busプロジェクトを識別します。

値を指定しないと、コマンドライン・ツールではOracle BPEL Process Managerプロジェクトをアップグレードすると想定されます。

Oracle SOA Suiteコマンドライン・アップグレード・ツールを実行する場合は、次の点に注意してください。

- sourceDirディレクトリとtargetDirディレクトリが同じディレクトリの場合、コマンドライン・アップグレード・ツールにより移行前にディレクトリのバックアップが自動的に作成されます。アップグレードを再実行する必要がある場合は、バックアップ・ディレクトリを使用してソース・ファイルをリストアできます。バックアップ・ディレクトリは、名前に.backupという接尾辞が付いています。
sourceDirディレクトリとtargetDirディレクトリが異なる場合、移行中にsourceDir内のファイルは変更されないため、バックアップ・ディレクトリは作成されず、不要になります。

- アップグレード後、次の出力ディレクトリにログが作成されます。

ORACLE_HOME/upgrade/logs

9.4.8.5 Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用した複数のBPELプロジェクトの単一コンポジットへの統合

Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用して、複数のBPELプロジェクトをマージして単一コンポジットを作成できます。これは、Oracle JDeveloperの移行ウィザードでは実行できません。

複数のBPELプロジェクトを単一コンポジットに組み合せるには、コマンドラインで-Dsourceプロパティの一部として複数のソース・ディレクトリを指定します。

パス・セパレータには、コロン(:)またはセミコロン(;)を使用できます。セパレータは、プラットフォームのローカル表記規則に変換されます。ガイドラインとして、二重引用符を使用して複数のソース・ディレクトリを識別すると、Antにより予期しない方法で入力が解析されるのを回避できます。

指定された最初のソース・ディレクトリは11gプロジェクトのルートとみなされ、これによりコンポジット名が決定されます。

例:

ant -f ORACLE_HOME/bin/ant-sca-upgrade.xml
-Dsource "sourceDir1:sourceDir2"
-Dtarget targetDir
-DappName app_name

ソース・リスト内の最初のプロジェクトはルート・プロジェクトとみなされ、そのサービスのみが コンポジット・サービスとして公開されます。マージ機能を使用する際には、各プロジェクトが関連していることが推奨されます。

プロジェクトのマージは、BPELプロジェクトに対してのみサポートされます。ESBプロジェクトを他のBPELプロジェクトまたは他のESBプロジェクトとマージすることはできません。

9.4.8.6 Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用したOracle Enterprise Service Bus(ESB)プロジェクトのアップグレード

Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用して、ESBプロジェクトをOracle Mediator 11gにアップグレードすることもできます。

ESBプロジェクトをアップグレードする場合は、第9.4.8.4項「Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用したBPELまたはESBプロジェクトのアップグレード」に記載されている説明に従いますが、mediator引数を次のように使用してください。

ant -f ORACLE_HOME/bin/ant-sca-upgrade.xml
-Dsource sourceDir
-Dtarget targetDir
-DappName app_name
mediator

9.4.8.7 ESBリポジトリのドメイン値マップ(DVM)と相互参照(XREF)のアップグレード

Oracle BPEL Process Manager 10gまたはOracle Enterprise Service Bus 10gのプロジェクトでドメイン値マップ(DVM)または相互参照を使用する場合は、次の点に留意してください。

- ドメイン値マップまたは相互参照へのアクセスに使用するxPath関数は、Oracle JDeveloper 11gでアプリケーションを開いてアップグレードする際に、自動的にOracle BPEL Process ManagerおよびOracle Mediator 10gにアップグレードされます。

- ただし、Oracle Enterprise Service Busリポジトリに保存されているドメイン値マップと相互参照をアップグレードするには、手動でアップグレード・タスクを実行する必要があります。アップグレード・プロセスにより、ドメイン値マップがESBリポジトリからOracle Fusion Middleware 11gのメタデータ・サービス(MDS)リポジトリに移動します。
詳細は、『Oracle Fusion Middleware管理者ガイド』のMDSリポジトリの管理に関する項を参照してください。

ESBリポジトリにある10gのドメイン値マップをアップグレードするには、次のタスクを実行します。

タスク1   ZIPファイルへのドメイン値マップ・メタデータのエクスポート

1. ディレクトリをOracle Enterprise Service BusのOracleホームに変更します。

2. エクスポート・スクリプトを使用して、メタデータをZIPファイルにエクスポートします。
たとえば、UNIXシステムの場合は次のスクリプトを使用します。

ORACLE_HOME/export.sh metadata10g.zip

タスク2   Oracle SOA Suiteアーカイブ・ファイルへのZIPファイルの変換

Apache Antとsca-upgrade.xmlファイル内のupgrade-xrefdvmターゲットを使用して、メタデータZIPファイルでOracle SOA SuiteアーカイブJARファイルを生成します。

1. ディレクトリをOracle SOA Suite 11gのOracleホームに変更します。

2. 次のコマンドを使用して、SOAアーカイブ・ファイルを生成します。このファイルは、自動的にsca_XrefDvmFiles10g_rev1.0.jarという名前になります。

ant -f ant-sca-upgrade.xml upgrade-xrefdvm
-Dsource=location_of_the_zip_file
-Dtarget=location_of_the_soa_archive

例:

ant -f ant-sca-upgrade.xml upgrade-xrefdvm
-Dsource=$ORACLE_HOME/temp/upgrade/metadata10g.zip
-Dtarget=$ORACLE_HOME/temp/upgrade

タスク3   MDSリポジトリへのアーカイブ・ファイルのインポート

1. Oracle JDeveloper 11gを起動して、新しいアプリケーションを作成します。

2. Oracle SOA Suiteアーカイブを新しいSOAプロジェクトにインポートします。

1. Oracle JDeveloper 11gの「ファイル」メニューから「インポート」を選択し、「SOAアーカイブをSOAプロジェクトへ」を選択します。

2. 「SOAアーカイブからのSOAプロジェクトの作成」ダイアログ・ボックスで、左側のナビゲーション・ツリーの「JARオプション」を選択し、「参照」をクリックして、この手順で以前に作成したsca_XrefDvmFiles10g_rev1.0.jarファイルを検索します。

3. 左側のナビゲーション・ツリーの「ファイル・グループ」→「プロジェクトの出力」を選択し、「アーカイブのターゲット・ディレクトリ」フィールドにXrefDvmFiles10gと入力します。

4. 「OK」をクリックして、XrefDvmFiles10gという名前の新しいSOAプロジェクトを作成します。
新しいプロジェクトは、空のコンポジットと、アップグレードされたXRefおよびDVMファイルで構成されています。

3. XRefおよびDVMメタデータのJARファイルを作成した後、JARファイルをOracle SOAインフラストラクチャにデプロイします。
詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』のSOAコンポジット・アプリケーション間での共有メタデータのデプロイおよび使用に関する項を参照してください。

DVMと相互参照メタデータを11gにアップグレードした後、必要であればOracle JDeveloper 11gを使用して、XrefDvmFiles10gプロジェクトのエントリを変更できます。変更を行うたびに、同じデプロイメント・プロセスを使用して、変更内容を適切なMDSリポジトリに転送する必要があります。

9.4.9 Oracle SOA Suite 10g相互参照(XREF)ランタイム・データの11gへのアップグレード

OracleデータベースにOracle SOA Suite 11g相互参照(XREF)ランタイム・データがあり、Oracle SOA Suite 11gとともに使用する場合は、次の手順によりOracle SOA Suite 11gで使用するようにアップグレードできます。

この手順およびユーティリティは、Oracle Fusion Middleware 11gのXREFデータベース・スキーマ表(XREF_DATA)が変更されたため必要です。この項で説明する手順を実行して、11gスキーマ書式に準拠するように10g XREFデータを修正します。

この手順では、10g XREFデータは1つのOracleデータベースにあり、新しいOracle Fusion Middleware 11gデータは、別のOracleデータベースにあると想定しています。このシナリオは、アウトオブプレース・データ・アップグレードと呼ばれます。

詳細は、次の各項を参照してください。

- XREFランタイム・データのアップグレード手順

- XREFランタイム・データ・アップグレード時のその他のタスクと考慮事項

9.4.9.1 XREFランタイム・データのアップグレード手順

相互参照ランタイム・データをOracle SOA Suite 10gからOracle SOA Suite 11gにアップグレードする手順は、次のとおりです。

1. XREF 10gから11gへのデータ・アップグレード・ユーティリティを検索し、ローカル・ディレクトリに解凍します。
このユーティリティは、Oracle Fusion Middlewareのリポジトリ作成ユーティリティ(RCU)・アーカイブ・ファイルをダウンロードして解凍した場合は、次のディレクトリにあります。

RCU_HOME/rcu/integration/soainfra/sql/xref/XREF10gto11gDataUpgradeUtility.zip

2. SYSユーザー権限でOracle SOA Suite 11gランタイム・データが格納されているOracleデータベースにログインし、XREF 10gデータが格納されている2つ目のデータベースにアクセスするためのデータベース・リンクを作成します。
例:

CREATE PUBLIC DATABASE LINK dblink10g
CONNECT TO 10g_db_user_name
IDENTIFIED BY 10g_db_password
USING '(description=(address=(protocol=TCP)(host=10g_db_hostname)
(port=10g_db_listening_port))(connect_data=(sid=10g_db_SID)))'

前述の例では、XREFデータが格納されているデータベースへの接続に必要な情報により、イタリック体で表示されている値を置換します。

3. XREF 10gから11gへのデータ・アップグレード・ユーティリティを解凍したローカル・フォルダ内に作成されたディレクトリを次のサブディレクトリに変更します。

XREF10gto11gDataUpgradeUtility/scripts

4. テキスト・エディタを使用して次のSQLファイルを開きます。

Upgrade10gXrefTo11gXref.sql

5. ファイルの内容を、次のように編集します。

1. Upgrade10gXrefTo11gXref.sqlファイルの次のエントリを検索して、ファイル内の[TO BE FILLED]文字列を、共有MDSデータ・ロケーションを指すoramds: URLに変更します。

--specify the MDS_FOLDER_LOCATION where the shared xref artifacts should reside,  -- 10g table name will get prefixed by this location.    --  MDS_FOLDER_LOCATION  varchar2(1000) := 'oramds:/abc/ABCMetaData/xref/';    MDS_FOLDER_LOCATION  varchar2(1000) := '[TO BE FILLED]';

oramds: URLプロトコルの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の共有メタデータのデプロイ方法に関する項を参照してください。

2. 必要に応じて、commitperbatchパラメータのデフォルト値を変更します(デフォルトは2000)。
このパラメータには、移行中にバッチごとにコミットされたレコードの数を指定します。

6. 同じディレクトリから、Oracle SOA 11g XREFをホストするOracleデータベースにXREFユーザーとしてログインし、次のように入力します。

set serverout on;
@Upgrade10gXrefTo11gXref.sql

これらのコマンドによりデータはアップグレードされ、アップグレードの進捗状況がサーバー出力ログとして表示されます。

または、ログをファイルにスプールできます。

spool on;
spool path_of_local_file;
@Upgrade10gXrefTo11gXref.sql
spool off;

9.4.9.2 XREFランタイム・データ・アップグレード時のその他のタスクと考慮事項

10g XREFデータが11gスキーマに準拠していない場合、またはアップグレード・プロセス中にエラーまたは例外が発生した場合は、破損したレコードがXREF_DATA_CORRUPTED表にコピーされます。この表には、EXCEPTION_CAUSEと呼ばれる追加の列とともに、XREF_DATAのすべての列があります。この列には、例外の理由と行番号が格納されます。

XREFデータのアップグレードが完了したら、SYSユーザーとして次のSQLコマンドを使用し、データベース・リンクを削除します。

DROP PUBLIC DATABASE LINK dblink10g;

レコードが正常に移行されていない場合、一時表XREF_DATA_CORRUPTEDおよびTEMP_UPGRADE_XREF_LOGはユーティリティで削除されず、手動でクリーン・アップする必要があります。

10 Oracle BPEL Process Managerアプリケーションのアップグレード

この章では、Oracle BPEL Process ManagerアプリケーションをOracle Fusion Middleware 11gにアップグレードする際に重要な追加情報について説明します。

注意:

10g BPELプロセスはすべてBPEL 1.1にのみアップグレードされます。

Oracle SOA Suite、WebCenterおよびADFの各アプリケーションのアップグレード時に必要となる主なタスクは、第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」で説明しています。

次の各項では、Oracle BPEL Process ManagerのアプリケーションとプロジェクトをOracle Fusion Middleware 11gにアップグレードするために必要となる可能性のあるアップグレード・タスクについて説明します。

- Oracle BPEL Process Managerアプリケーションの移行後の手動アップグレード・ステップ

- Oracle BPEL Process Managerアプリケーションに関するその他の考慮事項

10.1 Oracle BPEL Process Managerアプリケーションの移行後の手動アップグレード・ステップ

次の各項では、Oracle JDeveloper 11gでOracle Application Server 10g Oracle SOA Suiteアプリケーションを開いた後に実行する必要のある一般的なアップグレード・タスクについて説明します。

これらのタスクは、Oracle JDeveloperの移行ウィザードで自動的にアップグレードされないアイテムを表しています。

- 外部参照のための不足しているバインディング情報の指定

- Oracle BPEL Process Managerテスト・スイートを使用した問題の修正

- アップグレード後のOracle BPEL Process Managerデプロイメント・プランの使用方法

- Oracle BPEL Process Managerプロジェクトのフォルト・ポリシーのアップグレード

- BPELフォルダのない10gプロジェクトのアップグレード

- EJBへのWSIFバインディングを使用するプロジェクトのアップグレード後のステップ

- 異なるバインディングのアップグレード

10.1.1 外部参照のための不足しているバインディング情報の指定

この項では、Oracle JDeveloperで Oracle BPEL Process Managerプロジェクトをアップグレードした後に、不足しているバインディングに関するコンパイラの警告メッセージを修正する方法について説明します。

警告メッセージが生成される理由 アプリケーションのソース・プロジェクトが、Oracle Application Server 10g リリース3(10.1.3)Oracle BPEL Process ManagerまたはOracle Enterprise Service Bus(ESB)サービスに依存している場合、移行に先立って、Oracle JDeveloperの移行ウィザードにより抽象WSDLのローカル・コピーが作成されます。

抽象WSDLの定義には、サービスおよびポートのエンドポイント情報が不足しています。アップグレード中に、移行ウィザードによってサービス依存性の外部コンポジット参照が作成される際には、参照はバインディング情報なしで抽象参照として作成されます。

これらの抽象参照には、アップグレード・ログで警告メッセージのフラグが設定されます。アップグレード後にプロジェクトをコンパイルしようとすると、Oracle JDeveloperでコンポジットに抽象参照が含まれていることを示すコンパイル・エラーが生成されます。

10g リリース3(10.1.3)または11gの依存性サービスの使用 依存性ツリー上のすべてのサービスのアップグレードおよびデプロイメント・スケジュールに基づいて、10g リリース3(10.1.3)の依存性サービスを引き続き使用するか、依存性サービスをアップグレードして再デプロイするかを選択できます。

一般に、アップグレード処理を行う前に、ソース・プロジェクトとその依存性について理解しておくことをお薦めします。この分析により、アップグレードをスムーズに進めることができます。

再コンパイル中に検出されたバインディング・エラーの修正方法 抽象参照によるバインディング・エラーを修正するには、Oracle JDeveloper 11gのコンポジット・エディタで参照ノードを右クリックして、正しい具体的なWSDLを選択します。10g リリース3(10.1.3)の依存性サービスを引き続き使用することもできます。アップグレード・ログに記録される依存性サービス・エンドポイントURLの一部は、このステップで使用できます。

また、Oracle JDeveloper 11gでWSILブラウザ(リソース・パレット)を使用して依存性を再設計し、コンポジット・モデラーのUIからサービスを検出することもできます。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

10.1.2 Oracle BPEL Process Managerテスト・スイートを使用した問題の修正

Oracle JDeveloperでのアップグレード中に、BPELテスト・スイートはコンポジット・テスト・スイートに変換されます。ただし、移行されるのはインスタンス開始アクションのみです。このため、コンポジット・テストでは、テスト実行のみが開始されます。その他のBPELベースのテスト・アクションは自動的に移行されないため、アップグレード後に手動で設定する必要があります。

11g環境でのテストの設定方法については、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のSOAコンポジット・アプリケーションのテストに関する項を参照してください。

10.1.3 アップグレード後のOracle BPEL Process Managerデプロイメント・プランの使用方法

Oracle Application Server 10gでOracle BPEL Process Managerのユーザー・プロジェクトに対して設定したデプロイメント・プランおよび構成プランは、Oracle JDeveloper 11gでアップグレードされません。

Oracle Fusion Middleware11gでは、コンポジットにデプロイメント・プランとデプロイメント中の構成プランを付随させることができます。ただし、Oracle JDeveloperでアプリケーションを移行した後に、11gのデプロイメント・プランを手動で作成する必要があります。

11gで構成プランを作成する方法の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の開発、テストおよび本番環境間でのSOAコンポジット・アプリケーションの移動に関する項を参照してください。

10.1.4 Oracle BPEL Process Managerプロジェクトのフォルト・ポリシーのアップグレード

Oracle JDeveloperで10gアプリケーションを開き、Oracle JDeveloperの移行ウィザードを使用してアプリケーションをアップグレードする場合、ユーザー・プロジェクトで設定したフォルト・ポリシーとバインディングは自動的に11gにアップグレードされません。

この理由は、次のとおりです。

- Oracle BPEL Process Manager 10gでは、フォルト・ポリシーはサーバーとともに格納され、バインディングはサーバーとともに格納されるか、bpel.xmlに指定されます。Oracle BPEL Process Manager 11gでは、フォルト・ポリシーとフォルト・バインディングはOracle JDeveloper 11gプロジェクトに格納されます。

- 一般に、Oracle BPEL Process Manager 11gのフォルト・ポリシーとバインディングは、以前のリリースのものとは異なります。たとえば、11gでは、ファイル名と構文が異なり、フォルト・ポリシーはOracle MediatorとOracle BPEL Process Managerの両方に適用され、バインディングは参照、コンポーネントおよびコンポジット・レベルで行われます。

このため、アプリケーションをアップグレードした後、Oracle JDeveloper 11gプロジェクトでフォルト・ポリシーとバインディングを手動で再作成する必要があります。

同様に、Oracle Enterprise Service Bus 10g リリース3(10.1.3)のプロジェクトを11gにアップグレードする場合は、esb_config.iniファイルで定義されている再試行パラメータを11gのfault-policy.xmlファイルに追加する必要があります。

詳細は、次の項を参照してください。

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のBPEL Processでのフォルト処理の使用に関する項

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のMediatorのエラー処理の使用に関する項

10.1.5 BPELフォルダのない10gプロジェクトのアップグレード

アップグレードしている10g リリース3(10.1.3)アプリケーションに、BPELアーチファクトがプロジェクト内の独自のフォルダに分離されず、すべてのプロジェクト・アーチファクトが1つのフォルダに含まれているプロジェクトがある場合は、Oracle JDeveloperの移行ウィザードではそれらのアーチファクトをアップグレードできません。

この問題を回避するには、次のいずれかの手順を実行します。

- プロジェクトをアップグレードする前に、Oracle JDeveloper 10gを使用してBPELフォルダを作成し、build.xmlおよびbuild.propertiesファイルを除くすべてのアーチファクトをそのフォルダに移動します。その後、プロジェクトのアップグレードを続行できます。

- Oracle SOA Suiteコマンドライン・アップグレード・ツールを使用します。コマンドライン・ツールでは、プロジェクトにBPELフォルダがない場合でも、アーチファクトがアップグレードされます。詳細は、第9.4.8項「Oracle SOA Suiteコマンドライン・アップグレード・ツールの使用方法」を参照してください。

10.1.6 EJBへのWSIFバインディングを使用するプロジェクトのアップグレード後のステップ

Enterprise Java Bean(EJB)との通信にWSIFバインディングを使用するOracle SOA Suite 10gプロジェクトがある場合、プロジェクトを11gにアップグレードした後、いくつかの変更を加える必要があります。

たとえば、WSIFバインディングおよびEJBを使用するプロジェクトをアップグレードした後、WSIFバインディング・エラーによりプロジェクトを実行できなくなります。

このような問題に対処するために、通常、プロジェクトをOracle JDeveloper 11gにアップグレードした後、次のステップを実行する必要があります。

1. composite.xmlファイルの<binding.wsif>エントリのプロパティを、Oracle WebLogic Serverの正しいJNDI関連プロパティに置換します。
たとえば、BankTransferDemoアプリケーションというアプリケーションのOracle WebLogic Serverドメインに対して設定されている一般的なプロパティは次のとおりです。このアプリケーションは、以前Oracle Application Server 10g リリース3(10.1.3)にデプロイされました。

<binding.wsif
port="......."
location="......">
.
<property name="jndiName">
ejb/session/BankTransfer
</property>
.
<property name="java.naming.factory.initial">
weblogic.jndi.WLInitialContextFactory
</property>
.
<property name="java.naming.provider.url">
t3://[SERVER HOST NAME]:[SERVER PORT]
</property>
.
<property name="java.naming.security.principal">
[DOMAIN ADMIN USER NAME]
</property>
.
<property name="java.naming.security.credentials">
[DOMAIN ADMIN PASSWORD]
</property>
.
</binding.wsif>

2. 新しくアップグレードされた11gプロジェクトの次のディレクトリにEJBクラスをコピーします。

SOA_JDEV_PROJECT_HOME/SCA-INF/classes/

Oracle JDeveloperを使用してOracle SOA Suiteアプリケーションを変更する方法の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

10.1.7 異なるバインディングのアップグレード

Oracle SOA Suite 10gでは数多くのWSIFバインディングがサポートされていました。Oracle SOA Suite 11gにアップグレードできるのは、EJBおよびJavaバインディングのみです。EJBバインディングをアップグレードするには、第10.1.6項「EJBへのWSIFバインディングを使用するプロジェクトのアップグレード後のステップ」に説明されたステップを完了します。

HTTP WSIFバインディングは、Oracle SOA Suite 11gでbinding.wsのバリエーションと置換されます。これはOracle JDeveloperのツールを使用して移行されます。

その他のWSIFバインディングの場合はすべて、抽象参照のみが移行されます。バインディングは、JCAバインディング(例: JMS WSIF)またはWebサービス・バインディング(例: JAXRPCまたはAxis WSIF)に対して手動で完了する必要があります。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のバインディング・コンポーネントの概要に関する項を参照してください。

10.2 Oracle BPEL Process Managerアプリケーションに関するその他の考慮事項

次の各項では、Oracle BPEL Process Managerアプリケーションをアップグレードした後に確認する必要のある、その他の考慮事項について説明します。

- 第10.2.1項「bpel.xmlデプロイメント・ディスクリプタの新しいプロパティと非推奨プロパティの確認」

- 第10.2.2項「Oracle BPEL Process Managerプロジェクトのユーザー定義(カスタム)XPath関数のアップグレード」

- 第10.2.3項「複数のBPEL実装のサポートに関する変更」

- 第10.2.4項「非同期サービスで相関セットを使用するプロジェクトをアップグレードする場合のプロパティ・ファイル名の確認」

- 第10.2.5項「transaction=participateプロパティを使用したプロジェクトのアップグレード」

- 第10.2.6項「Oracle BPEL Process Manager 11gでのドメイン・ディスクリプタ・プロパティの指定」

- 第10.2.7項「複数のOracle BPEL Process Managerドメインを使用するアプリケーションのアップグレード」

- 第10.2.8項「暗号化と復号化の使用」

- 第10.2.9項「アップグレード前のプロセスID、プロジェクト名およびBPELファイル名表記規則の確認」

- 第10.2.10項「XPath関数のOracle BPEL Process Manager 11gネームスペース接頭辞の確認」

- 第10.2.11項「複数のタスクを持つOracle BPEL Process Managerプロジェクトのアップグレード」

- 第10.2.12項「動的パートナ・リンクのアップグレード」

10.2.1 bpel.xmlデプロイメント・ディスクリプタの新しいプロパティと非推奨プロパティの確認

Oracle Application Server 10g リリース3(10.1.3)アプリケーションがbpel.xmlデプロイメント・ディスクリプタに格納されているプロパティを参照している場合は、これらのプロパティはcomposite.xmlデプロイメント・ディスクリプタ・ファイルで設定されるようになったことに注意してください。

composite.xmlデプロイメント・ディスクリプタで使用可能なプロパティの詳細と、Oracle Fusion Middleware 11gでサポートされなくなったプロパティに関する重要な情報については、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のデプロイメント・ディスクリプタ・プロパティに関する項を参照してください。

10.2.2 Oracle BPEL Process Managerプロジェクトのユーザー定義(カスタム)XPath関数のアップグレード

Oracle JDeveloper 11gでアプリケーションを開いてアップグレードする場合、アプリケーション・プロジェクトのカスタムXPath関数は、自動的にアップグレードされません。

このため、アプリケーションをアップグレードした後、すべてのXPath関数クラスをサーバーのクラスパスにコピーし、サーバーの構成ファイルに関数を登録する必要があります。Oracle JDeveloperの移行ウィザードではサーバー情報を想定できないため、このステップは手動で行う必要があります。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のユーザー定義XPath拡張関数の作成に関する項を参照してください。

10.2.3 複数のBPEL実装のサポートに関する変更

Oracle BPEL Process Manager 11gでは、複数の実装を含む単一のBPELファイルをアップグレードできません。

10g リリース3(10.1.3)の複数のプロジェクトを単一のBPEL実装ファイルに移行するには、各プロジェクトでBPELファイル名を変更する必要があります。各プロジェクトのbpel.xmlファイルで、bpelファイル名とデプロイメントID名も同じ名前に変更する必要があります。

アプリケーションをアップグレードする前に、bpel.xmlファイルと*.bpelファイルを確認してください。BPELファイル名とプロセス名が同じであることを確認し、bpel.xmlファイルでファイル名とデプロイメントID名が一致していることを確認してください。

10.2.4 非同期サービスで相関セットを使用するプロジェクトをアップグレードする場合のプロパティ・ファイル名の確認

非同期サービスで相関セットを使用するOracle BPEL Process Manager 10gプロジェクトを作成した場合は、Oracle BPEL Process Manager 10g リリース3(10.1.3)の開発者ガイドで説明されているように、相関セット・プロパティ・ファイルで次のような適切なネーミング規則が使用されていることを確認してください。

BPEL_FILE_NAME_Properties.wsdl

Oracle BPEL Process Manager 10gプロジェクトがこのファイルのネーミング規則に従っていない場合、プロパティは正しくアップグレードされません。ファイルのネーミング規則に従って名前を変更する必要がある場合は、プロパティのファイル名をインポートするwsdlファイルも更新してください。

10.2.5 transaction=participateプロパティを使用したプロジェクトのアップグレード

構成プロパティtransaction=participateを持つOracle BPEL Process Manager 10gプロジェクトを開いてアップグレードする場合、Oracle JDeveloper 11gでアプリケーションを開いたときに、このプロパティは11gに移行されません。この構成プロパティは、Oracle Fusion Middleware 11gではサポートされません。

partnerLinkバインディング・プロパティtransaction=participateを持つOracle BPEL Process Manager 10gプロジェクトを開いてアップグレードする場合、このプロパティはコール元で削除されます。コール先のプロジェクトには、bpel.config.transaction=requiredというプロパティ設定が必要となります。このコール元からコール先への設定の伝播はアップグレードによって実行されないため、アプリケーションをアップグレードした後、そのアプリケーションをOracle Fusion Middleware 11gにデプロイする前に手動で実行する必要があります。

10.2.6 Oracle BPEL Process Manager 11gでのドメイン・ディスクリプタ・プロパティの指定

Oracle BPEL Process Manager 10gでは、ドメインのプロパティをdomain.xmlディスクリプタ・ファイルに指定します。

Oracle BPEL Process Manager 11gでは、Oracle BPEL Process Managerエンジンのプロパティをbpel-config.xmlとsoa-infra-config.xmlに指定します(両方ともMBeansとしてアクセスできます)。

表10-1は、Oracle BPEL Process Manager 10gおよびOracle BPEL Process Manager 10gで使用可能なドメイン・ディスクリプタ・プロパティを比較しています。

Oracle BPEL Process Manager 11gには、ドメインは1つのみです。つまり、これらのプロパティはサーバー全体に影響します。

表10-1 Oracle BPEL Process Manager 10gおよび11gでのドメイン・ディスクリプタ・プロパティ

Oracle BPEL Process Manager 10gのdomain.xmlファイル

Oracle BPEL Process Manager 11gのMBeanプロパティ

説明

auditDetailThreshold

auditDetailThreshold

監査証跡とは別に保管される前に許可される、監査証跡詳細文字列の最大サイズ(バイト数)。

詳細文字列がしきい値より大きい場合は、監査証跡が最初に取得された時点ではロードされず、リンクが詳細文字列のサイズとともに表示されます。

通常、詳細文字列にはBPEL変数の内容が含まれます。この変数が非常に大きい場合、監査証跡に記録することによりパフォーマンスに大きな影響が及ぶ場合があります。10gのデフォルト値は50KBです。

auditLevel

auditLevel

プロセスによってログされる監査イベントの数を制御します。

現在サポートされているロギング・レベルは次のとおりです。

- off: 一切のロギングは行われません。インスタンスの処理で、パフォーマンスがわずかに上昇することがあります。

- minimal: すべてのイベントがログされますが、監査詳細はログされません。

- production: すべてのイベントがログされます。assignアクティビティの監査詳細は記録されませんが、それ以外のすべてのノードの詳細が記録されます。

- development: すべてのイベントがログされます。すべてのアクティビティの監査詳細がログされます。10gのデフォルト値はdevelopmentです。

bpelcClasspath

bpelcClasspath

サーバー・サイドBPELプロセス・コンパイラのクラスパスです。プロセス・コンパイラによってBPELプロセスが正常にコンパイルされるようにするために、(アーカイブにパッケージ化されていない)BPEL Java実行ノードによって使用されるすべてのユーザー固有のクラスまたはライブラリをここに指定する必要があります。

datasourceJndi

datasourceJndi

(soa-infra-config.xmlに移動)

ドメイン・データソースのJNDI名です。このデータソースは、任意のデータソースを参照できます(JTAは必要ありません)。

deliveryPersistPolicy

deliveryPersistPolicy

配信メッセージを持続するかどうかを変更します。配信メッセージには、起動メッセージ、コールバック・メッセージおよびサブスクリプション・メッセージが含まれます。

- on: 配信メッセージを持続します。

- off: 配信メッセージはメモリーでのみ保管されます。

- off.immediate: 非同期プロセスにのみ適用可能です。インタフェースに関係なく、メッセージは同期に配信されます。10gのデフォルト値はonです。

dspEngineThreads

dspEngineThreads

プロセス・エンジン・ディスパッチャ・メッセージに割り当てられるスレッドの総数です。

エンジン・ディスパッチ・メッセージは、BPELエンジンでアクティビティが非同期的に処理される必要がある場合に生成されます。BPELサーバーでデプロイされるプロセスの大多数が、多数のデハイドレーション・ポイント(mid-process receive、onMessage、onAlarm、wait)で永続的である場合、エンジン・スレッド数を増やすことでパフォーマンスが大幅に向上する可能性があります。

スレッド数が多くなればなるほど、コンテキスト切替えコストが高くなるため、CPU使用率が大幅に増加する可能性があります。10gのデフォルト値は30スレッドです。1より小さい値は、自動的にデフォルト値に変更されます。

dspInvokeAllocFactor

なし

着信起動メッセージの処理がタスクになるアクティブ・スレッド数の割合です。スレッドはメッセージの処理が終了すると、現在のスレッド割当状況に応じて、エンジンまたは起動メッセージの処理が再度タスクになる場合があります。

このプロパティは、10g リリース3(10.1.3.4)でdspInvokeThreadsに置換されました。10.1.3.1.0のデフォルト値は0.4(40パーセント)です。

dspInvokeThreads

dspInvokeThreads

呼出しディスパッチャ・メッセージの処理に割り当てるスレッド合計数です。呼出しディスパッチャ・メッセージはOracle BPEL Serverで受信されたペイロードごとに生成され、新しいインスタンスのインスタンス化を目的としています。エンジンによって処理されるリクエストの大部分が(インスタンス・コールバックではなく)インスタンス呼出しである場合は、呼出しスレッド数を増やすことでパフォーマンスを改善できる可能性があります。スレッド数が多くなると、コンテキスト切替えのコストが高くなるため、CPU使用率が増加する場合もあります。

デフォルト値は40スレッドです。1スレッド未満の値は、デフォルト値に変更されます。

dspMaxThreads

なし

ピーク負荷時間にメッセージを処理することになるアクティブ・スレッドの最大数です。これは、ドメインのパフォーマンスを抑制する最も容易な方法です。最大値は、アプリケーション・サーバーまたはOSコンフィギュレーションによって決まります。このプロパティは、10.1.3.4.0でdsp(Engine|Invoke|System)Threadsに置換されました。10.1.3.1.0のデフォルト値は100スレッドです。

dspMinThreads

なし

ピーク負荷時間にメッセージを処理することになるアクティブ・スレッドの最小数です。現在のアクティブ・スレッドの数がこの数より少ない場合、新規スレッドを割り当てるかどうかを決定するとき負荷率は考慮されません。

このプロパティは、10.1.3.4.0でdsp(Engine|Invoke|System)Threadsに置換されました。10.1.3.1.0のデフォルト値は5スレッドです。

dspSystemThreads

dspSystemThreads

プロセス・システム・ディスパッチャ・メッセージに割り当てられるスレッドの総数です。システム・ディスパッチ・メッセージは、通常、サーバーにより迅速に処理される一般的なクリーン・アップ・タスクです(たとえば、ステートフル・メッセージBeanを元のプールに解放)。

通常、実行時に生成されたシステム・ディスパッチ・メッセージの数を処理するために必要なスレッド数はごく少数です。10gのデフォルト値は2スレッドです。1より小さい値は、自動的にデフォルト値に変更されます。

expirationMaxRetry

expirationMaxRetry

失敗した期限切れコール(wait/onAlarm)が失敗する前に再試行される最高回数です。期限切れコールがターゲットにしているアクティビティまたはインスタンスが見つからない場合、コールはもう一度再スケジュールされます。10gのデフォルトは5です。

expirationRetryDelay

expirationRetryDelay

失敗した期限切れコールを再スケジュールするまでに待機する時間です。10gのデフォルト値は120秒です。

instanceKeyBlockSize

instanceKeyBlockSize

1回のフェッチごとにデハイドレーション・ストアから割り当てられるインスタンスIDのブロック・サイズです。インスタンス化されたインスタンスのインスタンスIDは、デハイドレーション・ストアから事前に割り当てられ、メモリー内に保持されます。

メモリー内のインスタンスIDがすべて使い果たされると、次のリクエストによりデハイドレーション・ストアから次のブロックが取得されます。一般に、ブロック・サイズが大きいほど、インスタンスIDのフェッチがエンジンのパフォーマンス全体に与える影響は小さくなります(ブロック割当てコストが多数のインスタンスで償却されるため)。

ブロック・サイズが大きいことの唯一の短所は、クラスタ化されたインストールでインスタンス間にギャップがあること(各ノードがインスタンスIDのメモリー内ブロックを個別に持つため)、およびエンジンのシャットダウン時にブロックがすべて使用されていない場合にインスタンスIDが無駄になることです。10gのデフォルト値は10000です。

largeDocumentThreshold

largeDocumentThreshold

BPEL変数が、残りのインスタンス・スコープ・データから分離した場所に保管される前に許可される最大サイズ(バイト数)です。

XMLドキュメントのサイズが大きいと、これらのドキュメントがインスタンス上の処理を実行するとき常に読込みおよび書出しされる場合、BPELサーバー全体のパフォーマンスに大きな影響を与えます。

この変数を記述して記憶域を分けることにより、パフォーマンスの影響は変数が明示的にBPELアクティビティで使用されるときに限定されます。10gのデフォルト値は50KBです。

minBPELWait

minBPELWait

BPELが待機する最大時間です。この時間より短い待機時間は考慮されず、基本的に完全にスキップされます。10gのデフォルト値は2秒です。

processCheckSecs

なし

プロセス・コンテナが最後にBPELアーカイブをチェックした後、再びチェックするまでに待機する秒数です。

このチェックとは、特定のプロセスについて、BPELアーカイブの最終変更タイム・スタンプをチェックすることを表します。指定した秒数が経過し、最終チェック後にBPELアーカイブ・ファイルが変更されている場合は、新しいアーカイブからプロセスがリフレッシュされます。失効チェックの最終実行時から十分な時間が経過していない場合は、現在ロードされているプロセス・クラスが使用されます。

プロセス・チェックを無効にするには、値-1を使用します。この場合、プロセスがロードされた後、コンテナは同じプロセスの新しいバージョンがデプロイされているかどうかをチェックしません。10gのデフォルト値は1秒です。SOAインフラストラクチャではHTTPのみを使用してデプロイメントを処理されるため、このプロパティは11gには関連しません。

statsLastN

statsLastN

ごく最近処理されたリクエスト・リストのサイズです。各リクエストが終了した後で、そのリクエストの統計がリストに保管されます。

値が0以下の場合、統計収集が無効になります。注意: このオプションを有効にすると、エンジンの処理能力がわずかに影響を受けることがあります。適度な値をnに選択してください(1000が推奨値です)。

syncMaxWaitTime

syncMaxWaitTime

プロセス結果レシーバが戻るまでに結果を待機する最大時間です。非同期BPELプロセスからの結果は、コンテナからの結果を待機するレシーバによって同期に取得されます。10gのデフォルト値は45秒です。

txDatasourceJndi

txDatasourceJndi(soa-infra-config.xmlに移動)

ドメイン・トランザクション・データソースのJNDI名です。JTAサポートでは、このデータソースを設定する必要があります。

uddiLocation

oracle.soa.uddi.registry.inquiryUrl(soa-infra-config.xmlに移動)

UDDIバージョン3対応レジストリの照会URLです。

uddiPassword

oracle.soa.uddi.registry.password(soa-infra-config.xmlに移動)

UDDIが保護されている場合に、パスワードを指定します。

uddiUsername

oracle.soa.uddi.registry.username(soa-infra-config.xmlに移動)

UDDIが保護されている場合に、ユーザー名を指定します。

validateXML

validateXML

trueに設定すると、エンジンは着信および発信XMLドキュメントにスキーマ検証を適用します。10gのデフォルト値はfalseです。

10.2.7 複数のOracle BPEL Process Managerドメインを使用するアプリケーションのアップグレード

複数のOracle BPEL Process Managerドメインを使用してOracle Application Server 10g BPELプロジェクトを開発およびデプロイした場合、Oracle Fusion Middleware 11gは複数のBPELドメインをサポートしていないことに注意してください。

Oracle Application Server 10gで複数のドメインを使用している場合、Oracle Fusion Middleware 11gにアップグレードする際に次の2つのオプションがあります。

- 複数のOracle SOA Suite Oracle WebLogic Serverドメインをインストールおよび構成できます。その後、各Oracle BPEL Process Manager 10gドメインを個別のOracle WebLogic Serverドメインにマップできます。

- すべてのOracle BPEL Process Managerプロジェクトを単一のOracle SOA Suite Oracle WebLogic Serverドメインにデプロイできます。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite and Oracle Business Process Management Suiteインストレーション・ガイド』を参照してください。

10.2.8 暗号化と復号化の使用

Oracle Fusion Middleware 11gには、Oracle BPEL Process Manager 10.1.3.5のプロパティに類似した、暗号化および復号化のための対応したプロパティはありません。暗号化および復号化は、Oracle Web Services Managerポリシーをアタッチすることで実現できます。Oracle Web Services ManagerはOracle SOA Suite 11gで使用可能です。

ポリシーの詳細は、次のドキュメントを参照してください。

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のポリシーによるセキュリティの有効化に関する項

- Oracle Fusion Middleware Web Servicesのためのセキュリティと管理者ガイド

- Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteのための管理者ガイド

10.2.9 アップグレード前のプロセスID、プロジェクト名およびBPELファイル名表記規則の確認

BPELプロジェクトをOracle SOA Suite 11gにアップグレードする前に、bpel.xmlファイルのプロセスID、BPELプロジェクトの名前およびBPELファイルの名前がすべて同じ値であることを確認します。この確認を行わないと、Oracle JDeveloper 11gでプロジェクトをアップグレードする際にエラーが発生したり、プロジェクトの一部の要素が正しくアップグレードされない可能性があります。

10.2.10 XPath関数のOracle BPEL Process Manager 11gネームスペース接頭辞の確認

Oracle SOA Suite 10gで使用されているXPath関数のネームスペース接頭辞がOracle SOA Suite 11gで変更されている場合があります。その結果、アップグレードされたアプリケーションでXPath関数を使用しようとしたときに「関数が見つかりません」というエラーが発生することがあります。

たとえば、Oracle BPEL Process Managerアプリケーションで10gのora:parseXML()関数が使用されていた場合、次のエラーが発生する可能性があります。

"Function of name: ora:parseXML not found. please check the spelling and try gain"

この例では、parseXML関数のネームスペース接頭辞がOracle SOA Suite 11gではoraext:parseXMLに変更されています。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の付録「XPath拡張関数」のparseXMLに関する項を参照してください。

10.2.11 複数のタスクがあるOracle BPEL Process Managerプロジェクトのアップグレード

Oracle SOA Suite 10gでは、Oracle BPEL Process Managerプロジェクトに同じパートナ・リンクを呼び出す複数のタスクを含めることができました。

例10-1は、同じパートナ・リンクを呼び出す2つのタスクを定義する10gのコンポジット・アプリケーションの例を示しています。このようなアプリケーションを11gにアップグレードしようとすると、Oracle JDeveloperではプロジェクトのコンパイル時にエラーが生成されます。

この問題に対処するには、アプリケーションのアップグレード前または後に、各タスクで一意のパートナ・リンクを呼び出すようにOracle JDeveloper 11gでプロジェクトを変更する必要があります。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のパートナ・リンクの作成に関する項を参照してください。

例10-1 同じパートナ・リンクを使用する複数のタスクがあるOracle BPEL Process Manager 10gプロジェクト

<partnerLink myRole="TaskServiceCallbackListener" name="TaskService"
partnerRole="TaskService"
.
.
.
<invoke name="initiateTask_MainTask_1" partnerLink="TaskService"
portType="taskservice:TaskService"
operation="initiateTask"
inputVariable="initiateTaskInput"
outputVariable="initiateTaskResponseMessage">
<correlations>
<correlation initiate="yes" set="WorkflowTaskIdCor"
pattern="in"/>
</correlations>
</invoke>
.
.
.
<invoke name="initiateTask_SubTask_1"
partnerLink="TaskService"
portType="taskservice:TaskService"
operation="initiateTask"
inputVariable="initiateTaskInput"
outputVariable="initiateTaskResponseMessage">
.
.
.
</invoke>

10.2.12 動的パートナ・リンクのアップグレード

Oracle BPEL Process Manager 10gに動的パートナ・リンクが定義されている場合、Oracle BPEL Process Manager 11gにアップグレードした後に、例10-2に示されているように動的パートナ・リンクを変更する必要があります。

例10-2 Oracle BPEL Process Manager 11g動的パートナ・リンク

<invoke name="Invoke1"
inputVariable="Invoke1_QueryAddressByAliasKey_InputVariable"
outputVariable="Invoke1_QueryAddressByAliasKey_OutputVariable"
partnerLink="Service1" portType="ns1:AddressPort"
operation="QueryAddressByAliasKey" bpelx:invokeAsDetail="no">
<bpelx:inputProperty name="wsa.to"
expression=""http://localhost:7001/Simulator/simulator""/>
<bpelx:inputProperty name="endpointURI"
expression=""http://localhost:7001/Simulator/simulator""/>
</invoke>

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の実行時の動的パートナ・リンクの概要に関する項を参照してください。

11 Oracle Business Activity Monitoringアプリケーションのアップグレード

この章では、Oracle SOAアプリケーションをOracle Fusion Middleware 11gにアップグレードする際に重要な追加情報について説明します。

Oracle SOA Suite、WebCenterおよびADFの各アプリケーションのアップグレード時に必要となる主なタスクは、第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」で説明しています。

次の各項では、Oracle Business Activity Monitoringに関連するアップグレード・タスクについて説明します。

- Oracle BAMユーザー、グループおよびその他のLDAP情報の11gへの移行

- アップグレード後のBAMアクション・フォーム・テンプレートの検証

- Oracle BAM外部データソースのアップグレード

- Oracle BAMレポートのイメージのアップグレード

- 11gでのOracle BAM Webサービスの使用方法

- Oracle BAMセンサー・アクションのアップグレード

- Oracle BAM 11gへのエンタープライズ・リンク計画のアップグレード

- Oracle BAM 11gへのアップグレード時のその他の考慮事項

11.1 Oracle BAMユーザー、グループおよびその他のLDAP情報の11gへの移行

一般に、Oracle BAMスキーマのアップグレード後、Oracle Fusion Middleware 11gセキュリティ・プロバイダに存在しないOracle BAM 10gユーザーは、Oracle BAMアドミニストレータに無効として表示されます。ただし、Oracle BAMアドミニストレータ・ソフトウェアを使用して、10gユーザーを新しいOracle BAM 11gユーザーに再マップできます。

詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドのOracle BAMオブジェクトの所有権に関する項を参照してください。

アップグレード後、ユーザーおよびグループに対して次の処理が必要となる可能性があります。

- 共有フォルダの権限のリセット

- データ・オブジェクトおよび「データ・オブジェクト」フォルダの権限のリセット

- 配布リストのリセット

- セキュリティ・フィルタのリセット

- ユーザーおよびグループに対するアラート・アクションのリセット

さらに、Oracle BAM 10g環境で、LDAPディレクトリ・サーバーを使用してOracle BAMユーザー名またはその他のOracle BAM情報を格納していた場合は、Oracle Application Server 10gで使用していたLDAPディレクトリが新しいOracle Fusion Middleware 11g環境に関連付けられていることを確認する必要があります。

詳細は、第6.7.1項「Identity Managementコンポーネントを使用するためのOracle SOA Suite 11gの構成」を参照してください。

11.2 アップグレード後のOracle BAMアクション・フォーム・テンプレートの検証

Oracle BAM 10gからOracle Fusion Middleware 11gにアップグレードした後、Oracle BAM 10gで作成した一部のアクション・フォーム・テンプレートが正しく機能しなくなることがあります。

そのため、アップグレードを実施した後に、テンプレートを確認し正しく機能するかどうかを検証する必要があります。

Oracle Fusion Middleware 11gへのアップグレード後、次の手順に従って、修正が必要となる一般的な問題を検出してください。

関連項目:

『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』のアクション・フォーム・テンプレートに関する項

1. Oracle BAMの開始ページを開きます。

関連項目:

"『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』のOracle BAM Webアプリケーションの起動に関する項

2. Oracle BAMアーキテクトを起動します。

3. メニューから「データ・オブジェクト」を選択します。

4. システム・フォルダを展開し、ビュー・フォルダを開きます。

5. アクション・フォーム・テンプレート・データ・オブジェクトを選択し、「コンテンツ」をクリックします。

6. 「コンテンツの編集」をクリックします。

7. 一行目の隣の「編集」をクリックします。

8. FormInput列の内容をテキスト・エディタにコピーし、要素の後の空白をすべて削除します(つまり、"> "を">"に置換します)。

9. 大文字と小文字が混在する"ReportServer"を検索し、小文字の"reportserver"に変更して、スタイル・シートへのリンクを修正します。

10. 更新したテキストをコピーしてFormInput列に貼り付けて戻します。

11. データが含まれているFormInput列の各エントリについて、この手順を繰り返します。

11.3 Oracle BAM外部データソースのアップグレード

Oracle BAM 10g環境で定義した外部データソースは、Oracle BAM 11gにアップグレードされません。

このため、Oracle BAM 10g環境で外部データソースを使用している場合は、Oracle BAM 11gでそれらのデータソースを手動で再作成する必要があります。これは、Oracle Fusion Middleware 11gでは、外部データベースへの接続に使用される新しいデータベース・ドライバ・セットがサポートされているためです。

Oracle BAM 11g用の外部データソースの構成については、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の外部データソースの作成に関する項を参照してください。

11.4 Oracle BAMレポートのイメージのアップグレード

Oracle BAM 10gで使用していたイメージは、Oracle BAM 11gに自動的にアップグレードされません。したがって、Oracle BAM 11gレポートでイメージを使用する前に、Oracle BAMイメージをOracle BAM 11gに手動で移動する必要があります。

- バックグラウンド・イメージをアップロードした場合、またはイメージを列ビューに挿入した場合、イメージをOracle BAM 11gにアップグレードするには次の2つのオプションがあります。

- オプション1: Oracle BAM 10gの場所からOracle BAM 11gの場所にすべてのイメージ・ファイルをコピーします。
Oracle BAM 10gの場所:

ORACLE_HOME\BAM\images

Oracle BAM 11gの場所:

BAM_DOMAIN_HOME/servers/BAM_Managed_Server/
/tmp/_WL_user/oracle-bam-11.1.1/
/tmpdir/war/buildnumber/Images

Oracle BAM 11gのImagesディレクトリは大/小文字を区別するため、大文字の「I」で始める必要があります。

- オプション2: Oracle BAM 11gレポートを編集し、イメージ・ファイルを再アップロードします。
詳細は、『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』のレポートのバックグラウンドの設定に関する項を参照してください。

- イメージ・ファイルをOracle BAM 10gの「images」ディレクトリに手動で配置し、Oracle BAM 10gのHTML計算で参照している場合は、次の手順を実行します。

1. この項の前のほうにある「オプション1」で説明したように、Oracle BAM 10gディレクトリをOracle BAM 11gディレクトリの場所にコピーします。

2. Oracle BAM 11gのHTML計算式を編集し、フォルダ参照imagesをImagesに変更します。

- イメージ・ファイルをOracle BAM 10gのカスタム・フォルダに手動で配置し、HTML計算で参照している場合は、次の手順を実行する必要があります。

1. 次の場所と相対的なカスタム・フォルダを11gに作成します。

BAM_DOMAIN_HOME/servers/BAM_Managed_Server/
/tmp/_WL_user/oracle-bam-11.1.1/
/tmpdir/war/buildnumber/Images

2. 10gイメージをこの新しい場所にコピーします。

3. Oracle BAM 11gのHTML計算式を編集し、フォルダ参照imagesをImagesに変更します。

11.5 11gでのOracle BAM Webサービスの使用方法

次の各項では、Oracle Fusion Middleware 11gへのアップグレードによって、Oracle BAM 10gでのOracle BAM Webサービスのサポートにどのような影響があるかについて説明します。

- Oracle BAM 11gでのWebサービス・クライアントの使用方法

- Oracle BAMアラートからのWebサービスの起動

- Oracle BAM 11gでのManualRuleFire Webサービスの使用方法

- Oracle BAM 11gの新しいWebサービスのサポート

11.5.1 Oracle BAM 11gでのWebサービス・クライアントの使用方法

Oracle BAM 10gサーバー上のWebサービスを介して通信するクライアント・アプリケーションを開発した場合、Oracle BAM 11gへのアップグレード後も、クライアント・コードを変更することなく、そのクライアントを引き続き使用できます。

これは、Oracle BAM 10gで提供されているDataObjectOperations Webサービスが、Oracle BAM 11gでも使用可能なためです。DataObjectOperations WebサービスはDataObjectOperations10131に名前を変更されましたが、WSDLエンドポイントURLは同じであるため、クライアント・プロセスはOracle BAM 11gでも動作します。

ただし、クライアントがOracle BAM 11gでも正しく動作することを確認するために、Oracle BAM 11g環境を使用しているすべてのOracle BPEL Process Manager 10gクライアントに最新のパッチ・セットを適用することをお薦めします。

注意:

このドキュメントの公開時点では、Oracle SOA Suite 10gとOracle JDeveloperに適用できる最新のパッチ・セットは、10g リリース3(10.1.3.5)です。

ただし、Oracle Fusion Middleware 11gの相互運用性とアップグレードのために必要な最新パッチ・セットの詳細は、Oracle Technology Network(OTN)のOracle Fusion Middlewareドキュメント・ライブラリで提供されている、Oracle Fusion Middleware 11gのリリース・ノートを参照してください。

http://www.oracle.com/technology/documentation/

Oracle JDeveloper 10g リリース3(10.1.3)の最新バージョンを使用している場合、Oracle BAM 11gへの接続を作成する際には、BAM接続ウィザードの「ドメイン」フィールドは完全に無視されるため、空白のままにできます。

Oracle BAM 11gのDataObjectOperations10131 Webサービスの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BAM Webサービスの使用に関する項を参照してください。

11.5.2 Oracle BAMアラートからのWebサービスの起動

Oracle BAM 10gでは、外部アクションの起動によってWebサービスを起動するようにアラートを構成できました。このアラートの使用によるWebサービスの起動は、Oracle BAM 11gではサポートされていません。

かわりに、Oracle BAM 11gでは、Webサービスのコール・アクションをコールするアラート・ルールを作成できます。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BAMアラートの作成に関する項を参照してください。

11.5.3 Oracle BAM 11gでのManualRuleFire Webサービスの使用方法

Oracle BAM 10gでManualRuleFire Webサービスを使用していた場合は、Oracle BAM 11gでは、このWebサービスのエンドポイントURLが変更されていることに注意してください。

詳細については、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のManualRuleFire Webサービスの使用に関する項を参照してください。

11.5.4 Oracle BAM 11gの新しいWebサービスのサポート

Oracle BAM 11gの新しいWebサービス機能の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BAM Webサービスの使用に関する項を参照してください。

11.6 Oracle BAMセンサー・アクションのアップグレード

Oracle JDeveloper 11gでOracle BPEL Process Manager 10g リリース3(10.1.3)のプロジェクトを開いてアップグレードすると、すべてのOracle BAMセンター・アクションが自動的に11gに移行されます。

11gでの動作とは異なり、Oracle Fusion Middleware 11gでは、Oracle BAMセンサー・アクションは(「BAMセンサー・アクション」ダイアログ・ボックスに表示される)Oracle BAMコネクション・ファクトリJNDIを使用してOracle BAMサーバーに接続します。10g リリース3(10.1.3)で使用されていたbpel.xmlファイルは使用されません。移行されたOracle BAM 11gセンサー・アクションには、eis/bam/soapというコネクション・ファクトリJNDI名が付きます。10gのbpel.xmlファイルで指定されたOracle BAM接続は、Migrated1という名前でアプリケーション・リソースBAM接続に移行されます。

PORTSを除くすべての接続プロパティは、元の設定のままになります。ただし、PORTSは9001に設定されます。

Oracle JDeveloper 11gはOracle BAM 10g リリース3(10.1.3)に接続できないことに注意してください。Oracle JDeveloper 11gでアプリケーションを開いたとき、アプリケーションがすでにインストールされており、Oracle BAM 11gにアップグレードされていると想定されます。

同様に、Oracle BPEL Process Manager 11gのランタイムは、Oracle BAM 10g リリース3(10.1.3)に接続できません。

11.7 Oracle BAM 11gへのエンタープライズ・リンク計画のアップグレード

Oracle Business Activity Monitoring 10gのエンタープライズ・リンクは、Oracle BAM 11gでは使用できません。かわりに、Oracle BAM 11gは、エンタープライズ・リンクに取ってかわるOracle Data Integrator(ODI)との統合をサポートしています。

Oracle BAM 11gにアップグレードする際には、Oracle BAM 10gでのエンタープライズ・リンクの使用方法に応じて、次のオプションがあります。

- 主にJMSメッセージをOracle BAMに統合するためにエンタープライズ・リンクを使用していた場合は、Oracle BAM 11gで提供されるダイレクトEMS機能を検討してください。ダイレクトEMSを使用することにより、アダプタまたはODIを必要とせずに、JMSメッセージをOracle BAMに直接送信できます。
詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BAMエンタープライズ・メッセージ・ソースの作成に関する項を参照してください。

- Oracle BAM 10gエンタープライズ・リンク計画がより複雑な場合は、それらをODIシナリオとして手動で再作成する必要があります。Oracle BAM 11gは、Oracle BAM 10gのすべての変換(挿入、更新、削除など)を、Oracle BAM 11gとODIの統合によるODIナレッジ・モジュールとしてサポートしています。
詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BAMとOracle Data Integratorの使用に関する項を参照してください。

11.8 Oracle BAM 11gへのアップグレード時のその他の考慮事項

次の各項では、Oracle BAM 11gにアップグレードする際に考慮するその他の情報について説明します。

- アップグレード後のOracle BAMアラート・アクションの使用

- アップグレード後のOracle BAMエンタープライズ・メッセージ・ソースの再作成

11.8.1 アップグレード後のOracle BAMアラート・アクションの使用

いくつかのOracle BAMアラート・アクションは、Oracle BAM 11gでは削除されました。アップグレード後、削除されたアラート・アクションを使用するアラートは無効になる可能性があります。

具体的には、「計画の実行」アクションが削除されました。これは、Oracle BAMでは、エンタープライズ・リンクが「ODIシナリオの実行」アラート・アクションを使用するOracle Data Integratorに置換されたためです。

詳細は、第11.7項「Oracle BAM 11gへのエンタープライズ・リンク計画のアップグレード」を参照してください。

11.8.2 アップグレード後のOracle BAMエンタープライズ・メッセージ・ソースの再作成

エンタープライズ・メッセージ・ソースは、Oracle BAM 10gからOracle BAM 11gに変更されました。したがって、Oracle Fusion Middleware 11gにアップグレードした後、エンタープライズ・メッセージ・ソースを再作成する必要があります。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BAMエンタープライズ・メッセージ・ソースの作成に関する項を参照してください。

12 Oracle B2Bアプリケーションのアップグレード

この章では、Oracle B2BアプリケーションをOracle Fusion Middleware 11gにアップグレードする際に重要な追加情報について説明します。

Oracle SOA Suite、WebCenterおよびADFの各アプリケーションのアップグレード時に必要となる主なタスクは、第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」で説明しています。

次の各項は、Oracle B2Bのアップグレードに関して理解しておく必要がある情報や、Oracle B2B 11gへのアップグレード後に実行が必要となる場合のある特定のアップグレード後タスクを要約したものです。

- Oracle B2B 11gにアップグレードされない機能

- Oracle B2B 11gへのアップグレード後に変更される機能

- Oracle B2B 11gのアップグレード後タスク

12.1 Oracle B2B 11gにアップグレードされない機能

次のOracle B2B機能は、Oracle Fusion Middleware 11gにアップグレードしても自動的にアップグレードされません。

- ホストおよびパートナのセキュリティ証明書

- コールアウト・ライブラリJARファイル

- 交換プロトコル・パラメータの識別子

- AS2-1.1チャネルの受信者プロパティ

- 汎用TCPチャネル

- PositionalFlatFileドキュメント

12.1.1 ホストおよびパートナのセキュリティ証明書

Oracle B2Bのホストおよびパートナのセキュリティ証明書は、Oracle B2B 11gに適切な形式にはアップグレードされません。

かわりに、証明書をexport.zipファイル(第6.5.2.4項「B2Bスキーマのアップグレードの実行」で作成したファイル)のルート・ディレクトリからコピーし、キーストアにインポートする必要があります。

Oracle B2Bでは、証明書の保存先はSSLウォレットではなく、キーストアになりました。

詳細は、次の項を参照してください。

- 『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のOracle B2Bのセキュリティ機能に関する項

- 『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のアイデンティティと信頼の構成に関する項

12.1.2 コールアウト・ライブラリJARファイル

独自のカスタム・コールアウト・ライブラリjarファイルをOracle B2B 10gで作成していた場合、これらのjarファイルはOracle B2B 11gにはアップグレードされません。

かわりに、Oracle B2B 11gを使用してカスタム・コールアウトjarファイルを再作成する必要があります。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のコールアウトの管理に関する項を参照してください。

12.1.3 交換プロトコル・パラメータの識別子

Oracle B2B 10gでは、チャネルの交換プロトコル・パラメータに識別子を指定できました。交換プロトコル・パラメータへの識別子の追加はOracle B2B 11gではサポートされなくなり、これらの識別子はOracle B2B 11gにはアップグレードされません。

かわりに、Oracle B2B 11gでは、必要な識別子を取引パートナ・プロファイルの一部として再作成する必要があります。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』の取引パートナ・プロファイルの作成に関する項を参照してください。

12.1.4 AS2-1.1チャネルの受信者プロパティ

AS2-1.1チャネルの「受信配信オプション」プロパティをOracle B2B 10g環境で設定していた場合、このプロパティの値はOracle B2B 11gにはアップグレードされません。アップグレード後に、このプロパティを適切な値に設定する必要があります。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のチャネルの構成に関する項を参照してください。

12.1.5 汎用TCPチャネル

Oracle B2B 10gで作成した汎用TCPチャネルは、Oracle B2B 11gに自動的にアップグレードされません。Oracle B2B 11gで汎用TCPチャネルを作成するには、MLLPチャネルを作成してTCP情報を指定します。詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』の「MLLPについて」、TCPの汎用サポートに関する項を参照してください。

12.1.6 PositionalFlatFileドキュメント

Oracle B2B 10gのCustom Documentプロトコル(変換および検証にECSファイルを使用)の下に作成されるPositionalFlatFileドキュメント(SAP iDocドキュメントなど)は、Oracle B2B 11gに自動的にアップグレードされません。

Oracle B2B 11gで、PositionalFlatファイルという新しいドキュメント・プロトコルの下にこのドキュメントを作成し、識別詳細を指定して、ドキュメント定義内にECSファイルを指定します。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』の位置フラット・ファイル・ドキュメント・プロトコルの使用に関する項を参照してください。

12.2 Oracle B2B 11gへのアップグレード後に変更される機能

次のOracle B2B機能は、Oracle B2B 11gにアップグレードした後、動作が異なるか、構成を変更する必要があります。

- 「ドキュメント・プロトコル・リビジョン」および「ドキュメント・タイプ」フィールド

- MLLPチャネルの交換プロトコル・パラメータ

- チャネル・パスワード

- Oracle B2B 11gで必須のOracle B2B 10gのオプション・フィールド

- インバウンドおよびアウトバウンド・パートナ・アグリーメント

- RosettaNetアウトバウンド・メッセージ

12.2.1 「ドキュメント・プロトコル・リビジョン」および「ドキュメント・タイプ」フィールド

この2つのフィールドは、Oracle B2B 11gでは変更されています。Oracle B2B 10gでは、どちらのフィールドにも名前とバージョンが含まれていました。Oracle B2Bでは、「ドキュメント・プロトコル・バージョン」と「ドキュメント・タイプ名」のフィールドのみを使用します。

このため、ドキュメントをIP_OUT_QUEUEにエンキューする際は、Oracle B2B 10gで提供されるものとは異なる属性セットを提供する必要があります。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のMSエンキューおよびデキュー・ユーティリティに関する項を参照してください。

12.2.2 MLLPチャネルの交換プロトコル・パラメータ

Oracle B2B 10gの次の交換プロトコル・パラメータは、MLLPチャネルの属性になりました。

- ImmediateACK

- ImmediateACK-Custom-File

- ImmediateACK-mapAckControlID

- ImmediateACK-MapImmTriggerEvt

- DiscardHL7ACK

これらのパラメータをOracle B2B 10gで設定していた場合は、MLLPチャネルの属性として再設定する必要があります。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のチャネルの構成に関する項を参照してください。

12.2.3 チャネル・パスワード

Oracle B2B 11gでは、ユーザーの資格証明およびパスワード情報の保存に新しい方法を使用します。このため、10gでチャネルに入力していたパスワードは、Oracle B2B 11gにはアップグレードされません。

かわりに、アップグレード後に、パスワードをチャネル・パラメータの一部として入力する必要があります。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のチャネルの構成に関する項を参照してください。

12.2.4 Oracle B2B 11gで必須のOracle B2B 10gのオプション・フィールド

次のフィールドはオプションから必須に変更されました。このため、アップグレード後に、これらのフィールドへの値の指定が必要になる場合があります。

- EDI EDIFACTおよびEDI X12ドキュメントをOracle B2B 10gで使用していた場合は、「グループID」識別子が必須の識別子になったことに注意してください。

- RosettaNetドキュメントをOracle B2B 10gで使用している場合は、「コラボレーション・コード」および「コラボレーションの実行時間」フィールドは必須ではないことに注意してください。Oracle B2B 11gではこれらは必須です。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のタイプの作成に関する項を参照してください。

12.2.5 インバウンドおよびアウトバウンド・パートナ・アグリーメント

Oracle B2B 11gにアップグレードすると、Oracle B2B 10gに存在する単一のパートナ・アグリーメントは、Oracle B2B 11gでは2つのアグリーメントとして表示されます(一方はインバウンド交換用、他方はアウトバウンド交換用)。

たとえば、10gのRosetta 3A4アグリーメントは次のように分割されます。

- Pip3A4PurchaseOrderConfirmation_Inbound

- Pip3A4PurchaseOrderRequest_Outbound

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』の取引パートナ・アグリーメントの作成とデプロイに関する項を参照してください。

12.2.6 RosettaNetアウトバウンド・メッセージ

RosettaNetアウトバウンド・メッセージの動作が、Oracle B2B 11gでは変更されました。

RosettaNetをOracle B2B 11gで使用する場合は、レスポンス・メッセージとして扱う必要があるアウトバウンド・メッセージ(PurchaseOrderConfirmationメッセージなど)に対し、追加のエンキュー・プロパティ(msgType=2)の設定が必要になりました。

この設定を行わないと、アウトバウンド・メッセージはリクエスト・メッセージとして扱われます。Oracle B2B 10gでは、このプロパティは不要でした。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のエンキューおよびデキュー・ユーティリティに関する項を参照してください。

12.3 Oracle B2B 11gのアップグレード後タスク

Oracle B2B 11gにアップグレードした後、次のタスクを実行する必要があります。

- インバウンドおよびアウトバウンド・メッセージ用のMLLPチャネルの構成

- Oracle B2Bメタデータの移行

- B2B関連のOracle BPELプロセスのアップグレード時の考慮事項

12.3.1 インバウンドおよびアウトバウンド・メッセージ用のMLLPチャネルの構成

アップグレード後に、Oracle B2B 10gにおけるMLLPチャネルの構成方法に応じて、次のいずれかのタスクを実行します。

- singleDCプロパティをtip.propertiesファイルで使用し、単一のMLLPチャネルでインバウンドとアウトバウンドの両方のメッセージを転送できるようにしていた場合は、新しいチャネルを作成した後、その新しいチャネルを使用するようにパートナ・アグリーメントを更新する必要があります。

- singleDCプロパティを使用していなかった場合は、ホスト取引パートナの接続モードを「サーバー」に設定します。

詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のMLLPに関する項を参照してください。

12.3.2 Oracle B2Bメタデータの移行

コマンドライン・ツールを使用して既存のOracle B2B 10gをOracle B2B 11gに移行できます。

1. 『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のデータのエクスポートに関する項の説明に従って、b2bexportユーティリティを使用してOracle B2Bリポジトリからメタデータをエクスポートします。

2. 『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のデータのインポートに関する項の説明に従って、b2bimportユーティリティを使用してB2BメタデータZIPファイルをリポジトリにインポートします。

12.3.3 B2B関連のOracle BPELプロセスのアップグレード時の考慮事項

デフォルトでは、Oracle SOA Suite 10gは、Oracle BPEL Process ManagerとOracle B2Bの間のデフォルト接続としてOracle Streams Advanced Queuing(AQ)を使用します。Oracle AQ接続は、OC4Jで使用可能なデータソースに依存しています。

Oracle SOA Suite 11gにアップグレードすると、Oracle AQで使用される必須のデータソースはデフォルトでは使用できません。したがって、Oracle B2B 11gおよびOracle SOA Suite 11gにアップグレードする際には次の点を考慮する必要があります。

- Oracle B2B 11gにアップグレードする前に、Oracle B2B 10gデータベースを参照するOracle WebLogic Serverでデータソースを作成します。データベースに指定したJNDI名をメモします。
詳細は、Oracle Fusion Middleware Oracle WebLogic Server管理コンソールのオンライン・ヘルプのJDBCデータソースの作成に関する項を参照してください。

- Oracle B2B 11gにアップグレードした後、AQアダプタ外部参照を開くを開き、接続ウィザードの「サービス接続」ページで、新しいOracle WebLogic ServerデータソースのJNDI名を入力します。

Oracle JDeveloper 11gでOracle SOA Suite 10gアプリケーションを開くと、Oracle JDeveloper移行ユーティリティによりアプリケーションがアップグレードされ、プロジェクトに対して次の関連する変更が行われます。これらの変更により、Oracle B2BプロセスとOracle BPEL Process Managerプロセスの間のOracle AQ接続を引き続き使用できます。

- Oracle BPEL Process Managerプロジェクトの場合、Oracle AQ接続で使用される変数は、Oracle BPEL Process Managerのassign文内のプロパティまたはBPELプロセス・ファイル内の変換マップに自動的にアップグレードされます。

- Oracle Enterprise Service Busプロジェクトの場合、Oracle AQ接続で使用される変数は、10g XSLTマップ・ファイルから自動的に削除され、Oracle Mediatorの割当て値内のプロパティにアップグレードされます。

または、Oracle MediatorプロジェクトとOracle BPEL Process Managerプロセスの間の接続を定義するために新しいOracle Fusion Middleware 11g機能を使用して、Oracle JDeveloper 11gでプロジェクトを再作成することもできます。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

13 Oracle Web Services ManagerのポリシーおよびOC4Jセキュリティ環境のアップグレード

この章では、Oracle SOAアプリケーションをOracle Fusion Middleware 11gにアップグレードする際に重要な追加情報について説明します。

Oracle SOA Suite、WebCenterおよびADFの各アプリケーションのアップグレード時に必要となる主なタスクは、第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」で説明しています。

ここでは、Oracle SOAアプリケーションのアップグレードのみに該当するタスクについて説明します。

- 第13.1項「Oracle Web Services Manager(WSM)のポリシーのアップグレード」

- 第13.2項「Oracle Containers for J2EE(OC4J)セキュリティ環境のアップグレード」

13.1 Oracle Web Services Manager(WSM)のポリシーのアップグレード

Oracle WSM 10gでは、各ポリシー強制ポイントでポリシー・ステップを指定します。ポリシー・ステップは、特定のセキュリティ処理を扱うきめの細かい操作タスクです。認証および認可、暗号化および複合化、セキュリティ署名、トークン、資格証明の検証、変換などの処理を扱います。各操作タスクはWebサービス要求またはWebサービス応答のいずれかによって実行されます。

Oracle WSM 10gポリシー・ステップの詳細は、Oracle Application Server 10g リリース3 (10.1.3.1.0)ドキュメント・ライブラリで提供されている『Oracle Web Services Manager管理者ガイド』のOracle Web Services Managerのポリシー・ステップに関する項を参照してください。

http://www.oracle.com/technology/documentation/

Oracle WSM 11gでは、ポリシーをWebサービス・エンドポイントにアタッチします。ポリシーはドメインレベルで定義された1つ以上のアサーションで構成されています。アサーションはセキュリティ要件の定義です。そのまま使用できる事前定義のポリシーとアサーションのセットが用意されています。事前定義ポリシーの詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』の事前定義ポリシー参照に関する項を参照してください。

13.1.1 アップグレード前のタスク

Oracle WSMのポリシーをアップグレードする前に、次のタスクを実行する必要があります。

- Oracle WSM 11gをインストールします。詳細は、『Oracle Fusion Middleware Oracle SOA Suite and Oracle Business Process Management Suiteインストレーション・ガイド』を参照してください。

- Oracle Containers for J2EE (OC4J) 10gのWebサービスをOracle WebLogic Server 11gのWebサービスにアップグレードします。
詳細は、『Oracle Fusion Middleware Java EEアップグレード・ガイド』のタスク6: アプリケーションのWebサービスのアップグレードに関する項を参照してください。

13.1.1.1 Oracle WSM 10gのゲートウェイに関する注記

『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のOracle Fusion MiddlewareでのOracle WSMの再アーキテクチャの調査に関する項で説明されているように、Oracle Fusion Middleware 11g リリース1 (11.1.1.6.0)には、ゲートウェイ・コンポーネントが含まれていません。

Oracle WSM 10gのポリシーとともに、アプリケーションのOracle WSM 10g Gatewayのコンポーネントを引き続き使用できます。Oracle WSM 10gの相互運用性の詳細は、『Oracle Fusion Middleware Oracle Web Services Manager相互運用ガイド』を参照してください。

13.1.1.2 サード・パーティ・ソフトウェアに関する注意

『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のOracle Fusion MiddlewareでのOracle WSMの再アーキテクチャの調査に関する項で説明されているように、Oracle WSM 10gは、IBM WebSphereやRed Hat JBossなどのサード・パーティ・アプリケーション・サーバーに対するポリシー強制をサポートしていました。Oracle Fusion Middleware 11g リリース1 (11.1.1.6.0)では、Oracle WebLogic Serverのみをサポートします。

Oracle WSM 10gのポリシーとともに、サード・パーティ・アプリケーション・サーバーを引き続き使用できます。Oracle WSM 10gの相互運用性の詳細は、『Oracle Fusion Middleware Oracle Web Services Manager相互運用ガイド』を参照してください。

13.1.2 Oracle WSM 10gの事前定義ポリシーのアップグレード

表13-1は、認証および認可、メッセージ保護、転送、ロギングなどのセキュリティ要件に基づいた、一般的なOracle WSMの事前定義ポリシーのアップグレード・シナリオを示したものです。Oracle WSM 10g環境とOracle WSM 11g環境の両方で各セキュリティ要件を実装するために必要なステップが比較されています。

詳細は、次のリソースを参照してください。

- Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

- Oracle WSM 10gポリシー・ステップの詳細は、Oracle Application Server 10g リリース3 (10.1.3.1.0)ドキュメント・ライブラリで提供されている『Oracle Web Services Manager管理者ガイド』のOracle Web Services Managerのポリシー・ステップに関する項を参照してください。

http://www.oracle.com/technology/documentation/

表13-1 Oracle WSM 10gの事前定義ポリシーのアップグレード

セキュリティ要件

Oracle WSM 10g

Oracle WSM 11g

メッセージ保護付き匿名認証(WS-Security 1.0)

ポリシー・ステップを次のように添付します。

- クライアント: 「メッセージの署名と暗号化」

- Webサービス: 「署名の復号化と検証」

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_message_protection_client_policy

Webサービス: oracle/wss10_message_protection_service_policy

2. メッセージの署名と暗号化は、デフォルト構成のままにします。

3. 「タイムスタンプを含める」構成設定を無効にします。

メッセージ整合性付き匿名認証(WS-Security 1.0)

ポリシー・ステップを次のように添付します。

- クライアント: 「メッセージの署名」

- Webサービス: 「署名の検証」

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_message_protection_client_policy

Webサービス: oracle/wss10_message_protection_service_policy

2. メッセージ署名のポリシー・アサーションのみを構成します。

3. 「タイムスタンプを含める」構成設定を無効にします。

メッセージの機密保持付き匿名認証(WS-Security 1.0)

ポリシー・ステップを次のように添付します。

- クライアント: 「XML暗号化」

- Webサービス: 「XML復号化」

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_message_protection_client_policy

Webサービス: oracle/wss10_message_protection_service_policy

2. メッセージ暗号化のポリシー・アサーションのみを構成します。

3. 「タイムスタンプを含める」構成設定を無効にします。

メッセージ保護付きユーザー名トークン(WS-Security 1.0)

ポリシー・ステップを次のように添付します。

- クライアント: 「WSBASIC資格証明の挿入」および「メッセージの署名と暗号化」

- Webサービス: 「署名の復号化と検証」、「資格証明の抽出」(WSBASICとして構成)および「ファイルの認証」

注意: ファイル認証のかわりに、LDAP認証、Oracle Access Manager認証、Active Directory認証またはSetMinder認証を使用する方法もあります。

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_username_token_with_message_protection_client_policy

Webサービス: oracle/wss10_username_token_with_message_protection_service_policy

2. メッセージの署名と暗号化は、デフォルト構成のままにします。

3. 「タイムスタンプを含める」構成設定を無効にします。

4. 認証プロバイダとアイデンティティ・アサーション・プロバイダを構成します。

メッセージ保護付きユーザー名トークン(WS-Security 1.0)とファイル認証

ポリシー・ステップを次のように添付します。

- クライアント: 「WSBASIC資格証明の挿入」および「メッセージの署名と暗号化」

- Webサービス: 「署名の復号化と検証」、「資格証明の抽出」(WSBASICとして構成)、「ファイルの認証」、「ファイルの認可」

注意: ファイル認証のかわりに、LDAP認証、Active Directory認証またはSetMinder認証を使用する方法もあります。

同様に、ファイル認可のかわりに、LDAP認可、Active Directory認可またはSetMinder認可を使用する方法もあります。

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_username_token_with_message_protection_client_policy

Webサービス: oracle/wss10_username_token_with_message_protection_service_policyおよびoracle/binding_authorization

2. メッセージの署名と暗号化は、デフォルト構成のままにします。

3. 「タイムスタンプを含める」構成設定を無効にします。

4. 認証プロバイダとアイデンティティ・アサーション・プロバイダを構成します。

メッセージ保護付きSAMLトークン(送信者保証)を使用したID伝播(WS-Security 1.0)

ポリシー・ステップを次のように添付します。

- クライアント: 「SAML - WSS 1.0送信者保証トークンの挿入」および「メッセージの署名と暗号化」

- Webサービス: 「XML復号化」および「SAML - WSS 1.0トークンの検証」

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_saml_token_with_message_protection_client_policy

Webサービス: oracle/wss10_saml_token_with_message_protection_service_policy

2. 「タイムスタンプを含める」構成設定を無効にします。

3. メッセージの署名と暗号化は、デフォルト構成のままにします。

HTTP Basic認証

ポリシー・ステップを次のように添付します。

- クライアント: N/A

- Webサービス: 「資格証明の抽出」(HTTPとして構成)

ポリシーを次のように添付します。

- クライアント: oracle/wss_http_token_client_policy

- Webサービス: oracle/wss_http_token_service_policy

Oracle Access Managerセキュリティ(WS-Security 1.0)

ポリシー・ステップを次のように添付します。

- クライアント: 「Oracle Access Managerトークンの挿入」

- Webサービス: 「資格証明の抽出」およびOracle Access Managerの認証と認可

ポリシーを次のように添付します。

- クライアント: oracle/wss_oam_token_client_policy

- Webサービス: oracle/wss_oam_token_service_policy

メッセージ保護付き相互認証(WS-Security 1.0)

ポリシー・ステップを次のように添付します。

- クライアント: 「WSBASIC資格証明の挿入」および「メッセージの署名と暗号化」

- Webサービス: 「署名の復号化と検証」、「資格証明の抽出」(WSBASICとして構成)および「ファイルの認証」

注意: ファイル認証のかわりに、LDAP認証、Oracle Access Manager認証、Active Directory認証またはSetMinder認証を使用する方法もあります。

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_x509_token_with_message_protection_client_policy

Webサービス: oracle/wss10_x509_token_with_message_protection_service_policy

2. メッセージの署名と暗号化は、デフォルト構成のままにします。

3. 「タイムスタンプを含める」構成設定を無効にします。

4. 認証プロバイダとアイデンティティ・アサーション・プロバイダを構成します。

SSL上のユーザー名トークン

1. アプリケーション・サーバーをSSL用に構成します。

2. ポリシー・ステップを次のように添付します。
クライアント: 「WSBASIC資格証明の挿入」

Webサービス: 「資格証明の抽出」および「ファイルの認証」

1. アプリケーション・サーバーをSSL用に構成します。

2. ポリシーを次のように添付します。
クライアント: oracle/wss_username_token_over_ssl_client_policy

Webサービス: oracle/wss_username_token_over_ssl_client_service_policy

3. 「タイムスタンプを含める」構成設定を無効にします。

SSL上のSAMLトークン(送信者保証)を使用したID伝播(WS-Security 1.0)

1. アプリケーション・サーバーをSSL用に構成します。

2. ポリシー・ステップを次のように添付します。
クライアント: 「SAML - WSS 1.0送信者保証トークンの挿入」

Webサービス: 「SAML - WSS 1.0トークンの検証」

1. アプリケーション・サーバーをSSL用に構成します。

2. ポリシーを次のように添付します。
クライアント: oracle/wss_saml_token_over_ssl_client_policy

Webサービス: oracle/wss_saml_token_over_ssl_client_service_policy

3. 「タイムスタンプを含める」構成設定を無効にします。

情報のログ記録

クライアントまたはWebサービスに次のポリシー・ステップを添付します: 「ログ」

クライアントまたはWebサービスに次のポリシーを添付します: oracle/log_policy

13.1.3 Oracle WSMのカスタム・ポリシーのアップグレード

Oracle WSM 10gでは、次のOracle Application Server 10g リリース3 (10.1.3.1.0)のドキュメント・ライブラリにある『Oracle Web Services Manager 拡張ガイド』に記載されている手順を使用して、カスタム・ポリシー・ステップを作成、開発およびデプロイします。

http://www.oracle.com/technology/documentation/

Oracle WSM 11gでは、カスタム・ポリシー・アサーションを作成、開発およびデプロイします。『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のカスタム・アサーションの作成に関する項で説明されている手順を使用して、カスタム・ポリシー・ステップをカスタム・ポリシー・アサーションとして再定義する必要があります。

13.2 Oracle Containers for J2EE(OC4J)セキュリティ環境のアップグレード

OC4J 10gでは、XMLベースのデプロイメント・ディスクリプタ・ファイルの内容を変更することによってセキュリティ環境を構成します。OC4J環境の保護の詳細は、『Oracle Application Server Web Servicesセキュリティ・ガイド』を参照してください。

http://www.oracle.com/technology/documentation/

Oracle WSM 11gでは、ポリシーをWebサービス・エンドポイントにアタッチします。ポリシーはドメインレベルで定義された1つ以上のアサーションで構成されています。アサーションはセキュリティ要件の定義です。そのまま使用できる事前定義のポリシーとアサーションのセットが用意されています。事前定義ポリシーの詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』の事前定義ポリシー参照に関する項を参照してください。

次の各項では、認証、メッセージ保護、転送、ロギングなどのセキュリティ要件に基づいた、一般的なOC4Jのアップグレード・シナリオについて説明します。OC4J 10g環境とOracle WSM 11g環境の両方で各セキュリティ要件を実装するために必要なステップが比較されています。

- 第13.2.1項「アップグレード前のタスク」

- 第13.2.2項「メッセージ保護付き匿名認証(WS-Security 1.0)」

- 第13.2.3項「メッセージ整合性付き匿名認証(WS-Security 1.0)」

- 第13.2.4項「メッセージの機密保持付き匿名認証(WS-Security 1.0)」

- 第13.2.5項「メッセージ保護付きユーザー名トークン(WS-Security 1.0)」

- 第13.2.6項「メッセージ保護付きSAMLトークン(送信者保証)を使用したID伝播(WS-Security 1.0)」

- 第13.2.7項「メッセージ保護付きSAMLトークン(キーのホルダー)を使用したID伝播(WS-Security 1.0)」

- 第13.2.8項「メッセージ保護付き相互認証(WS-Security 1.0)」

- 第13.2.9項「SSL上のユーザー名トークン」

- 第13.2.10項「SSL上のSAMLトークン(送信者保証)を使用したID伝播(WS-Security 1.0)」

- 第13.2.11項「情報のログ記録」

注意:

Oracle Fusion Middleware 11gでのポリシー添付の構成の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』を参照してください。

次の項では、アップグレード前に必要な前提条件について説明します。

13.2.1 アップグレード前のタスク

OC4Jのセキュリティ環境をアップグレードする前に、次のタスクを実行する必要があります。

- Oracle WSM 11gをインストールします。詳細は、『Oracle Fusion Middleware Oracle SOA Suite and Oracle Business Process Management Suiteインストレーション・ガイド』を参照してください。

- 『Oracle Fusion Middleware Java EEアップグレード・ガイド』のタスク6: アプリケーションのWebサービスのアップグレードに関する項を確認します。
この項では、OC4J WebサービスのOracle WebLogic Serverへのアップグレードに関する一般情報について説明します。

13.2.2 メッセージ保護付き匿名認証(WS-Security 1.0)

次の各項では、WS-Security 1.0標準に準拠したメッセージ保護付き認証の実装方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

13.2.2.1 OC4J 10g

次の項の説明に従って、Webサービスとクライアントのデプロイメント・ディスクリプタを編集します。

デプロイメント・ディスクリプタ要素の詳細は、次のOracle Application Server 10g リリース3 (10.1.3.1.0)のドキュメント・ライブラリにある『Oracle Application Server Web Servicesセキュリティ・ガイド』のOracleAS Webサービスのセキュリティ・スキーマに関する項を参照してください。

http://www.oracle.com/technology/documentation/

Webサービス・クライアント(サンプル・データ)

クライアントのデプロイメント・ディスクリプタで、<signature>および<encrypt>要素を定義します。例:

<signature>
<signature-method>RSA-SHA1</signature-method>
<tbs-elements>
<tbs-element local-part="Body" name-space=
"http://schemas.xmlsoap.org/soap/envelope/" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" local-part="Timestamp" />
</tbs-elements>
<add-timestamp created="true" expiry="28800" />
</signature>
<encrypt>
<recipient-key alias="orakey"/>
<encryption-method>AES-128</encryption-method>
<keytransport-method>RSA-OAEP-MGF1P</keytransport-method>
<tbe-elements>
<tbe-element local-part="Body" name-space=
"http://schemas.xmlsoap.org/soap/envelope/" mode="CONTENT" />
</tbe-elements>
</encrypt>

Webサービス(サンプル・データ)

サービスのデプロイメント・ディスクリプタで、<verify-signature>および<decrypt>要素を定義します。例:

<verify-signature>
<tbs-elements>
<tbs-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
</tbs-elements>
<verify-timestamp expiry="28800" created="true" />
</verify-signature>
<decrypt>
<tbe-elements>
<tbe-element
name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" mode="CONTENT" />
</tbe-elements>
</decrypt>

13.2.2.2 Oracle WSM 11g

次のステップを実行します。

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_message_protection_client_policy

Webサービス: oracle/wss10_message_protection_service_policy

Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

2. メッセージ本体の署名と暗号化の構成はそのまま残します。

13.2.3 メッセージ整合性付き匿名認証(WS-Security 1.0)

次の各項では、WS-Security 1.0標準に準拠したメッセージ整合性付き認証の実装方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

13.2.3.1 OC4J 10g

次の項の説明に従って、Webサービスとクライアントのデプロイメント・ディスクリプタを編集します。

デプロイメント・ディスクリプタ要素の詳細は、次のOracle Application Server 10g リリース3 (10.1.3.1.0)のドキュメント・ライブラリにある『Oracle Application Server Web Servicesセキュリティ・ガイド』のOracleAS Webサービスのセキュリティ・スキーマに関する項を参照してください。

http://www.oracle.com/technology/documentation/

Webサービス・クライアント(サンプル・データ)

クライアントのデプロイメント・ディスクリプタで、<signature>要素を定義します。例:

<signature>
<signature-method>RSA-SHA1</signature-method>
<tbs-elements>
<tbs-element local-part="Body" name-space=
"http://schemas.xmlsoap.org/soap/envelope/" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" local-part="Timestamp" />
</tbs-elements>
<add-timestamp created="true" expiry="28800" />
</signature>

Webサービス(サンプル・データ)

サービスのデプロイメント・ディスクリプタで、<verify-signature>要素を定義します。例:

<verify-signature>
<tbs-elements>
<tbs-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
</tbs-elements>
<verify-timestamp expiry="28800" created="true" />
</verify-signature>

13.2.3.2 Oracle WSM 11g

次のステップを実行します。

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_message_protection_client_policy

Webサービス: oracle/wss10_message_protection_service_policy

Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

2. メッセージ本体の署名のポリシー・アサーションのみを構成します。

13.2.4 メッセージの機密保持付き匿名認証(WS-Security 1.0)

次の各項では、WS-Security 1.0標準に準拠したメッセージの機密保持付き認証の実装方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

デプロイメント・ディスクリプタ要素の詳細は、次の10g リリース3 (10.1.3.1.0)のドキュメント・ライブラリにある『Oracle Application Server Web Servicesセキュリティ・ガイド』のOracleAS Webサービスのセキュリティ・スキーマに関する項を参照してください。

http://www.oracle.com/technology/documentation/

13.2.4.1 OC4J 10g

次の項の説明に従って、Webサービスとクライアントのデプロイメント・ディスクリプタを編集します。

Webサービス・クライアント(サンプル・データ)

クライアントのデプロイメント・ディスクリプタで、<encrypt>要素を定義します。例:

<encrypt>
<recipient-key alias="orakey"/>
<encryption-method>AES-128</encryption-method>
<keytransport-method>RSA-OAEP-MGF1P</keytransport-method>
<tbe-elements>
<tbe-element local-part="Body" name-space=
"http://schemas.xmlsoap.org/soap/envelope/" mode="CONTENT" />
</tbe-elements>
</encrypt>

Webサービス(サンプル・データ)

サービスのデプロイメント・ディスクリプタで、<decrypt>要素を定義します。例:

<decrypt>
<tbe-elements>
<tbe-element
name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" mode="CONTENT" />
</tbe-elements>
</decrypt>

13.2.4.2 Oracle WSM 11g

次のステップを実行します。

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_message_protection_client_policy

Webサービス: oracle/wss10_message_protection_service_policy

Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

2. メッセージ本体の暗号化のポリシー・アサーションのみを構成します。

13.2.5 メッセージ保護付きユーザー名トークン(WS-Security 1.0)

次の各項では、WS-Security 1.0標準に準拠したメッセージ保護付きユーザー名トークンの実装方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

13.2.5.1 OC4J 10g

次の項の説明に従って、Webサービスとクライアントのデプロイメント・ディスクリプタを編集します。

デプロイメント・ディスクリプタ要素の詳細は、次の10g リリース3 (10.1.3.1.0)のドキュメント・ライブラリにある『Oracle Application Server Web Servicesセキュリティ・ガイド』のOracleAS Webサービスのセキュリティ・スキーマに関する項を参照してください。

http://www.oracle.com/technology/documentation/

Webサービス・クライアント(サンプル・データ)

クライアントのデプロイメント・ディスクリプタで、<username-token>、<signature>および<encrypt>要素を定義します。例:

<username-token password-type="PLAINTEXT" add-nonce="false"
add-created="false" />
<signature>
<signature-method>RSA-SHA1</signature-method>
<tbs-elements>
<tbs-element local-part="Body" name-space=
"http://schemas.xmlsoap.org/soap/envelope/"/>
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
local-part="UsernameToken" />
</tbs-elements>
<add-timestamp created="true" expiry="28800" />
</signature>
<encrypt>
<recipient-key alias="orakey" />
<encryption-method>AES-128</encryption-method>
<keytransport-method>RSA-OAEP-MGF1P</keytransport-method>
<tbe-elements>
<tbe-element local-part="Body" name-space=
"http://schemas.xmlsoap.org/soap/envelope/" mode="CONTENT" />
<tbe-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
local-part="UsernameToken" />
</tbe-elements>
</encrypt>

Webサービス(サンプル・データ)

サービスのデプロイメント・ディスクリプタで、<verify-username-token>、<verify-signature>および<decrypt>要素を定義します。例:

<verify-username-token password-type="PLAINTEXT" require-nonce="false"
require-created="false" />
<verify-signature>
<tbs-elements>
<tbs-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
</tbs-elements>
<verify-timestamp expiry="28800" created="true" />
</verify-signature>
<decrypt>
<tbe-elements>
<tbe-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" mode="CONTENT" />
</tbe-elements>
</decrypt>

13.2.5.2 Oracle WSM 11g

次のステップを実行します。

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_username_token_with_message_protection_client_policy

Webサービス: oracle/wss10_username_token_with_message_protection_service_policy

Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

2. メッセージ本体の署名と暗号化の構成はそのまま残します。

3. 認証プロバイダとアイデンティティ・アサーション・プロバイダを構成します。

13.2.6 メッセージ保護付きSAMLトークン(送信者保証)を使用したID伝播(WS-Security 1.0)

次の各項では、WS-Security 1.0標準に準拠した、メッセージ保護付きSAMLトークン(送信者保証)を使用したID伝播の実装方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

デプロイメント・ディスクリプタ要素の詳細は、次のリンクにある『Oracle Application Server Web Servicesセキュリティ・ガイド10g (10.1.3.1.0)』のOracleAS Webサービスのセキュリティ・スキーマに関する項を参照してください。

http://www.oracle.com/technology/documentation/

13.2.6.1 OC4J 10g

次の項の説明に従って、Webサービスとクライアントのデプロイメント・ディスクリプタを編集します。

Webサービス・クライアント(サンプル・データ)

クライアントのデプロイメント・ディスクリプタで、<saml-token>、<signature>および<encrypt>要素を定義します。例:

<saml-token issuer-name="www.oracle.com" name="weblogic"
name-format="UNSPECIFIED">
<subject-confirmation-method>
<confirmation-method>SENDER-VOUCHES</confirmation-method>
</subject-confirmation-method>
</saml-token>
<signature>
<signature-method>RSA-SHA1</signature-method>
<tbs-elements>
<tbs-element local-part="Body"
name-space="http://schemas.xmlsoap.org/soap/envelope/" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
</tbs-elements>
<add-timestamp created="true" expiry="28800" />
</signature>
<encrypt>
<recipient-key alias="orakey" />
<encryption-method>AES-128</encryption-method>
<keytransport-method>RSA-OAEP-MGF1P</keytransport-method>
<tbe-elements>
<tbe-element local-part="Body" name-space=
"http://schemas.xmlsoap.org/soap/envelope/" mode="CONTENT" />
</tbe-elements>
</encrypt>

Webサービス(サンプル・データ)

サービスのデプロイメント・ディスクリプタで、<verify-saml-token>、<verify-signature>および<decrypt>要素を定義します。例:

<verify-saml-token>
<subject-confirmation-methods>
<confirmation-method>SENDER-VOUCHES</confirmation-method>
</subject-confirmation-methods>
</verify-saml-token>
<verify-signature>
<tbs-elements>
<tbs-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
</tbs-elements>
<verify-timestamp expiry="28800" created="true" />
</verify-signature>
<decrypt>
<tbe-elements>
<tbe-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" mode="CONTENT" />
</tbe-elements>
</decrypt>

13.2.6.2 Oracle WSM 11g

ポリシーを次のように添付します。

- クライアント: oracle/wss10_saml_token_with_message_protection_client_policy

- Webサービス: oracle/wss10_saml_token_with_message_protection_service_policy

Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

13.2.7 メッセージ保護付きSAMLトークン(キーのホルダー)を使用したID伝播(WS-Security 1.0)

次の各項では、WS-Security 1.0標準に準拠した、メッセージ保護付きSAMLトークン(キーのホルダー)を使用したID伝播の実装方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

デプロイメント・ディスクリプタ要素の詳細は、次の10g リリース3 (10.1.3.1.0)のドキュメント・ライブラリにある『Oracle Application Server Web Servicesセキュリティ・ガイド』のOracleAS Webサービスのセキュリティ・スキーマに関する項を参照してください。

http://www.oracle.com/technology/documentation/

13.2.7.1 OC4J 10g

次の項の説明に従って、Webサービスとクライアントのデプロイメント・ディスクリプタを編集します。

Webサービス・クライアント(サンプル・データ)

クライアントのデプロイメント・ディスクリプタで、<saml-token>、<signature>および<encrypt>要素を定義します。例:

<saml-token issuer-name="www.oracle.com" name="weblogic"
name-format="UNSPECIFIED">
<subject-confirmation-method>
<confirmation-method>HOLDER-OF-KEY</confirmation-method>
</subject-confirmation-method>
</saml-token>
<signature>
<signature-method>RSA-SHA1</signature-method>
<tbs-elements>
<tbs-element local-part="Body"
name-space="http://schemas.xmlsoap.org/soap/envelope/" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
</tbs-elements>
<add-timestamp created="true" expiry="28800" />
</signature>
<encrypt>
<recipient-key alias="orakey" />
<encryption-method>AES-128</encryption-method>
<keytransport-method>RSA-OAEP-MGF1P</keytransport-method>
<tbe-elements>
<tbe-element local-part="Body" name-space=
"http://schemas.xmlsoap.org/soap/envelope/" mode="CONTENT" />
</tbe-elements>
</encrypt>

Webサービス(サンプル・データ)

サービスのデプロイメント・ディスクリプタで、<verify-saml-token>、<verify-signature>および<decrypt>要素を定義します。例:

<verify-saml-token>
<subject-confirmation-methods>
<confirmation-method>HOLDER-OF-KEY</confirmation-method>
</subject-confirmation-methods>
</verify-saml-token>
<verify-signature>
<tbs-elements>
<tbs-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
</tbs-elements>
<verify-timestamp expiry="28800" created="true" />
</verify-signature>
<decrypt>
<tbe-elements>
<tbe-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" mode="CONTENT" />
</tbe-elements>
</decrypt>

13.2.7.2 Oracle WSM 11g

ポリシーを次のように添付します。

- クライアント: oracle/wss10_saml_hok_with_message_protection_client_policy

- Webサービス: oracle/wss10_saml_hok_with_message_protection_service_policy

Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

13.2.8 メッセージ保護付き相互認証(WS-Security 1.0)

次の各項では、WS-Security 1.0標準に準拠したメッセージ保護付き相互認証の実装方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

デプロイメント・ディスクリプタ要素の詳細は、次の10g リリース3 (10.1.3.1.0)のドキュメント・ライブラリにある『Oracle Application Server Web Servicesセキュリティ・ガイド』のOracleAS Webサービスのセキュリティ・スキーマに関する項を参照してください。

http://www.oracle.com/technology/documentation/

13.2.8.1 OC4J 10g

次の項の説明に従って、Webサービスとクライアントのデプロイメント・ディスクリプタを編集します。

Webサービス・クライアント(サンプル・データ)

クライアントのデプロイメント・ディスクリプタで、<x509-token>、<signature>および<encrypt>要素を定義します。例:

<x509-token />
<signature>
<signature-method>RSA-SHA1</signature-method>
<tbs-elements>
<tbs-element local-part="Body"
name-space="http://schemas.xmlsoap.org/soap/envelope/" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
</tbs-elements>
<add-timestamp created="true" expiry="28800" />
</signature>
<encrypt>
<recipient-key alias="orakey" />
<encryption-method>AES-128</encryption-method>
<keytransport-method>RSA-OAEP-MGF1P</keytransport-method>
<tbe-elements>
<tbe-element local-part="Body"
name-space="http://schemas.xmlsoap.org/soap/envelope/" mode="CONTENT" />
</tbe-elements>
</encrypt>

Webサービス(サンプル・データ)

サービスのデプロイメント・ディスクリプタで、<verify-x509-token>、<verify-signature>および<decrypt>要素を定義します。例:

<verify-x509-token />
<verify-signature>
<tbs-elements>
<tbs-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" />
<tbs-element name-space=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
local-part="Timestamp" />
</tbs-elements>
<verify-timestamp expiry="28800" created="true" />
</verify-signature>
<decrypt>
<tbe-elements>
<tbe-element name-space="http://schemas.xmlsoap.org/soap/envelope/"
local-part="Body" mode="CONTENT" />
</tbe-elements>
</decrypt>

13.2.8.2 Oracle WSM 11g

次のステップを実行します。

1. ポリシーを次のように添付します。
クライアント: oracle/wss10_x509_token_with_message_protection_client_policy

Webサービス: oracle/wss10_x509_token_with_message_protection_service_policy

Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

2. メッセージ本体の署名と暗号化の構成はそのまま残します。

3. 認証プロバイダとアイデンティティ・アサーション・プロバイダを構成します。

13.2.9 SSL経由のユーザー名トークン

次の各項では、SSL上のユーザー名トークンの実装方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

デプロイメント・ディスクリプタ要素の詳細は、次の10g リリース3 (10.1.3.1.0)のドキュメント・ライブラリにある『Oracle Application Server Web Servicesセキュリティ・ガイド』のOracleAS Webサービスのセキュリティ・スキーマに関する項を参照してください。

http://www.oracle.com/technology/documentation/

13.2.9.1 OC4J 10g

アプリケーション・サーバーをSSL用に構成し、次の各項の説明に従って、Webサービスとクライアントのデプロイメント・ディスクリプタを編集します。

Webサービス・クライアント(サンプル・データ)

クライアントのデプロイメント・ディスクリプタで、<username-token>および<signature>要素を定義します。例:

<username-token password-type="PLAINTEXT" add-nonce="true"
add-created="true" />
<signature>
<add-timestamp created="true" expiry="28800" />
</signature>

Webサービス(サンプル・データ)

サービスのデプロイメント・ディスクリプタで、<verify-username>要素を定義します。例:

<verify-username-token password-type="PLAINTEXT" require-nonce="false" require-created="false" />
<signature>
<verify-timestamp expiry="28800" created="true" />
</signature>

13.2.9.2 Oracle WSM 11g

次のステップを実行します。

1. アプリケーション・サーバーをSSL用に構成します。

2. ポリシーを次のように添付します。
クライアント: oracle/wss_username_token_over_ssl_client_policy

Webサービス: oracle/wss_username_token_over_ssl_service_policy

Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

13.2.10 SSL上のSAMLトークン(送信者保証)を使用したID伝播(WS-Security 1.0)

次の各項では、WS-Security 1.0標準に準拠した、SSL上のSAMLトークン(送信者保証)を使用したID伝播の実装方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

デプロイメント・ディスクリプタ要素の詳細は、次の10g リリース3 (10.1.3.1.0)のドキュメント・ライブラリにある『Oracle Application Server Web Servicesセキュリティ・ガイド』のOracleAS Webサービスのセキュリティ・スキーマに関する項を参照してください。

http://www.oracle.com/technology/documentation/

13.2.10.1 OC4J 10g

アプリケーション・サーバーをSSL用に構成し、次の各項の説明に従って、Webサービスとクライアントのデプロイメント・ディスクリプタを編集します。

Webサービス・クライアント(サンプル・データ)

クライアントのデプロイメント・ディスクリプタで、<saml-token>および<signature>要素を定義します。例:

<saml-token name="weblogic" issuer-name="www.oracle.com"
name-format="UNSPECIFIED">
<subject-confirmation-method>
<confirmation-method>SENDER-VOUCHES</confirmation-method>
</subject-confirmation-method>
</saml-token>
<signature>
<add-timestamp created="true" expiry="28800" />
</signature>

Webサービス(サンプル・データ)

サービスのデプロイメント・ディスクリプタで、<verify-saml-token>要素を定義します。例:

<verify-saml-token>
<subject-confirmation-methods>
<confirmation-method>SENDER-VOUCHES-UNSIGNED</confirmation-method>
</subject-confirmation-methods>
</verify-saml-token>
<signature>
<verify-timestamp expiry="28800" created="true" />
</signature>

13.2.10.2 Oracle WSM 11g

次のステップを実行します。

1. アプリケーション・サーバーをSSL用に構成します。

2. ポリシーを次のように添付します。
クライアント: oracle/wss_saml_token_over_ssl_client_policy

Webサービス: oracle/wss_saml_token_over_ssl_service_policy

13.2.11 ログ情報

次の各項では、ログ情報の収集を有効にする方法について説明し、OC4J 10g環境とOracle WSM 11g環境で必要となるステップを比較します。

13.2.11.1 OC4J 10g

ログおよび監査のインターセプタを構成します。

13.2.11.2 Oracle WSM 11g

Webサービスまたはクライアントに、oracle/log_policyというポリシーを添付します。

Oracle Fusion Middleware 11gにおけるポリシーの添付の詳細は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のWebサービスへのポリシーの添付に関する項を参照してください。

14 その他のOracle SOA Suiteテクノロジのアップグレード

この章では、Oracle SOAアプリケーションをOracle Fusion Middleware 11gにアップグレードする際に重要な追加情報について説明します。

Oracle SOA Suite、WebCenterおよびADFの各アプリケーションのアップグレード時に必要となる主なタスクは、第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」で説明しています。

ここでは、Oracle SOAアプリケーションのアップグレードのみに該当するタスクについて説明します。

- 第14.1項「Oracle Enterprise Service Busに関連するアップグレード・タスク」

- 第14.2項「Technology Adaptersに関連するアップグレード・タスク」

- 第14.3項「ヒューマン・ワークフロー・タスクに関連するアップグレード・タスク」

- 第14.4項「Oracle Business Rulesに関連するアップグレード・タスク」

- 第14.5項「Oracle SOA Suiteクライアント・アプリケーションのアップグレード」

14.1 Oracle Enterprise Service Busに関連するアップグレード・タスク

Oracle Enterprise Service Bus 10gからOracle Mediator 11gへのアップグレードの詳細は、次の各項を参照してください。

- サービスとして公開されないOracle Enterprise Service Busルーティング・ルールのアップグレード

- Oracle Enterprise Service Busのドメイン値マップ(DVM)と相互参照のアップグレード

- SOAPヘッダーのあるOracle Enterprise Service BusプロジェクトのOracle Mediator 11gへのアップグレード

- 同じネームスペースを使用する複数のルーティング・サービスを持つプロジェクトのアップグレード

- 非同期ルーティングを使用するためのルーティング・サービスのアップグレード

- Oracle Enterprise Service Busのメッセージ・ヘッダーのフィルタリングまたは設定のアップグレード

- ESBプロジェクトをアップグレードする前の「ESBサーバーと同期」コマンドの使用

14.1.1 サービスとして公開されないOracle Enterprise Service Busルーティング・ルールのアップグレード

Webサービスとして公開されないESBルーティング・サービスを含むOracle Enterprise Service Bus 10gプロジェクトをアップグレードする場合、ルーティング・サービスと関連コンポジットは、アップグレード後に起動されません。

この問題を解決するには、Oracle Mediator 11gで、ルーティング・サービスをWebサービスとして公開されるように変更します。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のMediatorルーティング・ルールの作成に関する項を参照してください。

また、アップグレード・プロセスを開始する前に、Oracle Enterprise Service Bus 10gプロジェクトのすべてのルーティング・サービスがWebサービスとして公開されることを確認することもできます。

14.1.2 Oracle Enterprise Service Busのドメイン値マップ(DVM)と相互参照のアップグレード

Oracle Enterprise Service Bus 10gプロジェクトでドメイン値マップを使用する場合、DVMのxPath関数と相互参照は自動的にアップグレードされますが、DVMと相互参照メタデータを11gにアップグレードするために、アップグレード後に特定のタスクを実行する必要があります。

詳細は、第9.4.8.7項「ESBリポジトリのドメイン値マップ(DVM)と相互参照(XREF)のアップグレード」を参照してください。

14.1.3 SOAPヘッダーのあるOracle Enterprise Service BusプロジェクトのOracle Mediator 11gへのアップグレード

Enterprise Service Bus(ESB)10gでXSLT関数を使用してSOAPヘッダーを操作していた場合、アプリケーションのアップグレード後、Oracle Mediator 11gでは、これらのヘッダー操作は割当てとしてモデル化されます。

複雑なヘッダー操作については、アップグレードしたOracle Mediator 11gプロジェクトをデプロイする前にSOAPヘッダーを手動で確認してください。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の静的ルーティング・ルールの作成に関する項を参照してください。

14.1.4 同じネームスペースを使用する複数のルーティング・サービスを持つプロジェクトのアップグレード

Oracle Enterprise Service Bus 10gでは、単一ESBプロジェクト内で同じtargetNameSpaceを参照するWSDLを含む複数のルーティング・サービスがサポートされます。

たとえば、Oracle Technology Networkで提供されているサンプル10gアプリケーションのうち、少なくとも1つ(samples_102_responseForwardサンプル・アプリケーション)がこのシナリオをサポートしています。

Oracle Mediator 11gでは、この構成はサポートされません。Oracle JDeveloper gでアプリケーションをアップグレードしているときに、同じtargetNameSpaceを指すWSDLを含む2つ目のサービスが検出されると、そのネームスペースに接尾辞_service-qnameが付けられ、ネームスペースが変更されます。さらに、警告メッセージがログ・ファイルに追加されます。

たとえば、Samples_102_ResponseForwardサンプル・アプリケーションでは、サービスDispatchShipmentDetailsのtargetNameSpaceは次のようになっています。

@ http://oracle.com/esb/namespaces/Samples_102_ResponseForward

アプリケーションのアップグレード後、これは次のように表示されます。

@ http://oracle.com/esb/namespaces/
Samples_102_ResponseForward_Samples.102_ResponseForward.DispatchShipmentDetails

この例で、Samples.102_ResponseForward.DispatchShipmentDetailsはサービスDispatchShipmentDetailsのQNameです。

14.1.5 非同期ルーティングを使用するためのルーティング・サービスのアップグレード

Oracle Enterprise Service Bus 10gでは、非同期ルーティング・サービスはサポートされていませんでした。Oracle Enterprise Service BusによってOracle BPEL Process Managerの非同期プロセスが呼び出されると、OneWayサービスが作成されていました。

このようなOneWayサービスを使用するプロジェクトを作成した場合は、Oracle JDeveloper 11gでアプリケーションを開いてアップグレードした後、古いルーティング・サービスを削除して、OneWayを起動するかわりにOracle Mediator 11g非同期ルーティングを使用するルーティング・サービスを再作成できます。

14.1.6 Oracle Enterprise Service Busのメッセージ・ヘッダーのフィルタリングまたは設定のアップグレード

Oracle Enterprise Service Bus 10gでは、SOAP、JCA、JMS、AQアダプタなどのアダプタの標準およびカスタム・ヘッダー・プロパティで、メッセージ・ヘッダーのフィルタリングまたは設定がサポートされます。Oracle Enterprise Service Busでのフィルタリングは、ルーティング・ルールの<filterExpression>タグの一部として実行されます。

フィルタ式の多くは自動的にアップグレードされますが、複雑なフィルタの場合、アップグレードは部分的になる可能性があります。

Oracle JDeveloper 11gでOracle Enterprise Service Busプロジェクトを開くと、各ルーティング・ルールがケースにアップグレードされ、フィルタ式が条件に変換されます。これらの変更は、ルーティング・サービスのmplanファイルで確認できます。

たとえば、次のコード・スニペットは、Oracle Enterprise Service Bus 10gルーティング・ルールのフィルタ式を示しています。

<filterExpression>{ehdr:getRequestHeader
('/fhdr:InboundFileHeaderType/fhdr:fileName') = 'Mobile.xml'};{ namespace
fhdr=http://xmlns.oracle.com/pcbpel/adapter/file/ namespace
ehdr=http://www.oracle.com/XSL/Transform/java
/oracle.tip.esb.server.headers.ESBHeaderFunctions }
</filterExpression>

アップグレード中に、この例はmplanファイル内のケースの対応する条件に変換されます。

<condition language="xpath" xmlns:ehdr="http://www.oracle.com/XSL
/Transform/java/oracle.tip.esb.server.headers.ESBHeaderFunctions"
xmlns:fhdr="http://xmlns.oracle.com/pcbpel/adapter/file/">
<expression>$in.property.jca.file.FileName ='Mobile.xml'</expression>
</condition>

メッセージ・ヘッダーの設定は、変換ファイルの一部として実行され、assign文にアップグレードされます。

次のコード・スニペットは、Oracle Enterprise Service Bus 10gのメッセージ・ヘッダー設定の例を示しています。

<xsl:variable name="inputCountry" select="/imp1:CustomerData/Country"/>
<select="ehdr:setOutboundHeader
('/jhdr:JMSOutboundHeadersAndProperties
/jhdr:JMSOutboundProperties/jhdr:Property[position()=1]/@value',$inputCountry,
'jhdr=http://xmlns.oracle.com/pcbpel/adapter/jms/;')"/>

アップグレード中に、この例は、次のように11gの対応するassign要素に変換されます。

<assign>
<copy expression="$in.CustomerData/CustomerData/Country"
target="$out.CustomerData/jhdr:JMSOutboundHeadersAndProperties
/jhdr:JMSOutboundProperties/jhdr:Property[position()=1]/@value"/>
</assign>

ほとんどの標準ヘッダー・プロパティは、対応する11gヘッダーにアップグレードされます。カスタマイズされたヘッダーは、ベスト・エフォート方式でアップグレードされますが、カスタマイズされたヘッダーのすべてのバリエーションをアップグレードすることはできません。

このため、カスタマイズされたヘッダーは、対応する条件またはassign要素と対応するmplanアーチファクトに手動でアップグレードする必要があります。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle Mediatorの概要に関する項を参照してください。

14.1.7 ESBプロジェクトをアップグレードする前の「ESBサーバーと同期」コマンドの使用

Oracle Enterprise Service Bus 10gプロジェクトをOracle SOA Suite 11gにアップグレードする際に問題が発生するのを回避するには、ESBサーバー上のサービスが、現在ESB Oracle JDeveloperプロジェクト内にあるサービスと同期されていることを確認します。

このタスクを実行する手順は、次のとおりです。

1. Oracle JDeveloper 10gの「設計」タブの上部にある「ESBサーバーと同期」アイコンをクリックします。

2. 「ESBサーバーとの同期の確認」ダイアログの「はい」をクリックします。

詳細は、Oracle Technology Network(OTN)のOracle Application Server 10g リリース3(10.1.3.1.0)で提供されている『Oracle Enterprise Service Bus開発者ガイド』のESBサーバーとのサービスの同期に関する項を参照してください。

http://www.oracle.com/technology/documentation/middleware.html

14.2 Technology Adaptersに関連するアップグレード・タスク

次の各項では、Technology AdaptersをOracle Fusion Middleware 11gにアップグレードする際に必要となる可能性のあるアップグレード・タスクについて説明します。

- Oracle JDeveloper 11gのアダプタ構成ウィザードを使用したアダプタの確認

- アダプタ・ヘッダー変数のアップグレード

- アダプタJCAファイルの非管理接続情報のアップグレード

- Technology Adapterのアップグレード後の説明の欠落

- インバウンド同期リクエスト/リプライ・ユースケースのアップグレード

- アウトバウンド・デキューを使用するプロジェクトのアップグレード

- AQアダプタ・ヘッダーのアップグレード

- Technology Adapterヘッダーをアップグレードする際のその他のステップ

- AQアウトバウンド・リクエスト/リプライ・シナリオのアップグレード

- ストアド・プロシージャに使用されるデータベース・アダプタのアップグレード

14.2.1 Oracle JDeveloper 11gのアダプタ構成ウィザードを使用したアダプタの確認

Oracle SOA Suite 10gのプロジェクトをOracle SOA Suite 11gにアップグレードした後、アダプタ構成ウィザードを使用して、テクノロジ・アダプタのアップグレードを確認することをお薦めします。これにより、11gのすべての必須フィールドに値が指定されていること、および新しいOracle Fusion Middleware 11g環境へのアダプタの接続が有効であることを確認できます。

詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』でご使用のアダプタに関する説明を参照してください。

14.2.2 アダプタ・ヘッダー変数のアップグレード

アダプタ・ヘッダーを使用するアプリケーションをアップグレードした後、Oracle JDeveloper 11gでアプリケーションを開くとエラーが表示されることが多くあります。このエラーは、ヘッダー関数の解析中に変数またはパラメータが認識されなかったことを示しています。

これは、Oracle Fusion Middleware 11gでアダプタ・ヘッダー変数の定義方法が変更されたためです。

Oracle Application Server 10g リリース3(10.1.3)では、次のような名前、または方向および使用しているアダプタ・タイプに応じた同様な名前のwsdlファイルで、アダプタ・ヘッダー変数を作成します。

fileAdapterOutboundHeader.wsdl

Oracle Fusion Middleware 11gでは、アダプタ・ヘッダー変数は、Oracle JDeveloperの「起動」ダイアログ・ボックスの「プロパティ」タブで設定するプロパティです。

たとえば、JCA Adapter for Files/FTPに対して設定できるプロパティについては、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』のインバウンド・ヘッダーに関する項で説明されています。

Oracle JDeveloper 11gでプロジェクトを開いた後、Oracle Application Server 10g用に作成したwsdlヘッダー・ファイルはプロジェクトに添付されなくなります。wsdlファイル内の各変数を、ヘッダー変数を使用する各アダプタ・タイプのプロパティとして定義する必要があります。

詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』の各アダプタ・タイプに関する章を参照してください。

14.2.3 アダプタJCAファイルの非管理接続情報のアップグレード

Oracle Application Server 10gでは、JCAファイル内の非管理接続を使用して開発リソースを指すことができます。たとえば、JCAファイル内のnon-managed-connection要素を使用して、データソース定義を指定できます。

Oracle Application Server 10gでは、非管理接続の使用は開発専用に予約されていました。Oracle Fusion Middleware 11gでは、非管理接続はサポートされていません。

Oracle Application Server 10gのプロジェクトをOracle Fusion Middleware 11gにアップグレードする前に、datasources.xmlまたはoc4j-ra.xmlファイルで適切に定義されている接続へのJNDI参照のみを含むJCAファイルをすでに使用していることが理想的です。

アダプタ接続のために非管理接続を使用するアプリケーションをアップグレードする場合は、アップグレード後に、Oracle WebLogic Server管理コンソールなど、サポートされている管理ツールを使用して定義された適切な接続を使用するようにプロジェクトを変更する必要があります。

14.2.4 Technology Adapterのアップグレード後の説明の欠落

アダプタ構成ウィザードを使用して10g リリース3(10.1.3)テクノロジ・アダプタを作成し、ウィザードの「説明」フィールドにアダプタの説明を入力した場合、Oracle JDeveloper 11gでプロジェクトを開いて移行すると、その説明は失われます。

これは、アップグレード中にdocumentation要素がWSDLファイルから削除されるためです。

アダプタが重要な場合は、プロジェクトのアップグレード後に、Oracle JDeveloper 11gのアダプタ構成ウィザードを使用して説明を追加できます。

14.2.5 インバウンド同期リクエスト/リプライ・ユースケースのアップグレード

Oracle SOA Suite 10gでMQSeriesアダプタのインバウンド同期リクエスト/リプライ・ユースケースを使用していた場合、メッセージ・タイプが1つ(REQUEST)のみであることに気付きます。

Oracle SOA Suite 11gでは、MQアダプタはREQUESTとNORMALの2つのメッセージ・タイプをサポートします。REQEUST MQメッセージ・タイプでは、ヘッダーに常にreplyToQueueが設定されるため、FallbackQueueNameとFallbackQueueManagerNameは必要ありません。これに対し、NORMALメッセージには、FallbackQueueNameとFallbackQueueManagerNameが設定される場合とされない場合があります。

このため、10gのインバウンド同期リクエスト/リプライ・シナリオを11gにアップグレードした場合、メッセージ・タイプはREQUESTタイプのままです。したがって、FallbackQueueNameとFallbackQueueManagerNameは、そのプロパティが.jcaファイルには存在しますが、実行時には必要ありません。これらのプロパティを使用する場合は、メッセージ・タイプをNORMALに設定する必要があります。

インバウンド同期リクエスト/リプライ・ユースケースの詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』のOracle MQ Seriesアダプタのユースケースに関する項を参照してください。

14.2.6 アウトバウンド・デキューを使用するプロジェクトのアップグレード

10g リリース3(10.1.3)のドキュメント化されたユースケースであるMQSeriesアダプタのアウトバウンド・デキュー・ユースケースを使用していた場合、これらのタイプのプロジェクトはOracle JDeveloper 11gにアップグレードできないことに注意してください。

このため、Oracle JDeveloper 11gへのアップグレード後に再作成する必要があります。プロジェクトの再作成中に、UITransmissionPrimitiveの値をSynchronousDequeueに設定する必要があります。

詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』のアウトバウンド・デキュー・シナリオに関する項を参照してください。

14.2.7 AQアダプタ・ヘッダーのアップグレード

Oracle Application Server Adapter for Advanced Queuing(AQアダプタ)を使用するアプリケーションをアップグレードしている場合、Oracle Fusion Middleware 11gでは、AQアダプタ・ヘッダーへのアクセス方法が異なることに注意してください。

具体的には、Oracle SOA Suite 11gにアップグレードした後、AQアダプタ・ヘッダーに対して次のアップグレード後のステップを実行する必要があります。この手順は、Oracle MediatorにアップグレードされるOracle BPEL Process ManagerプロジェクトとOracle Enterprise Service Busプロジェクトの両方に対して必要です。

- Oracle Mediatorへのアップグレード後、Oracle Mediatorファイルの.mplanファイルで、インバウンドからアウトバウンドにjca.aq.HeaderDocument値を割り当てます。

- Oracle BPEL Process Manager 11gへのアップグレード後、次の手順を実行します。

1. 文字列タイプの新しい変数vInboundHeadersを定義します。
例:

<variable name="vInboundHeaders" type="xsd:string"/>

2. receiveアクティビティで、jca.aq.HeaderDocumentプロパティが前述の変数に書き込まれていることを確認します。
例:

<bpelx:property name="jca.aq.HeaderDocument"
variable="vInboundHeaders"/>

3. 起動時に、vInboundHeaders値がjca.aq.HeaderDocumentプロパティにコピーされることを確認します。

<invoke name="Invoke_1"
inputVariable="Invoke_1_Enqueue_InputVariable"
partnerLink="EnqueueClobPayload" portType="ns2:Enqueue_ptt"
operation="Enqueue">
<bpelx:inputProperty name="jca.aq.HeaderDocument"
variable="vInboundHeaders"/>
</invoke>

14.2.8 Technology Adapterヘッダーをアップグレードする際のその他のステップ

AQアダプタを使用していない場合は、次の手順を使用するため、jca.aq.HeaderDocumentプロパティの値は取得されません。このシナリオでは、プロパティを手動で移入する必要があります。

このシナリオには2つのステップがあります。Oracle Enterprise Service BusをOracle Mediator 11gにアップグレードした後に最初のステップを実行し、Oracle BPEL Process Manager 11gにアップグレードした後に2番目のステップを実行します。

これらの例は、アダプタ・ヘッダーからOracle B2Bを起動する方法を示しています。

Oracle Mediatorへのアップグレード後に実行するステップの例

Oracle Mediatorへのアップグレード後、Oracle Mediatorファイルの.mplanファイルで、インバウンドからアウトバウンドにjca.aq.HeaderDocument値を割り当てます。

例:

<copy target="$out.property.jca.aq.HeaderDocument" expression="'&lt;?xml version =
&quot;1.0&quot; standalone= &quot;yes&quot;?>&lt;tns:Header
@ xmlns:tns=&quot;http://xmlns.oracle.com/pcbpel/adapter/aq/outbound/">
<tns:PayloadHeader>&lt;MSG_ID>&lt;
/MSG_ID>&lt;INREPLYTO_MSG_ID>&lt;
/INREPLYTO_MSG_ID>&lt;FROM_PARTY>GlobalChips&lt;
/FROM_PARTY>&lt;TOPARTY>Acme&lt;
/TO_PARTY>&lt;ACTION_NAME>&lt;/ACTION_NAME>&lt;DOCTYPE_NAME>ORDERS&lt;
/DOCTYPE_NAME>&lt;DOCTYPE_REVISION>D98A&lt;
/DOCTYPE_REVISION>&lt;MSG_TYPE>1&lt;
/MSG_TYPE>&lt;PAYLOAD>&lt;
/PAYLOAD>&lt;/tns:PayloadHeader>&lt;/tns:Header>'"/>

Oracle BPEL Process Managerへのアップグレード後に実行するステップの例

Oracle BPEL Process Manager 11gへのアップグレード後、次の手順を実行します。

1. stringタイプの新しい変数headerVariableを定義します。
例:

<variable name="headerVariable" type="xsd:string"/>

2. 例14-1にあるようなassignブロックを作成します。

3. 起動時に、headerVariable値がjca.aq.HeaderDocumentプロパティにコピーされることを確認します。

<invoke name="Send_PO" partnerLink="X12_4010_850_ENQ_Service"
portType="ns2:Enqueue_ptt"
operation="Enqueue"
inputVariable="Send_PO_Enqueue_InputVariable">
<bpelx:inputProperty name="jca.aq.HeaderDocument"
variable="headerVariable"/>
</invoke>

例14-1 アダプタ・ヘッダーをアップグレードする際のAssignブロック

<assign name="assign header ">
<copy>
<from expression="'&lt;?xml version = &quot;1.0&quot;standalone = &quot;yes&quot;
standalone = &quot;yes&quot;?>&lt;tns:Header
@ xmlns:tns=&quot;http://xmlns.oracle.com/pcbpel/adapter/aq/Inbound/">
<tns:PayloadHeader>&lt;MSG_ID>12345&lt;
/MSG_ID>&lt;INREPLYTO_MSG_ID>54321&lt;
/INREPLYTO_MSG_ID>&lt;FROM_PARTY>Acme&lt;
/FROM_PARTY>&lt;TO_PARTY>GlobalChips&lt;
/TO_PARTY>&lt;ACTION_NAME>contentType:application/octet-stream;filename:abc.xml&lt;
/ACTION_NAME>&lt;DOCTYPE_NAME>850&lt;
/DOCTYPE_NAME>&lt;DOCTYPE_REVISION>4010&lt;
/DOCTYPE_REVISION>&lt;MSG_TYPE>1&lt;/MSG_TYPE>&lt;PAYLOAD>&lt;
/PAYLOAD>&lt;/tns:PayloadHeader>&lt;/tns:Header>'"/>
<to variable="headerVariable"/>
</copy>
</assign>

14.2.9 ペイロード・ヘッダー機能に依存するコンポジット・アプリケーションのアップグレード

第14.2.7項「AQアダプタ・ヘッダーのアップグレード」では、アプリケーションがペイロード・ヘッダーにアクセスする必要がある場合にOracle Fusion Middleware 11gで必要なjca.aq.HeaderDocumentプロパティの使用方法を説明しています。ペイロード・ヘッダー機能にアクセスするすべてのOracle Application Server 10g BPELプロセスおよびESBプロセスに対して、この項で説明した手順を実行する必要があります。

第14.2.7項に記載されている情報以外に、<Header>要素および<PayloadHeader>要素のターゲット・ネームスペースにより、Oracle Fusion Middleware11g リリース1(11.1.1.3.0)が変更されました。そのため、ペイロード・ヘッダーにアクセスし、Oracle SOA Suite 10gを使用して設計されたBPELプロセスおよびESBプロセスの場合、アダプタ・ウィザードを使用してサービスおよび参照アーチファクトを再生成する必要があります。これは、Oracle Application Server 10gではパートナ・リンクとも呼ばれます。

<Header>要素の定義に正しいターゲット・ネームスペースが使用されるように、アーチファクトを再生成する必要があります。ペイロード・ヘッダーにアクセスするには、第14.2.7項に記載されているステップ以外にこのステップを実行する必要があります。

さらに、<Header>要素を使用するAssignおよびTransformationsも変更する必要があります。このステップを実行しないと、設計時と実行時にネームスペースが一致しないため、XPathエラーおよびメッセージ・エンキュー・エラーが発生します。

14.2.10 AQアウトバウンド・リクエスト/リプライ・シナリオのアップグレード

Oracle Fusion Middleware 11gでは、Oracle BPEL Process ManagerプロジェクトのAQアウトバウンド・リクエスト/リプライ・シナリオの作成に使用する手順が変更されています。

このため、このシナリオを使用するOracle SOA Suite 10gアプリケーションをアップグレードする場合、アップグレード中に作成されるWSDLファイルには必要なバインディング情報が含まれていません。

この問題を解決するために、Oracle JDeveloper 11gでアプリケーションを開いてアップグレードした後に次の手順を実行します。

1. アップグレードによって作成されたWSDLファイルに、次のようにJCAエントリを追加します。

<?binding.jca CombinedRequestReply_aq.jca?>
<wsdl:definitions name="CombinedRequestReply" ... >
.
.
.
</wsdl:definitions>

2. composite.xmlファイルにバインディング・エントリを追加します。

<reference ui:wsdlLocation="CombinedRequestReply.wsdl"
name="CombineRequestReply">
<interface.wsdl interface="http://xmlns.oracle.com/pcbpel
/adapter/aq/EnqueueRequest/#wsdl.interface(Enqueue_ptt)"
callbackInterface="http://xmlns.oracle.com/pcbpel
/adapter/aq/DequeueReply/#wsdl.interface(Dequeue_ptt)"
xmlns:ns="http://xmlns.oracle.com/sca/1.0"/>
<binding.jca config="CombinedRequestReply_aq.jca"/>
</reference>

3. .bpelファイルから、使用されないWSDL参照をすべて削除します。

14.2.11 ストアド・プロシージャに使用されるデータベース・アダプタのアップグレード

第9.2項「Oracle SOA Suiteアプリケーションに対するOracle JDeveloper 11g移行ウィザードの使用」の説明に従って、11gにアップグレードする前に、Oracle SOA Suite環境に最新のパッチ・セットを適用し、最新の10g リリース3 (10.1.3) Oracle JDeveloperを使用することをお薦めします。

ただし、10g リリース3(10.1.3.3)以前のリリースからアップグレードしている場合は、ストアド・プロシージャ用のデータベース・アダプタを使用する際に次のことに注意してください。

- Oracle SOA Suite 10g リリース3(10.1.3.3)以前では、アダプタのXSDジェネレータにより、非修飾要素を含むXSDが生成されます。非修飾要素は、XSDファイルのInputParametersルート要素を確認することによって識別できます。非修飾要素は、次のように表示されます。

<db:InputParameters ... ></db:InputParameters>

db:ネームスペースは、スキーマの定義で指定され、ターゲット・ネームスペースと同じです。

- 10g リリース3(10.1.3.4)以降では、XSDジェネレータによって修飾要素が生成されます。これは、次のようにInputParametersルート要素に表示されます。

<InputParameters ..></InputParameters>

db:ネームスペースが削除されていることに注意してください。

- Oracle SOA Suiteバージョンと互換性のないOracle JDeveloper 10g リリース3(10.1.3)のバージョンを使用している場合は、要素が削除されるシナリオに遭遇する可能性もあります。

<null>(some value)</null>

この解決策は、次のとおりです。

- 最初に、Oracle SOA Suite環境のバージョンと一致しているOracle JDeveloperバージョンを使用していることを確認します。

- 次に、Oracle JDeveloperとOracle SOA Suite10g リリース3(10.1.3.4)、またはOracle SOA SuiteとOracle JDeveloper 11gにアップグレードした後、XSDを再生成します。

XSDをアップグレードして再生成した後、関連する割当てアクティビティとxPath式を適切に変更する必要があります。

14.3 ヒューマン・ワークフロー・タスクに関連するアップグレード・タスク

ヒューマン・ワークフロー・タスクを使用するOracle SOA Suiteアプリケーションをアップグレードしている場合は、次のアップグレード・タスクについて考慮する必要があります。

- 関連するヒューマン・ワークフロー・タスクのタスク詳細のアップグレード

- 共通ヒューマン・ワークフロー・タスクを共有する複数プロジェクトのアップグレード

- アップグレード後のヒューマン・ワークフロー・タスクの編集

14.3.1 関連するヒューマン・ワークフロー・タスクのタスク詳細のアップグレード

ヒューマン・タスクのタスク詳細を含むOracle SOA Suite 10gアプリケーションをアップグレードしている場合は、次のことに注意してください。

- Oracle SOA Suite 10g リリース3(10.1.3)では、タスク詳細は同じコンポジット・プロジェクト内で生成され、コンポジットのデプロイ中にデプロイされていました。

- Oracle SOA Suite 11gでは、タスク詳細は、個別にデプロイする必要のある個別のプロジェクトとして生成されます。

このため、Oracle Human Workflowのアップグレード中に、Oracle JDeveloper 11gで自動的にタスク詳細UI用の新しいプロジェクトが作成され、タスク詳細ページがアップグレードされます。関連するコンポジット・アプリケーションをデプロイした後、このプロジェクトを個別にデプロイする必要があります。

14.3.2 共通ヒューマン・ワークフロー・タスクを共有する複数プロジェクトのアップグレード

共通のヒューマン・ワークフロー・タスクを共有する複数のOracle JDeveloperプロジェクトを含むアプリケーションをアップグレードしている場合、Oracle JDeveloper 11gでアップグレードされたアプリケーションを慎重に確認してください。

アップグレード中に複数のプロジェクトが共通ディレクトリに移動するため、2つのプロジェクトのワークフロー・タスクで同じ名前が使用されている場合には、最初のプロジェクトに関連付けられているデータによって2番目のプロジェクトのデータが上書きされる可能性があります。

14.3.3 アップグレード後のヒューマン・ワークフロー・タスクの編集

Oracle JDeveloper 11gを使用してヒューマン・ワークフロー・タスクによりアプリケーションをアップグレードした後に、タスク・ファイルを編集するタスク・エディタを使用すると、Oracle JDeveloperでは、新しいペイロードXSDファイルが自動的に生成されます。

ただし、既存のWorkflowTask XSDファイルには、10gバージョンのアプリケーションで使用されるペイロードXSDファイルへの参照が含まれます。

この問題を修正するには、WorkflowTask XSDファイルが新しいペイロードXSDファイルを参照するように編集します。

例:

- 次のエントリを変更します。

<include schemaLocation="***_payload.xsd" xmlns=""/>

これを次のように変更します。

<include schemaLocation="***Payload.xsd" xmlns=""/>

- 次のエントリを変更します。

<element name="payload" type="tns:payloadType" minOccurs="0"maxOccurs="1"/>

これを次のように変更します。

<element name="payload" type="tns:***PayloadType" minOccurs="0"maxOccurs="1"/>

これらの例では、アスタリスクをペイロードXSDファイルに定義されている適切な名前とタイプに置き換えます。

14.4 Oracle Business Rulesに関連するアップグレード・タスク

Oracle Business Rulesを使用するプロジェクトをアップグレードする際には、次のドキュメント・リソースを参照してください。

- 第9.4.1.1項「Oracle Business Rules用のOracle Fusion Middleware Java APIへのアップグレード」

- 付録B「Oracle Business Rulesのディクショナリおよびプロジェクトのアップグレード」

14.5 Oracle SOA Suiteクライアント・アプリケーションのアップグレード

Oracle SOA Suiteアプリケーションの11gへのアップグレード中に、Oracle SOA Suite 10g環境がまだ稼働している場合は、最初にOracle SOA Suite環境に依存するクライアント・アプリケーションを確認、アップグレードおよびテストしてください。

次のリストを使用して、アップグレード後の新しい11g Oracle SOA Suite環境でクライアント・アプリケーションが動作するために必要な更新を分析してください。

- クライアント・アプリケーションで、使用中のリモート Oracle SOA Suite APIを確認します。
詳細は、第9.4.1項「Oracle Fusion Middleware 11gにおけるOracle SOA Suite APIの変更について」を参照してください。

- クライアント・アプリケーションで、Oracle SOA Suite HTTP URLへの参照を検索します。Oracle SOA Suite 11g HTTP URLの構文は、10gから変更されています。
デプロイしたOracle SOA Suite 11gアプリケーションにアクセスするためにクライントが使用できる新しいURLを取得するには、Oracle Enterprise Manager Fusion Middleware Controlのアプリケーション・デプロイメントのホーム・ページを使用します。詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドのSOAコンポジット・アプリケーションの監視に関する項を参照してください。

- JMSキューやデータソースなど、クライアント・アプリケーションのメッセージ・ターゲットへの参照を確認します。これらのリソースへの参照は、アップグレード後のOracle SOA Suite 11g環境を指すように更新する必要があります。

- クライアント・アプリケーションが Oracle Service Bus(OSB)を使用して、最適化された転送によってOracle BPEL Process Managerプロセスを起動している場合は、SOAP/HTMLを使用してOracle BPEL Process Managerプロセスを起動するようにクライアント・アプリケーションを変更する必要があります。
詳細は、Oracle Technology Network (OTN)で提供されているOracle Service Bus 10g リリース3 (10.3)のドキュメントを参照してください。

http://www.oracle.com/technology/documentation/bea.html

15 Oracle WebCenterアプリケーションのアップグレード時の考慮事項

この章では、Oracle WebCenter 10.1.3.xアプリケーションをOracle WebCenter Portal 11gにアップグレードする方法について説明します。

Oracle SOA、Oracle WebCenterおよびADFの各アプリケーションのアップグレード時に必要となる主なタスクは、第8章「Oracle SOA Suite、WebCenterおよびADFアプリケーションのアップグレードの概要」を参照してください。

Oracle WebCenterアプリケーションのアップグレードに固有のタスクについては、次の各項を参照してください。

- WebCenterアプリケーションのアップグレードについて

- WebCenterアプリケーションのアップグレードの前提条件

- WebCenterコンシューマ・アプリケーションのアップグレード

- ポートレット・プロデューサのアップグレード

- データの移行

注意:

この章では、該当する箇所で最近商標変更されたOracle WebCenter Portal製品名を使用しています。詳細は、第3.3.1項「Oracle WebCenterおよびOracle Enterprise Content Management Suiteの新規製品名」を参照してください。

15.1 WebCenterアプリケーションのアップグレードについて

この項では、主なアップグレード・タスクを示し、様々なWebCenterアプリケーション・テンプレートの概要について説明します。

15.1.1 WebCenterアプリケーションのアップグレードに関連するタスク

WebCenter 10.1.3.xアプリケーションの機能、およびアプリケーションで使用するように構成されているWebCenterサービスに応じて、次のタスクを実行してアプリケーションをOracle WebCenter Portal 11gにアップグレードすることが必要となる場合があります。

- Oracle JDeveloperを使用したWebCenterコンシューマ・アプリケーションのアップグレード

- WebCenterポートレット・プロデューサ・アプリケーションおよびそのカスタマイズ内容のアップグレード(WebCenterアプリケーションにポートレットが含まれている場合)

- WebCenterサービスに関連するデータの移行(指定されたサービスをWebCenterコンシューマ・アプリケーションで使用している場合)

注意:

この章では、WebCenterコンシューマ・アプリケーションとは、ユーザー・インタフェースを提供し、アプリケーションに必要なJSPページおよびコンポーネントが含まれているアプリケーションを表します。ポートレット・プロデューサ・アプリケーションとは、Oracle WebCenterサーバー側プロデューサ・コンポーネントと、WebCenterコンシューマ・アプリケーションで使用できるポートレットが含まれているアプリケーションを表します。

15.1.2 WebCenterアプリケーションのテンプレートについて

Oracle WebCenter 10.1.3.xアプリケーションとOracle WebCenter Portal 11gアプリケーションは、様々なアプリケーション・テンプレートに基づいています。WebCenterアプリケーションをアップグレードする前に、様々なテンプレートについて理解しておくことが重要です。

JDeveloper 10.1.3.xでは、WebCenterアプリケーションはWebCenterアプリケーション[ポートレット、コンテンツ・リポジトリ、JSF]アプリケーション・テンプレートを使用して作成されます。WebCenterコンシューマ・アプリケーションとポートレット・プロデューサ・アプリケーションのどちらもこの同じテンプレートに基づきます。

一方、Oracle WebCenter Portal 11gアプリケーションは、WebCenter Portal - Frameworkアプリケーション・テンプレート(コンシューマ・アプリケーションの場合)またはWebCenter Portal - ポートレット・プロデューサ・アプリケーション・テンプレート(ポートレット・プロデューサ・アプリケーションの場合)に基づいて作成されます。

JDeveloper 10.1.3.xの場合、「モデル」、「ポートレット」、「ViewController」という3つのプロジェクトでWebCenterアプリケーションが構成されます。JDeveloper 11gの場合、WebCenter Portal - Frameworkアプリケーション・テンプレートを使用して作成されたアプリケーションには、Portalプロジェクト(サイト・ナビゲーションおよびページ階層などの機能が含まれる)およびPortalWebAssetsプロジェクト(HTMLファイルおよびイメージ・ファイルなどの静的アプリケーション・リソースが含まれる)が含まれます。WebCenter Portal - ポートレット・プロデューサ・アプリケーション・テンプレートを使用して作成されたアプリケーションには、JSR 286(規格ベース)ポートレットおよびOracle PDK-Javaポートレットの作成を目的とした「ポートレット」というプロジェクトが1つだけ含まれています。

15.2 WebCenterアプリケーションのアップグレードの前提条件

WebCenter 10.1.3.xアプリケーションをアップグレードする前に、次のタスクを実行します。

1. アプリケーションがOracle Application Server 10g上で正常に稼働していることを確認します。
詳細は、第8.2項「タスク2: アプリケーションがOracle Application Server 10g上で正常に稼働していることの確認」を参照してください。

2. Oracle WebCenter 10.1.3.x環境がOracle WebCenter Portal 11g環境にアップグレードされていることを確認します。
詳細は、第8.4項「タスク4: 10g環境から11g環境へのアップグレードが完了していることの確認」を参照してください。

3. Oracle JDeveloper 11gをインストールします。
詳細は、第8.5項「タスク5: Oracle JDeveloper 11gのインストールと起動」を参照してください。

4. WebCenter Portal拡張バンドルをインストールします。
WebCenterアプリケーションで作業するには、WebCenter Portal拡張機能(JDeveloperにすべてのWebCenter Portal機能を提供するJDeveloperアドイン)をインストールする必要があります。

Oracle WebCenter Portal 11g拡張機能をインストールする手順は、次のとおりです。

1. JDeveloper 11gを起動します。

注意:

アプリケーション設定をJDeveloper 10.1.3.xからアップグレードする場合は、JDeveloper 11gを初めて起動する前に、WebCenterアプリケーションを終了してJDeveloper 10.1.3.xのIDEから削除します。これにより、JDeveloperの起動時に、アプリケーションを移行するときおよびアプリケーションの移行を呼び出さないときを詳細に制御できます。

アプリケーションをIDEから削除するには、アプリケーション・ナビゲータでアプリケーション名を右クリックし、ショートカット・メニューから「削除」を選択します。アプリケーションを削除すると、アプリケーションはIDEからのみ削除され、ローカル・ストレージ・システムからは削除されません。

2. 「ロールの選択」ダイアログが表示される場合は、「デフォルトのロール」を選択して全テクノロジを有効にして、「OK」をクリックします。

3. JDeveloper 11gを初めて起動した場合、以前のバージョンのJDeveloperからプリファレンスをインポートするかどうかを尋ねられます。
「インポート・プリファレンスの確認」ダイアログで、「検索」アイコンをクリックしてプリファレンスのコピー元のJDeveloperバージョンを選択します。次に「はい」をクリックすると、ダイアログにリストされた以前のバージョンのJDeveloperから、OmniPortletやWebクリッピングなどの事前構成したポートレット・プロデューサのポートレットのカスタム・データが自動的に移行されます。「すべてのインストールを表示 >>」ボタンをクリックし、必要なバージョンを選択することで、JDeveloperの別のバージョンを選択することもできます。

「いいえ」を選択した場合は、以前のバージョンのJDeveloperからポートレットのカスタマイズ内容が移行されないことに注意してください。この場合、カスタマイズ内容を手動で移行する必要があります。デフォルトの場所からカスタマイズ内容を手動で移行する方法の詳細は、第15.4.2.4.1項「デフォルトの場所からのカスタマイズ内容の移行」を参照してください。

注意:

Jdeveloperの移行ユーティリティにより、事前構成したポートレット・プロデューサのポートレットのカスタマイズ内容は、デフォルトの場所である10.1.3.x_jdev_install_dir/portal/portletdataからのみ移行されます。

事前構成済ポートレット・プロデューサのカスタマイズ内容を格納するのにデフォルト以外の場所が使用されていた場合、そのカスタマイズ内容は手動で移行する必要があります。事前構成済ポートレット・プロデューサ以外のポートレット・プロデューサのカスタマイズ内容を移行するには、プリファレンス・ストア移行ユーティリティを使用する必要があります。

詳細は、次のリソースを参照してください。

- デフォルトの場所から事前構成済ポートレット・プロデューサのカスタマイズ内容を手動で移行する場合は、第15.4.2.4.1項「デフォルトの場所からのカスタマイズ内容の移行」を参照してください。

- デフォルト以外の場所から事前構成済ポートレット・プロデューサのカスタマイズ内容を移行する場合は、第15.4.2.4.2項「デフォルト以外の場所からのカスタマイズ内容の移行」を参照してください。

- 事前構成したポートレット・プロデューサ以外のポートレット・プロデューサのカスタマイズ内容を移行する場合は、第15.4.3.1項「カスタマイズ内容の移行」を参照してください。

4. 「ヘルプ」メニューから「更新の確認」を選択します。

5. 「更新の確認」ウィザードの「ようこそ」ページで、「次へ」をクリックします。

6. 「ソース」ページで、「更新センターの検索」を選択した後、「次へ」をクリックします。

7. 「更新」ページで、WebCenter Portal拡張機能を検索して選択した後、「終了」をクリックします。

注意:

WebCenter Portal拡張機能の取得とインストールの詳細は、Oracle Technology Network (OTN)のWebCenter Portalページを参照してください。

http://webcenter.oracle.com

8. JDeveloper 11gを再起動するかどうかを尋ねるメッセージに対し、「はい」をクリックします。

9. 「インポート・プリファレンスの確認」ダイアログで、以前のバージョンのJDeveloperからプリファレンスをインポートするかどうかを尋ねられた場合は、「はい」をクリックします。このプリファレンスには、ポートレットのカスタム・データが含まれています。
これで、JDeveloperがWebCenter Portalのコンシューマ・アプリケーションおよびポートレット・プロデューサ・アプリケーションを作成するように構成されました。

15.3 WebCenterコンシューマ・アプリケーションのアップグレード

表15-1は、Oracle WebCenter Portal 11gへのWebCenter 10.1.3.xコンシューマ・アプリケーションのアップグレードに関連するタスクを示したものです。

表15-1 WebCenter 10.1.3.xコンシューマ・アプリケーションのアップグレードのタスク・フロー

タスク

サブタスク

タスクの実行状況

アプリケーションのアップグレード準備

アプリケーションのバックアップ

全状況

Oracle Content DBに依存しているアプリケーションの準備

WebCenter 10.1.3.2または10.1.3.3アプリケーションにOracle Content Database(Oracle Content DB)接続が含まれている場合

ポートレットが含まれているアプリケーションの準備

WebCenterアプリケーションにポートレットが含まれている場合

アプリケーションのアップグレード

WebCenterアプリケーションのアップグレード

全状況

アプリケーションのアップグレード後タスクの実行

カスタマイズ可能なコンポーネントのアプリケーション設定の構成

WebCenterアプリケーションにカスタマイズ可能なコンポーネントが含まれている場合

Oracle Portal接続のアップグレード

WebCenterアプリケーションにOracle Portal接続が含まれている場合

ADFセキュリティの構成

WebCenterアプリケーションにセキュリティが適用されている場合

事前構成済ポートレット・プロデューサのプロデューサ登録のアップグレード

事前構成済ポートレット・プロデューサがデフォルト・ポート(6688)にデプロイされていない場合

アプリケーションの再デプロイ

全状況

この項には次のサブセクションがあります。

- アプリケーションのアップグレード準備

- WebCenterアプリケーションのアップグレード

- アプリケーションのアップグレード後タスクの実行

15.3.1 アプリケーションのアップグレード準備

WebCenter 10.1.3.xアプリケーションをJDeveloper 11gで開くと、アプリケーションはOracle WebCenter Portal 11gに自動的にアップグレードされます。ただし、アップグレードする前にアプリケーションをバックアップする必要があります。さらに、アプリケーションにポートレットが含まれているか、またはOracle Content DBに依存しているかに応じて、アップグレード前に特定のタスクを実行する必要がある場合があります。

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

- アプリケーションのバックアップ

- Oracle Content DBに依存しているアプリケーションの準備

- ポートレットが含まれているアプリケーションの準備

注意:

アプリケーションのアップグレード時は、JDeveloper 10.1.3.xインストールを保持してください。アプリケーションの移行準備をするには、JDeveloper 10.1.3.xで特定のタスクの実行が必要な場合があります。

15.3.1.1 アプリケーションのバックアップ

アプリケーションのバックアップは重要です。Oracle WebCenter Portal 11gにアップグレードしたWebCenter 10.1.3.xアプリケーションは、以前のリリースのJDeveloper 11gでは開くことができなくなります。また、アップグレード中にアプリケーションに行った変更は、元に戻すことはできません。ソース・コントロール・システムを使用している場合は、個別のバックアップは不要な場合があります。

15.3.1.2 Oracle Content DBに依存しているアプリケーションの準備

注意:

アプリケーションにOracle Content DB接続が含まれていない場合は、この項は省略してください。

Oracle Content DBに依存しているWebCenter 10gアプリケーションの場合に必要な作業は次のとおりです。

- Oracle Content Serverがインストールされていることを確認してください。Oracle WebCenter Portal 11gでは、Oracle Content DBをコンテンツ・リポジトリとしてサポートしていません。WebCenter 10gアプリケーションがコンテンツ統合に関してOracle Content DBに依存している場合は、そのようなアプリケーションのコンテンツ・リポジトリとしてOracle Content Server 10.1.3.5.1またはOracle WebCenter Content Server 11gを使用する必要があります。Oracle Content Serverのインストールまたはアップグレードの詳細は、第7.6.2項「Oracle Content Serverのアップグレード」を参照してください。

- 第15.5.2項「Oracle Content DBデータの移行」の説明に従って、Content DBからOracle Content Serverにアプリケーション・データを移行します。

- この項で説明されている手順に従って、アプリケーションをアップグレードします。

WebCenter 10.1.3.2または10.1.3.3のアプリケーションはOracle Content DBに依存しており、Oracle WebCenter Portal 11gに直接アップグレードできません。これらのアプリケーションは、Oracle WebCenter 10.1.3.4にアップグレードして、コンテンツ・リポジトリ・データ・コントロールの接続タイプとしてOracle Content Serverを追加できるようにする必要があります。

WebCenter 10.1.3.2または10.1.3.3アプリケーションをOracle WebCenter 10.1.3.4にアップグレードする手順は、次のとおりです。

1. アプリケーションをJDeveloper 10.1.3.4で開き、アップグレード・ウィザードの指示に従います。

2. アップグレードしたアプリケーションの既存のコンテンツ・リポジトリ・データ・コントロールを、Oracle Content Serverを指すように編集します。このためには、接続タイプをOracle Content Serverに変更し、カスタム属性定義を再定義する必要があります。アップグレードしたWebCenter 10.1.3.4アプリケーションでは、カスタム属性に対し、WebCenter 10.1.3.2または10.1.3.3アプリケーションで使用していたものと同じ名前および値を使用する必要があります。
コンテンツ・リポジトリ接続の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための開発者ガイドの、コンテンツ・リポジトリ・データ・コントロールの編集に関する項およびOracle Content Serverアダプタに基づくコンテンツ・リポジトリ接続の作成方法に関する項を参照してください。

これらのタスクの実行後に、第15.3.2項「WebCenterアプリケーションのアップグレード」の説明に従って、WebCenter 10.1.3.4 アプリケーションをOracle WebCenter Portal 11gにアップグレードできます。

15.3.1.3 ポートレットが含まれているアプリケーションの準備

注意:

WebCenter 10gアプリケーションにポートレットが含まれていない場合は、この項は省略してください。

JDeveloper 11gでは、WebCenterアプリケーションに「ポートレット」プロジェクトは含まれていません。ただし、WebCenter 10.1.3.xアプリケーションにポートレットが含まれている場合、アップグレードした後もアプリケーションには「ポートレット」プロジェクトが含まれています。このため、WebCenterアプリケーションをアップグレードする前に、「ポートレット」プロジェクトをアプリケーションから手動で削除する必要があります。

注意:

ポートレット・プロデューサをアップグレードするには、Oracle WebCenter Portal 11gでポートレット・プロデューサ・アプリケーションを作成する必要があります。第15.4.2.2項「JDeveloperで作成されたポートレット・プロデューサのアップグレード」に説明されているように、ポートレット・プロデューサをアップグレードするときには10.1.3.xアプリケーションの「ポートレット」プロジェクトのコピーが必要になります。

「ポートレット」プロジェクトをWebCenter 10.1.3.xアプリケーションから削除する手順は、次のとおりです。

1. JDeveloper 10.1.3.xを起動します。

注意:

「ポートレット」プロジェクトを削除するには、JDeveloper 11gではなくJDeveloper 10.1.3.xを使用する必要があります。

2. アップグレードする10.1.3.xアプリケーションを開きます。

3. アプリケーション・ナビゲータで、「ポートレット」プロジェクトを選択します。

4. 「ファイル」メニューから「ディスクから削除」を選択します。

5. 「はい」をクリックし、アプリケーションからプロジェクトを削除します。

6. アプリケーションを保存します。

15.3.2 WebCenterアプリケーションのアップグレード

注意:

10.1.3.x WebCenterアプリケーションに許可のない権限が含まれる場合、権限は適切に移行されません。アプリケーションをアップグレードする前に、10.1.3ワークスペース内のapp-jazn-data.xmlファイルを調べて、空の権限セットを持つ権限付与を削除する必要があります。

WebCenter 10.1.3.xアプリケーションの準備が終わった後、そのアプリケーションをOracle WebCenter Portal 11gにアップグレードできます。

WebCenter 10.1.3.xアプリケーションをOracle WebCenter Portal 11gにアップグレードする手順は、次のとおりです。

1. JDeveloper 11gを起動します。

2. WebCenter 10.1.3.xアプリケーションを開きます。
これによりアップグレード・ウィザードが呼び出されます。このウィザードは、WebCenter 10.1.3.xアプリケーションをJDeveloper 11gで開くたびに表示されます。

3. 「ようこそ」ページで、「次へ」をクリックします。

4. 「確認」ページでは、図15-1のように、デフォルトでは「はい」オプションが選択されています。「次へ」をクリックし、アプリケーションとそのプロジェクトのアップグレードを確定します。
「いいえ」を選択すると、移行プロセスは中断され、アプリケーションはJDeveloperで開かれません。

図15-1 移行ウィザードの「確認」ページ

「図15-1 移行ウィザードの「確認」ページ」の説明

5. 「Webapp 2.5移行」ページで、図15-2のように、JavaServer Pages Standard Tag Library(JSTL)バージョン1.0または1.1を使用して作成されたプロジェクトを移行するかどうかを指定します。デフォルトの設定を受け入れるには、「次へ」をクリックします。

図15-2 移行ウィザードの「Webapp 2.5移行」ページ

「図15-2 移行ウィザードの「Webapp 2.5移行」ページ」の説明

6. 「コンポーネントID」ページで、コンポーネントIDを移行してランダム化するかどうかを指定します。「次へ」をクリックし、デフォルトの設定を受け入れます。(図15-3)

図15-3 移行ウィザードの「コンポーネントID」ページ

「図15-3 移行ウィザードの「コンポーネントID」ページ」の説明

7. トリニダード移行ページで、「次へ」をクリックします。(図15-4)

図15-4 移行ウィザードのトリニダード移行ページ

「図15-4 移行ウィザードのトリニダード移行ページ」の説明

8. 「終了」をクリックし、WebCenterアプリケーションのアップグレードを開始します。(図15-5)
アプリケーションのサイズによっては、アップグレード・プロセスに時間がかかる場合があります。アップグレード・プロセスの実行中は進行状況を示すダイアログが表示されます。アプリケーションのアップグレードが終了すると、図15-6のように、アップグレードされたプロジェクトのリストが「移行ステータス」ダイアログに表示されます。

図15-5 移行ウィザードの「終了」ページ

「図15-5 移行ウィザードの「終了」ページ」の説明

9. 「OK」をクリックします。

図15-6 移行ステータス

「図15-6 移行ステータス」の説明

アップグレードしたアプリケーションが開き、そのプロジェクトがアプリケーション・ナビゲータに表示されます。図15-6および図15-7で、移行されたプロジェクトのリストに「ポートレット」プロジェクトが含まれていない点に注目してください。

アプリケーションのアップグレード中にエラーが発生した場合は、エラーが「メッセージ - ログ」ウィンドウに表示されます。

図15-7 JDeveloper 11gにアップグレードされたプロジェクト

「図15-7 JDeveloper 11gにアップグレードされたプロジェクト」の説明

注意:

デフォルトでは、WebCenter 10.1.3.xアプリケーションはsuedeスキンを使用するように構成されるのに対し、WebCenter Portal 11gアプリケーションはfusionスキンを使用するように構成されます。WebCenter 10.1.3.xアプリケーションをアップグレードする際、suedeスキンの設定はアップグレード後のアプリケーションでも維持され、10.1.3.xアプリケーションに似たルック・アンド・フィールが提供されます。アップグレード後のアプリケーションでADFリッチ・スキンfusionを使用する場合は、trinidad-config.xmlファイルのスキン設定を更新します。

15.3.3 アプリケーションのアップグレード後タスクの実行

アプリケーションのアップグレード中は、JDeveloper 11gのアップグレード・ユーティリティによってアプリケーションに様々な変更が加えられ、Oracle WebCenter Portal 11g用に構成されます。これらの変更には、次に関連するものが含まれます。

- カスタマイズ可能コンポーネント

- 外部アプリケーション

- ポートレット・コンポーネントの変更

これらの変更の詳細は、第16章「その他のOracle WebCenterアップグレードの詳細」を参照してください。

WebCenterコンシューマ・アプリケーションのアップグレード後は、様々なアップグレード後タスクの実行が必要な場合があります。これには次のタスクが含まれます。

- カスタマイズ可能なコンポーネントのアプリケーション設定の構成

- アプリケーションのMDSからプロジェクト・ディレクトリへのリソース・カタログの移動

- Oracle Portal接続のアップグレード

- ADFセキュリティの構成

- 事前構成済ポートレット・プロデューサのプロデューサ登録のアップグレード

- アプリケーションの再デプロイ

15.3.3.1 カスタマイズ可能なコンポーネントのアプリケーション設定の構成

アップグレード後のWebCenterアプリケーションにカスタマイズ可能なコンポーネント(ShowDetailFrame、PanelCustomizableなど)が含まれている場合、カスタマイズ可能なコンポーネントに関連するカスタマイズ内容またはパーソナライズが引き続き機能するように、web.xmlを更新する必要があります。そのためには、ComposerChangeManagerをMDSDocumentChangeManagerに置換する必要があります。

web.xmlで、次のコンテキスト・パラメータ・エントリを置換します。

<context-param>
<param-name>org.apache.myfaces.trinidad.CHANGE_PERSISTENCE</param-name>
<param-value>oracle.adf.view.page.editor.change.ComposerChangeManager
</param-value>
</context-param>

置換後のエントリ:

<context-param>
<param-name>org.apache.myfaces.trinidad.CHANGE_PERSISTENCE</param-name>
<param-value>oracle.adf.view.rich.change.MDSDocumentChangeManager</param-value>
</context-param>

15.3.3.2アプリケーションのMDSからプロジェクト・ディレクトリへのリソース・カタログの移動

Oracle WebCenter Portal 11gにおいて、WebCenterアプリケーションではリソース・カタログのビジュアル・エディタをサポートします。アップグレードしたアプリケーションでこのビジュアル・エディタを使用する場合、リソース・カタログをアップグレード済アプリケーションのMDSディレクトリからプロジェクト・ディレクトリの1つに手動で移動する必要があります。

アップグレードしたアプリケーションのMDSからプロジェクト・ディレクトリにリソース・カタログを移動する方法は次のとおりです。

1. ファイル・システムで、アップグレードしたアプリケーションのリソース・カタログ定義に移動します。リソース・カタログのデフォルトの場所はapp-root/mds/oracle/adf/rc/metadataです。

2. ファイル・システムで、カタログ定義をアプリケーションの必須プロジェクトの下にあるJavaパッケージに移動します。
カタログの相対パスを変更しないことをお薦めします。たとえば、次のように移動します。

app_root/mds/oracle/adf/rc/metadata/default-catalog.xml

移動先

app_root/project/src/oracle/adf/rc/metadata/default-catalog.xml

3. 場所app-root/.adf/META-INFからadf-config.xmlを開きます。

4. 太字で強調表示されているエントリを削除します。

<metadata-namespaces>
....
<namespace path="/oracle/adf/rc/metadata"
metadata-store-usage="WebCenterFileMetadataStore"/>
....
</metadata-namespaces>

注意:

MDSからプロジェクト・ディレクトリにリソース・カタログを移動した場合でも、リソース・カタログはMDSを通じてロードされます。カタログでMDSを検索できるようにするには、選択したJavaパッケージがadf-config.xml内のMDSネームスペースに対応していてはなりません。MDSネームスペース・マッピングは、adf-config.xmlの<metadata-namespaces>に格納されています。

5. 異なるMDSネームスペースにカタログが格納されていた場合、WebCenter 10gアプリケーションで、新しい場所がどのMDSネームスペース・マッピングとも対応しないように、古いネームスペースのマッピングの削除またはカタログの新しい場所の調整、あるいはその両方を行います。

6. デフォルト・カタログの相対位置を変更している場合は、adf-config.xmlの次のエントリを更新(または追加)します。

<rcv-config xmlns="http://xmlns.oracle.com/adf/rcs/viewer/adf-config">
<default-catalog catalog-name="path_to_your_catalog_default-catalog.xml"/>
</rcv-config>
<adf-rcs-config xmlns="http://xmlns.oracle.com/adf/rcs/adf-config">
<rcs-config>
<catalog-config
default-scope="path_prefix"/>
</rcs-config>
</adf-rcs-config>

すべてのカタログIDに接頭辞path_prefixを付けてMDS参照を作成する必要があります。path_prefixの値は"/"の可能性があり、その場合はすべてのカタログ・パスが完全修飾MDS参照(ResourceCatalogSelectorによって返されたものを含む)である必要があります。

7. CatalogSelectorクラスがある場合、新しいカタログ場所を反映するように実装を更新します。CatalogSelectorクラスがある場合、<rcv-config>要素に次のエントリが含まれます。

<catalog-selector class-name="name_of_your_CatalogSelectorClass"/>

8. adf-config.xmlを保存します。

15.3.3.3 Oracle Portal接続のアップグレード

Oracle Portalアダプタに基づくコンテンツ・リポジトリについては、データ・ソースをデータベース接続にアップグレードする必要があります。最初にJDeveloper 11gを起動したときに、以前のバージョンのJDeveloperから設定をアップグレードするかどうかを尋ねるメッセージが表示されます。

- 「はい」を選択すると、データベース接続が自動的にアップグレードされ、JDeveloper 11gのIDE接続から接続を使用できるようになります。

- 「いいえ」を選択した場合、データベース接続はアップグレードされません。

設定のアップグレードに関するJDeveloperのメッセージに対して「はい」を選択した場合、WebCenterアプリケーションのアップグレード時に、アップグレードされたデータベース接続がアップグレード・ユーティリティによって使用されます。以前のバージョンのJDeveloperから設定をアップグレードしなかった場合、アップグレード・ユーティリティはアプリケーションのdata-sources.xmlファイル内の情報を使用してデータベース接続の作成を試みます。この場合、データベース接続のパスワードは使用できません。そのため、アプリケーションのアップグレード後に、データベース接続の編集ウィザードを使用してデータベース接続のパスワードを指定する必要があります。

まれに、Oracle Portalアダプタで使用されているデータベース接続が自動的にアップグレードまたは作成されないことがあります。この場合は、アプリケーションのアップグレード後に、データベース接続の作成ウィザードを使用して新しいデータベース接続を作成する必要があります。このウィザードはコンテンツ・リポジトリ接続の編集ウィザードからアクセスできます。データベース接続の作成方法の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための開発者ガイドのOracle Portalアダプタに基づくコンテンツ・リポジトリ接続の作成方法に関する項を参照してください。

15.3.3.4 ADFセキュリティの構成

WebCenter 10.1.3.xアプリケーションにADFセキュリティが適用されている場合は、アプリケーションのアップグレード後にセキュリティを再構成する必要があります。

ADFセキュリティが適用されているWebCenterアプリケーションをアップグレードすると、ADFセキュリティ・ポリシーがアップグレードされます。approot/.adf/META-INF/app-jazn-data.xmlに定義されているポリシーは、approot/src/META-INF/jazn-data.xmlにアップグレードされます。ただし、ポリシーに定義されているユーザーおよびエンタープライズ・ロールはアップグレードされません。

図15-8は、アップグレード後のWebCenterアプリケーションのjazn-data.xmlのプロパティを示したものです。

図15-8 アップグレード後のWebCenterアプリケーションのセキュリティの設定

「図15-8 アップグレード後のWebCenterアプリケーションのセキュリティの設定」の説明

アップグレード後のWebCenterアプリケーションのADFセキュリティを再構成する手順は、次のとおりです。

- まだ存在していない場合、jazn-dataエディタで新しいレルムを作成します。次に、WebCenter 10.1.3.xアプリケーションのセキュリティ・ポリシーに存在していた必要なユーザーおよびエンタープライズ・ロールを再作成します。必要に応じて、新しく作成されたユーザーをエンタープライズ・ロールに割り当てます。レルムの名前はjazn.comにすることをお薦めします。
ユーザーおよび役割の作成は、JDeveloperの統合WebLogic Server (WLS)でアプリケーションをテストする場合にのみ必要です。通常、必要なユーザーおよびアプリケーション・ポリシーで使用されるエンタープライズ・ロールは、アプリケーションがデプロイされる本番設定に存在しています。

注意:

valid-usersロールは、すべての認証済ユーザーを指定し、通常はweblogic.xml内のusersロールにマップされますが、アップグレード後のアプリケーションのweb.xmlには作成されないため、すべての認証済ユーザーにアクセスを制限します。すべての認証済ユーザーがアップグレード後のアプリケーションにアクセスできるようにするには、web.xml内にvalid-usersロールを手動で作成し、weblogic.xml内のusersロールにマップする必要があります。

- オプションで、アプリケーション・ロールを使用するようにアプリケーション認可データを再構成できます。アプリケーション・ロールは、Oracle WebCenter Portal 11gアプリケーションでサポートされています。エンタープライズ・ロールではなくアプリケーション・ロールを使用するようにADFセキュリティを再構成できます。

ADFセキュリティの構成方法の詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

ADFセキュリティが適用されているWebCenterアプリケーションのアップグレード時の考慮事項: 10.1.3.xアプリケーションに権限のない権限付与が含まれている場合、権限付与は正しく移行されません。アプリケーションをアップグレードする前に、10.1.3ワークスペース内のapp-jazn-data.xmlファイルを調べて、空の権限セットを持つ権限付与を削除する必要があります。

Oracle WebCenter 10.1.3.xでは、ADFフレームワークは、ページ呼出しのチェック以外に、行セット、属性およびメソッド呼出しのチェックを実行していました。10.1.3 WebCenterアプリケーションが行セットおよび属性に対して読取り権限を付与し、すべてのユーザーのメソッドに対して起動権限を付与すると、アプリケーションは追加設定を行わなくてもOracle WebCenter Portal 11gで予想どおりに機能します。

ただし、10.1.3.x WebCenterアプリケーションが、特定のユーザーにのみ行セット、属性または起動メソッドの表示を許可するように設計されていた場合は、このセキュリティのスタイルをサポートするために、特別なフラグを設定する必要があります。このフラグが設定されていない場合は、ページ・アクセス権を持つすべてのユーザーが属性、行セットおよび起動メソッドを表示できます。これは、Oracle WebCenter Portal 11gでは、権限チェックはページおよびタスク・フローでのみ行われるためです。次の例に示すように、adf-config.xmlファイル内のアプリケーションごとにフラグを設定する必要があります。

<sec:adf-security-child xmlns="http://xmlns.oracle.com/adf/security/config">
<JaasSecurityContext
initialContextFactoryClass="oracle.adf.share.security.JAASInitialContextFactory"
jaasProviderClass="oracle.adf.share.security.providers.jps.JpsSecurityContext"
authorizationEnforce="true"/>
<contextEnv name="oracle.adf.security.metadata" value="false"/>
<CredentialStoreContext
credentialStoreClass=
"oracle.adf.share.security.providers.jps.CSFCredentialStore"
credentialStoreLocation="../../src/META-INF/jps-config.xml"/>
</sec:adf-security-child>

adf-config.xmlファイル内に重複するJaasSecurityContext要素およびCredentialStoreContext要素がないことも確認する必要があります。

15.3.3.5 事前構成済ポートレット・プロデューサのプロデューサ登録のアップグレード

アプリケーションのアップグレード中に、すべての事前構成済ポートレット・プロデューサのポート番号(Webクリッピング、OmniPortletなど)が更新されます。Oracle Application Server 10.1.3.x環境にある事前構成済ポートレット・プロデューサの登録で、ポート6688を使用しているプロデューサ登録はすべて、ポート7101に移行されます。Oracle Application Server 10.1.3.x環境でデフォルトのポート番号を使用していなかった場合は、これらのポート番号を手動で適切なポート番号に変更する必要があります。

事前構成済ポートレット・プロデューサ以外のポートレット・プロデューサ登録に対しては、WebCenterアプリケーションのアップグレード時にポート番号の変更は行われません。

15.3.3.6 アプリケーションの再デプロイ

アプリケーションをWebCenter Portal 11gにアップグレードした後は、アプリケーションを再コンパイルする必要があります。アプリケーションの再デプロイを準備するには、WebLogic管理対象サーバー・インスタンスを作成し、必要な一連の共有ライブラリをプロビジョニングします。また、WebLogicドメインの管理サーバー・インスタンス上にアプリケーションのメタデータ・サービス(MDS)リポジトリを作成して登録します。その後、アプリケーションを再デプロイし、正しくデプロイされたことを確認する必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための管理者ガイドのWebCenter Portal: Frameworkアプリケーションのデプロイに関する項を参照してください。

15.4 ポートレット・プロデューサのアップグレード

WebCenter 10.1.3.xアプリケーションでポートレットが使用されている場合は、WebCenterコンシューマ・プリケーションのアップグレードに加えて、ポートレット・プロデューサもOracle WebCenter Portal 11gにアップグレードすることが必要な場合があります。

表15-2は、WebCenter 10.1.3.xアプリケーションで使用しているポートレット・プロデューサのアップグレードに関連するタスクを示したものです。

表15-2 ポートレット・プロデューサのアップグレードのタスク・フロー

タスク

サブタスク

タスクの実行状況

アプリケーションの準備

WebCenterコンシューマ・アプリケーションとポートレット・プロデューサの互換性の判断

全状況

ポートレット・プロデューサ・アプリケーションのアップグレード

JDeveloperで作成されたポートレット・プロデューサのアップグレード

WebCenterアプリケーションにJDeveloper 10.1.3.xで開発されたポートレット・プロデューサによるポートレットが含まれている場合

JDeveloper以外で作成されたポートレット・プロデューサのアップグレード

WebCenterアプリケーションにJDeveloper以外で開発されたポートレット・プロデューサによるポートレットが含まれている場合

事前構成済ポートレット・プロデューサのアップグレード

WebCenterアプリケーションに事前構成済ポートレット・プロデューサによるポートレットが含まれている場合

アップグレード後タスクの実行

カスタマイズ内容の移行

WebCenterアプリケーションに事前構成済ポートレット・プロデューサによるポートレット以外のポートレットが含まれている場合

ポートレット・プロデューサ・アプリケーションの再デプロイ

全状況

15.4.1 WebCenterコンシューマ・アプリケーションとポートレット・プロデューサの互換性の判断

Oracle Application Server 10.1.3.xにデプロイされているWebCenterコンシューマ・アプリケーションまたはポートレット・プロデューサ・アプリケーションのほとんどは、Oracle Fusion Middleware 11gにアップグレードされたアプリケーションと互換性があります。たとえば、Oracle Fusion Middleware 11gのOracle WebLogic ServerにアップグレードおよびデプロイされたWebCenterコンシューマ・アプリケーションが、Oracle Application Server 10.1.3.xで実行されているPDK-Javaプロデューサ・アプリケーションからのポートレットを引き続き使用することも可能です。

Oracle Fusion Middleware 11gは、WebCenterコンシューマ・アプリケーションとポートレット・プロデューサ・アプリケーションの下位互換性をサポートしています。互換性のサポート状況に応じて、WebCenterコンシューマ・アプリケーションのみをアップグレードするのか、ポートレット・プロデューサ・アプリケーションのみをアップグレードするのか、それとも両方をアップグレードするのかを決定できます。表15-3は、WebCenterコンシューマ・アプリケーションとポートレット・プロデューサ・アプリケーションの様々なバージョン間の互換性を示したものです。

表15-3を見ると、WebCenter 10.1.3.xコンシューマ・アプリケーションとPDK-JavaまたはWSRP 1.0のWebCenter Portal 11gポートレット・プロデューサ・アプリケーションの組合せは互換性があることがわかります。このように下位互換性がサポートされている場合は、WebCenter 10.1.3.xコンシューマ・アプリケーションをWebCenter Portal 11gにアップグレードしないことも選択できます。この表を見ると、WebCenter Portal 11gコンシューマ・アプリケーションとPDK-JavaまたはWSRP 1.0のWebCenter 10.1.3.xポートレット・プロデューサ・アプリケーションの組合せも互換性があるということがわかります。この場合は、10.1.3.xポートレット・プロデューサ・アプリケーションをアップグレードしないことも選択できます。

ただし、WebCenter 10.1.3.xコンシューマ・アプリケーションはWSRP 2.0のWebCenter Portal 11gポートレット・プロデューサ・アプリケーションとは互換性がありません。同様に、WebCenter Portal 11gコンシューマ・アプリケーションはWSRP 2.0のWebCenter 10.1.3.xポートレット・プロデューサ・アプリケーションとは互換性がありません。このような場合は、アプリケーションの連携動作が可能になるように、すべての10.1.3.x WSRP 2.0アプリケーションをOracle Fusion Middleware 11gにアップグレードする必要があります。

表15-3 WebCenterコンシューマ・アプリケーションとポートレット・プロデューサ・アプリケーションの様々なバージョン間の互換性

WebCenterコンシューマ・アプリケーションのバージョン脚注1

ポートレット・プロデューサ・アプリケーションのバージョン

このアプリケーションの組合せがOracle Fusion Middleware 11gでサポートされるかどうか

10.1.3.x

PDK-Java 11g

はい

10.1.3.x

Oracle WebLogic Server 11gにデプロイされたWSRP 1.0

はい

10.1.3.x

Oracle WebLogic Server 11gにデプロイされたWSRP 2.0

いいえ

11g

PDK-Java 10.1.3.x

はい

11g

Oracle Application Server 10.1.3.xにデプロイされたWSRP 1.0

はい

11g

Oracle Application Server 10.1.3.xにデプロイされたWSRP 2.0

いいえ

脚注1 この列の11gとは、Oracle WebCenter 11.1.1.7.0にアップグレードされた、またはもともとOracle WebCenter Portal 11.1.1.6.0で作成されたWebCenterコンシューマ・アプリケーションを表します。

15.4.2 ポートレット・プロデューサ・アプリケーションのアップグレード

ポートレット・プロデューサ・アプリケーションをアップグレードするには、WebCenter 10.1.3.xアプリケーションで使用しているポートレット・プロデューサのタイプに応じて、様々なタスクの実行が必要な場合があります。この項ではそのようなタスクについて説明します。次のサブセクションがあります。

- JSR168ポートレット・プロデューサからJSR286へのアップグレードについて

- JDeveloperで作成されたポートレット・プロデューサのアップグレード

- JDeveloper以外で作成されたポートレット・プロデューサのアップグレード

- 事前構成済ポートレット・プロデューサのアップグレード

15.4.2.1 JSR168ポートレット・プロデューサからJSR286へのアップグレードについて

Oracle WebCenter 10gはJavaポートレット仕様、JSR 168に基づくJavaポートレットをサポートし、Oracle WebCenter Portal 11gはJavaポートレット仕様バージョン2またはJSR 286に基づくJavaポートレットをサポートします。JSR 286はJSR 168の拡張機能で、JSR 168と下位互換性があります。

Oracle WebCenter 10gでは、Oracle JSF Portlet BridgeはJSR 301がベースでこの規格に準拠していますが、Oracle WebCenter Portal 11gでは、Oracle JSF Portlet BridgeはJSR 329に準拠しています。

JDeveloper 11gでは、JSR 168ポートレットを含む既存のポートレット・プロデューサ・アプリケーションを最初に開くと、ポートレットは自動的にJSR 286準拠にアップグレードされます。このアプリケーションがポートレット・ブリッジ・アプリケーションの場合、それに加えてJSR 329準拠にアップグレードされます。

ほとんどの場合、アップグレードされたポートレットはアップグレード前とまったく同様に動作を続けます。しかし、JSR 286にアップグレードされたときのJSR 168ポートレットの機能が異なり、JSR286の下で実行するためにこれらのポートレットでJSR 168互換モードを起動することが必要な場合がいくつかあります。

詳細は、Oracle Fusion Middleware Portlet Oracle WebLogic Portal開発ガイドのJSR-286/JSR-168ポートレット互換性に関する項を参照してください。

Oracle WebCenter 10gにおいて、ポートレット・プロデューサ・アプリケーションにはportlet.xmlおよびoracle-portlet.xmlというファイルが含まれています。ポートレット・プロデューサ・アプリケーションをアップグレードすると、oracle.portlet.xmlファイルは削除され、その内容はportlet.xmlに移されます。oracle.portlet.xmlに格納されていたナビゲーション・パラメータはパブリック・レンダー・パラメータに変換されてportlet.xmlに追加されます。JSR 168パラメータがアップグレード後のJSR 286準拠ポートレット・プロデューサ・アプリケーションでどのように処理されるかの詳細は、第16.4項「JSR 168ポートレット・プロデューサのJSR 286への移行: ポートレット要素の処理」を参照してください。

15.4.2.2 JDeveloperで作成されたポートレット・プロデューサのアップグレード

WebCenter 10.1.3.xアプリケーションにポートレットが含まれており、そのアプリケーションがJDeveloperを使用して作成された場合は、ポートレット・プロデューサ・アプリケーションをOracle WebCenter Portal 11gで作成してポートレット・プロデューサをアップグレードする必要があります。また、新しく作成されたポートレット・プロデューサ・アプリケーションにWebCenter 10.1.3.xアプリケーションの「ポートレット」プロジェクトを手動で追加する必要もあります。

注意:

WebCenter 10gアプリケーションにポートレット・プロデューサが含まれていない場合、「ポートレット」プロジェクトは空ということになります。

JDeveloper 10.1.3.xで作成したポートレット・プロデューサ・アプリケーションをアップグレードする手順は、次のとおりです。

注意:

この手順を完了するには、WebCenter 10.1.3.xアプリケーションのPortletsディレクトリのコピーが必要です。

1. WebCenter Portal - ポートレット・プロデューサ・アプリケーション・テンプレートを使用して、JDeveloper 11gでポートレット・プロデューサ・アプリケーションを作成します。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための開発者ガイドのポートレット・プロデューサ・アプリケーションの作成に関する項を参照してください。

2. 新しく作成したポートレット・プロデューサ・アプリケーションで、「ポートレット」プロジェクトを選択します。

3. 「ファイル」メニューから「プロジェクトの削除」を選択します。

4. 「プロジェクトの削除の確認」ダイアログで、図15-9に示すように、「プロジェクトを削除してそのコンテンツをすべて削除します(ソース・ディレクトリを含む)ラジオ・ボタンを選択し、「はい」を選択します。

図15-9 「ポートレット」プロジェクトの削除

「図15-9 「ポートレット」プロジェクトの削除」の説明

5. 削除操作を確認するメッセージに対し、「はい」をクリックします。

6. アプリケーションを保存します。

7. ファイル・システムで、Portletsディレクトリを、WebCenter 10.1.3.xアプリケーションのバックアップ・コピーから、新しく作成したポートレット・プロデューサ・アプリケーションのルート・ディレクトリにコピーします。

8. JDeveloper 11gで、ポートレット・プロデューサ・アプリケーションのportlets.jprを開きます。
「ポートレット」プロジェクトをアップグレードするかどうか入力を要求されます。

9. 図15-10に示すように、「はい」をクリックして、10.1.3.xの「ポートレット」プロジェクトを11gのポートレット・プロデューサ・アプリケーションにアップグレードします。

図15-10 「ポートレット」プロジェクトのアップグレード

「図15-10 「ポートレット」プロジェクトのアップグレード」の説明

「ポートレット」プロジェクトのアップグレードが終了すると、portlets.jprが正常にアップグレードされたことを示すメッセージが「移行ステータス」ダイアログに表示されます。

10. 「OK」をクリックします。

15.4.2.3 JDeveloper以外で作成されたポートレット・プロデューサのアップグレード

WARファイルまたはEARファイル内のWARファイルとしてパッケージ化されたJSR 168 Javaポートレット・プロデューサ・アプリケーションまたはPDK-Javaポートレット・アプリケーションがある場合は、アプリケーションをOracle WebLogic Serverアプリケーション・ディスクリプタなどのOracle WebCenter Portal 11gに固有の要素で更新する必要があります。

次の各項では、PDK-JavaまたはJSR 168アプリケーション(EARまたはWARアーカイブ・ファイルの形式のアプリケーション)をOracle WebCenter Portal 11gにアップグレードする方法について説明します。

15.4.2.3.1 EARファイルからのJDeveloperアプリケーションの作成

EARファイル内のWARファイルとしてパッケージ化されたJSR 168ポートレット・アプリケーションまたはPDK-Javaポートレット・アプリケーションがある場合、そのEARをOracle WebCenter Portal 11gにアップグレードするには、まずアーカイブ・ファイルに基づいてJDeveloper 10.1.3.xアプリケーションを作成する必要があります。その後、アプリケーションをJDeveloper 11gで開くと、アプリケーションをアップグレードできます。

JDeveloper 10gでEARファイルからアプリケーションを作成し、そのアプリケーションをOracle WebCenter Portal 11gにアップグレードする手順は、次のとおりです。

1. JDeveloper 10.1.3.xを開きます。

注意:

アップグレードするEARファイルの準備にはJDeveloper 10.1.3.xを使用する必要があります。

2. 「ファイル」メニューから「新規」を選択します。

3. 「新規ギャラリ」ダイアログで「一般」を展開し、「アプリケーション」、続いて「EARファイルからのアプリケーション」を選択し、「OK」をクリックします。

4. 「EARファイルからのアプリケーション」を選択し、「OK」をクリックします。

5. EARファイルからのアプリケーション作成ウィザードの「ようこそ」ページで、「次へ」をクリックします。

6. 「場所」ページで、「EARファイル」フィールドにEARファイルへのパスを入力します。

7. 「ファイルをアプリケーションへコピー」チェック・ボックスを選択します。

8. 「終了」を選択し、アプリケーションをJDeveloperで作成します。

9. アプリケーションを保存します。

10. アプリケーションのバックアップ・コピーを保存します。

11. JDeveloper 11gを開きます。

12. EARファイルから作成したWebCenter 10.1.3.xアプリケーションを開きます。

13. JDeveloper 11gにアプリケーションをアップグレードする手順に従います。

14. アプリケーションを保存します。
これで、アプリケーションの再デプロイが可能になります。

15.4.2.3.2 WARファイルからのJDeveloperアプリケーションの作成

WARファイルとしてパッケージ化されたJSR 168またはPDK-JavaアプリケーションからJDeveloperファイルを作成する手順は、次のとおりです。

1. JDeveloper 10.1.3.xを開きます。

注意:

アップグレードするWARファイルの準備にはJDeveloper 10.1.3.xを使用する必要があります。

2. 「ファイル」メニューから「新規」を選択します。

3. 「新規ギャラリ」ダイアログで「一般」を展開し、「アプリケーション」、続いて「アプリケーション」を選択し、「OK」をクリックします。

4. アプリケーションの作成ウィザードで、「OK」をクリックします。

5. プロジェクトの作成ウィザードで、「取消」をクリックし、新しいプロジェクトがアプリケーションに作成されないようにします。

6. アプリケーション・ナビゲータで、新しく作成したアプリケーションを選択します。

7. 「ファイル」メニューから「新規」を選択します。

8. 「新規ギャラリ」で「一般」を展開し、「プロジェクト」、続いて「WARファイルからのプロジェクト」を選択し、「OK」をクリックします。

9. WARファイルからのプロジェクト作成ウィザードの「ようこそ」ページで、「次へ」をクリックします。

10. 「WARの場所」ページで、WARファイルへのパスを「WARファイル」フィールドで指定します。

11. 「終了」をクリックし、プロジェクトを作成します。

12. アプリケーションを保存します。

13. アプリケーションをバックアップします。

14. JDeveloper 11gを開きます。

15. WARファイルから作成したWebCenter 10.1.3.xアプリケーションを開きます。

16. JDeveloper 11gでアプリケーションをアップグレードする手順に従います。

17. アプリケーションを保存します。
これで、アプリケーションの再デプロイが可能になります。

15.4.2.4 事前構成済ポートレット・プロデューサのアップグレード

Oracle WebCenter Portal 11gには、様々な事前構成済ポートレット・プロデューサが用意されています。たとえば、OmniPortlet、Webクリッピング、WSRPパラメータ・フォーム・ポートレット、サンプルWSRPポートレット・プロデューサ、サンプルPDK-Javaポートレット・プロデューサなどです。

Oracle WebCenterではポートレットのカスタマイズが可能です。ユーザー・データおよびポートレットやプロデューサの設定などのプリファレンスをカスタマイズすることができます。カスタマイズ内容はデータベースまたはファイル・システム内に保存できます。事前構成済ポートレット・プロデューサに関連するカスタマイズ内容は、アプリケーション・プロジェクト内ではなく、これらのプロデューサのカスタマイズ内容の保存先に保存されます。デフォルトでは、事前構成されたポートレット・プロデューサのOracle WebCenter 10gのカスタマイズ内容は次の場所に保存されます。

10.1.3.x_jdev_install_dir/portal/portletdata

10.1.3.x_jdev_install_dirは、JDeveloper 10.1.3.xのインストール・ディレクトリを表します。

このため、構成済ポートレット・プロデューサによるポートレットが含まれているWebCenterアプリケーションのアップグレード時は、ポートレットのカスタマイズ内容も移行する必要があります。

15.4.2.4.1 デフォルトの場所からのカスタマイズ内容の移行

JDeveloper 11gのインストール後の最初の起動時に、以前のリリースの設定を移行するかどうかを尋ねるメッセージが表示されます。「はい」を選択すると、事前構成済ポートレット・プロデューサのポートレットのカスタマイズ内容は、他のJDeveloperシステム・プロパティとともに、以前のJDeveloperインストールからJDeveloper 11gに自動的に移行されます。ただし、ポートレットのカスタマイズ内容は、デフォルトの場所である10.1.3.x_jdev_install_dir/portal/portletdataからのみ移行されます。

ポートレットのカスタマイズ内容を移行しないと選択し、「いいえ」を選択した場合は、カスタマイズ内容を後で手動で移行する必要があります。手動の手順では、10.1.3.x_jdev_install_dir/portal/portletdataディレクトリを11g_jdev_install_dir/jdeveloper/portal/portletdataディレクトリにコピーします。

15.4.2.4.2 デフォルト以外の場所からのカスタマイズ内容の移行

ポートレットのカスタマイズ内容の保存先としては、デフォルトの場所である10.1.3.x_jdev_install_dir/portal/portletdata以外も選択できます。

デフォルト以外の場所からカスタマイズ内容を移行するには、次のいずれかのタスクを実行する必要があります。

- 新しい場所へのカスタマイズの移行: カスタマイズ内容の保存先のディレクトリを必要なパスにコピーし、カスタマイズ内容の保存先の新しい場所を指すようにアップグレード済ポートレット・プロデューサを構成します。カスタマイズ内容がデータベースに保存される場合は、そのデータベースにアクセスするようにアップグレード済ポートレット・プロデューサを構成します。

- 既存の場所からカスタマイズ内容を使用します。以前の場所からカスタマイズ内容の保存先にアクセスするようにアップグレード済ポートレット・プロデューサを構成します。

カスタマイズ内容をデフォルト以外の場所に保存する方法の詳細は、第16.3項「事前構成されたポートレット・プロデューサ: カスタマイズ内容の保存先」を参照してください。

15.4.3 ポートレット・プロデューサのアップグレード後タスクの実行

ポートレット・プロデューサのアップグレード後は、事前構成済ではないポートレット・プロデューサのカスタマイズ内容を移行し、ポートレット・プロデューサ・アプリケーションを再デプロイする必要があります。

15.4.3.1 カスタマイズ内容の移行

Oracle PDK-JavaおよびWSRPポートレット・プロデューサのアップグレード後に、カスタマイズ内容が共有されていない場合、またはアップグレード済ポートレット・プロデューサからカスタマイズ内容にアクセスできない場合は、そのカスタマイズ内容を移行する必要があります。このカスタマイズ内容は、事前構成済ポートレット・プロデューサ以外のポートレット・プロデューサのものです。

このようなカスタマイズ内容を移行するには、プリファレンス・ストア移行ユーティリティを使用できます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための開発者ガイドのポートレット・プリファレンス・ストア移行ユーティリティに関する項を参照してください。

15.4.3.2 ポートレット・プロデューサ・アプリケーションの再デプロイ

アップグレード済ポートレット・プロデューサ・アプリケーションは、Oracle WebLogic Serverの管理対象サーバーでOracle WebCenterポートレット・プロデューサをサポートする構成のサーバーであれば、どのサーバーにもデプロイできます。デプロイメントには、Oracle Enterprise Manager Fusion Middleware Control、Oracle WebLogic Server管理コンソールまたはOracle WebLogic Scripting Tool(WLST)を使用できます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための管理者ガイドのポートレット・プロデューサ・アプリケーションのデプロイに関する項を参照してください。

WebLogicサーバーへのアクセスに必要な資格証明がある場合は、JDeveloperを使用して、ポートレット・プロデューサ・アプリケーションを開発環境から直接Oracle WebLogic Serverインスタンスにデプロイすることも可能です。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための管理者ガイドのOracle WebLogic管理対象サーバー・インスタンスへのポートレット・プロデューサ・アプリケーションのデプロイに関する項を参照してください。

15.5 データの移行

WebCenter 10gアプリケーションにバックエンド・コンポーネントに依存するWebCenterサービスが含まれている場合、バックエンド・コンポーネントのアップグレードを準備してからデータを移行することが必要となる場合があります。この項では、WebCenter 10gデータを必要なサーバーに移行する方法を説明します。次のサブセクションがあります。

- 第15.5.1項「Oracle WebCenter Wiki and Blog Serverからのデータの移行」

- 第15.5.2項「Oracle Content DBのからのデータの移行」

15.5.1 Oracle WebCenter Wiki and Blog Serverからのデータの移行

注意:

WebCenter 10g環境にOracle WebCenter Wiki and Blog Serverがインストールされていない場合は、この項は省略してください。

WebCenter 10gアプリケーションでは、Wikiおよびブログ機能がWikiサービスおよびBlogサービスによって実現されます。そのため、Oracle WebCenter 10gはWikiおよびブログ機能を実現するのにOracle WebCenter Wiki and Blog Serverに依存しています。Oracle WebCenter Portal 11gでは、Wikiおよびブログ機能はDocumentsサービスによって実現されており、この機能実現のためにコンテンツ・リポジトリとしてContent Server 11gを必要とします。

WikiサービスおよびBlogサービスを含むWebCenter 10.1.3.xアプリケーションをアップグレードする際は、Oracle WebCenter Wiki and Blog ServerからOracle WebCenter Content Server 11gへとデータを移行する必要もあります。中間層のアップグレード後であればいつでも、Wikiおよびブログのデータを移行できます。

Oracle WebCenter Wiki and Blog ServerからOracle WebCenter Content Server 11gへとWikiおよびブログのデータを移行する方法の詳細は、『Oracle Fusion Middlewareパッチ適用ガイド』のOracle Wikiページおよびブログの移行に関する項を参照してください。

15.5.2 Oracle Content DBからのデータの移行

WebCenter 10gアプリケーションがOracle Content DBに依存している場合、Oracle Content Serverバージョン10.1.3.5.1または11gをコンテンツ・リポジトリとして使用する必要があります。中間層のアップグレード後であればいつでもContent DBデータを移行できます。

WebDavクライアントを使用してOracle Content DBデータをOracle Content Server 10.1.3.5.1に移行する手順は、次のとおりです。

1. 関連するすべてのコンテンツにアクセスできるユーザー・アカウントを使用して、WebDAVの次の場所を開きます。

- Oracle Content DBの場合: http://server:host/content/dav

- Oracle Content Serverの場合: http://server:host/content-server-root/idcplg/webdav

2. コンテンツをOracle Content DBの場所からOracle Content Serverの場所にコピーします。

WebDavを使用してコンテンツを移行する場合は、次の点に注意してください。

- ごみ箱フォルダがコピーされます。

- バージョニング済のドキュメントでは、最新バージョンのみがコピーされます。

- メタデータおよびアクセス制御設定は、コピーされたコンテンツでは保持されません。

注意:

Oracle Content DBからOracle WebCenter Content Server 11gへと直接データを移行することはできません。Oracle WebCenter Content Server 11gをコンテンツ・リポジトリとして使用する場合、まずContent DBデータをOracle Content Server 10.1.3.5.1に移行し、次にOracle WebCenter Content Server 11gにアップグレードする必要があります。Oracle Content Server 10gから11gへのアップグレードの詳細は、Oracle Fusion Middleware Oracle WebCenter Contentアップグレード・ガイドを参照してください。

16 その他のOracle WebCenterアップグレードの詳細

この章では、アプリケーションのアップグレード中にOracle JDeveloper 11gのアップグレード・ユーティリティによりWebCenter 10.1.3.xアプリケーションに自動的に加えられる変更について説明します。また、事前構成したポートレット・プロデューサのカスタマイズ内容の保存先を変更する方法についても説明します。

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

- アップグレード後のWebCenterアプリケーションの自動変更

- コンテンツ統合接続: 外部アプリケーションへの資格証明の移行

- 事前構成されたポートレット・プロデューサ: カスタマイズ内容の保存先

- JSR 168ポートレット・プロデューサのJSR 286への移行: ポートレット要素の処理

注意:

この章では、該当する箇所で最近商標変更されたOracle WebCenter Portal製品名を使用しています。詳細は、第3.3.1項「Oracle WebCenterおよびOracle Enterprise Content Management Suiteの新規製品名」を参照してください。

16.1 アップグレード後のWebCenterアプリケーションの自動変更

WebCenter 10.1.3.xアプリケーションをOracle WebCenter Portal 11gにアップグレードするには、JDeveloper 11gを使用します。アプリケーションのアップグレード中は、JDeveloper 11gのアップグレード・ユーティリティにより、カスタマイズ可能なコンポーネント、外部アプリケーションおよびポートレット・コンポーネントなどに関連する変更が自動的に加えられます。

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

- カスタマイズ可能コンポーネントの変更

- 外部アプリケーションの変更

- ポートレット・コンポーネントの変更

16.1.1 カスタマイズ可能コンポーネントの変更

WebCenterアプリケーションでは、ユーザーが実行時にカスタマイズできるコンポーネントをOracle Composerを使用してページに追加できます。Oracle Composerでは、Panel CustomizableやShow Detail Frameなど、ページのパーソナライズとカスタマイズのためのコンポーネントをアプリケーションに追加できます。

カスタマイズ可能コンポーネントが使用されているWebCenter 10.1.3.xアプリケーションのアップグレード中、JDeveloperでは、Oracle WebLogic Server上で稼働するアプリケーションを準備する、カスタマイズ可能コンポーネントに関連する様々な変更が自動的に加えられます。次のような変更が加えられます。

- 一般的な変更

- Panel Customizableの変更

- Show Detail Frame

16.1.1.1 一般的な変更

WebCenterアプリケーションをアップグレードする際、JDeveloperでは、アプリケーションに次のような一般的な変更が加えられます。

- JSPXファイルのカスタマイズ可能コンポーネントのネームスペースの名前が変更されます。
変更前: http://xmlns.oracle.com/adf/faces/customizable

変更後:

http://xmlns.oracle.com/adf/faces/customizable/html

- web.xmlから次のエントリが削除されます。

- コンテキスト・パラメータoracle.mds.web-app-root

- フィルタmdsFilter

- mdsFilterのフィルタ・マッピング

- サーブレットjsp2、jsp2のサーブレット・マッピングおよびリソース・プロキシ

- Javaカスタマイズ可能コンポーネント・ライブラリが削除され、WebCenterカスタマイズ可能コンポーネント・ライブラリが追加されます。

- 古いカスタマイズ可能コンポーネント・タグ・ライブラリが削除され、新しいバージョンのカスタマイズ可能コンポーネント(HTML)が追加されます。

- Javaファイルにインポート文および宣言がある場合、Panel Customizableのクラス名がoracle.adf.view.html.component.customizable.PanelCustomizableに変更されます。

- Javaファイルにインポート文および宣言がある場合、Show Detail Frameのクラス名がoracle.adf.view.html.component.customizable.ShowDetailFrameに変更されます。

16.1.1.2 Panel Customizableの変更

Panel Customizableコンポーネントは、実行時にカスタマイズできるOracle ADFコンポーネント、タスク・フローおよびポートレットのグループを格納するためのコンテナです。WebCenterアプリケーションをアップグレードするときに、Oracle WebCenter Portal 11gでサポートされていない様々なPanel Customizable属性がJDeveloperによって削除されます。表16-1は、アップグレード後のWebCenterアプリケーションで変更されるPanel Customizable属性を示しています。

表16-1 アップグレード後のWebCenterアプリケーションで変更されるPanel Customizable属性

属性

アップグレード後のWebCenterアプリケーションでの属性の使用可能性

DisplayHeader

ExpansionMode

Text

Icon

IsSeededInteractionAvailable

IsMinimizable

IsMaximizable

IsMovable

IsShowContentEnabled

ContentInlineStyle

DisclosureListener

Background

isEditable

isHelpAvailable

削除されます。

これらの属性はすべて、アップグレード後のWebCenterアプリケーションから削除されます。Panel Customizableのヘッダーはサポートされなくなりました。このため、DisplayHeader、およびExpansionMode、Textなどの使用可能なヘッダーに依存するその他の属性も削除されます。

DisplayScrollBar

削除されます。

ただし、Panel Customizableのコンテンツ領域にスクロール・バーを表示するには、ScrollにLayout属性を設定します。

Width

Height

非推奨。

Width属性およびHeight属性の使用は推奨されていません。Panel Customizableの幅と高さを指定するには、inlineStyle属性を使用することをお薦めします。たとえば、inlineStyle="width:300px;height:500px;"と設定します。

例16-1は、WebCenter 10.1.3.xアプリケーションのソース・ビューに表示されたPanel Customizableのサンプル・コードです。

例16-1 WebCenter 10.1.3.xアプリケーションのPanel Customizableのコード

<cust:panelCustomizable id="panelCustomizable1"
text="panelCustomizable 1"
displayHeader="true"
isMaximizable="true"
isMinimizable="true"
width="100%"
height="50px">
displayScrollBar="auto"
isShowContentEnabled="true"/>

例16-2は、WebCenter 10.1.3.xアプリケーションがOracle WebCenter Portal 11gにアップグレードされた後のPanel Customizableのサンプル・コードです。isMinimizableやdisplayHeaderなどの属性がPanel Customizableコードから削除されています。

例16-2 WebCenter Portal 11gアプリケーションのPanel Customizableのコード

<cust:panelCustomizable id="panelCustomizable1"
xmlns="http://xmlns.oracle.com/adf/faces/customizable/html"/>

16.1.1.3 Show Detail Frame

Show Detail Frameコンポーネントは、WebCenterアプリケーション・ページ上の子コンポーネントの周囲に境界線またはクロムを表示します。「アクション」メニューのあるヘッダーが作成され、そこに含まれるユーザー・インタフェース(UI)コントロールを使用して子コンポーネントの表示をカスタマイズできるようになります。表16-2は、WebCenterアプリケーションをアップグレードしたときに、JDeveloperによってShow Detail Frameコンポーネントの属性に加えられる変更を示したものです。

表16-2 アップグレード後のWebCenterアプリケーションのShow Detail Frameの属性に加えられる変更

属性

説明

isMaximizable

この属性はアップグレード後のアプリケーションから削除されます。

isSeededInteractionAvailable

IsSeededInteractionAvailable=trueは次のように移行されます。

- showMoveAction=menu

- showMinimizeAction=chrome

- showRemoveAction=chrome

IsSeededInteractionAvailable=falseは次のように移行されます。

- showMoveAction=none

- showMinimizeAction=none

- showRemoveAction=none

isMovable

この属性は、名前がshowMoveActionに変更されます。isMovable=None|Menuはそれぞれ、showMoveAction=none|menuに変更されます。

isMinimizable

この属性は、名前がshowMinimizeActionに変更されます。isMinimizable=false|trueはそれぞれ、showMinimizeAction=none|chromeに変更されます。

expansionMode

expansionMode=maximizedの場合、移行後のアプリケーションからこの属性は削除されます。値がnormalまたはminimizedの場合、属性は維持されます。

ContentInlineStyle

この属性は、名前がInlineStyleに変更されます。

例16-3は、WebCenter 10.1.3.xアプリケーション・ページのソース・ビューに表示されたShow Detail Frameのサンプル・コードです。例16-4は、このアプリケーションがOracle WebCenter Portal 11gにアップグレードされた後の、Show Detail Frameのサンプル・コードです。isMaximizableが削除され、isSeededInteractionAvailable、isMinimizable、isMovableおよびContentInlineStyle属性の名前が変更されています。

例16-3 WebCenter 10.1.3.xアプリケーションのShow Detail Frameのコード

<cust:showDetailFrame id="showDetailFrame1"
text="showDetailFrame 1"
isSeededInteractionAvailable="false"
isMaximizable="false"
isMinimizable="true"
isMovable="true">
contentInlineStyle="background-color:rgb(0,255,255)"/>

例16-4 WebCenter Portal 11gアプリケーションのShow Detail Frameのコード

<cust:showDetailFrame id="showDetailFrame1"
text="showDetailFrame 1"
displayActions="never"
showMoveAction="none"
showMinimizeAction="none"
contentStyle="background-color:rgb(0,255,255)"
xmlns="http://xmlns.oracle.com/adf/faces/customizable/html"/>

16.1.2 外部アプリケーションの変更

外部アプリケーションは、ポートレット・プロデューサに関連付けることができます。外部アプリケーションは独自の認証プロセスを実装したアプリケーションです。つまり、外部アプリケーションはOracle WebCenterアプリケーションのシングル・サインオン・プロセスには含まれません。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための管理者ガイドの外部アプリケーションを使用した作業に関する項を参照してください。

この項には次のサブセクションがあります。

- Oracle Application Server 10gとOracle Fusion Middleware 11g間の外部アプリケーションの変更の概要

- 外部アプリケーションのアップグレードに関する変更

16.1.2.1 Oracle Application Server 10gとOracle Fusion Middleware 11g間の外部アプリケーションの変更の概要

Oracle Application Server 10gと比較してみると、Oracle Fusion Middleware 11gへの移行で外部アプリケーションの一部が変更されることがわかります。Oracle Fusion Middleware 11gでは、外部アプリケーションで共有資格証明とパブリック資格証明の指定が必要になります。外部アプリケーションでは、内部名(外部アプリケーションの識別子で、作成後の変更不可)と表示名(変更可能)の定義も必要になります。別の識別に関する機能として、Oracle Application Server 10gの外部アプリケーションではメタデータ・サービス(MDS)を使用してメタデータを格納していましたが、Oracle Fusion Middleware 11gでは、コンテンツ・リポジトリ接続などのサービスに類似した接続として外部アプリケーションが格納されます。

表16-3は、Oracle Application Server 10.1.3.xとOracle Fusion Middleware 11gの外部アプリケーションの識別関連の属性を比較したものです。この表の、name、ExtAppIdおよびGUIDの属性の値はサンプルの値です。

表16-3 Oracle Application Server 10.1.3.xおよびOracle Fusion Middleware 11gの外部アプリケーションの識別関連の属性

外部アプリケーションの属性

Oracle Application Server 10.1.3.xのサンプル属性値

Oracle Fusion Middleware 11gのサンプル属性値

Name

app1

app1(外部アプリケーションの表示名としても使用される)

extAppId

/oracle/adf/externalApps/extApp9213895574200898560.xml

app1

SharedCredEnabled

サポートされていない属性

False

PublicCredEnabled

サポートされていない属性

False

loginEnabled

サポートされていない属性

True

GUID

サポートされていない属性

ExtAppbc638395-2860-41ae-a9ff-edfc6b79110f

16.1.2.2 外部アプリケーションのアップグレードに関する変更

WebCenter 10.1.3.xアプリケーションが外部アプリケーションに依存している場合、そのアプリケーションのアップグレード時に、関連する外部アプリケーションも自動的にアップグレードされます。たとえば、外部アプリケーションに依存するPDK-Javaプロデューサを使用したWebCenter 10.1.3.xアプリケーションをアップグレードすると、その外部アプリケーションも自動的にアップグレードされます。WebCenterアプリケーションのアップグレード中、アップグレード・ユーティリティによって、外部アプリケーションに対して次のタスクが実行されます。

- 10.1.3.xの外部アプリケーションの名前が、アップグレード後のアプリケーションの内部名(ExtAppId)として使用されます。

- プロデューサのメタデータが新しい外部アプリケーションIDで更新されます。ポートレット・プロデューサのメタデータ内では、新しいIDで外部アプリケーションが参照されます。

- 外部アプリケーションのメタデータが、WebCenterアプリケーションのadf-config.xmlで設定されているMDSストアからconnections.xmlに移行されます。

- 外部アプリケーション・ポートレットを含むプロジェクトに、自動ログイン構成が追加されます。

- 表16-3に記載された新しい属性が、アップグレード後の外部アプリケーションに追加されます。

- 外部アプリケーション・ポートレットを含むプロジェクトに設定されている資格証明プロビジョニング・ページと、各プロジェクトに定義されているマネージドBeanおよびナビゲーション・ルールが削除されます。Oracle Fusion Middleware 11gでは、資格証明プロビジョニング・ページが外部アプリケーション・ライブラリにパッケージ化されます。

- 外部アプリケーション・ライブラリを設定します(WebCenter外部アプリケーション・サービスとWebCenter外部アプリケーション・サービス・ビュー)。

16.1.3 ポートレット・コンポーネントの変更

ポートレットを使用するWebCenterアプリケーションをアップグレードする際、JDeveloperではアップグレード後のアプリケーション内で、ポートレット・タグに関連する様々な変更が自動的に加えられます。

16.1.3.1 ポートレット・タグの変更

WebCenter 10.1.3.xアプリケーションでは、adfp:portletタグはhttp://xmlns.oracle.com/adf/faces/portletネームスペース内のポートレットを示します。

WebCenter Portal 11gアプリケーションでは、ポートレット・タグはTrinidad HTMLポートレット・タグに変換されます。adfp:portletポートレット・タグはhttp://xmlns.oracle.com/adf/faces/portlet/htmlネームスペースのadfph:portletに移行されます。

16.1.3.2 属性変更

表16-4は、ポートレットを含むアップグレード後のWebCenterアプリケーションで名前を変更、または削除される属性を示したものです。

表16-4 ポートレットを含むアップグレード後のWebCenterアプリケーションでの属性変更

属性

アップグレード後のアプリケーションの変更

isSeededInteractionAvailable

この属性は、名前がdisplayActionsに変更されます。isSeededInteractionAvailable=false|trueはそれぞれ、displayActions=onHover|alwaysに変更されます。

isMinimizable

この属性は、名前がshowMinimizeActionに変更されます。isMinimizable=false|trueはそれぞれ、showMinimizeAction=none|chromeに変更されます。

isMaximizable

この属性は、名前がshowMaximizeActionに変更されます。この変更は、HTMLポートレットにのみ適用されます。リッチ・テキスト・ポートレットには使用できません。isMaximizable=false|trueはそれぞれ、showMaximizeAction=none|chromeに変更されます。

isMovable

この属性は、名前がshowMoveActionに変更されます。isMovable=False|Trueはそれぞれ、showMoveAction=none|menuに変更されます。

contentInlineStyle

この属性は、名前がInlineStyleに変更されます。

text

この属性は、名前がtitleに変更されます。

portletType

この属性は削除されます。

isLinkModeAvailable

この属性は削除されます。

showRemoveAction

この属性はHTMLポートレットから削除されます。Oracle WebCenter Portal 11gでは、この属性はリッチ・テキスト・ポートレットにのみ適用できます。

expansionMode

JDeveloper 11gでは、この属性に使用できる値はnormalおよびminimizedです。WebCenter 10.1.3.xアプリケーションでは、この値がmaximizedに設定されると、属性がアップグレード後のアプリケーションから削除されます。

16.2 コンテンツ統合接続: 外部アプリケーションへの資格証明の移行

Oracle WebCenterのコンテンツ統合機能では、Oracle Content Server、Oracle Portal、ファイル・システムなどの各種のコンテンツ・リポジトリに分散するコンテンツを、WebCenterアプリケーションに統合できます。この項では、Oracle WebCenter 10.1.3.xおよびOracle WebCenter Portal 11gアプリケーションでサポートされている認証方法について説明します。また、WebCenter 10.1.3.xアプリケーションをアップグレードする際の、コンテンツ・リポジトリ接続に使用する外部アプリケーションへの資格証明の移行方法についても説明します。

コンテンツ・リポジトリのコンテンツをWebCenterアプリケーションに統合するときには、そのリポジトリへの接続を作成する必要があります。Oracle WebCenter Portal 11gでは、コンテンツ・リポジトリ接続を作成するときに、認証方法を次のいずれかに設定できます。

- アイデンティティ伝播: この方法では、コンテンツ・リポジトリに資格証明が渡されません。そのかわりに、Javaのセキュリティ・コンテキストによる現在のユーザーのアイデンティティが、リポジトリ接続に使用されます。通常この方法は、アプリケーションとコンテンツ・リポジトリが同じアイデンティティ・ストアを使用してユーザーを認証する場合に使用されます。

- 外部アプリケーション: 現在のユーザーのアイデンティティをコンテンツ・リポジトリに直接伝播する必要がない場合は、この方法を使用できます。

Oracle WebCenter 10.1.3.xでは、コンテンツ・リポジトリ接続の認証方法はJAASセキュリティに指定された設定で決定します。ユーザーのアイデンティティをリポジトリに転送し、資格証明を渡さずにWebCenterアプリケーションとコンテンツ・リポジトリ間の信頼関係を利用することを選択する場合は、「セキュリティにJAASを使用」チェック・ボックスを選択します。JAASセキュリティを使用しない場合、資格証明を指定して、このチェック・ボックスの選択を解除する必要があります。

図16-1は、JAASセキュリティを使用しないWebCenter 10.1.3.xアプリケーションのコンテンツ・リポジトリ接続の詳細を示しています。図16-1では、「セキュリティにJAASを使用」チェック・ボックスの選択が解除されており、「ユーザー名」と「パスワード」フィールドで資格証明が指定されています。

図16-1 WebCenter 10.1.3.xアプリケーションの認証方法

「図16-1 WebCenter 10.1.3.xアプリケーションの認証方法」の説明

JAASセキュリティを使用しているWebCenter 10.1.3.xアプリケーション(「セキュリティにJAASを使用」チェック・ボックスが選択されている)をアップグレードすると、アップグレード後のアプリケーションの接続の認証方法として、「アイデンティティ伝播」が自動的に設定されます。(「セキュリティにJAASを使用」機能は「アイデンティティ伝播」と同じものです。)

「セキュリティにJAASを使用」チェック・ボックスが選択されていないWebCenter 10.1.3.xアプリケーションの場合、アプリケーションのアップグレード時に認証方法として「外部アプリケーション」が設定されます。さらに、10.1.3.xのコンテンツ・リポジトリ接続で使用されていた資格証明を使用して、パブリック資格証明を持つ新しい外部アプリケーションが自動的に作成されます。図16-2は、アップグレード後のアプリケーションのコンテンツ・リポジトリ接続の詳細を示しています。認証方法として「外部アプリケーション」が選択されていて、アップグレード後のアプリケーションに新しい外部アプリケーションが作成されています。図16-3は、新しく作成された外部アプリケーションにパブリック資格証明が自動的に指定されているところを示しています。

図16-2 アップグレード後のアプリケーションのコンテンツ・リポジトリ接続の構成

「図16-2 アップグレード後のアプリケーションのコンテンツ・リポジトリ接続の構成」の説明

図16-3 外部アプリケーションに指定されたパブリック資格証明

「図16-3 外部アプリケーションに指定されたパブリック資格証明」の説明

注意:

アプリケーションに資格証明を使用するコンテンツ・リポジトリ接続があり、アップグレード中に資格証明ストアからの資格証明の取得、または外部アプリケーションの作成に問題がある場合は、アップグレード後のコンテンツ・リポジトリ接続を編集する必要があります。コンテンツ・リポジトリ接続の編集ウィザードでは、認証方法として「外部アプリケーション」を選択し、必要な資格証明で外部アプリケーションを作成する必要があります。

16.3 事前構成されたポートレット・プロデューサ: カスタマイズ内容の保存先

デフォルトでは、事前構成されたポートレット・プロデューサに関連するカスタマイズ内容はOracle WebCenter Portal 11g内の次の場所に保存されます。

11g_jdev_install_dir/jdeveloper/portal/portletdata

別の場所にポートレットのカスタマイズ内容を保存することもできます。この項では、事前構成した様々なポートレット・プロデューサのカスタマイズ内容の保存先を変更する方法について説明します。次のサブセクションがあります。

- WSRPポートレット・プロデューサ

- Webクリッピング・ポートレット・プロデューサ

- OmniPortletおよびその他のPDK-Javaポートレット・プロデューサ

- OmniPortletリポジトリの変更

16.3.1 WSRPポートレット・プロデューサ

WSRPポートレット・プロデューサのポートレットのカスタマイズ内容の保存先としてファイルのプリファレンス・ストアを指定するには、次のエントリを使用してプロデューサのWEB-INF/web.xmlを更新します。

<env-entry>
<env-entry-name>oracle/portal/wsrp/server/fileStoreRoot</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>{YOUR_PORTLET_DATA_PATH}</env-entry-value>
</env-entry>

YOUR_PORTLET_DATA_PATHは、ポートレットのカスタマイズ内容の保存先のパスです。

WSRPポートレット・プロデューサでデータベースのプリファレンス・ストアを使用する場合は、データベースのプリファレンス・ストアを設定する必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための開発者ガイドのプリファレンス・ストアの設定に関する項を参照してください。

16.3.2 Webクリッピング・ポートレット・プロデューサ

Webクリッピング・カスタマイズ内容の保存先を指定するには、mds-config.xmlで次のエントリを更新します。

<property name="metadata-path" value="{YOUR_PORTLET_DATA_PATH}"/>

Webクリッピング・ポートレット構成の詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための開発者ガイドのWebクリッピング・ポートレット構成のヒントに関する項を参照してください。

16.3.3 OmniPortletおよびその他のPDK-Javaポートレット・プロデューサ

OmniPortletについては、provider.xmlにカスタマイズ内容の保存先を指定します。ファイルはFusion Middleware 11gインストールの次の場所にあります。

MW_HOME/user_projects/domains/wc_domain/servers/WLS_Portlet/tmp/_WL_user/portalTools_11.1.1.2.0/RANDOMLY_GENERATED_DIRECTORY/war/WEB-INF/providers/omniPortlet/provider.xml

ヒント:

OmniPorletのprovider.xmlを検索するには、Oracle WebLogic Serverのインストール・ディレクトリでomniPortlet/provider.xmlを検索します。

OmniPortletポートレット・プロデューサのポートレットのカスタマイズ内容の保存先としてファイルのプリファレンス・ストアを指定するには、provider.xmlの次のエントリを更新します。

<preferenceStore class="oracle.webdb.reformlet.ReformletFilePreferenceStore">
<name>omniPortletprefStore</name>
<useHashing>true</useHashing>
<rootDirectory>{YOUR_PORTLET_DATA_PATH}</env-entry-value</rootDirectory>
</preferenceStore>

その他のPDK-Javaポートレット・プロデューサについても、ファイル・プリファレンスの保存先を同様に変更できます。

OmniPortletおよびその他のPDK-Javaポートレット・プロデューサにデータベースのプリファレンス・ストアを使用する場合は、データベースのプリファレンス・ストアを設定する必要があります。詳細は、Oracle Fusion Middleware Oracle WebCenter Portalのための開発者ガイドのプリファレンス・ストアの設定に関する項を参照してください。

16.3.4 OmniPortletリポジトリの変更

Oracle WebCenter Portal 11gでは、OmniPortletの接続詳細はOracle Platform Security Service(OPSS)資格証明ストアに格納されます。以前のバージョンのOracle WebCenterでは、OmniPortletの接続詳細はWebクリッピング・リポジトリに格納されます。OmniPortletを含むOracle WebCenterアプリケーションをアップグレードし、アップグレード後に初めてOmniPortletを実行すると、OmniPortletの接続詳細がWebクリッピング・リポジトリから自動的に移行されます。OmniPortletを初めて実行する場合は、OmniPortletテスト・ページにアクセスするか、アプリケーション・ページにOmniPortletインスタンスを表示します。アップグレード・プロセスはOracle WebLogic Serverのログ・ファイルに記録されます。アプリケーションのアップグレード後、OmniPorletのprovider.xmlでは、vaultIdタグが接頭辞MIGRATED_FROM_VAULT_ID_old_vault_idでマークされます。

アプリケーションのアップグレード中にエラーが発生した場合、アップグレード手順の再実行が必要になる可能性があります。たとえば、Webクリッピング・リポジトリが使用できないためにアプリケーションのアップグレードに失敗した場合、データベースが稼働していることを確認してから、アプリケーションを再びアップグレードする必要があります。

OmniPortletを含むアプリケーションのアップグレード手順を再実行する手順は、次のとおりです。

1. OmniPorletのprovider.xmlから、MIGRATED_FROM_VAULT_ID_old_vault_id接頭辞を削除します。

2. OmniPortletプロデューサを再起動します。

3. 次のURL書式を使用しOmniPortletテスト・ページにアクセスします。

http://host:port/portalTools/omniPortlet/providers/omniPortlet

hostおよびportは、Oracle WebCenterをインストールしたシステムのホスト名およびポート番号を表します。

16.4 JSR 168ポートレット・プロデューサのJSR 286への移行: ポートレット要素の処理

JDeveloper 11gでは、JSR 168ポートレットが含まれる既存のポートレット・プロデューサ・アプリケーションを初めて開く場合、ポートレットはJSR 286に準拠するよう自動的にアップグレードされます。

10gポートレット・プロデューサ・アプリケーションにアップグレードすると、WebCenterマイグレータによってoracle-portlet.xmlが削除され、portlet.xmlにアップグレードされます。oracle-portlet.xmlに格納されているナビゲーション・パラメータがパブリック・レンダラ・パラメータに変換され、portlet.xmlに追加されます。weblogic-portlet.xmlが存在する場合は、そのまま保持されます。

JSR 168ポートレット・プロデューサ・アプリケーションのJSR 286への移行は完全に自動化され、追加の手順を手動で実行する必要はありません。ただし、移行中にログ・パネルに表示される警告に基づいて、ポートレットに変更を加える場合があります。次の表は、JSR 168ポートレット・プロデューサ・アプリケーションのoracle-portlet.xmlファイルの様々なパラメータが、JSR 286ポートレット・プロデューサ・アプリケーションのportlet.xmlで処理される方法を示しています。

- 表16-5: portlet-app-extension要素の処理を示します

- 表16-6: portlet-extension要素の処理を示します

- 表16-7: navigation-parameters要素の処理を示します

表16-5 ポートレット・プロデューサ・アップグレード中のoracle-portlet.xmlのportlet-app-extension要素の処理

portlet-app-extension要素

XML型

JSR286準拠アップグレード済アプリケーションのportlet.xmlの要素の処理

<export-size-limit>

int

無視されます。

<allow-export>

boolean

同じブール値を持つポートレット・アプリケーション・レベルのcom.oracle.portlet.allowWsrpExportコンテナ実行時オプション(CRO)に変換されます。

<allow-import>

boolean

無視されます。

<allow-copy-portlets>

boolean

無視されます。

<export-encryption-data>

complexType

無視されます。

<use-jazn-security>

complexType

無視されます。

<strict-authentication>

boolean

反対のブール値を持つ次のポートレット・アプリケーション・レベルのCROに変換されます。

com.oracle.portlet.useWsrpUserContextForUserAuthenticationInfo

この要素がoracle-portlet.xmlには存在しないがoracle-portlet.xmlは存在し、portlet.xmlスキーマのバージョンが1.0の場合、次のポートレット・アプリケーション・レベルのCROが値trueを使用して作成されます。

com.oracle.portlet.useWsrpUserContextForUserAuthenticationInfo

表16-6 oracle-portlet.xmlのportlet-extension要素の処理

portlet-extension要素

XML型

JSR286準拠アップグレード済アプリケーションのportlet.xmlの要素の処理

<portlet-name>

string

oracle-portlet.xmlのportlet-extensionエントリをportlet.xmlの適切なポートレット・エントリへ関連付けるために使用されます。

<published-events>

complexType

無視されます。

<handled-events>

complexType

無視されます。

<navigation-parameters>

complexType

各navigation-parameters要素は、JSR286パブリック・レンダラ・パラメータに変換されます。

<portlet-id>

string

値"E:i" + portlet-id値 + ":default"を持つポートレット・レベルのcom.oracle.portlet.wsrpPortletHandle CROに変換されます。

パラメータが存在しない場合、ポートレット・レベルのcom.oracle.portlet.wsrpPortletHandleコンテナ実行時オプションは、値"E:n" + portlet-name (portlet.xmlから) + ":default"を使用して作成されます。

<allow-export>

boolean

無視されます。

<allow-import>

boolean

無視されます。

<hide-portlet>

boolean

反対のブール値を持つポートレット・レベルのcom.oracle.portlet.offerPortletOverWsrp CROに変換されます。

<require-iframe>

boolean

同じブール値を持つポートレット・レベルのcom.oracle.portlet.requireIFrame CROに変換されます。

<minimum-wsrp-version>

int

同じ整数値を持つポートレット・レベルのcom.oracle.portlet.minimumWsrpVersion CROに変換されます。

表16-7は、ポートレット・プロデューサ・アプリケーションのアップグレード時における、portlet.xmlファイル内のoracle-portlet.xmlのナビゲーション・パラメータの処理を示しています。JSR 168ポートレット・プロデューサ・アプリケーションをアップグレードする場合、oracle-portlet.xmlのナビゲーション・パラメータをパブリック・レンダラ・パラメータに変換する際に次の変更が行われます。

- portlet.xmlのポートレットに宣言済のsupported-public-render-parameterがある場合、oracle-portlet.xmlのすべてのナビゲーション・パラメータは無視され、メッセージがログに記録されます。

- portlet.xmlで、ポートレット・アプリケーション・レベルのpublic-render-parameter説明にoracle-portlet.xmlのナビゲーション・パラメータ名のローカル・パートと同じ識別子がある場合、競合するナビゲーション・パラメータは無視され、警告メッセージがログに記録されます。

- oracle-portlet.xmlで、portlet-extension要素に指定されたナビゲーション・パラメータに<name>要素と異なるネームスペース・パートはあるが、同じローカル・パートがある場合、1つを残して他のすべての重複するナビゲーション・パラメータは無視され、警告メッセージがログに記録されます。

表16-7 oracle-portlet.xmlで使用可能なnavigation-parameters要素の処理

navigation-parameter要素

XML型

JSR286コンテナのportlet.xmlの処理

<name>

QName

完全なQNameは、ポートレット・アプリケーション・レベルでportlet.xmlのpublic-render-parameter QNameとして使用されます。QNameのローカル・パートは、ポートレット・アプリケーション・レベルではpublic-render-parameter識別子として、またポートレット・レベルではsupported-public-render-parameter値として使用されます。

<type>

QName

無視されます。

<label>

localizedString

description要素に変換されます。

<label>、<hint>および<usage>要素が指定された順序でマージされ、portlet.xmlにpublic-render-parameterのdescription要素が作成されます。

<hint>

localizedString

description要素に変換されます。

<label>、<hint>および<usage>要素が指定された順序でマージされ、portlet.xmlにpublic-render-parameterのdescription要素が作成されます。

<usage>

string

description要素に変換されます。

<label>、<hint>および<usage>要素が指定された順序でマージされ、portlet.xmlにpublic-render-parameterのdescription要素が作成されます。

<aliases>

QName

ポートレット・アプリケーション・レベルのportlet.xmlにあるpublic-render-parameter宣言で別名宣言に変換されます。

A 例: SOA Order Bookingのアップグレードと再デプロイ

この付録では、複合的なOracle SOA Suite(SOA)アプリケーションをOracle Application Server 10g リリース3 (10.1.3.3)からOracle Fusion Middlewareリリース11 (11.1.1.0.0)にアップグレードする手順について、順を追って説明します。

この手順を通して、Oracle SOA Suite環境およびアプリケーションのアップグレード処理全体の例を示します。

この付録の具体的な内容は次のとおりです。

- SOA Order Bookingアプリケーションについて

- タスク1: SOA Order Bookingと外部パートナが稼働していることの確認

- タスク2: Oracle Fusion Middleware SOA Suiteのインストールとアップグレード

- タスク3: Oracle WebLogic Suite管理コンソールを使用した必要なリソースの構成

- タスク4: Oracle JDeveloper 11gのインストール

- タスク5: Oracle JDeveloperリリース11の接続の設定

- タスク6: SOA Order BookingアプリケーションをOracle JDeveloper 11gで開き、アプリケーション・プロジェクトを移行

- タスク7: Oracle Fusion Middleware 11gでの各アプリケーション・プロジェクトのコンパイルとデプロイ

- タスク8: Fusion Middleware ControlでのSOA Order Bookingアプリケーションのテスト

A.1 SOA Order Bookingアプリケーションについて

Oracle Application Server 10g リリース3(10.1.3.1.0)でサンプル・アプリケーションとして提供されたSOA Order Bookingアプリケーションでは、Oracle Application Server 10g リリース3(10.1.3.1.0)の多くの主要機能およびコンポーネントの実際の使用例を示しています。

SOA Order Bookingアプリケーションの詳細は、『Oracle SOA Suiteチュートリアル』および『Oracle SOA Suiteクイック・スタート・ガイド』を参照してください。この2つのドキュメントは、Oracle Technology NetworkのOracle Application Server 10g リリース3 (10.1.3.1.0)ドキュメント・ライブラリから入手できます。

http://www.oracle.com/technology/documentation/index.html

Oracle Application Server 10g リリース3(10.1.3.4)パッチ・セットにより、共通の問題に対する一連の改善と修正が適用されます。また、10g リリース3(10.1.3.4)用にテスト済の改善されたSOA Order Bookingの新バージョンもリリースされました。

この付録は、SOA Order Bookingアプリケーションと、このアプリケーションで使用されているテクノロジを理解しているユーザーを対象としています。

図A-1は、Oracle Application Server 10g リリース3(10.1.3.4)にデプロイされたSOA Order Bookingデモのログイン・ページを示しています。

図A-1 10g リリース3(10.1.3.4)にデプロイされたSOA Order Bookingアプリケーション

「図A-1 10g リリース3(10.1.3.4)にデプロイされたSOA Order Bookingアプリケーション」の説明

A.2 タスク1: SOA Order Bookingと外部パートナが稼働していることの確認

SOA Order Bookingアプリケーションを11gに移行する前に、次の前提条件を満たしていることを確認する必要があります。

- タスク1a: SOA Order BookingがOracle Application Server 10g リリース3(10.1.3.4)に正常にデプロイされていることの確認

- タスク1b: SOA Order BookingがOracle Application Server 10g リリース3(10.1.3.4)で現在稼働していることの確認

- タスク1c: すべての外部パートナが使用可能であることの確認

A.2.1 タスク1a: SOA Order BookingがOracle Application Server 10g リリース3 (10.1.3.4)に正常にデプロイされていることの確認

SOA Order Bookingアプリケーションを11gに移行する前に、次の条件を満たす必要があります。

- Oracle Application Server 10g リリース3(10.1.3.1.0)のインストールと構成作業、および10g リリース3(10.1.3.4)パッチ・セットの適用作業が完了していること

- Oracle JDeveloper 10g リリース3(10.1.3.4)のインストールと構成作業が完了していること

- SOA Order Bookingデモ・アプリケーションの、更新された10g リリース3(10.1.3.4)バージョンのダウンロード作業が完了していること
10g リリース3(10.1.3.4)のSOA Order Bookingデモ・アプリケーションは、Oracle Technology Network(OTN)の次の場所からダウンロードできます。

http://www.oracle.com/technology/products/ias/bpel/

- 10g リリース3 (10.1.3.1.0)の『Oracle SOA Suiteチュートリアル』または『Oracle SOA Suiteクイック・スタート・ガイド』の指示に従って、SOA Order BookingアプリケーションをOracle Application Server g リリース3 (10.1.3.4)にデプロイしていること
これには、SOA Order Bookingの10g リリース3(10.1.3.4)アプリケーションのデータベース・スキーマを、使用可能なデータベースにインストールすることも含まれます。

A.2.2 タスク1b: SOA Order BookingがOracle Application Server 10g リリース3(10.1.3.4)で現在稼働していることの確認

SOA Order Bookingアプリケーションを11gに移行する前に、アプリケーションを10g リリース3(10.1.3.4)上でテストし、正しく動作していることを確認します。これにより、SOA Order Bookingスキーマのインストール先データベースが稼働していて、外部サービスや外部パートナも稼働していることを確認します。

たとえば、アプリケーションへのログイン、製品一覧の閲覧(図A-2)および発注が可能であることを確認してください。また、BPEL Worklist Managerを使用したBPELプロセスの監視が可能であることを確認してください。

図A-2 SOA Order Bookingアプリケーションでのアイテムの閲覧

「図A-2 SOA Order Bookingアプリケーションでのアイテムの閲覧」の説明

詳細は、Oracle Application Server 10g リリース3 (10.1.3)の『Oracle SOA Suite クイック・スタート・ガイド』の、SOA Order Bookingアプリケーションの実行と監視に関する項を参照してください。

『Oracle SOA Suiteクイック・スタート・ガイド』はOracle Application Server 10g リリース3 (10.1.3)ドキュメント・ライブラリに含まれています。ドキュメント・ライブラリはOracle Technology Network (OTN)から入手できます。

http://www.oracle.com/technology/documentation/

A.2.3 タスク1c: すべての外部パートナが使用可能であることの確認

SOA Order Bookingアプリケーションを11gにアップグレードする前に、外部パートナが(リモートWebサービスの形態で)稼働していて使用可能であることを確認する必要があります。

Oracle JDeveloper 11gがこれらの外部パートナにアクセスでき、Oracle BPEL Process Managerと、10gにデプロイされているOracle Enterprise Service Busの各サービスにアクセスできることが必要です。アクセスできない場合、アプリケーション内のプロジェクトを11gに正しく移行できません。

必要なWebサービスが使用可能であることを確認するには、11gへの移行前にOracle SOA Suiteアプリケーションの各プロジェクトを調査する必要があります。たとえば、各プロジェクトのOracle BPEL Process Manager構成ファイルを確認し、これらの構成ファイルから参照されているWebサービスのURIが有効で稼働していることを確認します。

SOA Order Bookingアプリケーションでは、次のような方法でSOAOrderBookingプロジェクトの内容を確認できます。

1. Oracle JDeveloper 10g リリース3(10.1.3)で、SOA Order Booking 10g リリース3(10.1.3.4)アプリケーションを開きます。

2. SOAOrderBookingプロジェクトを展開し、「インテグレーション・コンテンツ」フォルダを展開します。

3. 「bpel」フォルダを展開し、bpel.xmlファイル(図A-3)をダブルクリックします。

図A-3 WSDL URLをテストするために bpel.xmlファイルを選択

「図A-3 WSDL URLをテストするためにbpel.xmlファイルを選択」の説明

4. bpel.xmlファイル内で、次のエントリを探します。

<partnerLinkBinding name="OrderFulfillment">
<property  name="wsdlLocation">
http://host.domain:port/esb/wsil/Fulfillment/OrderFulfillment?wsdl
</property>
<property name="preferredBindings">
http://www.oracle.com/esb/
</property>
</partnerLinkBinding>

5. wsdlLocation要素のURLをブラウザにコピーし、そのURLが有効で図A-4のような出力が表示されることを確認します。

6. WebサービスのURLが正しく表示されない場合は、アプリケーションを11gに移行する前にトラブルシューティングを実施し問題を解決します。
たとえば、SOA Order Bookingスキーマのインストール先データベースが稼働していて、アプリケーションのすべてのコンポーネントが正常にデプロイされていることを確認します。

7. bpel.xmlファイル内のその他のURLについても、この手順を繰り返します。

8. 次のプロジェクトのWSDL URLに対しても同様に調査します。

- SOAOrderBooking:

CreditValidatingService.wsdl
CustomerSvc.wsdl
RapidService.wsdl

- OrderBookingESB:

OrderBooking_OrderBookingProcess.esbsvc
OrderBooking_OrderBookingService.esbsvc

図A-4 Internet Explorerで表示したOrderFulfillmentのWSDL URL

「図A-4 Internet Explorerで表示したOrderFulfillmentのWSDL URL」の説明

A.3 タスク2: Oracle Fusion Middleware SOA Suiteのインストールとアップグレード

SOA Order BookingアプリケーションがOracle Application Server 10g リリース3(10.1.3)環境で正常に稼働していることを確認した後に、新しいOracle Fusion Middleware 11g環境をインストールして環境をアップグレードします。

第6章「Oracle SOA Suite 10g環境のアップグレード」の指示に従って、SOA Order Bookingの移行と再デプロイに備え、Oracle Fusion Middleware環境を準備します。

このタスクの内容は次のとおりです。

- Oracle SOA Suite 11g中間層のインストールと構成

- Oracle SOA Suiteスキーマの11gへのアップグレード

A.4 タスク3: Oracle WebLogic Suite管理コンソールを使用した必要なリソースの構成

SOA Order Bookingデモ・アプリケーションを使用するには、SOA Order Bookingのデプロイ先のOracle WebLogic Server管理対象サーバーに、データ・ソースと一連のJMSリソースが存在している必要があります。

これらのリソースを作成するためのOracle WebLogic Server管理コンソールの使用方法の詳細は、次の項を参照してください。

- タスク3a: SOADEMOデータ・ソースの作成

- タスク3b: DbAdapterアプリケーションの構成

- タスク3c: SOA Order Booking JMSリソースの作成

A.4.1 タスク3a: SOADEMOデータ・ソースの作成

SOA Order Bookingのサンプル・アプリケーションをOracle WebLogic Serverにデプロイする前に、SOA Order Bookingスキーマがインストールされているデータベースを参照するOracle WebLogic Serverデータ・ソースを最初に定義する必要があります。

このスキーマは、Oracle Application Server 10g リリース3(10.1.3.4)にSOA Order Bookingデモ・アプリケーションをデプロイしたときにインストールしたスキーマ(A.2項「タスク1: SOA Order Bookingと外部パートナが稼働していることの確認」を参照)と同じです。

データ・ソースを作成する手順は、次のとおりです。

1. 管理コンソールにログインします。

2. 「ドメイン構造」ツリーで「サービス」→「JDBC」の順に展開し、次に、「データ・ソース」を選択します。

3. データ・ソースの概要ページで、「新規」をクリックします。

4. 「JDBCデータ・ソースのプロパティ」ページが表示されます。
このページで次のプロパティを入力します。

- 名前: soademoDS

- JNDI名: jdbc/soademoDS

- データベースのタイプ: Oracle

- データベース・ドライバ: Oracleのドライバ(Thin XA)

5. 「次へ」をクリックして、「トランザクション・オプション」ページを表示します。
[次の2つのオプションは、HTおよびMark WrightからのコメントによりBug#9118797で削除されました]

- 「グローバル・トランザクションのサポート」を選択します。

- 「ロギング・ラスト・リソース」を選択します。

6. 「次へ」をクリックして、「接続の詳細」ページを表示します。

- 「データベース名」: Oracle_database_system_identifer_(SID)

- 「ホスト名」: Host_where_the_database_is_installed

- 「ポート」: Database_listening_port_for_example_1521

- 「データベース・ユーザー名」: soademo

- 「パスワード」および「パスワードの確認」: soademo

7. 「次へ」をクリックしてデータベース接続をテストします。

8. 「次へ」をクリックして「ターゲットの選択」ページを表示し、次に「soa_server1」を選択します。

9. 「終了」をクリックしてデータ・ソースをsoa_server1にデプロイします。

A.4.2 タスク3b: DbAdapterアプリケーションの構成

SOA Order Bookingアプリケーションをデータベースに接続するには、Oracle SOA Suite 11gドメインの一部としてインストールされ構成されているデフォルトのDbAdapterアプリケーションに変更を加える必要があります。

DbAdapterをSOA Order Bookingアプリケーション用に構成する方法は、次の項を参照してください。

- DbAdapterアプリケーションの新規アウトバウンド接続プールの作成

- DbAdapterアプリケーションの新規接続プールの構成

A.4.2.1 DbAdapterアプリケーションの新規アウトバウンド接続プールの作成

次の手順を使用して、DbAdapterアプリケーションに新規アウトバウンド接続プールを作成します。

1. DbAdapterアプリケーションのデプロイメント・プランを保存するためのディレクトリを作成します。
例:

MW_HOME/Oracle_SOA1/soa/DBPlan

2. 「ドメイン構造」ツリーで「デプロイメント」をクリックします。

3. DbAdapterアプリケーションをクリックします(チェック・ボックスではなく名前をクリックします)。

4. 「構成」タブをクリックし、「アウトバウンド接続プール」タブをクリックします。

5. 「新規」をクリックします。

6. javax.resource.cci.ConnectionFactoryのラジオ・ボタンを選択し、「次へ」をクリックします。

7. 「JNDI名」にeis/DB/soademoDSと入力します。
このJNDI名は、データベース接続で入力する値と一致する必要があります。データベース接続は、この手順の後のほうで、Oracle JDeveloperとともにアプリケーションをアップグレードする際に作成します。

8. 「終了」をクリックします。
このとき、デプロイメント・プランの場所を入力するように求められます。

9. 先に作成したディレクトリへのパスをクリックし、デプロイメント・プラン名Plan.xmlを入力します。

10. 正しいデプロイメント・プランが選択されていることを確認します。

11. 「次へ」をクリックし、「終了」をクリックします。

A.4.2.2 DbAdapterアプリケーションの新規接続プールの構成

次の手順を使用して、データ・ソースを参照するように新規接続プールを構成します。

1. 「構成」タブをクリックし、コネクション・ファクトリを展開して新規接続プールをクリックします(チェック・ボックスではなく名前をクリックします)。

2. 「プロパティ」表で、「xADataSource」の右側のボックスを選択します。
編集ボックスが表示されます。

3. 前に作成したデータ・ソースの名前を入力します。

jdbc/soademoDS

4. [Enter]キーを押して値を適用し、「保存」をクリックします。
フィールドに値を入力するには[Enter]キーを使用し、変更を保存するには「保存」をクリックする必要があります。

5. 「デプロイメント」ページに戻り、左側のナビゲーション・バーで「デプロイメント」をクリックします。

6. 「DbAdapter」の左側のチェック・ボックスを選択します。

7. 「更新」をクリックします。

8. 「このアプリケーションを再デプロイ」を選択し、デプロイメント・プランの場所を再確認して「終了」をクリックします。

9. 変更を検証して、確実に正しい構成になるようにします。構成が正しくないと、後でデプロイメント・エラーが発生します。

- 「DbAdapter」→「構成」→「アウトバウンド接続プール」ページに戻り、コネクション・ファクトリを展開して、接続プールが追加されたことを確認します。

- 前に入力した「xADataSource」プロパティの値を確認します。

- DbAdapterの「アウトバウンド接続プール」タブに戻り、eis/DB/soademoDS接続プールのコネクション・ファクトリのプロパティ値を確認します。

A.4.3 タスク3c: SOA Order Booking JMSリソースの作成

SOA Order Bookingサンプル・アプリケーションは、メッセージ・キューを使用して注文および調達の詳細を送信します。このため、アプリケーションを正常にデプロイできるようにするには、事前にJMSキューを構成しておく必要があります。

JMSの構成にはWLSTコマンドおよびスクリプトを使用できますが、次の手順では、JMSの構成にOracle WebLogic管理コンソールを使用する方法を示しています。

次の項では、SOA Order Bookingデモ・サンプル・アプリケーション向けにJMSを構成する方法について説明します。

- SOA Order Bookingデモ用のJMSキューの作成

- SOA Order Bookingデモ用のJMSコネクション・ファクトリの作成

- JmsAdapterアプリケーション用のアウトバウンド接続プールの作成

- JmsAdapter接続プールの構成

- 変更されたJmsAdapterアプリケーションの再デプロイ

A.4.3.1 SOA Order Bookingデモ用のJMSキューの作成

SOA Order Bookingデモに必要なJMS宛先を作成する手順は、次のとおりです。

1. Oracle WebLogic管理コンソールで、JMSモジュールの概要ページに移動し、「SOAJMSModule」JMSモジュールをクリックします。
このモジュールは、Oracle SOA Suite 11gをインストールおよび構成するときに作成および構成します。

2. JMSモジュールの構成ページで、「新規」をクリックします。

3. リソース・タイプのリストから「キュー」を選択します。

4. 「JMS宛先のプロパティ」ページで、宛先キューの名前とJNDI位置を入力します。
この手順では、次の値を入力します。

名前: demoFulfillmentQueue

JNDI名: jms/demoFulfillmentQueue

5. 「次へ」をクリックします。

6. 「サブデプロイメント」ドロップダウン・メニューから「SOASubDeployment」を選択します。

7. 「SOAJMSServer」JMSサーバーを選択し、「終了」をクリックします。

A.4.3.2 SOA Order Bookingデモ用のJMSコネクション・ファクトリの作成

SOA Order Bookingデモ・サンプル・アプリケーションに必要なコネクション・ファクトリを作成する手順は、次のとおりです。

1. Oracle WebLogic管理コンソールで、JMSモジュールの概要ページに移動し、「SOAJMSModule」JMSモジュールをクリックします。

2. JMSモジュールの構成ページで、「新規」をクリックします。

3. リソース・タイプのリストから「接続ファクトリ」を選択し、「次へ」をクリックします。

4. 「接続ファクトリのプロパティ」ページで、JMSコネクション・ファクトリの名前とJNDI位置を入力します。
次の値を使用します。

名前: demoCF

JNDI名: jms/demoCF

5. 「次へ」をクリックします。

6. 「終了」をクリックします。
キューとコネクション・ファクトリが「リソースの概要」にリストされます。

A.4.3.3 JmsAdapterアプリケーション用のアウトバウンド接続プールの作成

次の手順を使用して、新規接続プールを作成します。接続プールがJmsAdapterアプリケーションに構成され、デプロイメント・プランが使用されます。

1. JmsAdapterアプリケーションのデプロイメント・プランのディレクトリを作成します。
例:

MW_HOME/Oracle_SOA1/soa/JMSPlan

2. Oracle WebLogic Server管理コンソールで、「デプロイメント」をクリックします。

3. 「JmsAdapter」をクリックします(チェック・ボックスではなく名前をクリックします)。

4. 「構成」タブをクリックし、「アウトバウンド接続プール」タブをクリックします。

5. 「新規」をクリックします。

6. oracle.tip.adapter.jms.IJmsConnectionFactoryファクトリを選択します。

7. 「次へ」をクリックします。

8. eis/demo/Queueと入力します。

9. 「終了」をクリックします。
このとき、デプロイメント・プランの場所を入力するように求められます。

10. 前に作成したディレクトリへのパスをクリックし、計画名にPlan.xmlを入力します。
画面下部にラジオ・ボタンで選択されたプラン・ファイルがある場合は、入力したプラン・ファイルが優先されます。

11. 「次へ」をクリックし、「終了」をクリックします。

A.4.3.4 JmsAdapter接続プールの構成

次の手順を使用して、前項で作成した接続プールを構成します。

1. Oracle WebLogic Server管理コンソールで、「デプロイメント」をクリックします。

2. 「JmsAdapter」をクリックします(チェック・ボックスではなく名前をクリックします)。

3. 「構成」タブをクリックし、「アウトバウンド接続プール」タブをクリックします。

4. oracle.tip.adapter.jms.IJmsConnectionFactoryコネクション・ファクトリを展開します。

5. eis/demo/Queueをクリックします。

6. 「ConnectionFactoryLocation」プロパティの値をjms/demoCFに変更し、[Enter]キーを押します。
フィールドに値を入力するには[Enter]キーを使用する必要があります。

7. 「保存」をクリックします。
値を保存するには、「保存」ボタンを使用する必要があります。

A.4.3.5 変更されたJmsAdapterアプリケーションの再デプロイ

次の手順を使用して、JmsAdapterを再デプロイします。

1. Oracle WebLogic Server管理コンソールのナビゲーション・ツリーで、「デプロイメント」をクリックします。

2. 「JmsAdapter」の左側のチェック・ボックスを選択します。

3. 「デプロイメント」表の上部の「更新」をクリックします。

4. 正しいデプロイメント・プランが選択されていることを確認します。

5. 「このアプリケーションを再デプロイ」を選択し、デプロイメント・プランの場所を再確認して「終了」をクリックします。

A.5 タスク4: Oracle JDeveloper 11gのインストール

Oracle JDeveloper 11gは、Oracle Fusion Middlewareに付属しているCDのZIPファイルからインストールするか、またはOracle Technology Network(OTN)からOracle JDeveloper Studio Editionバージョン11.1.1.1.0.0のZIPファイルをダウンロードしてインストールできます。

http://www.oracle.com/technology/software/products/jdev/index.html

JDeveloperのインストール先は、Oracle Fusion Middleware 11gを稼働しているマシンでも、Oracle Fusion Middlewareを稼働しているマシンとは異なるマシンでもかまいません。

詳細は、『Oracle Fusion Middleware Oracle JDeveloperインストレーション・ガイド』を参照してください。

A.6 タスク5: Oracle JDeveloperリリース11の接続の設定

Oracle JDeveloperリリース11(11.1.1.0.0)で、データベースおよびOracle Application Serverへの接続を設定します。これらの接続を使用すると、SOADEMOスキーマのデータを表示し、アプリケーションをJDeveloperからOracle Fusion Middlewareにデプロイできます。

このタスクには、次のサブタスクが含まれます。

- タスク5a: Oracle JDeveloper 11gの起動

- タスク5b: 必要なOracle JDeveloper拡張機能があることの確認

- タスク5c: SOADEMOスキーマへの接続の作成

- タスク5d: Oracle WebLogic Serverへの接続の作成

A.6.1 タスク5a: Oracle JDeveloper 11gの起動

WindowsでOracle JDeveloper Studioを起動するには、次のいずれかの方法を使用します。

- 「スタート」メニューから、「すべてのプログラム」→「Oracle Fusion Middleware 11.1.1.x.x」→「Oracle JDeveloper Studio 11.1.1.x.x」の順に選択します。

- Oracle JDeveloperは、コマンドラインで次のいずれかのコマンドを実行して起動することもできます。

install_dir\jdeveloper\jdeveloper.exe
install_dir\jdeveloper\jdev\bin\jdevw.exe
install_dir\jdeveloper\jdev\bin\jdev.exe (to display a console window
for internal diagnostic information)

UNIXシステムでOracle JDeveloperを起動するには、次のファイルを実行します。

install_dir/jdeveloper/jdev/bin/jdev

A.6.2 タスク5b: 必要なOracle JDeveloper拡張機能があることの確認

Oracle SOA Suiteアプリケーションを11gにアップグレードするには、Oracle JDeveloper 11gに対応するOracle SOAコンポジット・エディタ拡張機能がインストールされている必要があります。

この拡張機能がインストールされていることを確認するには、Oracle JDeveloperの「ヘルプ」メニューから「バージョン情報」を選択し、「バージョン」タブをクリックします。コンポーネントのリストに「SOAコンポジット・エディタ」というエントリが表示されます。

「バージョン情報」ダイアログ・ボックスの「バージョン」タブにこのコンポーネントが表示されない場合は、「バージョン情報」ダイアログを閉じて、「ヘルプ」メニューから「更新の確認」を選択します。更新の確認ウィザードを使用して、最新バージョンの「SOAコンポジット・エディタ」拡張機能を検索し、インストールします。

A.6.3 タスク5c: SOADEMOスキーマへの接続の作成

JDeveloperで、SOADEMOスキーマへのデータベース接続を作成します。

注意:

このチュートリアルでは、データベース接続にSOADEMOという名前を付与します。別の名前を使用することもできますが、同じ命名規則を使用したほうがデモの手順がわかりやすくなります。

1. Oracle JDeveloperで、「表示」→データベース・ナビゲータを選択します。

2. 「IDE接続」ノードを右クリックし、「接続の作成」を選択します。

3. 表示されるダイアログ・ボックスで、次の値を入力します。

- 接続名: 「SOADEMO」と入力します。

- 接続タイプ: 「Oracle (JDBC)」を選択します。

- ユーザー名: 「SOADEMO」と入力します。

- パスワード: 「soademo」と入力します。

- ロール: 空白のままにします。

- パスワードの保存: このチェック・ボックスを選択します。

- カスタムJDBC URLの入力: このチェック・ボックスの選択を解除します。

- ドライバ: 「thin」を選択します。

- ホスト名: SOADEMOスキーマをインストールしたデータベースが実行されているマシンの名前を入力します。

- JDBCポート: データベースのポート番号を入力します。デフォルト値は1521です。

- SID: データベースのシステム識別子を入力します。デフォルト値はORCLです。

データベース接続値が不明な場合は、データベース管理者に確認してください。

4. 「接続のテスト」をクリックします。
テストが成功しない場合は、データベースが使用可能であること、および接続値が正しいことを確認してください。

5. 「終了」をクリックします。接続ナビゲータの「データベース」ノードの下に、接続が表示されます。

6. これで、Oracle JDeveloperからスキーマを調べることができます。「接続ナビゲータ」で、「データベース」→「SOADEMO」の順に展開します。「順序」および「表」ノードを開き、リストされる表が、『Oracle SOA Suite チュートリアル 10g リリース3 (10.1.3.1.0)』のSOADEMOスキーマの内容に関する項にリストされている表と一致していることを確認します。
図版db_connections.gifの説明

A.6.4 タスク5d: Oracle WebLogic Serverへの接続の作成

JDeveloperで、Oracle SOA Suite 11gをインストールおよび構成したOracle WebLogic Serverドメインへの接続を作成します。

1. Oracle JDeveloperで、「表示」→「アプリケーション・サーバー・ナビゲータ」を選択します。

2. 「アプリケーション・サーバー」ノードの下にある「アプリケーション・サーバー」フォルダを右クリックし、「新規アプリケーション・サーバー」を選択します。
図版as_connections.gifの説明

3. アプリケーション・サーバー接続ウィザードの「ようこそ」ページで、「次へ」をクリックします。

4. 次の値を入力します。

- 接続名: SoademoApplicationServerと入力します。

- 接続タイプ: 「WebLogic 10.3」を選択します。

「次へ」をクリックします。

5. ステップ2の認証ページで、次の値を入力します。

- ユーザー名: 「weblogic」と入力します。これは、Oracle WebLogic Serverのデフォルトの管理ユーザー名です。

- パスワード: weblogicユーザーのパスワードを入力します。これは、Oracle SOA Suite 11gドメインを構成したときに設定したパスワードです。

6. 「次へ」をクリックし、A.3項「タスク2: Oracle Fusion Middleware SOA Suiteのインストールとアップグレード」でインストールおよび構成したOracle WebLogic Serverドメインのホスト、ポートおよび名前を入力します。

7. 「次へ」をクリックします。「接続のテスト」ページが表示されます。

8. 「接続のテスト」をクリックします。

9. 「終了」をクリックします。
接続ナビゲータの「アプリケーション・サーバー」ノードの下に、接続が表示されます。

A.7 タスク6: SOA Order BookingアプリケーションをOracle JDeveloper 11gで開き、アプリケーション・プロジェクトを移行

次の項では、以前のバージョンのOracle JDeveloperで作成したアプリケーションを開き、移行ウィザードを使用してそのアプリケーションをOracle Fusion Middleware 11gにアップグレードする方法について説明します。

- アプリケーションを開いて移行

- 移行ログ・ファイルの表示

重要:

SOA Order Bookingアプリケーションおよびそのプロジェクトは、外部パートナに依存しています。SOA Order BookingアプリケーションをOracle Fusion Middleware 11gに移行する際は、これらのリモートWebサービスが稼働中でSOA Order Bookingアプリケーションから使用できる必要があります。

外部パートナのURIが使用できない場合、アプリケーションをOracle JDeveloper 11gで正常に開くことができません。詳細は、「タスク1: SOA Order Bookingと外部パートナが稼働していることの確認」を参照してください。

A.7.1 アプリケーションを開いて移行

アプリケーションをOracle JDeveloper 11gで開いて移行する手順は、次のとおりです。

1. 10g リリース3(10.1.3.4)のSOA Order Bookingデモ・アプリケーションのソース・ファイルがあるsoademoフォルダのバックアップ・コピーを作成します。
soademoフォルダの内容はアップグレード時に変更されます。バックアップ・コピーを使用すると、必要な場合に元の10g リリース3(10.1.3)バージョンのデモをリストアできます。

この手順では、作業フォルダ(アップグレードするファイルがあるフォルダ)がSOADEMO_HOMEディレクトリとして記載されていることに注意してください。

2. SOADEMO_HOMEディレクトリの内容を確認し、次のファイルがあれば削除します。

SOADEMO_HOME/SOAOrderBooking/bpel/rules/com

このbpel/rules/com/ディレクトリの下位にあるサブディレクトリも含まれます。

3. 「ファイル」メニューから「開く」を選択し、Oracle JDeveloper 10g リリース3 (10.1.3.1.0)のsoademo.jwsファイルを選択します。
移行ウィザードのステップ1の「ようこそ」ページが表示されます。

「次へ」をクリックします。

4. ステップ2(図A-5)で「はい」を選択し、プロジェクト・ファイルをOracle JDeveloperリリース11(11.1.1.0.0)に移行します。
「次へ」をクリックします。

図A-5 Oracle JDeveloper 11gの移行ウィザードのステップ2

「図A-5 Oracle JDeveloper 11gの移行ウィザードのステップ2」の説明

5. ステップ3で、「Webapp 2.5へ移行」チェック・ボックスの選択を解除します。
「Webapp 2.5へ移行」チェック・ボックスの選択を解除してプロジェクトを後で移行するには、プロジェクトを開いた後、JDeveloperでweb.xmlファイルを右クリックして、2.5へ移行を選択します。

注意:

「Webapp 2.5へ移行」チェック・ボックスの選択を解除することは重要です。SOA Order Bookingデモ・アプリケーションでは、この手順の後半で手動でアップグレードするWebサービスを使用するためです。このWebサービスが移行ウィザードにより自動アップグレードされないように、必ず「Webapp 2.5へ移行」チェック・ボックスの選択を解除してください。

「次へ」をクリックします。

図A-6 Oracle JDeveloperの移行ウィザードの WebApp 2.5オプションの選択の解除

「図A-6 Oracle JDeveloperの移行ウィザードのWebApp 2.5オプションの選択の解除」の説明

6. ステップ4で、ページの各項目を確認し、デフォルトの選択を受け入れて「次へ」をクリックします。

7. ステップ5で、選択した設定オプションを確認し、「終了」をクリックしてアプリケーションをOracle JDeveloperリリース11gにアップグレードします。
移行の進行状況を示す「移行ステータス」ダイアログ・ボックスが表示されます。また、移行についての情報が、Oracle JDeveloperのメイン・ウィンドウのロギング・ペインに表示されます。

8. 移行の完了後、「終了」をクリックします。

A.7.2 移行ログ・ファイルの表示

移行の後で、アプリケーション移行時に生成されたログ・ファイルを確認できます。ログ・ファイルには、プロジェクトが開かれてOracle JDeveloper 11gに移行された際にOracle JDeveloper 11gによって加えられた様々な変更が記録されています。

ログ・ファイルは次のディレクトリにあります。

JDEV_HOME\upgrade\logs\

各アプリケーションのログ・ファイルを識別するには、各ログ・ファイルの日付およびタイムスタンプを参照します。例:

SOAOrderBooking2009-04-29-12-46-35PM.log

また、Oracle JDeveloperのメイン・ウィンドウの「メッセージ」タブには、移行された各プロジェクトの個別のログ・ファイルへのリンクが表示されます。移行ログ・ファイルを表示する任意のリンクをクリックします。

A.8 タスク7: Oracle Fusion Middleware 11gでの各アプリケーション・プロジェクトのコンパイルとデプロイ

SOADEMOアプリケーションを開いてプロジェクトをOracle JDeveloper 11gに移行した後、各プロジェクトを1つずつ再コンパイルおよび再デプロイできます。

各プロジェクトの確認、コンパイルおよび再デプロイは、次の順序で行います。

- CreditService、RapidServiceおよびCustomerServiceプロジェクトについて

- SelectManufacturer

- DHLShipment

- FulfillmentESB

- CreditService

- RapidService

- CustomerService

- SOAOrderBooking

- OrderBookingESB

- ApproveOrderTaskForm

A.8.1 CreditService、RapidServiceおよびCustomerServiceプロジェクトについて

SOA Order BookingアプリケーションのCreditService、RapidServiceおよびCustomerServiceプロジェクトは、このアプリケーションの他のプロジェクトから参照されるJava EE Webサービスです。

このため、この例のためにこれら3つのプロジェクトを11gにアップグレードする必要はありません。引き続き、これらのサービスのOracle Application Server 10gバージョン(現在10g環境で実行されているバージョン)を使用できます。

これら3つのWebサービス・プロジェクトをアップグレードする場合は、次の点に注意します。

- Java EEアプリケーションとWebサービスの開発に関する知識と経験があれば、Webサービス・プロジェクトの変更手順は、この付録に書かれている内容で十分です。ただし、この手順は、Java EEプロジェクトのアップグレードに関するチュートリアルとしては説明されていません。

- CustomerService Webサービス・プロジェクトをアップグレードする場合は、SOAOrderBookingの追加変更がいくつか必要となりますが、この変更の詳細はこの付録には説明されていません。

A.8.2 SelectManufacturer

SelectManufacturerプロジェクトは非同期のBPELプロセスです。つまり、このプロジェクトには、BPELプロセス・フローを開始する受信アクティビティと、フローの最後に結果(つまり、見積)と非同期にクライアントをコールバックする起動アクティビティが含まれています。

SelectManufacturerプロジェクトをコンパイルおよび再デプロイする手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトを右クリックします。

2. コンテキスト・メニューから「SelectManufacturer.jprのメイク」を選択します。
プロジェクトが正常にコンパイルされます。

3. プロジェクトを再度右クリックし、「デプロイ」→「SelectManufacturer」を選択します。
デプロイメント・ウィザードの最初のページが表示されます。

4. ウィザード・ページの指示に従い、プロジェクトをSoademoApplicationServerにデプロイします。

A.8.3 DHLShipment

DHLShipmentプロジェクトは、Oracle Application Server 10g リリース3 (10.1.3)のOracle Enterprise Service Bus (ESB)サービスとして作成されました。このプロジェクトをOracle JDeveloper 11gによって開いた後に変更する必要はありません。

DHLShipmentプロジェクトをコンパイルおよび再デプロイする手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトを右クリックします。

2. コンテキスト・メニューから「DHLShipment.jprのメイク」を選択します。

3. プロジェクトを再度右クリックし、「デプロイ」→「DHLShipment」を選択します。
デプロイメント・ウィザードの最初のページが表示されます。

4. ウィザード・ページの指示に従い、プロジェクトをSoademoApplicationServerにデプロイします。

A.8.4 FulfillmentESB

FulfillmentESBプロジェクトは、10g リリース3(10.1.3)のOracle Enterprise Service Bus(ESB)プロジェクトとして作成されました。

注文が承認されると、SOAOrderBookingプロジェクトはFulfillmentESBプロジェクトを起動して注文の出荷方法を決定します。

注文はファイル・アダプタを介してUSPSに送信されます。注文情報はファイルに書き込まれます。Fedexの場合は、注文がデータベース・アダプタを介して送信されます。注文情報はデータベースに書き込まれます。FulfillmentESBプロジェクトは注文をJMSキューにも送信します。

このプロジェクトをコンパイルおよび再デプロイする前に、Oracle JDeveloper 11gで次の小さないくつかの変更を行う必要があります。

- Oracle JDeveloper 11gでのFulfillmentESBプロジェクトの変更

- FulfillmentESBプロジェクトのコンパイルおよびデプロイ

A.8.4.1 Oracle JDeveloper 11gでのFulfillmentESBプロジェクトの変更

FulfillmentESBプロジェクトを次のように変更します。

1. FullfillmentESBプロジェクトを展開し、composite.xmlをダブルクリックします。

2. FulfillmentESBコンポジットが「SOAコンポジット・エディタ」に表示されます(図A-4)。
詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のSOAアプリケーションおよびプロジェクト作成時の処理内容に関する項を参照してください。

3. 右側のスイムレーンでFulfillment.FulfillmentBatchへの参照を表すアイコンをダブルクリックします。
この外部参照はFulfillment.FulfillmentBatch JMSアダプタを表します。

この参照をダブルクリックすると、アダプタ構成ウィザードが表示されます。

4. アダプタ構成ウィザードの指示に従って、JMSアダプタをOracle Fusion Middleware 11g環境向けに再構成します。
ウィザードのデフォルト設定は、次を除いてすべて受け入れることができます。

- Oracle Enterprise Messaging Serviceとして「Oracle Weblogic JMS」を選択します。

- 「タスク5d: Oracle WebLogic Serverへの接続の作成」で作成したアプリケーション・サーバー接続を選択します。

- キュー名の横にある「参照」ボタンをクリックし、「demoFulfillmentQueue」を選択します。
「キュー名」フィールドに「jms/demoFullfillmentQueue」が入力されます。

- 「JNDI名」をeis/demo/Queueに設定します。

5. コンポジット・エディタに戻ったら、右側のスイムレーンでFulfillment.FedexShipmentへの参照を表すアイコンをダブルクリックします。
この外部参照はデータベース・アダプタを表します。

この参照をダブルクリックすると、アダプタ構成ウィザードが表示されます。

6. アダプタ構成ウィザードの指示に従って、データベース・アダプタをOracle Fusion Middleware 11g環境向けに再構成します。
ウィザードのデフォルトは、次を除いてすべて受け入れることができます。

- データベース接続としてsoademoを選択します。

- 「JNDI名」をeis/DB/soademoDSに設定します。

7. Fulfillment.USPSShipmentへの外部参照(ファイル・アダプタを表す)を次のように更新します。

1. ディスク上にファイル・アダプタのディレクトリを作成します。例:

MW_HOME/Oracle_SOA1/soa/USPSShipment

2. FulfillmentESBプロジェクトのためにコンポジット・エディタに戻り、FulfillmentUSPSShipmentへの外部参照をダブルクリックします。
アダプタ構成ウィザードが表示されます。

3. 「ファイル構成」画面が表示されるまで、画面の指示に従います。

4. 「発信ファイルのディレクトリ(物理パス)」フィールドで、ステップ7aで作成したディレクトリへのパスを入力します。

5. 「次へ」をクリックし、アダプタ構成手順の残りを実行します。

図A-7 SOA Order BookingアプリケーションのFulfillmentESBプロジェクトのコンポジット・エディタ

「図A-7 SOA Order BookingアプリケーションのFulfillmentESBプロジェクトのコンポジット・エディタ」の説明

A.8.4.2 FulfillmentESBプロジェクトのコンパイルおよびデプロイ

Fulfillmentプロジェクトをコンパイルおよび再デプロイする手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトを右クリックします。

2. コンテキスト・メニューから「FulfillmentESB.jprのメイク」を選択します。

3. プロジェクトを再度右クリックし、「デプロイ」→「FulFillmentESB」を選択します。
デプロイメント・ウィザードの最初のページが表示されます。

4. ウィザード・ページの指示に従い、プロジェクトをSoademoApplicationServerにデプロイします。

A.8.5 CreditService

CreditServiceプロジェクトは、顧客のクレジット・カードが有効かどうかをチェックします。このSOA Order Bookingアプリケーションで、コードは、クレジット・カード番号の値のみをチェックします。クレジット・カード番号が12345678未満の場合、カードは無効です。12345678以上の場合は、有効です。

このプロジェクトはJava EE Webサービスのプロジェクトです。続行する前に、A.8.1項「CreditService、RapidServiceおよびCustomerServiceプロジェクトについて」を参照してください。

このプロジェクトをコンパイルおよび再デプロイする前に、WebサービスをOC4J JAX-RPCからOracle WebLogic Server JAX-RPCにアップグレードしておく必要があります。

- CreditService Webサービスのアップグレード

- CreditServiceプロジェクトのコンパイルおよびデプロイ

A.8.5.1 CreditService Webサービスのアップグレード

OC4J JAX-RPC WebサービスをOracle WebLogic Server JAX-RPCにアップグレードする手順は、次のとおりです。

1. アプリケーション・ナビゲータで、CreditServiceプロジェクトを展開し、次の項目を選択します。
「アプリケーション・ソース」→「org.soademo.creditservice」→「CreditService」

2. Credit Service Webサービスを右クリックし、コンテキスト・メニューから「WebサービスをWLS JAX-RPC構成にアップグレード」を選択します。
「アップグレードの確認」ダイアログ・ボックスが表示されます。

3. 「はい」をクリックして、CreditService WebサービスをOracle WebLogic Server JAX-RPCにアップグレードします。

4. アップグレードが完了したら、プロジェクトを保存します。

図A-8 CreditService Webサービスをアップグレードする際の確認ダイアログ・ボックス

「図A-8 CreditService Webサービスをアップグレードする際の確認ダイアログ・ボックス」の説明

A.8.5.2 CreditServiceプロジェクトのコンパイルおよびデプロイ

CreditServiceプロジェクトをコンパイルおよび再デプロイする手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトを右クリックします。

2. コンテキスト・メニューから「CreditService.jprのメイク」を選択します。

3. プロジェクトを再度右クリックし、「デプロイ」→「CreditService」を選択します。
デプロイメント・ウィザードの最初のページが表示されます。

4. ウィザード・ページの指示に従い、プロジェクトをSoademoApplicationServerにデプロイします。

A.8.6 RapidService

RapidServiceプロジェクトは、顧客注文の見積価格を提示するサプライヤを表します。このサプライヤと競合する他のサプライヤが、SelectManufacturerです。顧客注文に対して低い見積を提示するサプライヤが、注文に対する供給を行うことができます。

このプロジェクトはJava EE Webサービスのプロジェクトです。続行する前に、A.8.1項「CreditService、RapidServiceおよびCustomerServiceプロジェクトについて」を参照してください。

このプロジェクトをコンパイルおよび再デプロイするには、Oracle JDeveloper 11gを使用して変更しておく必要があります。

- RapidService WebサービスのOC4J JAX-RPCからOracle WebLogic Server JAX-WSへのアップグレード

- RapidServiceプロジェクトのコンパイルおよびデプロイ

A.8.6.1 RapidService WebサービスのOC4J JAX-RPCからOracle WebLogic Server JAX-WSへのアップグレード

このプロジェクトをコンパイルおよびデプロイする前に、OC4J JAX-RPC WebサービスをOracle WebLogic Server JAX-WSにアップグレードしておく必要があります。

次の手順では、トップダウン手法を使用し、既存のWSDLを使用してWebサービスを再生成します。

1. RapidServiceプロジェクトから既存のJAX-RPC Webサービス・ファイルを削除します。

1. Oracle JDeveloper 11gアプリケーション・ナビゲータ・ペインで、RapidServiceプロジェクトを開いて、次のノードを開きます。
「アプリケーション・ソース」→「org.soademo.rapidservice」

2. 「RapidService」ノードを右クリックし、コンテキスト・メニューから「削除」を選択します。

3. 「Webサービスを削除しますか。」ダイアログ・ボックスで、「すべて選択」をクリックして、ダイアログ・ボックスに表示されたファイルをすべて選択します。

4. 図A-9に示すように、RapidService.wsdlファイルのチェック・ボックスの選択を解除します。

5. 「OK」をクリックします。

図A-9 RapidService Webサービスの削除

「図A-9 RapidService Webサービスの削除」の説明

6. 「タイプ」ノードの内容を開き、Item.java、Quote.javaを削除します。

7. 「Webコンテンツ」→「WEB-INF」ノードの内容を開き、oracle-webservices.xml、web.xmlおよびwebservices.xmlを削除します。
図A-10はRapidServiceの下のファイルを示しています。これらのファイルを選択して削除します。

図A-10 RapidService Webサービス・ファイルおよび関連ファイルの削除

「図A-10 RapidService Webサービス・ファイルおよび関連ファイルの削除」の説明

2. クラスパスからJAX-RPC Webサービスを削除します。

1. 「RapidService」プロジェクトを右クリックし、コンテキスト・メニューから「プロジェクト・プロパティ」を選択します。
「プロジェクト・プロパティ」ウィンドウが表示されます。

2. 「ライブラリとクラスパス」→JAX-RPC 10.1.3 Webサービスの順に選択し、「削除」→「OK」の順にクリックします。

3. 新しいJAX-WS Webサービスを生成します。

1. RapidServiceプロジェクト内の次の場所の下にあるRapidService.wsdlファイルを右クリックします。
「アプリケーション・ソース」→「org.soademo.rapidservice」→「RapidService」

2. コンテキスト・メニューから「Webサービスの作成」を選択します。
「WSDLからJava Webサービスを作成」ウィザードが表示されます。

3. 画面の指示に従い、新しいJAX-WS Webサービスを作成します。
「デプロイメント・プラットフォームの選択」画面で、必ず「Java EE 1.5(JAX-WS注釈のサポート付き)」を選択します。

4. RequestQuoteImpl.javaファイルのpoItemsQuoteメソッドを次のように変更します。

public Quote poItemsQuote(@WebParam(name = "param0", targetNamespace = "http://rapidservice.soademo.org/types/")
List<Item> param0) {
Long totalPrice = new Long(0);
for (int i = 0; i < param0.size(); i++) {
Item localItem = param0.get(i);
totalPrice += localItem.getQuantity() * 110;
}
Quote priceQuote = new Quote();
priceQuote.setSupplierName("RapidDistributors");
priceQuote.setSupplierPrice(totalPrice.toString());
return priceQuote;
}

5. RequestQuoteImpl.javaファイルのorderQuoteメソッドを次のように変更します。

public Quote orderQuote(@WebParam(name = "param0", targetNamespace =
"http://rapidservice.soademo.org/types/")
String param0, @WebParam(name = "param1", targetNamespace =
"http://rapidservice.soademo.org/types/")
String param1, @WebParam(name = "param2", targetNamespace =
"http://rapidservice.soademo.org/types/")
String param2, @WebParam(name = "param3", targetNamespace =
"http://rapidservice.soademo.org/types/")
String param3, @WebParam(name = "param4", targetNamespace =
"http://rapidservice.soademo.org/types/")
String param4) {
Quote priceQuote = new Quote();
priceQuote.setSupplierName("RapidDistributors");
priceQuote.setSupplierPrice("5000");
return priceQuote;
}

6. RapidServiceプロジェクトの変更を保存します。

A.8.6.2 RapidServiceプロジェクトのコンパイルおよびデプロイ

Fulfillmentプロジェクトをコンパイルおよび再デプロイする手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトを右クリックします。

2. コンテキスト・メニューから「RapidService.jprのメイク」を選択します。

3. プロジェクトを再度右クリックし、「デプロイ」→「RapidService」を選択します。
デプロイメント・ウィザードの最初のページが表示されます。

4. ウィザード・ページの指示に従い、プロジェクトをSoademoApplicationServerにデプロイします。

A.8.7 CustomerService

CustomerServiceプロジェクトは、SOAデモ・クライアント・アプリケーションなどのクライアント・アプリケーションがデータベースから顧客情報を取り出したり顧客をデータベースに追加するためのメソッドを提供するEJB実装です。

このプロジェクトはJava EE Webサービスのプロジェクトです。続行する前に、A.8.1項「CreditService、RapidServiceおよびCustomerServiceプロジェクトについて」を参照してください。

このプロジェクトをコンパイルおよびデプロイする前に、Oracle JDeveloper 11gでプロジェクトに対していくつかの変更を行っておく必要があります。

- 特定のCustomerServiceプロジェクト・クラス・ファイルの変更

- CustomerServiceプロジェクトのpersistence.xmlファイルの変更

- CustomerServiceプロジェクトのコンパイルおよびデプロイ

A.8.7.1 特定のCustomerServiceプロジェクト・クラス・ファイルの変更

Oracle JDeveloper 11gでCustomerServiceオブジェクトを変更するには、プロジェクトの/src/org/soademo/customerservice/ディレクトリにある次のファイルを変更する必要があります。

- business/Customerservice.java:
finsCustomerById()メソッドから"throws RemoteException"を削除します。

- client/CustomerServiceClient.javaとbusiness/CustomerServiceClient.java

1. 例A-1に示すクラス・ファイルのセクションを検索し、例A-2に示された変更を反映するように変更します。

2. ルックアップを次のように変更します。

CustomerService customerService =
(CustomerService)context.lookup(
"CustomerService#org.soademo.customerservice.business.CustomerService");

- business/CustomerserviceBean.java:
例A-3に示す変更を反映した内容になるようにこのファイルを変更します。

例A-1 オリジナルのCustomerService.javaファイル

private static Context getInitialContext() throws NamingException {
Hashtable en = new Hashtable();
//  Standalone OC4J connection details
env.put( Context.INITIAL_CONTEXT_FACTORY,
"oracle.j2ee.rmi.RMIInitialContextFactory" );
env.put( Context.SECURITY_PRINCIPAL, "oc4jadmin" );
env.put( Context.SECURITY_CREDENTIALS, "welcome1" );
env.put(Context.PROVIDER_URL, "ormi://localhost:23791/CustomerService");
return new InitialContext( env );

例A-2 変更されたCustomerService.javaファイル

private static Context getInitialContext() throws NamingException {
Hashtable env = new Hashtable();
env.put( Context.INITIAL_CONTEXT_FACTORY, "weblogic.jndi.WLInitialContextFactory" );
env.put( Context.SECURITY_PRINCIPAL, "weblogic" );
env.put( Context.SECURITY_CREDENTIALS, "weblogic" );
env.put(Context.PROVIDER_URL, "t3://edith:7101");
return new InitialContext( env );
}

例A-3 更新されたCustomerServiceBean.javaクラス・ファイル

package org.soademo.customerservice.business;
import javax.ejb.Remote;
import javax.ejb.RemoteHome;
import javax.ejb.Stateless;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import org.soademo.customerservice.persistence.Customer;
@Remote
@WebService(serviceName = "CustomerSvc",
targetNamespace = "http://www.globalcompany.com/ns/customer")
@Stateless(name="CustomerService", mappedName = "CustomerService")
public class CustomerServiceBean implements CustomerServiceLocal,
CustomerService {
@PersistenceContext(unitName = "customerServiceUnit" )
private EntityManager em;
public CustomerServiceBean() {
}
/**
* @param entity
* @return
*/
public Object mergeEntity(Object entity) {
return em.merge(entity);
}
public Object persistEntity(Object entity) {
em.persist(entity);
return entity;
}
public Object refreshEntity(Object entity) {
em.refresh(entity);
return entity;
}
public void removeEntity(Object entity) {
em.remove(em.merge(entity));
}
/** <code>select object(cust) from Customer cust
where cust.custid = :custid</code> */
@WebMethod
public Customer findCustomerById(@WebParam(name = "custid",
targetNamespace = "http://www.globalcompany.com/ns/customer")
String custid){
//    public Customer findCustomerById(String custid) {
return (Customer)em.createNamedQuery("Customer.findCustomerById").setParameter("custid",
custid).getSingleResult();
}
//    public String getCustomerStatus(String CustomerID) {
@WebMethod
public String getCustomerStatus(@WebParam(name = "CustomerID",
targetNamespace = "http://www.globalcompany.com/ns/customer")
String CustomerID){return
findCustomerById(CustomerID).getStatus();
}
//   public String addNewCustomer(Customer customer) {
@WebMethod
public String addNewCustomer(@WebParam(name = "customer",
targetNamespace ="http://www.globalcompany.com/ns/customer")
Customer customer){
em.persist(customer);
//making the change to return the customer id
// that client application can use to query orders
return customer.getCustid();
//return "New customer added sucessfully to customer database";
}
//   public Customer findCustomerByEmail(String email, String password) {
@WebMethod
public Customer findCustomerByEmail(@WebParam(name = "email",
targetNamespace = "http://www.globalcompany.com/ns/customer")
String email, @WebParam(name = "password",
targetNamespace = "http://www.globalcompany.com/ns/customer")
String password){
return(Customer)em.createNamedQuery(
"Customer.findCustomerByEmail").setParameter("email",
email).setParameter("password",
password).getSingleResult();
}
}

A.8.7.2 CustomerServiceプロジェクトのpersistence.xmlファイルの変更

Oracle Weblogic Serverで明示的にKodoを使用するようにsrc/META-INF/persistence.xmlを変更します。

Kodoは、透過なデータ・オブジェクトの規格であるSun Microsystem社のJava Persistence API(JPA)およびJava Data Objects(JDO)を実装したものです。Kodoは、スタンドアロン製品として使用可能で、WebLogic Serverに統合されます。

次のエントリをpersistence.xmlファイルの<persistence-unit>要素に追加します。

<provider>kodo.persistence.PersistenceProviderImpl</provider>

A.8.7.3 CustomerServiceプロジェクトのコンパイルおよびデプロイ

Fulfillmentプロジェクトをコンパイルおよび再デプロイする手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトを右クリックします。

2. コンテキスト・メニューから「CustomerService.jprのメイク」を選択します。

3. プロジェクトを再度右クリックし、「デプロイ」→「CustomerService」を選択します。
デプロイメント・ウィザードの最初のページが表示されます。

4. ウィザード・ページの指示に従い、プロジェクトをSoademoApplicationServerにデプロイします。

A.8.8 SOAOrderBooking

SOAOrderBookingプロジェクトはBPELプロジェクトで、SOA Order Bookingアプリケーションのメイン・フローを表します。これにより、注文情報が適切なタイミングで適切なサービスに送信されます。たとえば、CreditServiceに接続して顧客のクレジット・カードをチェックし、クレジット・カードがチェックに合格したら、サプライヤに接続(「Select Manufacturer」および「Rapid Distributors」)して注文の見積価格を入手します。

Oracle JDeveloper 11gでこのプロジェクトをコンパイルおよびデプロイするには、次のいくつかの変更を行う必要があります。

- SOAOrderBookingプロジェクトの変更

- (オプション)アップグレードされたWebサービスを使用するためのSOAOrderBookingの変更

- SOAOrderBookingプロジェクトのコンパイルおよびデプロイ

A.8.8.1 SOAOrderBookingプロジェクトの変更

Oracle JDeveloper 11gで、SOAOrderBookingプロジェクトを次のように変更します。

1. SOAOrderBookingプロジェクトを展開し、「SOAコンテンツ」→「ApproveOrder」フォルダを開きます。

2. ApproveOrder.taskファイルをダブルクリックします。このファイルで、手動による承認タスクを定義します。

3. 割当ておよびルーティングのセクションの「マネージャ」アイコンをダブルクリックし、「識別タイプ」ドロップダウン・メニューから「ユーザー」を選択して、該当フィールドにweblogicを入力します。

4. 「SOAコンテンツ」フォルダを開き、「composite.xml」をダブルクリックします。
「SOAコンポジット・エディタ」にSOAOrderBookingコンポジットが表示されます。

5. Orderへの参照を表すアイコンをダブルクリックします。
この外部参照はOrderデータベース・アダプタを表します。

この参照をダブルクリックすると、アダプタ構成ウィザードが表示されます。

6. ウィザードの指示を実行します。デフォルト設定は、次の変更を除いて受け入れます。

- データベース接続としてsoademoを選択します。

- 「JNDI名」をeis/DB/soademoDSに設定します。

7. OrderSequenceへの参照とOrderStatusへの外部参照に対してステップ5と6を実行します。これらの参照はともに、soademoデータベースおよびスキーマに接続するデータベース・アダプタを表しています。

8. SelectServiceへの参照をダブルクリックします。
「参照の更新」ダイアログ・ボックスが表示されます。

「WSDL URL」フィールドの横の「WSDL」アイコンをクリックすると、「SOAリソース・ブラウザ」が表示されます。

ドロップダウン・メニューから「リソース・パレット」を選択し、次に「リソース・パレット」から「SelectManufacturer」を選択します。

9. OrderFulfillmentへの参照に対してステップ8を繰り返します。ただし、今回は「リソース・パレット」のFulfillmentESBでFulfillment.OrderFulfillment_epエントリ・ポイントを選択します。

10. プロジェクトの変更を保存します。

A.8.8.2 (オプション)アップグレードされたWebサービスを使用するためのSOAOrderBookingの変更

この手順の前のほうでRapidService、CreditServiceおよびCustomerServiceプロジェクトをアップグレードして再デプロイした場合、Oracle Application Server 10g環境にデプロイされ稼働しているWebサービスではなく、新しい11g Webサービスを使用するように、SOAOrderBookingプロジェクトを変更できます。

または、引き続き、既存の10g Webサービスを参照することもできます。詳細は、A.8.1項「CreditService、RapidServiceおよびCustomerServiceプロジェクトについて」を参照してください。

新しくアップグレードされたRapidService、CreditServiceおよびCustomerService Webサービスを使用するようSOAOrderBookingプロジェクトを変更する手順は、次のとおりです。

1. アップグレードされたWebサービス・プロジェクトの新しいWSDL URLを検索します。

1. Webブラウザを開き、Fusion Middleware Controlにログインします。

For example: host24.mycompany.com:7001/em

詳細は、『Oracle Fusion Middleware管理者ガイド』のOracle Enterprise Manager Fusion Middleware Controlの使用に関するスタート・ガイドの項を参照してください。

2. ターゲット・ナビゲーション・ペインで、「アプリケーション・デプロイメント」フォルダを開きます。

3. デプロイ済アプリケーションのリストで、「SOADEMO-RAPIDSERVICE-RapidService-WS」アプリケーションをクリックします。
選択したアプリケーション用の「アプリケーション・デプロイメント」ページが表示されます。

4. このページの「エントリ・ポイント」セクションにある「Webサービス」表で、「SOADEMO-RAPIDSERVICE-RapidService-WS」に対して「テスト」アイコンをクリックします。

5. 「Webサービスのテスト」ページから、WebサービスのWSDL URLをメモします。

6. CreditServiceおよびCustomerServiceアプリケーションに対してステップcからeまでを繰り返します。

2. 新しいWSDL URLを使用してSOAOrderBookingコンポジットを変更します。

1. SOAOrderBookingプロジェクトを展開し、composite.xmlをダブルクリックします。

2. 「SOAコンポジット・エディタ」にSOAOrderBookingコンポジットが表示されます。

3. 右側のスイムレーンでRapidServiceへの外部参照を表すアイコンをダブルクリックします。
この外部参照はRapidService Webサービスを表します。

この参照をダブルクリックすると、「参照の更新」ダイアログ・ボックスが表示されます。

4. 「WSDL URL」フィールドに新しい11gのWSDL URLを入力し、「OK」をクリックします。

5. CreditValidationServiceおよびCustomerServiceへの外部参照に対してステップcとdを繰り返します。

6. プロジェクトの変更を保存します。

3. CustomerServiceプロジェクトを11gにアップグレードした場合は、11gへのアップグレード時に加えた変更を反映するよう、SOAOrderBooking.bpelファイルも変更する必要があります。
それには、Webサービス・バインディングを再接続し、customerServiceRequest、customerServiceResponseおよび後続の可変問合せを更新する必要があります。

A.8.8.3 SOAOrderBookingプロジェクトのコンパイルおよびデプロイ

SOAOrderBookingプロジェクトをコンパイルおよび再デプロイする手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトを右クリックします。

2. コンテキスト・メニューから「メイク」を選択します。
プロジェクトが正常にコンパイルされます。

3. プロジェクトを再度右クリックし、「デプロイ」→「SOAOrderBooking」を選択します。
デプロイメント・ウィザードの最初のページが表示されます。

4. ウィザード・ページの指示に従い、プロジェクトをSoademoApplicationServerにデプロイします。

A.8.9 OrderBookingESB

OrderBookingESBプロジェクトはSOA Order Bookingアプリケーションへのエントリ・ポイントです。

OrderBookingESBプロジェクトは、顧客が 「Place Order」 ボタンをクリックすると、SOADemo-Clientアプリケーションによって起動されます。

OrderBookingESBプロジェクトによりSOAOrderBookingプロジェクトが起動されます。SOAOrderBookingプロジェクトは、SOA Order Bookingアプリケーションの主要なフローを定義するBPELプロジェクトです。

これは、10g リリース3 (10.1.3)のOracle Enterprise Service Bus(ESB)プロジェクトとして作成されました。

Oracle JDeveloper 11gでこのプロジェクトをコンパイルおよびデプロイするには、次のいくつかの変更を行う必要があります。

- OrderBookingESBプロジェクトの変更

- OrderBookingESBプロジェクトのコンパイルおよびデプロイ

A.8.9.1 OrderBookingESBプロジェクトの変更

Oracle JDeveloper 11gでOrderBookingESBプロジェクトを変更する手順は、次のとおりです。

1. OrderBookingESBプロジェクトを展開し、composite.xmlをダブルクリックします。

2. OrderBookingESBコンポジットが「SOAコンポジット・エディタ」に表示されます(図A-4)。

3. 右側のスイムレーンでOrderBookingへの外部参照を表すアイコンをダブルクリックします。
この外部参照はOrderBooking Webサービスを表します。

この参照をダブルクリックすると、「参照の更新」ダイアログ・ボックスが表示されます。

4. 「WSDL URL」フィールドの横の「WSDL」アイコンをクリックすると、「SOAリソース・ブラウザ」が表示されます。
ドロップダウン・メニューから「リソース・パレット」を選択してアプリケーション・サーバー接続を開き、「リソース・パレット」から「SOAOrderBooking」→「クライアント」リソースを選択します。

5. プロジェクトの変更を保存します。

A.8.9.2 OrderBookingESBプロジェクトのコンパイルおよびデプロイ

OrderBookingESBプロジェクトをコンパイルおよび再デプロイする手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトを右クリックします。

2. コンテキスト・メニューから「メイク」を選択します。
プロジェクトが正常にコンパイルされます。

3. プロジェクトを再度右クリックし、「デプロイ」→「SOAOrderBookingESB」を選択します。
デプロイメント・ウィザードの最初のページが表示されます。

4. ウィザード・ページの指示に従い、プロジェクトをSoademoApplicationServerにデプロイします。

A.8.10 ApproveOrderTaskForm

Oracle JDeveloper 11gでSOA Order Bookingアプリケーションを開いてアップグレードすると、ApproveOrderTaskFormプロジェクトが自動的に作成されます。

このプロジェクトは変更する必要はありません。ただし、このプロジェクトをデプロイするには、プロジェクトとしてではなくアプリケーションとしてデプロイする必要があります。

1. ApproveOrderTaskFormプロジェクトを選択します。

2. 「アプリケーション」メニューから、「デプロイ」→「ApproveOrderTaskForm」を選択します。
デプロイメント・ウィザードの最初のページが表示されます。

3. ウィザード・ページの指示に従い、プロジェクトをSoademoApplicationServerにデプロイします。

A.9 タスク8: Fusion Middleware ControlでのSOA Order Bookingアプリケーションのテスト

SOADemo-Clientアプリケーションは、顧客がGlobal Companyへの注文に使用するWebベースのアプリケーションです。このアプリケーションにログインした顧客は、製品を参照してショッピング・カートに入れ、注文を発行できます。

SOADemo-Clientアプリケーションでは、ADFテクノロジを使用して、アプリケーション開発プロセスを簡素化し、アプリケーションの管理を容易にします。ADFアプリケーションは、JDeveloperを使用して作成できます。

しかし、SOAデモ・クライアント・アプリケーションをアップグレードしなくても、アップグレードされたSOA Order BookingアプリケーションをOracle Enterprise Manager Fusion Middleware Controlを使用してテストおよび確認できます。

Oracle Enterprise Manager Fusion Middleware Controlでは、Webベースの管理コンソールが用意されており、Oracle SOA Suiteコンポジット・アプリケーションの管理に使用できます。

Fusion Middleware ControlでSOA Order Bookingアプリケーションをテストする手順は、次のとおりです。

1. SOA Order Bookingアプリケーション・プロジェクトをデプロイしたOracle WebLogic ServerドメインのFusion Middleware Controlにログインします。
Fusion Middleware ControlのURLは通常次のようになります。

http://hostname:7001/em

詳細は、『Oracle Fusion Middleware管理者ガイド』のOracle Enterprise Manager Fusion Middleware Controlの使用に関するスタート・ガイドの項を参照してください。

2. ターゲット・ナビゲーション・ペインで、「SOA」フォルダ→「soa-infra(soa_server1)」ノードの順に開き、ドメインにデプロイされたSOAコンポジット・アプリケーションを表示します。

3. 「OrderBookingESB」コンポジット・アプリケーションをクリックします。
OrderBookingESBコンポジット・アプリケーション・ホームページの「ダッシュボード」タブが表示されます。このタブを使用することで、デプロイされたSOAコンポジット・アプリケーションを管理および監視できます。

4. ページの上部にあるボタン・バーの「テスト」をクリックします。
「Webサービスのテスト」ページに、「WSDLの位置」、「操作リスト」および2つのタブ「リクエスト」と「レスポンス」が表示されます。

5. このページで「引数を入力」セクションまで下にスクロールします。
ページのこのセクションで、コンポジット・アプリケーションをテストするための入力データを入力できます。SOA Order BookingアプリケーションのZIPファイルには、SOA Order Bookingアプリケーションのテストに使用するサンプル・データの入った、2つのテキスト・ファイルが含まれています。

6. SOADEMO_HOMEのルート・ディレクトリで、次の入力サンプル・テスト・ファイルを特定します。

sampleInput2.txt

7. sampleInput2.txtを開き、ファイルのコンテンツをすべて選択およびコピーします。

8. 「Webサービスのテスト」ページの「引数を入力」セクションのドロップダウン・メニューから、「XML表示」を選択します。

9. ページの「引数を入力」セクションの「リクエスト」タブに表示されたXMLコンテンツを選択して削除します。
図A-11は、「引数を入力」セクションで選択されたXMLコンテンツを示しています。

10. sampleinput2.txtファイルのコンテンツをテキスト・フィールドに貼り付け、ページの下部で「Webサービスのテスト」をクリックします。
数秒後、Webサービスが正常に起動されたことを示すメッセージが表示されます。サービスが取得した戻り値も表示されます。

11. 「メッセージ・フロー・トレースの起動」リンクをクリックして、コンポジットのフローならびにサービス、コンポーネントおよび参照の各ステータスを確認します。
「フローのトレース」ページ(図A-12)にプロセス・フローの各ステップが表示されます。このビューを使用することで、アプリケーションがその中の各コンポーネントおよびタスクを進行する過程を監視できます。

また、コンポーネントをクリックすることで、コンポーネントの「インスタンスの詳細」にドリルダウンできます。

12. 追加のテストとして、この同じ手順を実行するために、sampleinput2.txtと同じディレクトリに入っているsampleinput1.txtを使用でき、$1000を超える注文を発行します。
sampleinput1.txtの場合、次のURLにログインして注文を承認するまで、ワークフローが停止し、続行されません。

http://domain:port/integration/worklistapp

図A-11 「SOAコンポジット - Webサービスのテスト」ページの「引数を入力」セクションにおけるXMLコンテンツの選択

「図A-11 「SOAコンポジット - Webサービスのテスト」ページの「引数を入力」セクションにおけるXMLコンテンツの選択」の説明

図A-12: Fusion Middleware ControlでのSOA Order Bookingアプリケーションのフロー・トレース

「図A-12: Fusion Middleware ControlでのSOA Order Bookingアプリケーションのフロー・トレース」の説明

B Oracle Business Rulesのディクショナリおよびプロジェクトのアップグレード

Oracle Business Rulesのディクショナリおよびプロジェクトは旧リリースから移行できます。Oracle Business Rulesリリース10.1.3.xで作成されたディクショナリをOracle Business Rules for Oracle Fusion Middleware 11g リリース1 (11.1.1)で使用するには、ディクショナリを新しいディクショナリ形式に移行する必要があります。Oracle Business Rulesリリース10.1.3.x形式のディクショナリをOracle Fusion Middleware 11g リリース1 (11.1.1)に移行する移行パスは、リリース10.1.3.xディクショナリの作成方法に応じていくつかあります。

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

- B.1項「Oracle JDeveloperを使用したOracle Business Rulesディクショナリの移行」

- B.2項「ルール・マイグレータ・ツールを使用したOracle Business Rulesディクショナリの移行」

- B.3項「MigrateRuleRepositoryとOracle Business Rules SDKを使用したディクショナリの移行」

- B.4項「Oracle Business Rulesの手動移行タスク」

B.1 Oracle JDeveloperを使用したOracle Business Rulesディクショナリの移行

ディクショナリが10.1.3.x BPELデシジョン・サービスで作成されたアプリケーションの一部である場合は、Oracle JDeveloperでBPELプロセスを開くときに、Oracle Fusion Middleware 11g リリース1(11.1.1)ディクショナリ形式に移行できます。

Oracle JDeveloperを使用してディクショナリを移行する手順は、次のとおりです。

1. 図B-1に示すように、Oracle JDeveloperを開始します。これにより、Oracle JDeveloperの「開始」ページが表示されます。

図B-1 Oracle JDeveloperでのアプリケーションの作成

「図B-1 Oracle JDeveloperでのアプリケーションの作成」の説明

2. 「ファイル」メニューから「開く」を選択します。

3. プロジェクトに移動し、「開く」を選択します。
Oracle BPEL Process Manager移行ユーティリティが起動され、ルール・ディクショナリを含むプロジェクトが変換されます。

4. エラーがないかどうか、「メッセージ - ログ」ウィンドウを調べます。
場合によっては、移行を完了するために、移行するルール・ディクショナリをOracle Business Rules Designerにより手動で編集する必要があります。詳細は、B.4項「Oracle Business Rulesの手動移行タスク」を参照してください。

5. 「ファイル」メニューから「すべて保存」を選択します。

B.2 ルール・マイグレータ・ツールを使用したOracle Business Rulesディクショナリの移行

MigrateRuleRepositoryコマンドライン・ツールを使用して、ディクショナリを10.1.3.x形式からOracle Fusion Middleware 11g リリース1(11.1.1)形式に移行できます。ほとんどの移行シナリオで、手動移行タスクを実行する必要があることに注意してください。これは、10.1.3.xのコンセプトが、Oracle Fusion Middleware 11g リリース1(11.1.1)では更新されて、より強力な構成になったためです。手動移行タスクの詳細は、B.4項「Oracle Business Rulesの手動移行タスク」を参照してください。

このコマンドライン・ツールは次のような名前のJavaクラスです。

oracle.rules.tools.migrator.MigrateRuleRepository

これはSOA Oracleホーム内の次のディレクトリにあります。

SOA_HOME/soa/modules/oracle.rules.migration_11.1.1/migrator.jar

コマンドライン・ツールを実行するには、クラスパスに特定のJARファイル・セットが必要です。必要なJARファイルおよびライブラリのリストは、B.3.1項「Oracle Business Rules SDKを使用したディクショナリの移行方法」を参照してください。

たとえば、クラスパスを設定してLinux上で移行ツールを実行する手順は、次のとおりです。

> export CLASSPATH=required_jar_files
> java -cp $CLASSPATH oracle.rules.tools.migrator.MigrateRuleRepository OPTIONS

次に、MigrateRuleRepositoryコマンドの例を示します。

MigrateRuleRepository -all
-origType FILE_REPO
-origLocation /scratch/MyRepository
-destLocation /scratch/MyMigratedDictionaries
-importedClasspath /scratch/foo.jar:/scratch/myclasses
-xsdDirectory /scratch/myschemas
-xsdGeneration /scratch/jaxb_classes

表B-1に、必須のMigrateRuleRepositoryコマンドライン引数を示します。表B-2に、オプションのMigrateRuleRepositoryコマンドライン引数を示します。表B-3に、WebDAVのMigrateRuleRepositoryコマンドライン引数を示します。

表B-1 MigrateRuleRepositoryの必須オプション

オプション

説明

-origType {FILE_REPO | WEBDAV_REPO}

左記の文字列のいずれかを指定して、元のリポジトリのタイプを指定します。

-origLocation origin-repo

引数には、移行するディクショナリを含むリリース10.1.3.xリポジトリを指定します。これは、WebDAVリポジトリのURLかファイル・パスのいずれかの文字列を使用して指定します。

-destLocation dir-name

移行後のディクショナリの配置先となる宛先ディレクトリを指定します。移行後のディクショナリは、-destlocation、-destPackageNameおよび-destDictionaryName引数で構成されたディレクトリ構造に配置されます。

例:

dir-name/dest-pkg/dest-dict-name.xml

pkg-nameは、移行されて、dir-nameで作成されたディレクトリに配置されます。

-importedClasspath classpath

移行時にJavaファクト・タイプのインポートに使用するクラスパスを指定します。

-xsdDirectory schema-dir

XMLファクト・タイプ内で使用されるすべてのスキーマを含むスキーマ・ディレクトリを指定します。

-xsdGeneration jaxb-class-destination

スキーマのインポート時にJAXBクラスの生成先となるディレクトリを指定します。

-all

元のリポジトリ内のすべてのディクショナリを移行します。

-allを使用するか、または-origDictionaryNameおよび-origVersionNameを指定します。

-origDictionaryName origin-dict

-allオプションとは併用しないでください。

移行対象のディクショナリの名前を指定します。

-origVersionName origin-version

-allオプションとは併用しないでください。

移行対象のディクショナリのバージョンを指定します。

表B-2 任意のMigrateRuleRepositoryオプション

オプション

説明

-destPackageName dest-pkg

移行結果のディクショナリをOracle Business Rules Oracle Fusion Middleware 11g リリース1(11.1.1)形式で保存するときに使用するパッケージ名を指定します。移行後のディクショナリは、-destlocation、-destPackageNameおよび-destDictionaryName引数で構成されたディレクトリ構造に配置されます。

-destDictionaryName dest-dict

Oracle Business Rules Oracle Fusion Middleware 11g リリース1(11.1.1)形式の結果ディクショナリを保存するときに使用するディクショナリ名を指定します。移行後のディクショナリは、-destlocation、-destPackageNameおよび-destDictionaryName引数で構成されたディレクトリ構造に配置されます。

表B-3 WebDAV専用のMigrateRuleRepositoryオプション

オプション

引数および説明

-originPasswordSource webdav-password-src

引数には、WebDAV認証情報を含むOracle Walletファイルを指定します。

-originProxyHost webdav-proxy-host

プロキシが関係する場合、このオプションは必須です。必要であれば、引数にはWebDAVアクセス用プロキシとして使用するホストを指定します。

-originProxyPort webdav-proxy-port

必要であれば、プロキシが関係する場合に、引数にはWebDAVアクセス用プロキシ・ホストで使用するポートを指定します。

B.3 MigrateRuleRepositoryとOracle Business Rules SDKを使用したディクショナリの移行

MigrateRuleRepositoryプログラム関連インタフェースをOracle Business Rules SDKと一緒に使用します。通常の移行シナリオでは、手動移行タスクを実行する必要があることに注意してください。

B.3.1 Oracle Business Rules SDKを使用したディクショナリの移行方法

JavaをOracle Business Rules SDKと同時に使用して移行するには、oracle.rules.tools.migrator.MigrateRuleRepositoryクラスを使用します。

次の例では、http://www.oracle.com/technology/products/ias/business_rules/index.htmlにあるサンプルのhow-to-rules-javaを使用してディクショナリを移行します。

Oracle Business Rules SDKを使用してディクショナリを移行する手順

1. 図B-2に示すように、Oracle JDeveloperを開始します。これにより、Oracle JDeveloperの「開始」ページが表示されます。

図B-2 Oracle JDeveloperでのアプリケーションの作成

「図B-2 Oracle JDeveloperでのアプリケーションの作成」の説明

2. アプリケーションが作成されていない場合は、アプリケーション・ナビゲータで「新規アプリケーション」 をクリックします。または、アプリケーションがすでに作成されている場合は、「アプリケーション」をクリックし、ドロップダウン・リストから「新規アプリケーション」をクリックします。

3. アプリケーションの作成ウィザードで、新規アプリケーションの名前と場所を入力します。

1. 「アプリケーション名」フィールドで、アプリケーション名を入力します。たとえば、MigrateApplicationと入力します。

2. ディレクトリ名を入力するか参照します。または、デフォルトを受け入れます。

3. アプリケーション・パッケージ接頭辞を入力するか、またはデフォルトである接頭辞なしを受け入れます。
接頭辞はグローバルに一意の接頭辞である必要があり、通常は、会社が所有しているドメイン名になります。接頭辞に続いてピリオドが、アプリケーションの初期プロジェクト内に作成されたオブジェクトに付加されます。

この例では、接頭辞com.exampleを使用できます。

4. 図B-3に示すように、Oracle Business Rulesプロジェクトに対して、アプリケーション・テンプレートとして「汎用アプリケーション」を選択します。

図B-3 移行アプリケーションの追加

「図B-3 移行アプリケーションの追加」の説明

4. 「次へ」をクリックします。

5. 図B-4に示すように、汎用アプリケーションの作成ウィザードの「汎用プロジェクトの名前付け」で、新規プロジェクトの名前と場所を入力します。

- 「プロジェクト名」フィールドで、アプリケーション名を入力します。たとえば、MigrateProjectと入力します。

- ディレクトリ名を入力するか参照します。または、デフォルトを受け入れます。

- 「プロジェクト・テクノロジ」タブの「選択可能」リストで、「Java」を選択し、「移動」をクリックして「選択済」領域に追加します。

図B-4 プロジェクトのテクノロジの指定

「図B-4 プロジェクトのテクノロジの指定」の説明

6. 「終了」をクリックします。

7. Oracle JDeveloperで、MigrateProjectという名前のプロジェクトを選択します。

8. 右クリックし、ドロップダウン・リストから「プロジェクト・プロパティ」を選択します。

9. 「ライブラリとクラスパス」アイテムを選択します。

10. 「JAR/ディレクトリの追加」をクリックします。

次のJARファイルを含むようにプロジェクト・クラスパスを更新します。

ORACLE_HOMEディレクトリ内で、JDEV_HOMEと並んでJAVA_HOMEがインストールされている可能性がある点に留意してください。

JAVA_HOME/lib/tools.jar
JDEV_HOME/soa/modules/oracle.rules.migration_11.1.1/migrator.jar
JDEV_HOME/soa/modules/oracle.rules.migration_11.1.1/rulesdk.jar
JDEV_HOME/modules/oracle.adf.model_11.1.1/jr_dav.jar
JDEV_HOME/modules/oracle.pki_11.1.1/oraclepki.jar
JDEV_HOME/soa/modules/oracle.rules_11.1.1/rl.jar
JDEV_HOME/soa/modules/oracle.rules.migration_11.1.1/webdavrc.jar

11. 「アーカイブまたはディレクトリの追加」ダイアログで必要なJARファイルを選択し、図B-5に示すように「選択」をクリックします。

図B-5 「プロジェクト・プロパティ」ダイアログ: migrator.jar

「図B-5 「プロジェクト・プロパティ」ダイアログ: migrator.jar」の説明

12. 残りのJARファイルについてステップ10から繰り返します。

13. 「ライブラリの追加」をクリックします。

次のライブラリをプロジェクト・クラスパスに追加する必要があります。

- BC4Jクライアント

- Oracle JDBC

- Oracle Rules

- Oracle XML Parser v2

- JAX-RPCクライアント

14. 図B-6に示すように「ライブラリの追加」ダイアログで必要なライブラリを選択し、「OK」をクリックします。

図B-6 「プロジェクト・プロパティ」ダイアログ: Oracle Rulesライブラリ

「図B-6 「プロジェクト・プロパティ」ダイアログ: Oracle Rulesライブラリ」の説明

15. 残りのライブラリについてステップ13から繰り返します。

16. 「OK」をクリックします。

17. Oracle JDeveloperで、MigrateProjectという名前のプロジェクトを選択します。

18. 右クリックし、ドロップダウン・リストから「新規」を選択します。

19. 「新規ギャラリ」の「カテゴリ」領域で、「一般」を選択します。

20. 「新規ギャラリ」の「項目」領域で、「Javaクラス」を選択します。

21. 「OK」をクリックします。

22. 図B-7に示すように、「Javaクラスの作成」ウィンドウで、次のプロパティを構成します。

- 「名前」の値としてMigrateを入力します。

- 「パッケージ」の値としてcom.exampleを入力します。

- 次のチェック・ボックスを選択します。

- public

- <なし>

- スーパークラスからのコンストラクタ

- mainメソッド

図B-7 Migrate.javaクラスの作成

「図B-7 Migrate.javaクラスの作成」の説明

23. 「OK」をクリックします。
例B-1に示すようなJavaクラスが表示されます。

例B-1 新規クラスMigrate.java用に作成されたコード

package com.example;

public class Migrate {
public Migrate() {
}

public static void main(String[] args) {
Migrate migrate = new Migrate();
}
}

24. MigrateRuleRepository APIを使用して、例B-2に示すようなコードを追加します。
MigrateRuleRepository APIの詳細は、B.4.3項「手動移行についての留意事項」を参照してください。

例B-2 完成したMigrate.java

package com.example;

import java.io.PrintWriter;

import oracle.rules.tools.migrator.MigrateRuleRepository;

public class Migrate {
public Migrate() {
try {

// Create a migrator instance
MigrateRuleRepository conv = new MigrateRuleRepository();

// Set the output buffer
conv.setOutLog(new PrintWriter(System.out));

// Set input properties (SDK format)
conv.setOriginLocation("C:\\Temp\\how-to-rules-java\\dict\\CarRepository");
conv.setOriginType(MigrateRuleRepository.FILE_REPO);
conv.setOriginDictionaryName(MigrateRuleRepository.MIGRATE_ALL);
conv.setOriginVersionName(MigrateRuleRepository.MIGRATE_ALL);
conv.setImportedClassPath("C:\\Temp\\how-to-rules-java\\lib\\car.jar");

// Set output properties
conv.setDestinationLocation("C:\\Temp\\how-to-rules-java\\dict\\CarRepositorySDK2");

conv.migrate();
String results = conv.getTotalStats();
System.out.print(results);
}
catch (Exception e)
{
System.out.print(e);
}
}

public static void main(String[] args) {
Migrate migrate = new Migrate();
}
}

25. 移行元のリポジトリにXMLファクト・タイプが含まれている場合は、そのXMLファクト・タイプを定義するスキーマ・ファイルの場所を指定するだけでなく、スキーマ・ファイルをJavaクラスに変換する際にJAXBが使用する出力ディレクトリも指定する必要があります。
このデモでは、XMLファクト・タイプがないため、次のコード行は必要ありません。

conv.setXSDLocation("C:\\Temp\\how-to-rules-java\\schemas"); // or other
directory, as appropriate
conv.setXSDOutputDirectory("C:\\Temp\\how-to-rules-java\\jaxbOutput"); // or
other directory, as appropriate

26. アプリケーション・ナビゲータでMigrate.javaを右クリックし、「メイク」を選択します。

27. アプリケーション・ナビゲータでMigrate.javaを右クリックし、「実行」を選択します。

28. エラーがないかどうか、「メッセージ - ログ」ウィンドウを調べます。
場合によっては、移行を完了するために、ルールを手動で編集する必要があります。

29. 宛先位置から、移行後のディクショナリを取得します。
この例では、C:\Temp\how-to-rules-java\dict\CarRepositorySDK2から取得します。

B.3.2 MigrateRuleRepository APIについての留意事項

MigrateRuleRepository APIの詳細は、Oracle Fusion Middleware Oracle Business RulesのJava APIリファレンスを参照してください。

例B-3に示すように、標準的な移行プログラムでは、MigrateRuleRepository APIを使用して次のものを設定します。

- 入力プロパティ

- 出力プロパティ

B.3.2.1 入力プロパティ

入力プロパティには、移行するディクショナリの特性を定義します。例B-3の移行プログラムでは、標準的な入力プロパティが設定されます。

例B-3 入力プロパティ

// Set input properties (SDK format)
conv.setOriginLocation( "C:\\scratch\\SDK1_Repository" );
conv.setOriginType(MigrateRuleRepository.FILE_REPO);
conv.setOriginDictionaryName(MigrateRuleRepository.MIGRATE_ALL);
conv.setOriginVersionName(MigrateRuleRepository.MIGRATE_ALL);

MigrateRuleRepositoryメソッドを使用して、次の必須の入力プロパティを設定する必要があります。

- setOriginLocation - 移行対象のルール・ディクショナリの完全修飾パスを指定します。

- setOriginType - ルール・ディクショナリを含むリポジトリのタイプを指定します。次の定数のいずれかを選択できます。

- MigrateRuleRepository.FILE_REPO: ルール・ディクショナリがホストのファイル・システムに単純なファイルとして格納されます。

- MigrateRuleRepository.WEBDAV_REPO: ルール・ディクショナリがWebDAV管理リポジトリに格納されます。

- setOriginDictionaryName - 移行対象として指定するルール・ディクショナリに含まれるディクショナリの名前を指定します。ディクショナリ名には、Stringとしての名前、または指定するディクショナリに含まれるすべてのディクショナリを移行する場合はMigrateRuleRepository.MIGRATE_ALLを指定します。

- setOriginVersionName - 移行対象として指定するルール・ディクショナリのバージョンを指定します。ディクショナリのバージョンには、Stringとしてのバージョン、または指定するディクショナリのすべてのバージョンを移行する場合はMigrateRuleRepository.MIGRATE_ALLを指定します。

必要な場合は、この他のMigrateRuleRepositoryメソッドを使用してオプションの入力プロパティを定義することもできます。

B.3.2.2 出力プロパティ

出力プロパティでは、入力プロパティを指定している場合に、MigrateRuleRepositoryクラスの移行先となるOracle Fusion Middleware 11g リリース1(11.1.1)Oracle Business Rulesディクショナリの特性を定義します(項B.3.2.1「入力プロパティ」を参照)。例B-4の移行プログラムでは、標準的な入力プロパティが設定されます。

例B-4 出力プロパティ

// Set output properties (SDK2 format)
conv.setDestinationLocation( "C:\\scratch\\SDK2_Migrated_Dictionaries" );

MigrateRuleRepositoryメソッドを使用して、次の必須の出力プロパティを設定する必要があります。

- setDestinationLocation - 新しいOracle Fusion Middleware 11g リリース1(11.1.1)Oracle Business Rulesベースのルール・ディクショナリの完全修飾ファイル名を指定します。

必要な場合は、この他のMigrateRuleRepositoryメソッドを使用してオプションの出力プロパティを定義することもできます。

たとえば、デフォルトでは、新しいOracle Fusion Middleware 11g リリース1(11.1.1)Oracle Business Rulesディクショナリは、元のディクショナリで使用されていたパッケージ名を使用します。この動作をオーバーライドするには、MigrateRuleRepositoryのメソッドsetDestinationPackageNameを使用して新しいパッケージ名を指定します。

B.4 Oracle Business Rulesの手動移行タスク

Oracle Business Rulesリリース10.1.3.xで作成されたディクショナリを使用できるようにするには、そのディクショナリをOracle Fusion Middleware 11g リリース1(11.1.1)に必要な形式に移行する必要があります。BPELプロセスのデシジョン・サービスに含まれているディクショナリを最も簡単に移行する方法として、JDeveloperを使用できます。あるいは、MigrateRuleRepositoryコマンドライン・ツールを使用して移行することもできます。移行シナリオによっては、手動移行タスクを実行する必要があります。

B.4.1 JAXB 1.0からJAXB 2.0への移行方法

JAXB 2.0における重要なユーザビリティ上の改善点を利用できるようにするには、次の移行タスクを手動で実行する必要があります。

JAXB 1.0とJAXB 2.0の最も重要な違いは、生成されるクラスです。JAXB 1.0は、注釈がJava 1.5に導入される前に作成され、そのため一連のインタフェースと抽象クラスに依存しています。Oracle Business Rulesリリース10.1.3.xでは、デフォルトでJAXB 1.0を使用していました。Oracle Fusion Middleware 11g リリース1(11.1.1)では、デフォルトでJAXB 2.0を使用します。Rules Designerでは、XMLスキーマをインポートするには、JAXB 2.0のみを使用できます。移行後のディクショナリは引き続きJAXB 1.0を使用しますが、スキーマの変更やJAXB 1.0としての再インポートはできません。

JAXB 1.0オブジェクトを使用する移行後のディクショナリも、Oracle Fusion Middleware 11g リリース1(11.1.1)で動作します。ただし、JAXB 2.0では、重要な新機能および様々な改善を利用してOracle Business Rulesを使用できます。

例B-5に示すXSDフラグメントについて考えます。

例B-5 XSDフラグメント

<element name="foo">
<complexType>
<sequence>
<element name="bar" type="string"/>
<element name="baz" type="string"/>
</sequence>
</complexType>
</element>

この要素は、匿名の複合タイプを使用してデータ構造を定義しています。JAXB 1.0では次のクラスが生成されます。

- FooType

- Foo extends FooType, javax.xml.bind.Element

- FooImpl extends FooTypeImpl implements Foo

- FooTypeImpl extends oracle.xml.jaxb.JaxbNode implements FooType

これらのクラスのインスタンスを作成する唯一の手段は、ObjectFactoryの静的ファクトリ・メソッドです。

これに対して、JAXB 2.0で生成される単一の注釈付きクラスFooは、newメソッドまたはObjectFactoryメソッドのいずれを使用してもインスタンス化できます。

ルールの作成に使用されるファクト・タイプは、旧リリースではFooTypeであったのに対し、11g リリース1 (11.1.1.6.0)ではFooになりました。

ファクト・タイプFooTypeをFooに移行するには、次の手動移行タスクを実行します。

JAXB 1.0からJAXB 2.0に移行する手順

1. ルール・マイグレータ・ツールを使用して移行します。
詳細は、B.2項「ルール・マイグレータ・ツールを使用したOracle Business Rulesディクショナリの移行」を参照してください。

2. SCA-INF/classes内のすべてのクラスを削除します。

3. ルールで使用するすべてのファクト・タイプに割り当てられている別名を記録します。
たとえば、FooTypeファクトの別名「My Foo Type」を記録します。

4. JAXB 2.0にアップグレードするXMLファクト・タイプをデータ・モデルから削除します。
この操作を実行すると、削除するファクト・タイプの参照ごとに1つずつ、大量の検証警告が発生する可能性があります。

ただし、参照されるすべての要素のIDとString値に対する参照は、SDKにより保存されます。

参照のIDが設定されて存在している場合は、String値が現在の別名を反映するように更新されます。このため、ファクト・タイプの別名を変更すると、そのファクト・タイプが参照されるすべての場所で、参照のIDのために新しい値が取得されます。

このIDの要素がディクショナリから削除された場合でも、String値には参照された要素の最後の既知名が保持されます。これにより、たとえば、次のことができます。

1. 別名「FactType1」のファクト・タイプを削除します。

2. 新しいファクト・タイプをインポートします。

3. 新しいファクト・タイプの別名を「FactType1」に設定します。削除されたファクト・タイプに対するすべての参照は、自動的に新しいファクト・タイプを参照するように変更されます。

5. スキーマをインポートします。
11g リリース1 (11.1.1.6.0)では、JAXB 2.0がデフォルトです。

6. ファクト・タイプの別名を以前の別名に設定します。
たとえば、Fooの別名をFooTypeに変更します。

7. ディクショナリに対する検証を実行します。

8. 必要であれば、ファクト・タイプの別名を元の別名に設定します。
たとえば、別名FooTypeを再びFooに変更します。

9. 参照がすべて更新されたことを確認します。

B.4.2 RL関数の移行方法

旧リリースでは、関数を作成する唯一の方法は、フリー・フォームのRLを作成することでした。この関数は生成されるRL名に依存していましたが、11g リリース1 (11.1.1.6.0)で変更され、別名から自動的に計算されるようになったため、ユーザーが有効な名前を指定しなくても、関数がRLに準拠するようになりました。

アクションを使用することで、全体にアクセスする関数をリライトしてこの変更に準拠するようにできます。関数の作成は、アクションを使用すると設計時に関数が検証されるため、旧リリースよりも容易になりました。

Oracle Business Rules Release 10.1.3.xディクショナリでは、フリー・フォームのRL関数を含んでおり、データ・モデルにないJavaクラスの参照は一般的な方法でした。たとえば、多くのディクショナリには、ObjectFactoryを使用してJAXBクラスのインスタンスを作成する関数が含まれています。Oracle Fusion Middleware 11g リリース1(11.1.1)では、このクラスはJAXB 2.0クラスとしてインポートされるため、スキーマを再インポートしてObjectFactoryをインポートするだけでは、このクラスをデータ・モデルに追加できません。この場合、ディクショナリの移行元となったプロジェクトの「classes」ディレクトリにあるObjectFactoryクラスを使用すると解決します。このObjectFactoryクラスはJavaクラスとしてインポートする必要があり、それにより、Oracle Fusion Middleware 11g リリース1(11.1.1)の関数で参照できるようになります。

詳細は、B.4.3項「手動移行についての留意事項」を参照してください。

RL関数を移行する手順は、次のとおりです。

1. フリー・フォームのRL関数ごとに、アクションを使用するRLをリライトします。
11g リリース1 (11.1.1.6.0)では、関数本体とルールの中でアクションを使用できます。ほとんどの場合にフリー・フォームの関数本体を不要にできる新しいアクション・フォームがいくつかあります。使用可能なアクション・フォームは次のとおりです。

- Call

- AssertおよびAssert new

- Retract

- AssignおよびAssign New

- Modify

- Synchronized

- Expression

- Assert

- If、Else IfおよびElse

- ForおよびWhile

- Return、Throw、Try、CatchおよびFinally

- RL

2. ディクショナリを検証します。
詳細は、『Oracle Fusion Middleware Oracle Business Rulesユーザーズ・ガイド』のデシジョン表検証の理解に関する項を参照してください。

B.4.3 手動移行についての留意事項

旧リリースでは、XMLスキーマをインポートする唯一の方法はJAXB 1.0を使用することでした。11g リリース1 (11.1.1.6.0)では、Oracle Business RulesではJAXB 1.0をサポートしますが、デフォルトはJAXB 2.0です。引き続きJAXB 1.0を使用することを選択する場合、生成されたRLがMultipleInheritanceExceptionをスローする可能性があります。詳細は、『Oracle Fusion Middleware Oracle Business Rulesユーザーズ・ガイド』のJAXB 1.0ディクショナリおよびRL MultipleInheritanceExceptionに関する項を参照してください。

フリー・フォームのRL関数本体の検証チェックは、SDKでは行われません。このため、関数のエラーが存在していても、RLを実行しないかぎり明らかになりません。例B-6に、BPELプロセスにおけるこのようなエラーの例を示します。

例B-6 無効なRL関数の実行時エラー

[2008-10-01T04:52:15.043-07:00] [server_soa] [ERROR] [] [oracle.soa.services.rules] [tid: 35] [ecid:0000HmsG4oAEsHQ6ubV4EH18sYBt0000JA,0:2:100000051] [composite_name:ThreePattern] [component_name: CreditRatingRules] [component_instance_id:90558a4f-8781-4ac7-821c-49f46dd2f8fc] [composite_instance_id: 90033] <.>
Error caching the Decision Services metadata.[[
Error caching the decision services metadata for path
default/ThreePattern!1.0*c04f9ced-55ff-42fc-a6ee-f64a2055baf2/CreditRatingRules.
Check the underlying exception and correct the error. This is most likely due
to a rule modeling isssue. Validate the rule dictionary in rule designer and
fix any errors and warnings. Contact oracle support if error is not fixable.
ORABPEL-36109 Error caching the Decision Services metadata.
Error caching the decision services metadata for path default/ThreePattern!1.0*c04f9ced-55ff-42fc-a6ee-f64a2055baf2/CreditRatingRules.
Check the underlying exception and correct the error. This is most likely due to a rule modeling isssue. Validate the rule dictionary in rule designer and fix any errors and warnings. Contact oracle support if error is not fixable.
at oracle.bpel.services.rules.impl.DecisionServiceCache.cacheDecisionServiceMetadata(DecisionServiceCache.java:1039)
at
oracle.bpel.services.rules.impl.DecisionServiceCache.prepare(DecisionServiceCache.java:343)
at
oracle.bpel.services.rules.impl.DecisionServiceImpl.preProcess(DecisionServiceImpl.java:1164)
...

Caused by: oracle.rules.rl.exceptions.UndefinedException: symbol'CreditRatingRules.rating_param' is undefined at line 25 column 8 in main
at
oracle.rules.rl.exceptions.ExceptionFactory.createUndefinedException(ExceptionFactory.java:386)
at oracle.rules.rl.analyze.Expr.qname(Expr.java:1742)
at oracle.rules.rl.analyze.Expr.primary(Expr.java:814)
at oracle.rules.rl.analyze.Expr.expr(Expr.java:195)
...

Copyright © 2009, 2012, Oracle and/or its affiliates. All rights reserved.