ヘッダーをスキップ
Oracle Smart Update Oracle WebLogic Serverへのパッチの適用
リリース3.3.0
B61614-03
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次
前
前 		 次
次		  

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

この項では、Smart Update bsuコマンドについて説明します。これはパッチ・ダウンロード・ディレクトリにダウンロードされているパッチを適用するコマンドであり、対話形式またはスクリプトで使用できます。bsuコマンドをスクリプトで使用すると、複数のシステムにインストールされている製品に対して特定のメンテナンス・レベルを複製するためのメカニズムを構築できます。本番環境では、複数のシステムに対するソフトウェア更新の配布作業を、管理された方法で、信頼性と再現性を確保しつつ実施する必要があるため、この機能が特に役立ちます。

以下の内容について説明します。

bsuコマンドについて

bsuコマンドを対話形式またはスクリプトで使用する際の注意事項を次に示します。

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コマンドの例を示します。

インストールの例

次のコマンドでは、現在のシステムに設定されているパッチ・ダウンロード・ディレクトリから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
  前
前 		 次
次
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次