Oracle® Smart Update

Oracle WebLogic Serverへのパッチの適用

リリース3.3.0

B61614-04(原本部品番号:E14143-12)

2013年10月

このドキュメントでは、Smart Updateツールを使用したWebLogic Serverインストールへのパッチの適用について説明します。

Oracle Smart Update Oracle WebLogic Serverへのパッチの適用 リリース3.3.0 B61614-03

B61614-04

Copyright © 2001, 2013, Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、Oracleまでご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 はじめに

- Smart Updateバージョン3.3.0の新機能

- Smart Updateバージョン3.3.0でサポートされている製品

- Smart Update 3.3.0のダウンロードおよびインストール

- Smart Update 3.3.0のサイレント・モードでのインストール

- クイック・リファレンスの情報

- Smart Updateによるパッチ管理の簡略化

- パッチ検証および競合チェック

- コマンド・ライン・インタフェース

- 分散環境におけるパッチ適用のサポート

- My Oracle Supportに接続できないマシンに対するパッチ適用のサポート

- Smart Updateクライアント

- パッチおよびパッチ・カタログ

- メンテナンス・ロールバック作業の簡略化

- 特定のアプリケーション、ドメインまたはサーバーに対するパッチの適用

- My Oracle Supportから提供されるリソース

- パッチの適用の概要

- 分散したマシンに対するメンテナンス

- My Oracle Supportにアクセスできないマシンのメンテナンス

- 新バージョンのSmart Updateに対する手動によるパッチの適用

2 パッチのダウンロード

- はじめに

- My Oracle Supportからのパッチのダウンロード

- Oracleパッチ番号を使用した単一のパッチのダウンロード

- Smart UpdateパッチIDを使用した単一のパッチのダウンロード

- すべての入手可能なパッチの検索およびダウンロード

3 Smart Updateの起動

- はじめに

- ダウンロードされたパッチの解凍

- 必要なアクセスを取得する

- Smart Updateの起動方法

- プリファレンスの設定

- パッチ・ダウンロード・ディレクトリを選択する

- 「ダウンロードされたパッチ」パネルでパッチ・セットを表示する

- HTTPプロキシ情報の設定

4 パッチの適用

- ターゲット・インストールの選択

- 他のミドルウェア・ホーム・ディレクトリの指定

- パッチ情報の表示

- パッチを表示する方法

- 「パッチの管理」タブに表示されるパッチについて

- 現在ダウンロードされているパッチの表示

- パッチ詳細の表示

- パッチの適用および管理

- パッチ・プロファイルについて

- ターゲット・インストールへのパッチの適用

- ターゲット・インストールからパッチの削除

- パッチ間の競合の解決

- パッチの適用時の検証

- パッチの削除時の検証

- メンテナンス・スナップショットの作成および使用

- クライアントへのパッチの適用

5 インストールおよびアプリケーションにおける適用済パッチのアクティブ化

- 概要

- 起動スクリプトによる参照が必要とされるパッチ

- すべてのアプリケーション、ドメインおよびサーバーに対してリソースを置き換えるパッチ

- アプリケーションによるデプロイおよび参照が必要とされるパッチ

- システム上でのSmart Updateによるパッチ・ファイル格納方法

- インストール・レベルのパッチ・ディレクトリの構造

- パッチ・マニフェストJARファイル

- ネイティブ・ライブラリ・ファイル

- モジュール・パッチ・ファイル

- クラスパス、拡張クラスパス、およびネイティブ・ライブラリ・パッチ

- 起動スクリプトに対するパッチの場所の指定について

- すべてのWebLogicドメインおよびサーバーで使用されるクラス・パスとライブラリ・パスを定義したデフォルト・スクリプト

- デフォルト・パッチ・パス環境変数

- パッチ・パス変数がクラス・パスおよびライブラリ・パスに挿入される際の規則

- サーバー起動スクリプト内でのパッチ・パス変数の設定について

- 起動スクリプトの修正

- 起動スクリプト・エディタの使用

- Windowsのスクリプト・スニペット

- UNIXのスクリプト・スニペット

- 起動スクリプトを開く方法

- ドメイン起動スクリプトの修正

- すべての管理対象サーバーまたはクラスタの起動スクリプトの修正

- 特定サーバーの起動スクリプトの修正

- カスタム・スクリプト経由のパッチですべてのドメインとサーバーをポイントする方法

- ドメインおよびサーバーのWebLogicシステム・クラスパスからデフォルト・パッチ・プロファイル内のパッチJARへの参照

- ドメインおよびサーバーからデフォルト・パッチ・プロファイル内のライブラリ・パッチへの参照

- UNIXシステムの場合

- Windowsシステムの場合

- モジュール・パッチの適用

- WebLogic Serverにおけるモジュール・パッチの適用

- OSGiベースの製品におけるモジュール・パッチの適用

- ネイティブ・バイナリとその他のアーティファクトのパッチ

- 共有アーカイブ・パッチ

- 概要

- アーカイブの置換えまたは挿入

- パッチの削除

- 詳細情報

- 共有アーカイブ・パッチのデフォルト・アプリケーション

- アプリケーション・スコープによるカスタム・プロファイルでの共有アーカイブ・パッチのアクティブ化

- アプリケーション記述子の更新

6 個々のアプリケーション、ドメイン、またはサーバーへのパッチの適用

- ドメインまたはサーバーへのパッチ適用について

- アプリケーション、ドメイン、またはサーバーのパッチについて

- カスタム・プロファイルによる個々のドメイン、サーバー、およびアプリケーションへのパッチの適用

- ドメインまたはサーバーでカスタム・プロファイル内のパッチを参照する方法

- サーバーからパッチ・クラスを参照するPATCH_CLASSPATHの使用例

- OSGiベースの製品のカスタム・パッチ・プロファイルへの参照

- カスタム・パッチ・プロファイルを使用するためのベスト・プラクティス

- カスタム・プロファイルの増大を回避する

- ドメインおよびサーバー起動スクリプトを変更する

- インストール環境全体のリソースに影響するパッチを削除する

- カスタム・パッチ・プロファイルの作成

- カスタム・パッチ・プロファイルの初期内容

- パッチ・プロファイルのクローンを作成する

- カスタム・パッチ・プロファイルにパッチを追加する

- カスタム・パッチ・プロファイルを削除する

- ドメインおよびサーバーからカスタム・パッチ・プロファイルへの参照

- カスタム・スクリプトを使用する際の重要な注意

- ノード・マネージャ環境でのカスタム・パッチ・プロファイルの管理

7 パッチのアンインストール

- 製品のアンインストールに関する重要な注意

- パッチの削除

- パッチまたはパッチ・セットの削除

- サービス・パックまたはメンテナンス・パックのアンインストールまたはアップグレード

8 コマンド・ライン・インタフェースの使用

- bsuコマンドについて

- bsuコマンド・リファレンス

- コマンド・ライン・インタフェースの例

- インストールの例

- パッチの表示の例

- パッチの表示の例(2)

- メンテナンス・スナップショットの表示

- 適用済みパッチのレポート

9 パッチの配布に関するベスト・プラクティス

- 本番環境へのパッチの配布

- Smart Updateスクリプトを使用した標準メンテナンス・レベルから本番環境へのプロモート

- 製品インストール環境のアーカイブの作成と配布

- My Oracle Supportに接続できないシステムへのパッチの提供

- 共有パッチ・ダウンロード・ディレクトリ経由でオフライン・システムにパッチを適用する

- 要件

- 手順

- リムーバブル・メディア経由でオフライン・システムにパッチを適用する

- 要件

- 手順

- オフライン・システムにパッチを適用するためのその他の手段

10 Smart Updateに関する既知の制限事項

- 一般的な問題と回避策

- Smart Updateでサポートされていない製品のバージョン文字列がレジストリに存在すると、Smart Update 3.1の終了時にエラーが発生する

- Smart UpdateがApple Macintoshマシンで動作しない

- ノード・マネージャの実行中にSmart Updateを使用すると、例外がスローされる

- コマンド・ライン・モードでパッチ適用時の製品チェックが行われない

- 無効なパッチの代替として別の無効なパッチが表示される

- パッチ・プロファイル・メンテナンス・スナップショットをメモ帳で表示すると、書式が崩れる

- Smart Updateグラフィカル・ユーザー・インタフェースでまれに例外が表示される

- コンポーネントをアンインストールしてもコンポーネントのパッチが自動的に削除されない

- コマンド・ラインからインストールしたパッチは、GUIを再起動するまでGUIには反映されない

- WebLogic Server 10.3.2から10.3.1へのロールバック後に作成されたドメインで問題が発生する

11 よくある質問

- サポートIDを取得するにはどうすればよいですか。

- バグまたはCRとは何ですか。

- バグの修正はどうすれば入手できますか。バグに対するパッチは入手できますか。

- セキュリティ勧告の通知を取得するにはどうすればよいですか。

- プライベート・パッチとは何ですか。

- メンテナンス・パックを1つのみダウンロードするにはどうすればよいですか。

- Smart Updateツールを使用してパッチを適用できる製品にはどのようなものがありますか。

- My Oracle Supportからパッチをダウンロードするには、サポート契約が必要ですか。

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

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

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

- Smart Update GUI用語集

用語集

はじめに

ここでは、『Oracle Smart Update Oracle WebLogic Serverへのパッチの適用』で使用されるドキュメント・アクセシビリティ機能および表記規則について説明します。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportから電子サポートにアクセスできます。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

関連ドキュメント

詳細は、Oracle Fusion Middleware 11g リリース1のドキュメント・セットにある次の関連ドキュメントを参照してください。

- Oracle WebLogic Serverインストレーション・ガイド

- My Oracle SupportのドキュメントID: 1294294.1

- My Oracle SupportのドキュメントID: 1302053.1

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

斜体

イタリックは、ユーザーが特定の値を指定するプレースホルダー変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 概要

この項の内容は次のとおりです。

- Smart Updateバージョン3.3.0の新機能

- Smart Updateバージョン3.3.0でサポートされている製品

- Smart Update 3.3.0のダウンロードおよびインストール

- クイック・リファレンスの情報

- Smart Updateによるパッチ管理の簡略化

- My Oracle Supportから提供されるリソース

- パッチの適用の概要

Smart Updateバージョン3.3.0の新機能

Smart Update 3.3.0では、「パッチの取得」タブは削除されています。なお、パッチ、サービス・パックおよびメンテナンス・パックのダウンロードおよびバージョン・アップグレードにはSmart Updateを使用できなくなりました。まず、直接My Oracle Supportから適切なパッチをダウンロードします。ダウンロードしたら、Smart Updateを使用してパッチを適用することができます。

Smart Update 3.3.0は、パッチのインストールにのみ使用できます。Smart Update 3.3.0は、サービス・パック、メンテナンス・パック、またはバージョン・アップグレードのインストールには使用できません。インストール済の製品のバージョンをアップグレードする場合は、Smart Updateとは無関係に、My Oracle Supportからアップグレード・インストーラをダウンロードして、そのインストーラを実行する必要があります。詳細情報は、My Oracle Supportの「KB」検索フィールドに次のドキュメントIDを入力してください。

1294294.1

Smart Update 3.3.0では、セキュリティ・アップデートを入手するためにOracle Configuration Management (OCM)に登録するように指示されなくなりました。ところが、WebLogic Serverをインストールするときや、アップグレード・インストーラを使用して既存のWebLogic Serverをバージョン10.3.2以降に更新するときにOCMに登録することにより、セキュリティ・アップデートを入手できます。My Oracle Supportページのコレクタ・タブを選択して、My Oracle SupportからもOCMに直接登録できます。

Smart Updateの制限に関する情報は、第10章「Smart Updateの既知の制限事項」を参照してください。

Smart Updateバージョン3.3.0でサポートされている製品

Smart Update 3.3.0は、次の製品にパッチを適用するために使用できます:

- Oracle WebLogic Server 9.1.0、9.2.0、9.2.1、9.2.2、9.2.3、9.2.4、10.0.0、10.0.1、10.0.2、10.3.0、10.3.1、10.3.2、10.3.3、10.3.4、10.3.5、10.3.6、12.1.1

- Oracle Workshop for WebLogic Platform 9.2.1、9.2.2、9.2.3、10.0、10.0.1

- Oracle Workshop 10.1.0、10.2.0、10.2.1、10.3.0、10.3.1

- Oracle WorkSpace Studio 1.1.0

- Oracle WebLogic Integration 9.2.0、9.2.1、9.2.2、9.2.3、10.2.0、10.2.1、10.3.0、10.3.1

- Oracle WebLogic Portal 9.2.0、9.2.1、9.2.2、9.2.3、10.0.0、10.0.1、10.2.0、10.2.1、10.3.0、10.3.2

- Oracle WebLogic Event Server 2.0.0

- Oracle Complex Event Processing 10.3.0、11.1.1.1、11.1.2.0、11.1.3.0、11.1.4.0

- Oracle WebLogic Operations Control 1.0.0、10.3.0

- Oracle Communications Converged Application Server 5.0

- Oracle Communications Services Gatekeeper 4.1.0、4.1.1、5.0.0

- Oracle Service Bus 10.3.0、10.3.1

- Aqualogic Service Bus 2.1、2.5、2.6、2.6 RPI、3.0

- Oracle AquaLogic Data Services Platform 3.2.0

- Oracle AquaLogic Enterprise Repository 3.0.0

- Oracle Communications Marketing and Advertising 5.0.0.1

- Oracle Communications Presence 5.0.0

- Oracle Data Service Integrator 10.3.0

- Oracle WebLogic Communications Services 10.3.1

- Oracle WebLogic Communications Server 10.3.0

- Oracle WebLogic Network Gatekeeper 4.0.0

Smart Update 3.3.0のダウンロードおよびインストール

インターネットにアクセスがあるシステムは、Smart Update 3.3.0に自動更新されます。

オフライン・システムの更新は、次の手順を実行します。

1. インターネットにアクセスがあるシステムにMy Oracle Supportから「12426828」パッチをダウンロードします。

2. ダウンロードしたファイルをディレクトリに展開します。ZIPファイルには、Smart Update 3.3.0のスタンドアロン・インストーラが含まれています。

3. 「12426828」パッチのパッチREADMEファイルの指示に従います。Smart Updateを サイレント・モードでインストールする場合、次の項を参照してください。

Smart Update 3.3.0のサイレント・モードでのインストール

Smart Update 3.3.0をサイレント・モードでインストールするには、ダウンロードしたZIPファイルを展開し、次の手順を実行します。

1. 次の内容を含むサイレント・インストールのXMLファイル(例: silent.xml)を作成し、Smart Update 3.3.0インストーラと同じディレクトリに格納します。

<?xml version="1.0" encoding="UTF-8"?>

<domain-template-descriptor>
<input-fields>
<data-value name="BEAHOME" value="MW_HOME" />
<data-value name="COMPONENT_PATHS" value="Common Infrastructure
Engineering|Oracle WebLogic Smart Update" />
</input-fields>

</domain-template-descriptor>

BEAHOMEデータ値名のMW_HOMEの値をご使用のミドルウェア・ホーム・ディレクトリに置き換えます。(例：C:\Oracle\Middleware)

2. コマンド・プロンプト・ウィンドウを開きます。

3. 次のコマンドを入力します。
java -jar patch-client-installer330_generic32.jar
-mode=silent -silent_xml=xml_file_name

xml_file_nameをサイレント・インストールXMLファイルの名前に置き換えます。

サイレント・モードでのインストールに関する情報は、ご使用のWebLogic Serverのバージョンに対応したWebLogic Serverインストレーション・ガイドを参照してください。

クイック・リファレンスの情報

Smart Updateをすぐに使用するには、表1-1に示す項を参照してください。これらの項には、基本的なSmart Updateタスクを実行するための手順が要約されています。

表1-1 Smart Updateクイック・リファレンスの情報

クイック・リファレンスの情報

内容

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

メンテナンス・スナップショット(製品インストールのメンテナンス・レベルに関する詳細情報が記載された単純なテキスト・ファイル)を作成するための手順。問題を解決するためにMy Oracle Supportに連絡すると、必ずこのファイルの提供を求められます。

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

カスタム・パッチ・プロファイルを作成するための手順。カスタム・パッチ・プロファイルは、製品インストール上で動作するすべてのサーバーに対して有効にすることが適切でないパッチを、個別のWebLogicドメインまたは1つ以上のサーバーから参照する場合に使用します。

Smart Update GUI用語集

Smart Updateグラフィカル・インタフェースで使用されているアイコンおよびラベルについての定義。

bsuコマンド・リファレンス

Smart Updateのコマンド・ライン・インタフェースで使用されるbsuコマンドのリファレンス。

Smart Updateによるパッチ管理の簡略化

Smart Updateは、いかなるソフトウェアとも無関係に実行できるスタンドアロンのJavaアプリケーションで、現在のソフトウェア・インストールに対して迅速かつ容易にパッチを適用できます。また、My Oracle Supportからダウンロードしたパッチの適用にも使用できます。

製品を初めてインストールすると、Smart UpdateはMW_HOME/utils/bsuに自動的にインストールされます。

Smart Updateは随時新しい機能で強化され、My Oracle SUpportからパッチとして入手できます。詳細は、「Smart Update 3.3.0のダウンロードおよびインストール」を参照してください。

後でSmart Updateを起動すると、更新されたバージョンが呼び出されます。

パッチ検証および競合チェック

製品の特定のバージョン用に作成した個々のパッチすべてが、該当するバージョン用の既存のパッチすべてに対して検証されます。ダウンロードしたパッチを表示するためにSmart Updateを実行すると、My Oracle Supportから提供される検証データが自動的に使用されるため、製品インストールにすでに正しく適用されているパッチとの間に競合が発生するようなパッチの適用を防止できます。

たとえば、未適用のパッチに依存するパッチを適用しようとすると、Smart Updateによって依存関係についての問題が報告されます。その場合は、続行する前に、前提となるパッチをMy Oracle Supportからダウンロードし、Smart Updateで適用できます。パッチ検証は、パッチを適用する際には必ず自動的に実行されます。

場合によっては、適用した既存のパッチが、My Oracle Supportから後で提供された代替パッチによって置き換えられることや、My Oracle Supportによって無効パッチの指定を受けることがあります。My Oracle Supportからダウンロードしたすべてのパッチがパッチ・カタログのコピーを含みます。このカタログは、リポジトリの現在の状態を示します。よって、パッチのダウンロード後、廃止されたパッチをインストールしていることに気づく場合があります。その場合、My Oracle Supportで置換えパッチを確認します。

コマンド・ライン・インタフェース

Smart Updateのコマンド・ライン・インタフェースでは、パッチの適用と、ダウンロード済または適用済のパッチに関する情報の取得ができます。これらの機能は、コマンド・ラインから直接に実行することも、Smart Updateコマンドを記述したスクリプトによって間接的に実行することもできます。

分散環境におけるパッチ適用のサポート

Smart Updateでは、My Oracle Supportから組織内の一元的な場所にまとめてダウンロードしてあるパッチを、各種のインストール済の製品がある本番環境内の複数のシステムへとスクリプトによって配布するためのモデルがサポートされています。このモデルにより、マシン(特に、My Oracle Supportに直接接続してパッチをダウンロードすることが適切または可能でない本番環境に存在するマシン)に対するパッチの配布および適用方法を規定するビジネス プラクティスにSmart Updateを適合させることができます。

My Oracle Supportに接続できないマシンに対するパッチ適用のサポート

更新する対象のすべてのマシンがMy Oracle Support、つまりインターネットに直接接続されている必要はありません。GUIまたはコマンド・ライン・モードでSmart Updateを使用して、パッチおよびパッチ情報を適用、削除および表示できます。

インターネットに接続しているマシンが1台でもあれば、My Oracle Supportからそのマシンにパッチをダウンロードできます。ダウンロードしたパッチを、組織内のオフライン・マシンに適用できます。オフライン・マシンのSmart Updateダウンロード・ディレクトリには、パッチをダウンロードしたディレクトリを指定します。

Smart Updateクライアント

最新バージョンを適用するための、更新されたSmart Updateクライアント・インストーラを無料で入手できます。詳細は、「Smart Update 3.3.0のダウンロードおよびインストール」を参照してください。

パッチおよびパッチ・カタログ

インターネットにアクセスできるマシンに新しくダウンロードしたパッチはパッチ・カタログのコピーを含みます。このカタログは、Smart Updateリポジトリの現在の状態を示します。Smart Updateを実行するとパッチ・カタログの最新のローカル・バージョンが検出され、使用されます。

パッチを入手してオフライン・マシンに適用するには:

- インターネットに接続しているマシンでMy Oracle Supportへログインし、パッチをダウンロードします。WebLogic Serverパッチの特定およびダウンロードの詳細情報は、My Oracle Supportの「KB」検索フィールドに次のドキュメントIDを入力してください。
1302053.1

- パッチのZIPファイルをディレクトリに展開します。

- パッチのZIPファイルを展開したディレクトリをオフライン・マシンがアクセスできる場所にコピーします。

- Smart Updateを実行し、電子メール、FTP、物理メディアの送付などのような他の手段で入手したパッチを適用します。

メンテナンス・ロールバック作業の簡略化

Smart Updateでは、適用済のパッチを簡単に削除し、以前のメンテナンス・レベルを正確で安全に復元できます。詳細は、第7章「パッチのアンインストール」を参照してください。

- Smart Updateを実行すると、その検証プロセスの一部として現在のローカルのパッチ・カタログが確認され、インストール済のパッチで廃止されたパッチがあれば通知されます。ただし、現在のパッチ・カタログが失効している場合、現在のインストールに適用されているパッチより新しいパッチがMy Oracle Supportから発行されていても、通知されません。このため、随時My Oracle Supportで代替パッチを確認することをお薦めします。

- 現在のローカル・パッチ・カタログの情報に基づき、置き換えられたかまたは非推奨になったパッチがダウンロード・ディレクトリの中にあると、Smart Updateは、適用済パッチのリスト中のそれらのエントリを強調表示し、無効としてマークします。代替パッチが提供されている場合は、無効なパッチの説明に、該当する代替パッチの情報が追加されます。

特定のアプリケーション、ドメインまたはサーバーに対するパッチの適用

複雑な本番環境をサポートするために、Smart Updateでは、インストール全体に対して自動的に有効とならないパッチを、個別のドメインまたはサーバーの範囲に限定して適用できます。たとえば、単一のテスト・ドメインにかぎって使用するWebLogicシステム・クラスパス用のパッチがその一例です。1つのミドルウェア・ホーム・ディレクトリに複数の製品がインストールされており、そのうち特定の製品のみに基づいてWebLogicドメインが動作する場合は、この機能を使用することをお薦めします。

たとえば、Oracle Service Busに基づいて動作するドメインがある場合、Oracle Service Busクラスパスのパッチはすべて当該ドメインに限定して適用します。そうすれば、Oracle Service Busを使用しない他のドメインに属するサーバーのクラスパスにOracle Service Busのクラスが混入するのを防止できます。

また、1つのWebLogicドメインのすべてのアプリケーションではなく、選択したアプリケーションのみにパッチを適用することもできます。

My Oracle Supportから提供されるリソース

有効なMy Oracle SupportログインIDでMy Oracle Supportへ直接ログインしてパッチを表示およびダウンロードできます。

My Oracle Supportアカウントの作成の詳細は、「はじめに」を参照してください。

パッチ適用の概要

Smart Updateでは、ターゲットとなる製品インストール用のメンテナンス・パッチを簡単に参照してインストールできます。Smart Updateでは、ダウンロードして適用したパッチのリストが表示されため、パッチの管理を容易にできます。

Smart Updateのメイン・ウィンドウにある「パッチの管理」タブで、ダウンロードして適用したパッチのリストを表示できます。「パッチの管理」タブには、2種類のパッチ・リストが表示されます。ターゲット製品インストールにすでに適用されているパッチのリストと、ターゲット・インストール用にダウンロードされ、適用の準備ができているパッチのリストの2種類です。

パッチの適用プロセスは、次の手順で構成されます:

1. Webブラウザを開き、My Oracle Supportへログインします。

2. インストールした製品に適用するSUパッチを特定し、パッチをダウンロードします。

3. ダウンロードした各ZIPファイルをSmart Updateダウンロード・ディレクトリに展開します。

4. Smart Updateツールを実行します。

5. パッチを適用する製品インストールを選択します。

6. パッチを適用します

7. 検証の結果、競合がある場合、解決します。

My Oracle Supportを使用してSUパッチを特定およびダウンロードする方法については、第2章「パッチのダウンロード」を参照してください。

Smart Updateを使用してパッチを適用する方法については、第4章「パッチの適用」を参照してください。

分散したマシンに対するメンテナンス

分散配置した多数のマシンに対するメンテナンスを、厳格な管理のもとで、信頼性と再現性を確保しつつ実施するには、Smart Updateのコマンド・ライン・インタフェースが非常に役立ちます。たとえば、次のようなビジネス環境での運用が考えられます。

- 本番環境が厳格に管理されており、製品の複数のインストールを、厳密に指定されたメンテナンス・レベルで動作させる必要があります。

- 実際のIT環境の運用方法に合わせて、ソフトウェア・メンテナンス更新ファイルを内部の一元管理された場所に格納し、そこからすべてのマシンに配布する必要があります。

Smart Updateのコマンド・ライン・インタフェースを使用して特定のパッチ・セットを複数のマシンに適用する手順の例を次に示します。

1. インターネットに接続しているマシンからMy Oracle Supportにログインし、必要なパッチをダウンロードします。

2. パッチ適用先となるすべてのマシンからアクセス可能な場所にパッチおよび更新されたパッチ・カタログをコピーします。

3. 目的のパッチを適用するためのSmart Updateコマンドを記述したシェル・スクリプトを作成します。

4. 製品がインストールされている各マシン上で、スクリプトを実行します。

注意:

My Oracle Supportからパッチをダウンロードしたマシンでは、更新対象の分散ターゲット・インストールと一致するターゲット・インストールを選択しておく必要があります。

1つの本番環境内にインストールされている複数の製品にパッチを配布する場合の例は、第9章「パッチの配布に関するベスト・プラクティス」を参照してください。

My Oracle Supportにアクセスできないマシンのメンテナンス

状況によっては、特定のマシンからMy Oracle Supportへの直接の接続を確立することが不可能または望ましくないことがあります。例:

- クリティカル・パッチを至急ダウンロードして適用する必要がありますが、システム障害により、会社のインターネット接続が一時的に使用不能になっています。

- DMZ内、つまりファイアウォールの内側に設置されているため、My Oracle Supportに接続可能になることがない本番用マシンに対し、定期的なメンテナンス更新を実施する必要がある場合。

