| Oracle® Smart Update パッチおよびメンテナンス パックのインストール リリース 3.1 B55509-01 |
|
 戻る |
 次へ |
この節では、以下のトピックを取り上げます。
クラスパス (WebLogic システム クラスパスや、WebLogic Server 上にデプロイされたアプリケーションのクラスパスなど) 内にロードされるクラスを含んだパッチをダウンロードして適用した後は、それらのクラスを適切なクラスパスに対して正しく挿入したことを確認する必要があります。挿入方法が不適切な場合はパッチが有効になりません。同様に、ライブラリ パス内に挿入されるライブラリ ファイルを含んだパッチについては、それらを使用するサーバ インスタンスやアプリケーションにおいて、ライブラリ ファイルを示すパスが正しく処理されることを確認する必要があります。
製品インストールに対するパッチ適用の際に Smart Update で使用される方法は一律ではなく、パッチの種類および内容に応じて異なります。パッチには、場合によって次の内容が収められています。
製品インストール内のリソースに対する置き換え
クラス ファイル (必要に応じてクラスロード メカニズムで使用されるクラスパスや拡張ディレクトリのファイルなど)
ライブラリ ファイル (必要に応じてライブラリ パスに含められる)
ライブラリ ファイルを含んだパッチは、対象インストール内にすでに存在するファイルを置き換えるものとは限りません。そのため、起動スクリプトによって明示的にロードする必要があります。
デプロイしてアプリケーションで参照する必要がある共有アーカイブ
モジュールと呼ばれるエンティティを更新するパッチ JAR ファイル。
パッチが BEA_HOME ディレクトリに対して適用される方法と、システム上でパッチが Smart Update により管理される方法については、以下の節を参照してください。起動スクリプトに変更を加えるかどうか、どのように変更を加えるかを判断するために、そのプロセスを理解しておく必要があります。
この節では、ドメインに適用するパッチが有効になることを確認する場合に実行する必要のある、基本的な作業についても説明します。
起動スクリプトによってロードされるクラスまたはライブラリ ファイルを含んだパッチの場合、それらのクラスやファイルは Smart Update によって、システム上にあるインストール レベルのパッチ ディレクトリに一元的に格納されます。これにより、クラスやライブラリ ファイルは、それらを使用する WebLogic Server インスタンスの起動時にロードできる状態になります。
このカテゴリに属するパッチに含まれる内容の例を次に示します。
WebLogic Server システム クラスパスにロードされるクラス ファイル
WebLogic Server 上にデプロイされたアプリケーションのクラスパスにロードされるクラス ファイル
WebLogic Server ライブラリ パスにロードされるライブラリ ファイル
|
注意 : パッチの検証および対象インストールへの適用はいつでも実行できますが、ただちに有効にならないパッチもあります。(a) クラスパスにロードされるクラス、または (b) ライブラリ パスにロードされるネイティブ ライブラリ ファイルのいずれかが含まれるパッチは、次の手順を実行するまで有効になりません。必要に応じて、適切なドメインまたはサーバの起動スクリプトに変更を加え、パッチがポイントされるようにして、対応するドメインまたはサーバを再起動します。 |
製品インストールに含まれる既存のリソースを置き換えるパッチは、適用と同時に、そのインストール全体に対して自動的に有効になります。起動スクリプトによって有効化されるのではありません。したがって、システム リソースの置き換えを含んだパッチの場合、起動スクリプトに変更を加える必要はありません。
置き換えリソースを含んだパッチの一般的な内容の例を次に示します。
Web サーバ プラグインのリソース
ソケット マルチプレクサ
ダイナミック リンク ライブラリ
|
注意 : Smart Update では、置き換えられたファイルが、インストール レベルのパッチ ディレクトリの backup サブディレクトリに格納されます。その後、置き換えが含まれるパッチを削除すると、元のリソースが backup から復元されます。(backup の詳細については、表 5-1 を参照)。ただし、最大限の安全性を確保するために、置き換えを含んだパッチを適用する前には、置き換え予定のシステム リソースすべてについて別途バックアップを作成することをお勧めします。 |
共有アーカイブのパッチは、これを必要とするアプリケーションにより明示的にデプロイし、参照する必要があります。共有アーカイブのパッチをすべてのアプリケーションではなく、選択されたアプリケーションに適用する場合は、固有のパッチ レベルごとにカスタム パッチ プロファイルを作成する必要があります。
Oracle カスタマ サポートからパッチまたはパッチ セットをダウンロードすると、パッチ ダウンロード ディレクトリにパッチ コンテナが置かれます。パッチ コンテナには次の内容が収められています。
パッチまたはパッチ セット
1 つのパッチには複数のファイルが含まれている場合があります。含まれるファイルは次のようなものです。
クラスの置き換え用として提供される同名のクラス (サーバ起動時に WebLogic システム クラスパスに挿入される)
ネイティブ ライブラリ ファイル (システム パスに挿入される)
コンフィグレーション ファイル
パッチ セットとは、複数の独立したパッチからなる集合です。各パッチにはそれぞれ固有のファイル セットが含まれます。
そのパッチ コンテナに含まれる各パッチに関するメタデータ
メタデータは、対象の製品インストールに適用されているすべてのパッチに対して各パッチを検証するために Smart Update で使用される情報です (パッチを適用すると、メタデータは、Smart Update によって管理されるシステム上のディレクトリにあるパッチ レジストリに置かれます。詳細については、「5.1.5 インストール レベルのパッチ ディレクトリの構造」を参照してください)。
パッチ プロファイルに対してパッチが適用されると、そのパッチに含まれる個々のファイルは次のように処理されます。
システム リソース (WebLogic Server プラグイン モジュールなど) に対する置き換えを含んだパッチの場合、該当する既存のリソースが、その置き換えによって自動的に更新される。
パッチ JAR ファイル (対象インストール内にある同名のクラスに対する更新ファイルとしてクラスパスにロードされるクラスのセット) を含んだパッチの場合、次の処理が実行される。
パッチ JAR ファイルが、インストール レベルのパッチ ディレクトリに配置される。このディレクトリの詳細については、「5.1.5 インストール レベルのパッチ ディレクトリの構造」を参照。
パッチ マニフェスト JAR (パッチ JAR ファイル内にあるクラスへのポインタを含んだファイル) が、Smart Update により作成される。現在のプロファイルに対するパッチ マニフェスト JAR がすでに存在する場合は、既存のパッチ マニフェスト JAR が更新され、新しいパッチ JAR ファイル内にあるクラスへのポインタが追加される。パッチ マニフェスト JAR ファイルについては、「5.1.5.1 パッチ マニフェスト JAR ファイル」の説明を参照。
環境変数 PATH または LIBPATH を介してシステム ライブラリ パスにロードされるネイティブ ライブラリ ファイルを含んだパッチの場合、次の処理が実行される。現在選択されているパッチ プロファイル専用の native というサブディレクトリの有無がチェックされる。見つからない場合は、このサブディレクトリが Smart Update によって作成される。native サブディレクトリについては、「5.4.3 起動スクリプトを開くダイアログ ボックスのアイコン」の説明を参照。
製品をインストールし、Smart Update を実行すると、パッチ ディレクトリが作成されます。各製品 (たとえば、WebLogic Server、Workshop for WebLogic、WebLogic Integration および WebLogic Portal) には、BEA_HOME ディレクトリ配下に独自のパッチ ディレクトリ構造があります (patch_wls1001、patch_wlw1020、patch_wli1020、patch_wlp1020など)。
製品固有パッチ ディレクトリ構造は、製品のパッチ メンテナンスの新しい区分を提供します。またそれによって、今後の製品が、WebLogic Server の異なる、または共通のバージョン間で相互運用する際の柔軟性も向上します。
図 5-1 に、BEA_HOME\patch_<product> ディレクトリの構造が表示されます。
表 5-1 では、各パッチ ディレクトリの内容について説明します。
表 5-1 インストール レベルのパッチ ディレクトリ内にあるディレクトリおよびファイル
| ディレクトリ | 内容 |
|---|---|
|
patch_<product>\backup |
パッチ バックアップ マニフェスト (システム上に以前のパッチ レベルを復元するために必要なファイルおよび情報を含む)。 このディレクトリは、製品インストール ディレクトリ内に配置されるファイルを含んだ、インストール全体を対象とするパッチを適用すると作成される。 |
|
patch_<product>\patch_jars |
各製品のパッチ ディレクトリに配置されているパッチ JAR ファイルには (たとえば、図 5-1 に示すように 各製品のパッチ ディレクトリの 1 つのパッチ JAR ファイルには、次のうち 1 つまたは複数の内容が含まれる。
注意 : システム リソースに対する置き換えを含むパッチ JAR ファイルは、このディレクトリ ( 注意 : 追加されるパッチ JAR ファイルの格納に十分なディスク領域があるか確認しておくことを推奨。JAR ファイルを含んだパッチのサイズに関する詳細については、「3.4 パッチ情報の表示」を参照。 |
|
patch_<product>\profiles\default |
デフォルト パッチ プロファイルのディレクトリパッチを適用すると、場合によって次のうち 1 つまたは複数のサブディレクトリが作成される。
|
|
patch_<product>\profiles\custom-profile-name |
カスタム パッチ プロファイル用のディレクトリ。カスタム パッチ プロファイルの名前がディレクトリ名となる。カスタム パッチ プロファイルが 1 つ作成されるたびに、そのプロファイルの名前を持つディレクトリが自動的に作成される。カスタム パッチ プロファイルの各ディレクトリには、次のうち 1 つまたは複数のサブディレクトリが含まれる。
|
|
patch_<product>\registry |
次の事項に関する情報が含まれる。
この情報は、パッチ検証などの処理を実行するために Smart Update 内部で使用される。 |
同名の既存クラスに取って代わるためにクラスパスに挿入されるクラスを含んだパッチは、パッチ マニフェスト JAR によって参照されます。そのようなクラスを含んだパッチをパッチ プロファイルに適用すると、対象プロファイルのパッチ マニフェスト JAR ファイルが Smart Update によって自動的に更新され、新しいパッチ内にあるクラスを参照するようになります。
たとえば、パッチに CR99004.jar という名前の JAR ファイルが含まれ、このファイルに WebLogic システムレベル クラスがある場合、そのパッチをデフォルト パッチ プロファイルに適用すると、Smart Update により次の処理が実行されます。
CR99004.jar が BEA_HOME\patch_wls1001\patch_jars ディレクトリに追加される。
次のファイルが存在しない場合、作成される。
BEA_HOME\patch_wls1001\profiles\default\sys_manifest_classpath\weblogic_patch.jar
weblogic_patch.jar 内に、CR99004.jar 内の WebLogic システム クラスを指す次の参照が追加される。
Class-Path: C:\BEA\patch_wls1001\patch_jars\CR99004.jar
BEA_HOME\patch_wls1001\registry ディレクトリ内のパッチ レジストリ情報が更新される。
対応する WebLogic Server インスタンスの起動時にシステム ライブラリ パスにロードされるネイティブ ライブラリ ファイルを含んだパッチの場合は、適用先パッチ プロファイルの native サブディレクトリにそれらのライブラリ ファイルが格納されます。
たとえば、サーバ起動時にシステム ライブラリ パスにロードされる libmuxer.so というファイルがパッチに含まれているとします。このパッチをデフォルト パッチ プロファイルに適用すると、Smart Update により次の処理が実行されます。
次のディレクトリが 存在しない場合、作成される。
BEA_HOME\patch_wls1001\profiles\default\native
次のディレクトリに libmuxer.so が配置される。
BEA_HOME\patch_wls1001\profiles\default\native
次のディレクトリ内で管理されているパッチ レジストリ情報が更新される。
BEA_HOME\patch_wls1001\registry
共通のモジュール パッチか製品固有のモジュール パッチかにかかわらず、モジュール パッチが適用された場合、Smart Update によって、BEA_HOME\patch_<product>\profiles\profileName\modules ディレクトリにパッチが追加されます。元のモジュール JAR ファイルが修正されません。適用したパッチを限定するにはこのアプローチが実装されます。
たとえば、WebLogic Event Server 用モジュール パッチが BEA_HOME BEA_HOME\wlevs20\modules\com.bea.wlevs.processor.monitor_2.0.0.0.jar に更新したクラスを含み、そのパッチがデフォルト パッチ プロファイルに適用された場合、Smart Update では次のタスクが実行されます。
次のディレクトリが 存在しない場合、作成される。
BEA_HOME\patch_wlevs20200\profiles\default\modules
BEA_HOME\patch_wlevs20200\profiles\default\modules ディレクトリに更新した com.bea.wlevs.processor.monitor_2.0.0.0.jar が追加されます。
BEA_HOME\patch_wlevs20200\registry ディレクトリのパッチ レジストリ情報が更新される。
WebLogic Event Server を起動する場合、BEA_HOME\wlevs20200\modules ディレクトリに存在している元のモジュールを使用する代わりに、BEA_HOME\patch_wlevs20200\profiles\default\modules にあるパッチを適用したモジュールを使用します。
次の条件に該当する場合は、起動スクリプトに変更を加えなくても、クラスパスおよびライブラリ パスに対するパッチがドメイン サーバの起動時に正しく取り込まれると考えられます。
実際の WebLogic ドメイン用にコンフィグレーションした Oracle Product サーバ インスタンスを起動するためにコンフィグレーション ウィザードで生成したデフォルトのスクリプトを、該当する WebLogic ドメインで使用している。
パッチの適用範囲を特定のドメインやサーバ インスタンスに限定する必要がない。
それ以外の場合は、製品サーバの起動時にパッチが適切なクラスパスやライブラリ パスに挿入されるようにするために必要な作業があります。製品にパッチを適用した環境が次の説明のいずれかに当てはまる場合に、これらの追加作業を行う必要があります。
WebLogic ドメイン内のサーバを起動するときに、デフォルトの commEnv スクリプトを呼び出さない、カスタム スクリプトを使用する。
Windows :
WL_HOME\common\bin\commEnv.cmd
UNIX :
WL_HOME/common/bin/commEnv.sh
パッチまたはパッチ セットの適用範囲を製品インストール上で動作するすべてのドメインおよびサーバとするのではなく、特定のドメインまたはサーバのみに限定する必要がある。
この節では、スクリプトの使用、および Smart Update の起動スクリプト エディタを使用した起動スクリプトの変更方法を示し、クラスパス、拡張クラスパス、およびネイティブ ライブラリ ファイルのパッチですべてのドメインとサーバをポイントするために使用できるカスタム スクリプトについて説明します。
|
注意 : Workshop for WebLogic (10.1 および以降のリリース) は、自動的にランタイム WebLogic Server パッチを有効化しません。Smart Update を使用してパッチを適用したら、Workshop IDE でのランタイム WebLogic Server に対するパッチ プロファイルも指定する必要があります。詳細については、Workshop for WebLogic のドキュメントを参照してください。 |
WebLogic Server インスタンスの起動時、パッチが確実にクラスパスまたはシステム ライブラリ パスにロードされるようにするために、該当するサーバの起動スクリプトにパッチへのポインタを追加することが必要な場合があります。以下の節では、Smart Update の動作と、場合によって起動スクリプトに加える必要がある変更内容について説明します。
WebLogic Server インスタンスが起動する際には、いくつかの起動スクリプトが実行されます。そうしたスクリプトで実行される処理の 1 つに、システムで使用されるクラスパスとライブラリ パス (WebLogic システム クラスパスなど) の定義があります。デフォルトでは、すべての WebLogic Server インスタンスで、次のいずれかのスクリプト内で設定されるクラスパスおよびライブラリ パス定義が使用されます。
Windows :
WL_HOME\common\bin\commEnv.cmd
UNIX :
WL_HOME/common/bin/commEnv.sh
commEnv スクリプトには、表 5-2 で説明する環境変数のデフォルトの定義が含まれています。デフォルトでは、それらの「パッチ パス変数」はすべての WebLogic Server インスタンスが起動する際に使用され、また、クラスパスとライブラリ パスに挿入されるパッチをポイントしています。
表 5-2 commEnv スクリプト内で定義されるパッチ パス変数
| 変数 | 設定される参照先 |
|---|---|
|
PATCH_CLASSPATH |
デフォルト パッチ プロファイル用のパッチ マニフェスト JAR ファイル ( if "%PATCH_CLASSPATH%" == "" set PATCH_CLASSPATH=%WLS_PATCH_CLASSPATH%;%WLW_PATCH_CLASSPATH% 注意 : Oracle カスタマサポートから提供されるパッチの多くは、 |
|
WEBLOGIC_EXTENSION_DIRS |
デフォルト パッチ プロファイル用の WebLogic 拡張ディレクトリ パッチ マニフェスト JAR ファイル ( if "%WEBLOGIC_EXTENSION_DIRS%" == "" set WEBLOGIC_EXTENSION_DIRS= %BEA_HOME%\patch_wls1030\profiles\default\sysext_manifest_classpath 注意 :この変数は、WebLogic Server 上にデプロイされたアプリケーションのクラスパスにロードされるパッチ JAR ファイル内にあるクラスを必要とする製品のために予約されている。デプロイされたアプリケーションに対するパッチ用のこのメカニズムは、現在、WebLogic Server 9.1 では使用されない。 |
|
PATCH_LIBPATH (UNIX のみ) |
デフォルト パッチ プロファイル用のインストール レベル ディレクトリにある
if [ "${PATCH_LIBPATH}" = "" ]; then PATCH_LIBPATH=${BEA_HOME}/patch_wls1030/profiles /default/native
|
|
PATCH_PATH (Windows のみ) |
デフォルト パッチ プロファイル用のインストール レベル パッチ ディレクトリにある native フォルダ - このフォルダには、 if "%PATCH_PATH%" == "" set PATCH_PATH=%BEA_HOME%\patch_wls1030\profiles\default\native |
commEnv スクリプト内では、表 5-2 で説明するパッチ パス変数が、システム クラスパス、ライブラリ パスなどを設定するステートメントで必要に応じて挿入されます。たとえば、commEnv スクリプト内にある次のデフォルト ステートメントでは、WebLogic システム クラスパスを設定しています。クラスパス定義の冒頭で変数 PATCH_CLASSPATH が使用されている箇所を太字で示します。
set WEBLOGIC_CLASSPATH=%PATCH_CLASSPATH%;%JAVA_HOME%\lib\tools.jar;
%WL_HOME%\server\lib\weblogic_sp.jar;%WL_HOME%\server\lib\weblogic.jar;
%WL_HOME%\server\lib\webservices.jar
サーバの起動時に commEnv スクリプトが実行されると、これらのパッチ パス変数で参照されているクラスおよびライブラリ ファイルがロードされ、classpath ステートメントまたは path ステートメント内でそれ以降に参照されている同名のクラスまたはライブラリ ファイルに取って代わります。
図 5-2 は、PATCH_CLASSPATH 環境変数を介して参照され、commEnv スクリプトによって WebLogic システム クラスパスにロードされるクラスを含んだパッチ JAR ファイルを示しています。
図 5-2 PATCH_CLASSPATH 変数によって参照されるパッチ JAR ファイルのクラス
「5.2.1.1 すべてのドメインおよびサーバで使用されるクラスパスとライブラリ パスを定義したデフォルト スクリプト」で説明するパッチ パス変数が、WebLogic Server インスタンスの起動に先立って実行されるスクリプト (startWebLogic、setDomainEnv など) の中で定義されている場合、該当するサーバ インスタンスに対してはそうした既存の定義内容が使用されます。commEnv 内の変数定義によって上書きされることはありません。
たとえば、MyTestDomain ドメインの setDomainEnv スクリプトに、MyTestDomain 内のすべての WebLogic Server インスタンスで使用する PATCH_CLASSPATH 変数の定義が含まれている場合、該当するサーバ インスタンスに対してはその定義内容が使用され、commEnv スクリプト内の PATCH_CLASSPATH よりも優先されます。したがって、起動スクリプト内にパッチ パス変数の定義を追加する際は、別の起動スクリプトを呼び出すステートメントよりも前に定義を記述する必要があります。
個々の WebLogic Server インスタンスそれぞれについて、必要なすべてのパッチを使用して起動が正しく行われるようにしてください。環境において、いずれかのパッチ パス変数を定義して WebLogic Server インスタンスを起動することが要求される場合は、次の事項を理解しておく必要があります。
製品インストール環境において各種スクリプトが実行されるデフォルトの順序。「5.2.1.4.1 起動スクリプトの実行順序」を参照。
コンフィグレーション ウィザードで作成されるデフォルト起動スクリプトに含まれている、パッチ パス変数定義用の各種プレースホルダ。「5.2.1.4.2 デフォルト スクリプト内のパッチ パス変数定義用プレースホルダ」を参照。
使用環境内にある各種の起動スクリプトが実行される順序と、起動スクリプトが呼び出される場所について理解していれば、どのスクリプトに変更を加える必要があるかを判断でき、対象サーバ インスタンスすべてに対する必要なパッチ パス変数すべてについて、確実に正しい値が代入されるようにすることができます。
WebLogic Server インスタンスを起動し、Oracle product のインストールおよび各ドメインに対して変数を設定するデフォルト スクリプトが用意されています。
それらのスクリプトは、各スクリプトの内容に応じて決まる特定の順序に従って実行されます。
次の点について、表 5-3 で説明します。
サーバ、ドメイン、および製品インストールに対して作成される各種のデフォルト スクリプト
各スクリプトの機能
スクリプトが実行される順序
表 5-3 製品インストール内の各種デフォルト スクリプト
| スクリプト | 機能 | 実行のタイミング |
|---|---|---|
|
ドメインの Windows : startManagedWebLogic.cmd UNIX : startManagedWebLogic.sh |
ドメイン内の管理対象サーバを起動する。スクリプト内で定義されるパッチ パス変数は、当該スクリプトから起動されるすべての管理対象サーバで使用される。 |
コンフィグレーションに管理対象サーバが含まれるドメイン (クラスタなど) では、このスクリプトはデフォルトで最初に実行される。 このスクリプトからは、 |
|
ドメインの Windows : startWebLogic.cmd UNIX : startWebLogic.sh |
ドメイン内の WebLogic Server インスタンスを起動する。スクリプト内で定義されるパッチ パス変数は、ドメイン サーバすべて (すでに起動しているものを除く) に対して有効になる。 たとえば、前もって実行された |
コンフィグレーションに管理対象サーバが含まれるドメインでは、このスクリプトはデフォルトで
|
|
ドメインの Windows : setDomainEnv.cmd UNIX : setDomainEnv.sh |
WebLogic Server インスタンスを起動および実行するための、ドメイン全体の環境を設定する。スクリプト内で定義されるパッチ パス変数は、ドメイン サーバすべて ( |
このスクリプトは、デフォルトで
|
|
インストール環境の Windows : commEnv.cmd UNIX : commEnv.sh |
WebLogic Server インスタンスを起動および実行するための、ドメイン全体の環境を設定する。スクリプト内で定義されるパッチ パス変数は、ドメイン サーバすべて ( |
デフォルトでは、当該インストール上で起動および実行されるサーバ用に設定を定義するために呼び出されるスクリプトとしてはこれが最後。 |
コンフィグレーション ウィザードを使用してドメインを作成すると、次に説明するとおり、パッチ パス変数定義用のプレースホルダを含んだスクリプトがそのドメイン用に作成されます。
setDomainEnv スクリプトには、次に示すコード行が含まれている (デフォルトではコメントアウト)。
@REM If you want to override the default Patch Classpath, Library Path and Path for this domain, @REM Uncomment the following lines and add a valid value for the environment variables @REM set PATCH_CLASSPATH=[myPatchClasspath] (windows) @REM set PATCH_LIBPATH=[myPatchLibpath] (windows) @REM set PATCH_PATH=[myPatchPath] (windows) @REM PATCH_CLASSPATH=[myPatchClasspath] (unix) @REM PATCH_LIBPATH=[myPatchLibpath] (unix) @REM PATCH_PATH=[myPatchPath] (unix)
これらのコメント行は、パッチ パス変数の定義内容を記述する場所がわかりやすいように、コンフィグレーション ウィザードによって用意されるものです。たとえば、MyProfile というカスタム プロファイル内のパッチ JAR ファイルをドメインでポイントする場合は、次のように PATCH_CLASSPATH 変数のプレースホルダのコメントを解除し、値を定義します。
PATCH_CLASSPATH=%BEA_HOME%\patch_wls1001\profiles\MyProfile\sys_manifest_classpath\weblogic_patch.jar
これらの変数について commEnv スクリプトにデフォルトで含まれている定義については、表 5-2 を参照してください。
パッチ パス変数定義の追加作業を支援するために、Smart Update には起動スクリプト エディタが用意されています (「5.4 起動スクリプト エディタの使用」の説明を参照)。
|
注意 : 1 つの起動スクリプト内で参照する WebLogic システムレベル クラスのパッチ マニフェスト JAR ファイルは 1 つだけにしてください。複数のファイルを参照すると、実行時に予期できない動作が生じることがあります。 |
コンフィグレーション ウィザードで作成される startWebLogic および startManagedWebLogic 起動スクリプトには、パッチ パス変数定義用のプレースホルダはない。これらのスクリプトに変数定義を追加する場合は、どの WebLogic Server インスタンスに影響が及ぶかについて十分に注意してください。
パッチ パス変数定義を追加する起動スクリプトの個数を最小限にとどめることにより、インストールされている製品のメンテナンス レベルやバージョンを変更またはアップグレードする際、起動スクリプト関連で必要となる作業量が軽減されます。
起動スクリプトでプロファイル内のクラスのパッチまたはライブラリ ファイルのパッチを参照する場合に実行が必要な固有の作業は、これらのパッチの適用範囲が、製品インストール上で実行されているすべてのドメインおよびサーバを対象としているのか、またはそのインストールの特定のドメインまたはサーバのみを対象としているのかに応じて異なります。
カスタムの起動スクリプトを使用する場合、またはパッチの範囲を特定のドメインまたはサーバに制限する必要がある場合、起動スクリプトを次のように変更する必要があります。
特定の製品インストールで動作するすべてのサーバ インスタンスに対するシステム クラスパスまたはライブラリ パスにパッチを挿入する場合、カスタム起動スクリプトを使用していれば、デフォルト パッチ プロファイルへの参照をそのスクリプトに追加する必要がある。
パッチの範囲を特定のドメインまたはサーバに制限する場合、次の 2 つの作業を行う必要がある。
製品インストール上で実行しているドメインまたはサーバにパッチを適用するためのカスタム パッチ プロファイルを作成する。
該当するドメインまたはサーバの起動スクリプト内に、作成したカスタム パッチ プロファイルへの参照を追加する。
適用したクラスパス パッチおよびライブラリ パス パッチが正しく使用されるように起動スクリプトを変更する方法については、「5.1 概要」を参照してください。以下についての説明があります。
システム クラスパスまたはライブラリ パスに動的にロードされることが必要なパッチ ファイルと、インストール全体に対して自動的に有効になるパッチとの区別
パッチ適用時に Smart Update によってパッチ ファイル コンテンツが配置されるシステム上の場所
「5.2.1 起動スクリプトに対するパッチの場所の指定について」には、コンフィグレーション ウィザードで作成されるデフォルト スクリプトに組み込まれている、クラスやライブラリのパッチを自動的にシステム クラスパスやライブラリ パスに挿入する仕組みに関する説明があります。クラスやライブラリのパッチを正しく参照するようカスタム スクリプトに変更を加える必要がある場合は、この処理を理解しておくことが重要です。
変更が必要になるのは、次のような場合です。
使用環境内でデフォルト スクリプトを使用していない場合
パッチの適用対象を特定のドメインまたはサーバ起動スクリプトに限定する必要がある場合
表 5-4 に、起動スクリプトに加える変更内容の詳細について説明します。
表 5-4 起動スクリプトの変更
| 変更に関する情報 | 参照トピック |
|---|---|
|
起動スクリプト エディタの使用 |
|
|
起動スクリプトを開く方法 |
|
|
すべてのドメインとサーバで使用するクラスパスおよびライブラリ パスのパッチを参照するために起動スクリプトに加える変更の内容 |
5.5 カスタム スクリプト経由のパッチですべてのドメインとサーバをポイントする方法 |
|
特定のドメインまたはサーバのみで使用するクラスパスおよびライブラリ パスのパッチを参照するために起動スクリプトに加える変更の内容 |
6 個々のアプリケーション、ドメイン、またはサーバへのパッチの適用 |
|
カスタム パッチ プロファイルの作成 (ドメインまたはサーバからパッチを参照するためにスクリプトを修正する前に必要) |
|
起動スクリプト エディタは Smart Update に用意されているツールです。使用環境内で目的の起動スクリプトを見つけ、スクリプト内にパッチ パス変数の定義を作成する作業を簡単に実行できます。Smart Update は、デフォルト パッチ プロファイルとカスタム パッチ プロファイルの組み合わせで表される、パッチ レベルの異なる複数の製品を使用する環境におけるスクリプトを維持されます。
|
注意 : リリース 3.1 のインタフェースは、以前のリリースのインタフェースとは異なります。ツールは同じですが、更新を適用するバージョンに応じて、以前のリリースとリリース 3.1 ではタスクが異なります。主な違いである製品のドロップダウン リストは、次の図のようになります。 |
この変更により、下部のペインに表示されるスクリプトも製品固有のものになり、対象は myCustomProfile です。スニペットは、パスのタイプごとに異なります。これらのパスには、クラスパス、拡張クラスパス、およびネイティブがあります。
SET PATCH_CLASSPATH=%BEA_HOME%\patch_wls1001\profiles\myCustomProfile\sys_manifest_classpath\weblogic_patch.jar SET WEBLOGIC_EXTENSION_DIRS=%BEA_HOME%\patch_wls1001\profiles\myCustomProfile\sysext_manifest_classpath SET PATCH_LIBPATH=%BEA_HOME%\patch_wls1001\profiles\myCustomProfile\native SET PATCH_PATH=%BEA_HOME%\patch_wls1001\profiles\myCustomProfile\native
export PATCH_CLASSPATH=${BEA_HOME}/patch_wls1001/profiles/myCustomProfile/sys_manifest_classpath/weblogic_patch.jar
export WEBLOGIC_EXTENSION_DIRS=${BEA_HOME}/patch_wls1001/profiles/myCustomProfile/sysext_manifest_classpath
export PATCH_LIBPATH=${BEA_HOME}/patch_wls1001/profiles/myCustomProfile/native
export PATCH_PATH=${BEA_HOME}/patch_wls1001/profiles/myCustomProfile/native
この手順は、WebLogic Platform 9.x、ALSB 2.5、および ALSB 2.6 用に起動スクリプト エディタを使用する方法を順を追って説明します。起動スクリプト エディタを使用するには、以下の手順を実行します。
Smart Update の [対象インストール] パネルで、対象インストールを選択します。
[パッチ｜起動スクリプト エディタ] を選択します。
[スクリプト エディタの起動] ダイアログ ボックスで次の操作を実行します。
ドメインまたはサーバから参照するパッチ プロファイルを選択します。カスタム パッチ プロファイルを使用してパッチを特定のドメインまたはサーバに適用する方法については、「メンテナンス更新の配布に関するベスト プラクティス」を参照してください。
起動スクリプトを編集する製品を選択します。「図 5-3」を参照してください。
|
注意 : Workshop for WebLogic を選択すると、使用しているドメインでは、カスタム プロファイル内に存在する可能性のある WebLogic Server パッチは自動的にダウンロードされません。 |
変更を加える起動スクリプトを開きます。
詳細については、「5.4.3 起動スクリプトを開く方法」を参照してください。
パッチ プロファイルに、適切なパッチ パス変数定義を追加します。
起動スクリプト エディタには、PATCH_CLASSPATH、WEBLOGIC_EXTENSION_DIRS、PATCH_LIBPATH、および PATCH_PATH の各変数に対して推奨される定義付きのコードが用意されています。これらの定義はすべて、前に選択したパッチ プロファイル用にカスタマイズされています。それらの定義内容は必要に応じて変更することもできます。
デフォルト パッチ プロファイル内のパッチを参照するようにスクリプトを修正する場合は、「5.5 カスタム スクリプト経由のパッチですべてのドメインとサーバをポイントする方法」の手順説明を参照してください。
カスタム パッチ プロファイル内のパッチをポイントするようにスクリプトを変更する場合、カスタム パッチ プロファイルを作成して、そのプロファイルへのポインタをドメインまたはサーバの起動スクリプトに追加する方法については、「6 個々のアプリケーション、ドメイン、またはサーバへのパッチの適用」を参照してください。
カスタム パッチ プロファイル myCustomProfile に WebLogic Server と Workshop for WebLogic の両方のパッチが含まれており、そのすべてを特定のドメインでアクティブにする場合は、スニペットのようではあるが setPatchEnv.cmd 内の宣言でモデル化されている、製品固有のトークン化されたパス宣言を含めるようにドメインの起動スクリプトを最初に編集します。
以下に例を示します。
WLS_PATCH_CLASSPATH= and WLW_PATCH_CLASSPATH=
変更前の内容は次のとおりです。
PATCH_CLASSPATH=
また、setPatchEnv.cmd に含まれているような連結文を追加する必要もあります。
set PATCH_CLASSPATH=%WLS_PATCH_CLASSPATH%;%WLW_PATCH_CLASSPATH%
この処理をパスのタイプごとに繰り返します。
起動スクリプトを保存します。
|
注意 : パッチ パス変数の定義を起動スクリプトに追加する際、別の起動スクリプトを呼び出すステートメントより前にその定義を配置するようにしてください。たとえば、setDomainEnv スクリプトにパッチ パス変数の定義を追加する場合は、commEnv スクリプトを呼び出すステートメントの前に追加します。この位置関係を守れば、追加した定義がその後呼び出される別の起動スクリプト内の定義によって上書きされることはありません。 |
起動スクリプトの変更方法は、Smart Update によって強制または制限されることはありません。ただし、コンフィグレーション ウィザードなどの標準ツールによってデフォルトで作成される起動スクリプトの内容と、ツールによって決定されるデフォルトの格納場所にはそのまま従うことをお勧めします。そうすることで、パッチ プロファイル内のパッチを参照するよう修正が必要な適切な起動スクリプトを見つけるための機能が期待どおりに動作し、Smart Update をより便利に利用できます。
[スクリプト エディタの起動] ダイアログ ボックスはウィザードではないため、次のような処理はできません。
修正が必要とされるすべての適切なスクリプトの特定。コンフィグレーション ウィザードによってデフォルトで作成される起動スクリプトを使用していれば、起動スクリプト エディタを使用して目的のスクリプトをすばやく見つけることができます。
サーバおよびドメインの起動メカニズムがカスタマイズされている場合、起動スクリプト エディタ内だけではすべての変更作業を完結できないことがあり、追加の作業手順が必要となる可能性があります。
起動スクリプトの修正。起動スクリプト エディタでは、スクリプトを表示し、スクリプトに対して推奨される追加コードも「提示」しますが、変更内容と保存場所の最終決定はユーザが行います。
起動スクリプトのバックアップ コピーの作成。
[スクリプト エディタの起動] ダイアログ ボックスで [開く] をクリックして起動スクリプトを開くと、Smart Update の [起動スクリプトを開く] ダイアログ ボックスが表示されます。このダイアログ ボックスは、ドメイン、管理対象サーバ、クラスタ、または個別のサーバについて、パッチ プロファイル内のパッチへのポインタを追加する対象の起動スクリプトを見つけるために使用します。
[スクリプト エディタの起動] ダイアログ ボックスでは、表 5-5 に示すアイコンを使用すると、変更対象の起動スクリプトを含むディレクトリに移動できます。
表 5-5 [起動スクリプトを開く] ダイアログ ボックスのアイコン
| アイコン | 意味 |
|---|---|
 |
ドメイン内の bin サブディレクトリ (変更する必要があるスクリプトがデフォルトで格納されている) の親ディレクトリ。 |
 |
スクリプト ファイルが格納されているドメイン サブディレクトリ (bin など)。サブディレクトリを開いて中のスクリプトを表示するには、このアイコンをクリックする。 |
コンフィグレーション ウィザードによってドメイン用に作成されたディレクトリ構造を使用している場合は、Smart Update により、修正が必要な起動スクリプトのあるディレクトリへと誘導されます。
修正対象となる特定の起動スクリプトを見つける場合の詳細については、以下のトピックを参照してください。
ドメインの起動スクリプトに変更を加えるには、対象ドメインの bin サブディレクトリにある setDomainEnv または startWebLogic スクリプトを選択します。図 5-4 は、Windows システムで setDomainEnv スクリプトを選択する方法を示しています。
setDomainEnv スクリプトには、PATCH_CLASSPATH、PATCH_LIBPATH、および PATCH_PATH の各変数定義のプレースホルダが含まれています。このスクリプトの変更については、「表 5-6」を参照してください。
表 5-6 スクリプトの変更
| 変更に関する情報 | 参照トピック |
|---|---|
|
|
5.2.1.4.2 デフォルト スクリプト内のパッチ パス変数定義用プレースホルダ |
|
このスクリプトをデフォルト パッチ プロファイル内のパッチをポイントするように変更する |
5.5 カスタム スクリプト経由のパッチですべてのドメインとサーバをポイントする方法 |
|
このスクリプトをカスタム パッチ プロファイル内のパッチをポイントするように変更する |
6.4 ドメインおよびサーバからカスタム パッチ プロファイルへの参照 |
ドメイン内にある管理対象サーバすべて (デフォルトではクラスタ内のサーバ全てを含む) に対する起動スクリプトに変更を加えるには、対象ドメインの bin サブディレクトリにある startManagedWebLogic スクリプトを選択します。図 5-5 は、Windows システムの場合についてその方法を示しています。
このスクリプトの変更方法については、以下の表を参照してください。
表 5-7 スクリプトの変更
| このスクリプトに対する変更に関する情報 | 参照トピック |
|---|---|
|
このスクリプトをデフォルト パッチ プロファイル内のパッチをポイントするように変更する |
5.5 カスタム スクリプト経由のパッチですべてのドメインとサーバをポイントする方法 |
|
このスクリプトをカスタム パッチ プロファイル内のパッチをポイントするように変更する |
6.4 ドメインおよびサーバからカスタム パッチ プロファイルへの参照 |
ドメイン内の特定のサーバに対する起動スクリプトに変更を加えるには、対象ドメインの bin サブディレクトリにある、対象サーバ用に固有の名前を付けた起動スクリプトを選択します。図 5-6 は、Windows システムで startWebLogicServer1 スクリプトを選択する方法を示しています。
このスクリプトの変更方法については、以下の表を参照してください。
表 5-8 起動スクリプトの変更
| このスクリプトに対する変更に関する情報 | 参照トピック |
|---|---|
|
このスクリプトをデフォルト パッチ プロファイル内のパッチをポイントするように変更する |
5.5 カスタム スクリプト経由のパッチですべてのドメインとサーバをポイントする方法 |
|
このスクリプトをカスタム パッチ プロファイル内のパッチをポイントするように変更する |
6.4 ドメインおよびサーバからカスタム パッチ プロファイルへの参照 |
クラスおよびライブラリのパッチは、実際のドメインで使用されるクラスパスおよびライブラリ パスに確実に正しくロードされるようにすることが重要です。WebLogic ドメイン内でサーバ起動や環境設定に使用している起動スクリプトから、「5.2.1.1 すべてのドメインおよびサーバで使用されるクラスパスとライブラリ パスを定義したデフォルト スクリプト」に示すとおり commEnv スクリプトの呼び出しが行われない場合は、次のようにスクリプトを修正する必要があります。
デフォルト パッチ プロファイルに適用されているクラスおよびライブラリのパッチを指し示す環境変数を定義する
それらの環境変数を次のパスに追加する
WebLogic システム クラスパス
WebLogic Server 上にデプロイされたアプリケーションで使用されるクラスパス (製品の要件に応じて追加)
ライブラリ パス
デフォルトの commEnv スクリプトのこの機能は、以下のいずれかの方法で必ず自身のスクリプトに追加します。
デフォルト パッチ プロファイル内のパッチを参照するコードを単一のスクリプトにまとめ、一元管理する方法。その一元化したスクリプトを、すべての起動スクリプトから呼び出すようにします。パッチを参照するコードのメンテナンス作業が簡略化され、環境変化に伴って発生するスクリプト変更作業の量が最小限になるため、この方法を採用することをお勧めします。
デフォルト パッチ プロファイルに適用されているパッチを参照するコードを、個々の起動スクリプト内にコピーする方法。当該コードを個々の起動スクリプト内に確実にコピーすれば、適用済みのパッチがドメイン内のすべてのサーバから参照されることを保証できます。ただし、サーバの追加やコンフィグレーションの変化が使用環境内に生じると、起動スクリプトを正しくメンテナンスする作業の内容は複雑になっていきます。
使用環境内にあるドメインおよびサーバが起動する際には、デフォルト パッチ プロファイルに適用されているパッチ JAR が WebLogic システム クラスパスに挿入される必要があります。パッチ JAR がクラスパスに確実に挿入されるようにするには、使用する起動スクリプトに、この節で説明するコードを必ず追加しなくてはなりません。
PATCH_CLASSPATH 環境変数のデフォルトの定義を追加します。以下に例を示します。
if "%PATCH_CLASSPATH%" == "" set PATCH_CLASSPATH=BEA_HOME\patch_wls1001\profiles\default\sys_manifest_classpath\weblogic_patch.jar
この定義では、個々のサーバまたはドメインがカスタム パッチ プロファイル内のパッチをポイントする必要がある場合に、そのサーバまたはドメインでこの定義をオーバーライドできます。この定義で BEA_HOME は、BEA_HOME ディレクトリ パスを表します。絶対パスを指定するか、前に定義した BEA_HOME などの環境変数を使用 (推奨) することもできます。
PATCH_CLASSPATH を、WebLogic のシステム クラスパスを設定するステートメントの先頭に追加します。以下に例を示します。
set WEBLOGIC_CLASSPATH=%PATCH_CLASSPATH%;%JAVA_HOME%\lib\tools.jar; %WL_HOME%\server\lib\weblogic_sp.jar;%WL_HOME%\server\lib\weblogic.jar; %WL_HOME%\server\lib\webservices.jar
このように定義すれば、パッチ JAR に収められたクラスが、クラスパス内でそれより後に参照されている同名の既存クラスに取って代わります。
デフォルト パッチ プロファイルに製品対応の WebLogic Server にデプロイされているアプリケーション用のパッチ JAR が含まれている場合、以下のように、WEBLOGIC_EXTENSION_DIRS 環境変数を該当するアプリケーションのパッチ JAR をポイントするように定義できます。
if "%WEBLOGIC_EXTENSION_DIRS%" == "" set WEBLOGIC_EXTENSION_DIRS=%BEA_HOME%\patch_wls1001\profiles\default\sysext_manifest_classpath
|
注意 : WEBLOGIC_EXTENSION_DIRS 変数は、パッチ JAR ファイル内のクラスを WebLogic Server にデプロイされているアプリケーションのクラスパスにロードする必要がある製品で使用するために予約されています。デプロイされたアプリケーションに対するパッチ用のこのメカニズムは、現在、WebLogic Server 9.1 では使用されていません。 |
デフォルト パッチ プロファイルに適用されたネイティブ ファイルは、使用環境内にあるどのドメインまたはサーバが起動する際にも、システム ライブラリ パスに確実に挿入される必要があります。それらのファイルが正しく挿入されるようにするには、デフォルト パッチ プロファイルに適用されたパッチを参照するスクリプトに、この節で説明するコードを追加してください。
このコードをスクリプトに追加するには、次に示す適切な手順説明に従ってください。
PATCH_LIBPATH 環境変数のデフォルトの定義を追加します。以下に例を示します。
if [ "${PATCH_LIBPATH}" = "" ]; then PATCH_LIBPATH=${BEA_HOME}/patch_wls1001/profiles/default/native
この定義では、個々のサーバまたはドメインがカスタム パッチ プロファイル内のパッチをポイントする必要がある場合に、そのサーバまたはドメインでこの定義をオーバーライドできます。この定義で BEA_HOME は、BEA_HOME ディレクトリ パスを表します。絶対パスを指定するか、前に定義した $BEA_HOME などの環境変数を使用 (推奨) することもできます。
PATCH_LIBPATH を、システムのシステム ライブラリ パスを設定するステートメントの先頭に追加します。このスクリプトを製品でサポートされているすべてのオペレーティング システムとハードウェア アーキテクチャで使用可能にするために、これらの各システムのパスを設定する個々のステートメントを指定できます。以下に例を示します。
if [ -n "${LIBPATH}" ]; then
LIBPATH=${LIBPATH}:${WL_HOME}/server/native/aix/ppc
else
LIBPATH=${WL_HOME}/server/native/aix/ppc
fi
LIBPATH=${PATCH_LIBPATH}:${LIBPATH}
export LIBPATH
これで、デフォルト パッチ プロファイル内のライブラリ ファイル パッチが、パスに後で出現する既存の同名のファイルを確実にオーバーライドするようになります。
PATCH_PATH 環境変数のデフォルトの定義を追加します。以下に例を示します。
if "%PATCH_PATH%" == "" set PATCH_PATH=%BEA_HOME%\patch_wls1001\profiles\default\native
この定義では、個々のサーバまたはドメインがカスタム パッチ プロファイル内のパッチをポイントする必要がある場合に、そのサーバまたはドメインでこの定義をオーバーライドできます。この定義で BEA_HOME は、BEA_HOME ディレクトリ パスを表します。絶対パスを指定するか、前に定義した %BEA_HOME% などの環境変数を使用 (推奨) することもできます。
変数 PATCH_PATH を、システム ライブラリ パスを設定するステートメントの先頭に追加します。このスクリプトを製品でサポートされているすべてのオペレーティング システムとハードウェア アーキテクチャで使用可能にするために、これらの各システムのパスを設定する個々のステートメントを指定できます。以下に例を示します。
if "%WL_USE_X86DLL%" == "true" set PATH=%PATCH_PATH%;%WL_HOME%\server\native\win\32;%WL_HOME%\server\bin;%JAVA_HOME%\jre\bin;%JAVA_HOME%\bin;%PATH%;%WL_HOME%\server\native\win\32\oci920_8
これで、デフォルト パッチ プロファイル内のライブラリ ファイル パッチが、パスに後で出現する既存の同名のファイルを確実にオーバーライドするようになります。
WebLogic Server (10.0 および以降のリリース) および OSGi ベースの製品 (Oracle Enterprise Repository など) は、ソフトウェアの開発と配布にモジュール化アプローチを採用しています。このようなモジュールを更新するパッチが提供されています。
|
注意 : OSGi ベースの製品は、microServices Architecture (mSA) 上に構築され、Open Services Gateway initiative (OSGi) ベースのフレームワークを使用して、モジュールまたは機能セットで提供されたサービスを管理します。 |
共通と製品固有の 2 つのモジュール タイプがあります。共通モジュールは複数の製品で共有し、製品固有モジュールは製品のみで使用します。共通モジュール用にパッチを適用しようとすると、Smart Update から警告メッセージが表示されます。すべての製品にパッチを適用する場合は、[はい] をクリックできます。それ以外の場合は、[いいえ] をクリックします。ダイアログ ボックスに表示される指示に従ってください。
WebLogic Platform の実行時インスタンスには、1 つのバージョンのモジュールだけを含めることができます。そのため、特定のモジュール バージョンが正しくパッチを適用されるようにするには、複数の製品に関連付けられているモジュールに関して、連携するすべての製品にパッチを適用する必要があります。
WebLogic Server ではモジュール パッチはクラスパスに従って追加しますが、OSGi ベースの製品ではパッチはベースのランチャーを使用してロードします。
クラスパスに従ってランタイム コンテナへ WebLogic Server ロード モジュールなどの製品クラスパスへパッチのロードの詳細については、「5.2 クラスパス、拡張クラスパス、およびネイティブ ライブラリ パッチ」を参照してください。
OSGi ベースの製品は、OSGi ベースのランチャーを通じてモジュールをランタイム コンテナにロードします。ランチャーは、必要なモジュールと実行時にロードされるモジュールの順序を決定します。また、特定の製品に対してモジュールにパッチが適用されているかどうかを決定します。モジュールにパッチが適用されていると、更新されたバージョンがロードされ、使用されます。モジュール パッチのスコープは、製品およびパッチ プロファイルに固有です。これにより、同じ BEA_HOME ディレクトリのすべての製品に対してではなく 1 つの製品だけに固有なパッチであることが確実になります。
OSGi ベースの製品インストールでは、共通のモジュール (BEA_HOME\modules) および製品固有モジュール (たとえば、BEA_HOME\wlevs20\modules) の 2 つのディレクトリが表示されます。図 5-7 にこれらのディレクトリの構造を示します。
ネイティブ バイナリとその他のアーティファクトは、「5.1.2 すべてのアプリケーション、ドメインおよびサーバに対してリソースを置き換えるパッチ」で説明しているように、すべてのアプリケーション、ドメイン、およびサーバで有効になります。
この節では、アプリケーションで共有アーカイブ パッチをデプロイおよび参照する方法について説明します。
共有アーカイブ パッチは、共有ライブラリ、特に WebLogic ライブラリ モジュールをサポートするために導入されました。製品ディレクトリにインストールされる他のアーティファクトと異なり、アプリケーションは既知の場所に依存しなくても、ディレクトリ名とバージョン参照によって共有アーカイブを使用できます。これは、共有アーカイブのデフォルト インストールが、同じ共有アーカイブのカスタム インストールによって指定されたプロファイルに置き換えられるまで、インストール全体 (またはドメイン全体) に適用されることを示しています。
Smart Update でデフォルト プロファイルまたはカスタム プロファイルに適用された後、共有アーカイブ パッチをアクティブ化するには、ユーザは影響を受けるドメインでパッチを適用するアーカイブをデプロイしてから、アーカイブを特定して参照するようにアプリケーションの記述を変更します。
共有アーカイブ パッチは、ドメイン全体 (または特定のインストールで動作中のすべてのドメイン) またはドメイン内の選択したアプリケーションに適用できます。インストール内のすべてのドメインに影響を与えるには、Smart Update 内のデフォルト プロファイルに共有アーカイブ パッチを適用します。
このトピックの詳細については、「5.8.2 共有アーカイブ パッチのデフォルト アプリケーション」を参照してください。
特定のアプリケーションにのみ影響を与えるには、カスタム プロファイルにパッチを適用し、アプリケーション記述子のアーカイブ参照を更新する必要があります。この方法により、必要に応じて、共有ライブラリを利用するアプリケーションごとに独自のパッチ プロファイルを維持できます。
このトピックの詳細については、「5.8.3 アプリケーション スコープによるカスタム プロファイルでの共有アーカイブ パッチのアクティブ化」を参照してください。
共有アーカイブ パッチを適用する場合、アーカイブ全体を置き換える (まったく新しいアーカイブをインストールする) か、(挿入によって) アーカイブの一部を更新します。
使用される操作は、パッチの作成者によって決まります。不明な場合は、Oracle サポートにお問い合わせください。
Smart Update で共有アーカイブ パッチをデフォルト プロファイルに適用する場合、パッチ管理システムでは、インストール全体に適用可能なパッチとして扱われます。したがって、共有アーカイブ パッチをデフォルト プロファイルに適用すると、そのパッチはすべてのカスタム プロファイル (ある場合) にも適用されます。Smart Update では、パッチが製品インストール全体に適用されるという警告が表示されます。[続行] をクリックすると、パッチがすべてのプロファイルに適用されます。
パッチを適用した共有アーカイブが実際に書き込まれる場所は、通常は製品の共有ライブラリ ディレクトリを基準とします。アーカイブのデプロイ方法によって、この情報が必要になる場合もあります。
共有ライブラリは、次の場所にあります。
WL_HOME/common/deployable-libraries
WL_HOME/portal/lib/modules
WL_HOME/servicebus/lib
WL_HOME/integration/common/lib/installation
通常、ポータル共有アーカイブ パッチは、上記の共通ディレクトリおよびポータル共有ライブラリ ディレクトリの maintenance/default にインストールされます。他の製品では、別のデフォルト パッチ ディレクトリ構造が作成される場合もあります。特定のパッチに関する詳細なガイダンスが必要な場合は、Oracle サポートにお問い合わせください。
パッチが既存のアーカイブを置き換えて、すでにデプロイされている場合、サーバを再起動する必要があります。パッチに新しいバージョンがある場合、または別のディレクトリにインストールされる場合、パッチを適用したアーカイブをデプロイする必要があります。デプロイメントを実行するには、WebLogic Server コンソールまたはカスタム WLST スクリプトを使用するか、対象ドメインの config.xml を直接更新します。
パッチを適用したアーカイブのデプロイメントが正常に完了すると、アーカイブの名前、仕様、バージョン番号などが WebLogic Server Administration Console に表示されます。
ライブラリ モジュール マニフェストを変更しない場合、ライブラリ モジュールへの参照もすべて変更されず、ドメイン内のすべてのアプリケーションは、アプリケーション記述子を手動でさらにコンフィグレーションしなくても、新しい機能をただちに利用できるようになります。
パッチを一定のレベルで管理して、選択したアプリケーションに適用することがあります。このような場合に共有アーカイブ パッチを適用するには、カスタム プロファイルを作成し、そのカスタム プロファイルにのみ共有アーカイブ パッチを適用します。
共有ライブラリ パッチのバージョンを区別し、1 つのドメイン内で複数のバージョンの共有ライブラリが共存できるようにするには、固有の名前または固有の実装バージョン (あるいはその両方) でバージョンを区別します。
Smart Update のカスタム プロファイルに共有アーカイブ パッチを適用したあと、2 つの手順を実行して、パッチを適用するアプリケーションに対してパッチをアクティブ化する必要があります。
カスタム プロファイルでパッチをデプロイします。
パッチを適用したアーカイブの特定のバージョンを参照するように、アプリケーション記述子を更新します。
カスタム プロファイルで共有アーカイブ パッチをデプロイする手順は、パッチが次のディレクトリにあるという点を除いて、デフォルト プロファイルで共有アーカイブ パッチをデプロイする手順と同じです。
BEA_HOME/patch_weblogic[version]/profile/custom-profile-name/archives
次に例を示します。BEA_HOME/patch_wls1001/profile/customProfile
アプリケーション適用範囲のパッチのさまざまな例をサポートするために、パッチのインストール時に固有の名前またはバージョン (あるいはその両方) を強制するように作成されている場合、共有アーカイブ パッチをコンフィグレーションできます。Smart Update では、パッチがカスタム プロファイルに適用された場合にこれを検出し、そのときにアーカイブ マニフェストでアーカイブの拡張子名または実装バージョン (あるいはその両方) を変更します。
意の名前を強制するようにパッチが作成されている場合、パッチ インストール プロセスにより、マニフェスト拡張子名に文字列「-patch_custom-profile-name」が追加されます。
一意の実装バージョンを強制するようにパッチが作成されている場合、パッチ インストール プロセスにより、バージョンの末尾の数字がデクリメントされ、数字「N」が追加されます。「N」は、patch-registry.xml で定義されているパッチ プロファイル ID です。たとえば、実装バージョン 9.2.0.1 は 9.2.0.0.1 になります。
通常、アプリケーション記述子 (WAR の場合 weblogic.xml、EAR の場合 weblogic-application.xml) には特定のバージョンは不要です。その場合、最新 (最大値) バージョンが検索されます。特定のバージョンの共有ライブラリを参照するには、<exact-match を true に設定する必要があります。
9.2.0.0.1 共有アーカイブ パッチについて、weblogic-application.xml のセクションの例を次に示します。<exact-match が true に設定されています。
<weblogic-application xmlns="http://www.bea.com/ns/weblogic/90" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <library-ref> <library-name>wlp-tools-admin-app-lib</library-name> <specification-version> 9.2.0 </specification-version> implementation-version> 9.2.0.0.1 </implementation-version> <exact-match> true </exact-match> </library-ref> </weblogic-application>
