Configuration parameters of the disconnected scanner (disconnected scenario)

9.2.5 Available from 9.2.5.

You can customize the disconnected scanner behavior and the scans that it runs by editing the configuration files. For example, you can schedule scans and specify directories to exclude from scans.

Important: Do not change parameters that are not described.

UNIX Windows setup_config.ini

Important: The file is not available on IBM i. Only default configuration is possible on IBM i.
The file contains general parameters for scheduling software and capacity scans. Every time you change a parameter in the setup_config.ini file, run the following script for the changes to take effect:
  • UNIX automation/configure.sh
  • Windows automation\configure.bat
Table 1. Parameters in the setup_config.ini file.
Parameter Default value Possible values Description
9.2.24 Linux COLLECT_HOST_HOSTNAME FALSE
  • TRUE
  • FALSE

Enables collection of host names of virtualization hosts.

The VIRTUALIZATION_HOST_SCAN_ENABLED parameter must be set to TRUE before you can enable collection of host names.

9.2.30 CURL_PARAMETERS -k -s String

cURL options that are used during the upload of disconnected scan results to the License Metric Tool server. They are used to customize connection parameters that might be required in more secure environments.

9.2.30 CURL_PATH
  • Linux curl
  • Windows curl.exe
String

Full path to cURL if cURL is not located in the PATH environment variable.

For more information, see: Uploading disconnected scan results (disconnected scenario).

9.2.22 DAILY_PACK_RESULTS_
CREATION_ENABLED
  • For application updates 9.2.22 - 9.2.23: FALSE
  • Starting from application update 9.2.24: TRUE
  • TRUE
  • FALSE

Enables daily creation of packages with scan results.

When you set the value of this parameter to FALSE, you need to run one of the following scripts to create packages with scan results.
  • UNIX run_sw_and_pack.sh or pack_results.sh
  • Windows run_sw_and_pack.bat or pack_results.bat
9.2.26 DOCKER_SCAN_ENABLED FALSE
  • TRUE
  • FALSE

Enables discovery of software that is installed in containers. For more information on how License Metric Tool reports software that is installed in containers, see: Discovering software in containers.

9.2.18 Linux HW_SCAN_SCHEDULE_ENABLED TRUE
  • TRUE
  • FALSE

Enables scheduling capacity scans in cron.

By default, the capacity scan is scheduled to run every 30 minutes. The frequency cannot be modified.

When you set the value of this parameter to FALSE, a single capacity scan is run but no schedule is set.

9.2.30 LMT_SERVER_URL The field is empty by default {IP address or host name}:port

IP address or host name, and port of the License Metric Tool server to which packages with disconnected scan result will be uploaded.

For more information, see: Uploading disconnected scan results (disconnected scenario).

9.2.30 LMT_SERVER_API_TOKEN The field is empty by default String

API token to be used to upload disconnected scan results to the License Metric Tool server. It must belong to a user with the Manage Scan Uploads (previously: Manage Uploads) permission.

For more information, see: Uploading disconnected scan results (disconnected scenario).

The API token is kept in obfuscated form.

MAX_HW_SCAN_DAYS 14 Any positive number The number of days after which scan results are considered old. Such results are removed if the number of unique scan files exceeds the number that is set in the MAX_HW_SCAN_FILES parameter.
MAX_HW_SCAN_FILES 7 Any positive number The maximum number of files with capacity scan results that can be stored on a computer.

If the number is exceeded, files that are older than specified in the MAX_HW_SCAN_DAYS parameter are not included in the package with scan results.

NUMBER_OF_HISTORICAL_
RESULTS_TO_KEEP
30 Any positive number The number of files with scan results that can be stored in the output folder. If there are more files, the oldest ones are removed during packaging.

If you specify 0, the number of stored files is not limited and no files are removed during packaging.

9.2.17 PACKAGE_OUTPUT_DIR .\output Directory name Defines the directory in which scan results are stored. By default, the .\output directory is created in the installation directory of the disconnected scanner.
9.2.23 PUBLIC_CLOUD_TYPE The field is empty by default
  • Alibaba Elastic Compute Service
  • Amazon EC2
  • Google Compute Engine
  • 9.2.28 IBM Cloud LinuxONE VS
  • IBM Power Virtual Server
  • IBM SoftLayer
  • 9.2.29 KDDI Virtual Server
  • Microsoft Azure
  • NEC Cloud IaaS Instance
  • 9.2.33 NTT Data
  • 9.2.25 NTT Enterprise Cloud Server
  • 9.2.28 NTT IaaS Powered by VMware
  • 9.2.24 Fujitsu Cloud IaaS Instance
    Note: For application updates 9.2.24 and 9.2.25, Fujitsu Cloud IaaS Instance indicates FJcloud-V. Starting from application update 9.2.26, it indicates both FJcloud-V and FJcloud-O.
  • Oracle Compute Instance
  • Tencent Cloud Server Instance