Smart Updateでは、このようなマシンにパッチを適用するための様々な方法がサポートされています。Smart Updateでは、リモート・マウントしたディスクやリムーバブル・メディアなどのソースからパッチを取得することも可能です。この柔軟性を利用すれば、組織におけるIT運用にSmart Updateを適合させ、インストールされている製品のメンテナンス用に、管理と信頼性の行き届いた、再現可能なプロセスを作成できます。

My Oracle Supportにログインできるマシンが使用環境内に1台でもある場合は、Smart Updateでサポートされているすべての製品インストールに対してパッチを取得および配布できます。インターネットに接続しているシステム上のSmart Updateダウンロード・ディレクトリにパッチをダウンロードします。デフォルトのダウンロード・ディレクトリは、MW_HOME\utils\bsu\cache_dir\です。

パッチのダウンロードに関する情報は、第2章「パッチのダウンロード」を参照してください。

パッチの適用に関する情報は、次の各章を参照してください。

- GUIをオフライン・モードで使用する場合、「Smart Updateの起動」および「パッチの適用」を参照してください。

- コマンド・ラインを使用する場合は、第8章「コマンド・ライン・インタフェースの使用」を参照してください。

新バージョンのSmart Updateに対する手動によるパッチの適用

Smart Updateインストールのバージョン番号を表示するには、GUIから「ヘルプ」→「バージョン情報」を選択するか、コマンド・ライン・モードで-versionオプションを使用します。My Oracle SupportにアクセスできるシステムでSmart Updateを更新する場合、Smart Updateを実行させる他のすべてのシステムも更新する必要があります。すべてのシステムにSmart Updateの同じバージョンがインストールされている必要があります。

互換性のないバージョンのSmart Updateを使用してパッチを適用すると、エラーが発生します。これらのエラーでは、通常、エラーの原因がSmart Updateのバージョンの不一致であることは明示されません。このような場合、My Oracle Supportでは、バージョンの不一致を確認し、スタンドアロンのSmart Updateインストーラを提供します。バージョンの不一致は、ログ・ファイルで確認できます。-logオプションの詳細は、「bsuコマンドについて」を参照してください。

My Oracle Supportから入手できるスタンドアロン・インストーラを使用して、空のMW_HOMEまたはインストール済の製品を格納している既存のMW_HOMEのいずれかにインストールします。Smart Update 3.3.0の入手方法は、「Smart Update 3.3.0のダウンロードおよびインストール」を参照してください。既存のMW_HOMEにインストールした場合、インストーラは必要なディレクトリを作成し、既存バージョンのSmart Updateに取ってかわります。

スタンドアロン・インストーラは、既存のcache_dirディレクトリの内容を触らないため、適用済のパッチには影響を及ぼしません。なお、既存のpatch-catalog.xmlファイルも置き換えられません。

接続マシンで使用されている最新バージョンとSmart Updateを一致させる

必要なすべてのファイルの最新バージョンを確保するには、patch-catalog.xmlを含め、ダウンロード・ディレクトリにあるすべてのパッチとpatch-*.xmlファイルを接続マシンからオフライン・マシンにコピーします。

デフォルトのパッチ・ダウンロード・ディレクトリは、MW_HOME\utils\bsu\cache_dirです。これは「プリファレンス」メニューから、またはコマンド・ライン・モードでpatch_download_dirパラメータを使用して変更できます。

エンコーディングされたパッチ・カタログpatch-catalog.xmlには、パッチとパッチの依存関係および競合に関するメタデータが含まれます。

完全なオフライン環境では、My Oracle Supportにご連絡の上、パッチおよびパッチ・カタログの最新コピーを入手してください。

図1-1では、My Oracle Supportにアクセスできないシステムにパッチを適用する場合の例を示します。

図1-1 My Oracle Supportにアクセスできないシステムへのパッチ適用の例

詳細は、「My Oracle Supportに接続できないシステムへのパッチの提供」を参照してください。

2 パッチのダウンロード

Smart Update 3.3.0以降では、Smart Updateからのパッチのダウンロードが不可能になりました。かわりに、My Oracle Supportへ直接ログインして適切なパッチをダウンロードする必要があります。この章では、これを行う方法を説明します。

はじめに

My Oracle Supportからパッチをダウンロードする前に、次の手順を実行します。

- パッチをダウンロードするには、有効なMy Oracle SupportログインIDおよびパスワードが必要です。My Oracle Supportアカウント作成はhttps://support.oracle.comの「登録」リンクをクリックし、指示に従ってください。

- パッチ・ダウンロード先のディレクトリを決定します。すべてのマシンがインターネットにアクセスできる場合、(必須ではありませんが、)パッチを各マシンの同じディレクトリ・パスにダウンロードします。インターネットにアクセスできないマシンがある場合、パッチをリモート・マウントしたディスクまたはリムーバブル・メディアなど一元的な場所にダウンロードします。

- 現在のインストール済の製品のバージョン番号を記録してください。この番号は、My Oracle Supportで入手可能なパッチを検索するときに必要となります。

My Oracle Supportからのパッチのダウンロード

この項では、My Oracle Supportからパッチをダウンロードする方法を説明します。詳細情報は、My Oracle Supportの「KB」検索フィールドにドキュメントID 1302053.1を入力してください。

My Oracle Supportからパッチをダウンロードするには:

1. Webブラウザを開き、次のURLを入力します。
https://support.oracle.com/CSP/ui/flash.html

2. サインイン・ボタンをクリックし、ご自身のMy Oracle SupportログインIDおよびパスワードでログインします。

3. 「パッチと更新版」タブを選択します。このタブを選択すると、パッチのダウンロードに関する次の2つのオプションが表示されます。

- パッチ番号およびプラットフォームを入力して単一のパッチをダウンロード:「Oracleパッチ番号を使用した単一のパッチのダウンロード」を参照してください。

- 現在インストールしている製品に対する入手可能なパッチをすべて検索:「すべての入手可能なパッチの検索およびダウンロード」を参照してください。

注意:

Smart Update 3.3.0では、説明がSUパッチで始まるパッチのみをダウンロードして適用できます。

Oracleパッチ番号を使用した単一のパッチのダウンロード

ダウンロードするパッチのOracleパッチ番号がわかる場合、次の手順を実行します。

1. 「パッチ検索」セクションの「パッチ名」、「パッチ番号」または「Sun CR ID」リンクをクリックします。

2. 次のフィールドに適切な項目を選択します。

- 「パッチ名」または「パッチ番号」 - パッチ番号を入力します。

- 「プラットフォーム」 - 指定したパッチ番号に対して最大5つのプラットフォームを選択します。また、他の検索条件も変更できます。たとえば、ご使用の言語に対するパッチの検索は、「プラットフォーム」を「言語」に変更し、1つまたは複数の言語を入力します。

3. 「検索」をクリックします。すると「パッチ検索結果」が表示されます。

4. ダウンロードするパッチのチェック・ボックスを選択します。

5. 「ダウンロード」をクリックします。

6. パッチ・ファイル名をクリックし、「保存」をクリックします。

7. ダウンロードする場所を選択し、「保存」をクリックします。

8. 「閉じる」をクリックし、ダイアログ・ボックスを閉じます。

Smart UpdateパッチIDを使用した単一のパッチのダウンロード

ダウンロードするパッチのSmart UpdateパッチID(例: CX138)がわかる場合、次の手順を実行します。

1. パッチ検索セクションの製品またはファミリ(絞込み検索)リンクをクリックします。

2. 次のフィールドに適切な項目を選択します。

- 「Product」 - このドロップダウン・リストから1つまたは複数の製品を選択します。複数の製品を選択するには、Ctrlキーを押しながら製品名を選択します。

- Release - 指定する製品の1つまたは複数のリリース・バージョン番号を選択します。

- 「プラットフォーム」 - 「プラットフォーム」を「説明」に変更し、Smart UpdateパッチIDを検索テキストとして入力します。

3. 「検索」をクリックします。すると「パッチ検索結果」が表示されます。

4. ダウンロードするパッチのチェック・ボックスを選択します。

5. 「ダウンロード」をクリックします。

6. パッチ・ファイル名をクリックし、「保存」をクリックします。

7. ダウンロードする場所を選択し、「保存」をクリックします。

8. 「閉じる」をクリックし、ダイアログ・ボックスを閉じます。

すべての入手可能なパッチの検索およびダウンロード

インストール済の製品に対するすべての入手可能なパッチを検索し、その1つまたは複数のパッチをダウンロードするには、次の手順を実行します。

1. パッチ検索セクションの製品またはファミリ(絞込み検索)リンクをクリックします。

2. 次のフィールドに適切な項目を選択します。

- 「Product」 - このドロップダウン・リストから1つまたは複数の製品を選択します。複数の製品を選択するには、Ctrlキーを押しながら製品名を選択します。

- Release - 指定する製品の1つまたは複数のリリース・バージョン番号を選択します。

- 「プラットフォーム」 - 指定した製品に対して最大5つのプラットフォームを選択します。また、他の検索条件も変更できます。たとえば、説明にSUパッチが含まれているすべてのバグの検索は、「プラットフォーム」を「説明」に変更し、SUパッチを検索テキストとして入力します。

3. 「検索」をクリックします。すると「パッチ検索結果」が表示されます。

4. ダウンロードする各パッチのチェック・ボックスを選択します。

5. 「ダウンロード」をクリックします。選択済のパッチがすべてリストされたダイアログ・ボックスが表示されます。

6. リストの各パッチの名前を選択し「保存」をクリックします。

7. ダウンロードする場所を選択し、「保存」をクリックします。

8. パッチのダウンロードが完了したらダイアログ・ボックスの「閉じる」をクリックします。

3 Smart Updateの起動

この節では、以下のトピックについて説明します。

- はじめに

- Smart Updateの起動方法

- プリファレンスの設定

はじめに

Smart Updateを起動して製品インストールへの更新の適用を開始する前に、次の項を確認してください。

- ダウンロードされたパッチの解凍

- 必要なアクセスを取得する

ダウンロードされたパッチの解凍

My Oracle SupportかダウンロードするすべてのSUパッチ・ファイルは、圧縮(ZIP)ファイルです。パッチの適用時にSmart Updateを実行する前には、これらのZIPファイルを環境に適合するツール(Windowsの場合7-ZipまたはWinZip、Linuxの場合tarまたはgunzipなど)で展開する必要があります。

各ファイルを解凍するとパッチJARファイルおよびREADME.txtファイルが展開されます。ファイルの展開は、適用するパッチと同じディレクトリに展開する必要があります。この場所は、「プリファレンスの設定」で説明されているとおりにSmart Updateのパッチ・ダウンロード・ディレクトリと同じディレクトリになります。また、ファイルをサブディレクトリに展開してからパッチJARファイルをパッチ・ダウンロード・ディレクトリに移動することもできます。

必要なアクセスを取得する

Smart Updateを起動する前に、必要なすべてのリソースにアクセスできることを確認してください。具体的には、次のことを行います。

- パッチ・ダウンロード・ディレクトリに対する適切な書込み権限があることを確認します。特に、このディレクトリがリモート・ディスク・ドライブまたはリモート・コンピュータ上に存在している場合には必ず確認してください。

- ターゲットの製品インストール・ディレクトリにアクセスするために必要な権限があることを確認します。ネットワーク経由の(リモート・マウントされた)ディスク・ドライブ上にある製品インストールにパッチを適用する場合、これらのディレクトリにアクセスできることは特に重要です。

Smart Updateの起動方法

表3-1には、WindowsシステムおよびUNIXシステムでSmart Updateグラフィカル・インタフェースを起動する手順を示します。

表3-1 Smart Updateの起動

このプラットフォームでSmart Updateを起動するには

次の手順を実行します

Windows

「スタート」メニューから、次を選択します

「スタート」→「プログラム」→「Oracle WebLogic」→「Smart Update」

または、MS-DOSコマンド・プロンプト・ウィンドウから起動する場合は:

1. MW_HOME\utils\bsuディレクトリに移動します。MW_HOMEは、更新する製品インストールのホスト・ディレクトリです。

2. プロンプトに対して、次のコマンドを入力します:

bsu.cmd

Smart Updateのメイン・ウィンドウが表示されます。

UNIX

注意: UNIXシステムでSmart Updateを実行する場合、ソフトウェアのアップグレードを行うシステムに付属するコンソールで、JavaベースのGUIがサポートされている必要があります。

1. UNIXシステムにログインします。

2. MW_HOME/utils/bsuディレクトリに移動します。MW_HOMEは、更新する製品インストールのホスト・ディレクトリです。

3. プロンプトに対して、次のコマンドを入力します:

bsu.sh

Smart Updateのメイン・ウィンドウが表示されます。

Smart Updateをはじめて起動する際に、パッチ・ダウンロード・ディレクトリを適切な場所を設定します。「パッチ・ダウンロード・ディレクトリを選択する」を参照してください。

プリファレンスの設定

「プリファレンス」ダイアログ・ボックスでは、次のオプションを設定できます。

- パッチ・ダウンロード・ディレクトリの場所

- Smart Updateウィンドウの「ダウンロードされたパッチ」パネルにおけるパッチ・セットの表示モード

- HTTPプロキシまたは周辺セキュリティ認証情報。Smart Updateクライアントの自動更新メカニズムにのみ適用します。

パッチ・ダウンロード・ディレクトリを選択する

My Oracle Supportからダウンロードしたパッチを適用する前に、パッチ・ダウンロード・ディレクトリとして適切な場所を選択することをお薦めします。ダウンロードしたパッチはすべてこのディレクトリに格納します。

パッチ・ダウンロード・ディレクトリは単一レベルのディレクトリまたはフォルダで、Smart Updateでは適用可能なパッチの検出に使用されます。パッチの適用を開始する前に、この役割を果すディレクトリを、この項の説明に従って必ず指定してください。

Smart Update 3.3.0にアップグレードする際には、パッチ・ダウンロード・ディレクトリが自動的に作成されますが、必要に応じてデフォルト以外の場所を指定することも可能です。たとえば、組織内において、ソフトウェア・ベンダーからダウンロードしたパッチを専用の場所に格納することが推奨または義務付けられている場合があります。この場所は、集中管理されるリポジトリである場合も、特定の構成のためのキャッシュ・ディレクトリ・セットである場合もあります。更新ファイルの格納についてSmart Updateが柔軟に対応できることを利用すれば、ソフトウェア・メンテナンスが集中管理されている場合や、QA環境、ステージング環境、本番環境に順次移行するためメンテナンス・イメージを簡単にレプリケートする必要がある場合など、各種のビジネス・プラクティスにSmart Updateを適合させることができます。

パッチ・ダウンロード・ディレクトリを指定するには、次の手順を実行します:

1. Smart Updateを起動します。

2. Smart Updateのメイン・ウィンドウから、「ファイル」→「プリファレンス」を選択します。
「プリファレンス」ダイアログ・ボックスが表示されます。

3. 「プリファレンス」ダイアログ・ボックスの「パッチ・ダウンロード・ディレクトリ」セクションで、パッチ・ダウンロード・ディレクトリのパスを指定します。
パッチ・ダウンロード・ディレクトリに関する次の情報に注意してください。

- Smart Update 3.3.0をインストールすると、MW_HOME\utils\bsu\cache_dirディレクトリがデフォルトのパッチ・ダウンロード・ディレクトリとして作成されます。

- 別のディレクトリを指定しないかぎり、デフォルトのパッチ・ダウンロード・ディレクトリは、システムにダウンロードされるすべての製品のパッチを格納するために使用されます。つまり、この目的で使用されるディレクトリは、別のミドルウェア・ホーム・ディレクトリが作成されても変更されません。

- ミドルウェア・ホーム・ディレクトリが複数ある場合は、パッチ・ダウンロード・ディレクトリを、パッチを適用するインストール・ターゲットのMW_HOME\utils\bsu\cache_dirに変更することをお薦めします。そうすることで、Smart Updateをターゲット・インストールのミドルウェア・ホームから実行している場合でも、必要なパッチを適用できるようになります。

「ダウンロードされたパッチ」パネルでパッチ・セットを表示する

Smart Updateでは、Smart Updateのメイン・ウィンドウの「ダウンロードされたパッチ」パネルに表示されているSmart Updateパッチ・セットの表示モードを選択できます。Smart Updateパッチ・セットとは、単一のパッチにバンドルされたパッチの集まりのことです。パッチ・セットは、アップグレード・インストーラでのみインストールできるWebLogic Server用のOracleパッチ・セット・リリース(バージョン・アップグレード)と混同しないよう注意してください。

- インストール済のパッチ・セット内の各パッチのエントリおよびパッチ・セット自体のエントリを表示する場合は、「パッチ・セットとすべての構成パッチを表示する」を選択します。(これがデフォルトの設定です。)

- インストール済のパッチ・セットのエントリのみを表示し、パッチ・セットに属している個々のパッチのエントリは表示しない場合は、「パッチ・セットが存在し、完全な場合は、構成パッチを非表示にする」を選択します。

HTTPプロキシ情報の設定

Smart Updateを実行しているシステムがファイアウォールによって保護されている場合は、パッチをダウンロードするには、次のオプションのいずれかの指定が必要になる場合があります。これらの設定はSmart Updateクライアントの自動更新メカニズムにのみ適用します。Smart Updateは、Smart Updateクライアントの入手可能な更新バージョンがあるかどうかを確認し、入手できるバージョンがあれば、ダウンロードするように指示します。入手可能な更新をダウンロードすると、Smart Updateはその新しいバージョンに更新されます。

- HTTPプロキシを使用する
ダウンロードにHTTPプロキシ・サーバーを使用する場合は、このオプションを選択します。HTTPプロキシ・サーバーを使用するには、初めてダウンロード・サーバーにログインする前に、Smart Updateで次の設定を行う必要があります。その後、設定を変更する必要はありません。

「ログイン」ダイアログ・ボックスで、「オフライン」をクリックして、次の項目を指定します。

- ホスト: プロキシ・サーバーの名前またはIPアドレス

- ポート: プロキシ・サーバーのポート番号

- 認証を使用する
使用しているHTTPプロキシ・サーバーにサーバー側認証が必要な場合は、このオプションを選択します。このオプションを選択するには、以下を指定する必要があります。

- ユーザー名: プロキシ・サーバーに必要な、有効なユーザー名

- パスワード: ユーザーの有効なパスワード

4 パッチの適用

この章では、My Oracle Supportからダウンロードしてパッチ・ダウンロード・ディレクトリに格納したパッチの適用方法について説明します。

この項には次のトピックが含まれます:

- ターゲット・インストールの選択

- パッチ情報の表示

- パッチの適用および管理

- パッチ間の競合の解決

- メンテナンス・スナップショットの作成および使用

- クライアントへのパッチの適用

ターゲット・インストールの選択

Smart Updateでは、図4-1で示すように「ターゲット・インストール」パネルが表示されます。このパネルには、Smart Updateを開始した際に検出されたインストール済のWebLogic製品がすべて表示されます。次に示す例では、WebLogicプラットフォーム10.3 MP2(つまり10.3.2)が選択中のターゲット・インストールです。

図4-1 「ターゲット・インストール」パネル

これ以降にSmart Updateで実行する操作は、ターゲット・インストールとして選択されているインストールに対して実行されます。例:

- 「ダウンロードされたパッチ」パネルにリストされたパッチ・セットは、選択中のターゲット・インストールに固有のものです。選択中のターゲット・インストールに該当する製品以外のために作成されたパッチをSmart Updateで適用できません。

- My Oracle Supportから提供される検証データを使用して、競合が生じることが確認されているパッチの適用を防ぐ、Smart Updateの組込み機能であるパッチの検証も、選択中のターゲット・インストールのみに対して動作します。

パッチは、1つのターゲット・インストールに適用すると、このパネルにリストされた他のインストールには適用されません。たとえば、ある製品のインストールが同じミドルウェア・ホーム・ディレクトリ内または異なるミドルウェア・ホーム・ディレクトリ内に複数存在する場合、パッチを一度に適用できるのはいずれか1つのインストールに対してのみです。通常、1つのシステムに複数のミドルウェア・ホーム・ディレクトリを作成することはお薦めしません。

ターゲット・インストールの選択に際しては、次の事項に留意してください。

- このパネルに表示されるミドルウェア・ホーム・ディレクトリは、現在のシステムで検出されたものに限りません。他のシステムにあるディスクをリモート・マウントして、そこに現在のシステムから製品をインストールしたことがある場合は、そのリモート・ディスクにある製品のミドルウェア・ホーム・ディレクトリも表示されます。このように完全な一覧が表示されることで、リモート・システムにメンテナンス更新をインストールするのが容易になります。

注意:

Smart Updateグラフィカル・インタフェースでは、Smart Updateを実行しているシステム以外で作成されたミドルウェア・ホーム・ディレクトリは検出されません。

- パッチは、一度に1つのターゲット・インストールに対してのみインストールできます。同じ手順で複数のインストールに対してインストールできません。ただし、同じSmart Updateセッションで、複数のターゲット・インストールに対したパッチの適用が可能です。あるターゲット・インストールに対してパッチをインストールした後は、Smart Updateを再起動しなくても、引続き別のターゲット・インストールに対してパッチをインストールできます。

- 最後に選択したターゲット・インストールは、Smart Updateの終了時に記憶され、次回Smart Updateを起動したときにも強調表示されます。1つのミドルウェア・ホーム・ディレクトリに複数の製品インストールが含まれる場合、それらの製品インストールに対して更新を行う順序に制限はありません。

- 同じミドルウェア・ホーム・ディレクトリに属する製品インストールの一覧は、必要に応じて表示を展開したり、折りたたんだりできます。この表示はデフォルトでは展開されています。

- Smart Updateのコマンド・ライン・インタフェースを使用する場合は、Smart Updateの起動時に必ず-prod_dir=pathパラメータを含め、ターゲット・インストールのディレクトリを設定します。第8章「コマンド・ライン・インタフェースの使用」を参照してください。

他のミドルウェア・ホーム・ディレクトリの指定

「ターゲット・インストール」パネルにリストされていない他のミドルウェア・ホーム・ディレクトリも指定できます。

注意:

ローカル・ドライブ(ローカル・マウント・ボリューム)では、ミドルウェア・ホームが指定できる唯一のディレクトリです。

Smart Updateの起動時に有効なインストール対象がない場合は、ダイアログ・ボックスが表示されます。処理を継続する前に、ここでミドルウェア・ホームを指定する必要があります。

ミドルウェア・ホーム・ディレクトリを指定するには:

1. 「ファイル」→「ターゲット・インストール」→「他のBEAホームを探す」を選択します。

2. 有効なミドルウェア・ホーム・ディレクトリを指定し、階層を移動してディレクトリを選択するか、「場所」フィールドにパスを入力します。

3. 「OK」をクリックします。「ターゲット・インストール」パネルに新しいディレクトリが追加されます。

指定したディレクトリに有効なインストール・ターゲットがない場合は、エラー・メッセージが表示されます。

パッチ情報の表示

Smart Updateでは、必要に応じて、適用する前のパッチの詳細情報を読むことができます。特に、Smart Updateでは、2つのカテゴリのパッチに対してこのオプションが提供されます。これらのカテゴリには、My Oracle Supportからダウンロード可能な公開されているものと、すでにダウンロードして各自のシステム上またはアクセス可能なネットワーク・ディスク・ドライブに格納してあるものがあります。

注意:

ダウンロード可能な公開パッチの一覧を取得するには、My Oracle Supportにログインする必要があります。

パッチを表示する方法

「パッチの管理」タブでは、現在パッチ・ダウンロード・ディレクトリに存在するパッチがすべてリストされます。

- 現在選択されているパッチ・プロファイルを介してターゲット・インストールにすでに適用されているパッチは、トップ・パネルでリストされています。パッチ・プロファイルの詳細は、「パッチ・プロファイルについて」を参照してください。

- 選択中のパッチ・プロファイルのコンテキストにおいて、ターゲット・インストールにまだ適用されていないパッチは、「ダウンロードされたパッチ」パネルでリストされています。

「ダウンロードされたパッチ」パネルに表示される情報の詳細は、「現在ダウンロードされているパッチの表示」を参照してください。

現在のパッチ・ダウンロード・ディレクトリ以外のディレクトリにダウンロードされているパッチについても、「プリファレンス」ダイアログ・ボックスで目的のディレクトリを指定することにより、一覧を表示できます。詳細は、「パッチ・ダウンロード・ディレクトリを選択する」を参照してください。

「パッチの管理」タブに表示されるパッチについて

表4-1では、「パッチの管理」タブの上下部パネルの各列に表示される情報について説明します。パネルによって表示されない列があります。

表4-1 ダウンロード可能なパッチに関する情報

列のタイトル

説明

パッチID

パッチのIDは、パッチと関連付けられる一意の文字列です。パッチのIDの横に次に示す情報アイコンが表示されます。

バグ

パッチのIDに関連付けられるOracleバグ番号

説明

パッチの簡単な説明

製品

パッチの適用先となる製品の名前(WebLogic Server、Workshop for WebLogic、WebLogic Portal、JRockit、Oracle Service Busなど)。

カテゴリ

パッチが該当する製品カテゴリ。例:

- JMS - WebLogic JMS (Java Message Service)用のパッチ

- Security - WebLogicセキュリティ・サービス用のパッチ

- Console - WebLogic管理コンソール用のパッチ

削除

インストール済のパッチを削除するには、「削除」列の該当するアイコンをクリックしてください。

適用

ダウンロード済のパッチを適用するには、「適用」列の該当するアイコンをクリックしてください。

現在ダウンロードされているパッチの表示

「パッチの管理」タブには、選択中のターゲット・インストール用のパッチ・ダウンロード・ディレクトリの使用可能なパッチのリストが表示されます。このタブには、次のパネルがあります。

- パッチ・プロファイル・パネル - 現在のターゲット・インストールに対してすでに適用されているパッチのリストが表示されます。ターゲット・インストール全体に適用されているパッチを表すデフォルト・パッチ・プロファイルについては、「パッチ・プロファイルについて」で説明します。パッチ・プロファイル・パネルでは、作成した各カスタム・プロファイルに対して1つのタブが追加されています。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

- 「ダウンロードされたパッチ」 - 現在パッチ・ダウンロード・ディレクトリにあるパッチから、選択中のパッチ・プロファイルに対してまだターゲット・インストールに適用されていないもののリストが表示されます。ターゲット・インストールにパッチを適用すると、該当するパッチ・プロファイルに対しては、それ以降、適用したパッチのエントリが「パッチの管理」タブの「ダウンロードされたパッチ」パネルに表示されなくなります。詳細は、「ターゲット・インストールへのパッチの適用」を参照してください。

