IBM Z Hypervisor Proxies for IBM License Metric Tool (ILMT)

Introduction

In order to enable the z/VM and KVM for IBM Z hypervisors for sub-capacity pricing, IBM has created a script to manage the configuration of a virtual machine that acts as a stand in for the hypervisor. The ILMT (IBM License Metric Tool) agent in this virtual machine will recognize the signatureors on which they run, of the proxy and report its capacity. The associated reports that ILMT produces can then be used to verify that the appropriate hypervisor capacity has been licensed.

File Identifier Description
ilmt-config-sync.sh Configuation management script
ibm.com_zVM_proxy_for_ILMT-1.0.0.swidtag Software tag for z/VM proxy
licenses_zVM_proxy_for_ILMT-1.0.0.tar Licenses for zVM proxy
ibm.com_KVM_proxy_for_ILMT-1.0.0.swidtag Software tag for KVM proxy
licenses_KVM_proxy_for_ILMT-1.0.0.tartag Licenses for KVM proxy

Prerequisites

Prior to implementing a hypervisor proxy, ILMT must be ordered and installed. Click here for more information.


KVM Proxy Implementation Procedure

  1. Create a new Linux guest and configure it with 64 virtual CPUs.
  2. Install your preferred Linux distribution in the guest.
  3. Install the ILMT agent in the guest.
  4. Download file licenses_KVM_proxy_for_ILMT-1.0.0.tar and untar it to the guest's /root/licenses/ directory.
  5. Execute the following commands on the guest:
    1. mkdir -p /usr/local/bin
    2. ln -f /bin/sleep /usr/local/bin/kvm-ilmt-1
    3. (crontab -l;echo"@reboot/usr/local/bin/kvm-ilmt-1 10000d") / crontab-
  6. Download file ibm.com_KVM_proxy_for_ILMT-1.0.0.swidtag and copy it to the guest's /root/swidtag/ directory.
  7. Download file ilmt-config-sync.sh and copy it to the KVM hypervisor's /usr/local/bin.
  8. Edit file ilmt-config-sync.sh and set the value of the variable kvm_guest_name (in the first few lines) to the name of the new guest.
  9. Issue chmod 755 against file ilmt-config-sync.sh and issue ./ilmt-config-sync.sh to execute the script.

z/VM Proxy Implementation Procedure

  1. Create a new Linux guest and configure it with 64 virtual CPUs.
  2. Install your preferred Linux distribution in the guest.
  3. Install the ILMT agent in the guest.
  4. Download file ibm.com_zVM_proxy_for_ILMT-1.0.0.tar and untar it to the guest's /root/licenses/ directory.
  5. Download file licenses_zVM_proxy_for_ILMT-1.0.0.swidtag and copy it to the guest's /root/swidtag/ directory.
  6. Download file ilmt-config-sync.sh, copy it to the guest's /usr/local/bin, issue chmod 755 against file ilmt-config-sync.sh, and issue /usr/local/bin/ilmt-config-sync.sh to execute the script.

Interpreting ILMT Reports for Proxies

The capacity associated with a proxy is reported by ILMT using Processor Value Units (PVUs) and is aggregated across the enterprise. However, the z/VM and KVM for IBM Z hypervisors are not licensed on the basis of PVUs. z/VM is licensed using engine-based Value Units, while KVM for IBM Z is licensed using engines. To determine the number of licenses required, convert the PVU values it reports to engines, based on the PVU rating of the underlying hardware system or systems. The Value Unit Converter Toolmay be helpful. For z/VM, convert the number of engines to engine-based Value Units using Value Unit Exhibit 021 (VUE021)


Support

If you encounter problems or have questions about this procedure, please e-mail z Systems Hypervisor Proxy Support and include any logs or other information relevant to describing your problem.