Set up IBM License Metric Tool (ILMT) integration

Set up IBM License Metric Tool integration for IBM compliance reporting. You can use an HTTP or HTTPS connection

Before you begin

Role required: sys_admin

About this task

Integrate one or multiple ILMT servers with Software Asset Management using HTTP or HTTPS.
Note: The add-on IBM content pack (com.sn_samp_ibm) plugin must be installed to view the IBM dashboard tab.

Upon plugin activation, an ILMT Server connection alias is provided to use to set up ILMT server connections. Once the connection with ILMT is successful, historical data is retrieved for the aggregated period set up in ILMT. Data includes computers and license consumption information.

Content related to ILMT integration can be accessed from the Integration - ILMT application menu.
  • Setup contains connection alias and connection information.

    A connection alias resolves your connection and credential at runtime. Multiple active ILMT server connections are supported. More than one credential can be active per connection alias at a time. If more than one credential is active, they are used in order.

  • Scheduled Import contains scheduled script execution information. Runs weekly by default but it can be executed manually.
  • Transform History contains the Transform Histories list to view.
  • Import Set Data > Scheduled Cleanup contains the Import Set Deleter script that you can update, delete, or execute.
  • Import Set Data > Computers contains the ILMT Computers list.
  • Import Set Data > License Consumption contains the ILMT Consumption list.


  1. If you are using an HTTPS connection, download, import, and create a server certificate.
    1. Download the server certificate from the ILMT server.
      For example:
      -----BEGIN CERTIFICATE-----
      [certificate content]
      -----END CERTIFICATE-----
      Note: A server certificate is not required for an HTTP connection.
    2. Import the certificate to the Java keystore using the IMLT server certificate file using the keytool command.
      keytool -import -trustcacerts -alias DemoAlias -file IBM_server.cer   -keystore IBM_server.keystore  -storetype jks
      keytool -list -v -keystore IBM_server.keystore

      For more information, see Java keytool documentation.

    3. Navigate to System Definition > Certificates and create a certificate (Trust Store Cert, PEM format).
    4. Paste the full downloaded ILMT server certificate content into the PEM Certificate field (including banners).
    5. Click Validate Stores/Certificates related list.
  2. For HTTP or HTTPS, create a new connection by navigating to Integration - ILMT > Setup (see table for field descriptions).
    Table 1. HTTP Connection form
    Field Description
    Name Unique name of the connection.
    Credential Credential value used by this connection.

    Use ILMT server user and password, or token.

    Connection alias Connection alias value with which the connection can be referred.

    A connection alias resolves your connection and credential at runtime.

    Use ILMT_Servers predefined alias.

    URL builder If checked, indicates that the URL builder is used to build the connection string.
    Note: For use with an HTTPS connection.
    Connection URL Connection URL (if not using the URL builder).
    Mutual authentication If checked, indicates mutual authentication is used.
    Note: For use with an HTTPS connection.
    Protocol profile Underlying protocol used by the connection.
    Note: For use with an HTTPS connection.
    Active (Optional) If checked, indicates that the connection is active.
    Domain Domain to which the connection belongs.
    Use MID server If checked, indicates connection uses a MID server.
    Host Target host used by the connection.

    Enter host IP address for ILMT setup.

    Port Target port used by the connection.

    Enter port number for ILMT setup.

    Base path Base path for the HTTP connection.
    Active connection information is shown.
  3. Import ILMT scheduled data by navigating to Integration - ILMT > Scheduled Import and clicking Execute Now.
    The ILMT Transport Histories list is shown to verify import was completed successfully. Computers are imported to the [cmdb_ci_computer] table. License consumption is imported to the [samp_ilmt_sw_install] table.