IBM Support

What does MANUAL_BES_CACHING_REQUIRED mean?

Technote (troubleshooting)


Problem(Abstract)

This indicates that the Fixlet Message you have deployed had a patch that needed special attention when running and needs to be downloaded manually or had special conditions. The first thing to do to find out what the special conditions are is to check the Fixlet Message for NOTES: or special instructions on what to do.

Resolving the problem

This message is seen when viewing the Download Status Report, through the Tivoli Endpoint Manager - TEM Administration tool or through a web browser directly in the Failed section or In Process section. (NOTE: The default address for accessing the Download Status report directly in the browser is: http://127.0.0.1:52311/cgi-bin/bfenterprise/besmirrorrequest.exe)

Action: 967 waiting for retry Wed, 17 Sep 2008 16:24:02 -0700
url 1: http://www.sun.com/MANUAL_BES_CACHING_REQUIRED/jre-6u7-windows-i586-p.exe



For example, generally the JAVA patches have special conditions that you need to download the Java RunTime executable and agree to their EULA terms. After downloading the file, the file needs to be:

  1. Downloaded to the TEM server.
  2. The file needs to be renamed to the sha1 value outlined in the Fixlet Message.
  3. This file needs to be copied to the sha1 directory on the TEM server usually here:
    C:\Program Files\BigFix Enterprise\BES Server\wwwrootbes\bfmirror\downloads\sha1 ...
Common issues where manual caching is involved:
  • When downloading the file from the SUN (Oracle) website, the file chosen for download is not the correct file. Be sure to select the right patch file and the file should be about the size specified in the Fixlet Message.
  • When renaming the file, the file name must be the correct SHA1 value. To avoid complications with this we have made a SHA1 checking tool available in our Fixlet Authoring section of the Support site, Please click on the URL Sha1.exe located at, in the Related information section below to download. Be certain that when the file is renamed that is corresponds exactly with the SHA1 value stated in the Fixlet and that the value in that you get from the SHA1 checking tool is also exactly the same as what the Fixlet has scripted.

    • You can view a list of all of the fixlets that need manual caching using two different ways:

      The simplest way is to create a custom filter:
      • In the all-content view, ctrl-f to create a custom filter.  Use action contains MANUAL_BES_CACHING_REQUIRED and visibility equals visible

      This can also be done via the presentation debugger:
      • Enable the DEBUG menu in the BigFix console: http://www-01.ibm.com/support/docview.wss?uid=swg21506082
      • Run the "Presentation Debugger" from the debug menu you just enabled.
      • Run the following query in the debugger:
          (id of it, name of it, name of site of it) of bes fixlets whose ((fixlet flag of it or task flag of it) AND concatenation of scripts of actions of it contains "MANUAL_BES_CACHING_REQUIRED") 

Related information

Sha1.exe located at

Historical Number

500

Document information

More support for: IBM BigFix family

Software version: Version Independent

Operating system(s): Platform Independent

Reference #: 1506080

Modified date: 01 November 2011


Translate this page: