Page tree
Skip to end of metadata
Go to start of metadata

The Windows 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 signature file, and so on) as well as filters and whether local copies of the files are created on the target server or downloaded directly during deployment.

Note

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 Windows Catalog tab:

Before you begin

Depending on whether you are creating an online or offline patch catalog, perform the following prerequisites steps to download and use the patch metadata files:

  1. From the Configuration menu, select Patch Global Configuration. The Patch Global Configuration dialog box opens.
  2. Click the Shavlik URL Configuration tab and enter information about the PD5.xml and HF7b.xml configuration files. For more information about the information to be entered under the Shavlik URL Configuration tab, see Parameters on the Shavlik URL Configuration tab.

 If the machine running the Console has internet access, perform the following steps to download the patch metadata files:

  1. From the Configuration menu, select Patch Global Configuration. The Patch Global Configuration dialog box opens.
  2. Click the Shavlik URL Configuration tab and enter information about the PD5.xml and HF7b.xml configuration files. For more information about the information to be entered under the Shavlik URL Configuration tab, see Parameters on the Shavlik URL Configuration tab.
  3. Click the edit icon and then the download button to download the files from the Shavlik website. The metadata files are stored on the file server in the templates directory.

Alternatively, if your console machine does not have access to the internet, you can use the metadata files generated after executing the offline patch downloader utility. For more information about running the patch downloader utility, see Patch Downloader utility for Microsoft Windows.

Catalog Mode

Select one of two options:

  • Source from Vendor (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.

Repository Options

Enter the following information:

Field

Description

Payload Source Location (NSH Path)

(Offline only) Location of existing metadata and payload files
Metadata files stored in this location are copied to the catalog automatically. Payload files are not copied to the catalog.
Note: Payload files are not required to create the patch catalog.

Repository Location (NSH Path)

NSH path to the location of the patch repository
BMC recommends that this location have ample free space. Repositories typically contain many files, usually totaling gigabytes of data. The repository can be on either a Linux or Windows host computer.

Patch Signature File (hf7b)

(Offline only) Depot location of the signature file, hf7b.xml, originally downloaded from Shavlik Technologies
Note: For the offline mode, you must add the hf7b.xml file to the depot workspace.

For offline mode, the Patch Signature File needs to be added to the Depot after each execution of the offline downloader utility and the Patch Catalog definition needs to be modified to point to the newly added Depot Objects.

Package Info File (pd5)

(Offline only) Depot location of the Information File, either pd5.xml, originally downloaded from Shavlik Technologies
Note: For the offline mode, you must add the pd5.xml file to the depot workspace.

For offline mode, the Package Info File needs to be added to the Depot after each execution of the offline downloader utility and the Patch Catalog definition needs to be modified to point to the newly added Depot Objects.

OEM Catalog File (oemcatalog)

(Offline only) Depot location of the Catalog File, oemcatalog.zip, originally downloaded from Shavlik Technologies
Note: For the offline mode, you must add the oemcatalog.zip file to the depot workspace.

For offline mode, the Catalog File needs to be added to the Depot after each execution of the offline downloader utility and the Patch Catalog definition needs to be modified to point to the newly added Depot Objects.

Note

When specifying a host within an NSH path, you can use either the host name of the IP address (IPv4 or IPv6).

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:
    • mount the device specified in the URL
    • deploy patch payloads directly to the agent
      If you select this 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.

Note

(Only for Windows 2012 targets) Before you enable the Agent mounts source for direct use at deployment (no local copy) option, you need to add the mounted device in the security zone of the target. This can be done by making the following changes to the registry of the target.

  1.  Under HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ZoneMap\EscRanges\, create a key with the name Range1. If key Range1 already exists, create a key with the next available number (for example Range2, Range3, Range4 and so on).
  2. Create the following values under the Range1 key:

    Value NameValue Data
    :Range<mountedDeviceIPAddress>
    file1 hexadecimal

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 populated based on the repository location.
  • If you chose Agent mounts source for direct use at deployment (no local copy), enter the enter the SMB URL. For more information on the URL syntax, see URL syntax for network data transmission.

RBAC Policy

Browse to and select a predefined ACL Policy. Permissions defined by the ACL Policy are assigned to all Depot Objects created in the catalog.

Download from Vendor

(Online Only) To download the payload (executables) at the same time as the metadata, select the Download from Vendor 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. You define a combination of product and language (such as Microsoft Windows 2008 — English). There is no limit on the number of filters you can create but you must have at least one. Only those hotfixes and bulletins that match the combinations you define are added to the catalog.

If you are working in Offline Mode, the product/language combinations you define must match those defined in the configuration file used by the download utility.

You can define filters during catalog creation or later, when editing the catalog. Click Add Filter and enter the following:

Field

Description

Product

Select a product from the list provided.

Language

Select the appropriate language for the product.