メンテナンス更新ファイルおよび Service Pack のインストール
Smart Update クイック リファレンス
この節の内容は以下のクイックリファレンス エイドです。クイックリファレンス エイドには、基本的な 2 つの作業に関する手順説明と、グラフィカル インタフェースで使用されるアイコンおよびラベルの説明が含まれています。
プライベート パッチをダウンロードおよび適用するには
この節は、BEA カスタマサポートから提供されたプライベート パッチを取得および適用するための手順を説明するクイックリファレンス エイドです。
プライベート パッチを取得してインストールするには、次の手順を実行します。
Windows :
[スタート] メニューから、[スタート|プログラム|BEA Products|Smart Update] を選択する。
UNIX :
BEA_HOME/utils/bsu
ディレクトリに移動する。
Smart Update のメイン ウィンドウにある [Target Installation] パネルで、ダウンロードするプライベート パッチの適用対象となる BEA Products インストールを選択します。
[Patches|Retrieve Private...] を選択し、パッチ ID とパスコードを入力して、[Download] をクリックします。
パッチ間の衝突をダウンロード前にチェックするかどうか確認を求められたら、[No, continue with the download and check for conflicts later] をクリックし、[OK] をクリックします。
[Manage Patches] タブを選択します。
[Downloaded Patches] パネルで、ダウンロードしたプライベート パッチの横に表示されている [Apply] ボタンをクリックします。
パッチを適用する際には、適用するパッチと、すでに対象インストールに適用されている他のパッチとの間で衝突が発生するかどうかが検証されます。衝突が検出されなかった場合、Smart Update には次のダイアログ ボックスが表示されます。[OK] をクリックします。
メンテナンス スナップショットを作成するには
Smart Update には、BEA カスタマサポートに問題を報告する際に送付するための、BEA Products インストールに関する情報をキャプチャするメカニズムが用意されています。この情報はメンテナンス スナップショットと呼ばれています。この節では、メンテナンス スナップショットを作成するための手順を説明します。
メンテナンス スナップショットを作成するには、次の手順を実行します。
Windows :
[スタート] メニューから、[スタート|プログラム|BEA Products|Smart Update] を選択する。
UNIX :
BEA_HOME/utils/bsu
ディレクトリに移動する。
注意 : メンテナンス スナップショットは、BEA カスタマサポートにログインしていなくても作成できます。
Smart Update のメイン ウィンドウにある [Target Installation] パネルで、報告する問題が発生した BEA Products インストールを選択します。
[Manage Patches] タブで、パッチ プロファイルを選択します。
[Patches|Patch Profiles...|Save Snapshot...] を選択します。
[Save Snapshot] ダイアログ ボックスで、メンテナンス スナップショットのファイル名を入力し、[OK] をクリックします。
メンテナンス スナップショットは、単純な ASCII テキスト ファイルです。
BEA カスタマサポートに、メンテナンス スナップショットを送付します。電子メールで送信することをお勧めしますが、必要な場合は、印刷したファイルを郵送してもかまいません。
カスタム パッチ プロファイルを作成するには
クラスパスまたはライブラリ パスのパッチの適用範囲を特定のドメインまたはサーバ インスタンスに限定する場合は、次の作業を実行する必要があります。
カスタム パッチ プロファイルを作成し、そのプロファイルにパッチを適用します。
該当するドメインまたはサーバの起動スクリプトを修正し、作成したカスタム パッチ プロファイルへの参照を追加します。
この節は、これらの作業を実行する手順について説明するクイックリファレンス エイドです。例として、パッチをプロダクション用ドメインに組み込む前に、テスト エンジニアが品質検査用ドメインを使用してパッチをテストする場合の作業内容を示します。
カスタム パッチ プロファイルを作成し、そのプロファイルに適用したパッチが特定のドメインまたはサーバから参照されるようにするには、次の手順を実行します。
Smart Update を起動して、BEA カスタマサポートにログインし、作業対象の BEA Products を [Target Installation] パネルから選択します。
目的のパッチを BEA カスタマサポートからダウンロードし、指定したパッチ ダウンロード ディレクトリに格納します。
次の手順に従って、パッチの適用先となるカスタム パッチ プロファイルを作成します。
[Patches|Patch Profiles|New] を選択します。
カスタム パッチ プロファイルに名前を付けます。次に、対象インストールの既存のパッチ プロファイルから内容のクローンを作成することにより、新しいカスタム パッチ プロファイルに最初から含まれるパッチのセットを指定します。
例 : 品質検査用ドメインは、プロダクション用ドメインと同じパッチ メンテナンス レベルに、手順 2 でダウンロードしたパッチを追加した状態で実行する必要があります。そこで、テスト エンジニアは QADomainProfile というカスタム パッチ プロファイルを作成し、デフォルト パッチ プロファイルの内容のクローンを作成して QADomainProfile に設定します。このカスタム パッチ プロファイルが、ダウンロードしたパッチの適用先となります。
インストール全体に対して有効になるパッチがすでに対象インストールに適用されている場合、それらのパッチは、新しいカスタム パッチ プロファイルにもデフォルトで含まれます。
[Create] をクリックすると、デフォルト パッチ プロファイルのタブの横に、新しいカスタム パッチ プロファイルが表示されます。
カスタム パッチ プロファイルに対し、必要に応じてパッチの適用または削除を実行します。
例 : テスト エンジニアは、手順 2 でダウンロードしたパッチを、カスタム パッチ プロファイル QADomainProfile に適用します。
起動スクリプト エディタを実行する前に、変更を加える予定のすべてのスクリプトについてバックアップを作成します。
カスタム パッチ プロファイル内のパッチを参照するように起動スクリプトを修正するために、起動スクリプト エディタを実行します。
[Start Script Editor] ダイアログ ボックスで、作成したカスタム パッチ プロファイルを選択し、[Open] をクリックして起動スクリプトを開きます。
目的のドメイン、クラスタ、またはサーバの実行時にカスタム パッチ プロファイル内のパッチが使用されるようにするために、適切な起動スクリプトを開きます。次の表で、domain_home
はドメインのルート ディレクトリを表します。
カスタム パッチ プロファイルに適用されたパッチを使用する対象
|
開くスクリプト
|
ドメイン
|
Windows :
domain_home \bin\setDomainEnv.cmd
UNIX :
domain_home /bin/setDomainEnv.sh
|
ドメイン内にあるすべての WebLogic Server インスタンス
|
Windows :
domain_home \bin\startWebLogic.cmd
UNIX :
domain_home /bin/startWebLogic.sh
|
すべての管理対象サーバ
|
Windows :
domain_home \bin\startManagedWebLogic.cmd
UNIX :
domain_home /bin/startManagedWebLogic.sh
|
単一のサーバ インスタンス
|
Windows :
domain_home \bin\start ServerName .cmd
UNIX :
domain_home /bin/start ServerName .sh
|
例 : テスト エンジニアは、品質検査用ドメインでカスタム パッチ プロファイルを参照する必要があるので、そのドメイン内にあるすべてのサーバのみに対して環境を設定する setDomainEnv.cmd
スクリプトを開きます。パッチの適用対象を特定のサーバ インスタンスのみに限定する必要がない限り、通常、カスタム パッチ プロファイルへの参照は setDomainEnv
に設定することをお勧めします。
該当する起動スクリプトの中で、目的のカスタム パッチ プロファイルに含まれるクラスパスまたはライブラリ パスのパッチを参照する環境変数を作成します。
参照するパッチ
|
カスタム パッチ プロファイル内のパッチを参照するために定義する環境変数
|
WebLogic システム クラスパスに挿入されるクラスを含んだパッチ JAR
|
定義する環境変数
PATCH_CLASSPATH
例 :
set PATCH_CLASSPATH= %BEA_HOME%\patch_weblogic910\profiles\NewProfile \sys_manifest_classpath\weblogic_patch.jar
|
WebLogic Server 上にデプロイされたアプリケーションのクラスパスに挿入されるクラスを含んだパッチ JAR
|
定義する環境変数
WEBLOGIC_EXTENSION_DIRS
例 :
set WEBLOGIC_EXTENSION_DIRS= %BEA_HOME%\patch_weblogic910\profiles\NewProfile \sysext_manifest_classpath
|
システム ライブラリ パスに挿入されるネイティブ ファイル (UNIX)
|
定義する環境変数
PATCH_LIBPATH
例 :
PATCH_LIBPATH="${BEA_HOME}/patch_weblogic910/profiles /NewProfile/native"
|
システム ライブラリ パスに挿入されるネイティブ ファイル (Windows)
|
定義する環境変数
PATCH_PATH
例 :
set PATCH_PATH= %BEA_HOME%\patch_weblogic910\profiles\default\native
|
例 : 品質検査用ドメインでテストするパッチは、WebLogic システム クラスパスの先頭に挿入されるパッチ JAR に収められているものとします。この場合、ドメインでカスタム パッチ プロファイルを参照するために定義するパッチ パス変数は PATCH_CLASSPATH
です。
テスト エンジニアは、setDomainEnv.cmd
スクリプト内にある次の行を見つけます。
@REM set PATCH_CLASSPATH=[myPatchClasspath] (windows)
この行を、起動スクリプト エディタの下部パネル内に生成された次のコードで置き換えます。
SET PATCH_CLASSPATH=%BEA_HOME%\patch_weblogic910\profiles\QADomainProfile\sys_manifest_classpath\weblogic_patch.jar
テスト エンジニアが setDomainEnv.cmd
スクリプトに加えた変更の例を次に示します。
起動スクリプトに追加したパッチ パス変数は、その他の環境スクリプトに対する呼び出しよりも前に記述されている必要があります。たとえば、setDomainEnv
スクリプトにパッチ パス変数の定義を追加する場合は、必ず commEnv
スクリプトの呼び出しよりも前に追加してください。
カスタム スクリプトを使用している環境で、WL_HOME
\common\bin\commEnv
スクリプトまたはコンフィグレーション ウィザードで作成される他のデフォルト スクリプトへの呼び出しがカスタム スクリプトに含まれない場合は、スクリプト内でその環境のクラスパスまたはライブラリ パスを設定するステートメントもあわせて修正し、定義した環境変数がステートメント内で正しく挿入されるようにする必要があります。
たとえば、WebLogic システム クラスパス内で、パッチ JAR がそれ以降に参照される同名のクラスに取って代わるようにするには、次に示す太字の位置に 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
パッチを有効にするには、そのパッチを使用するすべてのサーバ インスタンスを再起動する必要があります。
後になってパッチの適用範囲を変更する必要が生じ、そのパッチが別のドメインやサーバで使用されるようにする場合や、1 つのインストール上で動作するすべてのサーバおよびドメインで使用されるようにする場合は、適切なパッチ プロファイルを更新します。
例 : テスト エンジニアによる品質検査用ドメインでのテストに合格したパッチは、プロモートされてプロダクション用ドメインで使用されます。パッチをプロモートするために、テスト エンジニアは次の作業を実行します。
Smart Update を実行し、プロダクション用ドメインで使用される製品インストールを選択します。
[Manage Patches] タブで、デフォルト パッチ プロファイルを選択し、目的のパッチを適用します。
プロダクション用ドメイン内のサーバを再起動します。
Smart Update GUI 用語集
表 1 に、Smart Update グラフィカル インタフェースで使用される記号およびラベルの説明を示します。
表 1 Smart Update グラフィカル インタフェース
画面またはパネル
|
記号
|
説明
|
対象インストール
|
|
BEA ホーム ディレクトリを表す。BEA ホーム ディレクトリ内には場合によって複数の BEA Products が含まれることがある。メンテナンス スナップショットを作成する際には、目的の BEA ホーム ディレクトリを選択する必要がある。
Smart Update グラフィカル インタフェースには、現在のマシンでインストールされた製品の BEA ホーム ディレクトリしか表示されない。リモート マウントされたディスク上にある BEA ホーム ディレクトリは、現在のマシンからインストールされたものだけが表示される。
|
|
BEA Products ホーム ディレクトリを表す。たとえば、WebLogic Server、AquaLogic Service Bus など。
|
|
BEA Products の特定のインストール (対象インストールと呼ばれる) を表す。たとえば、WebLogic Server Release 9.1 など。
次の作業を実行する際には、特定のインストールを選択する必要がある。
|
[Get Patches] タブ
|
|
選択されている対象インストールに対して使用可能な公開パッチまたはパッチ セットが表示される。また、現在のパッチ ディレクトリの内容が表示される。
|
|
個別のパッチを表す。このアイコンをクリックすると、該当するパッチに関する詳細情報が表示される。
|
|
複数のパッチを収めたパッチ セットを表す。このアイコンをクリックすると、セットを構成するパッチに関する詳細情報が表示される。
|
|
チェックすると、該当する公開パッチまたはパッチ セットのダウンロードが有効になる。複数個を一度に選択することもできる。ダウンロードを開始するには、[Download Selected] をクリックする。
|
[Downloaded Patches] パネル
|
|
パッチ ダウンロード ディレクトリの内容が表示される。[Get Patches] タブを選択した場合は、選択されている対象インストール用のダウンロード ディレクトリの内容が表示される。[Manage Patches] タブを選択した場合は、指定のプロファイルにまだ適用されていないパッチだけが表示される。
|
|
緑色の矢印をクリックすると、該当するパッチまたはパッチ セットが現在のパッチ プロファイルに適用される (パッチまたはパッチ セットの適用は、[Manage Patches] タブを選択した場合のみ実行可能)。
|
[Manage Patches] タブ
|
|
個々のパッチ プロファイルの内容 (現在選択されている対象インストールに適用されたパッチのセット) が表示される。パッチまたはパッチ セットの適用と削除は、[Manage Patches] タブで実行する。
注意 : パッチまたはパッチ セットを適用して現在のプロファイルに追加するには、[Downloaded Patches] パネルで、目的のパッチまたはパッチ セットの横に表示された [Apply] ボタンをクリックする。
|
|
指定の BEA ホーム ディレクトリにあるインストール全体が適用範囲となっている、現在選択されている対象インストールに関連付けられたパッチおよびパッチ セットの一覧が表示される。
追加のパッチ プロファイル (カスタム パッチ プロファイル) を作成すると、この [Default] プロファイル タブの横に、各カスタム パッチ プロファイルのタブが作成される。
|
|
赤色の矢印をクリックすると、該当するパッチまたはパッチ セットが現在の対象インストールおよびプロファイルから削除される (削除されたパッチまたはパッチ セットは、[Manage Patches] タブでパッチ プロファイルの内容を表示した場合に [Downloaded Patches] パネルに表示されるようになる)。
|
[Patch Application Validation] ダイアログ ボックス
|
|
パッチまたはパッチ セットの適用時に発生した衝突が表示される。どのパッチがどの適用済みパッチと衝突したのかが示される。パッチまたはパッチ セットの適用時に発生する可能性がある衝突条件を以下に示す。
|
|
選択したパッチを適用する前に、別のパッチを適用する必要がある。この衝突は次のようにして解決する。
1. 前提となるパッチの ID を確認する。
2. [Cancel] をクリックし、前提となるパッチをダウンロードおよび適用してから、選択したパッチを適用する。
|
|
選択したパッチを適用する前に、適用されている別のパッチをいったん削除する必要がある。この衝突は次のようにして解決する。
1. 削除が必要なパッチの ID を確認する。
2. [Cancel] をクリックし、ID が示されたパッチを削除する。
3. 選択したパッチをダウンロードして適用する。
4. 手順 2 で削除したパッチをもう一度適用する。
|
|
選択したパッチと併用できない別のパッチが、すでに 1 つまたは複数適用されている。この衝突を解決するには、どちらのパッチを対象インストールに適用する必要があるかを選択する必要がある。
|