Installing the scanner and gathering initial data on IBM i systems

Available from 9.2.5. After you copied the installation files and the software catalog to your IBM i systems, start the installation and the initial scans.

Before you begin

  • You must have the *ALLOBJ authority to perform this task.
  • The jar tool must be available on the endpoint. To check whether the tool is available, type jar in the QSH.
  • Set the JAVA_HOME variable on the computer on which you want to install the scanner and export it to your process.
    1. To set the variable, run one of the following commands from the IBM i Main Menu.
      • To add the variable to your current interactive job, run the following command:
        ADDENVVAR ENVVAR(JAVA_HOME) VALUE('/QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit’)
      • To set the variable at the system level, run the following command:
        ADDENVVAR ENVVAR(JAVA_HOME) VALUE('/QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit') LEVEL(*SYS)
    2. Export the JAVA_HOME variable to your process.
      1. Open a Qshell session by using the STRQSH command.
      2. Export the variable to your process by using the following command.
        export -s JAVA_HOME=/QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit


  1. Open the QSH and go to the directory where you copied the disconnected scanner package. By default, it is the /cit directory.
  2. Run the file.
    It automatically performs the following steps:
    • Installs the scanner.
    • Runs the initial capacity scan, and creates the computer.yml file.

      The initial capacity scan is needed to collect data about your IBM i system, and to create the computer.yml file that will identify this system. The file is added to each package with scan results and it helps to catalog and correctly display them in the user interface. It contains information about the operating system, such as host name, and a unique computer ID.

    • Schedules regular capacity scans.

      The capacity scan is scheduled to run every 30 minutes to gather current results for virtualized environments where the capacity can dynamically change depending on the allocated resources.

    Note: After you install the scanner, its installation path cannot be changed. The installation path is a location where you upload the installation files. To change the installation path, back up the configuration files, scan results and logs. Then, uninstall the scanner, move the files to a different directory, and then install the scanner in the new location.
  3. Go to the /cit or /cit/config directory, and verify that the created computer.yml file contains the correct data. For more information about the contents of this file and instructions about how to change them, see: Creating the computer.yml file.


The scanner is set up now, and ready to run the software scan and gather results.

What to do next

Run the software scan and gather scan results.