Tracking license usage in VMs by using IBM License Metric Tool

You can track your WebSphere Automation VPC usage in virtual machines (VMs) by using the IBM License Metric Tool, which uses software identification tags to detect the software installed in your environment. An IBM software identification tag (also known as a swidtag) is an XML file that is included in the relevant IBM product package and deployed by the product installer.

About this task

The IBM License Metric Tool automatically detects the chargeable components that are part of IBM WebSphere Automation.

The following list shows the chargeable software components for WebSphere Automation 1.11.0.

IBM WebSphere Automation 1.11.0
IBM WebSphere Application Server Liberty Core for ISVs 21.0
IBM WebSphere Application Server Liberty 24.0
IBM WebSphere Application Server Liberty 23.0
IBM WebSphere Application Server Liberty 22.0
IBM WebSphere Application Server Liberty 21.0
IBM WebSphere Application Server Liberty 20.0
IBM WebSphere Application Server Liberty 19.0
IBM WebSphere Application Server Liberty 18.0
CC001591 IBM WebSphere Application Server 9.0
CC001592 IBM WebSphere Application Server Network Deployment 9.0
CC001592 IBM WebSphere Application Server Network Deployment 8.5
CC013056 IBM WebSphere Application Server Liberty Core 24.0
CC013056 IBM WebSphere Application Server Liberty Core 23.0
CC013056 IBM WebSphere Application Server Liberty Core 20.0
IBM WebSphere Application Server Liberty Core for ISVs 19.0
CC001591 IBM WebSphere Application Server 8.5
CC013056 IBM WebSphere Application Server Liberty Core 18.0
IBM WebSphere Application Server Liberty ILAN 25.0
IBM WebSphere Application Server Liberty for z/OS 25.0
IBM WebSphere Application Server Liberty for z/OS 20.0
IBM WebSphere Application Server Liberty for z/OS 18.0
CC001294 IBM WebSphere Application Server - Express 8.5
IBM WebSphere Application Server for z/OS 9.0
IBM WebSphere Application Server for z/OS 8.5
CC013056 WebSphere Application Server Liberty Core 25.0
CC013056 WebSphere Application Server Liberty Core 22.0
IBM WebSphere Application Server Liberty ILAN 18.0
IBM WebSphere Application Server Liberty for z/OS 19.0
IBM WebSphere Application Server Liberty Core for ISVs 24.0
IBM WebSphere Application Server Liberty ILAN 24.0
IBM WebSphere Application Server Liberty ILAN 23.0
IBM WebSphere Application Server Liberty ILAN 22.0
IBM WebSphere Application Server Liberty Core for ISVs 20.0
IBM WebSphere Application Server Liberty ILAN 21.0
IBM WebSphere Application Server Liberty ILAN 20.0
IBM WebSphere Application Server Liberty ILAN 19.0
CC001368 IBM WebSphere Application Server for Developers 8.5
IBM WebSphere Application Server ILAN 9.0
CC013056 IBM WebSphere Application Server Liberty Core 21.0
CC013056 IBM WebSphere Application Server Liberty Core 19.0
IBM WebSphere Application Server Liberty for z/OS 23.0
IBM WebSphere Application Server Liberty for z/OS 22.0
IBM WebSphere Application Server Liberty for z/OS 21.0
IBM WebSphere Application Server Liberty 25.0
IBM WebSphere Application Server Liberty Core for ISVs 25.0
IBM WebSphere Application Server Liberty Network Deployment 18.0
IBM WebSphere Application Server Liberty Network Deployment 25.0
IBM WebSphere Application Server Liberty Core for ISVs 18.0
IBM WebSphere Application Server Liberty for z/OS 24.0
IBM WebSphere Application Server Liberty Network Deployment 24.0

The IBM License Metric Tool can calculate VPC consumption only when software identification tags exist and are activated by the customer. For IBM License Metric Tool to detect and start tracking license usage in VMs, the customer must manually copy the WebSphere Automation software identification tag to the appropriate location on the file system.

The following table provides the software identification tag information for WebSphere Automation.

Product name	Version	Software identification tag for WebSphere Automation
IBM WebSphere Automation	1.11.0	`ibm.com_IBM_WebSphere_Automation-1.11.0.swidtag`
IBM WebSphere Automation	1.10.0	`ibm.com_IBM_WebSphere_Automation-1.10.0.swidtag`
IBM WebSphere Automation	1.9.0	`ibm.com_IBM_WebSphere_Automation-1.9.0.swidtag`
IBM WebSphere Automation	1.8.2	`ibm.com_IBM_WebSphere_Automation-1.8.2.swidtag`
IBM WebSphere Automation	1.8.1	`ibm.com_IBM_WebSphere_Automation-1.8.1.swidtag`

Tip: When installing, or when upgrading WebSphere Automation to a different version, make sure no tags related to older versions of WebSphere Automation are present. Search for file extensions *.sys, *.sys2, *swtag, and *.swidtag.

Ensure that your search returns only tags that identify the currently installed version. Remove any other software identification tags.

Contents of the *.swidtag file of each applicable WebSphere Automation version are listed as following:

1.11.0
1.10.0
1.9.0
1.8.2
1.8.1

