Patch catalog - Solaris Catalog


The Solaris Catalog tab determines whether the catalog operates in Online or Offline Mode and defines a number of options.

Defined options include locations (such as location of the source files, the repository, the patchdiag.xref file) as well as filters and whether local copies of the files are created on the target server or downloaded directly during deployment.

Notes

  • Before applying patches, make sure you are applying the correct patches. BMC Server Automation supports undo for patches, but this rolls back the patches without verification of the type of patches. Some types of patches, such as kernel patches, should not be undone.
  • BMC Server Automation can apply patches to global and local zone setups where no lib or var is shared between the global and local zones. BMC Server Automation does not support patching on whole-root and sparse-root zones.
    BL does not stop local zones before applying patches to a global zone. Its recommended to stop local zone before zone patching and users should try doing this using a separate deploy command.
  • After a catalog option update, ensure you update the patch catalog for the catalog option update to take effect.

 

The following sections provide more information about the Solaris Catalog tab:

Catalog Mode

Select one of two options:

  • Source from Oracle (Online Mode): Use this mode if the BMC Server Automation Application Server is installed on a server with Internet access.
  • Source from Disk Repository (Offline Mode): Use this mode in a secured environment where download occurs on a server, with Internet access, outside of the environment.

Oracle Credentials

If you selected Source from Oracle (Online Mode), enter the user name and password used to access the vendor website.

Repository Options

Enter the following information:

Field

Description

Payload Source Location (NSH Path)

(Offline only) Location where existing metadata and payload files are stored.
Note: Payload files are not required to create the patch catalog.

Payload Repository Location (NSH Path)

NSH path of the patch repository 
BMC recommends that this location have ample free space. Repositories typically contain many files, usually totaling gigabytes of data.

Source patchdiag.xref File

(Offline/Oracle Solaris only) (read only) Depot location of the patchdiag.xref file downloaded from the Oracle website
For Fujitsu Solaris, contains the location created by the fj2pdx.pl script. This script is available in the Support Files directory within All-OS-Patch-Downloaders-platform-build.extension.

Metadata Corrections File

(Oracle Solaris Only) Depot location of the file used to correct errors found in the patchdiag.xref file that you added to the patch repository

Single User Mode and Reboot Override File

Depot location of the file used to override single user mode and reboot settings for a particular patch

Depot Object Options

Enter the following information:

Field

Description

Network URL type for payload deployment

  • (Default) Copy to agent at staging: The BMC Server Automation Application Server copies patch payloads to a staging directory on the target server during the Deploy Job staging phase.
  • Agent mounts source for direct use at deployment (no local copy): A Deploy Job instructs the agent on a target server to do the following:
    • Mount the device specified in the URL.
    • Deploy patch payloads directly to the agent.
      Note: If you select the Agent mounts source for direct use at deployment (no local copy) option, the Deploy Job does not copy patch payloads to a staging area on the agent, so the job does not create any local copies of the patches on target servers.

Network URL for Payload Deployment

The value entered here depends on your selection in the Network URL type for payload deployment box.

  • If you chose Copy to agent at staging, do not enter a value here. The value is autopopulated based on the repository location.
  • If you chose Agent mounts source for direct use at deployment (no local copy), enter the NFS-accessible path to the location of the payload.
    Note: The Agent mounts source for direct use at deployment (no local copy) option does not work if the patch requires the server to be rebooted into single user mode. You must override the reboot requirement.

RBAC Policy

Select a predefined ACL policy. Permissions defined by the ACL policy are assigned to all depot objects created in the catalog.

Download patches from Oracle

(Online Mode Only) To download the payload at the same time as the patchdiag.xref file, select the Download patches from Oracle check box.

Tip

You can also download the payload by right-clicking the catalog and selecting Download.

Filters

Filters limit the amount of information brought into the catalog. A filter defines:

  • a specific combination of operating system and architecture
  • a list of Patch IDs
  • a specific or custom Oracle Solaris cluster 

There is no upper limit to the number of filter combinations you can make but there must be at least one. Only clusters and patches that match the combinations you define are added to the catalog.

In Offline Mode, recreate the filters defined in the configuration file used by the download utility.

You can define filters either when the catalog is created or later, when you edit the catalog. Depending on the filter option you selected, provide specific details for the filter such as an operating system-architecture combination, a specific patch identifier, or a cluster name, and then click OK. To begin, click Add Filter and select one of the following options: 

Field

Description

Os-Architecture

Identify a particular operating system and architecture.

Patch IDs

Create a list of specific patch identifiers.

Cluster

Identify a specific Oracle Solaris cluster. If the catalog works in offline mode, you can enter a custom, Oracle Solaris cluster.

Notes

  • If you create an online Oracle Solaris Catalog with filter type as cluster, the download of patches starts automatically and the Download from Vendor check box is disabled.
  • In 2011, Oracle renamed the term 'Solaris Patch Cluster' to 'patchset'.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*