ディレクトリをパッチ・ダウンロード・ディレクトリとして指定すると、それに応じて「ダウンロードされたパッチ」パネルに表示されるパッチのリストが更新されます。パッチをダウンロードした場所がシステム環境内に複数あり、それらの場所にネットワーク・ディスク・ドライブを介してアクセスできる場合は、単に新しくパッチ・ダウンロード・ディレクトリを指定するだけでそれらのパッチにアクセスできます。別のパッチ・ダウンロード・ディレクトリの指定の詳細は、「パッチ・ダウンロード・ディレクトリの選択」を参照してください。

パッチ詳細の表示

パッチの詳細情報は、目的のパッチIDの横にある情報アイコンをクリックします。図4-2 パッチの詳細というダイアログ・ボックスで示すものと似たようなパッチの詳細のダイアログ・ボックスが表示されます。

図4-2 パッチの詳細のダイアログ・ボックス

Smart Updateのダイアログ・ボックスに表示される詳細情報の項目について、表4-2で説明します。

表4-2 パッチ詳細への鍵

この詳細は

次を示します

製品

パッチが適用される製品。

バージョン

パッチの適用対象となる製品のバージョン。

重大度

パッチがクリティカルか任意か。

カテゴリ

パッチが該当する製品カテゴリ。

再起動

パッチの適用後に再起動が必要となるソフトウェア・コンポーネント。

サイズ(KB)

パッチのサイズ(単位はKB)。

ステータス

パッチの利用可能性。My Oracle Supportからダウンロードするすべてのパッチは、ステータスが公開です。

OS

パッチの動作環境として想定されているオペレーティング・システム。

説明

パッチによって解決される問題の簡単な説明。

パッチの詳細を確認し、「OK」をクリックして「パッチの詳細」ダイアログ・ボックスを閉じ、Smart Update画面に戻ります。

パッチの適用および管理

パッチ・ダウンロード・ディレクトリにパッチをダウンロードした後は、ターゲット・インストールにパッチを適用できます。以下の節では、パッチを適用および管理する方法について説明します。

- パッチ・プロファイルについて

- ターゲット・インストールへのパッチの適用

- ターゲット・インストールからパッチの削除

パッチ・プロファイルについて

Smart Updateでは、パッチ・プロファイルという概念を使用してパッチのセットを管理します。パッチ・プロファイルには、適用されているパッチの一覧が収められます。すべてのターゲット・インストールには、デフォルト・パッチ・プロファイルが定義されています。デフォルト・パッチ・プロファイルに含まれるパッチはインストール全体で有効であり、そのインストールから実行されるすべてのアプリケーション、WebLogicドメイン、およびWebLogic Serverインスタンスについてもデフォルトで有効です。

一般的なメンテナンス要件に適合するために、デフォルト・パッチ・プロファイルだけはほとんどのユーザーが使用する必要があります。デフォルト・パッチ・プロファイルはあらかじめ用意されており、構成不要ですぐに使用できます。

カスタム・パッチ・プロファイルの作成も可能です。カスタム・パッチ・プロファイルを使用すると、インストール内の特定のサーバー、ドメインまたはアプリケーションを、インストールの一部にのみ適用する1つ以上のパッチ・セットに関連付けることができます。ただし、カスタム・パッチ・プロファイルを使用すると、インストールされた製品のメンテナンスがより複雑になります。カスタム・パッチ・プロファイルについては、第6章「個々のアプリケーション、ドメイン、またはサーバーへのパッチの適用」を参照してください。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

ターゲット・インストールへのパッチの適用

ターゲット・インストールにパッチを適用するには、「ダウンロードされたパッチ」パネルで、目的のパッチの横にある「適用」アイコンをクリックします。

注意:

予想外のエラーを避けるには、パッチ適用時にサーバーを停止します。

ターゲット・インストールにパッチを適用する場合、次の処理が実行されます。

1. 適用するパッチが、現在のパッチ・プロファイル内にあるパッチに対して検証されます。

注意:

ターゲット・インストールに複数のパッチ・プロファイルがあり、インストール全体のリソースに影響を与えるパッチを適用しようとすると、Smart Updateによって警告のポップアップが表示され、アラートが示されます。インストール全体に対して有効になるパッチとしては、システム・リソースを置き換えるパッチや、セキュリティ勧告に対応するためのパッチなどがあります。適用を続行することを選択すると、そのパッチは、ターゲット・インストールに定義されているすべてのパッチ・プロファイルに対して自動的に適用されます。

2. パッチ間の競合が発生しない場合は、パッチが適用されます。
競合が発生している場合は、競合の概要を示すパッチ・インストール検証ダイアログ・ボックスが表示されます。パッチは適用されません。

3. パッチは、適用されると、現在のパッチ・プロファイルに追加されます。このプロファイルの「パッチの管理」タブの「ダウンロードされたパッチ」パネルには表示されなくなります。

検証時に競合が検出された場合は、そのパッチを適用する前に競合を解決する必要があります。詳細は、「パッチ間の競合の解決」を参照してください。

パッチのタイプによっては、適用されたメンテナンスがユーザーのアプリケーションおよびWebLogicドメインで自動的にアクティブ化されない場合があります。デフォルト・プロファイルとカスタム・プロファイルのどちらにパッチが適用されたかに関係なく、パッチのタイプとシステムの環境および構成によっては、管理者が次のうちの1つ以上の操作を実行することが必要になる場合があります。

- サーバーの起動または再起動

- アプリケーションの起動または再起動

- アプリケーションのアンデプロイおよびデプロイ

- WebLogicドメインまたはサーバーの起動スクリプトの編集

- ライブラリ・モジュールのアプリケーションへのデプロイ

- ドメイン構成ファイルの編集

- アプリケーションの記述子ファイルの編集

ターゲット・インストールからパッチの削除

問題が予想どおりに解決されなかった場合や、パッチが不要になった場合またはパッチによって新たな問題が発生したためMy Oracle Supportから代替パッチが提供されるのを待つ場合など、適用済のパッチをターゲット・インストールから削除する必要がある場合、該当するパッチ・プロファイル内のリストで、削除するパッチの横にある「削除」アイコンをクリックします。

注意:

予想外のエラーを避けるには、パッチを削除時にサーバーを停止します。

ターゲット・インストールからパッチを削除する場合、次の処理が実行されます。

1. パッチ適用時の検証と同じように、削除操作についての検証が実行されます。ターゲット・インストールからパッチを削除する際には、現在のパッチ・プロファイルに含まれる他のパッチが削除するパッチに依存していないかどうかがSmart Updateによりチェックされます。

2. 競合が検出されると、具体的な競合の内容を示す「パッチの削除を検証」ダイアログ・ボックスが表示されます。競合が発生している場合は、そのパッチを削除する前に競合を解決する必要があります。

3. 削除によって発生する競合が検出されない場合は、次の処理が実行されます。

1. ターゲット・インストールおよび現在のパッチ・プロファイルから、該当するパッチが削除されます。

2. 削除されたパッチが、現在のパッチ・プロファイルに対して「パッチの管理」タブの「ダウンロードされたパッチ」パネルに表示されるようになります。

パッチを削除する際には、次の点に注意してください。

- ターゲット・インストールに複数のパッチ・プロファイルがある場合、インストール全体のリソースに影響するパッチを削除すると、Smart Updateの警告のポップアップが表示されアラートが示されます。削除を続行することを選択すると、そのパッチは、ターゲット・インストールに定義されているすべてのパッチ・プロファイルから自動的に削除されます。

- インストール全体に影響しないパッチを削除する場合は、現在のパッチ・プロファイルから該当するパッチが削除されます。

- 該当する製品インストール内にあるサーバー・インスタンスの実行時の動作に影響するパッチを削除した後は、パッチの削除を有効にするためにサーバーを再起動する必要があります。

削除によって発生する競合を解決する方法の詳細は、「パッチ間の競合の解決」を参照してください。

パッチ間の競合の解決

Smart Updateでは、適用または削除するパッチについて、ターゲット・インストールにすでに適用されている他のパッチとの互換性が検証されることにより、ご使用のシステムが保護されます。検証によって問題が検出されればパッチ間の競合として報告されるので、競合を解決してからパッチの操作を完了できます。

この節では、次の検証プロセスにおいて検出される場合がある競合の種類について説明します。

- パッチの適用時の検証

- パッチの削除時の検証

各節では、競合の種類ごとに、解決の手順についても説明します。

パッチの適用時の検証

パッチの適用プロセスでは、様々な種類の競合が報告される可能性があります。競合が報告された場合は、目的のパッチを適用する前に競合を解決する必要があります。

表4-3では、適用時の検証で報告される可能性がある競合の種類について説明し、それぞれの種類について解決の手順を示します。

表4-3 パッチの適用時の競合状況

この競合が報告された場合

適用するよう選択したパッチは

この競合を解決して選択したパッチを適用するには

前提条件が満たされていません

このパッチを適用する前に、別のパッチを適用する必要があります

1. 前提条件となっているパッチのIDを記録します。

2. 「取消」をクリックして、選択したパッチの適用プロセスを終了します。

3. ステップ1で確認した前提となるパッチをダウンロードして適用します。

4. 最初に選択したパッチを適用します。

順序が間違っています

このパッチを適用する前に、適用されている別のパッチをいったん削除する必要があります

1. 削除する必要のあるパッチのIDを記録します。

2. 「取消」をクリックして、選択したパッチの適用プロセスを終了します。

3. ステップ1で確認したIDのパッチを削除します。

4. 最初に選択したパッチを適用します。

5. ステップ3で削除したパッチをもう一度適用します。

相互に排他的です

すでに適用されている一部のパッチと共存できません

ターゲット・インストールに適用するパッチを選択し、必要に応じて適用します。

パッチの削除時の検証

表4-4では、パッチの削除時に検出される可能性がある競合について説明し、解決の手順を示します。

表4-4 パッチの削除時の競合状況

この競合が報告された場合

削除するよう選択したパッチは

この競合を解決して選択したパッチを削除するには

依存関係違反

このパッチを必要とする別のパッチがすでに適用されています

1. 依存しているパッチのIDを確認します。

2. ダウンロード・プロセスを終了するには「取消」をクリックします。

3. 依存しているパッチを必要に応じて削除します。

4. 本来削除しようとしていた目的のパッチを削除します。

メンテナンス・スナップショットの作成および使用

問題解決に必要な情報をMy Oracle Supportに提供する作業が容易になるように、Smart Updateでは、特定のパッチ・プロファイルに適用されているパッチに関する情報を簡単にキャプチャする機能が用意されています。その機能は、メンテナンス・スナップショットと呼ばれます。これは、「パッチの管理」タブで選択されたパッチ・プロファイルの情報と、そのプロファイルに適用されている各パッチのIDなどの情報を含む、プレーンなASCIIファイルです。

My Oracle Supportに問題を報告すると、問題解決の最初の手順として、このスナップショットを提供するよう求められます。このため、問題が発生した場合は、メンテナンス・スナップショットを用意した上でカスタマ・サポートにご連絡ください。

メンテナンス・スナップショットは、Smart Updateグラフィカル・インタフェースを使用してすぐに作成できます。

1. Smart Updateのメイン・ウィンドウにある「ターゲット・インストール」パネルで、報告する問題が発生した製品インストールを選択します。

2. 「パッチの管理」タブで、報告する問題が発生したパッチ・プロファイルを選択します。

3. 「パッチ」→「パッチ・プロファイル」→「スナップショットの保存」を選択します。
メンテナンス・スナップショットの名前と場所の指定を求めるダイアログ・ボックスが表示されます。デフォルトでは、メンテナンス・スナップショット・ファイルはMW_HOME\utils\bsu内に作成されます。別の場所を指定する場合は、目的の場所にあるファイルへのアクセスに必要な権限があることを確認してください。

メンテナンス・スナップショットは、Smart Updateコマンド・ライン・インタフェースを使用して作成することもできます。例については、「コマンド・ライン・インタフェースの例」を参照してください。

メンテナンス・スナップショットを作成する際は、次の習慣を守ることをお薦めします:

- 1つの製品インストールに関するメンテナンス・スナップショットは1つの場所にまとめ、見つけやすい場所に保存します。

- 他のメンテナンス・スナップショットと混同しないよう、内容を区別しやすいファイル名を付けます。たとえば、パッチ・プロファイルの名前を指定します(MyCustomProfile.txtなど)。

メンテナンス・スナップショットをMy Oracle Supportに送付する際には、サポート関連の行動を必ず記録しておいてください。

クライアントへのパッチの適用

WebLogic Serverパッチはサーバー、クライアントまたは両方で適用できます。この節ではクライアントにパッチを適用するのに必要な手順を示します。

1. 第2章「パッチのダウンロード」の説明に従って、パッチをダウンロードします。

2. 第3章「ダウンロードされたパッチの解凍」の説明に従ってパッチJARファイルを展開します。

3. 適切なディレクトリにパッチJARファイル内のクラス・ファイルをコピーするか、ファイルが置かれたディレクトリへのパスをクラスパスの先頭に配置してJMSクライアント環境でクラスJARを参照します。

5 インストールおよびアプリケーションにおける適用済パッチのアクティブ化

この項には次のトピックが含まれます:

- 概要

- クラスパス、拡張クラスパス、およびネイティブ・ライブラリ・パッチ

- 起動スクリプトの修正

- 起動スクリプト・エディタの使用

- カスタム・スクリプト経由のパッチですべてのドメインとサーバーをポイントする方法

- モジュール・パッチの適用

- ネイティブ・バイナリとその他のアーティファクトのパッチ

- 共有アーカイブ・パッチ

概要

WebLogicシステム・クラスパスや、WebLogic Server上にデプロイされたアプリケーションのクラスパスなどのようなクラスパス内にロードされるクラスを含んだパッチを適用した後は、それらのクラスが適切なクラスパスに正しく挿入されたことを必ず確認してください。そうでない場合、それらは有効になりません。同様に、ライブラリ・パス内に挿入されるライブラリ・ファイルを含んだパッチについては、それらを使用するサーバー・インスタンスやアプリケーションが起動したときに、ライブラリ・ファイルを示すパスが正しく処理されることを必ず確認してください。

製品インストールに対するパッチ適用の際にSmart Updateで使用される方法は一律ではなく、パッチの種類および内容に応じて異なります。パッチには、次のいずれかが収められています:

- 製品インストール内のリソースに対する置換え

- クラスローディング・メカニズムで使用されるクラス・ファイル(クラスパスや拡張ディレクトリのファイルなど)

- ライブラリ・パスに含められるライブラリ・ファイル
ライブラリ・ファイルを含んだパッチは、ターゲット・インストール内にすでに存在するファイルを置き換えるものとは限りません。そのため、起動スクリプトによって明示的にロードする必要があります。

- デプロイしてアプリケーションで参照する必要がある共有アーカイブ

- モジュールと呼ばれるエンティティを更新するパッチJARファイル

パッチが適用される方法と、システム上でパッチがSmart Updateにより管理される方法については、次の項を参照してください。起動スクリプトを変更するかどうかおよび変更方法を判断するためには、これらを理解しておく必要があります。

- 起動スクリプトによる参照が必要とされるパッチ

- すべてのアプリケーション、ドメインおよびサーバーに対してリソースを置き換えるパッチ

- アプリケーションによるデプロイおよび参照が必要とされるパッチ

- システム上でのSmart Updateによるパッチ・ファイル格納方法

- インストール・レベルのパッチ・ディレクトリの構造

この項では、WebLogicドメインに適用するパッチが有効になることを確認する場合に実行する必要のある基本的な作業についても説明します。

- 起動スクリプトによる参照が必要とされるパッチ

- すべてのアプリケーション、ドメインおよびサーバーに対してリソースを置き換えるパッチ

- アプリケーションによるデプロイおよび参照が必要とされるパッチ

起動スクリプトによる参照が必要とされるパッチ

起動スクリプトによってロードされるクラスまたはライブラリ・ファイルを含んだパッチの場合、それらのクラスやファイルはSmart Updateによって、システム上にあるインストール・レベルのパッチ・ディレクトリに一元的に格納されます。これにより、クラスやライブラリ・ファイルは、それらを使用するWebLogic Serverインスタンスの起動時にロードできる状態になります。

このカテゴリに属するパッチの例として、次のようなものがあります

- WebLogic Serverシステム・クラスパスにロードされるクラス・ファイル

- WebLogic Server上にデプロイされたアプリケーションのクラスパスにロードされるクラス・ファイル

- WebLogic Serverライブラリ・パスにロードされるライブラリ・ファイル

注意:

パッチの検証およびターゲット・インストールへの適用はいつでも実行できますが、ただちに有効にならないパッチもあります。(a)クラスパスにロードされるクラスおよび(b)ライブラリ・パスにロードされるネイティブ・ライブラリ・ファイルのいずれかが含まれるパッチは、(a)必要に応じて、適切なWebLogicドメインまたはサーバーの起動スクリプトに変更を加えてパッチを参照するようにしたうえで、(b)対応するドメインまたはサーバーを再起動するまで、有効になりません。

すべてのアプリケーション、ドメインおよびサーバーに対してリソースを置き換えるパッチ

製品インストールに含まれる既存のリソースを置き換えるパッチは、適用と同時に、そのインストール全体に対して自動的に有効になります。起動スクリプトによって有効化されるのではありません。したがって、システム・リソースの置換えを含んだパッチの場合、起動スクリプトに変更を加える必要はありません。

置換えアーティファクトを含んだパッチの一般的な内容の例を次に示します。

- Webサーバー・プラグインのリソース

- ソケット・マルチプレクサ

- ダイナミック・リンク・ライブラリ

注意:

Smart Updateでは、置き換えられたファイルがインストール・レベルのパッチ・ディレクトリのbackupサブディレクトリに格納されます。その後、置換えが含まれるパッチを削除すると、元のリソースがバックアップから復元されます。(バックアップの詳細は、表5-1を参照してください。)ただし、最大限の安全性を確保するために、システム・リソースを置き換えるパッチを適用する前には、置換え予定のシステム・リソースすべてについて別途バックアップを作成することをお薦めします。

アプリケーションによるデプロイおよび参照が必要とされるパッチ

共有アーカイブのパッチは、これを必要とするアプリケーションにより明示的にデプロイし、参照する必要があります。共有アーカイブのパッチをすべてのアプリケーションではなく、選択されたアプリケーションに適用する場合は、固有のパッチ・レベルごとにカスタム・パッチ・プロファイルを作成する必要があります。

システム上でのSmart Updateによるパッチ・ファイル格納方法

My Oracle Supportからパッチをダウンロードすると、パッチ・ダウンロード・ディレクトリにパッチ・コンテナが配置されます。パッチ・コンテナには次の内容が収められています。

- パッチ
1つのパッチには複数のファイルが含まれている場合があります。次のようなファイルが含まれます

- クラスの置換え用として提供される同名のクラス(サーバー起動時にWebLogicシステム・クラスパスに挿入される)

- ネイティブ・ライブラリ・ファイル(システム・パスに挿入される)

- 構成ファイル

- そのパッチ・コンテナに含まれる各パッチに関するメタデータ
メタデータは、各パッチを、同じ製品インストールに適用されている他のすべてのパッチに対して検証するためにSmart Updateで使用される情報です。(パッチを適用すると、メタデータは、システム上のSmart Updateによって管理されるディレクトリにあるパッチ・レジストリに置かれます。詳細は、「インストール・レベルのパッチ・ディレクトリの構造」を参照してください。)

パッチ・プロファイルに対してパッチが適用されると、そのパッチに含まれる個々のファイルは次のように処理されます。

- システム・リソース(WebLogic Serverプラグイン・モジュールなど)に対する置換えを含んだパッチの場合、該当する既存のリソースが、その置換えによって自動的に更新されます。

- パッチJARファイル(ターゲット・インストール内にある同名のクラスに対する更新としてクラスパスにロードされるクラスのセット)がパッチに含まれている場合、次のイベントがj発生します:

- パッチJARファイルがインストール・レベルのパッチ・ディレクトリに配置されます。このディレクトリについては、「インストール・レベルのパッチ・ディレクトリの構造」を参照してください。

- パッチ・マニフェストJAR(パッチJARファイル内にあるクラスへのポインタを含んだファイル)がSmart Updateにより作成されます。現在のプロファイルに対するパッチ・マニフェストJARが存在する場合は、既存のパッチ・マニフェストJARが更新され、新しいパッチJARファイル内にあるクラスへのポインタが追加されます。パッチ・マニフェストJARファイルについては、「パッチ・マニフェストJARファイル」の説明を参照してください。

- パッチが環境変数PATHまたはLIBPATHを介してシステム・ライブラリ・パスにロードされるネイティブ・ライブラリ・ファイルを含む場合、Smart Updateでは、現在選択されているパッチ・プロファイル専用のnativeというサブディレクトリの有無の確認が行われます。このサブディレクトリが見つからない場合は、作成されます。nativeサブディレクトリについては、「「起動スクリプトを開く」ダイアログ・ボックスのアイコン」を参照してください。

インストール・レベルのパッチ・ディレクトリの構造

製品をインストールし、Smart Updateを実行すると、パッチ・ディレクトリが作成されます。各製品(WebLogic Server、Workshop for WebLogic、WebLogic Integration、WebLogic Portalなど)には、ミドルウェア・ホーム・ディレクトリの下に独自のパッチ・ディレクトリ構造(patch_wls1001、patch_wlw1020、patch_wli1020、patch_wlp1020など)があります。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

製品固有パッチ・ディレクトリ構造は、製品のパッチ・メンテナンスの新しい区分を提供します。またそれによって、今後の製品が、WebLogic Serverの異なる、または共通のバージョン間で相互運用する際の柔軟性も向上します。

図5-1は、MW_HOME\patch_productディレクトリの構造を示しています。

図5-1 インストール・レベルのパッチ・ディレクトリ

表5-1では、各パッチ・ディレクトリの内容について説明します。

表5-1 インストール・レベルのパッチ・ディレクトリ内のディレクトリとファイル

このディレクトリは

次を含みます

patch_product\backup

システムを以前のパッチ・レベルに復元するために必要なファイルおよび情報が格納されているパッチ・バックアップ・マニフェストを含みます。

このディレクトリは、製品インストール・ディレクトリ内に配置されるファイルを含んだ、インストール全体を対象とするパッチを適用すると、作成されます。

patch_product\patch_jars

各製品のパッチ・ディレクトリ(図5-1に示すpatch_wlp1020、patch_wls1001、patch_wlw1020など)にあるパッチJARファイルには、システム上の製品インストールに適用された各種パッチのクラスJARファイルが含まれています。

各製品のパッチ・ディレクトリの下の1つのパッチJARファイルには、次のうち1つまたは複数のものが含まれます。

- インストール内の同名のクラスに対する置換えとして提供されたクラス。これらのクラスは、WebLogicシステム・クラスパスに挿入する必要があります。

- なんらかの製品に必要なクラス。これらのクラスは、WebLogic Server上にデプロイされたアプリケーションに挿入する必要があります。

注意: システム・リソースに対する置換えを含むパッチJARファイルは、このディレクトリ(patch_jars)には保存されません。

注意: 追加されるパッチJARファイルの格納に十分なディスク領域があるか確認しておくことをお薦めします。JARファイルを含んだパッチのサイズについては、「パッチ情報の表示」を参照してください。

patch_product\profiles\default

デフォルトのパッチ・プロファイルのディレクトリ。パッチを適用すると、次のうち1つまたは複数のサブディレクトリが作成される場合があります。

- profiles\default\sys_manifest_classpath
パッチ・マニフェストJARファイルweblogic_patch.jarが格納されます。このファイルには、WebLogicシステム・クラスパスに挿入される(patch_jarsディレクトリの)パッチJARファイル内にあるクラスへの参照が含まれています。パッチ・マニフェストJARファイルについては、「パッチ・マニフェストJARファイル」の説明を参照してください。

注意: My Oracle Supportが発行するパッチの大半は、weblogic_patch.jarで参照されます。

- profiles\default\sysext_manifest_classpath
WebLogic拡張ディレクトリ・パッチ・マニフェストJARファイルweblogic_ext_patch.jarが格納されます。このファイルには、なんらかの製品に必要とされ、その製品に基づいてWeblogic Server上にデプロイされるアプリケーションのクラスパスに挿入する必要がある、パッチJARファイル内にあるクラスへの参照が含まれています。weblogic_ext_patch.jarで参照されるパッチJARファイルも、patch_jarsディレクトリに格納されます。

注意: sysext_manifest_classpathディレクトリはWebLogic Server 9.1では使用されません。

- profiles\default\native
システム・ライブラリ・パスに挿入され、インストール先にある同名の既存ライブラリに(置換えではなく)取ってかわる、ネイティブ・ライブラリ・ファイルが格納されます。詳細は、「ネイティブ・ライブラリ・ファイル」を参照してください。

- profiles\default\modules
Open Services Gateway initiative (OSGi)ベースの製品で使用されるモジュール・ファイルが格納されます。このディレクトリの内容は、クラスパスを通じてモジュールがロードされる、WebLogic Serverベースの製品では使用されません。詳細は、「モジュール・パッチ・ファイル」を参照してください。

patch_product\profiles\custom-profile-name

カスタム・パッチ・プロファイル用のディレクトリ。カスタム・パッチ・プロファイルの名前がディレクトリ名となります。カスタム・パッチ・プロファイルが1つ作成されるたびに、そのプロファイルの名前を持つディレクトリが自動的に作成されます。カスタム・パッチ・プロファイルの各ディレクトリには、次のうち1つまたは複数のサブディレクトリが含まれます。

- profiles\custom-profile-name\sys_manifest_classpath
パッチ・マニフェストJARファイルweblogic_patch.jarが格納されます。このファイルには、このカスタム・パッチ・プロファイルを示すサーバー・インスタンスのWebLogicシステム・クラスパスに挿入される、パッチJARファイル内にあるクラスへの参照が含まれています。

- profiles\custom-profile-name\sysext_manifest_classpath
WebLogic拡張ディレクトリ・パッチ・マニフェストJARファイルweblogic_ext_patch.jarが格納されます。このファイルには、このカスタム・パッチ・プロファイルを示すWebLogic Serverインスタンス上にデプロイされたアプリケーションのクラスパスに挿入される、patch_jarsディレクトリのパッチJARファイル内にあるクラスへの参照が含まれています。

注意: sysext_manifest_classpathディレクトリはWebLogic Server 9.2では使用されません。

- profiles\custom-profile-name\native
このカスタム・パッチ・プロファイルを参照するサーバー・インスタンスのシステム・ライブラリ・パスに挿入されるネイティブ・ライブラリ・ファイルが格納されます。

