CentOS download cacher usage information

Use the CentOS download cacher to download and cache CentOS patches in air-gapped environments. This tool supports the Patches for CentOS 6 Native Tools and Patches for CentOS 7 sites.

You can run the CentOS download cacher on a Windows system. For information about requirements, see BigFix - System Requirements.

The latest CentOS download cacher is available from the BigFix Support site: http://software.bigfix.com/download/bes/util/CentOSDownloadCacher.exe

Note: For illustration purposes, this section indicates the steps to run the CentOS download cacher in Windows. However, the parameters and subcommands to run the CentOS download cacher are the same for both Windows and Linux systems.

You can run the tool CentOSDownloadCacher.exe to perform additional operations. To run this tool from the command prompt, use the following command:

CentOSDownloadCacher.exe [OPTIONS]

To run in interactive mode:CentOSDownloadCacher.exe

CentOSDownloadCacher.exe

To run using a configuration file:

CentOSDownloadCacher.exe --configFile FILE

To run using a repository of CentOS patches:

CentOSDownloadCacher.exe --repobuilder [repository options]

Options:

--repobuilder

Build a repository rather than specifying individual files. For a list of repository builder commands, specify --repobuilder --help. If used with --configFile, this --repobuilder option must be specified in the command line and not inside the file.

--os OS1,OS2,...

Comma separated list of OS names, such as 5x86,6x86_64. Default is all.

--bulletins BUL1,BUL2,...

Comma separated list of bulletins (case sensitive). Bulletins may be specified as perl regexes when enclosed in //. For example, --bulletins /CESA-.*/. Default is all.

--rpms RPM1,RPM2,...

Comma separated list of RPM names (case sensitive). Default is all.

--downloads FILE

Explicitly specify pairs of patch bundles and SHA1s in a file. Each pair is on its own line, and the patch bundle and SHA1 should be separated by a space. If given, the cacher will parse this file for patch bundles instead of parsing a TEM site.

--superseded

Specify to grab superseded content (only).

--cacheDirectory DIR

The directory to cache to. Uses TEM cache if undefined.

--noRename

Do not rename files to sha1 or sha256 values.

--sha1

Rename files to sha1 values. Ignored if specified with either --noRename or --sha256. On by default.

--sha256

Rename files to sha256 values. Ignored if specified with --noRename.

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

--proxy SERVER:PORT

The proxy server to use. Please specify the protocol (http, https). For example,

http://proxyURL:8888

--proxyUser USER

The proxy username to use.

--proxyPassword PASS

The proxy password to use.

--forceDownloads

Force the cacher to re-download files, even if they already exist.

--autoCacheIncrease

Auto increase the cache in the event that the TEM 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 CentOS fixlet sites.

--configFile FILE

Specifies a cacher config file that may contain any of the previous options in the [Options] section. For example:

[Options]
cacheDirectory=C:\cache
os=5x86
bulletins=CEBA-2012:1312

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

Note: if using the option --repobuilder, the --repobuilder option must be specified in the command line (it will be ignored if specified inside the 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:

[Options]
cacheDirectory=C:\cache

; The following snippet taken from a plugin.ini
[UA]
proxy=http://someproxyurl:8080
proxyUser=john_doe
proxyPassword=p@ssw0rd

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

--help

Print the help message.

Repository Options:

--os OS1,OS2,...

Comma separated list of OS names, such as 5x86,6x86_64. Default is all.

--repoSource SOURCE

The CentOS repository to use. Accepted values:

‘mirror’ for mirror.centos.org
‘vault’ for vault.centos.org
‘all’ for all repositories

--dir DIR

The parent directory to store the files. A subfolder titled "CENTOS_Repository" will be created.

--noRename

Do not rename files to sha1 or sha256 values. On by default.

--sha1

Renames files to sha1 value. Ignored if specified with either --noRename or --sha256. Files will be saved in a directory titled "SHA1_FILENAMES" under the OS or support file subdirectory specified by --dir.

--sha256

Rename files to sha256 values. Ignored if specified with --noRename. Files will be saved in a directory titled "SHA256_FILENAMES" under the OS or support file subdirectory specified by --dir.

--renameSHA

For files that already exist as sha1 or sha256 values, it will rename those files to its original name. Will be ignored if specified with either --noRename, --sha1, or --sha256.

--rpmOnly

Download RPM files only. No support files from the Patches for CentOS sites will be downloaded.

--supportFileOnly

Download support files only. No RPM files will be downloaded. Will be ignored if specified with --rpmOnly.

--supportFileType

Type of support file from the Patches for CentOS sites to be downloaded. Accepted values: EDR, NativeTools. Default is all. Will be ignored if specified with --rpmOnly.

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

--proxy SERVER:PORT

The proxy server to use. Please specify the protocol (http, https). For example,

http://proxyURL:8888

--proxyUser USER

The proxy username to use.

--proxyPassword PASS

The proxy password to use.

--forceDownloads

Force the cacher to re-download files, even if they already exist.

--configFile FILE

Specifies a cacher config file that may contain any of the previous options in the [Options] section. For example:

[Options]
cacheDirectory=C:\cache
os=5x86
bulletins=CEBA-2012:1312

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:

[Options]
cacheDirectory=C:\cache

; The following snippet taken from a plugin.ini
[UA]
proxy=http://someproxyurl:8080
proxyUser=john_doe
proxyPassword=p@ssw0rd

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

--help

Print the help message.