Skip navigation.

Installing Maintenance Updates and Service Packs

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF   Get Adobe Reader

Using the Command-Line Interface

This section describes the Smart Update bsu command, which you can use to apply patches, interactively or via script, that have been downloaded into a patch download directory. When you use bsu commands in a script, you can create a mechanism for replicating a specific maintenance level of a BEA product that is installed on multiple machines. This capability is especially valuable in production environments, in which the distribution of software updates to machines must be implemented in a controlled, reliable, and reproducible manner.

The following topics are included:

 


About Using the bsu Command

When using the bsu command, either interactively or via a script, note that this command:

Note: If you run the Smart Update command-line interface simultaneously with the graphical interface, changes you make to patch profiles via the command-line interface are not visible from the graphical interface when you refresh the view of those patch profiles.

 


bsu Command Reference

This section describes the bsu command syntax. Square brackets appearing with a parameter argument indicate that the argument is optional.

A summary of the bsu command syntax is provided at the following URL as a downloadable PDF file that is optimized for printing. To download this summary:

    1. Click the following URL, or enter it into a browser:

http://e-docs.bea.com/common/docs91/smart_update/pdf/aid-bsu.pdf

    2. In the popup window that is displayed, choose File—> Print to print the summary, or File—> Save As... to save it.


 

The bsu command has the parameters and arguments listed and described in Table 8-1.

Table 8-1 bsu Command Parameters and Arguments 

Parameter

Description

Arguments

-help

Displays a summary of bsu parameters and arguments

None

-view

Displays the identifiers of patches that are either applied or in the patch download directory.

If the download directory does not contain any patches, the tool displays the following message:

No patches exist in the specified download directory.


[-profile=profile_name]

Displays identifiers of patches applies to the profile represented as profile_name. If you do not specify this argument, the default patch profile is used by default.

[-patch_download_dir=path]

Displays the identifiers of patches that have been downloaded into the patch download directory represented as path. If you do not specify a patch download directory, the patch download directory designated in the Preference dialog box is used by default. (If none is designated in the Preference dialog box, BEA_HOME\utils\bsu\cache_dir is used.)

-status={applied|downloaded}

Displays the current status of the patches viewed, as follows:

  • applied—displays identifiers of patches that have been applied to the target installation. Use this argument, with -profile, to create a maintenance snapshot for the specific profile.

  • downloaded—displays identifiers of patches in the download directory but not yet applied.

[-verbose]

Displays the full set of details associated with each patch displayed.

-prod_dir=path

Displays the identifiers of patches applied to the target installation in the location represented as path.

-install

Applies specified patches to the target installation. If no patch profile is specified, the patches are applied to the default patch profile for the installation.

If the download directory does not contain any patches, the tool displays the following message:

No patches exist in the specified download directory.


-patchlist=patch1[,patch2,patch3 . . . ]

Specifies the identifier of each patch to be applied, represented as patch1, patch2, and patch3.

[-profile=profile_name]

Specifies the patch profile to which the patches are to be applied, represented as profile_name.

[-patch_download_dir=path]

Specifies the patch download directory from which the patches are to be applied, represented as path. If you do not specify a patch download directory, the patch download directory designated in the Preference dialog box in the Smart Update graphical interface is used by default. (If none is designated in the Preference dialog box, BEA_HOME\utils\bsu\cache_dir is used.)

[-verbose]

Displays the full set of details associated with each patch applied.

-prod_dir=path

Specifies the target installation to which the patches are to be applied, represented as path.

-gui

Starts the Smart Update graphical interface.


-log

Creates a file, in the specified location, in which the corresponding bsu command logging information is to be sent.

Note: The -log parameter logs only bsu command activity, and not activity related to patches or profiles.

=path

Specifies the file name and location of the log file to be created, represented as path.

[-log_priority=
{trace|debug|info|warn|error|fatal}]

Specifies the priority of log information to be captured. The default priority is debug.


 

 


Command-Line Interface Examples

This section includes the following bsu command examples:

Installation Example

The following command installs the patch IRZ2 from the patch download directory that has been established for the current machine:

bsu -prod_dir=c:\bea\weblogic91 -patchlist=IRZ2 -verbose -install

When executed, the preceding command displays the following output showing that the patch was successfully applied:

Checking for conflicts.
No conflict(s) detected

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

View Patches Example

The following command displays a list of patches that exist in the patch download directory, c:\patchdir:

bsu -prod_dir=c:\bea\weblogic91 -patch_download_dir=c:\patchdir
-status=downloaded -view

When executed, the preceding command generates a display similar to the following:

ProductName:    WebLogic Platform
Version: 9.1
Components: WebLogic Server/Server, WebLogic Server/Server Examples,
AquaLogic Service Bus/Service Bus Server, AquaLogic Service
Bus/Data Transformation Tools, AquaLogic Service Bus/Service
Bus Examples,
BEAHome: c:\beahome
ProductHome: c:\beahome\weblogic91
JavaHome: c:\beahome\jrockit90_150_04
JavaVersion: 1.5.0
JavaVendor: BEA

PatchID: patch20_weblogic910
PatchID: patch537_weblogic910
PatchID: patch2004_weblogic910

Another View Patches Example

The following command displays the set of patches for a target installation that have been downloaded to the machine's designated patch download directory:

bsu -prod_dir=c:\bea\weblogic91 -status=downloaded -verbose -view

When executed, the preceding command generates a display similar to the following:

ProductName:       WebLogic Platform
ProductVersion: 9.1
Components: WebLogic Server/Server, WebLogic Server/Server Examples, Aqu
aLogic Service Bus/Service Bus Server, AquaLogic Service Bus
/Data Transformation Tools, AquaLogic Service Bus/Service Bu
s Examples

BEAHome: C:\bea
ProductHome: C:\bea\weblogic91
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

Display Maintenance Snapshot

The following command displays a maintenance snapshot of the default patch profile:

bsu -view -profile=default -status=applied -verbose -prod_dir=c:\bea\weblogic91

When executed, the preceding command generates a display similar to the following:

ProductName:       WebLogic Platform
ProductVersion: 9.1
Components: WebLogic Server/Server, WebLogic Server/Server Examples,
AquaLogic Service Bus/Service Bus Server, AquaLogic
Service Bus/Data Transformation Tools, AquaLogic Service
Bus/Service Bus Examples
BEAHome: C:\bea
ProductHome: C:\bea\weblogic91
DownloadDir: C:\bea\patch-download-dir
JavaHome: C:\bea\jrockit90_150_04
JavaVersion: 1.5.0_04
JavaVendor: BEA

Patch ID: QDXN
PatchContainer: QDXN.jar
Checksum: -1137516737
Component: AquaLogic Service Bus
Severity: optional
Category: General
CR:
Restart: false
Description: ext classpath

Patch ID: 4N1M
PatchContainer: 4N1M.jar
Checksum: 979379797
Component: WebLogic Server
Severity: optional
Category: Plugin
CR:
Restart: false
Description: classpath (myWLServer.jar) 3

 

Skip navigation bar  Back to Top Previous Next