Configuration parameters of the disconnected scanner (disconnected scenario)

You can edit the configuration files to customize the disconnected scanner behavior and the scans. For example, you can schedule scans and specify directories to exclude from scans.
Important: Do not change parameters that are not described.

setup_config.ini

The file contains general parameters for scheduling software and capacity scans.
Table 1. Parameters in the setup_config.ini file.
Parameter Default value Possible values Description
DOCKER_SCAN_ENABLED FALSE
  • TRUE
  • FALSE
Enables discovery of software that is installed in Docker containers. For more information on how License Metric Tool reports software that is installed in Docker containers, see: Discovering software in Docker containers.
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.

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.
10.0.8 PUBLIC_CLOUD_TYPE The field is empty by default
  • 10.0.11 KDDI Virtual Server
  • IBM Power Virtual Server
  • IBM SoftLayer
  • Microsoft Azure
  • Amazon EC2
  • Google Compute Engine
  • Oracle Compute Instance
  • Alibaba Elastic Compute Service
  • Tencent Cloud Server Instance
  • NEC Cloud IaaS Instance
  • Fujitsu Cloud IaaS Instance
    Note: For application updates and , Fujitsu Cloud IaaS Instance indicates FJcloud-V. Starting from application update , it indicates both FJcloud-V and FJcloud-O.
Specifies the type of a public cloud on which the computer is running. It allows proper counting of the number of Processor Value Units (PVUs) per virtual core.
Note: Ensure the name of the public cloud is enclosed in quotation marks.
SW_SCAN_SCHEDULE_ENABLED

FALSE

  • TRUE
  • FALSE

Enables software scans scheduling in crontab. If you set SW_SCAN_SCHEDULE_ENABLED to TRUE, the first software scan is initiated after you install the scanner. Subsequent scans will run on that time with the frequency you choose (defined by SW_SCAN_FREQUENCY)

SW_SCAN_FREQUENCY WEEKLY
  • DAILY
  • WEEKLY
Defines the frequency of software scans, either daily or weekly.

isotag_config.xml and slmtag_config.xml

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. For more information about these scans, see: Types of software scans.

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). The parameter is not available .
ExcludeDirectory For the list of directories that are excluded by default, see: Excluding directories from being scanned. Directory name Specifies directories that are excluded from software scans. For more information, see: Excluding directories from software scans by disconnected scanner (disconnected scenario).
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:pathWhere:
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. The parameter is not available.
Timeout 43200 Any positive number Specifies the number of seconds after which a query times out.

schedule_scans.sh

Replace the default user profile name QSECOFR with your preferred profile name to use it 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.
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). The parameter is not available .
excludeDirectory For the list of directories that are excluded by default, see: Excluding directories from being scanned (BigFix scenario). Directory name Specifies directories that are excluded from software scans. For more information, see: Excluding directories from software scans by disconnected scanner (disconnected scenario).
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:pathWhere:
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 (*), question mark (?).
Specifies directories to be included in the software scan. The parameter is not available .
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
  • vpd_config