Hardware Management Console Readme

For use with Version 10 Release 1 Maintenance 1010 (V10R1M1010)

Updated: 1 September 2023

(C) Copyright International Business Machines Corp., 2023 All rights reserved.

Contents

These instructions contain the following information specific to the HMC V10 R1 M1010 code level

Terminology

x86 -  This term is used to reference the Intel hypervisors (KVM, VMWare, Xen) on which Virtual HMC can be installed. Note: HMC V10R1 release for x86 is not supported on bare metal (7042 hardware appliances).

ppc64 or ppc64le -
describes the Linux code that is compiled to run on Power-based servers or LPARS (Logical Partitions)




HMC V10 R1 M1010 Recovery Media - for 7063 Hardware

This package represents the Recovery image that can be used to install HMC V10 R1 M1010 on the 7063 machine type. This Recovery image can be used to upgrade to HMC V10 R1 M1010 from minimum level of HMC V9R1 + MH01857/MH01858.You can reference the Recovery image by APAR MB04288 and PTF MF68914.


Package name Size Checksum (sha1sum) APAR# PTF#
HMC_Recovery_V10R1M1010_ppc.iso
5064181760 f5499097e2fe04a95779aedcf5ade58e21fdb3bb MB04288 MF68914
Splash Panel information (or lshmc -V output)
After installing the Recovery package
"version= Version: 10
 Release: 1
 Service Pack: 1010
HMC Build level 2108131106
","base_version=V10R1
"
The updated version of this readme is available in Fix Central : https://www-945.ibm.com/support/fixcentral/



Install Notes


Upgrade notes


Enhancements and new function


General fixes

Command Line Changes

  • The chpwrmgmt and lspwrmgmt commands have been enhanced to support new power saver modes for Power10 servers.
  • The chsyscfg, lssyscfg and mksyscfg commands have been enhanced to support the Power10 processor compatibility mode.
  • The lscod and lssyscfg commands have been enhanced to support AIX Update Access Keys.
  • The lslparmigr command has been enhanced to include MSP network adapter information.
  • A new option has been added to the chhwres command to switch over all vNICs from one VIOS to other VIOSs.
  • The following commands have been added to support VIOS backup and restore: chviosbk, cpviosbk, lsviosbk, mkviosbk, rmviosbk, rstviosbk.
  • A new option has been added to the chhmcusr command to enable an HMC user that was disabled due to inactivity.
  • The following commands have been enhanced to support the addition of the user inactivity expiration property to HMC password policies: chpwdpolicy, lspwdpolicy, mkpwdpolicy.
  • The chhmcusr command has been enhanced to change the HMC default setting for the amount of time an HMC user is suspended from logging in to the HMC GUI or REST interface after reaching the maximum number of login attempts.
  • New options have been added to the chhmc and lshmc commands to set and display user-defined information, such as HMC location, for the HMC.
  • The chdatarep and lsdatarep commands have been enhanced to support data replication for groups.
  • A new option has been added to the lshmc command to display HMC secure boot settings (7063-CR2 HMC only).
  • The following commands have been updated to replace objectionable terminology.  The objectionable terminology was deprecated and removed from the command documentation, however it will still be accepted.  On ls commands, the objectionable attributes will still be output but only when specified with -F.
    • chcodpool, lscodpool: master has been replaced with controller
    • chcomgmt, lscomgmt: master has been replaced with controller
    • lsdatarep: slave has been replaced with secondary


Performance & Scale

  • With V9 R2 M950 or later, a single HMC can manage up to 48 systems & 2000 partitions across the systems being managed by HMC with minimum requirements as below
    • 16GB memory for 1-500 partitions
    • 32 GB memory for 500-2000 partitions
  • For maximum number of systems and partitions when HMC is used in combination with CMC, PowerVC, VM HA/DR, please refer to the corresponding product documentation. For other configuration requirements for Version 9 Virtual HMC Appliance, please refer to Installing the HMC virtual appliance.

