この項では、Smart Update 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
コマンドの構文について説明します。パラメータ引数が大カッコ付きで示されている場合、その引数はオプションです。
表8-1で、bsu
コマンドのパラメータおよび引数について説明します。
表8-1 bsuコマンドのパラメータおよび引数
パラメータ | 説明 | 引数 |
---|---|---|
|
|
なし。 |
|
ターゲット・インストールに特定のパッチを適用します。有効なプロファイル名を指定する必要があります。 |
[-patchlist=patch1[,patch2,patch3] 適用される各パッチのID( [-profile=profile_name]は、パッチが適用されるパッチ・プロファイル(profile_name)を指定します。表の最後にある注意を参照してください。[-patch_download_dir=path]は、パッチの適用元となるパッチ・ダウンロード・ディレクトリをpathで指定します。パッチ・ダウンロード・ディレクトリを指定しない場合、Smart Updateグラフィカル・インタフェースの「プリファレンス」ダイアログ・ボックスで指定されたパッチ・ダウンロード・ディレクトリがデフォルトで使用される(「プリファレンス」ダイアログ・ボックスでも指定されていない場合は、 |
|
Smart Updateグラフィカル・インタフェースを起動します。 |
なし。 |
|
対応する 注意: |
=path 作成されるログ・ファイルのファイル名と場所( [-log_priority= {trace|debug|info|warn|error|fatal}] 取り込むログ情報の優先度を指定します。デフォルトの優先度は |
|
指定したパッチをプロファイルから削除します。 |
[-patchlist=patch1[,patch2,patch3] 適用される各パッチのID(patch1、patch2、patch3)を指定します。[-profile=profile_name]は、パッチが削除されるパッチ・プロファイル(profile_name)を指定します。表の最後にある注意を参照してください。[-prod_dir=path]は、パッチが削除されるターゲット・インストール(path)を指定します。[-verbose]は、適用される各パッチに関連する詳細情報をすべて表示します。 |
|
適用されたパッチおよびミドルウェア・ホーム・ディレクトリで変更のあった関連ファイルについて表示するレポートを生成します。 |
-BEA_HOME=path パッチが適用されるターゲット・インストール( 注意: 複数の引数を指定するには、正規表現を使用します。たとえば、 |
|
バージョン情報を表示します。 例: Oracle Smart Update. Version: 3.3.3.0 |
なし。 |
|
適用されているパッチまたはパッチ・ダウンロード・ディレクトリにあるパッチのIDを表示します |
[-profile=profile_name] profile_nameで指定したプロファイルに適用されるパッチのIDを表示します。この引数を指定しない場合、デフォルト・パッチ・プロファイルがデフォルトで使用されます。 表の最後にある注意を参照してください。[-patch_download_dir=path]は、pathで指定したパッチ・ダウンロード・ディレクトリにダウンロードされているパッチのIDを表示します。パッチ・ダウンロード・ディレクトリを指定しない場合、「プリファレンス」ダイアログ・ボックスで指定されたパッチ・ダウンロード・ディレクトリがデフォルトで使用される(「プリファレンス」ダイアログ・ボックスでも指定されていない場合は、 [-verbose]は、表示対象の各パッチに関連する詳細情報をすべて表示します。-prod_dir=path pathで表される場所にあるターゲット・インストールに適用されるパッチのIDを表示します。 |
注意: 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)
次のコマンドでは、システムで指定されているパッチ・ダウンロード・ディレクトリにダウンロードされた、ターゲット・インストール用のパッチのセットが表示されます。
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