メンテナンス更新ファイルおよび Service Pack のインストール
commEnv スクリプトを呼び出していない
WL_HOME\common\bin\commEnv.cmd
WL_HOME/common/bin/commEnv.sh
(1) 必要に応じて、適切なドメインまたはサーバ起動スクリプトに変更を加え、パッチが参照されるようにする。
(2) 該当するドメインまたはサーバを再起動する。
backup サブディレクトリに保管されます。置き換えを含んだパッチを後で削除すると、元のリソースが backup から復元されます (backup の詳細については、表 5-1 を参照)。ただし、最大限の安全性を確保するために、置き換えを含んだパッチを適用する前には、置き換え予定のシステム リソースすべてについて別途バックアップを作成することをお勧めします。
PATH または LIBPATH を介してシステム ライブラリ パスにロードされるネイティブ ライブラリ ファイルを含んだパッチの場合、次の処理が実行されます。
native というサブディレクトリの有無がチェックされる。見つからない場合は、このサブディレクトリが Smart Update によって作成される。native サブディレクトリについては、表 5-1 の説明を参照。
native サブディレクトリにコピーされる。
BEA_HOME\patch_weblogic910 が作成されます。このディレクトリの構造を 図 5-1 に示し、ディレクトリの内容を 表 5-1 で説明します。
|
|
|
|
backup
|
|
|
patch_jars
|
patch_jars) には格納されない。
|
|
profiles
|
profiles\default - デフォルト パッチ プロファイル用のディレクトリ。パッチを適用すると、場合によって次のうち 1 つまたは複数のサブディレクトリが作成される。
profiles\custom-profile-name - カスタム パッチ プロファイル用のディレクトリ。カスタム パッチ プロファイルの名前がディレクトリ名となる。カスタム パッチ プロファイルが 1 つ作成されるたびに、そのプロファイルの名前を持つディレクトリが自動的に作成される。カスタム パッチ プロファイルの各ディレクトリには、次のうち 1 つまたは複数のサブディレクトリが含まれる。
|
|
registry
|
|
CR99004.jar という JAR ファイルが含まれ、この JAR ファイルには WebLogic システムレベル クラスが収められているとします。このパッチをデフォルト パッチ プロファイルに適用すると、Smart Update により次の処理が実行されます。
CR99004.jar が、BEA_HOME\patch_weblogic910\patch_jars ディレクトリに追加される。
BEA_HOME\patch_weblogic910\profiles\default\sys_manifest_classpath\weblogic_patch.jar
weblogic_patch.jar 内に、CR99004.jar 内の WebLogic システム クラスを指す次の参照が追加される。 Class-Path: C:\bea\patch_weblogic910\patch_jars\CR99004.jar
BEA_HOME\patch_weblogic910\registry ディレクトリ内のパッチ レジストリ情報が更新される。
native サブディレクトリにそれらのライブラリ ファイルが格納されます。
libmuxer.so というファイルがパッチに含まれているとします。このパッチをデフォルト パッチ プロファイルに適用すると、Smart Update により次の処理が実行されます。
BEA_HOME\patch_weblogic910\profiles\default\native
libmuxer.so が格納される。 BEA_HOME\patch_weblogic910\profiles\default\native
BEA_HOME\patch_weblogic910\registry
WL_HOME\common\bin\commEnv.cmd
WL_HOME/common/bin/commEnv.sh
commEnv スクリプトには、表 5-2 で説明する環境変数のデフォルトの定義が含まれています。デフォルトでは、それらの「パッチ パス変数」はすべての WebLogic Server インスタンスが起動する際に使用され、また、クラスパスとライブラリ パスに挿入されるパッチを指しています。
|
|
|
|
PATCH_CLASSPATH
|
weblogic_patch.jar) - この JAR ファイルには、WebLogic システム クラスパスにロードされるパッチ JAR ファイル内にあるクラスへの参照が含まれる。たとえば、Windows の場合、commEnv スクリプトのデフォルトの定義は次のとおり。
if "%PATCH_CLASSPATH%" == "" set PATCH_CLASSPATH=
%BEA_HOME%\patch_weblogic910\profiles\default
\sys_manifest_classpath\weblogic_patch.jar
PATCH_CLASSPATH で参照される WebLogic システム クラスパス パッチである。
|
|
WEBLOGIC_EXTENSION_DIRS
|
weblogic_ext_patch.jar) - このファイルには、WebLogic Server 上にデプロイされたアプリケーションのクラスパスにロードされるパッチ JAR ファイル内にあるクラスへの参照が含まれる。たとえば、Windows の場合、commEnv スクリプトのデフォルトの定義は次のとおり。
if "%WEBLOGIC_EXTENSION_DIRS%" == "" set WEBLOGIC_EXTENSION_DIRS=
%BEA_HOME%\patch_weblogic901\profiles\default
\sysext_manifest_classpath
|
|
PATCH_LIBPATH
(UNIX の場合のみ)
|
native フォルダ - このフォルダには、LIBPATH 環境変数を介してシステム ライブラリ パスにロードされるファイルが格納される。たとえば、UNIX の場合、commEnv スクリプトのデフォルトの定義は次のとおり。
if [ "${PATCH_LIBPATH}" = "" ]; then
PATCH_LIBPATH=${BEA_HOME}/patch_weblogic901/profiles
/default/native
fi
|
|
PATCH_PATH
(Windows の場合のみ)
|
native フォルダ - このフォルダには、PATH 環境変数を介してシステム パスにロードされるファイルが格納される。たとえば、Windows の場合、commEnv スクリプトのデフォルトの定義は次のとおり。
if "%PATCH_PATH%" == ""
set PATCH_PATH=%BEA_HOME%\patch_weblogic910\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 ステートメント内でそれ以降に参照されている同名のクラスまたはライブラリ ファイルに取って代わります。
PATCH_CLASSPATH 環境変数を介して参照され、commEnv スクリプトによって WebLogic システム クラスパスにロードされるクラスを含んだパッチ JAR ファイルを示しています。
startWebLogic、setDomainEnv など) の中で定義されている場合、該当するサーバ インスタンスに対してはそうした既存の定義内容が使用されます。commEnv 内の変数定義によって上書きされることはありません。
setDomainEnv スクリプトに、MyTestDomain 内のすべての WebLogic Server インスタンスで使用する PATCH_CLASSPATH 変数の定義が含まれている場合、該当するサーバ インスタンスに対してはその定義内容が使用され、commEnv スクリプト内の PATCH_CLASSPATH よりも優先されます。したがって、起動スクリプト内にパッチ パス変数の定義を追加する際は、別の起動スクリプトを呼び出すステートメントよりも前に定義を記述する必要があります。
|
|
|
|
|
bin ディレクトリ内にあるスクリプト :
startManagedWebLogic.cmd
startManagedWebLogic.sh
|
|
startWebLogic スクリプトが呼び出される。
|
|
bin ディレクトリ内にあるスクリプト :
startWebLogic.cmd
startWebLogic.sh
|
startManagedWebLogic スクリプトに管理対象サーバ用のパッチ パス定義が含まれている場合、startWebLogic スクリプト内のパッチ パス変数定義は、startManagedWebLogic スクリプトで起動される管理対象サーバに対しては有効にならない。
|
startManagedWebLogic スクリプトから呼び出される。
startWebLogic スクリプトからは、setDomainEnv スクリプトが呼び出される。
|
|
bin ディレクトリ内にあるスクリプト :
setDomainEnv.cmd
setDomainEnv.sh
|
startManagedWebLogic、startWebLogic などサーバ固有のスクリプトから起動されるものを除く) に対して有効になる。
|
startWebLogic スクリプトから呼び出される。
setDomainEnv スクリプトには、commEnv スクリプト (そのドメインについてサーバ起動スクリプトや setDomainEnv スクリプトで定義されない設定を定義) の呼び出しが含まれている。
|
|
WL_HOME\common\bin ディレクトリ内にあるスクリプト :
commEnv.cmd
commEnv.sh
|
startManagedWebLogic、startWebLogic などサーバ固有のスクリプトから起動されるものを除く) に対して有効になる。
|
|
setDomainEnv スクリプトには、次に示すコード行が含まれています (デフォルトではコメントアウト)。@REM このドメインのデフォルトのパッチ クラスパス、ライブラリ パス
およびパスを上書きするには、
@REM 次のコード行のコメントを解除し、環境変数に対して有効な値を
指定してください
@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)
PATCH_CLASSPATH 変数のプレースホルダのコメントを解除し、値を定義します。
PATCH_CLASSPATH=%BEA_HOME%\patch_weblogic910\profiles\MyProfile\sys_manifest_classpath\weblogic_patch.jar
commEnv スクリプトにデフォルトで含まれている定義については、表 5-2 を参照してください。
startWebLogic および startManagedWebLogic 起動スクリプトには、パッチ パス変数定義用のプレースホルダはありません。これらのスクリプトに変数定義を追加する場合は、どの WebLogic Server インスタンスに影響が及ぶかについて十分に注意してください。
PATCH_CLASSPATH、WEBLOGIC_EXTENSION_DIRS、PATCH_LIBPATH、PATCH_PATH の各変数に対して、以前に選択したパッチ プロファイル用にカスタマイズされた定義内容の候補が起動スクリプト エディタによって示されます。それらの定義内容は必要に応じて変更することもできます。
setDomainEnv スクリプトにパッチ パス変数の定義を追加する場合、commEnv スクリプトを呼び出すステートメントよりも前に追加してください。この位置関係を守れば、追加した定義がその後呼び出される別の起動スクリプト内の定義によって上書きされることはありません。
|
|
|
|
|
bin サブディレクトリ (修正対象のスクリプトがあるデフォルトの格納場所) の親ディレクトリ。
|
|
|
bin など)。サブディレクトリを開いて中のスクリプトを表示するには、このアイコンをクリックする。
|
bin サブディレクトリにある setDomainEnv または startWebLogic スクリプトを選択します。図 5-3 は、Windows システムで setDomainEnv スクリプトを選択する方法を示しています。
![[Select Start Script] ダイアログ ボックスでの setDomainEnv スクリプトの選択](wwimages/selectDomain.gif "[Select Start Script] ダイアログ ボックスでの setDomainEnv スクリプトの選択")
setDomainEnv スクリプト内には、PATCH_CLASSPATH、PATCH_LIBPATH、PATCH_PATH 各変数の定義用プレースホルダがあります。このスクリプトに対する修正の詳細については、次の表を参照してください。
bin サブディレクトリにある startManagedWebLogic スクリプトを選択します。図 5-4 は、Windows システムの場合についてその方法を示しています。
![[Select Start Script] ダイアログ ボックスでの startManagedWebLogic スクリプトの選択](wwimages/selectMS.gif "[Select Start Script] ダイアログ ボックスでの startManagedWebLogic スクリプトの選択")
bin サブディレクトリにある、対象サーバ用に固有の名前を付けた起動スクリプトを選択します。図 5-5 は、Windows システムで startWebLogicServer1 スクリプトを選択する方法を示しています。
![[Select Start Script] ダイアログ ボックスでのサーバ起動スクリプトの選択](wwimages/selectServer.gif "[Select Start Script] ダイアログ ボックスでのサーバ起動スクリプトの選択")
commEnv スクリプトの呼び出しが行われない場合は、次のようにスクリプトを修正する必要があります。
commEnv スクリプトに組み込まれているこの機能を、確実にカスタム スクリプトに追加してください。
PATCH_CLASSPATH 環境変数のデフォルトの定義を追加します。次に例を示します。 if "%PATCH_CLASSPATH%" == "" set PATCH_CLASSPATH=BEA_HOME\patch_weblogic910\profiles\default\sys_manifest_classpath\weblogic_patch.jar
BEA_HOME は、BEA ホーム ディレクトリのパスを表します。この定義には絶対パスを指定することも、事前に定義した BEA_HOME などの環境変数を使用する (推奨) こともできます。
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
WEBLOGIC_EXTENSION_DIRS 環境変数を定義することで当該アプリケーション用のパッチ JAR を参照します。
if "%WEBLOGIC_EXTENSION_DIRS%" == "" set WEBLOGIC_EXTENSION_DIRS=%BEA_HOME%\patch_weblogic910\profiles\default\sysext_manifest_classpath
WEBLOGIC_EXTENSION_DIRS 変数は、WebLogic Server 上にデプロイされたアプリケーションのクラスパスにロードされるパッチ JAR ファイル内にあるクラスを必要とする BEA Products のために予約されています。デプロイされたアプリケーションに対するパッチ用のこのメカニズムは、現在、WebLogic Server 9.1 では使用されていません。
PATCH_CLASSPATH 環境変数のデフォルトの定義を追加します。次に例を示します。 if [ "${PATCH_LIBPATH}" = "" ]; then
PATCH_LIBPATH=${BEA_HOME}/patch_weblogic910/profiles/default/native
fi
BEA_HOME は、BEA ホーム ディレクトリのパスを表します。この定義には絶対パスを指定することも、事前に定義した $BEA_HOME などの環境変数を使用する (推奨) こともできます。
PATCH_LIBPATH を追加します。このスクリプトを、BEA Products のサポート対象となっているすべてのオペレーティング システムおよびハードウェア アーキテクチャで使用できるようにするには、パスを設定するステートメントを各システムごとに個別に用意します。次に例を示します。 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_weblogic910\profiles\default\native
BEA_HOME は、BEA ホーム ディレクトリのパスを表します。この定義には絶対パスを指定することも、事前に定義した %BEA_HOME% などの環境変数を使用する (推奨) こともできます。
PATCH_PATH を追加します。このスクリプトを、BEA Products のサポート対象となっているすべてのオペレーティング システムおよびハードウェア アーキテクチャで使用できるようにするには、パスを設定するステートメントを各システムごとに個別に用意します。次に例を示します。 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