- profiles\custom-profile-name\modules
OSGiベースの製品で使用されるモジュール・ファイルが格納されます。

- profiles\custom-profile-name\archives
このカスタム・パッチ・プロファイルを示すアプリケーションによりデプロイおよび参照される共有アーカイブ・ファイルが格納されます。

patch_product\registry

次に関する情報が含まれます

- その製品インストールに適用されているすべてのパッチ

- パッチによって置き換えられた製品のインストール・ファイル

この情報は、パッチ検証などの処理を実行するためにSmart Update内部で使用されます。

パッチ・マニフェストJARファイル

同名の既存クラスに取ってかわるためにクラスパスに挿入されるクラスを含んだパッチは、パッチ・マニフェストJARによって参照されます。そのようなクラスを含んだパッチをパッチ・プロファイルに適用すると、対象プロファイルのパッチ・マニフェストJARファイルがSmart Updateによって自動的に更新され、新しいパッチ内にあるクラスを参照するようになります。

たとえば、パッチにBug10131320_1032.jarという名前のJARファイルが含まれ、このファイルにWebLogicシステム・レベル・クラスがある場合、そのパッチをデフォルト・パッチ・プロファイルに適用すると、Smart Updateにより次の処理が実行されます。

- Bug10131320_1032.jarがMW_HOME\patch_wls1032\patch_jarsディレクトリに追加されます。

- 次のファイルが存在しない場合、作成されます。

MW_HOME\patch_wls1032\profiles\default\sys_manifest_classpath\weblogic_patch.jar

- weblogic_patch.jar内に、Bug10131320_1032.jar内のWebLogicシステム・クラスを指す次の参照が追加されます。

Class-Path: C:\Oracle\Middleware\patch_wls1032\patch_jars\Bug10131320_1032.jar

- MW_HOME\patch_wls1032\registryディレクトリ内のパッチ・レジストリ情報が更新されます。

ネイティブ・ライブラリ・ファイル

対応するWebLogic Serverインスタンスの起動時にシステム・ライブラリ・パスにロードされるネイティブ・ライブラリ・ファイルを含んだパッチの場合は、適用先パッチ・プロファイルのnativeサブディレクトリにそれらのライブラリ・ファイルが格納されます。

たとえば、サーバー起動時にシステム・ライブラリ・パスにロードされるlibmuxer.soというファイルがパッチに含まれているとします。このパッチをデフォルト・パッチ・プロファイルに適用すると、Smart Updateにより次の処理が実行されます。

- 次のディレクトリが存在しない場合、作成されます。

MW_HOME\patch_wls1032\profiles\default\native

- 次のディレクトリにlibmuxer.soが配置されます。

MW_HOME\patch_wls1032\profiles\default\native

- 次のディレクトリ内で管理されているパッチ・レジストリ情報が更新されます。

MW_HOME\patch_wls1032\registry

モジュール・パッチ・ファイル

共通のモジュール・パッチか製品固有のモジュール・パッチかにかかわらず、モジュール・パッチが適用された場合、Smart Updateによって、MW_HOME\patch_product\profiles\profileName\modulesディレクトリにパッチが追加されます。元のモジュールJARファイルは修正されません。この方法が取られているのは、適用したパッチの有効範囲を限定するためです。

たとえば、WebLogic Event Server用モジュール・パッチがMW_HOME\wlevs20\modules\com.bea.wlevs.processor.monitor_2.0.0.0.jarに更新したクラスを含み、そのパッチがデフォルト・パッチ・プロファイルに適用された場合、Smart Updateでは次のタスクが実行されます。

1. 次のディレクトリが存在しない場合、作成されます。

MW_HOME\patch_wlevs20200\profiles\default\modules

2. 更新されたcom.bea.wlevs.processor.monitor_2.0.0.0.jarを、MW_HOME\patch_wlevs20200\profiles\default\modulesディレクトリに追加します

3. MW_HOME\patch_wlevs20200\registryディレクトリ内のパッチ・レジストリ情報が更新されます。

WebLogic Event Serverが起動すると、MW_HOME\wlevs20200\modulesディレクトリにまだある元のモジュールではなく、MW_HOME\patch_wlevs20200\profiles\default\modulesにあるパッチ適用済のモジュールが使用されます。

クラスパス、拡張クラスパス、およびネイティブ・ライブラリ・パッチ

次の場合は、起動スクリプトに変更を加えなくても、クラスパスおよびライブラリ・パスに対するパッチがWebLogicドメイン・サーバーの起動時に正しく取り込まれると考えられます。

- WebLogicドメイン用に構成したOracle製品サーバー・インスタンスを起動するためのデフォルト・スクリプトを構成ウィザードで生成し、実際のWebLogicドメインでそのスクリプトを使用している場合。

- パッチの適用範囲を特定のWebLogicドメインやサーバー・インスタンスに限定する必要がない場合。

それ以外の場合は、追加の作業手順を実行して、製品サーバーの起動時にパッチが適切なクラスパスやライブラリ・パスに挿入されるようにする必要があります。追加の作業手順が必要となるのは、パッチを適用した製品の使用環境に次のいずれかが該当する場合です。

- WebLogicドメイン内のサーバーを起動するときに、デフォルトのcommEnvスクリプトを呼び出さない、カスタム・スクリプトを使用します。
Windows:

WL_HOME\common\bin\commEnv.cmd

UNIX:

WL_HOME/common/bin/commEnv.sh

- 特定の製品インストール上で動作するすべてのドメインおよびサーバーにパッチを広く適用するのではなく、特定のWebLogicドメインまたはサーバーのみに適用範囲を限定する必要があります。

ここでは、スクリプトの使用方法およびSmart Update Start Script Editorを使用しての起動スクリプトの変更方法について説明します。なお、すべてのWebLogicドメインおよびサーバーにクラスパス、拡張クラスパスおよびネイティブ・ライブラリ・ファイルのパッチを参照させるために使用できるカスタム・スクリプトについても説明します。

注意:

Workshop for WebLogic (10.1以降のリリース)では、ランタイムWebLogic Serverパッチは自動的に有効化されません。Smart Updateを使用してパッチを適用したら、Workshop IDEでランタイムWebLogic Serverのパッチ・プロファイルも指定する必要があります。詳細は、Workshop for WebLogicのドキュメントを参照してください。

起動スクリプトに対するパッチの場所の指定について

WebLogic Serverインスタンスの起動時、パッチが確実にクラスパスまたはシステム・ライブラリ・パスにロードされるようにするために、該当するサーバーの起動スクリプトにパッチへのポインタを追加することが必要な場合があります。次の項では、Smart Updateの動作と、起動スクリプトに加える必要がある変更の内容について説明します。

- すべてのWebLogicドメインおよびサーバーで使用されるクラス・パスとライブラリ・パスを定義したデフォルト・スクリプト

- デフォルト・パッチ・パス環境変数

- パッチ・パス変数がクラス・パスおよびライブラリ・パスに挿入される際の規則

- サーバー起動スクリプト内でのパッチ・パス変数の設定について

すべてのWebLogicドメインおよびサーバーで使用されるクラス・パスとライブラリ・パスを定義したデフォルト・スクリプト

WebLogic Serverインスタンスが起動する際には、いくつかの起動スクリプトが実行されます。そうしたスクリプトで実行される処理の1つに、システムで使用されるクラスパスとライブラリ・パス(WebLogicシステム・クラスパスなど)の定義があります。デフォルトでは、すべてのWebLogic Serverインスタンスで、次のいずれかのスクリプト内で設定されるクラスパスおよびライブラリ・パス定義が使用されます。

Windows:

WL_HOME\common\bin\commEnv.cmd

UNIX:

WL_HOME/common/bin/commEnv.sh

注意:

UNIX環境でcommEnv.shをコマンド・ラインから手動で実行するか、カスタム・サーバー起動スクリプトから呼び出す場合は、次の構文を使用する必要があります。

. WL_HOME/common/bin/commEnv.sh

または

. ./commEnv.sh(すでにbinディレクトリに移動している場合)

デフォルト・パッチ・パス環境変数

commEnvスクリプトには、表5-2で説明する環境変数のデフォルトの定義が含まれています。デフォルトでは、それらのパッチ・パス変数はすべてのWebLogic Serverインスタンスが起動する際に使用されます。また、クラス・パスとライブラリ・パスに挿入されるパッチをポイントしています。

表5-2 commEnvスクリプト内で定義されるパッチ・パス変数

この変数は

次のロケーションに設定されています

PATCH_CLASSPATH

デフォールトのパッチ・プロファイル用のパッチ・マニフェストJARファイル(weblogic_patch.jar)です。

このJARファイルには、WebLogicのシステム・クラスパスにロードされるパッチJARファイル内にあるクラスへの参照が含まれています。たとえば、Windowsの場合、commEnvスクリプトのデフォルトの定義は次のとおりです。

if "%PATCH_CLASSPATH%" == "" set PATCH_CLASSPATH=
%WLS_PATCH_CLASSPATH%;%WLW_PATCH_CLASSPATH%

注意: My Oracle Supportから提供されるパッチの多くは、PATCH_CLASSPATHで参照されるWebLogicシステム・クラスパス・パッチです。

WEBLOGIC_EXTENSION_DIRS

デフォールトのパッチ・プロファイル用のWebLogic拡張ディレクトリ・パッチ・マニフェストJARファイル(weblogic_ext_patch.jar)です。

このJARファイルには、WebLogicサーバーにデプロイされているアプリケーションのクラスパスにロードされたパッチJARファイル内にあるクラスへの参照が含まれています。たとえば、Windowsの場合、commEnvスクリプトのデフォルトの定義は次のとおりです。

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のみ)

デフォルトのパッチ・プロファイル用のインストール・レベルのディレクトリ内のnativeフォルダ

このフォルダには、LIBPATH環境変数を介してシステム・ライブラリ・パスにロードするファイルが含まれています。たとえば、UNIXの場合、commEnvスクリプトのデフォルトの定義は次のとおりです。

if [ "${PATCH_LIBPATH}" = "" ];
then PATCH_LIBPATH=${BEA_HOME}
/patch_wls1030/profiles/default/native

PATCH_PATH

(Windowsのみ)

デフォルトのパッチ・プロファイル用のインストール・レベルのパッチ・ディレクトリ内のnativeフォルダ

このフォルダには、PATH環境変数を介してシステム・パスにロードするファイルが含まれています。たとえば、Windowsの場合、commEnvスクリプトのデフォルトの定義は次のとおりです。

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ファイルのクラス

サーバー起動スクリプト内でのパッチ・パス変数の設定について

「すべてのドメインおよびサーバーで使用されるクラス・パスとライブラリ・パスを定義したデフォルト・スクリプト」で説明するパッチ・パス変数が、WebLogic Serverインスタンスの起動に先立って実行されるスクリプト(startWebLogic、setDomainEnvなど)の中で定義されている場合、該当するサーバー・インスタンスに対してはそうした既存の定義内容が使用されます。commEnv内の変数定義によってオーバーライドされることはありません。

たとえば、MyTestDomainドメインのsetDomainEnvスクリプトに、MyTestDomain内のすべてのWebLogic Serverインスタンスで使用するPATCH_CLASSPATH変数の定義が含まれている場合、該当するサーバー・インスタンスに対してはその定義内容が使用され、commEnvスクリプト内のPATCH_CLASSPATHはオーバーライドされます。したがって、起動スクリプト内にパッチ・パス変数の定義を追加する際は、別の起動スクリプトを呼び出す文よりも前に定義を記述する必要があります。

個々のWebLogic Serverインスタンスそれぞれについて、必要なすべてのパッチを使用して起動が正しく行われるようにしてください。使用環境において、いずれかのパッチ・パス変数を定義してWebLogic Serverインスタンスを起動することが求められる場合は、次の事項を理解しておく必要があります。

- 製品インストール環境において各種スクリプトが実行されるデフォルトの順序。「起動スクリプトの実行順序」を参照してください。

- 構成ウィザードで作成されるデフォルト起動スクリプトに含まれている、パッチ・パス変数定義用の各種プレースホルダー。「デフォルト・スクリプト内のパッチ・パス変数定義用プレースホルダー」を参照してください。

起動スクリプトの実行順序

使用環境内にある各種の起動スクリプトが実行される順序と、起動スクリプトが呼び出される場所について理解していれば、変更を加える必要のあるスクリプトを判断し、すべてのターゲット・サーバー・インスタンスに必要なすべてのパッチ・パス変数について、確実に正しい値が代入されるようにすることができます。

WebLogic Serverインスタンスを起動し、各WebLogicドメインおよびOracle製品インストールに対して変数を設定するデフォルト・スクリプトが用意されています。

それらのスクリプトは、各スクリプトの内容に応じて決まる特定の順序に従って実行されます。

次の点について、表5-3で説明します。

- サーバー、WebLogicドメイン、および製品インストールに対して作成される各種のデフォルト・スクリプト

- 各スクリプトの機能

- スクリプトが実行される順序

表5-3 製品インストールに含まれるスクリプトのデフォルト・セット

このスクリプトは

この機能を実行します

実行されるとき

WebLogicドメインのbinディレクトリ内:

Windows:

startManagedWebLogic.cmd

UNIX:

startManagedWebLogic.sh

ドメイン内の管理対象サーバーを起動します。スクリプト内で定義されるパッチ・パス変数は、当該スクリプトから起動されるすべての管理対象サーバーで使用されます。

構成に管理対象サーバーが含まれるドメイン(クラスタなど)では、このスクリプトはデフォルトで最初に実行されます。

このスクリプトからは、startWebLogicスクリプトが呼び出されます。

WebLogicドメインのbinディレクトリ内:

Windows:

startWebLogic.cmd

UNIX:

startWebLogic.sh

ドメイン内のWebLogic Serverインスタンスを起動します。スクリプト内で定義されるパッチ・パス変数は、ドメイン・サーバーすべて(すでに起動しているものを除く)に対して有効になります。

たとえば、前もって実行されたstartManagedWebLogicスクリプトに管理対象サーバー用のパッチ・パス変数定義が含まれている場合、startManagedWebLogicスクリプトで起動される管理対象サーバーに対しては、startWebLogicスクリプト内のパッチ・パス変数定義がオーバーライドされます。

構成に管理対象サーバーが含まれるドメインでは、このスクリプトはデフォルトでstartManagedWebLogicスクリプトから呼び出されます。

startWebLogicスクリプトからは、setDomainEnvスクリプトが呼び出されます。

WebLogicドメインのbinディレクトリ内:

Windows:

setDomainEnv.cmd

UNIX:

setDomainEnv.sh

WebLogic Serverインスタンスを起動および実行するためのドメイン全体の環境を設定します。スクリプト内で定義されるパッチ・パス変数は、ドメイン・サーバーすべて(startManagedWebLogic、startWebLogicなどサーバー固有のスクリプトから起動されるものを除く)に対して有効になります。

このスクリプトは、デフォルトでstartWebLogicスクリプトから呼び出されます。

setDomainEnvスクリプトには、commEnvスクリプト(そのドメインについてサーバー起動スクリプトやsetDomainEnvスクリプトで定義されない設定を定義)の呼出しが含まれています。

インストールのWL_HOME\common\binディレクトリ内:

Windows:

commEnv.cmd

UNIX:

commEnv.sh

WebLogic Serverインスタンスを起動および実行するための、ドメイン全体の環境を設定します。スクリプト内で定義されるパッチ・パス変数は、ドメイン・サーバーすべて(startManagedWebLogic、startWebLogicなどサーバー固有のスクリプトから起動されるものを除く)に対して有効になります。

デフォルトでは、当該インストール上で起動および実行されるサーバー用に設定を定義するために呼び出されるスクリプトとしてはこれが最後です。

注意: UNIX環境でcommEnv.shをコマンド・ラインから手動で実行するか、カスタム・サーバー起動スクリプトから呼び出す場合は、次の構文を使用する必要があります。

. WL_HOME/common/bin/commEnv.sh

すでにbinディレクトリに移動している場合は、次の構文を使用します。

. ./commEnv.sh

デフォルト・スクリプト内のパッチ・パス変数定義用プレースホルダー

構成ウィザードを使用してWebLogicドメインを作成すると、次に説明するとおり、パッチ・パス変数定義用のプレースホルダーを含んだスクリプトがそのドメイン用に作成されます。

- 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

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

commEnvスクリプトにデフォルトで含まれているこれらの変数の定義については、表5-2を参照してください。

パッチ・パス変数定義の追加作業を支援するために、Smart Updateには起動スクリプト・エディタが用意されています(「起動スクリプト・エディタの使用」の説明を参照)。

注意:

1つの起動スクリプト内で参照するWebLogicシステム・レベル・クラスのパッチ・マニフェストJARファイルは1つだけにしてください。複数のファイルを参照すると、実行時に予期できない動作が生じることがあります。

- 構成ウィザードで作成されるstartWebLogicおよびstartManagedWebLogic起動スクリプトには、パッチ・パス変数定義用のプレースホルダーはありません。これらのスクリプトのいずれかに1つ以上の変数定義を追加する場合は、どのWebLogic Serverインスタンスに影響が及ぶかについて十分に注意してください。
パッチ・パス変数定義を追加する起動スクリプトの数を最小限にとどめることにより、インストール済の製品のメンテナンス・レベルやバージョンを変更またはアップグレードした場合、起動スクリプト関連で必要となるメンテナンス作業の量が軽減されます。

起動スクリプトの修正

起動スクリプトでプロファイル内のクラスのパッチまたはライブラリ・ファイルのパッチを参照する場合に実行が必要な固有の作業は、これらのパッチの適用範囲が、製品インストール上で実行されているすべてのWebLogicドメインおよびサーバーを対象としているのか、そのインストールの特定のドメインまたはサーバーのみを対象としているのかに応じて異なります。

カスタム起動スクリプトを使用する場合、またはパッチの適用範囲を特定のWebLogicドメインまたはサーバーに限定する必要がある場合、起動スクリプトを次のように変更する必要があります。

- 特定の製品インストール上で動作するすべてのサーバー・インスタンスのシステム・クラスパスまたはライブラリ・パスにパッチを挿入する場合であっても、カスタム起動スクリプトを使用していれば、デフォルト・パッチ・プロファイルへの参照をそのスクリプトに追加する必要があります。

- パッチの適用範囲を特定のWebLogicドメインまたはサーバーに限定する場合、次の2つの作業を行う必要があります。

1. 製品インストール上で実行しているドメインまたはサーバーにパッチを適用するためのカスタム・パッチ・プロファイルを作成します。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

2. 該当するWebLogicドメインまたはサーバーの起動スクリプト内に、カスタム・パッチ・プロファイルへの参照を追加します。

適用したクラス・パス・パッチおよびライブラリ・パス・パッチが正しく使用されるように起動スクリプトを変更する方法については、「概要」を参照してください。次の項目についての説明があります。

- システム・クラスパスまたはライブラリ・パスに動的にロードされることが必要なパッチ・ファイルと、インストール全体に対して自動的に有効になるパッチとの区別

- パッチ適用時にSmart Updateによってパッチ・ファイルの内容が配置されるシステム上の場所

「起動スクリプトに対するパッチの場所の指定について」も参照し、構成ウィザードで作成されるデフォルト・スクリプトによってクラスやライブラリのパッチがシステム・クラスパスやライブラリ・パスに自動的に挿入される仕組みについて理解してください。クラスやライブラリのパッチを正しく参照するようスクリプトに変更を加える必要がある場合は、このプロセスを理解しておくことが重要です。

スクリプトの変更が必要になるのは、次のような場合です:

- 使用している環境内でデフォルト・スクリプトを使用していない。

- パッチの適用範囲を特定のWebLogicドメインやサーバーの起動スクリプトに限定する必要がない。

表5-4は、起動スクリプトの変更に関する情報をまとめたものです。

表5-4 起動スクリプトの変更

次に関する情報は

次のトピックを参照してください

起動スクリプト・エディタの使用

起動スクリプト・エディタの使用

起動スクリプトを開く方法

起動スクリプトを開く方法

すべてのWebLogicドメインおよびサーバーで使用するクラスおよびライブラリ・パスのパッチを参照するために起動スクリプトに加える変更の内容

カスタム・スクリプト経由のパッチですべてのドメインとサーバーをポイントする方法

特定のWebLogicドメインまたはサーバーで使用するクラスおよびライブラリ・パスのパッチを参照するために起動スクリプトに加える変更の内容

第6章「個々のアプリケーション、ドメイン、またはサーバーへのパッチの適用」

カスタム・パッチ・プロファイルの作成(WebLogicドメインまたはサーバーからパッチを参照するようスクリプトを変更する前に必要)

カスタム・パッチ・プロファイルの作成

起動スクリプト・エディタの使用

起動スクリプト・エディタはSmart Updateに用意されているツールです。使用環境内で目的の起動スクリプトを見つけ、スクリプト内にパッチ・パス変数の定義を作成する作業を簡単に実行できます。Smart Updateは、デフォルト・パッチ・プロファイルとカスタム・パッチ・プロファイルの組合せで表される、パッチ・レベルの異なる複数の製品を使用する環境におけるスクリプトを維持されます。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

この変更により、下部のペインに表示されるスクリプト・スニペットも製品固有のものになり、myCustomProfileがターゲットに設定されます。各種のパスそれぞれに対して異なるスニペットが提供されています。これらのパスには、クラスパス、WebLogic拡張クラスパスおよびネイティブが含まれます。

Windowsのスクリプト・スニペット

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

UNIXのスクリプト・スニペット

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用に起動スクリプト・エディタを使用する方法を順を追って説明します。起動スクリプト・エディタを使用するには、次の手順を実行します:

1. Smart Updateの「ターゲット・インストール」パネルで、ターゲット・インストールを選択します。

2. 「パッチ」→「スクリプト・エディタの起動」を選択します。

3. 「スクリプト・エディタの起動」ダイアログ・ボックスで次の操作を実行します。

1. WebLogicドメインまたはサーバーから参照するパッチ・プロファイルを選択します。カスタム・パッチ・プロファイルを使用してパッチを特定のWebLogicドメインまたはサーバーに適用する方法の詳細は、第9章「パッチの配布に関するベスト・プラクティス」を参照してください。

2. 起動スクリプトを編集する製品を選択します。図5-3を参照してください。

注意:

Workshop for WebLogicを選択した場合、そのカスタム・プロファイルに存在するWebLogic ServerパッチはWebLogicドメインに自動的にダウンロードされません。

3. 変更を加える起動スクリプトを開きます。
詳しい手順は、「起動スクリプトを開く方法」を参照してください。

4. パッチ・プロファイルに、適切なパッチ・パス変数定義を追加します。
起動スクリプト・エディタには、PATCH_CLASSPATH、WEBLOGIC_EXTENSION_DIRS、PATCH_LIBPATH、PATCH_PATHの各変数に対して推奨される定義付きのコード・スニペットが用意されています。これらの定義はすべて、前に選択したパッチ・プロファイル用にカスタマイズされています。ただし、定義内容は必要に応じて変更することもできます。

- デフォルト・パッチ・プロファイル内のパッチを参照するようにスクリプトを修正する場合は、「カスタム・スクリプト経由のパッチですべてのドメインとサーバーをポイントする方法」の手順を参照してください。

- カスタム・パッチ・プロファイル内のパッチを参照するようにスクリプトを修正する場合は、第6章「個々のアプリケーション、ドメイン、またはサーバーへのパッチの適用」を参照してください。カスタム・パッチ・プロファイルを作成して、そのプロファイルへのポインタをWebLogicドメインまたはサーバーの起動スクリプトに追加する方法についての説明があります。

5. カスタム・パッチ・プロファイル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%

この処理をパスのタイプごとに繰り返します。

6. 起動スクリプトを保存します。

注意:

パッチ・パス変数の定義を起動スクリプトに追加する際、別の起動スクリプトを呼び出す文より前にその定義を配置するようにしてください。たとえば、setDomainEnvスクリプトにパッチ・パス変数の定義を追加する場合は、commEnvスクリプトを呼び出す文の前に追加します。この位置関係を守れば、追加した定義がその後呼び出される別の起動スクリプト内の定義によってオーバーライドされることはありません。

起動スクリプトの変更方法は、Smart Updateによって強制または制限されることはありません。ただし、構成ウィザードなどの標準ツールによってデフォルトで作成される起動スクリプトの内容と、ツールによって決定されるデフォルトの格納場所にはそのまま従うことをお薦めします。そうすることで、パッチ・プロファイル内のパッチを参照するよう修正が必要な適切な起動スクリプトを見つけるための機能が期待どおりに動作し、Smart Updateをより便利に利用できます。

「スクリプト・エディタの起動」ダイアログ・ボックスはウィザードではないため、次のような処理はできません。

- 修正が必要とされるすべての適切なスクリプトの特定。構成ウィザードによってデフォルトで作成される起動スクリプトを使用していれば、起動スクリプト・エディタを使用して目的のスクリプトをすばやく見つけることができます。
サーバーおよびドメインの起動メカニズムがカスタマイズされている場合、起動スクリプト・エディタ内のみではすべての変更作業を完結できないことがあり、追加の作業手順が必要となる可能性があります。

- 起動スクリプトの修正。起動スクリプト・エディタでは、スクリプトを表示し、スクリプトに対して推奨される追加コードも提示しますが、変更内容と保存場所の最終決定はユーザーが行います。

- 起動スクリプトのバックアップ・コピーを作成します。

起動スクリプトを開く方法

「スクリプト・エディタの起動」ダイアログ・ボックスで「開く」をクリックして起動スクリプトを開くと、Smart Updateの「起動スクリプトを開く」ダイアログ・ボックスが表示されます。このダイアログ・ボックスは、WebLogicドメイン、管理対象サーバー、クラスタ、または個別のサーバーについて、パッチ・プロファイル内のパッチへのポインタを追加する対象の起動スクリプトを見つけるために使用します。

「スクリプト・エディタの起動」ダイアログ・ボックスでは、表5-5に示すアイコンを使用すると、変更対象の起動スクリプトを含むディレクトリに移動できます。

表5-5 「起動スクリプトを開く」ダイアログ・ボックスのアイコン

このアイコンは

次を表します

WebLogicドメイン内のbinサブディレクトリ(変更する必要があるスクリプトがデフォルトで格納されている)の親ディレクトリ。

スクリプト・ファイルが格納されているドメイン・サブディレクトリ(binなど)。サブディレクトリを開いて中のスクリプトを表示するには、このアイコンをクリックします。

構成ウィザードによってドメイン用に作成されたディレクトリ構造を使用している場合は、Smart Updateにより、変更が必要な起動スクリプトのあるディレクトリへと誘導されます。

