IBM Support

How to Avoid PowerHA Licensing Errors by Being Compliant

Troubleshooting


Problem

Attempting to use PowerHA commands and encountering various licensing error messages.
Common licensing messages for PowerHA (5770HAS) are:
CPF9E18 Message . . . . :   Attempt made to exceed usage limit for product 5770HAS. User not added.
CPF9E72 Message text . . . . . . . . :   Usage limit of 1 exceeded. Grace period expires in 70 days on (some date in the future).
CPF9E71 Message text . . . . . . . . :   Grace period expired. Requesting user not added.
HAE0047 Message text . . . . . . . . :   No valid license for IBM PowerHA for i found.

Resolving The Problem

PowerHA  does it's license checking with the highest ranking installed option for 5770HAS versions R720 (skip shipped R730) and R740. 
For example, if the only license key available is for the 5052 license, but 5051 and 5052 are installed, PowerHA would be checking 5051 for a license key regardless of the function level needing to be used.
Verify that the license key for all required features of 5770HAS is correct and added.
The *BASE product option for 5770HAS, feature 5050 is IBM PowerHA for i Standard Edition.
Product Option 1 for 5770HAS is PowerHA for i Enterprise Edition, feature code 5051.   Requires a valid license key for 5051.
Product Option 2 for 5770HAS is PowerHA for i Standard Edition, feature code 5052.  Requires a valid license key for 5052.
Product Option 3 for 5770HAS is PowerHA for i Express Edition, feature code 5053.  Requires a valid license key for 5053.
*NOTE - When PowerHA is purchased for Enterprise Edition, it is required to purchase both Standard and Enterprise Editions.
License keys can be checked at the Entitled Software Support Web site. Check the current usage limit for the license keys on this site or by using WRKLICINF.


Another common cause on an HMC-managed system, the processor usage on the system exceeds the usage limit for the license key. Check the HMC profile, and ensure that the processor usage does not exceed the usage limit of the license key. It may be necessary to cap the processor use or set up a shared processor pool to limit the usage. The following document provides information on shared processor pools, Configuring Shared Processor Pools for Use with Operating System Licensing Rules.
The following provides an example to check a system for PowerHA compliance.
Step 1) Use the command QSYS/WRKLICINF OUTPUT(*PRINT) which provides how many processors are allowed for the current license of PowerHA. In the following example, products 5770HAS 5051 and 5770HAS 5052 have a usage limit of 1 processor (Usage Limit). 
The 5770HAS license usage limit should be the same number as the current usage count (or higher) being used by 5770SS1 in order to avoid errors.  Ideally the 5770SS1 and 5770HAS Usage Limit counts would be the same.
          License                                             Usage  Usage  Peak
Product   Terms    Feature  Description                       Limit  Count  Usage
5770SS1   Vx       5051     IBMi                                8    2.00    5.00
5770HAS   VxRxMx   5051     PowerHA for i Enterprise Edition    1     .00    1.00
5770HAS   VxRxMx   5052     PowerHA for i Standard Edition      1     .00     .00
Step 2) Run command CALL QSYS/QLZARCAPI. The command shows the system's processor usage. After the command is initiated, display the job log. The following example shows the entitled processing capacity is 1.80 and online virtual processors is 2. The system is not in compliance to use PowerHA since 5770HAS only has 1 usage limit.
SYSTEM INFO -> SYSTEM SERIAL NUMBER: 11-1111R  . SYSTEM TYPE-MODEL: 8286-
  42A. PROCESSOR FEATURE CODE: EPXH. PROCESSOR GROUP:  P20. MAX PHYSICAL 
  PROCS IN SYSTEM: 24. CONFIGURABLE PROCS IN SYSTEM: 24.                 
PARTITION INFO -> NETWORK NAME: TESTSYS. PARTITION NAME:                
  TESTSYS. PARTITION ID: 18. SHARING TYPE: SHARED.  
  SHARING MODE: UNCAPPED
. MIN PROCESSING CAPACITY: 0.10. DESIRED         
  PROCESSING UNITS: 1.80. MAX PROCESSING CAPACITY: 5.00. ENTITLED        
  PROCESSING CAPACITY: 1.80
. MIN VIRTUAL PROCESSORS: 1. DESIRED VIRTUAL  
  PROCESSORS: 2. MAX VIRTUAL PROCESSORS: 5. ONLINE VIRTUAL PROCESSORS: 2 
PROCESSOR POOL INFO -> NUMBER OF VIRTUAL PROCESSOR POOLS CONFIGURED: 2.  
  CURRENT PROCESSOR POOL ID: 1. MAXIMUM PROCESSING UNITS FOR PROCESSOR   
  POOL 1: 8. 
For the latest compliance information on PowerHA, visit Software Licensing & Compliance Information

[{"Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CGgAAM","label":"High Availability"}],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Type":"MASTER"}]

Historical Number

641191485

Document Information

Modified date:
22 March 2023

UID

nas8N1010856