Known issues and Limitations

  • System firmware cannot be updated on both BMC and FSP system types at the same time from the firmware update wizard.
  • Restoring the SSP backup on VIOS can fail at the first attempt with RMC going down. When such an issue is observed, wait for RMC to come up on its own (RSCT services on VIOS restarted on its own) and retry the restore.
  • While removing a virtual network, UI shows "Internal error" when there is a stale trunk adapter in the system. Reloading the UI or refreshing the browser should solve the issue.
  • User shall see Various Invalid Validation errors when configuring the backing device capacity for VNIC in Deploy Partition Template Wizard.
  • When configure multiple logical ports in Deploy Partition Template panel, issue can be seen with available capacity.
  • In the GUI, last RoCE logical port remains in the table view, even after removing it. Refreshing the browser should clear the table.
  • After PCM data migration from HMC 942 to 1010 level, PCM data fails to be retrieved.
  • In the Add Network wizard, moving back and forth the panels causes incorrect values to be displayed for 802.1q vlan id and load group.
  • Login fails if the Kerberos username is different from the remote user id even though password and other configurations are correct. Make sure both Kerberos user id/name is same as id/name of the remote user.
  • Rarely, following backup restore, attempts to login fails from GUI. Users will have to restart HMC to restore the access.
  • Hardware images for 78D8 and 78D6 are missing in the sysplan viewer under Hardware section in sysplan view from GUI.
  • When a Kerberos user attempts to login with an expired password an access denied message is shown instead of a password expiration message.
  • If current encryption in webui cipher is set to only one cipher TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 , HMC will not work with error as SSL_ERROR_NO_CYPHER_OVERLAP. Adding back the other removed ciphers manually will solve the problem.
  • When addressing Power Interface Card Cable related errors on System Control Unit (i.e.: U78xx.SC1.xxxxxx-P1-C1-T1; U78xx.SC1.xxxxxx-P1-C2-T1), Repair Panel (both Repair & Verify or Exchange FRU) cannot be launched from the System Control Unit end where the hardware location cannot be found. Workaround is to launch the repair panel from the System Node end.
  • The reset of an expired password of a Kerberos user is not supported in multi-realm configuration setups since release V9 R2 950. When such users try to login using GUI, they will get message as Invalid credential. Upon login from CLI, users may see below or similar messages.
    Password:
    Password expired. Change your password now.
    Current password:
    Current Password:
    Password change failed. Server message: Old password not accepted.
    Current Password:
    Password change failed. Server message: Old password not accepted.
    Current Password:
    New password:
    Retype new password:
    Password change failed. Server message: Old password not accepted.
    Circumvention: Change or reset the password first, then log into HMC.



Best Practices


Web browser requirements

Learn about the requirements your web browser must meet to monitor and control the HMC.

HMC web browser support requires HTML 2.0, JavaScript 1.0, Java™ Virtual Machine (JVM), Java Runtime Environment (JRE) Version 8 U151, and cookie support in browsers that will connect to the HMC. Contact your support personnel to assist you in determining if your browser is configured with a Java Virtual Machine. The web browser must use HTTP 1.1. If you are using a proxy server, HTTP 1.1 must be enabled for the proxy connections. Additionally, pop-ups must be enabled for all HMCs addressed in the browser if running with pop-ups disabled.

The following browsers have been tested:

Google Chrome

HMC V10 R1 M1010 supports Google Chrome Version Version 90.0.4430.93  (Official Build) (64-bit).

Mozilla Firefox

HMC V10 R1 M1010 supports Mozilla Firefox 88.0 (64-bit).

Safari

HMC V10 R1 M1010 supports Safari Version 14.1 (15611.1.21.161.5, 15611)

Microsoft Edge

HMC V10 R1 M1010 supports Version 91.0.864.48 (Official build) (64-bit)

Clearing the Browser Cache

In Microsoft Edge
  1. Open Microsoft Edge,
  2. Select Menu (3 dots icon on top right corner of the browser)
  3. Click on Settings
  4. On the left panel, under Settings, click on "Privacy, search & services".
  5. Under Clear browsing data, click on "Choose what to clear".
  6. Select "Cookies and other site data" and "Cached images and files" check box
  7. Click on “Clear now” button.

In Mozilla Firefox

1. In the top-right corner of the browser window click the menubutton
    Choose History, and then Clear Recent History.
    In time range to clear, select "Everything"
    In the Details section, select "Cookies" and "Cache"
    Click on "Clear now"
2. In the top-right corner of the browser window click the menu button
    Choose Options > Advanced > Network >
    In "Offline Web Content and User Data" section click on "Clear Now"

In Google Chrome

1. In the top-right corner of the browser window, click the Chrome menu
    Choose History.
    Click the button Clear browsing data. A dialog will appear.
    From the drop-down menu, select "the beginning of time."
    Check the boxes "Cookies, site, and plug-in data" and "Cache"
    Click the button Clear browsing data.
