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® sub-capacity 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.

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

1. Download the IBM License Metric Tool agent and install it on each server that has HCL Digital Experience installed.

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®, Linux™: ./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 Portal 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 Portal 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.

   Product offering / Component name	IBM Tivoli License Manager signature file	Signature file's directory path
   HCL Portal Extend Version 9.0	ibm.com_IBM_HCL Portal and HCL Web Content Manager_Extend-9.0.0.swidtag	the UserData path of the PortalServer_root/swidtag directory
   HCL Portal Enable Version 9.0	ibm.com_IBM_HCL Portal and HCL Web Content Manager_Enable-9.0.0.swidtag	the UserData path of the PortalServer_root/swidtag directory
   HCL Portal Server Version 9.0	ibm.com_IBM_HCL Portal and HCL Web Content Manager_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
   HCL PortalVersion 9.0	ibm.com_IBM_HCL Portal and HCL Web Content Manager_Express-9.0.0.swidtag	the UserData path of the PortalServer_root/swidtag directory

   Product offering / Component name	IBM Tivoli License Manager signature file	Signature file's directory path
   HCL Portal Extend Version 8.5	IBM_HCL Portal and HCL Web Content Manager_Extend.8.5.0.swtag	the UserData path of the PortalServer_root/properties/version directory
   HCL Portal Enable Version 8.5	IBM_HCL Portal and HCL Web Content Manager_Enable.8.5.0.swtag	the UserData path of the PortalServer_root/properties/version directory
   HCL Portal Server Version 8.5	IBM_HCL Portal and HCL Web Content Manager_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 Portal Version 8.5	IBM_HCL Portal and HCL Web Content Manager_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.