Upgrading the disconnected scanner (disconnected scenario)

Edit online

9.2.5 Available from 9.2.5. The disconnected scanner is updated regularly to introduce improvements and new functions. Upgrade the scanner to take advantage of these functions. You can upgrade the scanner manually or by using the upgrade script.

About this task

9.2.22 If you use Ansible to manage disconnected scanners, you can use the lmt_install_or_upgrade_scanner.yml playbook. For more information, see: License Metric Tool playbooks.

9.2.41 Upgrading automatically

Edit online

You can enable the automatic upgrade of the disconnected scanner. The scanner checks whether its new version is available daily. If a new version is available, it is downloaded and the scanner is upgraded.

Before you begin

  • To use this option, the License Metric Tool server must be in version 9.2.41 or higher.
  • If you installed the disconnected scanner in version 9.2.41 or higher, the automatic upgrade is enabled by default. If you installed the disconnected scanner in a lower version, you must first upgrade it to the latest version. Then, you can enable the automatic upgrade.

  • IBM i Automatic upgrade is not available on IBM i. To upgrade the disconnected scanner on IBM i, use the manual procedure.

Procedure

  1. Log in to the computer where the disconnected scanner is installed.
  2. Open the setup_config.ini file. By default, the file is in the following location.
    • Linux <disconnected_scanner_install_dir>/config
    • Windows <disconnected_scanner_install_dir>\config
  3. Set the following parameters. They are already set if you used the following procedure to set up the transfer of scan results: Uploading disconnected scan results directly to the server (disconnected scenario).
    • For application update 9.2.41 and earlier: LMT_SERVER_URL and LMT_SERVER_API_TOKEN
    • For application update 9.2.42 and later: DATA_UPLOAD_URL and DATA_UPLOAD_TOKEN
  4. Set the value of the AUTO_UPGRADE_ENABLED parameter to TRUE. If you installed the disconnected scanner in version 9.2.41 or higher, the parameter is already set properly.

Results

Automatic upgrade of the disconnected scanner is enabled. The disconnected scanner checks whether its new version is available daily. When a new version is available, the disconnected scanner package and the upgrade script are downloaded, and the scanner is upgraded. When the script finishes, the upgrade is complete. If an error occurs during the upgrade, see what is the possible cause and how to solve it. For more information, see: Return codes from the disconnected scanner upgrade.

9.2.41 Upgrading with the script

Edit online

You can upgrade the disconnected scanner by using the upgrade script.

Before you begin

  • To use this option, the License Metric Tool server must be in version 9.2.41 or higher.
  • To perform this task, you must have the following privileges.
    • UNIX root
    • Windows administrative privileges with elevation

  • IBM i The upgrade script is not available on IBM i. To upgrade the disconnected scanner on IBM i, use the manual procedure.

Procedure

  1. Log in to License Metric Tool, and go to Management > Scanning Tools.
  2. Download the following packages that are specific for the operating system on which you want to upgrade the disconnected scanner
    • Disconnected scanner package
    • Upgrade script
  3. Place the scanner package and the upgrade script in a single catalog. It can be any catalog on the system other than the catalog where the disconnected scanner is installed.
  4. Run the upgrade script.
    • Linux 
      chmod +x LMT-DisconnectedScannerUpgrader-unix-<version>.sh
./LMT-DisconnectedScannerUpgrader-unix-<version>.sh
    • Windows 
      powershell -ExecutionPolicy Bypass -File LMT-DisconnectedScannerUpgrader-windows-<version>.ps1

Results

When the script finishes, the upgrade is complete. If an error occurs during the upgrade, see what is the possible cause and how to solve it. For more information, see: Return codes from the disconnected scanner upgrade.

Upgrading manually

Edit online

You can upgrade the disconnected scanner manually. This procedure requires more steps than upgrading the scanner with a script.

Before you begin

To perform this task, you must have the following privileges.
  • IBMi *ALLOBJ authority
  • UNIX root
  • Windows administrative privileges with elevation