Specifies the type of a public cloud on which the computer is running. It allows for properly counting the number of Processor Value Units (PVUs) per virtual core.
Note: Ensure the name of the public cloud is enclosed in quotation marks.

Alternatively, you can mark computers from the License Metric Tool user interface. For more information, see: Identifying disconnected computers as running on public clouds (disconnected scenario).

9.2.27 SW_SCAN_CPU_
THRESHOLD_PERCENTAGE
The field is empty by default
  • Empty value
  • Integer between 5 and 100
Limits the amount of processor resources that the scanner consumes.

By default, the value is empty, which indicates that the scan can consume up to 100% of a single CPU that is available to the scanner. The higher value that you specify as the threshold, the higher is the consumption limit. For example, if you specify 75, scanner processes use the average of 75% of a single CPU that is available on the target computer.

Important: Setting the threshold does not guarantee that CPU consumption is always below the specified value. It fluctuates around that value, sometimes exceeding it and sometimes dropping below it. Temporary peaks are expected. The CPU threshold provides the process scheduler of the operating system with information for how long to keep the scanner thread idle. The scanner does not control how the threshold is mapped to the CPU resources that are available. The assignment of resources is determined by the operating system that decides on which processor (or core) to run the scanner thread.

Setting the threshold might lengthen the time of the scan.

If you set the CPU threshold in application update 9.2.26 or lower by editing the isotag_config.xml, slmtag_config.xml and sw_config.xml files, the empty value of the SW_SCAN_CPU_THRESHOLD_PERCENTAGE parameter preserves your previous settings. For more information, see: Optimizing processor utilization by disconnected scanner (disconnected scenario).

9.2.26 SW_SCAN_DAY_OF_WEEK The field is empty by default
  • MON
  • TUE
  • WED
  • THU
  • FRI
  • SAT
  • SUN
Defines the day of the week on which the weekly scan will run. This parameter is relevant only if the SW_SCAN_FREQUENCY parameter is set to WEEKLY. By default, this parameter is empty which means that the weekly scan will be scheduled starting from the time when the setup.sh or setup.bat script was run.
SW_SCAN_FREQUENCY WEEKLY
  • DAILY
  • WEEKLY
Defines the frequency of software scans, either daily or weekly.
9.2.26 SW_SCAN_LOCAL_TIME The field is empty by default Time in the HH:MM format Defines the time (hour and minutes) during the day in the local time zone when the scheduled software scan (weekly or daily) will run. By default, this parameter is empty which means that the scan will start at the time of the day when the setup.sh or setup.bat script was run.
SW_SCAN_SCHEDULE_ENABLED
  • For application updates 9.2.5 - 9.2.23: FALSE
  • Starting from application update 9.2.24: TRUE
  • TRUE
  • FALSE
Enables scheduling software scans in cron on UNIX or Task Scheduler on Windows.

When you set the value of this parameter to TRUE, the first software scan is initiated after you install the scanner. Subsequent scans run with the frequency that is set in the SW_SCAN_FREQUENCY parameter.

9.2.24 Linux VIRTUALIZATION_HOST_
SCAN_ENABLED
FALSE
  • TRUE
  • FALSE
Enables the capacity scan on virtualization hosts that retrieves capacity data from all virtual machines that are managed by these hosts.

After this scan is enabled, it becomes a part of the regular capacity scan. Thus, the HW_SCAN_SCHEDULE_ENABLED parameter must be set to TRUE before you enable the scan on virtualization hosts.

For more information, see: Collecting capacity data from virtualization hosts with disconnect scanner (disconnected scenario).

UNIX Windows isotag_config.xml and slmtag_config.xml

Important: The files are not available on IBM i. Only default configuration is possible on IBM i.
The isotag_config.xml file contains parameters for tuning the software identification tags scan. The slmtag_config.xml contains parameters for tuning the resource utilization scan.
Table 2. Parameters in the isotag_config.xml and slmtag_config.xml files
Parameter Default value Possible values Description
AssumeAutoFS remote
  • local

    Recognizes disks mounted by autofs as local disks.

  • remote

    Recognizes disks mounted by autofs as remote disks.

  • other

    Recognizes disks mounted by autofs as disks of other types, for example: DVD.

Specifies how the scan recognizes disks that were mounted by the automatic mounting service (autofs).
ExcludeDirectory Depends on the operating system

For more information, see: Excluding directories from software scans (disconnected scenario).

