4 Oracle Service Bus (Oracle SOA Suiteなし)の11gからのアップグレード
ノート:
Oracle Service BusがSOA 11gまたは以前の12cドメインの一部であり、Oracle Service BusをOracle SOA Suiteの12c (12.2.1.4.0)へのアップグレードの一環としてアップグレードする場合は、「SOA SuiteおよびBusiness Process Managementのアップグレード」または「Oracle SOA SuiteおよびBusiness Process Managementの以前の12cリリースからのアップグレード」で説明されている標準アップグレード手順に従ってください。- Oracle Service Busの12cへのスタンドアロン・アップグレードの理解
Oracle SOA Suiteを含まないOracle Service Bus 11gデプロイメントをアップグレードするには、このプロセス・フローに従います。 - Oracle Service Bus 12c (12.2.1.4.0)のアップグレードに関する制限事項
Oracle Service Bus 11gのトポロジが単一のドメイン内の複数のコンポーネントで構成されている場合は、12c (12.2.1.4.0)にアップグレードできません - Oracle Service Bus (OSB)のアップグレード前タスクの実行
- Oracle Service Busのインストール
Oracle Universal Installerを使用して、必要な製品ディストリビューションをターゲット・システムにインストールします。Oracle Service Busは、Oracle SOA SuiteおよびBusiness Process Managementなしでインストールおよびアップグレードできますが、Oracle Service Busをアップグレードする前には、Oracle Fusion Middleware Infrastructure 12c (12.2.1.4.0)をインストールする必要があります。 - RCUを使用した必要な12cスキーマの作成
11gからアップグレードする場合、必要な12cスキーマを作成する必要があります。リポジトリ作成ユーティリティ(RCU)を使用してカスタマイズされたスキーマを作成するか、オプションでUpgrade Assistantを使用してデフォルトのスキーマ設定を使用したスキーマを作成できます。この手順では、RCUを使用してスキーマを作成する方法について説明します。Upgrade Assistantを使用してスキーマを作成する詳細は、アップグレード手順で説明します。 - サーバーとプロセスの停止
Upgrade Assistantを実行してスキーマおよび構成をアップグレードする前に、すべてのアップグレード前のプロセス、および管理サーバーや管理対象サーバーを含めたすべてのサーバーを停止する必要があります。 - Upgrade Assistantを使用したスキーマのアップグレード
- ドメインの再構成について
再構成ウィザードを実行して、ドメイン・コンポーネント構成を12c (12.2.1.4.0)にあわせて再構成します。 - ドメイン・コンポーネント構成のアップグレード
ドメインを再構成した後、Upgrade Assistantを使用して、更新したドメイン構成と一致するようドメイン内のドメイン・コンポーネント構成をアップグレードします。 - Oracle Service Busのアップグレード後タスクの実行
- Oracle Service Busアップグレードのトラブルシューティング
Oracle Service Busの12cへのスタンドアロン・アップグレードの理解
Oracle SOA Suiteを含まないOracle Service Bus 11gデプロイメントをアップグレードするには、このプロセス・フローに従います。
Oracle Service Bus (OSB)は、Oracle SOA SuiteおよびBusiness Process Managementの有無にかかわらず12c (12.2.1.4.0)にアップグレードできます。このトピック内のアップグレード・ステップでは、SOAを含まないOracle Service Busのアップグレード方法について説明します。
Oracle Service BusがSOA 11gまたは以前の12cドメインに含まれており、Oracle SOA Suiteの12c (12.2.1.4.0)へのアップグレードの一部としてOracle Service Busをアップグレードする場合は、「SOA SuiteおよびBusiness Process Managementのアップグレード」で説明している標準アップグレード・プロセスに従います。
ノート:
ドメインにSOAが含まれていない場合でも、Oracle Service Busメタデータをアップグレードするために、_SOAINFRA
スキーマをアップグレードする必要があります。Oracle Service Busには別個のスキーマはありません。
タスク | 説明 |
---|---|
Oracle Web Services Managerがまだデプロイされていない場合は必要となります。 既存の11g環境にOracle Web Services Managerポリシー・マネージャをデプロイします。 |
Oracle Web Services Manager (OWSM)ポリシー・マネージャがOracle Service Bus 11g環境にデプロイされていない場合は、12cにアップグレードする前に、それを手動でデプロイする必要があります。 |
必須 Oracle Service Busのアップグレード時にサービス、プロジェクトおよびリソースをエクスポートします |
Oracle Service Bus 12c (12.2.1.4.0)にアップグレードする前に、サービス、プロジェクトおよびリソースを構成JARファイルにエクスポートする必要があります。アップグレード後に、このJARファイルを新しい12c環境にインポートします。 |
必須 既存の環境からすべてのサービス、プロジェクトおよびリソースを削除します。 |
エクスポートの後、ユーザーが作成したすべてのサービス、プロジェクトおよびリソースを、アップグレード前に削除する必要があります。 |
必須 12c Oracle Fusion Middleware Infrastructureディストリビューションを新しいOracleホームにインストールします。 |
12c Infrastructure (Oracle WebLogic ServerおよびJRFコンポーネントを含む)をインストールする必要があります。 |
必須 Oracle Service Busを新しいOracleホームにインストールします。 |
Oracle Service Busディストリビューションを入手して、そのコンテンツを新しいOracleホームにインストールします。 |
必須 リポジトリ作成ユーティリティ(RCU)を実行して、必要な新しいスキーマを作成します。 |
Service Tableスキーマ(_STB )は、すべてのドメインのための新しい必須スキーマです。11gからアップグレードする場合は、12cにアップグレードする前にこのスキーマを作成する必要があります。
SOAがドメインの一部でない場合でも、Oracle Service Busには、SOAスキーマ( 以前の12cリリースからアップグレードする場合、別のService Tableスキーマは作成しないでください。 |
必須 すべてのサーバーおよびプロセスを停止します。 |
アップグレードを開始する前に、すべてのサーバーおよびプロセスを停止する必要があります。 |
必須 Upgrade Assistantを実行して、必要なスキーマをアップグレードします。 |
以前の12cリリースからアップグレードする場合は、 |
必須
再構成ウィザードを実行して、既存のドメインを再構成します。 |
アップグレード後も既存のドメインを引き続き使用するため、新しいコンポーネントと機能するよう、それを再構成する必要があります。 |
必須 Upgrade Assistantを実行して、コンポーネント構成を構成します。 |
Upgrade Assistantをもう一度実行して、新しいドメインで機能するようコンポーネント構成を更新します。 |
必須 アップグレード後タスクをすべて実行します。 |
標準の12cアップグレード後タスクと、各自のデプロイメントに該当するOSB固有のアップグレード後タスクをすべて実行します。 |
Oracle Service Bus 12c (12.2.1.4.0)のアップグレードに関する制限事項
Oracle Service Bus 11gのトポロジが単一のドメイン内の複数のコンポーネントで構成されている場合は、12c (12.2.1.4.0)にアップグレードできません
単一OSBドメイン内でUMSを使用する複数コンポーネントのアップグレード(未サポート)
特定のFusion Middlewareコンポーネント(Oracle SOA、Oracle Service Bus (OSB)、Business Activity Monitoring (BAM)など)は、12cでは、ユーザー・メッセージング・サービス(UMS)に対する依存関係があります。単一の12c (12.2.1.4.0)ドメイン内でこれらのコンポーネントのうち複数を構成する場合は、コンポーネントが動作するサーバーが1つしかない場合でも、これらのコンポーネントは各自のクラスタ内で動作する必要があります。
このようなコンポーネントをアップグレードするには、ドメインの再構成時に、各コンポーネントに個別のクラスタを作成する必要があります(クラスタに関する項を参照)。
このようなコンポーネントに対してサポートされるアップグレード・トポロジについては、「クラスタ化トポロジのアップグレード」を参照してください。
Oracle Service Bus (OSB)のアップグレード前タスクの実行
Oracle Service Busをアップグレードする場合は、アップグレードを開始する前に、次の各タスクを実行する必要があります。独自のユース・ケースのシナリオと既存のデプロイメントを調べて、次のタスクが各自の環境に当てはまるかどうかを判断してください。
11g環境へのOracle Web Services Managerポリシー・マネージャのデプロイ
Oracle Web Services Manager (OWSM)ポリシー・マネージャがOracle Service Bus 11g環境にデプロイされていない場合は、12cにアップグレードする前に、それを手動でデプロイする必要があります。
11gでは、WebLogicのセキュリティ・ポリシーとOWSMのポリシーは、どちらもOracle Service Busでサポートされていました。11g (11.1.1.7)の時点でWebLogicセキュリティ・ポリシーは非推奨になり、12c (12.2.1.4.0)ではサポートされなくなりました。11gではWebLogicセキュリティ・ポリシーが使用可能であったため、OWSMポリシー・マネージャのデプロイメントとOWSMポリシーの使用はオプションでした。12cではOWSMポリシーのみがサポートされているため、OWSMポリシー・マネージャのデプロイメントが必須になります。
OWSMポリシー・マネージャを手動で11g環境にデプロイする方法の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWebLogic ServerでのOWSMのインストールに関する項を参照してください。
Oracle Service Busのアップグレード時のサービス、プロジェクトおよびリソースのエクスポート
Oracle Service Bus 12c (12.2.1.4.0)にアップグレードする前に、既存のサービス、プロジェクトおよびリソースを構成JARファイルにエクスポートする必要があります。アップグレード後に、このJARファイルを新しい12c環境にインポートします。
ノート:
WebLogic Serverでは、JNDI名でmyqueues/myqueue
のようにフォワード・スラッシュを使用できますが、フォワード・スラッシュのあるJNDI名は、Service Busに必要とされるURI形式と一致しないため、このような名前は使用できません。この問題を回避するには、JMS外部サーバーを定義してURIでその外部サーバーを参照します。
Oracle WebLogic Server管理コンソール・オンライン・ヘルプの外部サーバーの構成に関する項を参照してください。
リソースとサービスは、サポート対象の旧リリースから手動でエクスポートできます。「以前のリリースからのOracle Service Busリソースの移行」を参照してください。
詳細は、『Oracle Service Busでのサービスの開発』のリソースと構成のインポートおよびエクスポートに関する項を参照してください。
すべてのサービス、プロジェクトおよびリソースの削除
エクスポートの後、ユーザーが作成したすべてのサービス、プロジェクトおよびリソースを、アップグレード前に削除する必要があります。
Oracle Service Bus Consoleの使用方法の詳細は、プロジェクト、フォルダおよびリソースの削除方法に関する項を参照してください。
JDeveloperを使用したリソースの削除の詳細は、「プロジェクトまたはリソースの削除方法」を参照してください。
以前のリリースからのOracle Service Busリソースの移行
リソースとサービスは、次の各リリースから手動でエクスポートして、Oracle Service Bus 12c (12.2.1.4.0)で使用できます。
-
Oracle Service Bus 12cリリース12.1.3.0、12.2.1.0および12.2.1.1
-
Oracle Service Bus 11gリリース: 11.1.1.7.0
-
Oracle Service Bus 10.3リリース: 10.3.1および10.3.0
-
AquaLogic® Service Busリリース3.0以降
詳細は、『Oracle Service Busでのサービスの開発』のリソースと構成のインポートおよびエクスポートに関する項を参照してください。
Oracle Service Busのインストール
Oracle Universal Installerを使用して、必要な製品ディストリビューションをターゲット・システムにインストールします。Oracle Service Busは、Oracle SOA SuiteおよびBusiness Process Managementなしでインストールおよびアップグレードできますが、Oracle Service Busをアップグレードする前には、Oracle Fusion Middleware Infrastructure 12c (12.2.1.4.0)をインストールする必要があります。
ノート:
Infrastructureがアップグレードに必要な場合、他のFusion Middleware製品をインストールする前にOracle Fusion Middlewareディストリビューションを最初にインストールする必要があります。-
Oracle Service Busには、Oracle Fusion Middleware Infrastructure (Oracle WebLogic ServerおよびJRF)が必要です。
- Oracle Service BusでOracle Web Services Managerポリシーを使用する場合、Oracle WebLogicドメインの構成時にいずれかのOracle Service Busドメイン・テンプレートを選択した後、Oracle Web Services Manager拡張テンプレートを選択する必要があります。
RCUを使用した必要な12cスキーマの作成
11gからアップグレードする場合、必要な12cスキーマを作成する必要があります。リポジトリ作成ユーティリティ(RCU)を使用してカスタマイズされたスキーマを作成するか、オプションでUpgrade Assistantを使用してデフォルトのスキーマ設定を使用したスキーマを作成できます。この手順では、RCUを使用してスキーマを作成する方法について説明します。Upgrade Assistantを使用してスキーマを作成する詳細は、アップグレード手順で説明します。
ノート:
Oracle Fusion Middlewareの前の12cリリースからアップグレードする場合、これらのスキーマがすでに存在する場合には再作成する必要はありません。ドメインの既存のスキーマを特定するには、次のステップを参照してください。Oracle Fusion Middleware 11gリリースでは、SOAスキーマは必須ではなかったため、データベースなしでOracle Service Bus (OSB)を実行することもできました。ただし、12cでは、Oracle Service Bus 12c (12.2.1.4.0)を実行する前に、サポートされているデータベースを必須のSOAスキーマで構成しておく必要があります。
12cにアップグレードする前に、次のスキーマが存在している必要があります。11gからアップグレードし、現在使用しているスキーマがわからない場合、次のステップを参照して、ドメインの既存のスキーマを識別します。すでに存在する場合、これらのスキーマを再作成する必要はありません
-
サービス表スキーマ(
prefix_STB
)。このスキーマは12cで新規のものであり、ドメインベースのアップグレードに必要になります。基本的なスキーマ構成情報(スキーマ接頭辞やパスワードなど)が格納され、他のOracle Fusion Middlewareコンポーネントはドメイン作成中にこれにアクセスして使用できます。このスキーマはリポジトリ作成ユーティリティ(RCU)を実行するときに自動的に作成され、ここで他の11gスキーマに使用した既存のスキーマ所有者接頭辞を指定します。ノート:
サービス表スキーマが存在しない場合、
UPGAST-00328: スキーマ・バージョンのレジストリ表はこのデータベースに存在しません。その場合、Upgrade Assistantを実行するためにはサービス表スキーマを作成する必要があります。
というエラー・メッセージが表示されることがあります。 - SOA Infrastructureスキーマ(
prefix_SOAINFRA
)。 - Oracle User Messaging Serviceスキーマ(
prefix_UMS
)。
サーバーとプロセスの停止
Upgrade Assistantを実行してスキーマおよび構成をアップグレードする前に、すべてのプアップグレード前のプロセスと管理サーバーや管理対象サーバーを含めたすべてのサーバーを停止する必要があります。
Oracle Fusion Middleware環境は、Oracle WebLogic Serverドメイン、管理サーバー、複数の管理対象サーバー、Javaコンポーネント、Identity Managementコンポーネントなどのシステム・コンポーネント、およびメタデータのリポジトリとして使用されるデータベースで構成できます。コンポーネントは相互に依存していることがあるため、適切な順序で停止する必要があります。
ノート:
この項内の手順では、WLSTコマンドライン・ユーティリティまたはスクリプトを使用して既存のアップグレード前のサーバーおよびプロセスを停止する方法を説明します。Oracle Fusion Middleware ControlおよびOracle WebLogic Server管理コンソールを使用することもできます。管理サーバー、管理対象サーバーおよびノード・マネージャの起動と停止を参照してください。アップグレード前のFusion Middleware環境を停止するには、アップグレード前のドメインに移動し、次のステップに従います。
ステップ1: システム・コンポーネントの停止
Oracle HTTP Serverなどのシステム・コンポーネントを停止するには、stopComponent
スクリプトを使用します。
-
(UNIX)
EXISTING_DOMAIN_HOME/bin/stopComponent.sh component_name
-
(Windows)
EXISTING_DOMAIN_HOME\bin\stopComponent.cmd component_name
どの順序でもシステム・コンポーネントを停止できます。
ステップ2: 管理対象サーバーの停止
WebLogic Server管理対象サーバーを停止するには、stopManagedWebLogic
スクリプトを使用します。
-
(UNIX)
EXISTING_DOMAIN_HOME/bin/stopManagedWebLogic.sh managed_server_name admin_url
-
(Windows)
EXISTING_DOMAIN_HOME\bin\stopManagedWebLogic.cmd managed_server_name admin_url
プロンプトが表示されたらユーザー名とパスワードを入力します。
SOAサーバーおよびプロセスは、次の順番で停止してください。
-
Business Activity Monitoring (BAM)管理対象サーバー
-
Oracle Service Bus (OSB)管理対象サーバー
-
サービス指向アーキテクチャ(SOA)管理対象サーバー
-
Oracle Web Services Manager (OWSM)管理対象サーバー
ステップ3: Oracle Identity Managementコンポーネントの停止
Oracle Identity Managementのコンポーネント(Oracle Internet Directoryなど)を停止します。-
(UNIX)
EXISTING_DOMAIN_HOME/bin/stopComponent.sh component_name
-
(Windows)
EXISTING_DOMAIN_HOME\bin\stopComponent.cmd component_name
ステップ4: 管理サーバーの停止
管理サーバーを停止するときには、WebLogic Server管理コンソールおよびFusion Middleware Controlなど、管理サーバーで実行されているプロセスも停止します。
管理サーバーを停止するには、stopWebLogic
スクリプトを使用します。
-
(UNIX)
EXISTING_DOMAIN_HOME/bin/stopWebLogic.sh
-
(Windows)
EXISTING_DOMAIN_HOME\bin\stopWebLogic.cmd
プロンプトが表示されたら、管理サーバーのユーザー名、パスワードおよびURLを入力します。
ステップ5: ノード・マネージャの停止
ノード・マネージャを停止するには、それが実行されているコマンド・シェルを閉じます。
またはnodemanager.properties
の属性QuitEnabled
をtrue
に設定した後(デフォルトはfalse
です)、WLSTを使用して、ノード・マネージャに接続して停止できます。WebLogic Server WLSTコマンド・リファレンスのstopNodeManagerを参照してください。
Upgrade Assistantを使用したスキーマのアップグレード
ノート:
Service Busの場合、アップグレードする必要があるドメインのスキーマが存在する場合のみ、このステップが必要です。RCUを使用して必要なスキーマを作成し、ドメインに他のスキーマが存在しない場合、このステップをスキップして再構成ウィザード・ステップに移動できます。
Oracle Service Busスキーマはありませんが、Oracle Service Busのデータベース・スキーマのデータは、SOAINFRAスキーマに組み込まれています。そのため、Oracle Service Busをアップグレードするには、SOAINFRAスキーマをアップグレードする必要があります(存在する場合)。
- Upgrade Assistantの起動
Upgrade Assistantを実行して、製品スキーマ、ドメイン・コンポーネント構成、またはスタンドアロンのシステム・コンポーネントを12c (12.2.1.4.0)にアップグレードします。Upgrade AssistantをSYSDBA以外のユーザーとして実行し、一度に1つのドメインのアップグレードを完了することをお薦めします。 - Upgrade Assistantの使用によるSOAスキーマのアップグレード
Upgrade Assistantの各画面を通じて、製品スキーマをアップグレードします。
アップグレード・アシスタントの起動
Upgrade Assistantを実行して、製品スキーマ、ドメイン・コンポーネント構成またはスタンドアロン・システム・コンポーネントを12c (12.2.1.4.0)にアップグレードします。Upgrade AssistantをSYSDBA以外のユーザーとして実行し、一度に1つのドメインのアップグレードを完了することをお薦めします。
ノート:
Upgrade Assistantを起動する前に、Upgrade Assistantを実行しているプラットフォームにJVM文字エンコーディングがUTF-8に設定されていることを確認してください。文字エンコーディングがUTF-8に設定されていない場合、名前にUnicode文字を含むファイルをダウンロードできません。アップグレードが失敗することがあります。
oracle_common/upgrade/bin
ディレクトリに移動します。- (UNIX)
ORACLE_HOME/oracle_common/upgrade/bin
- (Windows)
ORACLE_HOME\oracle_common\upgrade\bin
- (UNIX)
- Upgrade Assistantを起動します。
- (UNIX) ./ua
- (Windows) ua.bat
ロギング・パラメータなど、コマンド・ラインで指定できるその他のパラメータの詳細は、次を参照してください。
アップグレード・アシスタントのパラメータ
アップグレード・アシスタントをコマンド・ラインから起動する際に、追加パラメータを指定できます。
表4-5 アップグレード・アシスタントのコマンドライン・パラメータ
パラメータ | 必須またはオプション | 説明 |
---|---|---|
|
準備状況チェックに必要
ノート: 準備状況チェックはスタンドアロン・インストール上で実行できません(WebLogic Serverの管理対象でありません)。 |
実際のアップグレードを実行せずにアップグレードの準備状況チェックを実行します。 スキーマおよび構成がチェックされます。
|
|
オプション |
スキーマの同時アップグレードまたはスキーマの準備状況チェックに使用可能なスレッドの数を識別します。 値は、1 - 8の正の整数である必要があります。デフォルトは4です。 |
|
サイレント・アップグレードまたはサイレント準備状況チェックに必要 |
GUIモードでのUpgrade Assistantの実行時に入力されたデータから生成されたレスポンス・ファイルに保存されている入力を使用して、Upgrade Assistantを実行します。このパラメータを使用すると、アップグレード・アシスタントはサイレント・モード(アップグレード・アシスタントの画面表示なし)で実行されます。 |
|
オプション |
調査フェーズを実行しますが、実際のアップグレードは実行しません。
|
|
オプション |
次のいずれかの属性を指定して、ロギング・レベルを設定します。
デフォルトのロギング・レベルは より多くの情報がログ記録されるよう、 |
|
オプション |
アップグレード・ログ・ファイルおよび一時ファイルのデフォルトの場所を設定します。Upgrade Assistantによってログ・ファイルおよび一時ファイルが作成される、既存の書込み可能なディレクトリを指定する必要があります。 デフォルトの場所は次のとおりです。 (UNIX)
(Windows)
|
|
オプション |
すべてのコマンドライン・オプションを表示します。 |
親トピック: Upgrade Assistantの起動
アップグレード・アシスタントを使用したSOAスキーマのアップグレード
Upgrade Assistantの各画面を通じて、製品スキーマをアップグレードします。
注意:
パージ・スクリプトまたはスケジュールされたデータベース・ジョブの実行中は、アップグレード・アシスタントを起動しないでください。
パージまたはアップグレードが完了するまで待ってから、アップグレード・プロセスを開始してください。アップグレード・アシスタントを使用してスキーマをアップグレードするときに、パージ・スクリプトまたはインスタンスのアップグレード・ジョブを実行していると、アップグレードは失敗します。
アップグレード・アシスタントを起動する必要がある場合は、「バックグラウンド制御ジョブの有効化と無効化(オプション6)」で説明しているように、パージを停止してスケジュールされたジョブを無効にしてください。
ノート:
Oracle Fusion Middleware 11gリリースでは、SOAスキーマは必須ではなかったため、データベースなしでOracle Service Bus (OSB)を実行することもできました。ただし、12cでは、Oracle Service Bus 12c (12.2.1.4.0)を実行する前に、サポートされているデータベースを必須のスキーマで構成しておく必要があります。
ドメインの再構成について
再構成ウィザードを実行して、ドメイン・コンポーネント構成を12c (12.2.1.4.0)に再構成します。
WebLogic Serverドメインを再構成すると、ドメイン内のアプリケーションに応じて、次の項目が自動的に更新されます。
-
WebLogic Serverコア・インフラストラクチャ
-
ドメイン・バージョン
ノート:
ドメイン再構成を開始する前に、次の制限事項に注意してください。
-
再構成ウィザードでは、ドメインに含まれる独自のアプリケーションは更新されません。
-
アップグレード・プロセスの間の非動的クラスタ・ドメインから動的クラスタ・ドメインへの変換はサポートされていません。
動的クラスタ機能は再構成ウィザードの実行時に使用可能ですが、Oracleでは、非動的クラスタのアップグレード後の動的クラスタの追加のみがサポートされています。アップグレード・プロセスの間に動的クラスタを追加することはできません。
-
アップグレードするインストールでOracle Access Management (OAM)が使用されない場合は、2つのファイルを編集して、再構成ウィザードが、存在しないOAMインフラストラクチャ・スキーマの更新(アップグレードが失敗する)を試みないようにする必要があります。
$DOMAIN/init-info/domain-info.xml
に次の例のような行をコメント・アウトします。<!--extention-template-ref name="Oracle Identity Navigator" version="11.1.1.3.0" location="/u01/app/oracle/product/fmw/iam111130/common/templates/applications/yourcomany.oinav_11.1.1.3.0_template.jar" symbol=""/--> <!--install-comp-ref name="oracle.idm.oinav" version="11.1.1.3.0" symbol="yourcompany.idm.oinav_11.1.1.3.0_iam111130_ORACLE_HOME" product_home="/u01/app/oracle/product/fmw/iam111130"/-->
また、同様に、
$DOMAIN/config/config.xml
に次の例のような行をコメント・アウトします。<!--app-deployment> <name>oinav#11.1.1.3.0</name> <target>AdminServer</target> <module-type>ear</module-type> <source-path>/u01/app/oracle/product/fmw/iam111130/oinav/modules/oinav.ear_11.1.1.3.0/oinav.ear</source-path> <deployment-order>500</deployment-order> <security-dd-model>DDOnly</security-dd-model> <staging-mode>nostage</staging-mode> </app-deployment-->
-
ドメインの
config.xml
ファイルのドメイン・バージョン番号は、管理サーバーのインストール済WebLogic Serverバージョンに更新されます。 -
すべてのインストール済Oracle製品の再構成テンプレートは、自動的に選択されてドメインに適用されます。これらのテンプレートは、WebLogicドメインが現在のWebLogic Serverバージョンと互換性を持つために必要な再構成タスクを定義します。
-
起動スクリプトが更新されます。
変更した起動スクリプトを保持する必要がある場合は、再構成ウィザードを開始する前にそれらをバックアップするようにしてください。
ノート:
ドメインの再構成プロセスを開始すると、行う変更を元に戻すことはできません。再構成ウィザードを実行する前に、アップグレード前チェックリストに示されているようにドメインをバックアップしてあることを確認してください。再構成ウィザードの実行中にエラーまたは他の割込みが発生した場合、バックアップ場所から元のドメイン・ディレクトリにファイルとディレクトリをコピーすることによって、ドメインをリストアする必要があります。これは、ドメインが再構成前の元の状態に戻されたことを確認する唯一の方法です。- ドメインのバックアップ
- 再構成ウィザードの起動
- 再構成ウィザードを使用したSOAドメインの再構成
Upgrade Assistantを実行する前に、再構成ウィザードを使用して、まず既存のドメインを再構成する必要があります。
ドメインのバックアップ
再構成ウィザードを実行する前に、ドメイン・ディレクトリのバックアップ・コピーを作成します。
ドメイン・ディレクトリのバックアップを作成するには:
親トピック: ドメインの再構成について
再構成ウィザードの起動
ノート:
再構成プロセスを開始する前に管理サーバーおよびすべてのコロケートされた管理対象サーバーを停止します。「サーバーとプロセスの停止」を参照再構成ウィザードをグラフィカル・モードで起動するには:
親トピック: ドメインの再構成について
再構成ウィザードを使用したSOAドメインの再構成
Upgrade Assistantを実行する前に、再構成ウィザードを使用して、まず既存のドメインを再構成する必要があります。
ノート:
ソースがクラスタ環境である場合は、再構成ウィザードをプライマリ・ノードでのみ実行します。圧縮/解凍ユーティリティを使用して、ドメイン内の他のクラスタ・メンバーに変更を適用します。親トピック: ドメインの再構成について
ドメイン・コンポーネント構成のアップグレード
ドメインを再構成した後、Upgrade Assistantを使用して、更新したドメイン構成と一致するようドメイン内のドメイン・コンポーネント構成をアップグレードします。
- Upgrade Assistantの起動
Upgrade Assistantを実行して、製品スキーマ、ドメイン・コンポーネント構成、またはスタンドアロンのシステム・コンポーネントを12c (12.2.1.4.0)にアップグレードします。Upgrade AssistantをSYSDBA以外のユーザーとして実行し、一度に1つのドメインのアップグレードを完了することをお薦めします。 - Upgrade Assistantを使用したドメイン・コンポーネントのアップグレード
Upgrade Assistantの各画面を通じて、WebLogicドメインのコンポーネント構成をアップグレードします。
アップグレード・アシスタントの起動
Upgrade Assistantを実行して、製品スキーマ、ドメイン・コンポーネント構成またはスタンドアロン・システム・コンポーネントを12c (12.2.1.4.0)にアップグレードします。Upgrade AssistantをSYSDBA以外のユーザーとして実行し、一度に1つのドメインのアップグレードを完了することをお薦めします。
ノート:
Upgrade Assistantを起動する前に、Upgrade Assistantを実行しているプラットフォームにJVM文字エンコーディングがUTF-8に設定されていることを確認してください。文字エンコーディングがUTF-8に設定されていない場合、名前にUnicode文字を含むファイルをダウンロードできません。アップグレードが失敗することがあります。
oracle_common/upgrade/bin
ディレクトリに移動します。- (UNIX)
ORACLE_HOME/oracle_common/upgrade/bin
- (Windows)
ORACLE_HOME\oracle_common\upgrade\bin
- (UNIX)
- Upgrade Assistantを起動します。
- (UNIX) ./ua
- (Windows) ua.bat
ロギング・パラメータなど、コマンド・ラインで指定できるその他のパラメータの詳細は、次を参照してください。
アップグレード・アシスタントのパラメータ
アップグレード・アシスタントをコマンド・ラインから起動する際に、追加パラメータを指定できます。
表4-6 アップグレード・アシスタントのコマンドライン・パラメータ
パラメータ | 必須またはオプション | 説明 |
---|---|---|
|
準備状況チェックに必要
ノート: 準備状況チェックはスタンドアロン・インストール上で実行できません(WebLogic Serverの管理対象でありません)。 |
実際のアップグレードを実行せずにアップグレードの準備状況チェックを実行します。 スキーマおよび構成がチェックされます。
|
|
オプション |
スキーマの同時アップグレードまたはスキーマの準備状況チェックに使用可能なスレッドの数を識別します。 値は、1 - 8の正の整数である必要があります。デフォルトは4です。 |
|
サイレント・アップグレードまたはサイレント準備状況チェックに必要 |
GUIモードでのUpgrade Assistantの実行時に入力されたデータから生成されたレスポンス・ファイルに保存されている入力を使用して、Upgrade Assistantを実行します。このパラメータを使用すると、アップグレード・アシスタントはサイレント・モード(アップグレード・アシスタントの画面表示なし)で実行されます。 |
|
オプション |
調査フェーズを実行しますが、実際のアップグレードは実行しません。
|
|
オプション |
次のいずれかの属性を指定して、ロギング・レベルを設定します。
デフォルトのロギング・レベルは より多くの情報がログ記録されるよう、 |
|
オプション |
アップグレード・ログ・ファイルおよび一時ファイルのデフォルトの場所を設定します。Upgrade Assistantによってログ・ファイルおよび一時ファイルが作成される、既存の書込み可能なディレクトリを指定する必要があります。 デフォルトの場所は次のとおりです。 (UNIX)
(Windows)
|
|
オプション |
すべてのコマンドライン・オプションを表示します。 |
親トピック: Upgrade Assistantの起動
Upgrade Assistantの使用によるドメイン・コンポーネントのアップグレード
Upgrade Assistantで複数の画面をナビゲートし、WebLogicドメイン内のコンポーネント構成をアップグレードします。
再構成ウィザードを実行してWebLogicドメインを12c (12.2.1.4.0)に再構成した後、Upgrade Assistantを実行して、更新したドメイン構成と一致するようドメイン・コンポーネント構成をアップグレードします。
親トピック: ドメイン・コンポーネント構成のアップグレード
Oracle Service Busのアップグレード後タスクの実行
アップグレードが正常に完了したら、次のタスクを1つ以上実行する必要がある場合があります。独自のユース・ケースのシナリオと既存のデプロイメントを調べて、次のタスクが各自の環境に当てはまるかどうかを判断してください。
ノート:
Oracle Service Busでアップグレード後の問題が発生した場合は、「Oracle Service Busのトラブルシューティング」で、一般的な解決策の一覧を参照してください。
WLS_OSB管理対象サーバーのOracle HTTP Serverの構成
Oracle Service BusコンソールおよびOracle Service BusサービスにOracle HTTP Serverからルーティングできるようにするため、WebLogicClusterパラメータをこのクラスタにあるノードのリストに設定します。
詳細は、『Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』のOracle Service Bus用のOracle HTTP Serverの構成に関する項を参照してください。
ドメイン構成データのインポート
アップグレード後に、「Oracle Service Busのアップグレード時のサービス、プロジェクトおよびリソースのエクスポート」でエクスポートしたドメイン構成データをインポートする必要があります。
ノート:
WebLogic Serverでは、JNDI名でmyqueues/myqueue
のようにフォワード・スラッシュを使用できますが、フォワード・スラッシュのあるJNDI名は、Service Busに必要とされるURI形式と一致しないため、このような名前は使用できません。この問題を回避するには、JMS外部サーバーを定義してURIでその外部サーバーを参照します。
Oracle WebLogic Server管理コンソール・オンライン・ヘルプの外部サーバーの構成に関する項を参照してください。
詳細は、「コンソールで構成JARファイルからリソースをインポートする方法」および構成ファイルの実行に関する項を参照してください。
セキュリティ構成のインポート
Oracle WebLogic Server管理コンソールを使用して、アップグレード前にエクスポートしたセキュリティ・データを新しいOracle Service Busドメインにインポートします。
詳細は、Oracle WebLogic Server管理コンソールのオンライン・ヘルプでセキュリティ・プロバイダへのデータのインポートに関する項を参照してください。
ノート:
セキュリティ情報は、セキュリティ・プロバイダごとに個別にインポートする必要があります。
XQueryリソースのアップグレード
Oracle Service Busでは、XQuery 1.0をサポートしています。旧XQuery 2004もサポートされます。Service Busで作成された新しいXQueryリソースは、デフォルトでXQuery 1.0を使用します。
12cより前のService Busプロジェクトからアップグレードすると、そのプロジェクト内のすべてのXQueryリソースが、XQuery 2004バージョンを使用するように構成されます。
XQuery Resourcesのアップグレードの詳細は、「XQuery 1.0を使用したXQueryリソースのアップグレード方法」を参照してください。
12cの分割-結合の理解
12cにはパイプラインまたはプロキシ・サービスから分割-結合コンポーネントを直接呼び出す方法があるため、12cではFusion Middleware 11gの分割-結合ビジネス・サービスはなくなりました。アップグレード・プロセスでは、次のようにして、静的に構成されたすべての呼び出しの参照を自動的に分割-結合ビジネス・サービスに変更します。
-
フロー・ビジネス・サービスは削除されます。つまり、フロー・ビジネス・サービス用に構成された
Timeout
プロパティも削除されます。 -
ビジネス・サービスと、それを呼び出すプロキシ・サービスが同じプロジェクトに配置されている場合は、そのプロキシ・サービスに関連付けられたパイプラインにより分割-結合が直接呼び出されます。
-
ビジネス・サービスと、それを呼び出すプロキシ・サービスが異なるプロジェクトに配置されている場合は、分割-結合を呼び出すためのローカル プロキシ・サービスが作成されます。このローカル・プロキシ・サービスは、元のプロキシ・サービスから呼び出されます。
Oracle Service Busアップグレードのトラブルシューティング
Oracle Service Busでアップグレード後の問題が発生した場合は、次の内容を確認して、関連する解決方法を適用してください。
クラスタのフロントエンド・ホストとしてOHSを使用するOSBのアップグレード後のHTTP 404エラーの解決
クラスタ・ドメインのフロントエンド・ホストとしてOracle HTTP Server (OHS)を構成する場合は、OHS構成ファイル(ohs.confg)に次のコードを追加する必要があります。
<Location /sbconsole> SetHandler weblogic-handler WebLogicCluster [ADMIN_SERVER_HOST]:[ADMIN.SERVER:PORT] </Location> <Location /servicebus> SetHandler weblogic-handler WebLogicCluster [ADMIN_SERVER_HOST]:[ADMIN.SERVER:PORT] </Location>
ADMIN.SERVER:PORT
は、OHSに使用するマシン名、サーバー名およびポート番号です。
次のサンプル・コード内のmymachine.us.mycompany.com:7001
がその例です。
<Location /sbconsole> SetHandler weblogic-handler WebLogicCluster mymachine.us.mycompany.com:7001 </Location> <Location /servicebus> SetHandler weblogic-handler WebLogicCluster mymachine.us.mycompany.com:7001 </Location>
OSBコンソールへのアクセス時のHTTP 404エラーの解決
12cより前のOSBコンソールには、URL: http://[HOST]:[PORT]/sbconsole
を使用してアクセスしていました。
12cでは、OSBコンソールのURLがhttp://[HOST]:[PORT]/servicebus
に変更されています。
アップグレード後に、http://[HOST]:[PORT]/sbconsole
と入力すると、http://[HOST]:[PORT]/servicebus
にリダイレクトされます。
リダイレクトに失敗して、HTTP 404エラーが返された場合は、12cのURL http://[HOST]:[PORT]/servicebus
を直接入力してみてください。