Smart Update クイックリファレンス

この節では、3 つの基本的なタスクを実行するための手順を示し、グラフィカルインタフェースで使用されるアイコンおよびラベルについて説明するためのものです。

プライベートパッチをダウンロードおよび適用するには

この節は、BEA カスタマサポートから提供されたプライベートパッチを取得および適用するための手順を説明するクイックリファレンスエイドです。

プライベートパッチを取得してインストールするには、次の手順を実行します。

Smart Update を起動します。

Windows :

[スタート] メニューから、[スタート｜プログラム｜BEA Products｜Smart Update] を選択します。

UNIX :

BEA_HOME/utils/bsu ディレクトリに移動します。
bsu.sh コマンドを入力します。

BEA カスタマサポートにログインします。

setDomainEnv スクリプトを変更するときに、パッチパス変数のプレースホルダを下に示されるスニペットと置き換えることができます。

Smart Update のメインウィンドウに表示される [対象インストール] というラベルの付いたパネルで、プライベートパッチをダウンロードする BEA Products のインストールを選択します。

[ログイン] ダイアログボックス

[パッチの取得] タブを選択します。

BEA Products のインストールを選択する [対象インストール] パネル

[パッチ｜プライベートの取得] を選択し、パッチの ID とパスコードを入力して、[ダウンロード] をクリックします。

[パッチの取得] タブ

ダウンロード前にパッチの衝突の有無について確認するかどうかたずねるメッセージが表示されたら、[いいえ、ダウンロードを続行し、後から衝突チェックを行います] をクリックし、[OK] をクリックします。
[パッチの管理] タブを選択します。

プライベートパッチのダウンロード

[ダウンロードされたパッチ] パネルで、ダウンロードしたプライベートパッチの横に表示される [適用] をクリックします。

パッチを適用する際には、適用するパッチと、すでに対象インストールに適用されている他のパッチとの間で衝突が発生するかどうかが検証されます。衝突が検出されなかった場合、Smart Update には次のダイアログボックスが表示されます。[OK] をクリックします。

[ダウンロードされたパッチ] パネルの [適用] ボタン

メンテナンススナップショットを作成するには

Smart Update には、BEA カスタマサポートに問題を報告する際に送付するための、BEA Products インストールに関する情報をキャプチャするメカニズムが用意されています。この情報は、メンテナンススナップショットと呼ばれます。この節では、メンテナンススナップショットを作成するための手順を説明します。

メンテナンススナップショットを作成するには、次の手順を実行します。

Smart Update を起動します。

Windows :

[スタート] メニューから、[スタート｜プログラム｜BEA Products｜Smart Update] を選択します。

UNIX :

BEA_HOME/utils/bsu ディレクトリに移動します。
bsu.sh コマンドを入力します。

注意 :

メンテナンススナップショットを生成するために BEA カスタマサポートにログインする必要はありません。

Smart Update のメインウィンドウに表示される [対象インストール] というラベルの付いたパネルで、問題を報告する BEA Products のインストールを選択します。

パッチのダウンロード時の衝突が検出されなかったことを示すメッセージボックス

[パッチの管理] タブで、パッチプロファイルを選択します。

[パッチ｜パッチプロファイル｜スナップショットの保存] を選択します。
[スナップショットの保存] ダイアログボックスで、メンテナンススナップショットのファイル名を入力し、[OK] をクリックします。

メンテナンススナップショットは、単純な ASCII テキストファイルです。

BEA カスタマサポートに、メンテナンススナップショットを送付します。電子メールを使用することをお勧めします。必要な場合は、印刷したファイルを郵送してもかまいません。

カスタムパッチプロファイルを作成するには

クラスパスまたはライブラリパスのパッチの適用範囲を特定のドメインまたはサーバインスタンスに限定する場合は、次の作業を実行する必要があります。

カスタムパッチプロファイルを作成し、そのプロファイルにパッチを適用します。
該当するドメインまたはサーバの起動スクリプトを修正し、作成したカスタムパッチプロファイルへの参照を追加します。

この節は、これらの作業を実行する手順について説明するクイックリファレンスエイドです。例として、パッチをプロダクション用ドメインに組み込む前に、テストエンジニアが品質検査用ドメインを使用してパッチをテストする場合の作業内容を示します。

カスタムパッチプロファイルを作成し、そのプロファイルに適用したパッチが特定のドメインまたはサーバから参照されるようにするには、次の手順を実行します。

Smart Update を起動して、BEA カスタマサポートにログインし、作業対象の BEA Products を [対象インストール] パネルから選択します。
目的のパッチを BEA カスタマサポートからダウンロードし、指定したパッチダウンロードディレクトリに格納します。
次の手順に従って、パッチの適用先となるカスタムパッチプロファイルを作成します。

[パッチ｜パッチプロファイル｜新規] を選択します。

カスタムパッチプロファイルに名前を付けます。次に、対象インストールの既存のパッチプロファイルから内容のクローンを作成することにより、新しいカスタムパッチプロファイルに最初から含まれるパッチのセットを指定します。