2. Open the following URL with the Chrome browser: chrome://appcache-internals/
    If there is an entry related to the target hmc, click the corresponding "Remove" link

Other web browser considerations

Session cookies need to be enabled in order for ASMI to work when connected to HMC remotely. The ASM proxy code saves session information and uses it.

Microsoft Edge

  1. Open Microsoft Edge
  2. Select Menu (3 dots icon on top right corner of the browser).
  3. Click on Settings  Cookies and site permissions.
  4. Under “Cookies and data stored” click on “Manage and delete cookies and site data”.
  5. Turn on “Allow sites to save and read cookie data (recommended)” to unblock cookies.

Mozilla Firefox

  1. Click Tools > Options.
  2. Click the Cookies Tab.
  3. Select Allow sites to set cookies.
    If you want to allow only specific sites, select Exceptions, and add the HMC to allow access.

BMC Browser requirements

To access local console in OpenPower environment required the following browser requirements with JRE Plugin Version 8 U144
  • Google Chrome Version 60
  • Firefox Version 52.1.2
  • Internet Explorer Version 11
  • Safari Version 10.1.2

Installing HMC in the OpenPower Environment, 7063 Machine type 

Configuring the 7063-CR1 HMC:
https://www.ibm.com/docs/en/power9?topic=rack-configuring-7063-cr1-hmc

Configuring the 7063-CR2 HMC:
https://www.ibm.com/docs/en/power9?topic=rack-configuring-7063-cr2-hmc

Pre-installation considerations, cabling, and configuration of a new 7063-CR2 Power HMC:
https://www.ibm.com/support/pages/node/6485099

Upgrading the HMC from Version to V10R1M1010
https://www.ibm.com/support/pages/node/6490357

Note: Use of an external USB 3.0 DVD device on the 7063-CR1 will require use of a y-cable connected to 2 USB ports in order to power the device properly.



Virtual HMC Installation for x86 hypervisors

Installation Images 

Download of the Power Hardware Management Virtual Appliance (vHMC) install images for x86 hypervisors are available at the Entitled Systems Support site (ESS): http://www-304.ibm.com/servers/eserver/ess/OpenServlet.wss .  You must be entitled to Product ID 5765-VHX in order to download 5765-VHX from the ESS site.

Upgrade of 5765-HMW to 5765-VHX is supported. Check the Upgrade Notes section above for further details.

Fixes, mandatory fixes and service packs for the vHMC are common to the Power Hardware management console (HMC) and will be available at IBM Fix Central.

Installation guidance for installing the vHMC into your hypervisor is found in the IBM Knowledge Center. Installation procedures may vary depending on the operating system you use and the hypervisor you use.

A feature of the vHMC is the activation engine which allows you to preconfigure the HMC Console by passing configuration information to the HMC at the first boot of the HMC, when using these images. Please look at the on-line Knowledge Center documentation on using the Activation Engine feature.

Notes for the Virtual Appliance for  x86 hypervisors
Notice: Download of the Power Hardware Management Virtual Appliance (vHMC) install images for x86 hypervisors are available at the Entitled Systems Support site (ESS): http://www-304.ibm.com/servers/eserver/ess/OpenServlet.wss . Entitlement for Product ID 5765-VHX is needed to download from the ESS site. Fixes, mandatory fixes and service packs for this product are common to the Power Hardware Management Console Appliance (HMC) and will be available from Fix Central site.
Package name Size Checksum (sha1sum)
VHMC_ESX_SHA1_V10R1M1010.tgz
5312785599
0eb218661befa589ff1b559794beded4c28759f6
VHMC_ESX_SHA256_V10R1M1010.tgz
5312785632
596e2bf360781ff775f030224ed1e4db705d7bfb
VHMC_KVM_V10R1M1010_x86.tgz
5143051517
dfcf81d2d103e21394f1c10e4479b1d2998b2f07
VHMC_XEN_V10R1M1010.tgz
5143052391
ca5231856caddcb552669b46b5af39eff6214a75


Installation methods for vHMC on x86 hypervisors
https://www.ibm.com/docs/en/power10/000V-HMC?topic=appliance-installing-hmc-virtual-x86


Virtual HMC for PowerVM LPARS

Installation Images 