Contents of the ibm.com_IBM_WebSphere_Automation-1.11.0.swidtag file:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<SoftwareIdentity xmlns="http://standards.iso.org/iso/19770/-2/2015/schema.xsd" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="IBM WebSphere Automation" tagId="ibm.com-c2b4e5044cf947fcad2d5fb953cd44a4-1.11.0" version="1.11.0" versionScheme="multipartnumeric" xml:lang="en" xsi:schemaLocation="http://standards.iso.org/iso/19770/-2/2015-current/schema.xsd schema.xsd">
    <Meta persistentId="c2b4e5044cf947fcad2d5fb953cd44a4"/>
    <Meta generator="4-1-20210113"/>
    <Entity name="IBM" regid="ibm.com" role="licensor tagCreator softwareCreator"/>
</SoftwareIdentity>

Contents of the ibm.com_IBM_WebSphere_Automation-1.10.0.swidtag file:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<SoftwareIdentity xmlns="http://standards.iso.org/iso/19770/-2/2015/schema.xsd" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="IBM WebSphere Automation" tagId="ibm.com-c2b4e5044cf947fcad2d5fb953cd44a4-1.10.0" version="1.10.0" versionScheme="multipartnumeric" xml:lang="en" xsi:schemaLocation="http://standards.iso.org/iso/19770/-2/2015-current/schema.xsd schema.xsd">
    <Meta persistentId="c2b4e5044cf947fcad2d5fb953cd44a4"/>
    <Meta generator="4-1-20210113"/>
    <Entity name="IBM" regid="ibm.com" role="licensor tagCreator softwareCreator"/>
</SoftwareIdentity>

Contents of the ibm.com_IBM_WebSphere_Automation-1.9.0.swidtag file:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<SoftwareIdentity xmlns="http://standards.iso.org/iso/19770/-2/2015/schema.xsd" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="IBM WebSphere Automation" tagId="ibm.com-c2b4e5044cf947fcad2d5fb953cd44a4-1.9.0" version="1.9.0" versionScheme="multipartnumeric" xml:lang="en" xsi:schemaLocation="http://standards.iso.org/iso/19770/-2/2015-current/schema.xsd schema.xsd">
    <Meta persistentId="c2b4e5044cf947fcad2d5fb953cd44a4"/>
    <Meta generator="4-1-20210113"/>
    <Entity name="IBM" regid="ibm.com" role="licensor tagCreator softwareCreator"/>
</SoftwareIdentity>

Contents of the ibm.com_IBM_WebSphere_Automation-1.8.2.swidtag file:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<SoftwareIdentity xmlns="http://standards.iso.org/iso/19770/-2/2015/schema.xsd" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="IBM WebSphere Automation" tagId="ibm.com-c2b4e5044cf947fcad2d5fb953cd44a4-1.8.2" version="1.8.2" versionScheme="multipartnumeric" xml:lang="en" xsi:schemaLocation="http://standards.iso.org/iso/19770/-2/2015-current/schema.xsd schema.xsd">
    <Meta persistentId="c2b4e5044cf947fcad2d5fb953cd44a4"/>
    <Meta generator="4-1-20210113"/>
    <Entity name="IBM" regid="ibm.com" role="licensor tagCreator softwareCreator"/>
</SoftwareIdentity>

Contents of the ibm.com_IBM_WebSphere_Automation-1.8.1.swidtag file:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<SoftwareIdentity xmlns="http://standards.iso.org/iso/19770/-2/2015/schema.xsd" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="IBM WebSphere Automation" tagId="ibm.com-c2b4e5044cf947fcad2d5fb953cd44a4-1.8.1" version="1.8.1" versionScheme="multipartnumeric" xml:lang="en" xsi:schemaLocation="http://standards.iso.org/iso/19770/-2/2015-current/schema.xsd schema.xsd">
    <Meta persistentId="c2b4e5044cf947fcad2d5fb953cd44a4"/>
    <Meta generator="4-1-20210113"/>
    <Entity name="IBM" regid="ibm.com" role="licensor tagCreator softwareCreator"/>
</SoftwareIdentity>

CAUTION:

Do not change the name or content of the software identification tag. IBM License Metric Tool uses file names to discover the product.

Procedure

Identify the VMs or servers with the WebSphere Application Server instances that are managed by WebSphere Automation.
Download the swidtag file using the name and contents previously mentioned. The extension of the file must be .swidtag.
Place the software identification tag in the product installation directory. For example:
```
<COMPONENT_ROOT>/swidtag/
```
<COMPONENT_ROOT> is the location where the software component is installed.
Each instance of a software identification tag that is detected on a system is reported by IBM License Metric Tool as a separate installation of your software component.
Deploy the IBM License Metric Tool agent on each VM that was identified in step 1.
In IBM License Metric Tool, scan the managed VMs or server file systems for gathering capacity data. In the IBM License Metric Tool Software Classification report, you receive a list of VMs or servers where the WebSphere Automation software identification tag is discovered. You can review the IBM License Metric Tool assignments and update them as needed. To verify that components are assigned correctly, refer to https://www.ibm.com/docs/en/license-metric-tool?topic=classification-assigning-components-products-cloud-paks.
After you confirm the WebSphere Automation software classifications in the IBM License Metric Tool, it will provide the related VPC license usage consumption for WebSphere Automation.