Using the Solaris download cacher

Use the Solaris download cacher utility to pre-cache Solaris updates to the specified BigFix server or to a specified target directory before deploying the Fixlets to targeted endpoints.

For more information about the download cacher, see Solaris download cacher tool overview.

Running the download cacher tool manually

For air-gapped environments, you can run the Solaris download cacher utility manually.

Download the Solaris download cacher tool from the BigFix software website at https://software.bigfix.com/download/bes/util/SolarisDownloadCacher.exe.

Note: Solaris Download cacher (Solaris 11) does not support caching files for Patches.

Note: Running the executable opens a browser window for Oracle Multi-Factor Authentication (MFA). You must enter your Oracle username, password, and the second-factor (2FA) verification code in this window before the download can proceed.

To run using command line options:

SolarisDownloadCacher.exe <OPTIONS>

Parameters:

--os OS1,OS2,...

Specifies a comma separated list of operating system names, such as 10 and 11. Default is all.

--loglevel

Specifies the log level. You can choose among DEBUG', 'INFO', 'WARNING', or 'ERROR'. By default, the value is set to 'INFO'.

INFO: Contains general information outlining the progress and successful downloads, with minimal tracing information.

WARNING: Contains information about failed downloads, and reasons for failure.

ERROR: Contains errors related to the execution of the download plug-in, which might indicate an impending fatal error.

DEBUG: Contains fine-grained information used for troubleshooting issues. This is the most verbose level available.

--help

Prints the help message.

--download_dir "PATH"

Directory where all downloaded files are cached. Enclose the path in quotes. For example: "C:\Users\<username>\Downloads\solaris".

--logfile "FILE"

File path where logs are created.

--site

Target site. Currently supported: solaris11.

--patch_id ID1,ID2,...

Specifies one or more patch IDs to download. Multiple patch IDs must be separated by commas. For example: 15607530, 28351140.

--download-only-index

If user need to download patches just for a specific index, use this parameter. For example,

SolarisDownloadCacher.exe --loglevel DEBUG --download_dir "C:\Users\Administrator\Downloads\solaris" --logfile "C:\Users\Administrator\Downloads\solaris\downloader.log" --download-only-index 2 downloadByPatchId --site solaris11 --patch_id 15607530,28351140

--bigfix_server upload functionality

When the BigFix server details and credentials are provided, the utility caches all the downloaded files (the patches related to the specified Fixlet) in the directory specified by --download_dir and also uploads them to the following directory on the BigFix server:

C:\Program Files (x86)\BigFix Enterprise\BES
              Server\wwwrootbes\Uploads

. For example,

.\SolarisDownloadCacher.exe --loglevel DEBUG --download_dir "C:\Users\Administrator\Downloads\solaris" --logfile "C:\Users\Administrator\Downloads\solaris\downloader.log" --bigfix_server "https://10.134.141.238:52311" --bigfix_user "bigfix" --bigfix_pass "<password>" downloadByPatchId --site solaris11 --patch_id 15607530

--bigfix_user USER

Specifies the BigFix server user name.

--bigfix_pass_encoded PASSWORD

Specifies the Base64-encoded password for the BigFix server. If this option is not specified, the utility prompts for the BigFix server password during execution.

--os VERSION

Specifies the Solaris version (for example, --os 11).

--proxyServer PROXYSERVER

Specifies the URL of proxy server to use. It must be a well-formed URL, which contains a protocol and a host name. The URL is usually the IP address or DNS name of your proxy server and its port, which is separated by a colon. For example, http://192.168.100.10:8080.

--proxyUser PROXYUSER

Specifies the proxy user name if your proxy server requires authentication. It is usually in the form of domain/username.

--proxyPass PROXYPASS

Specifies the proxy password if your proxy server requires authentication.

subcommand subparameter

Specifies the subcommand and subparameters to be used to run the download cacher.

Note: The subcommand and subparameter names are case-sensitive.

The subparameter varies for each subcommand as follows:

downloadPkg

Downloads the listed RPM files for the specified operating system version, architecture, and flavor. This operation requires a JSON file that contains the package information. For example,

{
  "id": 7,
  "inbox": "./",
  "downloads": [
    {
      "id": 5502,
      "file": "./148076-20-1.zip",
      "url": "SolarisProtocol://getupdates.oracle.com/all_unsigned/148076-20.zip"
    }
  ]
}

Pass the JSON file using the --file parameter.

For example,

.\SolarisDownloadCacher.exe --loglevel DEBUG --download_dir "C:\Users\Administrator\Downloads\solaris" --logfile "C:\Users\Administrator\Downloads\solaris\downloader.log" downloadPkg --file test.json

downloadByPatchId

Downloads the file based on the patch ID for a specific operating system version. For example,

.\SolarisDownloadCacher.exe --loglevel DEBUG --download_dir "C:\Users\<username>\Downloads\solaris" --logfile "C:\Users\<username>\Downloads\solaris\downloader.log" downloadByPatchId --site solaris11 --patch_id 15607530

downloadbycontent

Downloads the file based on the content for a specific site. For example,

.\SolarisDownloadCacher.exe --loglevel DEBUG --download_dir "C:\Users\Administrator\Downloads\solaris" --logfile "C:\Users\Administrator\Downloads\solaris\downloader.log" downloadByContent --site solaris11 --content all

C:\Program Files (x86)\BigFix
        Enterprise\BES Server\wwwrootbes\Uploads

Without passing the BigFix Server password as input, you will be prompted for a password interactively.