Procedure

  1. Create a backup of the following files that are located in the config subdirectory of the disconnected scanner installation directory. You will need to restore the files after the upgrade of the scanner.
    Important: Some files exist only on selected operating systems. If a file does not exist in the config subdirectory, it is not available on the particular operating system.
    9.2.25 computer_properties.yml
    The file contains values of custom computer properties.
    endpoint_id.txt

    The file contains the host name, and the time stamp of the first setup of the disconnected scanner. The combination of these two elements becomes an identifier of a computer. In case of scanner upgrade, or re-installation, the existing identifier from the file is used. If the file is missing, a new identifier is created for the computer. It causes that the discovered software is duplicated in License Metric Tool and VM manager scan results are rejected if the disconnected VM Manager Tool is used.

    9.2.26 IBM i The file is available on IBM i starting from application update 9.2.26. For earlier application updates, back up the computer.yml file. In case of IBM i, identifier of the computer is a combination of the hardware serial number and LPAR ID.

    Linux vmman_host_id
    The file is present on Linux systems on which the scan of virtualization hosts was enabled. The file contains the generated ID of the virtualization host.
    uuid.dat
    The file contains generated ID of a VM when the ID cannot be retrieved from a VM that runs on a public cloud.
    isotag_config.xml
    The file contains parameters for tuning the software identification tags scan.
    slmtag_config.xml
    The file contains parameters for tuning the resource utilization scan.
    sw_config.xml
    The file contains parameters for tuning the catalog-based scan.
  2. UNIX Windows If you changed any of the configuration in the setup_config.ini file, back up the file. You will need to manually recreate the same configuration after the upgrade of the scanner. The file is located in the config subdirectory of the disconnected scanner installation directory.
    Important: The file does not exist on IBM i.
  3. Download the disconnected scanner package.
    • 9.2.33 Download the disconnected scanner package from the Scanning Tools panel.
      1. Log in to License Metric Tool and go to Management > Scanning Tools.
      2. In the Disconnected Scanners section, click the link that is specific for the operating system on which you want to install the disconnected scanner.
    • 9.2.29 Download the disconnected scanner package from the Data Sources panel.
      1. Log in to License Metric Tool and go to Management > Data Sources.
      2. Select the disconnected data source.
      3. In the Disconnected scanner installation packages section, click the link that is specific for the operating system on which you want to upgrade the disconnected scanner.
    • 9.2.25 To download the disconnected scanner package by using REST API, see: REST API for downloading disconnected scanner packages.
    • To download the disconnected scanner package from the installation directory of the License Metric Tool server, perform the following steps.
      1. Upgrade the License Metric Tool server to the latest version. For more information, see: Upgrading components of License Metric Tool (disconnected scenario).
      2. Go to the <LMT_installation_directory>/disconnected-scanners/ directory on the computer where the License Metric Tool server is installed.
  4. Move the disconnected scanner package to the computer on which you want to upgrade the scanner.
  5. Upgrade the disconnected scanner.
    • To upgrade of the disconnected scanner in-place, perform the following steps.
      1. Extract the disconnected scanner package to the installation directory of the existing disconnected scanner.
      2. Restore the files that you backed up in step 1 in the config directory.
      3. UNIX Windows Manually recreate settings in the setup_config.ini file. Do not restore the file that you backed up in step 1 as the new file might have an updated format.
      4. To update the disconnected scanner, run the following script.
        • IBM i update.sh
        • UNIX setup.sh
        • Windows setup.bat
    • To upgrade the disconnected scanner in a new location, perform the following steps. This type of upgrade is not possible on IBM i.
      1. Extract the disconnected scanner package in a new location.
      2. Copy the files that you backed up in step 1 to the config directory of the new disconnected scanner.
      3. Uninstall the disconnected scanner from the old location. For more information, see: Uninstalling the disconnected scanner (disconnected scenario).
      4. UNIX Windows Manually recreate settings in the setup_config.ini file. Do not restore the file that you backed up in step 1 as the new file might have an updated format.
      5. To update the disconnected scanner, run the following script.
        • UNIX setup.sh
        • Windows setup.bat
  6. If you enabled scanning of reparse points, enable it again as the setting is not preserved during the upgrade. For more information, see: Scanning symbolic links and junctions (disconnected scenario).