例 : 品質検査用ドメインは、プロダクション用ドメインと同じパッチメンテナンスレベルに、手順 2 でダウンロードしたパッチを追加した状態で実行する必要があります。そこで、テストエンジニアは QADomainProfile というカスタムパッチプロファイルを作成し、デフォルトパッチプロファイルの内容のクローンを作成して QADomainProfile に設定します。このカスタムパッチプロファイルが、ダウンロードしたパッチの適用先となります。

インストール全体に対して有効になるパッチがすでに対象インストールに適用されている場合、それらのパッチは、新しいカスタムパッチプロファイルにもデフォルトで含まれます。

[作成] をクリックすると、デフォルトパッチプロファイルのタブの隣のタブに、カスタムパッチプロファイルが表示されます。

カスタムパッチプロファイルに対し、必要に応じてパッチの適用または削除を実行します。

例 : テストエンジニアは、手順 2 でダウンロードしたパッチを、カスタムパッチプロファイル QADomainProfile に適用します。

起動スクリプトエディタを実行する前に、変更を加える予定のすべてのスクリプトについてバックアップを作成します。

注意 :

起動スクリプトエディタは、WebLogic Event Server 2.0 および AquaLogic Enterprise Repository 3.0. などの BEA の OSGi ベース製品には適用されません。

カスタムパッチプロファイル内のパッチを参照するように起動スクリプトを修正するために、起動スクリプトエディタを実行します。

カスタムパッチプロファイル用に作成されたタブ

[スクリプトエディタの起動] ダイアログボックスで、作成したカスタムパッチプロファイルと、スクリプトの編集対象の製品を選択し、[開く] をクリックして起動スクリプトを開きます。

起動スクリプトエディタを実行するためのメニューオプション

