Steps to manually run the download cacher tool for Red Hat Enterprise Linux

Technote (troubleshooting)


Problem(Abstract)

The Download Cacher for Red Hat is a command line tool designed to automatically download and cache Red Hat rpm patches to facilitate deployment of Red Hat Fixlet messages.

Resolving the problem

The TEM Download Cacher for Red Hat is a command line tool designed to automatically download and cache Redhat rpm patches to facilitate deployment of Red Hat Fixlet messages. The latest Red Hat Download Cacher is available here.

Command Line Usage

Synopsis

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

To run in interactive mode:
RHELDownloadCacher.exe

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

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

To run using a repository of Red Hat patches:
RHELDownloadCacher.exe --repobuilder (see repository options below)

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 30x86,40x86_64,50x86_64,60x86. 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 /RHSA-.*/. Default is all.
--rpms RPM1,RPM2,...
Comma separated list of RPM names (case sensitive). Default is all.
--downloads FILE
Explicitly specify pairs of RPMs and SHA1s in a file. Each pair is on its own line, and the RPM and SHA1 should be separated by a space. If given, the cacher will parse this file for RPMs instead of parsing a site.
--superseded
Specify to grab superseded content (only).
--username USER
RHN username
--password PASS
RHN password
--cacheDirectory DIR
The directory to which to cache. Uses TEM cache if undefined.
--noRename
Do not rename files to sha1 or sha256 values
--sha1
Rename files to sha1 values. On by default. Ignored if specified with --noRename or --sha256.
--sha256
Rename files to sha256 values. On by default. 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 Redhat 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
username=john_doe
password=p@ssw0rd
--------------------------------------
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 Red Hat OS versions, such as 30x86,40x86_64,50x86_64,60x86. Default is all..
--osType type1, type2,...
OS type for patches. Accepted values: AS, ES, WS, Desktop, Server, Client, Workstation. Default is all.
--username USER
RHN username.
--password PASS
RHN password.
--dir DIR
The parent directory to store the files. Subfolders will be created for OS (e.g. “RHEL5”) and support files (“RHEL_SUPPORT_FILES”).
--noRename
Do not rename files to sha1 or sha256 values. On by default.
--sha1 
Rename files to sha1 values. 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 either --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 RHEL sites will be downloaded..
--supportFileType
Type of support file from the Patches for RHEL 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]
os=5
dir=C:\repo
username=john_doe
password=p@ssw0rd
--------------------------------------
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:\repo
; 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.

Historical Number

267

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Endpoint Manager

Software version:

Version Independent

Operating system(s):

Platform Independent

Software edition:

All Editions

Reference #:

1505968

Modified date:

2014-08-18

Translate my page

Machine Translation

Content navigation