Running the ISO tags scan

Available from 9.2.5. In software identification tags scan, the scanner searches for ISO tags that are delivered with software products. After you upload the final package with scan results to BigFix Inventory, the tags are processed. Based on the information that they contain, the software is discovered.

Note: This task is optional, because it can be completed by an automated script. Use it only for advanced scenarios.

Before you begin

The ISO tags scan requires the software catalog for ISO tags. You can find it in the downloaded ibm_i_cit_and_configs.zip package.

Procedure

  1. In QSH, run the following command to initiate the ISO tag scan:
    /qsys.lib/qtivcit.lib/wscansw.pgm -s -c sw_config.xml -i i5_iso_catalog.xml -o iso_scan.xml
    Where:
    -s
    Creates a signature for the output file. The signature must be stored for audit purposes.
    -c sw_config.xml
    Path to the sw_config.xml configuration file that you downloaded with CIT.
    -i i5_iso_catalog.xml
    Path to the ISO software catalog for IBM i systems.
    -o iso_scan.xml
    The output file. It contains paths to all scanned ISO tags.
  2. The scan creates the iso_scan.xml output file. Back up this file, because you will need to store the original output and its signature for audit purposes.
  3. The iso_scan.xml output file lists all scanned ISO tags. You must now gather and copy these tags to a separate directory and create a text file that lists all of them. Create such a directory, for example /isotag_scan, and then complete the following steps:
    1. Open the iso_scan.xml file. Each entry in this file contains a path to the scanned ISO tag file, for example:
      <MatchedSignature guid="ISO-TAGS">
      <Variable name="INSTALL_PATH" value="/iso-swid/IBM_Capital_Regulatory_Reporting_Add-on-License-4.9.0.swidtag"/>
      <Variable name="IS_INSTALLED" value="true"/>
      </MatchedSignature>
    2. Copy each path to a new file called list.txt. Place each path on a separate line, for example:
      /iso-swid/IBM_Capital_Regulatory_Reporting_Add-on-License-4.9.0.swidtag
      /iso-swid/1986-03.com.ibm_IBM_BigFix_Inventory_Server-9.2.1.swidtag
    3. Copy each of the scanned ISO tags to the isotag_scan directory. Rename the files so that they contain numeric values according to their order in the list.txt file.

      For example, if the /iso-swid/IBM_Capital_Regulatory_Reporting_Add-on-License-4.9.0.swidtag file is written on the first line in the list.txt file, rename this ISO tag to 1.

      The following image shows sample ISO tag files and their paths in the list.txt file.
      Image showing the contents of the isotag_scan directory.
  4. Compress the isotag_scan directory into a [zip|tar.gz|tgz] package, and copy it to the /scans directory, in which you store all scan results.
    Warning: The list.txt file must be the first file in the archive. You can achieve it by compressing only this file, and then adding the rest of files to the archive.
  5. Copy the backup iso_scan.xml file and its signature to the /source directory.