IBM Support

Solaris Download Cacher Tool

Technote (FAQ)


How do I manually run the download cacher tool for Solaris?


The BigFix Download Cacher for Solaris is a command line tool designed to automatically download and cache Solaris patch .jar packages to facilitate deployment of Solaris Fixlet messages. The latest Solaris Download Cacher is available here.

Note: The preferred method of Solaris patch caching is to register a Solaris Download Plug-in (see Task ID: 20 in the Patches for Solaris site).

Command Line Usage


This tool is used to download and cache files in the sha1 cache or other directory.

To run in interactive mode:

To run using a configuration file:
SolarisDownloadCacher.exe --configFile FILE

To run using command line options:
SolarisDownloadCacher.exe [OPTIONS]


--os OS1,OS2,...
Comma separated list of OS names, such as 9,10,10x86. Default is all.
--patches ptch1,ptch2,... 
Comma separated list of patch IDs in the format of "123456-78". Default is all.
--downloads FILE
Explicitly specify pairs of patch files (in the format of "123456-78.jar" or "") and SHA1s in a file. Each pair is on it's own line, and the patches and SHA1 should be separated by a space. If given, the cacher will parse this file for patchIDs instead of parsing a site.
Gathers the cluster for specified operating systems, if designated, or all of them if no operating systems are specified.
Specify to grab superseded content (only)
Gathers from the Solaris Maintenance site
--username USER
Sun username
--password PASS
Sun password
--cacheDirectory DIR
The directory to cache to. Uses BigFix cache if undefined.
Do not rename files to sha1 values.
--emailServer SERVER
The SMTP server to use
--emailUser USER
The email login to use
--emailPassword PASS
The email password to use
--emailSender ADDR
The email sender address. Required if emailServer is given.
--emailTo ADDR1,ADDR2,... 
A comma separated list of email addresses. Required if emailServer is given.
The proxy server to use
--proxyUser USER
The proxy username to use
--proxyPassword PASS
The proxy password to use
Force the cacher to re-download files, even if they already exist.
Auto increase the cache in the event that the BES cache is filled. Only applies if --cacheDirectory is not specified.
--sites EFXMFILE
Specifies the masthead file. Multiple masthead files may be listed, separated by commas. If given, specified sites will be parsed rather than default Suse fixlet sites.
--configFile FILE
Specifies a cacher config file that may contain any of the previous options in the [Options] section. For example:

Command line options take precedence if 
the same option is passed in the command
line and the config file.

Additionally, the config file used for 
Download Plug-ins (plugin.ini) is compatible 
here.  The [UA] and [Logger] sections from 
plugin.ini may be included in the cacher 
config file.  For example:


; The following snippet taken from a plugin.ini
--logfile FILE
Directs logging to the specified file (as well as STDOUT)
--debug LEVEL
Specifies a debug level (0-5) to determine the verbosity of the output. Default is 0.
Print the help message

Historical Number


Document information

More support for: IBM BigFix family

Software version: 9.0, 9.1, 9.5

Operating system(s): Platform Independent

Reference #: 1506020

Modified date: 08 March 2017