修正対象となる特定の起動スクリプトを見つける場合の詳細は、以下のトピックを参照してください。

- ドメイン起動スクリプトの修正

- すべての管理対象サーバーまたはクラスタの起動スクリプトの修正

- 特定サーバーの起動スクリプトの修正

ドメイン起動スクリプトの修正

ドメインの起動スクリプトに変更を加えるには、対象となるドメインのbinサブディレクトリにあるsetDomainEnvまたはstartWebLogicスクリプトを選択します。図5-3は、WindowsシステムでsetDomainEnvスクリプトを選択する方法を示しています。

図5-3 起動スクリプトの選択ダイアログ・ボックスでのsetDomainEnvスクリプトの選択

setDomainEnvスクリプトには、PATCH_CLASSPATH、PATCH_LIBPATH、PATCH_PATHの各変数定義のプレースホルダーが含まれています。このスクリプトの変更の詳細は、表5-6を参照してください。

表5-6 スクリプトの変更

次の変更に関する情報は

次の項を参照してください

PATCH_CLASSPATH、PATCH_LIBPATH、PATCH_PATHの各変数定義のプレースホルダーを変更する方法

デフォルト・スクリプト内のパッチ・パス変数定義用プレースホルダー

このスクリプトをデフォルト・パッチ・プロファイル内のパッチをポイントするように変更する方法

カスタム・スクリプト経由のパッチですべてのドメインとサーバーをポイントする方法

このスクリプトをカスタム・パッチ・プロファイル内のパッチをポイントするように変更する方法

ドメインおよびサーバーからカスタム・パッチ・プロファイルへの参照

すべての管理対象サーバーまたはクラスタの起動スクリプトの修正

ドメイン内にある管理対象サーバーすべて(デフォルトではクラスタ内のサーバーすべてを含む)の起動スクリプトに変更を加えるには、対象となるドメインのbinサブディレクトリにあるstartManagedWebLogicスクリプトを選択します。図5-4は、Windowsシステムの場合についてその方法を示しています。

図5-4 起動スクリプトの選択ダイアログ・ボックスでのstartManagedWebLogicスクリプトの選択

このスクリプトの変更の詳細は、表5-7を参照してください。

表5-7 スクリプトの変更

このスクリプトに対する変更に関する情報は

次の項を参照してください

このスクリプトをデフォルト・パッチ・プロファイル内のパッチをポイントするように変更する方法

カスタム・スクリプト経由のパッチですべてのドメインとサーバーをポイントする方法

このスクリプトをカスタム・パッチ・プロファイル内のパッチをポイントするように変更する方法

ドメインおよびサーバーからカスタム・パッチ・プロファイルへの参照

特定サーバーの起動スクリプトの修正

ドメイン内の特定のサーバーに対する起動スクリプトに変更を加えるには、対象となるドメインのbinサブディレクトリにある、特定のサーバー用に固有の名前を付けた起動スクリプトを選択します。図5-5は、Windowsシステムで起動スクリプトstartWebLogicServer1を選択する方法を示しています。

図5-5 起動スクリプトの選択ダイアログ・ボックスでのサーバー起動スクリプトの選択

このスクリプトの変更の詳細は、表5-8を参照してください。

表5-8 起動スクリプトの変更

このスクリプトに対する変更に関する情報は

次の項を参照してください

このスクリプトをデフォルト・パッチ・プロファイル内のパッチをポイントするように変更する方法

カスタム・スクリプト経由のパッチですべてのドメインとサーバーをポイントする方法

このスクリプトをカスタム・パッチ・プロファイル内のパッチをポイントするように変更する方法

ドメインおよびサーバーからカスタム・パッチ・プロファイルへの参照

カスタム・スクリプト経由のパッチですべてのドメインとサーバーをポイントする方法

クラスおよびライブラリのパッチは、実際のドメインで使用されるクラス・パスおよびライブラリ・パスに確実に正しくロードされるようにすることが重要です。WebLogicドメイン内でサーバー起動や環境設定に使用している起動スクリプトから、「すべてのWebLogicドメインおよびサーバーで使用されるクラス・パスとライブラリ・パスを定義したデフォルト・スクリプト」に示すとおりデフォルトのcommEnvスクリプトの呼出しが行われない場合は、次のようにスクリプトを修正する必要があります。

- デフォルト・パッチ・プロファイルに適用されているクラスおよびライブラリのパッチを指し示す環境変数を定義する

- それらの環境変数を次のパスに追加する

- WebLogicシステム・クラスパス

- WebLogic Server上にデプロイされたアプリケーションで使用されるクラスパス(製品の要件に応じて追加)

- ライブラリ・パス

デフォルトのcommEnvスクリプトのこの機能は、次のいずれかの方法で必ず自身のスクリプトに追加してください。

- デフォルト・パッチ・プロファイル内のパッチを参照するコードを単一のスクリプトにまとめ、一元管理する方法。その一元化したスクリプトを、すべての起動スクリプトから呼び出すようにします。パッチを参照するコードのメンテナンス作業が簡略化され、環境変化に伴って発生するスクリプト変更作業の量が最小限になるため、この方法を採用することをお薦めします。

- デフォルト・パッチ・プロファイルに適用されているパッチを参照するコードを、個々の起動スクリプト内にコピーする方法。当該コードを個々の起動スクリプト内に確実にコピーすれば、適用済みのパッチがドメイン内のすべてのサーバーから参照されることを保証できます。ただし、サーバーの追加や構成の変化が使用環境内に生じると、起動スクリプトを正しくメンテナンスする作業の内容は複雑になっていきます。

ドメインおよびサーバーのWebLogicシステム・クラスパスからデフォルト・パッチ・プロファイル内のパッチJARへの参照

使用環境内にあるドメインおよびサーバーが起動する際には、デフォルト・パッチ・プロファイルに適用されているパッチJARがWebLogicシステム・クラスパスに挿入される必要があります。パッチJARがクラスパスに確実に挿入されるようにするため、使用する起動スクリプトに、この項で説明するコードを必ず追加してください。

1. PATCH_CLASSPATH環境変数のデフォルトの定義を追加します。例:

if "%PATCH_CLASSPATH%" == "" set PATCH_CLASSPATH=BEA_HOME\patch_wls1001\profiles\default\sys_manifest_classpath\weblogic_patch.jar

この定義を使用すると、個々のサーバーまたはドメインからカスタム・パッチ・プロファイル内のパッチを参照する必要がある場合に、そのサーバーまたはドメインでこの定義をオーバーライドできます。この定義におけるBEA_HOMEは、ミドルウェア・ホーム・ディレクトリ・パスを表します。絶対パスを指定する方法と、前に定義した環境変数を使用する方法(推奨)があります。

2. 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変数は、WebLogic Server上にデプロイされたアプリケーションのクラスパスにロードされる、パッチJARファイル内のクラスを必要とする製品で使用するため、予約されています。デプロイされたアプリケーションに対するパッチ用のこのメカニズムは、現在、WebLogic Server 9.1では使用されていません。

ドメインおよびサーバーからデフォルト・パッチ・プロファイル内のライブラリ・パッチへの参照

デフォルト・パッチ・プロファイルに適用されたネイティブ・ファイルは、使用環境内にあるどのドメインまたはサーバーが起動する際にも、システム・ライブラリ・パスに確実に挿入される必要があります。それらのファイルが正しく挿入されるようにするには、デフォルト・パッチ・プロファイルに適用されたパッチを参照するスクリプトに、この項で説明するコードを追加してください。

このコードをスクリプトに追加するには、次に示す適切な手順説明に従ってください。

- UNIXシステムの場合

- Windowsシステムの場合

UNIXシステムの場合

1. PATCH_LIBPATH環境変数のデフォルトの定義を追加します。例:

if [ "${PATCH_LIBPATH}" = "" ]; then  PATCH_LIBPATH=${BEA_HOME}/patch_wls1001/profiles/default/native

この定義を使用すると、個々のサーバーまたはドメインからカスタム・パッチ・プロファイル内のパッチを参照する必要がある場合に、そのサーバーまたはドメインでこの定義をオーバーライドできます。

2. 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

これで、デフォルト・パッチ・プロファイル内のライブラリ・ファイル・パッチが、パスに後で出現する既存の同名のファイルを確実にオーバーライドするようになります。

Windowsシステムの場合

1. PATCH_PATH環境変数のデフォルトの定義を追加します。例:

if "%PATCH_PATH%" == "" set PATCH_PATH=%BEA_HOME%\patch_wls1001\profiles\default\native

この定義を使用すると、個々のサーバーまたはドメインからカスタム・パッチ・プロファイル内のパッチを参照する必要がある場合に、そのサーバーまたはドメインでこの定義をオーバーライドできます。この定義におけるBEA_HOMEは、ミドルウェア・ホーム・ディレクトリ・パスを表します。絶対パスを指定する方法と、前に定義した環境変数を使用する方法(推奨)があります。

2. 変数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種類があります。共通モジュールは複数の製品で共有し、製品固有モジュールは1つの製品のみで使用します。共通モジュール用のパッチを適用しようとすると、Smart Updateから警告メッセージが表示されます。すべての製品にパッチを適用する場合は、「はい」をクリックできます。それ以外の場合は、「いいえ」をクリックします。ダイアログ・ボックスに表示される指示に従ってください。

WebLogic Platformの実行時インスタンスには、1つのバージョンのモジュールだけを含めることができます。そのため、特定のモジュール・バージョンが正しくパッチを適用されるようにするには、複数の製品に関連付けられているモジュールに関して、連携するすべての製品にパッチを適用する必要があります。

WebLogic Serverではモジュール・パッチはクラスパスに従って追加しますが、OSGiベースの製品ではパッチはベースのランチャを使用してロードします。

WebLogic Serverにおけるモジュール・パッチの適用

WebLogic Serverなどの製品は、クラスパスに従ってモジュールをランタイム・コンテナにロードします。クラスパスへのパッチのロードの詳細は、「クラスパス、拡張クラスパス、およびネイティブ・ライブラリ・パッチ」を参照してください。

OSGiベースの製品におけるモジュール・パッチの適用

OSGiベースの製品は、OSGiベースのランチャを通じてモジュールをランタイム・コンテナにロードします。ランチャは、必要なモジュールと実行時にモジュールがロードされる順序を決定します。また、特定の製品のモジュールにパッチが適用されているかどうかを判別します。モジュールにパッチが適用されていると、更新されたバージョンがロードされ、使用されます。モジュール・パッチの適用範囲は、製品およびパッチ・プロファイルに固有です。これにより、同じミドルウェア・ホーム・ディレクトリのすべての製品ではなく、1つの製品のみにパッチを限定するために必要とされるきめ細かな管理が可能になります。

OSGiベースの製品インストールの場合、共通モジュール用(MW_HOME\modules)および製品固有モジュール用(MW_HOME\wlevs20\modulesなど)の2つのディレクトリがあります。図5-6にこれらのディレクトリの構造を示します。

注意:

Oracle Fusion Middleware 11gR1リリースから、BEA_HOMEにかわってMW_HOMEが新たに使用されています。

図5-6 WebLogic Event Serverに対するインストール・レベルのディレクトリ構造

ネイティブ・バイナリとその他のアーティファクトのパッチ

ネイティブ・バイナリとその他のアーティファクトは、「すべてのアプリケーション、ドメインおよびサーバーに対してリソースを置き換えるパッチ」で説明しているように、すべてのアプリケーション、ドメインおよびサーバーで有効になります。

共有アーカイブ・パッチ

ここでは、アプリケーションで共有アーカイブ・パッチをデプロイおよび参照する方法について説明します。

概要

共有アーカイブ・パッチは、共有ライブラリ、特にWebLogicライブラリ・モジュールをサポートするために導入されました。製品ディレクトリにインストールされる他のアーティファクトと異なり、アプリケーションは既知の場所に依存しなくても、ディレクトリ名とバージョン参照によって共有アーカイブを使用できます。これは、共有アーカイブのデフォルト・インストールが、同じ共有アーカイブのカスタム・インストールによって指定されたプロファイルに置き換えられるまで、インストール全体(またはドメイン全体)に適用されることを示しています。

Smart Updateで、デフォルト・プロファイルまたはカスタム・プロファイルへの適用後、共有アーカイブ・パッチをアクティブ化するには、パッチを適用したアーカイブを対象のドメインにデプロイしてから、必要があれば、そのアーカイブを参照するようにアプリケーションの記述を変更します。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

共有アーカイブ・パッチは、ドメイン全体(または特定のインストールで動作中のすべてのドメイン)またはドメイン内の選択したアプリケーションに適用できます。インストール内のすべてのドメインに影響を与えるには、Smart Update内のデフォルト・プロファイルに共有アーカイブ・パッチを適用します。

このトピックの詳細は、「共有アーカイブ・パッチのデフォルト・アプリケーション」を参照してください。

特定のアプリケーションにのみ影響を与えるには、カスタム・プロファイルにパッチを適用し、アプリケーション記述子のアーカイブ参照を更新する必要があります。この方法により、必要に応じて、共有ライブラリを利用するアプリケーションごとに独自のパッチ・プロファイルを維持できます。

このトピックの詳細は、「アプリケーション・スコープによるカスタム・プロファイルでの共有アーカイブ・パッチのアクティブ化」を参照してください。

アーカイブの置換えまたは挿入

共有アーカイブ・パッチを適用すると、アーカイブ全体が置き換えられる(まったく新しいアーカイブがインストールされる)か、(挿入によって)アーカイブの一部が更新されます。

どちらの操作が行われるかは、パッチの作成者が決定します。不明な場合は、My Oracle Supportにお問合せください。

パッチの削除

パッチを削除する場合、Smart Updateを使用してパッチを削除するだけでなく、パッチを明示的にアンデプロイする必要があります。

詳細情報

共有ライブラリのデプロイおよびアンデプロイの詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。共有ライブラリの詳細は、Oracle WebLogic Serverアプリケーションの開発を参照してください。

共有アーカイブ・パッチのデフォルト・アプリケーション

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にインストールされます。他の製品では、別のデフォルト・パッチ・ディレクトリ構造が作成される場合もあります。特定のパッチに関する詳細なガイダンスが必要な場合は、My Oracle Supportにお問合せください。

パッチが既存のアーカイブを置き換えるタイプのもので、すでにデプロイされている場合、サーバーを再起動する必要があります。パッチに新しいバージョンがある場合、または別のディレクトリにインストールされる場合、パッチを適用したアーカイブをデプロイする必要があります。デプロイメントを実行するには、WebLogic ServerコンソールまたはカスタムWLSTスクリプトを使用するか、ターゲット・ドメインのconfig.xmlを直接更新します。

パッチを適用したアーカイブのデプロイメントが正常に完了すると、アーカイブの名前、仕様、バージョン番号などがWebLogic Server管理コンソールに表示されます。

ライブラリ・モジュール・マニフェストを変更しない場合、ライブラリ・モジュールへの参照もすべて変更されず、ドメイン内のすべてのアプリケーションは、アプリケーション記述子を手動でさらに構成しなくても、新しい機能をただちに利用できるようになります。

アプリケーション・スコープによるカスタム・プロファイルでの共有アーカイブ・パッチのアクティブ化

パッチを一定のレベルで管理して、選択したアプリケーションに適用することがあります。このような場合に共有アーカイブ・パッチを適用するには、カスタム・プロファイルを作成し、そのカスタム・プロファイルにのみ共有アーカイブ・パッチを適用します。

共有ライブラリ・パッチのバージョンを区別し、1つのドメイン内で複数のバージョンの共有ライブラリが共存できるようにするには、固有の名前または固有の実装バージョン(あるいはその両方)でバージョンを区別します。

Smart Updateのカスタム・プロファイルに共有アーカイブ・パッチを適用したあと、2つの手順を実行して、パッチを適用するアプリケーションに対してパッチをアクティブ化する必要があります。

1. カスタム・プロファイルでパッチをデプロイします。

2. パッチを適用したアーカイブの特定のバージョンを参照するように、アプリケーション記述子を更新します。

カスタム・プロファイルの共有アーカイブ・パッチをデプロイする手順は、パッチが次のディレクトリにあるという点を除いて、デフォルト・プロファイルの共有アーカイブ・パッチをデプロイする手順と同じです。

MW_HOME/patch_weblogicversion/profile/custom-profile-name/archives

例: MW_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>

6 個々のアプリケーション、ドメイン、またはサーバーへのパッチの適用

インストール環境全体を対象とすることが必須でないパッチは、カスタム・パッチ・プロファイルを使用することにより、特定のドメインまたはサーバーのみに対して適用できます。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

この項には次のトピックが含まれます:

- ドメインまたはサーバーへのパッチ適用について

- アプリケーション、ドメイン、またはサーバーのパッチについて

- カスタム・パッチ・プロファイルの作成

- ドメインおよびサーバーからカスタム・パッチ・プロファイルへの参照

- ノード・マネージャ環境でのカスタム・パッチ・プロファイルの管理

ドメインまたはサーバーへのパッチ適用について

パッチをダウンロードして適用する際、パッチはデフォルトでターゲット・インストール全体に対して有効になります。インストール全体にパッチが適用された環境で実行するように構成されているドメインやサーバーはすべて、その環境に適用されたパッチを使用して実行されます。しかし、場合によっては、本番環境内の個々のサーバーまたはドメインをそれぞれ異なるパッチ・レベルで実行することが必要になります。そのようなニーズを満たすため、Smart Updateでは、インストール環境全体を対象とすることが必須でない特定のパッチを、個々のドメイン、サーバーまたはクラスタに対して適用できます。

たとえば、(a) 1つのミドルウェア・ホーム・ディレクトリに複数の製品がインストールされている状態で、(b) それらのうち1つの製品しか使用しないドメインがある場合、そのようなドメインでは、使用する特定の製品に適用されているパッチのみを参照することをお薦めします。

インストール全体に対して有効にすることが適切でない1つまたは複数のパッチを個別のドメインまたはサーバーから参照するには、大まかにいって、次の3つの手順からなる作業が必要となります。

1. カスタム・パッチ・プロファイルを作成します。

2. 対応するドメインまたはサーバーの適切な起動スクリプトに、カスタム・パッチ・プロファイルへのポインタを挿入します。

3. カスタム・パッチ・プロファイルに目的のパッチを適用します。

図6-1は、この手順の詳細を示しています。

図6-1 カスタム・パッチ・プロファイルで個々のドメイン、クラスタ、またはサーバーをポイントする方法

アプリケーション、ドメイン、またはサーバーのパッチについて

Smart Updateでは、特定のアプリケーションに共有アーカイブ・パッチを適用できます。共有アーカイブ・パッチをデフォルト・パッチ・プロファイルに適用する場合、自動的にインストールされます。ただし、アプリケーション・スコープのパッチをカスタム・パッチ・プロファイルに適用する場合、明示的にデプロイする必要があります。「共有アーカイブ・パッチ」を参照してください。

カスタム・プロファイルによる個々のドメイン、サーバー、およびアプリケーションへのパッチの適用

デフォルトでは、デフォルト・パッチ・プロファイルに含まれるすべてのパッチが、インストール環境全体のすべてのドメインとサーバーに対して有効になります。ただし、カスタム・パッチ・プロファイル内のパッチは、インストール環境内の一部のドメインまたはサーバーのみに対して有効にすることができます。「すべてのアプリケーション、ドメインおよびサーバーに対してリソースを置き換えるパッチ」で説明するように、システム全体のリソースを置き換えるパッチは、一部のドメインやサーバーのみを選択してターゲットとすることはできません。しかし、起動スクリプトでロードされることによりシステム内にある同名の既存リソースに取ってかわるようなクラスまたはライブラリ・ファイルのパッチについては、選択的にターゲットを指定できます。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

これ以降の節では、個別のドメインおよびサーバーにパッチを適用するためにカスタム・パッチ・プロファイルを使用する方法の背景情報について説明します。

- ドメインまたはサーバーでカスタム・プロファイル内のパッチを参照する方法

- カスタム・パッチ・プロファイルを使用するためのベスト・プラクティス

ドメインまたはサーバーでカスタム・プロファイル内のパッチを参照する方法

構成ウィザードを使用してドメインを作成すると、ドメインに対して次のスクリプトが作成されます。

- setDomainEnv: すべてのサーバーが使用する環境変数を含め、ドメイン・レベルの環境変数を設定するスクリプト。

- startWebLogic: ドメイン内の管理対象サーバーでないWebLogic Serverインスタンスが使用する起動スクリプト。

- startManagedWebLogic: ドメイン内の管理対象サーバー(クラスタ内にあるものを含む)が使用する起動スクリプト。

注意:

詳細は、「すべてのWebLogicドメインおよびサーバーで使用されるクラス・パスとライブラリ・パスを定義したデフォルト・スクリプト」を参照してください。

デフォルトでは、製品インストール・スクリプトcommEnvで提供されるPATCH_CLASSPATH、WEBLOGIC_EXTENSION_DIRS、PATCH_LIBPATH、PATCH_PATHの各変数の値は、該当するインストールで実行されるすべてのサーバー・インスタンスで使用されます。ただし、ドメイン・レベルのスクリプトでこれらの変数の値をオーバーライドした場合は、ドメイン・レベルのスクリプトで起動されたWebLogic Serverインスタンスによってのみ新しい値が使用されます。

注意:

任意のパッチ変数の定義で参照するパッチ・マニフェストJARは、ただ1つである必要があります。複数のパッチ・マニフェストJARファイルを参照すると、実行時に予期しない動作が発生するおそれがあります。

起動スクリプト内でパッチ・パス変数の定義を変更することは、起動スクリプトから起動されるサーバーでカスタム・パッチ・プロファイル内にあるパッチを参照する便利な方法です。たとえば、カスタム・パッチ・プロファイルに適用されるパッチ内のWebLogicシステム・クラスをサーバーから参照する場合、PATCH_CLASSPATH変数の定義をそのサーバーの起動スクリプトに追加して、その変数をカスタム・パッチ・プロファイル内のパッチ・マニフェストJARファイルのパスに設定するだけで済みます。同様に、カスタム・パッチ・プロファイルのネイティブ・ライブラリ・ファイルをサーバーまたはドメインから参照するには、そのネイティブ・ファイルを含むカスタム・パッチ・プロファイルにディレクトリへの参照を追加します。この参照を追加するには、PATCH_PATH変数またはPATCH_LIBPATH変数の定義を、該当するサーバーまたはドメインの起動スクリプトに追加します。

注意:

パッチ・パス変数の定義を起動スクリプトに追加する際、別の起動スクリプトを呼び出す文より前にその定義を配置するようにしてください。たとえば、setDomainEnvスクリプトにパッチ・パス変数の定義を追加する場合は、commEnvスクリプトを呼び出す文の前に追加します。この位置関係を守れば、追加した定義がその後呼び出される別の起動スクリプト内の定義によってオーバーライドされることはありません。

起動スクリプトの変更方法は、Smart Updateによって強制または制限されることはありません。ただし、構成ウィザードなどの標準ツールによってデフォルトで作成される起動スクリプトの内容と、ツールによって決定されるデフォルトの格納場所にはそのまま従うことをお薦めします。そうすることで、修正が必要な起動スクリプトを見つける機能や、それらのスクリプトに加える具体的な変更内容の候補を表示する機能が期待どおりに動作し、Smart Updateをより便利に利用できます。

図6-2は、インストール環境で使用される2つのパッチ・プロファイルであるデフォルト・パッチ・プロファイルとカスタム・パッチ・プロファイルを示しています。この図の内容は次のとおりです。

- デフォルト・パッチ・プロファイルにはパッチ1、2、および3があります。デフォルトでは、サンプル・インストール環境で実行されるすべてのドメインとサーバーはデフォルト・パッチ・プロファイルを参照しています。

- カスタム・パッチ・プロファイルにはパッチ4があります。サンプル・ドメイン内の1つのサーバーがカスタム・パッチ・プロファイルを参照しています。

図6-2 カスタム・パッチ・プロファイルで個々のドメイン、クラスタ、またはサーバーをポイントする方法

サーバーからパッチ・クラスを参照するPATCH_CLASSPATHの使用例

次のPATCH_CLASSPATH変数は、カスタム・プロファイルProductionServer1にあるパッチ・マニフェストJARファイルのweblogic_patch.jarを参照しています。

set PATCH_CLASSPATH=
%BEA_HOME%\patch_wls1001\profiles\ProductionServer1
\sys_manifest_classpath\weblogic_patch.jar

