Configuring the advanced OpenSUSE download Plug-in settings

For advanced configurations, manually edit the OpenSUSE download plug-in configuration file called plugin.ini.

The plugin.ini file is automatically created when the download plug-in is registered from the Manage Download Plug-in dashboard. It contains the settings for logging and caching, as well as custom configurations for extending the repository list file.

On Linux systems, the file is in the root directory tree occupied by the download plug-in. For example, /var/opt/BESServer/DownloadPlugins/OpenSUSEProtocol.

On Windows systems, the file is in the BigFix server installation directory. For example, %PROGRAM FILES%\BigFix Enterprise\BES Server\DownloadPlugins\OpenSUSEProtocol.

Figure 1. Example of the OpenSUSE download plug-in configuration file

[Logger]
file = logs/OpenSUSEPlugin.log
level = INFO

[UA]
proxy                = 
proxyUser            = 
proxyPass            = 

primaryRepoListFile  = C:\Program Files (x86)\BigFix Enterprise\BES Server\
       GatherDBData\gather\Patching Support\CurrentSiteData\DLOpenSUSERepoList.json

extendedRepoListFile = 
onlyUseExtendedRepoListFile = no

localCache =
localCacheOnly = no
CryptoUtilPath = C:\Program Files (x86)\BigFix Enterprise\BES Server\
       DownloadPlugins\CryptoUtility\CryptoUtility_v11.exe

Note: The plugin.ini is divided into sections, which are denoted by square brackets. Ensure that the options are under the correct sections. Moving the options to a different section might result in errors.

Either an absolute path or relative path can be used in the options that require a path: file, primaryRepoListFile, extendedRepoListFile, and localCache. Relative paths are relative to the download plug-in executable directory. By default, the executable file is in the DownloadPlugins\OpenSUSEProtocol folder.

Setting the logging level

The logging level determines the amount of detail that is written to the OpenSUSEPlugin file.

The available logging levels are as follows:

ERROR: Contains errors related to the execution of the download plug-in, which might indicate an impending fatal error.
WARNING: Contains information about failed downloads, and reasons for failure.
INFO: Contains general information outlining the progress and successful downloads, with minimal tracing information.
DEBUG: Contains fine-grained information used for troubleshooting issues. This is the most verbose level available.

You can change the logging level option from the [Logger] section of the plugin.ini file.

[Logger]
logfile = logs/OpenSUSEPlugin.log
level = INFO

For example, if the logging is set to INFO, the logger outputs any logs for that level and any level above it. In this case, it outputs the INFO, WARNING, and ERROR logs.

Note: Setting the logging level to DEBUG increases the amount of information to log, which might impact performance. Only increase the logging level to DEBUG when investigating an issue, and switch back to INFO or WARNING after the issue is resolved.

Adding an extended repository list file

The OpenSUSE download plug-in can be configured to work with repositories that are not officially supported by BigFix, if required.

Setting the download cache

You can use the download cacher tool to download the packages and repository metadata to a location that you specify.

There are three possible scenarios in which you can configure the download cacher for.

Sha1 download capability on air-gapped environments: The download cacher tool is mainly designed to be used for air-gapped environments, which require secure networks and therefore do not have access to the internet to download the files directly from the vendor site.; The sha1 download capability improves performance by caching the packages directly on the BigFix server's sha1 folder.; For information, see Using the OpenSUSE Leap 15 download cacher for air-gapped environments.
Sha1 download capability on an internet-enabled BigFix server: This method is considered best practice for caching packages on environments with a BigFix server that is internet-enabled. The sha1 download capability improves performance by caching the packages directly on the BigFix server's sha1 folder.; For information, see Caching packages on the sha1 folder.
Without the sha1 download capability on an internet-enabled BigFix server: If for some reason you choose not to use the sha1 download capability to cache packages on the BigFix server's sha1 folder, you can use the local cache. For information, see Caching packages on the local cache folder.