目的のドメイン、クラスタ、またはサーバの実行時にカスタムパッチプロファイル内のパッチが使用されるようにするために、適切な起動スクリプトを開きます。次の表の 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\startServerName.cmd` UNIX : `domain_home/bin/startServerName.sh`

例 : テストエンジニアは、QA ドメインからカスタムパッチプロファイルを参照する必要があるため、エンジニアは setDomainEnv.cmd スクリプトを開きます。このスクリプトは、そのドメインに限り、すべてのサーバの環境を設定します。パッチの適用範囲を特定のサーバインスタンスに制限する必要がない限り、通常は setDomainEnv を使用してカスタムパッチプロファイルを参照することをお勧めします。

該当する起動スクリプトの中で、目的のカスタムパッチプロファイルに含まれるクラスパス、拡張ディレクトリパス、またはライブラリパスのパッチを参照する環境変数を作成します。

製品ごとにパッチクラスパスとその他の環境変数が設定されます。wlserver_home\common\bin\setPatchEnv.cmd (Windows) または wlserver_home/common/bin/setPatchEnv.sh (UNIX) で設定した変数のように各製品に対する適切な変数を設定する必要があります。これらの環境変数について、次の表で説明します。

参照先のパッチ	カスタムパッチプロファイル内のパッチを参照するために定義する必要のある環境変数
WebLogic システムクラスパスに挿入されるクラスを含んだパッチ JAR	定義する環境変数 : `PATCH_CLASSPATH` 例 : `set WLS_PATCH_CLASSPATH= %BEA_HOME%\patch_wls1030\profiles\NewProfile \sys_manifest_classpath\weblogic_patch.jar` if "%PATCH_CLASSPATH%" == "" set PATCH_CLASSPATH=%WLS_PATCH_CLASSPATH%;%WLW_PATCH_CLASSPATH%;%WLP_PATCH_CLASSPATH%
WebLogic Server にデプロイされているアプリケーションのクラスパスに挿入されるクラスを含むパッチ JAR	定義する環境変数 : `WEBLOGIC_EXTENSION_DIRS` 例 : `set WEBLOGIC_EXTENSION_DIRS= %BEA_HOME%\patch_wls1030\profiles\NewProfile \sysext_manifest_classpath`
システムライブラリパスに挿入されるネイティブファイル (UNIX)	定義する環境変数 : `PATCH_LIBPATH` 例 : `PATCH_LIBPATH="${BEA_HOME}/patch_wls1030/profiles /NewProfile/native"`
システムライブラリパスに挿入されるネイティブファイル (Windows)	定義する環境変数 : `PATCH_PATH` 例 : `set PATCH_PATH= %BEA_HOME%\patch_wls1030\profiles\default\native`

次の図は、setDomainEnv.cmd スクリプトの変更に使用するスニペットの例を示しています。

[スクリプトエディタの起動] ダイアログボックスで、スクリプトから参照するカスタムパッチプロファイルを選択し、[開く] をクリックして起動スクリプトを開きます。

起動スクリプトに追加したパッチパス変数は、その他の環境スクリプトに対する呼び出しよりも前に記述されている必要があります。たとえば、setDomainEnv スクリプトにパッチパス変数の定義を追加する場合は、必ず commEnv スクリプトに対する呼び出しの前に追加します。

WL_HOME\common\bin\commEnv スクリプトや、Configuration Wizard によって作成される他のデフォルトのスクリプトを呼び出さない環境でカスタムスクリプトを使用する場合は、その環境のクラスパスおよびライブラリパスを設定するスクリプト内のステートメントも変更して、定義した環境変数をそれらのステートメントに正しく挿入する必要があります。

たとえば、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 を実行し、プロダクション用ドメインで使用される製品インストールを選択します。
[パッチの管理] タブで、デフォルトパッチプロファイルを選択し、目的のパッチを適用します。
プロダクション用ドメイン内のサーバを再起動します。

Smart Update GUI 用語集

表 A-1 に、Smart Update グラフィカルインタフェースで使用される記号およびラベルの説明を示します。

表 A-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 など。

次の作業を実行する際には、特定のインストールを選択する必要がある。

公開パッチまたはパッチセットの表示またはダウンロード
パッチまたはパッチセットの適用または削除
カスタムパッチプロファイルの作成または削除

[パッチの取得] タブ

選択されている対象インストールに対して使用可能な公開パッチまたはパッチセットが表示される。また、現在のパッチディレクトリの内容が表示される。

個別のパッチを表す。このアイコンをクリックすると、該当するパッチに関する詳細情報が表示される。

複数のパッチを収めたパッチセットを表す。このアイコンをクリックすると、セットを構成するパッチに関する詳細情報が表示される。

チェックすると、該当する公開パッチまたはパッチセットのダウンロードが有効になる。複数個を一度に選択することもできる。ダウンロードを開始するには、[選択したものをダウンロード] をクリックする。

[ダウンロードされたパッチ] パネル

パッチダウンロードディレクトリの内容が表示される。[パッチの取得] タブを選択した場合は、選択されている対象インストール用のダウンロードディレクトリの内容が表示される。[パッチの管理] タブを選択した場合は、指定のプロファイルにまだ適用されていないパッチだけが表示される。

緑色の矢印をクリックすると、該当するパッチまたはパッチセットが現在のパッチプロファイルに適用される (パッチまたはパッチセットの適用は、[パッチの管理] タブを選択した場合のみ実行可能)。

[パッチの管理] タブ

個々のパッチプロファイルの内容 (現在選択されている対象インストールに適用されたパッチのセット) が表示される。パッチまたはパッチセットの適用と削除は、[パッチの管理] タブで実行する。

注意 :

パッチまたはパッチセットを適用し、現在のプロファイルに追加するには、[ダウンロードされたパッチ] パネルのパッチまたはパッチセットの横にある [適用] ボタンをクリックする。

指定の BEA ホームディレクトリにあるインストール全体が適用範囲となっている、現在選択されている対象インストールに関連付けられたパッチおよびパッチセットの一覧が表示される。

追加のパッチプロファイル (カスタムパッチプロファイル) を作成すると、この [デフォルト] プロファイルタブの横に、各カスタムパッチプロファイルのタブが作成される。

赤色の矢印をクリックすると、該当するパッチまたはパッチセットが現在の対象インストールおよびプロファイルから削除される (削除されたパッチまたはパッチセットは、[パッチの管理] タブでパッチプロファイルの内容を表示した場合に [ダウンロードされたパッチ] パネルに表示されるようになる)。

[パッチの適用の検証] ダイアログボックス

パッチまたはパッチセットの適用時に発生した衝突が表示される。どのパッチがどの適用済みパッチと衝突したのかが示される。パッチまたはパッチセットの適用時に発生する可能性がある衝突条件を以下に示す。

選択したパッチを適用する前に、別のパッチを適用する必要がある。この衝突は次のようにして解決する。

前提条件となっているパッチの ID を記録する。
[取り消し] をクリックし、前提条件パッチをダウンロードし適用してから、選択したパッチを適用する。

選択したパッチを適用する前に、適用されている別のパッチをいったん削除する必要がある。この衝突は次のようにして解決する。

削除する必要のあるパッチの ID を記録する。
[取り消し] をクリックし、特定されたパッチを削除する。
選択したパッチをダウンロードして適用する。
手順 2 で削除したパッチをもう一度適用する。

選択したパッチと併用できない別のパッチが、すでに 1 つまたは複数適用されている。この衝突を解決するには、どちらのパッチを対象インストールに適用する必要があるかを選択する必要がある。

パッチおよびメンテナンス パックのインストール

Smart Update クイック リファレンス

プライベート パッチをダウンロードおよび適用するには

メンテナンス スナップショットを作成するには

カスタム パッチ プロファイルを作成するには

Smart Update GUI 用語集

パッチおよびメンテナンスパックのインストール

Smart Update クイックリファレンス

プライベートパッチをダウンロードおよび適用するには

メンテナンススナップショットを作成するには

カスタムパッチプロファイルを作成するには