In the configuration file, you provide information that is used by the Patch Downloader utility.
This information includes definition of a proxy server (if one is used), identification of a local, temporary directory on the server that is used by the Patch Downloader utility during download, and filter definitions which determine the metadata and payload that is downloaded from the Shavlik Technologies website.
Ensure that the editor you are using to edit the XML file supports UTF-8 encoding. The downloaded utility expects a configuration file with UTF-8 encoding. If the file uses a different encoding method, the application may fail with parsing errors.
If you are using a proxy server, use the following command to encrypt the password supplied to the proxy server by the Patch Downloader utility. You must specify the resulting encrypted password in the
<password></password> parameter in the configuration XML file.
If you are running the downloader on Microsoft Windows:
If you are running the downloader on UNIX:
To obtain more information about the proper syntax and the filters for downloader commands, use the following options:
If you are using a proxy server, perform the following actions:
If you are not using a proxy server and decide to delete the contents of the
proxy-settings section, do not delete the
</proxy-settings> opening and closing tags. This section is required in the XML file even if you are not using a proxy server.
Remove the comment indication within the
proxy-settings section. That is, remove the
<!-- characters that appear before the
Add proxy information using the following XML tags:
The protocol for which to assign the proxy configuration. Valid values are:
The port used for communication with the proxy server.
The proxy server's host name or IP address.
The user name required for authentication to communicate with the proxy server.
An encrypted password for the specified user.
The proxy server domain name to be used for authentication.
The type of proxy server. Valid values are:
Define download settings using the following XML tags.
Location where files can be stored temporarily during the download process (for example: C:\tmp)
Indicates whether the download utility checks the certificate of the patch payload before download
Local location of the patch repository where metadata and payload are stored. The following files are stored in this location:
The Patch Signature File and the Package Info File needs to be added to the Depot after each execution of the offline downloader utility. You must update the Patch Catalog definition to point to the newly added Depot Objects. For more information see, Creating a patch catalog in offline mode.
Number of times the download utility attempts to download if the first attempt at downloading a payload fails.
Number of milliseconds that the utility waits for a response before considering the attempt as failed
Number of downloads that can be performed in parallel.
In the <subscription> tag, specify filters for limiting the patches that are included in the download.
The same filters entered here must also be entered during catalog creation.
For example, to create a filter that defines product category and language, use the following syntax:
Save the file.
The sample-windows-downloader-config.xml file is shown below and includes sample data:
Use the command in Downloading patches using defined filters for Microsoft Windows and pass the configuration file as a parameter to download the patches.