Skip navigation.
Downloads | Product Documentation | Support

Installing Maintenance Updates and Service Packs

# 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
- bsu Command Reference
- Command-Line Interface Examples

# About Using the bsu Command

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

- Runs the `bsu` script (`bsu.cmd` on Windows systems, `bsu.sh` on UNIX systems) that is located in the `BEA_HOME``\utils\bsu` directory. When running the `bsu` command, first change to this directory on the machine from which you are running it.
- Can be executed from a command file (on Windows) or shell script (on UNIX).
- Contains the subset of Smart Update functionality that allows you to:

- Apply patches that are located in an accessible patch download directory
- View patches that are in the download directory, applied to a product installation on the current machine, or applied to a specific patch profile for the current machine

The `bsu` command can also invoke the Smart Update graphical interface and send messages to a log file.

- Can apply patches to, or view patches on, only those BEA products installed from the machine on which this command is run, as follows:

- If the current machine contains a BEA product that was installed by a different machine, you cannot apply patches to that installation or view them.
- If the current machine was used to install a BEA product located on a remote-mounted disk drive, you can use the `bsu` command with that installation.

Therefore, the restrictions regarding the specific BEA product installations that can be maintained via the `bsu` command is the same as for Smart Update's graphical interface.

- Cannot be used for the following:

- Logging in to BEA Customer Support
- Removing patches applied to a target installation
- Creating custom patch profiles
- Locating start scripts to modify.

These capabilities are available only from Smart Update's graphical interface.

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
- View Patches Example
- Another View Patches Example
- Display Maintenance Snapshot

#### 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