Download of the Power Hardware Management Virtual Appliance (vHMC) install images are available at the Entitled Systems Support site (ESS): http://www-304.ibm.com/servers/eserver/ess/OpenServlet.wss . You must be entitled to Product ID 5765-VHP in order to download 5765-VHP from the ESS site.

Upgrade of 5765-HMB to 5765-VHP is supported. Check the Upgrade Notes section above for further details.

Fixes, mandatory fixes and service packs for the vHMC are common to the Power Hardware management console (HMC) and are available at IBM Fix Central.

The splash panel information (lshmc -V output) for the vHMC will be the same as for the HMC recovery DVD that is documented in the above description section for the 7063 Machine type.

Installation guidance for installing the vHMC into your hypervisor are found in the Online Knowledge Center. Installation procedures may vary depending on the operating system you use and the hypervisor you use. 

Notes for the Virtual Appliance for PowerVM :
Notice: Download of the Power Hardware Management Virtual Appliance (vHMC) install images are available at the Entitled Systems Support site (ESS): http://www-304.ibm.com/servers/eserver/ess/OpenServlet.wss . Entitlement for Product ID 5765-VHP is needed to download from the ESS site. Fixes, mandatory fixes and service packs for this product are common to the Power Hardware Management Console Appliance (HMC) and will be available from Fix Central site.
Package name Size Checksum (sha1sum)
VHMC_PPC_LPAR_V10R1M1010_1.iso
5112995150
c0d7c06103a8090a3ee792962fdeab60698e82ea


Installation of vHMC for LPARs:
https://www.ibm.com/docs/en/power10/000V-HMC?topic=power-installing-hmc-virtual-appliance-powervm-logical-partition


General Virtual HMC notes


National Language Support (Supported languages)

Languages

Locales

English

en_US,en_AU,en_BE,en_BE@preeuro,en_CA,en_GB,en_GB@euro,en_HK,en_IE,en_IE@preeuro,en_IN,en_NZ,en_PH,en_PK,en_SG,en_ZA

Catalan

ca_ES, ca_ES@preeuro

German

de_DE, de_DE@preeuro, de_CH, de_AT, de_AT@preeuro, de_LU, de_LU@preeuro

French

fr_FR, fr_FR.UTF-8, fr_CH, fr_CA, fr_BE, fr_BE@preeuro, fr_LU, fr_LU@preeuro

Italian

it_IT, it_IT@preeuro, it_CH

Spanish

es_ES, es_ES@preeuro, es_AR, es_BO, es_CL, es_CO, es_CR, es_DO, es_EC,es_SV, es_GT, es_HN, es_MX, es_NI, es_PA, es_PY,es_PE, es_PR, es_US, es_UY,es_VE

Brazilian Portuguese

pt_BR

Portugal Portuguese

pt_PT, pt_PT@preeuro

Polish

pl_PL, pl_PL.UTF-8, pl_PL@euro,pl_PL@preeuro

Japanese

Ja_JP

Simplified Chinese

zh_CN, zh_SG

Traditional Chinese

zh_TW, zh_HK

Korean

ko_KR

Hungarian

hu_HU, hu_HU.UTF-8,hu_HU@euro,hu_HU@preeuro

Dutch

nl_NL, nl_NL@preeuro, nl_BE, nl_BE@preeuro

Russian

ru_RU

Czech

cs_CZ, cs_CZ.UTF-8,cs_CZ@euro,cs_CZ@preeuro

Slovakian

sk_SK, sk_SK.UTF-8,sk_SK@euro,sk_SK@preeuro


Copyright and Trademark Information

http://www.ibm.com/legal/copytrade.shtml

Notices


This information was developed for products and services offered in the US.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan
 
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
 
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk.
 
IBM may use or distribute any of the information you provide in any way it believes appropriate without incurring any obligation to you.
 
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
 
IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
 
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

The performance data and client examples cited are presented for illustrative purposes only. Actual performance results may vary depending on specific configurations and operating conditions.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

Statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to actual people or business enterprises is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Each copy or any portion of these sample programs or any derivative work must include a copyright notice as follows:

© (your company name) (year).
Portions of this code are derived from IBM Corp. Sample Programs.
© Copyright IBM Corp. _enter the year or years_.
 
If you are viewing this information in softcopy, the photographs and color illustrations may not appear.

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml.
 
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
 
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft is a trademarks of Microsoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Back to top