BigFix Technical Search

Search BigFix

 
Search Areas
BigFix Support Website Knowledge Base
User Forums Main BigFix Website

Looking for info on the BigFix Relevance Language? Try the Inspector Search Engine.

Summary:

How do I manually run the download cacher tool for Red Hat Enterprise Linux?

Solution:

The download cacher tool for Red Hat Enterprise Linux is a Perl executable designed to automatically download and cache Red Hat RPM packages to facilitate deployment of Red Hat Enterprise Linux Fixlet messages.

The tool can be downloaded from the BES Support website here.

To run this tool, you may wish to create a batch file with the following parameters. If you run the tool without specifying any parameters, you will be prompted to enter the parameters at the command line.

Sample.bat

RHEDownloadCacher.exe redhat_user redhat_password cache C:\logs yes RHSA-2004:609 3 PROXY http://www.proxyserver.com:8080 proxy_user proxy_password x86 x86_64

Usage -
RHEDownloadCacher.exe RHNUsername RHNPassword DirectoryPath/cache [Logfile Directory] [Increase Cache] [Bulletin Number(s)] [Red Hat OS Version(s)] [PROXY] [Proxy URL] [Proxy Username] [Proxy Password][Architectures]

Required Parameters:

RHNUsername

Your Red Hat Network Username (used to log into https://rhn.redhat.com)

RHNPassword

Your Red Hat Network Password (used to log into https://rhn.redhat.com)

DirectoryPath/cache

The full path to the folder where downloaded files should be saved. The keyword 'cache' indicates that files should be downloaded to the BES Server cache and should only be used when RHEDownloadCacher.exe is run on a BES Server machine.

Architectures

x86 and/or x86_64 defines which architecture of fixlets to cache. x86 includes all content relating to i386, i586 and i686. x86_64 includes all 64 bit architectures.

Optional Parameters:

[Logfile Directory]

Full path to the folder where you would like to create the log file. By default, the logfile is placed in the BES Client Logs directory (ex: C:\Program Files\BigFix Enterprise\BES Client\__BESData\__Global\Logs)

[Increase Cache]

This option is only available if the specified Directory Path is the keyword 'cache'. Enter 'yes' to increase the BES Server cache automatically in the event that the size of the files being downloaded exceeds the current amount of free space in the cache. Enter 'no' or leave blank to be prompted to manually increase the cache.

[Bulletin Number(s)]

Specify Red Hat Errata. Separate each Errata Number with a space (ex: RHSA-2004:609 RHBA-2005:104 RHBA-2005:109). Use this option when you wish to download files for specific errata. If you do not specify this parameter, the tool will cache all files for all published Fixlet messages in the Red Hat Enterprise Linux Fixlet site.

[Red Hat OS Version(s)]

BigFix currently supports Red Hat Enterprise Linux 3.0 and 4.0. Enter a space-delimited list (e.g. "3", "3 4") to indicate the version(s) for which you would like to download files. If you do not specify this parameter, the tool will cache downloads for all versions.

[PROXY] [Proxy URL] [Proxy Username] [Proxy Password]

PROXY is a keyword used to indicate that downloads must go through a proxy server. If your network requires a proxy server for Internet access, you must specify this keyword and provide required parameters.

[Red Hat OS Type(s)]
BigFix currently supports types AS, ES, and WS for Redhat Enterprise Linux 3.0 and 4.0, and types SERVER and DESKTOP for Redhat Enterprise Linux 5.0. Enter a space-delimited list (e.g. "AS DESKTOP SERVER") to indicate the OS type(s) for which you would like to download files. If you do not specify this parameter, the tool will cache downloads for all versions.

Proxy URL is the URL of your proxy server. This is usually the ip address or dns name of your proxy server, and its port, separated by a colon (ex: http://192.168.100.10:8080).

If your proxy server requires authentication, you must specify your Proxy Username and Proxy Password. Your Proxy Username is usually in the form of domain\username.

  • --no-rename: Use this option if you wish to download RedHat patch files, but not rename them to their respective sha1 checksum values.
  • --email [Internal SMTP Server] [login] [password] [sender@email.com][receiver1@email.com;receiver2@email.com]: Use this option to send a notification email containing a summary of the execution of the download cacher.
    • [Internal SMTP Server]: specify which email server you would like to use to send the notification
    • [login]: username for the email server, or "none" if no login is required
    • [password]: password for the email server, or "none" if no password is required
    • [sender@email.com]: the summary will be sent from this address
    • [receiver1@email.com;receiver2@email.com;...]: specify as many recipients as are necessary, separated by semicolons
  • --rpm-names [RPM filenames]: Use this option if you wish to specify the files you wish to download
    • [RPM filenames]: specify the full filename of the package(s) you wish to download, separated by a space. (e.g. "psstack-1.2-3.EL.2.i386.rpm firefox-1.5-3.x86_64.rpm").

Sample Usage:
RHEDownloadCacher.exe redhat_user redhat_password cache C:\logs yes RHSA-2004:609 3 AS WS x86 x86_64 --email mailer.email.com none none sender@email.com receiver@email.com

RHEDownloadCacher.exe --rpm-names redhat_user redhat_password cache C:\logs psstack-1.2.3.EL.2.i386.rpm firefox-1.5-3.x86_64.rpm

Please Note: If you are using a proxy server, but are not using authentication, you must still provide parameters for "Proxy Username" and "Proxy Password".
For example:

RHEDownloadCacher.exe redhat_user redhat_password cache C:\logs yes RHSA-2004:609 3 PROXY http://www.proxyserver.com:8080 dummy_user dummy_password x86 x86_64

Knowledge Base ID:

267

Version Information:  

Creation Date:

17 Mar 2005 10:40:49

Last Modified Date:

1 Jul 2009 02:20:44