前述の定義を所定のドメインのstartWebLogicスクリプトに追加すると、このスクリプトによって該当するドメイン内で起動されたサーバー・インスタンスが、ProductionServer1カスタム・プロファイル内のweblogic_patch.jarファイルによって参照されるWebLogic Serverのクラスパスにクラス・ファイルをロードします。このクラスパスへのロードは、その後commEnvスクリプトの次の行が実行されたときに行われます(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

注意:

ProductionServer1プロファイル内のweblogic_patch.jarが参照するパッチJARファイルのセットは、デフォルト・パッチ・プロファイルのweblogic_patch.jarで参照されるパッチJARファイルのセットとまったく異なる場合があります。

あるドメイン内のサーバーまたはあるインストール環境内のドメインで、デフォルト・パッチ・プロファイル内のパッチを引き続き参照する必要がある場合、構成ウィザードで提供されるサーバーおよびドメインのデフォルト・スクリプトを使用するかぎり、そのサーバーまたはドメイン用の起動スクリプトを変更する必要はありません。ただし、1台以上のサーバー、もしくは1つのドメインからカスタム・パッチ・プロファイルを参照する場合は、変更する起動スクリプトの影響がターゲットのサーバーまたはドメインにしか及ばないことを確認してください。

起動スクリプトが実行される順序と、パッチ・パス変数の特定の定義がパッチ・パス変数定義のあるスクリプトで起動されるサーバーに及ぼす影響の詳細は、「起動スクリプトの実行順序」を参照してください。

OSGiベースの製品のカスタム・パッチ・プロファイルへの参照

テキスト・エディタでサーバーの起動スクリプト(WebLogic Event Serverドメインのstartwlevs.cmd(Windows)、startwlevs.sh(UNIX)など)を開き、このスクリプトに-DBEAPatchProfileプロパティを次のように追加します。

if "%1" == "-dgc" goto rundgc

"%JAVA_HOME%\bin\java" -Dwlevs.home="%USER_INSTALL_DIR%" -Dbea.home="%BEA_HOME%"
-Dcom.bea.core.security.username=wlevs -Dcom.bea.core.security.password=wlevs
–DBEAPatchProfile=custProfile
-jar "%USER_INSTALL_DIR%\bin\wlevs_2.0.jar" %1 %2 %3 %4 %5 %6

goto finish
:rundgc

"%JAVA_HOME%\bin\java" %DGC_ARGS% -Dwlevs.home="%USER_INSTALL_DIR%"
-Dbea.home="%BEA_HOME%" -Dcom.bea.core.security.username=wlevs
-Dcom.bea.core.security.password=wlevs –DBEAPatchProfile=custProfile
-jar "%USER_INSTALL_DIR%\bin\wlevs_2.0.jar" %2 %3 %4 %5 %6
:finish

修正された起動スクリプトが実行されると、スクリプトで指定したパッチ・プロファイルに適用したこれらのパッチのみがOSGiランチャによって参照されます。

カスタム・パッチ・プロファイルを使用するためのベスト・プラクティス

この節では、カスタム・パッチ・プロファイルの使用法に関する重要な情報について説明します。

- カスタム・プロファイルの増大を回避する

- ドメインおよびサーバー起動スクリプトを変更する

- インストール環境全体のリソースに影響するパッチを削除する

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

カスタム・プロファイルの増大を回避する

ダウンロードした新しいパッチをドメインまたはサーバーから参照する際には、できるだけ既存のパッチ・プロファイルにパッチを適用してください。特定のドメインまたはサーバーから参照するパッチのセットを変更する必要がある場合は、そのパッチを含んでいるカスタム・パッチ・プロファイルの内容を変更してください。これは、新しいカスタム・パッチ・プロファイルを作成し、そのプロファイルを参照するように起動スクリプトを変更するよりも望ましいアプローチです。ダウンロードしたパッチごとに新しくプロファイルを作成することは避けてください。作成するプロファイルの数を最小限に抑えることによって、Smart UpdateおよびMy Oracle Supportリポジトリに組み込まれているパッチ検証および依存関係チェックの機能を効率的に活用することができます。

また、使用するカスタム・プロファイルの数を最小限にすると、メンテナンスが必要な起動スクリプトの変更も最小限に抑えることになります。その結果、スクリプトにミスを混入する可能性も減らすことができます。それに加えて、パッチの削除に必要な作業も簡略化され、適切なパッチ・プロファイルを更新するだけでよくなります。スクリプトを更新する必要は最小限になります。

ドメインおよびサーバー起動スクリプトを変更する

起動スクリプトは、とても柔軟です。起動スクリプトに特定の名前や格納場所を使用することは強制されません。ただし、構成ウィザードによってドメイン用に作成されるデフォルトのディレクトリ構造と、提供される起動スクリプトの場所および構造が維持されている場合、カスタム・プロファイルの使用時に必要な起動スクリプトを見つけ、変更内容の候補を表示するSmart Updateの機能を最大限に利用できます。

一般に、カスタム・パッチ・プロファイルをドメインまたはサーバーから参照するときには、次のガイドラインに留意してください。

- 起動スクリプトを変更する前に、バックアップ・コピーを作成します。

- 起動スクリプトの変更は、できるだけ一般的なレベルにとどめます。たとえば、ドメインからカスタム・パッチ・プロファイルを参照する場合は、ドメイン内のサーバーを起動する各スクリプトではなく、setDomainEnvスクリプトを変更します。この方法を取ることで、変更とメンテナンスの必要な起動スクリプトの数が最小限になります。

- 1つのドメインまたはサーバーから複数のパッチ・プロファイルを参照しません。パッチ検証は単一のパッチ・プロファイル内で実行され、複数のプロファイルに対して同時に実行されることはありません。

インストール環境全体のリソースに影響するパッチを削除する

通常、カスタム・パッチ・プロファイルに対して追加または削除できるパッチ・セットには制限はありません。ただし、インストール環境全体のリソースに影響するパッチについては、ターゲット・インストール環境の既存のパッチ・プロファイルすべてに自動的に配置されます。

インストール環境全体のリソースに影響するパッチを任意の1つのパッチ・プロファイル(デフォルト・プロファイルかカスタム・プロファイルかは問わない)から削除すると、そのパッチは自動的にすべてのパッチ・プロファイルから削除されます。ターゲット・インストールに複数のプロファイルがある場合、インストール環境全体のリソースに影響するパッチの置換えや削除を行おうとすると、Smart Updateに警告が表示されます。

カスタム・パッチ・プロファイルの作成

カスタム・パッチ・プロファイルを作成するには、この項に記載されている手順を実行します。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

1. 「ターゲット・インストール」パネルで製品インストール環境を選択します。

2. 「パッチ」→「パッチ・プロファイル」→「新規」を選択します。

3. 新規パッチ・プロファイル・ダイアログ・ボックスで次の項目を選択します。

1. カスタム・パッチ・プロファイルの名前

2. プロファイルの初期内容

注意:

カスタム・パッチ・プロファイルを作成すると、そのプロファイル用にユーザーが選択した名前を使用してディレクトリが作成されます。そのため、製品のソフトウェアでサポートされるハードウェアとオペレーティング・システムのすべての組合せにおいてカスタム・パッチ・プロファイルを確実に使用できるようにするには、カスタム・パッチ・プロファイルの名前に英数字のみを使用してください。

4. 「作成」をクリックします。

カスタム・プロファイルの詳細については次のトピックを参照してください。

- カスタム・パッチ・プロファイルの初期内容

- パッチ・プロファイルのクローンを作成する

- カスタム・パッチ・プロファイルにパッチを追加する

- カスタム・パッチ・プロファイルを削除する

カスタム・パッチ・プロファイルの初期内容

カスタム・パッチ・プロファイルには次のタイプのパッチが含まれています。

- WebLogicシステム・クラスパスにロードできるクラス

- WebLogic Serverにデプロイされるアプリケーション用の、拡張クラスパスにロードできるクラス

- ライブラリ・パスに追加できるネイティブ・ライブラリ・ファイル

デフォルトでは、インストール全体に対して有効になるパッチがすでにターゲット・インストールに適用されている場合、それらのパッチは新しいパッチ・プロファイルを作成するたびに自動的に組み込まれます。ただし、最初はパッチが含まれていないパッチ・プロファイルを作成することもできます。

カスタム・パッチ・プロファイルを作成するために既存のパッチ・プロファイルの内容のクローンを作成すると、実際にディスクに複製されるのは既存のパッチ・プロファイルのパッチの一部のみです。

- パッチJARファイルは複製されません。パッチJARファイルを参照しているシステム上のすべてのパッチ・プロファイルによって、単一のパッチJARファイルが共有されます。
代替パッチは複製されません。あるパッチが最初に適用されたときシステム・リソースが置き換えられた場合、該当するシステム・リソースは、そのパッチがカスタム・パッチ・プロファイルに自動的に複製されるたびに置き換えられることはなく、また、カスタム・パッチ・プロファイル内のパッチ用の複製エントリによって参照されるパッチ・コンテナで作成された複製コピーに置き換えられることもありません。

- サーバーの起動時にシステム・パス内にロードされるパッチのネイティブ・ライブラリ・ファイルは、インストール・レベルのパッチ・ディレクトリに複製されます。ディスク容量に不安がある場合は、カスタム・パッチ・プロファイルによって複製されるネイティブ・ライブラリ・ファイルの占有する領域サイズが問題にならないことを確認してください。

注意:

ファイルまたは他のアーティファクトの代替を含むパッチは、インストール全体に自動的に適用されます。

パッチ・プロファイルのクローンを作成する

既存のパッチ・プロファイル内と同じパッチを含むカスタム・パッチ・プロファイルを作成する場合、既存のプロファイルのクローンを作成してから、パッチの追加や削除を行うことで必要に応じてカスタマイズできます。この方法は、カスタム・パッチ・プロファイルを短時間で作成する場合に便利です。

注意:

インストール環境全体のリソースに影響を与えるパッチは、ターゲット・インストール環境で作成されるパッチ・プロファイルすべてに含まれます。この種のパッチを削除する場合は、ターゲット・インストール環境にあるすべてのパッチ・プロファイルから削除する必要があり、特定のプロファイルからのみ削除することはできません。これを試みると、Smart Updateは警告メッセージを表示します。

カスタム・パッチ・プロファイルにパッチを追加する

カスタム・パッチ・プロファイルを作成すると、デフォルト・パッチ・プロファイルに対してパッチの追加や削除を行うのと同様に、カスタム・パッチ・プロファイルに対してもパッチの追加や削除を行うことができます。

1. 「パッチの管理」タブで、作成したカスタム・パッチ・プロファイルを選択します。

2. プロファイルにパッチを追加するには、「ダウンロードされたパッチ」パネルから追加するパッチを選択して、「適用」をクリックします。

3. プロファイルからパッチを削除するには、表示されるパッチ・プロファイルのリストからパッチを選択して「削除」をクリックします。

ターゲット・インストールにパッチを適用する場合、次の処理が実行されます。

1. 適用するパッチが、現在のパッチ・プロファイル内にあるパッチに対して検証されます。

2. パッチ間の競合が発生しない場合は、パッチが適用されます。

注意:

パッチは検証され、ターゲット・インストールに適用されますが、クラスパスにロードされるクラス、またはライブラリ・パスにロードされるネイティブ・ライブラリ・ファイルを含むパッチは、次の手順を完了するまで有効になりません。

- 必要に応じて、パッチを参照するように適切なドメインまたはサーバーの起動スクリプトを変更します。

- 適切なドメイン、サーバーまたはアプリケーションを再起動します。「共有アーカイブ・パッチ」で説明しているように、共有アーカイブ・パッチはアプリケーションから明示的に参照する必要があります。

競合が検出された場合は、パッチ・インストール検証ダイアログ・ボックスに競合の概要が表示されます。パッチは競合が解決するまで適用できません。詳細は、「パッチ間の競合の解決」を参照してください。

3. パッチは、適用されると、現在のパッチ・プロファイルに追加されます。このプロファイルの「パッチの管理」タブの「ダウンロードされたパッチ」パネルには表示されなくなります。

カスタム・パッチ・プロファイルを削除する

カスタム・パッチ・プロファイルを削除するには、次の手順を実行します:

1. 「パッチの管理」タブで、削除するカスタム・パッチ・プロファイルを選択します。

2. 「パッチ」→「パッチ・プロファイル」→「削除」を選択します。
確認用のダイアログ・ボックスが表示されるので、削除操作を続行するか、取り消すかを選択することができます。

カスタム・パッチ・プロファイルを削除するときには、次の事項に留意してください。

- 削除されたカスタム・パッチ・プロファイルがドメインまたはサーバー用の起動スクリプトから参照されている場合、その起動スクリプトは失敗することがあります。パッチ・プロファイルをドメインまたはサーバーから参照する手順は、「ドメインおよびサーバーからカスタム・パッチ・プロファイルへの参照」を参照してください。

- カスタム・パッチ・プロファイルを削除しても、そのプロファイルに関連付けられているパッチは削除されません。

- デフォルト・パッチ・プロファイルは削除できません。これを試みると、Smart Updateはエラー・メッセージを表示します。

ドメインおよびサーバーからカスタム・パッチ・プロファイルへの参照

作成したカスタム・パッチ・プロファイルをドメインまたはサーバーから参照するには、この項に記載されている手順を実行します。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

1. 変更予定の各スクリプトのバックアップ・コピーを作成します。

2. Smart Update内の「ターゲット・インストール」パネルでターゲット・インストール環境を選択します。

3. 「パッチ」→「スクリプト・エディタの起動」メニュー・オプションを選択します。「スクリプト・エディタの起動」ダイアログ・ボックスが表示されます。

4. 「スクリプト・エディタの起動」ダイアログ・ボックスで次の操作を実行します。

1. ドメインまたはサーバーから参照するカスタム・パッチ・プロファイルを選択します。

2. 変更を加える起動スクリプトを開きます。手順については、「起動スクリプトを開く方法」を参照してください。

3. 新しいカスタム・パッチ・プロファイルを参照するパッチ・パス変数を追加します。Smart Updateでは、PATCH_CLASSPATH、WEBLOGIC_EXTENSION_DIRS、PATCH_LIBPATH、PATCH_PATHの各変数の推奨される定義を含むコード・スニペットが示されます。これらの定義では、システム・クラスとライブラリ・パスに挿入されるクラスとファイルを含むパッチを参照しています。ただし、カスタム・パッチ・プロファイルの内容と参照する必要のある具体的なパッチ・パス変数によっては、異なる変更を行う必要があることもあります。

4. 起動スクリプトを保存します。

注意:

パッチ・パス変数の定義を起動スクリプトに追加する際、別の起動スクリプトを呼び出す文より前にその定義を配置するようにしてください。たとえば、setDomainEnvスクリプトにパッチ・パス変数の定義を追加する場合は、commEnvスクリプトを呼び出す文の前に追加します。この位置関係を守れば、追加した定義がその後呼び出される別の起動スクリプト内の定義によってオーバーライドされることはありません。

WebLogic Server製品のホーム・ディレクトリのデフォルト起動スクリプトは、WL_HOME\common\bin\commEnvです。このスクリプトには、クラスパスやライブラリ・パスにパッチ・ファイルを挿入するために使用される、次の変数のデフォルト値が記述されています。

- PATCH_CLASSPATH

- WEBLOGIC_EXTENSION_DIRS

- PATCH_LIBPATH

- PATCH_PATH

詳細は、「デフォルト・パッチ・パス環境変数」を参照してください。

前述の変数の定義をサーバーまたはドメインの起動スクリプトに追加すると、commEnvスクリプトでは、該当するサーバーまたはドメインのデフォルトの定義が新しい定義によってオーバーライドされます。このため、サーバーまたはドメインのスクリプトでこれらの変数を定義するときには、新しい定義が適切なサーバー・インスタンスに適用されることを必ず確認してください。

また、起動スクリプトが実行される順序にも注意してください。前述の変数のいずれかの定義をスクリプトで設定したら、その後に実行されるスクリプトの定義によってオーバーライドされることはありません。詳細は、「起動スクリプトの実行順序」を参照してください。

カスタム・スクリプトを使用する際の重要な注意

WL_HOME\common\bin\commEnvスクリプトを呼び出さないカスタム・スクリプトを環境内で使用する場合は、その環境のクラスパスおよびライブラリ・パスを設定する文をスクリプト内で変更する必要があります。これにより、定義した環境変数がSet WEBLOGIC_CLASSPATHやSet PATHなどの文に正しく挿入されます。

たとえば、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

カスタム・スクリプトからパッチ・プロファイルを参照する方法の詳細は、「カスタム・スクリプト経由のパッチですべてのドメインとサーバーをポイントする方法」を参照してください。

ノード・マネージャ環境でのカスタム・パッチ・プロファイルの管理

ドメインでノード・マネージャを使用しており、ドメインで使用するパッチすべてがデフォルト・パッチ・プロファイルに適用される場合、ノード・マネージャで起動されるサーバーは、自動的にそれらのパッチを使用して実行されます。ただし、ノード・マネージャを使用するように構成されたドメインでカスタム・パッチ・プロファイルを使用する場合は、この項で説明する追加の手順を実行する必要があります。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

ドメイン・クラスタ内のすべての管理対象サーバーが起動時にカスタム・パッチ・プロファイル内のパッチを必ず参照するようにするには、次の手順を実行します:

1. すべてのノード・マネージャ・インスタンスが、Java Virtual Machine (JVM)プロセス内で実行されるJavaベースのバージョンであることを確認します。システムを再起動したときに必ずノード・マネージャが自動的に再起動されるようにするため、すべてのノード・マネージャ・インスタンスを次のように実行することをお薦めします。

- Windowsプラットフォームの場合: Windowsサービスとして実行する

- UNIXプラットフォームの場合: オペレーティング・システム・サービスとして実行する

この節で説明している手順では、ノード・マネージャのスクリプト・ベースのバージョンの使用はサポートされません。

2. 管理対象サーバーの起動時に参照する必要があるカスタム・パッチ・プロファイルに、WebLogicシステム・クラスパス用のパッチJARファイルは含まれていますが、システム・パスに挿入する必要があるネイティブ・ライブラリ・ファイルは含まれない場合、影響を受ける管理対象サーバーのクラスパスをWebLogic Server管理コンソールから次のように設定できます。

1. 管理サーバーを起動します。

2. 次のURLを入力してWebLogic Server管理コンソールにアクセスします。

http://hostname:port/console

ここで、hostnameは管理サーバーのDNS名またはIPアドレスを表し、portは管理サーバーがリクエストをリスニングするポートの番号(デフォルトではポート7001)を表します。

3. 管理コンソールの「チェンジ・センター」で、「ロックして編集」をクリックします。

4. 管理コンソールの左側のペインで、「環境」を展開し、「サーバー」を選択します。

5. 「サーバー」表で、構成する管理対象サーバーの名前をクリックします。それぞれの管理対象サーバーについて、手順(f)および(g)を実行します。

6. 「構成」→「サーバーの起動」メニュー・オプションを選択します。

7. 「クラスパス」フィールドの先頭にPATCH_CLASSPATH環境変数を追加します。

8. 「保存」をクリックします。

9. 管理コンソールのチェンジ・センターで「変更のアクティブ化」をクリックして、これらの変更をアクティブ化します。

3. 起動時に管理対象サーバーから参照する必要のあるカスタム・パッチ・プロファイルに、システム・パスに挿入する必要のあるネイティブ・ライブラリ・ファイルが設定されている場合は、カスタム・パッチ・プロファイルにパッチJARファイルも設定されているかどうかに関係なく、クラスタ内の管理対象サーバーをホストする各システムでノード・マネージャのnodemanager.propertiesファイルを編集する必要があります。対象となるそれぞれのnodemanager.propertiesファイルを開き、次の変更を行います。

1. 次の例に示すように、StartScriptEnabledプロパティをtrueに設定します。

StartScriptEnabled=true

2. StartScriptNameプロパティが、ドメイン内のすべてのサーバー・インスタンスで使用されるWebLogic Server起動スクリプトに設定されていることを確認します。デフォルトの起動スクリプトはオペレーティング・システムごとに次のようになります。
Windows:

startWebLogic.cmd

UNIX:

startWebLogic.sh

nodemanager.propertiesファイルの変更の詳細は、『Oracle WebLogic Serverノード・マネージャ管理者ガイド』のノード・マネージャの構成ファイルとログ・ファイルに関する項を参照してください。

3. テキスト・エディタで、ドメインのsetDomainEnvスクリプト(Windowsの場合はsetDomainEnv.cmd、UNIXの場合はsetDomainEnv.sh)を開き、表6-1に示すパッチ・パス環境変数を1つ以上定義します。

インストール・レベルのパッチ・ディレクトリ(MW_HOME\patch_wlsversion)に含まれる、表6-1に示す各ファイルまたはディレクトリに対して、対応するパッチ・パス変数用のsetDomainEnvスクリプトに定義を追加することにより、パッチ・パス変数でそのファイルまたはディレクトリが参照されるようにします。表6-1のcustom-profileは、インストール・レベルのパッチ・ディレクトリに作成されたカスタム・パッチ・プロファイルの名前を表しています。

たとえば、システムでMW_HOME\patch_wls1000\profiles\custom-profile\sys_manifest_classpath\weblogic_patch.jarという名前のJARファイルをホストしている場合、そのファイルを参照するsetDomainEnvスクリプトにPATCH_CLASSPATH変数の定義を追加します。

表6-1 ノード・マネージャ環境用のsetDomainEnvに定義するパッチ変数

定義する変数

カスタム・プロファイル・ディレクトリ内に次のファイルがある場合

PATCH_CLASSPATH

ファイル:

MW_HOME\patch_wls103\profiles\custom-profile\
sys_manifest_classpath\weblogic_patch.jar

変数の目的:

PATCH_CLASSPATH変数は、WebLogicシステム・クラスパスに挿入されるパッチJARファイル内のクラスを参照します。WebLogicシステム・クラスパスは、ドメイン内のノード・マネージャによって起動される各管理対象サーバーが使用するものです。

例:

PATCH_CLASSPATH= "%MW_HOME%\patch_wls103\profiles\
myCustomProfile\sys_manifest_classpath \weblogic_patch.jar"

注意: My Oracle Supportが発行する大部分のパッチは、このパッチ・マニフェストJARファイルで参照されます。

WEBLOGIC_EXTENSION_DIRS

ファイル:

MW_HOME\patch_wls103\profiles\custom-profile\
sysext_manifest_classpath\weblogic_ext_patch.jar

変数の目的:

Weblogic_EXTENSION_DIRS変数は、アプリケーションのクラスパスに挿入されるパッチJARファイル内のクラスを参照します。アプリケーションのクラスパスは、WebLogic Serverにデプロイされ、製品で必要となるものです。

例:

WEBLOGIC_EXTENSION_DIRS="%MW_HOME%\
patch_wls103\profiles\myCustomProfile\
sysext_manifest_classpath\weblogic_patch.jar"

注意: WebLogic Server 9.1では、アプリケーション・レベルのクラスを参照するパッチ・マニフェストJARファイルはサポートされません。

PATCH_LIBPATH

ディレクトリ(UNIXのみ):

MW_HOME/patch_wls103/profiles/custom-profile/native

変数の目的:

PATCH_LIBPATH変数は、LIBPATH環境変数を介して、システム・パスに挿入されるネイティブ・ライブラリ・ファイルを参照します。

例:

PATCH_LIBPATH="${MW_HOME}/patch_wls103/
profiles/myCustomProfile/native"

PATCH_PATH

ディレクトリ(Windowsのみ):

MW_HOME\patch_wls103\profiles\custom-profile\native

変数の目的:

PATCH_PATH変数は、PATH環境変数を介して、システム・パスに挿入されるネイティブ・ライブラリ・ファイルを参照します。

例:

set PATCH_PATH=%MW_HOME%\patch_wls103\
profiles\myCustomProfile\native

4. 管理対象サーバーの各インスタンスを再起動します。それを行うまで、ノード・マネージャ構成ファイルとパッチ・パス変数定義に対する更新は有効になりません

7 パッチのアンインストール

パッチをアンインストールする場合もあります。Smart Updateを使用してインストール済のパッチを削除することによってインストールを元に戻します。

- 製品のアンインストールに関する重要な注意

- パッチの削除

- サービス・パックまたはメンテナンス・パックのアンインストールまたはアップグレード

製品のアンインストールに関する重要な注意

製品をアンインストールしても、その製品に適用されているパッチは削除されません。このことが重要になるのは、ミドルウェア・ホーム・ディレクトリにある複数の製品のパッチが同一のパッチ・プロファイルに適用されているときに、1つの製品をアンインストールしても他の製品は引き続き使用する場合です。この状況が発生した場合、使用を継続する製品は、アンインストールされた製品のパッチが適用された状態で実行されます。

パッチの削除

Smart Updateを使用すると、パッチ・ファイルに適用されているパッチを簡単に削除できます。

注意:

インストール適用範囲の共有アーカイブ・パッチをカスタム・プロファイルから削除することはできません。デフォルト・プロファイルでのみ削除できます。この場合、インストールと同様に、デフォルト・プロファイル、およびデフォルト・プロファイルが最初に適用されたすべてのカスタム・プロファイルからパッチが削除されます。

パッチまたはパッチ・セットの削除

パッチまたはパッチ・セットを削除するには、次の手順を実行します:

1. Smart Updateを起動します。

2. 「ターゲット・インストール」ペインで、削除するパッチをホストする製品のインストールを選択します。

3. 「パッチの管理」タブを選択します。

4. 削除するパッチまたはパッチ・セットを含むパッチ・プロファイルを選択します。

5. 削除するパッチまたはパッチ・セットの右側にある下矢印付きの「削除」ボタンをクリックします。

6. 「プロファイルからのパッチの削除」ダイアログ・ボックスで、「OK」をクリックします。
検証のダイアログ・ボックスが表示されます。別のパッチが依存しているパッチを削除しようとすると、削除によって発生する競合が報告されるので、続行する前に解決する必要があります。パッチ削除による競合の解決方法は、『パッチの削除時の検証』を参照してください。パッチ削除の進捗はステータス画面から確認できます。削除が完了すると、メッセージが表示されます。

7. パッチ削除が有効になるように、実行中のWebLogic Serverインスタンスがあればシャットダウンして再起動します。

注意:

パッチ・セットに属するパッチを削除した場合、「ダウンロードされたパッチ」パネルに表示されるパッチ・プロファイルの内容の一覧から、そのパッチ・セットのエントリが削除されます。ただし、パッチ・セットの中で削除されていない他のパッチについては、その場所で引き続き一覧に表示されます。

サービス・パックまたはメンテナンス・パックのアンインストールまたはアップグレード

Smart Updateは、個々のパッチの削除にのみ使用できます。Smart Updateを使用してサービス・パック、メンテナンス・パックまたはアップグレード・インストーラでインストールしたバージョンのアップグレードを削除することはできません。これらのアップグレードを削除するには、WebLogic Serverのアンインストール・プログラムを使用します。詳細は、『Oracle WebLogic Serverインストレーション・ガイド』のソフトウェアのアンインストールに関する項を参照してください。

8 コマンド・ライン・インタフェースの使用

この項では、Smart Update bsuコマンドについて説明します。これはパッチ・ダウンロード・ディレクトリにダウンロードされているパッチを適用するコマンドであり、対話形式またはスクリプトで使用できます。bsuコマンドをスクリプトで使用すると、複数のシステムにインストールされている製品に対して特定のメンテナンス・レベルを複製するためのメカニズムを構築できます。本番環境では、複数のシステムに対するソフトウェア更新の配布作業を、管理された方法で、信頼性と再現性を確保しつつ実施する必要があるため、この機能が特に役立ちます。

以下の内容について説明します。

- bsuコマンドについて

- bsuコマンド・リファレンス

- コマンド・ライン・インタフェースの例

bsuコマンドについて

bsuコマンドを対話形式またはスクリプトで使用する際の注意事項を次に示します。

- MW_HOME\utils\bsuディレクトリにあるbsuスクリプト(Windowsシステムではbsu.cmd、UNIXシステムではbsu.sh)が実行されます。bsuコマンドを実行する際には、まずスクリプトを実行するシステムでこのディレクトリに移動してください。

- コマンド・ファイル(Windows)またはシェル・スクリプト(UNIX)から実行できます。

- Smart Update機能のサブセットを備え、次の処理を実行できます。

- アクセス可能なパッチ・ダウンロード・ディレクトリにあるパッチの適用と削除

- ダウンロード・ディレクトリにあるパッチの表示、現在のシステムにあるいずれかの製品インストールに適用されたパッチの表示、現在のシステムにある特定のパッチ・プロファイルに適用されたパッチの表示

- 製品インストールへ適用したパッチをリストするレポートの生成

また、bsuコマンドからSmart Updateグラフィカル・インタフェースを呼び出して、ログ・ファイルにメッセージを送信することもできます。

- パッチの適用および表示は、次のとおり、コマンドを実行したシステムからインストールされた製品に対してのみ実行できます。

- 現在のシステムに、別のシステムによってインストールされた製品がある場合、そのインストールに対してはパッチの適用や表示を実行できません。

- リモート・マウントされたディスク・ドライブ上に、現在のシステムを使用してインストールされた製品がある場合、そのインストールに対してはbsuコマンドを使用できます。

つまり、特定の製品インストールに対してbsuコマンドによるメンテナンスが可能であるための条件は、Smart Updateのグラフィカル・インタフェースを使用するための条件と同じです。

- 次の作業を実行することはできません。

- カスタム・パッチ・プロファイルの作成

- 修正する起動スクリプトの配置

これらの機能は、Smart Updateのグラフィカル・インタフェースでのみ使用できます。

注意:

Smart Updateコマンド・ライン・インタフェースとグラフィカル・インタフェースの両方を同時に実行しているとき、コマンド・ライン・インタフェースからパッチ・プロファイルに対して加えた変更は、グラフィカル・インタフェース上で当該パッチ・プロファイルの表示をリフレッシュしても表示に反映されません。

bsuコマンド・リファレンス

この項では、bsuコマンドの構文について説明します。パラメータ引数が大カッコ付きで示されている場合、その引数はオプションです。

表8-1で、bsuコマンドのパラメータおよび引数について説明します。

注意:

表8-1では、大カッコ[..]は引数がオプションであることを表しています。たとえば、[-profile=profile_name]は、-installパラメータのオプション引数です

表8-1 bsuコマンドのパラメータおよび引数

パラメータ

説明

引数

-help

bsuのパラメータおよび引数の概要を表示します

なし。

-install

ターゲット・インストールに特定のパッチを適用します。有効なプロファイル名を指定する必要があります。

[-patchlist=patch1[,patch2,patch3]

適用される各パッチのID(patch1、patch2、patch3)を指定します。

[-profile=profile_name]は、パッチが適用されるパッチ・プロファイル(profile_name)を指定します。表の最後にある注意を参照してください。[-patch_download_dir=path]は、パッチの適用元となるパッチ・ダウンロード・ディレクトリをpathで指定します。パッチ・ダウンロード・ディレクトリを指定しない場合、Smart Updateグラフィカル・インタフェースの「プリファレンス」ダイアログ・ボックスで指定されたパッチ・ダウンロード・ディレクトリがデフォルトで使用される(「プリファレンス」ダイアログ・ボックスでも指定されていない場合は、MW_HOME\utils\bsu\cache_dirが使用されます。)[-verbose]は、適用される各パッチに関連する詳細情報をすべて表示します。[-prod_dir=path]は、パッチが適用されるターゲット・インストール(path)を指定します。たとえば、WebLogic ServerとPortalの場合はMW_HOME\wlserver_10.3になります。

-gui

Smart Updateグラフィカル・インタフェースを起動します。

なし。

-log

対応するbsuコマンドのログ情報の送信先となるファイルを、指定した場所に作成します。

注意: -logパラメータで記録されるのはbsuコマンドのアクティビティのみであり、パッチまたはプロファイルに関連するアクティビティは記録されません。

=path

作成されるログ・ファイルのファイル名と場所(path)を指定します。

[-log_priority= {trace|debug|info|warn|error|fatal}]

取り込むログ情報の優先度を指定します。デフォルトの優先度はdebugです。

-remove

指定したパッチをプロファイルから削除します。

[-patchlist=patch1[,patch2,patch3]

適用される各パッチのID(patch1、patch2、patch3)を指定します。[-profile=profile_name]は、パッチが削除されるパッチ・プロファイル(profile_name)を指定します。表の最後にある注意を参照してください。[-prod_dir=path]は、パッチが削除されるターゲット・インストール(path)を指定します。[-verbose]は、適用される各パッチに関連する詳細情報をすべて表示します。

-report

適用されたパッチおよびミドルウェア・ホーム・ディレクトリで変更のあった関連ファイルについて表示するレポートを生成します。

-BEA_HOME=path

パッチが適用されるターゲット・インストール(path)を指定します。パスが指定されていない場合、このオプションによってすべての製品インストールについてのレポートが生成されます。該当するミドルウェア・ホーム・ディレクトリを指定します。[-product_mask=regexp]は、正規表現regexpによって表される一致した製品にレポートを制限します。

注意: 複数の引数を指定するには、正規表現を使用します。たとえば、-product_mask=WebLogic.*では、WebLogicで始まるすべての製品がフィルタされます。[-release_mask=regexp]は、正規表現regexpによって表されるものと一致する製品リリースにレポートを限定します。[-profile_mask=regexp]は、正規表現regexpによって表されるものと一致するパッチ・プロファイルにレポートを限定します。[-patch_id_mask=regexp]は、正規表現regexpによって表されるものと一致するパッチにレポートを限定します。[-output_format=text|xml]は、レポートのフォーマットを指定します。使用可能なオプションはtextとxmlです。デフォルトのフォーマットは、textです。[-output_file=path]は、pathとして表されるレポートが格納されているディレクトリを指定します。レポート出力用のパスが指定されていない場合は、stdoutが使用されます。

-version

バージョン情報を表示します。

例:

Oracle Smart Update. Version: 3.3.3.0

なし。

-view

適用されているパッチまたはパッチ・ダウンロード・ディレクトリにあるパッチのIDを表示します

[-profile=profile_name]

profile_nameで指定したプロファイルに適用されるパッチのIDを表示します。この引数を指定しない場合、デフォルト・パッチ・プロファイルがデフォルトで使用されます。

表の最後にある注意を参照してください。[-patch_download_dir=path]は、pathで指定したパッチ・ダウンロード・ディレクトリにダウンロードされているパッチのIDを表示します。パッチ・ダウンロード・ディレクトリを指定しない場合、「プリファレンス」ダイアログ・ボックスで指定されたパッチ・ダウンロード・ディレクトリがデフォルトで使用される(「プリファレンス」ダイアログ・ボックスでも指定されていない場合は、MW_HOME\utils\bsu\cache_dirが使用されます。)[-status={applied|downloaded}は、表示されるパッチの現在のステータスを表示します。この引数にappliedを指定すると、ターゲット・インストールに適用されているパッチのIDが表示されます。この引数を-profileとともに使用すると、特定のプロファイルのメンテナンス・スナップショットを作成できます。downloadedを指定すると、ダウンロード・ディレクトリにあるがまだ適用されていないパッチのIDが表示されます。

[-verbose]は、表示対象の各パッチに関連する詳細情報をすべて表示します。-prod_dir=path

pathで表される場所にあるターゲット・インストールに適用されるパッチのIDを表示します。

注意:

profileを指定しない場合は、デフォルト・プロファイルが使用されます。

profile引数を使用し、無効なプロファイルを指定した場合、そのプロファイルはデフォルトに設定されず、次のエラーが表示されます。

$ bsu -view -status=applied -prod_dir=C:/10_WLP/wlserver_version-profile=profile3
The specified profile could not be found.[profile_name]

コマンド・ライン・インタフェースの例

この項では、次のbsuコマンドの例を示します。

- インストールの例

- パッチの表示の例

- パッチの表示の例(2)

- メンテナンス・スナップショットの表示

- 適用済みパッチのレポート

インストールの例

次のコマンドでは、現在のシステムに設定されているパッチ・ダウンロード・ディレクトリからIRZ2というパッチがインストールされます。

bsu -prod_dir=c:\Oracle\Middleware\wlserver_10.3 -patchlist=IRZ2 -verbose -install

このコマンドを実行すると、パッチが正常に適用されたことを示す次の出力が表示されます。

Checking for conflicts.
No conflict(s) detected

Starting installation of Patch ID: IRZ2
Installing C:\Oracle\Middleware\download-dir\IRZ2.jar
Result: Success

パッチの表示の例

次のコマンドでは、パッチ・ダウンロード・ディレクトリc:\patchdirにあるパッチの一覧が表示されます。

bsu -view -status=downloaded -prod_dir=C:\Oracle\Middleware\wlserver_10.3
-patch_download_dir=C:\patchdir

このコマンドを実行すると、次のような結果が表示されます。

C:\Oracle\Middleware\utils\bsu>bsu -view -status=downloaded
-prod_dir=C:\Oracle\Middleware\wlserver_10.3 –patch_download_dir=C:\patchdir
ProductName:     WebLogic Platform
ProductVersion:  10.3
Components:      WebLogic Platform/WebLogic Server,WebLogic Platform/Workshop
for WebLogic Platform,WebLogic Platform/WebLogic Portal
BEA_HOME:         C:\Oracle\Middleware
ProductHome:     C:\Oracle\Middleware\wlserver_10.3
PatchSystemDir:  C:\Oracle\Middleware\utils\bsu
PatchDir:    C:\Oracle\Middleware\patch_wls_1032
Profile:         Default
DownloadDir:     C:\patchdir
JavaHome:        C:\Oracle\Middleware\jrockit160_14_R27.6.5-32
JavaVersion:     160_14_R27.6.5-32
JavaVendor:      ORACLE
Patch ID:        9A5T (10131320)
Patch ID:        585H (10201173)
Patch ID:        8LU6 (10106400)
Patch ID:        AFJ5 (10111681)
Patch ID:        Q8K5 (10085296)

パッチの表示の例(2)

次のコマンドでは、システムで指定されているパッチ・ダウンロード・ディレクトリにダウンロードされた、ターゲット・インストール用のパッチのセットが表示されます。

bsu -view -prod_dir=C:\Oracle\Middleware\wlserver_10.3 -status=downloaded -verbose

このコマンドを実行すると、次のような結果が表示されます。

ProductName:       WebLogic Platform
ProductVersion:    10.3
Components:        WebLogic Server/Server,WebLogic Server/Server Examples,
AquaLogic Service Bus/Service Bus
BEA_HOME:           C:\Oracle\Middleware
ProductHome:       C:\Oracle\Middleware\wlserver_10.3
DownloadDir:       C:\Oracle\Middleware\download-dir
JavaHome:        C:\Oracle\Middleware\jrockit160_14_R27.6.5-32
JavaVersion:     160_14_R27.6.5-32
JavaVendor:        ORACLE
Patch ID:          FZN2
PatchContainer:    FZN2.jar
Checksum:          -174938558
Component:         WebLogic Server
Severity:          critical
Category:          Security
CR:                CRxxyyzz
Restart:           false
Description:       ATN fix for xxxx
Patch ID:          GWQR
PatchContainer:    GWQR.jar
Checksum:          1170817068
Component:         AquaLogic Service Bus
Severity:          optional
Category:          Multiple
CR:                CRxxyyzz
Restart:           true
Description:       One more ALSB patch

メンテナンス・スナップショットの表示

次のコマンドでは、デフォルト・パッチ・プロファイルのメンテナンス・スナップショットが表示されます。

bsu -view -status=applied -prod_dir=c:\BEA\wlserver_10.0

このコマンドを実行すると、次のような結果が表示されます。

C:\Oracle\Middleware\utils\bsu>bsu -view -status=applied
-prod_dir=C:\Oracle\Middleware\wlserver_10.0
ProductName:       WebLogic Server
ProductVersion:    10.0
Components:        WebLogic Server/Server,WebLogic Server/Server Examples,
WebLogic Server/Server
BEA_HOME:   C:\Oracle\Middleware
ProductHome:       C:\Oracle\Middleware\wlserver_10.0
PatchSystemDir:    C:\Oracle\Middleware\utils\bsu
PatchDir:          C:\Oracle\Middleware\patch_wls1000
Profile:           Default
DownloadDir:       C:\Oracle\Middleware\utils\bsu\cache_dir
JavaHome:          c:\Oracle\Middleware\jdk150_06
JavaVersion:       1.5.0_06
JavaVendor:        Sun
Patch ID:          PBLW (CR838734)

ProductName:       WebLogic Portal
ProductVersion:    10.0
Components:        WebLogic Portal/Portal Server,WebLogic Portal/WebLogic Works
WebLogic Portal/Portal Examples
BEA_HOME:   C:\Oracle\Middleware
ProductHome:       C:\Oracle\Middleware\wlserver_10.0
PatchSystemDir:    C:\Oracle\Middleware\utils\bsu
PatchDir:          C:\Oracle\Middleware\patch_wlp1000
Profile:           Default
DownloadDir:       C:\Oracle\Middleware\utils\bsu\cache_dir
Patch ID:          FJTH (CR861234)

C:\Oracle\Middleware\utils\bsu>
C:\Oracle\Middleware\utils\bsu>bsu -view -status=applied -prod_dir=C:\10_WLP_0
320\workshop_10.0
ProductName:       Workshop for WebLogic
ProductVersion:    10.0
Components:        Workshop for WebLogic Platform/Workshop,Workshop for WebLogic Platform/Workshop Examples
BEA_HOME:          C:\Oracle\Middleware
ProductHome:       C:\Oracle\Middleware\workshop_10.0
PatchSystemDir:    C:\Oracle\Middleware\utils\bsu
PatchDir:          C:\Oracle\Middleware\patch_wlw1000
Profile:           Default
DownloadDir:       C:\Oracle\Middleware\utils\bsu\cache_dir
Patch ID:          8K9T (CR873456)

適用済みパッチのレポート

次のコマンドでは、MW_HOMEに適用したパッチのうち、パッチIDの最初の文字が6であるパッチのレポートが生成されます。

bsu -report -patch_id_mask=6.*

このコマンドを実行すると、次のような結果が表示されます。

Patch Report
============
Report Info
Report Option
BEA_HOME ### OPTION NOT SET
product_mask.. ### OPTION NOT SET
release_mask.. ### OPTION NOT SET
profile_mask.. ### OPTION NOT SET
patch_id_mask. 6.*
Report Messages
BEA_HOME D:\Platform92\BEA_HOME
Product Description
Product Name.. WebLogic Platform
Product Version.. 9.2.0.0
Installed Components WebLogic Server, Workshop for WebLogic Platform,
WebLogic Integration, WebLogic Portal
Product Install Directory. D:\Platform92\BEA_HOME\weblogic92
Java Home.. D:\Platform92\BEA_HOME\jrockit90_150_04
Jave Vendor BEA
Java Version.. 1.5.0_04
Patch Directory.. D:\Platform92\BEA_HOME\patch_weblogic920

Profile. Default

Patch ID 6L1H
CR(s) CR285988
Description Fix P13N processing of Platform Domain Upgrade.
Intended for use with WLI 9.2
Classpath
Classpath type SYSTEM
Classpath control jar.. weblogic_patch.jar
Jar.. CR285988_920.jar
File.com/BEA/p13n/upgrade/LibraryModuleConfigProcessor.class
File. com/BEA/p13n/upgrade/P13nDatabasePlugIn.class
File. resources/p13n-upgrade.xml
File. resources/P13nCommonPlugIn-definition.xml
File. resources/portal-upgrade.xml
File. META-INF/MANIFEST.MF

Patch ID 6MK8
CR(s) CR262488
Description Allow WLI Domains to be upgraded by Domain Upgrade Wizard
Classpath
Classpath type SYSTEM
Classpath control jar.. weblogic_patch.jar
Jar.. CR262488_920.jar
File.weblogic/upgrade/domain/directoryselection/DomainDirectorySelectionPlugIn.class
File.weblogic/upgrade/domain/directoryselection/i18n_DomainDirectorySelectionPlugIn.properties
File. META-INF/MANIFEST.MF

9 パッチの配布に関するベスト・プラクティス

この節では、以下のトピックについて説明します。

- 本番環境へのパッチの配布

- My Oracle Supportに接続できないシステムへのパッチの提供

本番環境へのパッチの配布

この節では、本番環境にパッチを配布する次のモデルについて説明します。

- Smart Updateスクリプトを使用した標準メンテナンス・レベルから本番環境へのプロモート

- 製品インストール環境のアーカイブの作成と配布

これらのモデルでは、本番環境のシステムに対するソフトウェア・メンテナンスの提供について、次の条件が想定されています。

- ベンダーから取得したパッチが厳密に制御され、管理されています。たとえば、保護されたリポジトリに保持され、少数の担当者を除いてアクセスを許可されないようになっています。パッチをリポジトリ内にコピーまたはダウンロードするには、承認、スケジューリング、監査、記録について厳格な手順を踏む必要があります。

- パッチは、本番システムにプロモートされるまでに所定の段階を経る必要があり、その過程で徹底的にテストされます。たとえば、最初は本番環境から隔離された単一のシステムにパッチがインストールされ、そこで実施される本番アプリケーションのテストによって、パッチが想定どおりに機能し、回帰が発生しないことが保証されます。場合によっては、本番環境に展開する前に、本番環境で想定される使用状況を模した負荷を課して中間ステージング領域でのテストが実施される場合があります。

- パッチが本番環境に導入されたら、パッチがインストールされたすべてのシステムで、更新された製品ソフトウェアを正確に同じメンテナンス・レベルで動作させる必要があります。たとえば、すべてのシステムで使用されるWebLogic Server 9.1のドメイン構成、製品バージョンおよびパッチ・レベルは同一となります。

- 本番環境のシステムからインターネットに接続してパッチを取得できるとは限りません。実際、本番環境のシステムがまったくインターネットに接続されておらず、インターネット接続の可能なシステムによって共有されているローカル・エリア・ネットワークにも接続されていないことがあります。むしろ、パッチは組織内のある特定の場所または複数の場所からのみ入手可能にさせられ、また、本番システムにダウンロードする際には、いくつかの運用上の規定や手順を遵守する必要があります。

- 本番環境で使用されるWebLogic Serverインスタンスが、多くのカスタマイズを施したスクリプトから起動されます。

Smart Updateスクリプトを使用した標準メンテナンス・レベルから本番環境へのプロモート

この項では、前述の条件のいくつかまたはすべてに該当する本番システムにパッチを配布する作業の例を示すことで、Smart Updateの機能がどのように役立つかを説明します。

1. My Oracle Supportは、Avitek社に対して、同社がWebLogic Server 9.1上で実行しているエンタープライズ・アプリケーションについて報告した問題を解決するためのパッチを提供しました。

2. Avitek社のIT部門に所属しているBob Jonesは、提供されたパッチを自分のシステムのパッチ・ダウンロード・ディレクトリにダウンロードしました。このディレクトリは、ITで使用されるネットワーク・ディスクに設定されており、そこにAvitekのソフトウェア・ベンダーすべてから提供されるメンテナンス更新が格納されています。

3. Rachel BurnsはAvitek社の品質保証(QA)部門の社員であり、自分のシステムでパッチをテストすることを担当しています。Rachelのシステムには、本番環境で使用されているのと同一のWebLogic Server環境があります。Rachelのシステムにあるドメイン構成は、Avitek社の本番環境で動作中のWebLogicドメインと類似しています。Rachelは、本番環境で使用し、自分のシステムでも実行するWebLogic Server起動スクリプトを作成しました。
Rachelはオフライン・モードでSmart Updateを実行しました。パッチ・ダウンロード・ディレクトリをBobが使用したディレクトリに設定していることを確認してから、そのパッチを自分のWebLogic Serverインストール環境に適用しました。

4. Rachelは、本番システムがカスタマイズしたWebLogic Server起動スクリプトを使用しており、パッチに存在するクラスが自分のシステムのWebLogicシステム・クラスパスにロードされるようにスクリプトを変更する必要があることに気づきました。
Rachelは、起動スクリプトでデフォルト・パッチ・プロファイルを参照するようにPATCH_CLASSPATH変数の定義を起動スクリプトに追加し、この変数をSET WEBLOGIC_CLASSPATH文の先頭に追加しました。

5. Rachelはパッチのテストに成功し、Avitek社の本番環境で動作している20個の製品インストールすべてに対してこのパッチをレプリケートする準備を整えました。各本番システムはほとんど同じであるため、どのシステム上でも動作するパッチ適用スクリプトを1つ作成すればよいことをRachelは理解していました。
そこでスクリプトを作成しました。その機能は非常に単純で、ターゲット・インストールのデフォルト・パッチ・プロファイルにパッチを適用し、更新した起動スクリプトを各システムの適切な場所にコピーするというものです。

6. Rachelはこのパッチをパッチ・ダウンロード・ディレクトリにアップロードしました。このディレクトリは、Avitek社のDMZにある本番システムで使用される、セキュリティで保護されたディスク上にあります。また、Smart Updateスクリプトと新しいWebLogic Server起動スクリプトも、この保護されたディスクにアップロードしました。

7. Dagmar Kohlは、Avitek社の本番環境にあるシステムの管理者です。彼女は、Smart Updateスクリプトを各本番システムにダウンロードして実行しました。

8. パッチの内容から考えて、Dagmarは、パッチを有効にするために各サーバーを再起動する必要があることを理解しました。サーバーを再起動し、メンテナンス作業は完了しました。

製品インストール環境のアーカイブの作成と配布

「Smart Updateスクリプトを使用した標準メンテナンス・レベルから本番環境へのプロモート」で説明している手順の代替手段として、完全にパッチを適用した製品イメージのアーカイブを作成し、そのイメージを本番環境全体のすべてのシステムにレプリケートする方法もあります。このアプローチを実行する場合は、次の点に注意してください。

- このアプローチはお薦めしません。オラクル社では、製品インストーラを使用して製品のインストールをシステムに作成すること、およびSmart Updateを使用してパッチを配布することを常にお薦めしています。

- 製品インストール環境にSmart Updateを使用して適用されているメンテナンス・パッチが存在する場合には、アーカイブ・イメージに次のディレクトリを含める必要があります。このディレクトリはミドルウェア・ホーム・ディレクトリの最上位レベルに存在します。

- patch_versionおよびすべてのサブディレクトリ

- utilsおよびすべてのサブディレクトリ

My Oracle Supportに接続できないシステムへのパッチの提供

「My Oracle Supportに直接接続できないマシンのメンテナンス」で説明に従って、Smart Updateのオフライン・モードを使用すれば、My Oracle Supportに接続できないシステムにメンテナンス更新をインストールできます。この項では、そうしたシステムにパッチを適用するための次の方法について説明します。

- 共有パッチ・ダウンロード・ディレクトリ経由でオフライン・システムにパッチを適用する

- リムーバブル・メディア経由でオフライン・システムにパッチを適用する

- オフライン・システムにパッチを適用するためのその他の手段

これらの方法についてこの後の項で説明する際には、My Oracle Supportに接続できないシステムのことをオフライン・システムと呼びます。

共有パッチ・ダウンロード・ディレクトリ経由でオフライン・システムにパッチを適用する

次の項では、共有パッチ・ダウンロード・ディレクトリ経由でオフライン・システムにパッチを適用する方法について説明します。

- 要件

- 手順

要件

共有パッチ・ダウンロード・ディレクトリ経由でオフライン・システムにパッチをインストールするには、主として次の2つを用意する必要があります。

- My Oracle Supportへの接続を確立できるシステム。このシステムには次のものが必要です。

- オフライン・システムにインストールされている製品とバージョンが同じ製品のローカル・インストール

- My Oracle Supportのユーザー・アカウント

- My Oracle Supportに接続できるシステムとオフライン・システムの両方からアクセス可能な、ネットワーク上のディスク

手順

インターネットにアクセスできるシステムから、インターネットに接続できないシステムにリモートでパッチを適用するには、インターネットにアクセスできるシステムを使用して次の手順を実行します。

1. My Oracle Supportに接続できるシステムからMy Oracle Supportへログインし、目的のパッチをパッチ適用元のディレクトリにダウンロードします。第2章 「パッチのダウンロード」を参照してください。

2. Smart Updateを起動し、次の手順を実行します。

1. 「ファイル」→「プリファレンス」を選択し、手順1でダウンロードしたパッチの場所を指定します。

2. 公開パッチをダウンロードした場合、「ターゲット・インストール」パネルでオフライン・システムにインストールされたソフトウェアおよびそのバージョンと一致するインストールを選択します。

3. オフライン・システムで、次の手順を実行します。

1. Smart Updateを起動します。

2. 「ファイル」→「プリファレンス」を選択し、My Oracle Supportに接続されたシステムでパッチをダウンロードした場所にパッチ・ダウンロード・ディレクトリを設定します。

3. 「ターゲット・インストール」パネルで、パッチを適用するターゲット・インストールを選択します。

4. 「パッチの管理」タブで、目的のパッチ・プロファイルが選択されていることを確認します。

5. 「ダウンロードされたパッチ」パネルで、適用するパッチの横にある「適用」をクリックします。

6. 「パッチの適用および管理」の説明に従って、パッチを適用する手順をすべて完了します。

リムーバブル・メディア経由でオフライン・システムにパッチを適用する

次の項では、リムーバブル・メディア経由でオフライン・システムにパッチを適用する方法について説明します。

- 要件

- 手順

要件

リムーバブル・メディアを使用してオフライン・システムにパッチをインストールするには、主として次の2つを用意する必要があります。

- My Oracle Supportへの接続を確立できるシステム。このシステムには次のものが必要です。

- オフライン・システムにインストールされている製品とバージョンが同じ製品のローカル・インストール

- My Oracle Supportのユーザー・アカウント

- Oracleサポートに接続されたシステムとオフライン・システムの両方で使用できるタイプのリムーバブル・メディアにパッチを格納できること。例: 書込み可能なCD-ROMまたはDVD。

手順

リムーバブル・メディアを使用してオフライン・システムにパッチを適用するには、次の手順を実行します。

1. My Oracle Supportに接続できるシステムからMy Oracle Supportへログインし、リムーバブル・メディアにパッチをコピーするコピー元のディレクトリに目的のパッチをダウンロードします。第2章 「パッチのダウンロード」を参照してください。

2. Smart Updateを起動し、次の手順を実行します。

1. 「ファイル」→「プリファレンス」を選択し、手順1でダウンロードしたパッチの場所を指定します。

2. 公開パッチをダウンロードした場合、「ターゲット・インストール」パネルでオフライン・システムにインストールされたソフトウェアおよびそのバージョンと一致するインストールを選択します。

3. ダウンロードしたパッチをリムーバブル・メディアにコピーします。

3. オフライン・システムで、次の手順を実行します。

1. リムーバブル・メディアをオフライン・システムにマウントします。

2. Smart Updateを起動します

3. 「ファイル」→「プリファレンス」を選択し、パッチ・ダウンロード・ディレクトリを、パッチが格納されているリムーバブル・メディアのディレクトリとして設定します。

4. 「ターゲット・インストール」パネルで、パッチを適用するターゲット・インストールを選択します。

5. 「パッチの管理」タブで、目的のパッチ・プロファイルを選択します。

6. 「ダウンロードされたパッチ」パネルで、適用する各パッチの横にある「適用」をクリックします。

7. 「パッチの適用および管理」の説明に従って、パッチを適用する手順をすべて完了します。

オフライン・システムにパッチを適用するためのその他の手段

My Oracle Supportにオンライン接続する手段がない場合、My Oracle Supportでは、必要に応じて代替手段によってパッチを提供することがあります。

10 Smart Updateに関する既知の制限事項

この節では、Oracle Smart Updateに関する制限事項について示します。可能な場合は、回避策を示します。

一般的な問題と回避策

この項では、Oracle Smart Updateに関する次のような一般的問題と回避策について説明します。

- Smart Updateでサポートされていない製品のバージョン文字列がレジストリに存在すると、Smart Update 3.1の終了時にエラーが発生する

- Smart UpdateがApple Macintoshマシンで動作しない

- ノード・マネージャの実行中にSmart Updateを使用すると、例外がスローされる

- コマンド・ライン・モードでパッチ適用時の製品チェックが行われない

- 無効なパッチの代替として別の無効なパッチが表示される

- パッチ・プロファイル・メンテナンス・スナップショットをメモ帳で表示すると、書式が崩れる

- Smart Updateグラフィカル・ユーザー・インタフェースでまれに例外が表示される

- コンポーネントをアンインストールしてもコンポーネントのパッチが自動的に削除されない

- コマンド・ラインからインストールしたパッチは、GUIを再起動するまでGUIには反映されない

- WebLogic Server 10.3.2から10.3.1へのロールバック後に作成されたドメインで問題が発生する

Smart Updateでサポートされていない製品のバージョン文字列がレジストリに存在すると、Smart Update 3.1の終了時にエラーが発生する

Smart Updateでサポートされていない製品(Oracle Tuxedoなど)のバージョン文字列がレジストリに存在し、サポートされていない製品とWebLogic Serverが同じミドルウェア・ホームに位置している場合は、Smart Update 3.1の終了時にエラーが発生します。

このエラーが発生するのは、たとえば、Oracle Tuxedoに依存するPeopleSoftがインストールされたマシンで、Smart Updateを実行する場合です(Smart UpdateはOracle Tuxedoをサポートしていません)。

この問題を回避するには、Smart Update 3.2.1にアップグレードします。Smart Update 3.2.1では、サポートされていない製品のバージョン文字列が無視されます。

Smart Update 3.2.1にアップグレードするには、次の手順を実行します。

1. beahomelistファイルの名前をbeahomelist_に変更します。
Windowsの場合、beahomelistファイルは${SystemDrive}\beaフォルダにあります。LinuxとUNIXの場合、beahomelistファイルは${HOME}\beaフォルダにあります。

2. Smart Updateを起動します。
新しいバージョンのツールがダウンロードされ、Smart Updateのアップグレードが自動的に行われます。

3. Smart Updateを終了します。

4. beahomelist_ファイルの名前をbeahomelistに戻します。

Smart UpdateがApple Macintoshマシンで動作しない

Macintoshマシンでは、十分なヒープ・メモリーがデフォルトで割り当てられないため、Smart Updateを実行できません。

この問題を回避するには、MW_HOME/utils/bsuフォルダにあるbsu.shスクリプトを変更して、Javaヒープ・メモリーを増やします。

次のコードは、ヒープ・メモリーを増やすために編集する必要があるスクリプト行を示しています。編集後の値は太字で表されています。

"$JAVA_HOME/bin/java" -Xms64m -Xmx256m -jar patch-client.jar $*

ノード・マネージャの実行中にSmart Updateを使用すると、例外がスローされる

この問題は、MS Windowsプラットフォームのみに該当します。

ノード・マネージャの実行中に、Smart Updateを使用したパッチの適用または削除、あるいはミドルウェア・ホームへの増分インストールを行うと、例外com.bea.plateng.patch.PatchInstallationExceptionがスローされます。

ノード・マネージャの実行中、プロセスはファイルweblogic_patch.jarをロックします。その結果、weblogic_patch.jarの更新に失敗するため、パッチのインストールや削除が正常に行えません。

この問題を回避するには、同じミドルウェア・ホームから増分インストールまたはSmart Updateの起動を行う際に、ノード・マネージャを停止します。

コマンド・ライン・モードでパッチ適用時の製品チェックが行われない

WebLogic Integrationをコマンド・ライン・モードでインストールし、インストールの正常な完了後にパッチを自動的に適用するよう選択(オプション1を選択)した場合、インストーラはWebLogic Server、Workshop for WebLogicおよびWebLogic Portalにパッチを自動的に適用します。WebLogic Portalがインストールされているかどうかはチェックしないため、WebLogic Portalがインストールされていない場合でもWebLogic Portalのパッチが適用されます。

後でWebLogic Portalをインストールすると、インストーラによってパッチが上書きされてしまいますが、Smart Updateにはパッチが適用されていると表示されます。

この問題を回避するには、パッチをアンインストールしてからWebLogic Portalをインストールし、その後で、Smart Updateを使用してWebLogic Portalパッチを適用します。

無効なパッチの代替として別の無効なパッチが表示される

無効なパッチの詳細を表示すると、代替パッチのIDが示されていることがあります。しかし、後でその代替パッチがMy Oracle Supportによって無効に指定されても、このIDは更新されず、無効なパッチを示したままになります。

この問題の回避策は、My Oracle Supportにお問合せください。

パッチ・プロファイル・メンテナンス・スナップショットをメモ帳で表示すると、書式が崩れる

Smart Updateで生成されるパッチ・プロファイル・メンテナンス・スナップショット・ファイルは、メモ帳などの一般的なテキスト・エディタで表示すると読みにくくなります。スナップショット・ファイルには通常の改行文字が含まれていないため、列の表示が崩れ、容易に解読できません。

この問題を回避するには、ワードパッド、TextPadなどのテキスト・エディタを使用してファイルを表示します。このファイルをMy Oracle Supportに送付する場合、書式を整える必要はありません。

Smart Updateグラフィカル・ユーザー・インタフェースでまれに例外が表示される

Smart Updateグラフィカル・インタフェースの使用中、まれに次の例外が表示されることがあります。

java.util.ConcurrentModificationException
at
java.util.TreeMap$PrivateEntryIterator.nextEntry(TreeMap.java:1031)
at java.util.TreeMap$KeyIterator.next(TreeMap.java:1058)
at
com.bea.plateng.patch.gui.PatchStoreTableModel.getRowCount(PatchStoreTableModel.java:199)

この例外は無視してもかまいません。

コンポーネントをアンインストールしてもコンポーネントのパッチが自動的に削除されない

コンポーネントをアンインストールした場合に、そのコンポーネントに関連付けられたパッチが自動的に削除されません。パッチされたアーティファクトはアンインストール中に削除されるが、パッチ自体は適用されたままとなります。

この問題を回避するには、アンインストールの前に、Smart Updateを使用してコンポーネントに関連付けられているパッチを削除します。

コマンド・ラインからインストールしたパッチは、GUIを再起動するまでGUIには反映されない

Smart Updateのグラフィカル・インタフェースとコマンド・ライン・インタフェースの両方を同時に使用している場合、コマンド・ライン・インタフェースから適用したパッチは、GUIの表示をリフレッシュしてもGUIには反映されません。

この問題を回避するには、Smart UpdateのGUIを終了して再起動し、新しいパッチを表示します。

WebLogic Server 10.3.2から10.3.1へのロールバック後に作成されたドメインで問題が発生する

アップグレード・インストーラを使用してWebLogic Server 10.3.1からWebLogic Server 10.3.2にアップグレードした後、(WebLogic Serverアンインストーラのロールバック・オプションを使用して)10.3.1リリースにロールバックすると、次の問題が発生します。

- WebLogic Serverは起動しますが、検証エラーが発生

- 管理コンソールへのアクセス不可(ブラウザに500エラーが表示される)

10.3.0から10.3.2にアップグレードし、10.3.0にロールバックした場合、これらの問題は発生しません。

回避策

現在判明している唯一の回避策は、元のWebLogic Server 10.3.1インストールを復元することです(バックアップが取ってある場合に限ります)。

11 よくある質問

このFAQでは、次の質問について説明します。

- サポートIDを取得するにはどうすればよいですか。

- バグやCRとは何ですか。

- バグの修正はどうすれば入手できますか。バグのパッチは入手できますか。

- セキュリティ勧告の通知を取得するにはどうすればよいですか。

- プライベート・パッチとは何ですか。

- メンテナンス・パックを1つのみダウンロードするにはどうすればよいですか。

- Smart Updateツールを使用してパッチを適用できる製品にはどのようなものがありますか。

- My Oracle Supportからパッチをダウンロードするには、サポート契約が必要ですか。

サポートIDを取得するにはどうすればよいですか。

My Oracle Supportアカウントを取得するには、Oracleサポートのサイト(http://www.oracle.com/support/index.html)に移動し、「My Oracle Supportログイン」をクリックします。「My Oracle Support」ページで、指示に従って新規ユーザーとして登録します。

バグまたはCRとは何ですか。

バグとは、既存のコードにある欠陥や、ドキュメントに記述されているように実行できない機能です。CRとは、バグを表すBEAの用語です。

バグの修正はどうすれば入手できますか。バグに対するパッチは入手できますか。

My Oracle Supportへログインし、バグに対するパッチをダウンロードします。入手可能なパッチを表示および適用するには、Smart Updateツールを使用します。問題を修正するパッチがMy Oracle Supportから入手できない場合は、サポート問題としてMy Oracle Supportに報告してください。

セキュリティ勧告の通知を取得するにはどうすればよいですか。

「Critical Patch Updates and Security Alerts」ページ(http://www.oracle.com/technology/deploy/security/alerts.htm)に移動し、勧告と推奨される修正またはパッチの最新リストを確認します。http://www.oracle.com/technology/deploy/security/securityemail.htmlで登録を行い、セキュリティ勧告の通知を受け取ることもできます。

プライベート・パッチとは何ですか。

プライベート・パッチとは、カスタム・メンテナンス・ソリューションの一部としてMy Oracle Supportが提供するパッチであり、通常はMy Oracle Supportリポジトリからすべてのお客様に公開されるものではありません。

メンテナンス・パックを1つのみダウンロードするにはどうすればよいですか。

メンテナンス・パックは、有効なメンテナンス契約を結んでいるユーザーが個別にダウンロードして入手できます。メンテナンス・パックまたはサービス・パックの取得は、My Oracle Support(http://www.oracle.com/support/index.html)へログインし、メニューバーからパッチと更新版を選択します。目的のOracle製品とバージョンおよびメンテナンス・パックを選択します。詳しい手順は、『Oracle WebLogic Serverインストレーション・ガイド』のMy Oracle Supportからのアップグレード・インストーラのダウンロードに関する項を参照してください。

Smart Updateツールを使用してパッチを適用できる製品にはどのようなものがありますか。

「Smart Updateバージョン3.3.0でサポートされている製品」を参照してください。

My Oracle Supportからパッチをダウンロードするには、サポート契約が必要ですか。

My Oracle Supportアカウントを取得するにはサポート契約が必要です。パッチは、My Oracle Supportアカウントがある場合にのみダウンロードできます。

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

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

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

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

- Smart Update GUI用語集

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

Smart Updateには、ユーザーが問題を報告する際にMy Oracle Supportに送信する、ユーザーのOracle製品インストールについての情報をキャプチャするための仕組みが用意されています。この情報は、メンテナンス・スナップショットと呼ばれます。この項では、メンテナンス・スナップショットを作成するための手順を説明します。

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

1. Smart Updateを起動します。
Windows:

「スタート」メニューから「スタート」→「プログラム」→「Oracle WebLogic」→「Smart Update」を選択します。

UNIX:

1. MW_HOME/utils/bsuディレクトリに移動します。

2. bsu.shコマンドを入力します。

注意:

メンテナンス・スナップショットを生成するためにMy Oracle Supportにログインする必要はありません。

2. Smart Updateのメイン・ウィンドウに表示される「ターゲット・インストール」パネルで、問題を報告するOracle製品インストールを選択します。

3. 「パッチの管理」タブで、パッチ・プロファイルを選択します。

4. 「パッチ」→「パッチ・プロファイル」→「スナップショットの保存」を選択します。

5. 「スナップショットの保存」ダイアログ・ボックスで、メンテナンス・スナップショットのファイル名を入力し、「OK」をクリックします。
メンテナンス・スナップショットは、単純なASCIIテキスト・ファイルです。

6. My Oracle Supportにメンテナンス・スナップショットを送付します。電子メールを使用することをお薦めします。必要な場合は、印刷したファイルを郵送してもかまいません。

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

クラスまたはライブラリ・パス・パッチの範囲を特定のドメインまたはサーバーに制限する場合、次の手順を実行します。

注意:

カスタム・プロファイルは、Smart Update 3.3.0以降、非推奨になっています。これ以降、カスタム・プロファイルを使用しないようにお薦めします。カスタム・プロファイルでは、インストール全体で使用されるWebLogic Serverパッチのインストールがより複雑になっています。

1. カスタム・パッチ・プロファイルを作成し、そのプロファイルにパッチを適用します。

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

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

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

1. 目的のパッチをMy Oracle Supportからダウンロードし、パッチ・ダウンロード・ディレクトリに格納します。

2. Smart Updateを起動して、My Oracle Supportにログインし、「ターゲット・インストール」パネルでOracle製品を選択します。

3. 次の手順に従って、パッチの適用先となるカスタム・パッチ・プロファイルを作成します。

1. 「パッチ」→「パッチ・プロファイル」→「新規」を選択します。

2. カスタム・パッチ・プロファイルに名前を付けます。次に、ターゲット・インストールの既存のパッチ・プロファイルから内容のクローンを作成することにより、新しいカスタム・パッチ・プロファイルに最初から含まれるパッチのセットを指定します。
例: テスト・エンジニアは、QAドメインを本番システムと同じパッチ・メンテナンス・レベルで実行します。そのとき、手順1でダウンロードしたパッチを追加してから実行します。そこで、テスト・エンジニアはQADomainProfileというカスタム・パッチ・プロファイルを作成し、デフォルト・パッチ・プロファイルの内容のクローンを作成してQADomainProfileに設定します。このカスタム・パッチ・プロファイルが、ダウンロードしたパッチの適用先となります。

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

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

4. カスタム・パッチ・プロファイルに対し、必要に応じてパッチの適用または削除を実行します。
例: テスト・エンジニアは、手順2でダウンロードしたパッチを、カスタム・パッチ・プロファイルQADomainProfileに適用します。

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

注意:

起動スクリプト・エディタは、Oracle Enterprise RepositoryなどのOSGiベースの製品には対応していません。

6. 「パッチ」→「パッチ・プロファイル」を選択して起動スクリプト・エディタを開きます。カスタム・パッチ・プロファイル内のパッチを参照するように、適切な起動スクリプトを変更します。

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

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

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

9. 該当する起動スクリプトの中で、目的のカスタム・パッチ・プロファイルに含まれるクラス・パス、拡張ディレクトリ・パス、またはライブラリ・パスのパッチを参照する環境変数を作成します。
パッチ・クラスパスとその他の環境変数は製品ごとに設定します。WL_HOME\common\bin\setPatchEnv.cmd(Windows)またはWL_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スクリプトの変更に使用するスニペットの例を示しています。

10. 起動スクリプトに追加したパッチ・パス変数は、その他の環境スクリプトに対する呼出しよりも前に記述されている必要があります。たとえば、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

11. 「保存」をクリックします。
パッチを有効にするには、そのパッチを使用するすべてのサーバー・インスタンスを再起動する必要があります。

12. 後になってパッチの適用範囲を変更する必要が生じ、そのパッチが別のドメインやサーバーで使用されるようにする場合や、1つのインストール上で動作するすべてのサーバーおよびドメインで使用されるようにする場合は、適切なパッチ・プロファイルを更新します。
例: テスト・エンジニアによる品質検査用ドメインでのテストに合格したパッチは、プロモートされて本番用ドメインで使用されます。パッチをプロモートするために、テスト・エンジニアは次の作業を実行します。

1. Smart Updateを実行し、本番用ドメインで使用される製品インストールを選択します。

2. 「パッチの管理」タブで、デフォルト・パッチ・プロファイルを選択し、目的のパッチを適用します。

3. 本番用ドメイン内のサーバーを再起動します。

Smart Update GUI用語集

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

注意:

Oracle Fusion Middleware 11gR1リリースから、BEA_HOMEにかわってMW_HOMEが新たに使用されています。

表A-1 Smart Updateグラフィカル・インタフェース

画面またはパネル

記号

説明

ターゲット・インストール

ミドルウェア・ホーム・ディレクトリを表します。ミドルウェア・ホーム・ディレクトリには複数のOracle製品が格納されることがあります。メンテナンス・スナップショットを作成する際には、適切なミドルウェア・ホーム・ディレクトリを選択する必要があります。

Smart Updateグラフィカル・インタフェースには、現在のシステムでインストールされた製品のミドルウェア・ホーム・ディレクトリしか表示されません。リモート・マウントされたディスク上にあるミドルウェア・ホーム・ディレクトリは、現在のシステムからインストールされた場合にのみ表示されます。

ターゲット・インストール

製品のホーム・ディレクトリを表します。例: WebLogicプラットフォームまたはOracle Service Bus。

ターゲット・インストール

製品の特定のインストール(ターゲット・インストールと呼ばれる)を表します。たとえば、WebLogic Serverリリース9.1などです。

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

- 公開パッチまたはパッチ・セットの表示またはダウンロード

- パッチまたはパッチ・セットの適用または削除

- カスタム・パッチ・プロファイルの作成または削除

「ダウンロードされたパッチ」パネル

パッチ・ダウンロード・ディレクトリの内容が表示されます。プロファイルに適用されていないパッチのみが表示されます。

「ダウンロードされたパッチ」パネル

青色の矢印をクリックすると該当するパッチが現在のパッチ・プロファイルに適用されます。

「パッチの管理」タブ

個々のパッチ・プロファイルの内容、つまり選択中のターゲット・インストールに適用されたパッチのセットが表示されます。パッチの適用および削除は、「パッチの管理」タブで実行します。

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

「パッチの管理」タブ

指定のミドルウェア・ホーム・ディレクトリにあるインストール全体、つまり現在選択中のターゲット・インストールが適用範囲となっているパッチ・セットが表示されます。

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

「パッチの管理」タブ

赤色の矢印をクリックすると、該当するパッチがターゲット・インストールおよびプロファイルから削除されます。(削除されたパッチは「ダウンロードされたパッチ」パネルにリストされ、必要に応じてまた適用できます。)

「パッチの適用の検証」ダイアログ・ボックス

パッチの適用時に発生した競合が表示されます。どのパッチがどの適用済パッチと競合したのかが示されます。パッチの適用時に発生する可能性がある競合条件を次に示します。

「パッチの適用の検証」ダイアログ・ボックス

選択したパッチを適用する前に、別のパッチを適用する必要があります。この競合を解決するには:

1. 前提条件となっているパッチのIDを記録します。

2. 「取消」をクリックして、前提条件パッチをダウンロードして適用してから、選択したパッチを適用します

「パッチの適用の検証」ダイアログ・ボックス

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

1. 削除する必要のあるパッチのIDを記録します。

2. 「取消」をクリックし、特定されたパッチを削除します。

3. 選択したパッチをダウンロードして適用します。

4. ステップ2で削除したパッチをもう一度適用します。

「パッチの適用の検証」ダイアログ・ボックス

選択したパッチと共存できない別のパッチが、すでに1つ以上適用されています。この競合を解決するには、ターゲット・インストールに適用するパッチを選択する必要があります。

用語集

BEA_HOMEディレクトリ

Oracleソフトウェア製品がインストールされるルート・ディレクトリ。環境変数BEA_HOMEで表されます。

Oracle Fusion Middleware 11gR1リリースから、BEA_HOMEにかわってMW_HOMEが新たに使用されています(デフォルトはC:\Oracle\Middleware)。また、WL_HOMEはWebLogic Serverホームを表す変数です(デフォルトはC:\Oracle\Middleware\wlserver_version)。

bsuコマンド

Smart Updateコマンド・ライン・インタフェースを実行するためのコマンド。コマンド・ライン・インタフェースを実行するには、まずMW_HOME\utils\bsuディレクトリに移動する必要があります。第8章「コマンド・ライン・インタフェースの使用」を参照してください。

カスタム・パッチ・プロファイル

デフォルト・パッチ・プロファイルの他に、ユーザーが作成できるパッチ・プロファイル。カスタム・パッチ・プロファイルを使用すると、特定のOracle製品インストール環境で実行されている一部のサーバー(個別のドメイン、クラスタ、サーバーなど)に有効範囲を限定してパッチ・セットを適用できます。カスタム・パッチ・プロファイルについては、第5章「インストールおよびアプリケーションにおける適用済パッチのアクティブ化」を参照してください。

依存関係違反

既存のパッチが依存しているパッチを削除しようとしたときに報告される競合。

インストール・レベルのパッチ・ディレクトリ

パッチJARファイル、ネイティブ・パッチ、プロファイル・サブディレクトリ、パッチ・レジストリ、パッチ・マニフェストJARファイルのある、Smart Updateによって作成されたディレクトリ。

無効なパッチ

My Oracle Supportによって置き換えられたかまたは非推奨になったパッチ。Smart Updateで、パッチ・ダウンロード・ディレクトリ内に無効なパッチが検出された場合、そのことが自動的に通知されます。無効なパッチが適用されている場合は、パッチ・プロファイル内のエントリでそのパッチが強調表示されます。パッチのアイコンをクリックすると、代替パッチが提供されている場合は、無効なパッチの置換えに関する情報が表示されます。

メンテナンス・パック

既存のリリースに対する更新。既知の問題のソリューションや、その他の製品の機能強化が含まれます。メンテナンス・パックは、Oracle製品を置き換えるものではなく、製品に対する変更や追加をまとめたパッケージです。

サービス・パックは、WebLogic Platform 9.2メンテナンス・パック1からメンテナンス・パックにかわりました。メンテナンス・パックは、Oracle WebLogic Server 10.3.xから、バージョン・アップグレード(Oracleパッチ・セット・リリース)で置き換えられます。

メンテナンス・パックの適用または削除、バージョン・アップグレード、サービス・パックにSmart Updateを使用できなくなったことに注意してください。

メンテナンス・スナップショット

Smart Updateを使用して生成できるテキスト・ファイル。特定のパッチ・プロファイルのターゲット・インストール環境に関する現在のメンテナンス・レベルの詳細が記述されています。

モジュール・パッチ

共通モジュールと製品固有モジュールを更新するパッチ。

相互に排他的です

ダウンロードや適用を選択したパッチが、ターゲット・インストール環境で既存のパッチと共存できない場合に報告される競合。競合の原因となる既存のパッチのIDが示されます。

ミドルウェア・ホーム(MW_HOME)ディレクトリ

環境変数MW_HOMEで表され、Oracleソフトウェア製品がインストールされるルート・ディレクトリ。Oracle Fusion Middleware 11gR1リリースから、BEA_HOMEにかわってMW_HOMEが新たに使用されています。

ネイティブ・アーティファクト・ファイル

オペレーティング・システム固有のファイル。バイナリ・ファイルまたは他のリソースの場合があります。

順序が間違っています

複数のパッチを間違った順序でダウンロードまたは適用しようとした場合に報告される、パッチ間の競合。この競合が報告された場合は、選択したパッチの正しい適用順序が示されます。

パッチ・マニフェストJAR

MW_HOME\patch_wls1032\\patch_jarsディレクトリに存在するパッチJARを参照するファイル

パスコード

Oracleサポートから提供される英数字の文字列。プライベート・パッチを取得するためにパッチIDとともに使用します。プライベート・パッチはSmart Updateでは利用できなくなりました。

パッチ

個別のコンポーネントのバグ修正用に発行されるメンテナンス・パック更新の間に発行されるパッチ。パッチでは、製品の機能強化は行われません。

パッチ・バックアップ・マニフェスト

パッチの適用によって置き換えられたファイルを格納する、MW_HOME\patch_wls1032\backupディレクトリに保存されるファイル。このディレクトリには、システムを以前のパッチ・メンテナンス・レベルに復元するために必要なファイルが格納されます。

パッチ間の競合

ターゲット・インストール環境にダウンロード、適用、削除のために選択したパッチと、その環境にすでに適用されている他のパッチとの間でSmart Updateによって検出される互換性の問題。

パッチ・コンテナ

パッチ・ダウンロード・ディレクトリに保持される、Oracleサポートからダウンロードしたファイル。パッチそのものと、検証に使用されるパッチのメタデータを含みます。

パッチJARファイル

クラスパスに挿入される予定のクラスを含むJARファイル。たとえば、WebLogicシステム・クラスパス、またはWebLogic Serverにデプロイされたアプリケーションのクラスパスに挿入されます。パッチJARファイルは、インストール・レベル・パッチ・ディレクトリのpatch_jarsサブディレクトリに配置されます。パッチJARファイルの詳細は、「インストール・レベルのパッチ・ディレクトリの構造」を参照してください。

パッチ・プロファイル

特定のOracle製品インストール環境にインストールされており、適用されるパッチをSmart Updateが検証するためのメカニズムとして機能するパッチ・セット。

パッチ・セット

単一のエンティティとしてダウンロードやインストールが可能になった複数のパッチのセット。パッチ・セット内に含まれるメンバー・パッチは、強制的に正しい順序でターゲット・インストール環境に適用されます。ただし、パッチ・セットに含まれるパッチを個別に選択して削除することも可能です。

前提条件が満たされていません

パッチのダウンロード時または適用時に報告される競合。この競合は、他のパッチを先にインストールしておく必要のあるパッチのダウンロード時または適用時に発生します。この競合が報告された場合は、事前に適用する必要があるパッチのIDが表示されます。

プライベート・パッチ

My Oracle Supportが、個別のユーザーのサポート・ニーズに応じて利用可能にするパッチ。プライベート・パッチはSmart Updateでは利用できなくなりました。

公開パッチ

My Oracle Supportが、有効なサポート契約を締結しているユーザーに対して利用可能にしているパッチ。My Oracle Supportから、システムにインストールされている特定のOracle製品に対する公開パッチの詳細情報を表示および入手できます。

サポートID

Oracleに登録したときに取得するユーザー・アカウントのID。

ターゲット・インストール

Smart Updateの「ターゲット・インストール」パネルで現在選択されているOracle製品インストール。

検証

パッチが、ターゲット・インストール環境に適用されている他のパッチと競合するかどうかを判断するプロセス。

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。