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

     前  次    新しいウィンドウで目次を開く     
ここから内容

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

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

この章の内容は以下のとおりです。

bsu コマンドについて

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

注意 : 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 グラフィカル インタフェースの [環境設定] ダイアログ ボックスで指定されたパッチ ダウンロード ディレクトリがデフォルトで使用される ([環境設定] ダイアログ ボックスでも指定されていない場合、BEA_HOME\utils\bsu\cache_dir が使用される)。
[-verbose]
適用される各パッチに関連する詳細情報をすべて表示する。
-prod_dir=path
パッチが適用される対象インストール (path) を指定する。たとえば、WebLogic Server と Portal の場合は BEA_HOME\wlserver_10.3、Workshop for WebLogic の場合は BEA_HOME\workshop_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 ホーム ディレクトリで変更のあった関連ファイルについて表示するレポートを生成する。
[-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
バージョン情報を表示する。
以下に例を示します。
BEA Smart Update. Version: 3.1.0.0
なし
-view
適用されているパッチまたはパッチ ダウンロード ディレクトリにあるパッチの ID を表示する。
[-profile=profile_name]
profile_name で指定したプロファイルに適用されるパッチの ID を表示する。この引数を指定しない場合、デフォルト パッチ プロファイルがデフォルトで使用される。
表の下にある「注意」を参照。
[-patch_download_dir=path]
path で指定したパッチ ダウンロード ディレクトリにダウンロードされているパッチの ID を表示する。パッチ ダウンロード ディレクトリを指定しない場合、[環境設定] ダイアログ ボックスで指定されたパッチ ダウンロード ディレクトリがデフォルトで使用される ([環境設定] ダイアログ ボックスでも指定されていない場合、BEA_HOME\utils\bsu\cache_dir が使用される)。
-status={applied|downloaded}
表示対象のパッチについて、現在の状態を次のように表示する。
  • applied - 対象インストールに適用されているパッチの ID を表示する。この引数を -profile と共に使用すると、特定のプロファイルに関するメンテナンス スナップショットを作成できる。
  • downloaded - ダウンロード ディレクトリにあるが、まだ適用されていないパッチの ID を表示する。
[-verbose]
表示対象の各パッチに関する詳細情報のセットを完全に表示する。
-prod_dir=path
path で表される場所にある対象インストールに適用されるパッチの ID を表示する。
注意 :
注意 : プロファイルを指定しない場合は、デフォルト プロファイルが使用されます。
注意 : ただし、プロファイルの引数が使用され、無効なプロファイルが指定された場合、そのプロファイルはデフォルトに設定されず、次のエラーが表示されます。
注意 : $ bsu -view -status=applied -prod_dir=C:/10_WLP/wlserver_10.0 -profile=profile3 <
注意 : 指定されたプロファイルが見つかりませんでした。[profile3]

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

この節では、次の bsu コマンドの例を示します。

インストールの例

次のコマンドでは、現在のマシンに設定されているパッチ ダウンロード ディレクトリから IRZ2 というパッチがインストールされます。 

bsu -prod_dir=c:\bea\wlserver_10.0 -patchlist=IRZ2 -verbose -install

このコマンドを実行すると、パッチが正常に適用されたことを示す次の出力が表示されます。 

Checking for conflicts.
No conflict(s) detected

Starting installation of Patch ID: IRZ2
Installing C:\bea\download-dir\IRZ2.jar
Result: Success

パッチの表示の例

次のコマンドでは、パッチ ダウンロード ディレクトリ c:\patchdir にあるパッチのリストが表示されます。 

bsu -status=downloaded -view -prod_dir=C:\bea\wlserver_10.0 -patch_download_dir=C:\patchdir

このコマンドを実行すると、次のような結果が表示されます。 

C:\bea\utils\bsu>bsu -view -status=downloaded -prod_dir=C:\bea\wlserver_10.0 – patch_download_dir=C:\patchdir
ProductName:     WebLogic Platform
ProductVersion:  9.2
Components:      WebLogic Platform/WebLogic Server,WebLogic Platform/Workshop 
		   for WebLogic Platform,WebLogic Platform/WebLogic Portal
BEAHome:         	C:\bea
ProductHome:    	 C:\bea\wlserver_10.0
PatchSystemDir:	  C:\bea\utils\bsu
PatchDir: 		   C:\bea\patch_weblogic920
Profile:      	   Default
DownloadDir:   	  C:\patchdir
JavaHome:        	C:\bea\jrockit90_150_04
JavaVersion:     	1.5.0_04
JavaVendor:    	 	 BEA
Patch Set ID: 	   62KY (CR293511,CR295183,CR294340,CR300742,CR286384,CR296875)
Patch ID:        	7NX7 (CR999999)
Patch ID:        	91T2 (CR275126)
Patch ID:       	 9NGH (CR999999)
Patch ID:        	AF66 (CR293511,CR295183,CR286384,CR296875,CR294340,CR300742)
Patch ID:        	B27Q (CR294340)
Patch ID:       	 EN1T (CR999999)
Patch ID:      	  X8JC (CR300742)
Patch ID:      	  Y85M (CR999999)

パッチの表示の例 (2)

次のコマンドでは、マシンで指定されているパッチ ダウンロード ディレクトリにダウンロードされた、対象インストール用のパッチのセットが表示されます。 

bsu -prod_dir=C:\bea\wlserver_10.0 -status=downloaded -verbose -view

このコマンドを実行すると、次のような結果が表示されます。 

ProductName:       WebLogic Platform
ProductVersion:    9.2
Components:        WebLogic Server/Server,WebLogic Server/Server Examples,AquaLogic Service Bus/Service Bus ServerAquaLogic Service Bus /Data Transformation Tools,AquaLogic Service Bus/Service Bus Examples,WebLogic Portal,Workshop for Weblogic Platform

BEAHome:           C:\bea
ProductHome:       C:\bea\wlserver_10.0
DownloadDir:       C:\bea\download-dir
JavaHome:          C:\bea\jrockit90_150_04
JavaVersion:       1.5.0_04
JavaVendor:        BEA

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:\bea\utils\bsu>bsu -view -status=applied -prod_dir=C:\bea\wlserver_10.0
ProductName:       WebLogic Server
ProductVersion:    10.0
Components:        WebLogic Server/Server,WebLogic Server/Server Examples,WebLogic Server/Server Add-ons,WebLogic Server/Evaluation Database
BEAHome:           C:\bea
ProductHome:       C:\bea\wlserver_10.0
PatchSystemDir:    C:\bea\utils\bsu
PatchDir:          C:\bea\patch_wls1000
Profile:           Default
DownloadDir:       C:\bea\utils\bsu\cache_dir
JavaHome:          c:\bea\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
                   hop Portal Extension,WebLogic Portal/Portal Examples
BEAHome:           C:\bea
ProductHome:       C:\bea\wlserver_10.0
PatchSystemDir:    C:\bea\utils\bsu
PatchDir:          C:\bea\patch_wlp1000
Profile:           Default
DownloadDir:       C:\bea\utils\bsu\cache_dir
Patch ID:          FJTH (CR861234)
C:\bea\utils\bsu>
C:\bea\utils\bsu>bsu -view -status=applied -prod_dir=C:\10_WLP_0
320\workshop_10.0
ProductName:       Workshop for WebLogic Platform
ProductVersion:    10.0
Components:        Workshop for WebLogic Platform/Workshop,Workshop for WebLogic Platform/Workshop Examples
BEAHome:           C:\bea
ProductHome:       C:\bea\workshop_10.0
PatchSystemDir:    C:\bea\utils\bsu
PatchDir:          C:\bea\patch_wlw1000
Profile:           Default
DownloadDir:       C:\bea\utils\bsu\cache_dir
Patch ID:          8K9T (CR873456)

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

次のコマンドは、パッチ ID の最初の文字は「6」である BEA Home へ適用したパッチのレポートを生成します。 

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.  Intende 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

  ページの先頭       前  次