Configuring the IBM License Metric Tool

IBM License Metric Tool monitors license compliance. It recognizes and monitors what product offerings and their versions, releases, and fix packs are installed and used on the system. It measures the processor value units (PVU) available to and used by these assets. The tool ensures compliance with IBM® subcapacity licensing requirements and to demonstrate good IT governance. Information about installed software is collected from monitored computers by an agent that can be deployed on a range of operating systems. It is stored on a central server in a DB2® database and can be accessed through pre-configured reports that are available from a web user interface.

Before you begin

Install and configure HCL Digital Experience before you configure the IBM License Metric Tool.

Procedure

  1. Download the IBM License Metric Tool agent and install it on each server that has HCL installed. Read Passport Advantage® for instructions on downloading the IBM License Metric Tool agent, prerequisites, and licensing process.
  2. Complete the following steps to provide credentials to IBM License Metric Tool:
    1. Open a shell window.
    2. Change to the IBM License Metric Tool installation directory: agent_home/wasagent.
    3. Run the following task to start the WebSphere® agent:
      • AIX® HP-UX Linux™ Solaris: ./WASAgentClient.sh
      • IBM i: WASAgentClient.sh
      • Windows™: WASAgentClient.bat
    4. Enter servers to list the WebSphere server IDs and locations.
    5. Enter credentials id userid password to provide credentials for the servers. Where id is the server ID and userid and password correspond to the WebSphere Application Server administrator user ID and password.
      Note: Whenever the IBM Tivoli® License Compliance Manager agent is stopped, rerun the WASAgentClient task and then reissue the credentials.
    6. Complete any additional configuration tasks after installation. Read the following topic for instructions: Configuring IBM License Metric Tool.
  3. Follow the IBM License Metric Tool instructions that are provided with your customer agreement to complete the IBM License Metric Tool licensing configuration for HCL and HCL Web Content Manager.
  4. Ensure that the appropriate inventory signature file exists in the PortalServer_root/properties/version directory path. The file that is present depends on your license agreement and has a general format of IBM_offering_nameversion_number.swtag.
    Tip: Only one filename.swtag signature file can exist per product offering. Refer to the following table to determine the correct signature file. If you installed HCL Server as a prerequisite for Enable, Extend, HCL Web Content Manager, or HCL Web Content Manager Standard Edition, only the .swtag for the advanced offering exists.
    Note: If the wrong file is found, the wrong offering might be installed. You must uninstall that offering and install the correct offering. If necessary, contact IBM Support for assistance with this process.
    Table 1. Product signature files for Version 9.0
    Product offering / Component name IBM Tivoli License Manager signature file Signature file's directory path
    HCL Extend Version 9.0 ibm.com_IBM_WebSphere_Portal_Extend-9.0.0.swidtag the UserData path of the PortalServer_root/swidtag directory
    HCL Enable Version 9.0 ibm.com_IBM_WebSphere_Portal_Enable-9.0.0.swidtag the UserData path of the PortalServer_root/swidtag directory
    HCL Server Version 9.0 ibm.com_IBM_WebSphere_Portal_Server-9.0.0.swidtag the UserData path of the PortalServer_root/swidtag directory
    HCL Web Content Manager Version 9.0 ibm.com_IBM_Web_Content_Manager-9.0.0.swidtag the UserData path of the PortalServer_root/swidtag directory
    HCL Web Content Manager Standard Edition Version 9.0 ibm.com_IBM_Web_Content_Manager-9.0.0.swidtag the UserData path of the PortalServer_root/swidtag directory
    HCLVersion 9.0 ibm.com_IBM_WebSphere_Portal_Express-9.0.0.swidtag the UserData path of the PortalServer_root/swidtag directory
    Table 2. Product signature files for Version 8.5
    Product offering / Component name IBM Tivoli License Manager signature file Signature file's directory path
    HCL Extend Version 8.5 IBM_WebSphere_Portal_Extend.8.5.0.swtag the UserData path of the PortalServer_root/properties/version directory
    HCL Enable Version 8.5 IBM_WebSphere_Portal_Enable.8.5.0.swtag the UserData path of the PortalServer_root/properties/version directory
    HCL Server Version 8.5 IBM_WebSphere_Portal_Server.8.5.0.swtag the UserData path of the PortalServer_root/properties/version directory
    HCL Web Content Manager Version 8.5 IBM_Web_Content_Manager.8.5.0.swtag the UserData path of the PortalServer_root/properties/version directory
    HCL Web Content Manager Standard Edition Version 8.5 IBM_Web_Content_Manager.8.5.0.swtag the UserData path of the PortalServer_root/properties/version directory
    HCL Version 8.5 IBM_WebSphere_Portal_Express.8.5.0.swtag the UserData path of the PortalServer_root/properties/version directory
  5. Verify that the itlm.product file exists in the PortalServer_root/version directory.