[media_type::]drive:path
Where:
media_type
Specifies the media type. Possible values:
  • $local

    Excludes local disks.

  • $remote

    Excludes remote disks.

  • $other

    Excludes other disk types, for example: DVD. This option is supported only on Windows.

  • $all

    Excludes all disks that are listed above.

If the media_type variable is not specified, the $local value is assumed.

drive
Specifies drives to be excluded. You can indicate one or more drives or you can use the $local, $remote, $other, and $all values. In the latter case, all drives of a particular type are excluded from the scan. This variable is optional on UNIX.
path
Specifies the path to be excluded. The following wildcards are supported: asterisks (*) and question mark (?).
Specifies directories that are excluded from software scans. For more information, see: Excluding directories from software scans (disconnected scenario).
AIX SolarisExcludeGuestDirectories true
  • true
  • false
Specifies whether catalogs that belong to zones or WPARs are scanned. When the value of the parameter is set to true, the catalogs are not scanned.
IncludeDirectory $local::* [media_type::]drive:path
Where:
media_type
Specifies the media type. Possible values:
  • $local

    Includes local disks.

  • $remote

    Includes remote disks.

  • $other

    Includes other disk types, for example: DVD. This option is supported only on Windows.

  • $all

    Includes all disks that are listed above.

If the media_type variable is not specified, the $local value is assumed.

drive
Specifies drives to be included. You can indicate one or more drives or you can use the $local, $remote, $other, and $all values. In the latter case, all drives of a particular type are included in the scan. This variable is optional on UNIX.
path
Specifies the path to be included. The following wildcards are supported: asterisks (*) and question mark (?).
Specifies directories to be included in the software scan.

For more information about scanning remote shared disks, see: Scanning remote shared disks (disconnected scenario).

Timeout 43200 Any positive number Specifies the number of seconds after which a query times out.

IBM i schedule_scans.sh

Replace the default user profile name QSECOFR with the name of the profile that you want to use to run capacity scans. The user profile must meet the following requirements:
  • Class set to *USER
  • Special authority set to *NONE
You can use the same user profile that is used to install the scanner and run the software scan. Set up the special authority to *ALLOBJ.

sw_config.xml

The file contains parameters for tuning the catalog-based scan. For more information about this scan, see: Types of software scans (BigFix scenario).
Table 3. Parameters in the sw_config.xml file.
Parameter Default value Possible values Description
assumeAutoFS remote
  • local

    Recognizes disks mounted by autofs as local disks.

  • remote

    Recognizes disks mounted by autofs as remote disks.

  • other

    Recognizes disks mounted by autofs as disks of other types, for example: DVD.

Specifies how the scan recognizes disks that were mounted by the automatic mounting service (autofs).

IBM i The parameter is not available.

excludeDirectory Depends on the operating system

For more information, see: Excluding directories from software scans (disconnected scenario).

Where:
media_type
Specifies the media type. Possible values:
  • $local

    Excludes local disks.

  • $remote

    Excludes remote disks.

  • $other

    Excludes other disk types, for example: DVD. This option is supported only on Windows.

  • $all

    Excludes all disks that are listed above.

If the media_type variable is not specified, the $local value is assumed.

drive
Specifies drives to be excluded. You can indicate one or more drives or you can use the $local, $remote, $other, and $all values. In the latter case, all drives of a particular type are excluded from the scan. This variable is optional on UNIX.
path
Specifies the path to be excluded. The following wildcards are supported: asterisks (*) and question mark (?).
Specifies directories that are excluded from software scans. For more information, see: Excluding directories from software scans (disconnected scenario).
AIXSolaris excludeGuestDirectories true
  • true
  • false
Specifies whether catalogs that belong to zones or WPARs are scanned. When the value of the parameter is set to true, the catalogs are not scanned.
includeDirectory $local::* [media_type::]drive:path
Where:
media_type
Specifies the media type. Possible values:
  • $local

    Includes local disks.

  • $remote

    Includes remote disks.

  • $other

    Includes other disk types, for example: DVD. This option is supported only on Windows.

  • $all

    Includes all disks that are listed above.

If the media_type variable is not specified, the $local value is assumed.

drive
Specifies drives to be included. You can indicate one or more drives or you can use the $local, $remote, $other, and $all values. In the latter case, all drives of a particular type are included in the scan. This variable is optional on UNIX.
path
Specifies the path to be included. The following wildcards are supported: asterisks (*) and question mark (?).
Specifies directories to be included in the software scan.

IBM i The parameter is not available.

For more information about scanning remote shared disks, see: Scanning remote shared disks (disconnected scenario).

maxQueryTime 43200 Any positive number Specifies the number of seconds after which a query times out.

Configuration files that should not be modified

Do not modify any parameters in the following configuration files. Otherwise, the disconnected scanner might stop working.
  • tlm_hw_config.xml