IBM Support

How do I manually cache a file on the BigFix Server?

Technote (troubleshooting)


Problem(Abstract)

Instructions for manually caching files on the BigFix Server.
Occasionally you might have a need to manually store files on your BigFix Server rather than having them downloaded from the Internet.
For example, if a file is already downloaded from the Internet and you wish to not have it re-downloaded, or if you are providing a file that is internal to your company and does not reside on the Internet.
Many of the Java Fixlets also require you to authenticate and download the particular Java update appropriate for your platform and operating system, so these will typically need to be manually placed into the cache of the BigFix Server.

Resolving the problem

Caching files on the BigFix Server is a simple process:

  1. Obtain the file you wish to cache on the BigFix Server.
  2. Calculate the sha1 checksum of the file.*
  3. Rename the file to its sha1 checksum value. (Remove file extension if it exists)
  4. Place the renamed file in the BigFix Server download cache folder.**

Once the file is cached on the BigFix Server, any action deployed that checks for the same sha1 will use the file in the cache instead of downloading it from the Internet.

For more details on how the BigFix Server/Relay caches work, see: http://www-01.ibm.com/support/docview.wss?uid=swg21505905

*You can calculate the sha1 checksum of a file by using the sha1.exe tool available here: https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?lang=en#/wiki/Tivoli%20Endpoint%20Manager/page/SHA1%20Tool

***Alternately, there is an newer, open-sourced version of the tool which can handle higher size limits and files greater that 4Gb. It can handle SHA-256 or SHA1. The tool is located here: https://github.com/bigfix/make-prefetch

**To find out where your BigFix Server cache folder is located, check the registry value "DownloadContentLocation" under the key "HKEY_LOCAL_MACHINE\SOFTWARE\BigFix\Enterprise Server\GatherService". The cache folder is the "sha1" folder under this folder. (By default and can NOT be changed: "C:\Program Files\BigFix Enterprise\BES Server\wwwrootbes\bfmirror\downloads\sha1")

Note: For 64bit systems check the registry value "DownloadMirror URL" at
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\BigFix\Enterprise Server\GatherService
If your BigFix server is running on a 64 bit machine, the cache folder is located under C:\Program Files (x86)BigFix Enterprise\BESServer\wwwrootbes\bfmirror\downloads\sha1

Historical Number

390

Document information

More support for: IBM BigFix family

Software version: Version Independent

Operating system(s): Platform Independent

Reference #: 1506037

Modified date: 15 June 2012


Translate this page: