Updating 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. To update the scanner, download the new disconnected scanner package, and copy it to the scanner installation directory.

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.

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 that causes duplication of the discovered software in License Metric Tool.

    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.

    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.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 2 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 2 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).