IBM Support

Model 7063 and vHMC for PowerVM: Upgrading the HMC from Version V9R1 or V9R2 to V10R1M1010

Troubleshooting


Problem

This document provides instructions to upgrade vHMC for PowerVM and HMC 7063 machine type from Version 9 Release 1 with mandatory fix MH01858, or V9R2M950 to V10R1M1010.

Environment

Power HMC 7063-CR1 (ppc)
Power HMC 7063-CR2 (ppc)
vHMC for PowerVM Product ID 5765-VHP

Diagnosing The Problem

These instructions apply to ppc based HMCs (model 7063 or vHMC on POWER). They are not intended for x86 based vHMC.

Resolving The Problem

Prerequisites
Before upgrading, complete the following:

1. Verify HMC model is compatible with V10R1M1010

HMC V10 R10 M1010 supports the following HMC models:

  • Open Power : 7063-CR1
  • Open Power : 7063-CR2
  • (vhmc) PowerVM  Power 8, Power 9 and Power 10
2. The minimum HMC levels required to upgrade to HMC V10 R1 M1010 are:
  • HMC V9 R2 M950
  • HMC V9 R1 M910 with mandatory fix MH01858
3. HMC V10 R1 M1010 provides support for managing Power10, Power9, and Power8 processor based systems.
  • POWER7 and older servers are not supported by HMC V10 R1 M1010. Attempts to manage POWER7 and older servers will result in a connection state of Version Mismatch and connection_error_code "Connection not allowed 0009-0008-00000000".
4. HMC V10 R1 M1010 does not support 7042 models.
5. If two HMC's manage the same server, both HMC's must be at the same version, release, and maintenance level.
 When upgrading multiple HMCs that are part of a Power Enterprise Pool (PEP) from 9.1.0 or 9.2.950 to V10R1M1010, it is recommended to upgrade a backup HMC first. Next set the upgraded HMC as the primary, then upgrade the previous primary. This ensures a primary is always available.
After one HMC is upgraded the servers on the redundant HMC can go to a "Version Mismatch" state, with reference code "Save area version mismatch". This state clears when the redundant HMC is upgraded.
6. Review/repair and close all service events
7.  Review the readme file
Please review all additional "upgrade notes" found in the V10 R1 M1010 release notes.  The readme file release notes for HMC V10 R1 M101 Recovery Media can be found in IBM Fix Central at https://download4.boulder.ibm.com/sar/CMA/HMA/09zzf/0/MF68914.readme.html
8. Reboot the HMC

If the HMC has not been restarted recently, you should restart before you begin the upgrade. To reboot, either:
- Use the GUI task HMC Management > Console Management > Shut Down or restart the Management Console > restart HMC then click OK.
OR
- Use the CLI hmcshutdown -r -t now

 NETWORK UPGRADE
 

Instructions for upgrading from a network server
This section describes how to perform the upgrade over the network instead of from Recovery DVD. The network upgrade can be done using FTP, sftp or nfs protocol. If the HMC does not have direct internet access the network upgrade files can be staged on a local server (see "Using a local server" below).

Restricted Shell Access

This upgrade method requires restricted shell command-line access.

From the local HMC, select HMC Management > Console Management > Open a Restricted Shell Terminal

From a remote location, restricted shell is available through the ssh protocol. For information on how to access HMC command line remotely see https://www.ibm.com/support/pages/node/667941
 Step 1: Save Profile Data

Perform a Save Profile Data for each managed system to save an additional copy of partition/profile configurations. For dual HMCs managing the same server this step is only needed on the upgrade of the first HMC. It cannot be run on HMC with a server in "version mismatch - save area version mismatch" state.
At the command prompt, enter the following command tol save profile data for all servers:
lssyscfg -r sys -F type_model*serial_num | while read machine; do bkprofdata -m "$machine" -f Beforeupgrade$(date +%Y%m%d) ; done
Step 2: Save Upgrade Data

A Save Upgrade Data task must be done to preserve information on the HMC before performing the upgrade. You must upgrade immediately after the Save Upgrade Data task. If you restart the HMC again without doing the upgrade, you must log in and run the Save Upgrade Data task (to hard disk) again before performing the upgrade. If your not using a USB, run the command saveupgdata -r disk then skip to Step 3.

 
a. Prepare media to use for Save Upgrade Data. You will need a USB flash drive.

USB flash drive must be formatted FAT32 with a single partition and it cannot be password protected. Plug the flash drive into a USB port on the front of the HMC. Wait until you hear 3 beeps (or approximately 1 minute) for the HMC to detect the flash drive.

Note: Save Upgrade Data will overwrite any existing save upgrade data on the media. It will not overwrite any backup Management Console Data already on the media.
 
b. Use the following command specifying "diskusb" for USB flash drive.
saveupgdata -r diskusb.
 
c. Wait for the Save Upgrade Data task to complete. If the task fails, contact your next level of support before proceeding. If the Save Upgrade Data task is successful, the following optional procedure can be performed to verify the data:

1. Mount the media:

Run the command lsmediadev to determine the mount point of the USB flash drive. In the example below, USB flash drive is /media/sda1
device=/dev/cdrom,mount_point=/media/cdrom,type=1,description=CD/DVD
device=/dev/fd0,mount_point=/media/floppy,type=2,description=internal diskette drive
device=/dev/hda,type=6,description=internal hard disk drive
device=/dev/sda1,mount_point=/media/sda1,type=3,description=USB flash memory device


Run the command mount (for example, mount /media/sda1 for USB flash drive)

2. Run the command ls –l using the same mount point as in Step 1 above. - "Example" ls -l /media/sda1

3. Verify that there are five tar files with the following names:

ACMSaveData.tar
RSCTSaveUpgrade.tar
SaveCCFWUpgradeData.tar
SaveHSCSystemUpgradeData.tar
SaveProfileDataUpgrade.tar

If any of these tar files are missing, contact your next level of support.

4. Issue the command umount using the same mount point as in Step 1 above.

Note: The Save Upgrade Data will be saved to the hard disk drive on the HMC as well as the media. The Save Upgrade Data on the media is used only to recover from an unexpected error under the direction of support personnel.

 
d.
Once the Save Upgrade Data task is successful, remove the USB flash drive.
Step 3: Upgrade the HMC to V10 R1 M1010
 
a.
Download the V10 V1 M1010 network upgrade files to the HMC.
**To upgrade from a local server instead of direct from the IBM FTP site, refer to "Using a local server" section at the bottom of this page.

Open Restricted Shell (or ssh session) and type the following command:

getupgfiles -h public.dhe.ibm.com -u anonymous --passwd anonymous -d /software/server/hmc/network/v1010/ppc
 
Alternate site - getupgfiles -h service.boulder.ibm.com -u anonymous --passwd anonymous -d /software/server/hmc/network/v1010/ppc

The parameters of the getupgfiles command:
-h The host name or IP address of the remote FTP server.
-u The user ID to log in to the remote site.
--passwd The password to log in to the remote site. If this option is omitted, you will be prompted for the password.
-d The directory on the remote site that contains the upgrade files.

The following files will be downloaded to the directory indicated:
File name Description Destination Size KB BSD Checksum
img2a kernel image /hmcboot 27815 18867
img3a Ram Disk file system /hmcboot 77346 10405
base.img Base Image /hmcboot 1341004 18255
disk1.img Base HMC Image and Service Doc /hmcdump 3465110 40619
hmcnetworkfiles.sum checksums /hmcdump 1 n/a

While the download is running, there is no indication of progress in the restricted shell. To monitor progress, open another restricted shell session and monitor the files and file sizes. For example the following command will loop indefinitely querying the file sizes every 30 seconds: while true; do ls -l /hmcdump ; ls -l /hmcboot ; sleep 30; done (Use ctl+c to end).
Once the files have all been downloaded successfully, the getupgfiles command returns to the command prompt and the ls -l command will no longer list the files in the directory as the target directories are unmounted.
 
b.
Set the HMC to do the next reboot from the special location on the hard disk where the downloaded V9 files are stored by typing the following command:

chhmc -c altdiskboot -s enable --mode upgrade

Note: Remove any USB flash drive that contains HMC backup Management Console Data before performing a network upgrade. Failure to remove the drive will result in failed network upgrade.
c.
Reboot the HMC using one of the following methods:

Option 1. HMC GUI: HMC Management > Console Management > Shut Down or restart the Management Console > restart HMC then click OK
Option 2. Restricted shell command: hmcshutdown -t now -r

Note: The initial reboot can take 30-45 minutes. Do not reboot or power off; wait for the boot to complete.
 
Once the HMC reboots, (the Petitboot screen should appear and you may need to arrow up and wait a bit for the Install from alternate disk option) then installation starts and typically takes about an hour. After the installation of V10R1M1010 is complete, you should be able to remotely access the HMC again.
d. At the Hardware Management Console login prompt, log in using your user ID and password.
Optional: Using a local server

1. Use FTP to do a binary download of the upgrade files from the IBM server to a directory on a local server:

IBM Server: public.dhe.ibm.com/software/server/hmc/network/v1010/ppc
Files:
img2a
img3a
base.img
disk1.img
hmcnetworkfiles.sum

2. Verify the download Use a BSD checksum tool to verify that the checksum of each file matches the expected checksum documented in the table above.
3. Perform the upgrade as described above. However, in Step 1, modify the getupgfiles command to point to your local FTP server. For example:

getupgfiles -h myserver -u myuserid --passwd mypassword -d /mydirectory
 
** An alternative method using remote FTP server, is to go to Fix Central, select MF68914 HMC Recovery V10R1M1010 for 7063 Machine Type, click continue, sign in, and if the download method is set to HTTPS, select the V10R1_network_images_ppc.zip file, and download that. Put the zip file on your FTP server and unzip it. Use the folder path to do the upgrade, getupgfiles -h myserver -u myuserid --passwd mypassword -d /mydirectory
 

DVD

Instructions for upgrading from DVD media (DVD should be DVD+R DL)

This section shows how to use the BMC console viewer to upgrade using a remote virtual DVD. An external USB DVD drive can be used instead of remote virtual media. You may need to connect the USB DVD drive to an external power source (7063-CR1) or use a USB Y cable to connect to an extra USB port to provide sufficient power to the DVD drive.

Step 1: Download the Recovery DVD image Download the HMC Version 10R1M1010 Recovery DVD: HMC_Recovery_V10R1M1010_ppc.iso
External USB DVD drive: Burn the .iso as an image to DVD+R DL media.  (This recovery media MF68914 cannot be ordered)

Step 2: Save Profile Data
Use one of the following options to perform a Save Profile Data for each managed system to save an additional copy of partition/profile configurations.
For dual HMCs managing the same server this step is only needed on the upgrade of the first HMC. It cannot be run on HMC with a server in "version mismatch - save area version mismatch" state.
Option 1: Use HMC GUI interface
a. Expand Resources, then All Systems
b. Select the first managed system by checking the box in front of the server name.
c. Under Actions select View All Actions > Legacy > Manage Partition Data > Backup.
d. In the Profile Data backup window, type a name for the backup file, and click OK.
e. You will get a popup window that the profile data has been backed up. Click OK.
Repeat a through e for each additional system managed by this HMC. Once you have a partition data backup for each managed system, continue with Step 3.
 
Option 2: Use restricted shell command line

At the command prompt, enter the following command which will save profile data for all servers:
lssyscfg -r sys -F type_model*serial_num | while read machine; do bkprofdata -m "$machine" -f Beforeupgrade$(date +%Y%m%d) ; done

Step 3: Save Upgrade Data

A Save Upgrade Data task must be done to preserve information on the HMC before performing the upgrade. You must upgrade immediately after the Save Upgrade Data task. If you restart the HMC again without doing the upgrade, you must log in and run the Save Upgrade Data task again before performing the upgrade.
a. Prepare media to use for Save Upgrade Data. You will need a USB flash drive.

USB flash drive must be formatted FAT32 with a single partition and it cannot be password protected. Plug the flash drive into a USB port on the front of the HMC. Wait until you hear 3 beeps (or approximately 1 minute) for the HMC to detect the flash drive.

Note: Save Upgrade Data will overwrite any existing save upgrade data on the media. It will not overwrite any backup Management Console Data already on the media.
 
b. Save Upgrade Data can be performed using either HMC GUI or restricted shell command line.

Use the HMC GUI:
1) Select HMC Management. > Console Management
2) Select Save Upgrade Data.
3) Select media type USB flash drive, click Next, and then click Finish.

Use restricted shell command line:
Run the following command specifying "diskusb" for USB flash drive:
saveupgdata -r diskusb
 
c. Wait for the Save Upgrade Data task to complete. If the task fails, contact your next level of support before proceeding. If the Save Upgrade Data task is successful, the following optional procedure can be performed to verify the data:

1. Open a restricted shell terminal

Local HMC: Select HMC Management > Console Management > Open a Restricted Shell Terminal
Remotely: Log in via ssh.

2. Mount the media:

a. Run the command lsmediadev to determine the mount point of the USB flash drive. In the example below, USB flash drive is /media/sda1
device=/dev/cdrom,mount_point=/media/cdrom,type=1,description=CD/DVD
device=/dev/fd0,mount_point=/media/floppy,type=2,description=internal diskette drive
device=/dev/hda,type=6,description=internal hard disk drive
device=/dev/sda1,mount_point=/media/sda1,type=3,description=USB flash memory device


b. Run the command mount (for example, mount /media/sda1 for USB flash drive)

3. Run the command ls –l using the same mount point as in Step b above. - "Example" ls -l /media/sda1

4. Verify that there are five tar files with the following names:

ACMSaveData.tar
RSCTSaveUpgrade.tar
SaveCCFWUpgradeData.tar
SaveHSCSystemUpgradeData.tar
SaveProfileDataUpgrade.tar

If any of these tar files are missing, contact your next level of support.

5. Issue the command umount using the same mount point as in Step b above.


 
4. Once the Save Upgrade Data task is successful, remove the USB flash drive.

Step 4: Upgrade HMC to V10R1M1010 (from Recovery DVD)
 
a.
Load the Recovery DVD
External USB DVD drive
1. Insert the USB drive (external power or Y-cable required 7063-CR1)
2. Insert the Recovery DVD into the drive.
3. Reboot the HMC
4. Select the option to Upgrade
BMC Virtual Media
(Remote user) For 7063-CR1
BMC Virtual media
Mount the iso image using BMC remote virtual media.
1. Log in to the BMC web interface (https://). Default login is ADMIN/ADMIN.
2. Select Remote Control.
3. Select Console Redirection.
4. Click Launch Console. Accept any Java prompts.
5. In the Java™ iKVM Viewer, select Virtual Media > Virtual Storage.

6. Under Logical Drive Type, select ISO File.
7. Click Open Image and locate the Recovery ISO file on your system.
8. Press plug-in to mount the ISO file.
The rest of the instructions would be the same for Virtual Image, just select it from the Petitboot menu.
 
b. Reboot the HMC.
Click HMC Management > Console Management, then click the Shutdown or restart menu option Select restart HMC and click OK.
 
c.

At the Petitboot panel cursor up to halt the automatic boot. 

image-20180807114044-1

d.

Wait for the CD/DVD device to appear in the boot list (this may take up to a minute). 

Note:  If the device does not automatically appear within in one minute, select Rescan devices and hit enter to rescan.

After the CD/DVD option appears, cursor up to select the Install Hardware Management Console option that is located under CD/DVD. Press enter.

e. The HMC reads the media in the drive and displays the Hardware Management Console Install Wizard window. Highlight Next button (use tab/alt-Tab or arrow keys to move), and press Space bar or Enter to select.

Note: If the Save Upgrade Data (Step 3 above) was not performed, you will see a warning window that save upgrade data was not found on the hard disk. Cancel the upgrade, remove the recovery media from the DVD drive, reboot the HMC, complete Step 3 above to Save Upgrade Data, then start the upgrade process again.
 
f. Using tab or arrow keys to move the cursor and the space bar to select an option, select Upgrade to a new version (need asterisk on Upgrade to a new release as shown below):

( * ) Upgrade to a new version
( ) Install

Highlight Next button, and press Enter.

Note: If the Save Upgrade Data (Step 3 above) was not performed, you will see a warning window that save upgrade data was not found on the hard disk drive. Cancel the upgrade, remove the recovery media from the DVD drive, reboot the HMC, complete Step 3 above to Save Upgrade Data, then start the upgrade process again.
 
g. On Upgrade Confirmation screen, highlight Finish and press Enter to start the Upgrade process.
 
h. The HMC installs V9R2M950 from the media, restores the data preserved by the Save Upgrade Data task, and then completes the booting process.
Note: The initial reboot can take 30-45 minutes. Do not reboot or power off; wait for the boot to complete.
 
i. Select "Log on and launch the Hardware Management Console web application", then log in using your user ID and password.
 
For 7063-CR2
BMC Virtual media
Mount the iso image using BMC remote virtual media.
1. Log in to the BMC web interface (https:// ). Default login is root/OpenBmc.
2. Select Server Control.
3. Select Virtual Media
4. Choose File, and go select the iso file.
5. Click Start
image 11517
Wait for the DVD to show up in the Petitboot menu, then arrow up to select it. See screen shots for this under the 7063-CR1 section.
When you get the menu to Install or Upgrade, you need to use your arrow keys to select Upgrade, and enter.
The Upgrade can take an hour or so.

USB Flash

Instructions for downloading the image and upgrading from USB media

Step 1: Obtain HMC V10R1M1010 .iso image

a. Download the HMC Version V10R1M1010 Recovery iso:
b. Use this link to create a bootable USB https://www.ibm.com/support/pages/node/6454883
(This is the supported method to create a bootable USB. Other applications have failed to work at this time.)

Step 2: Save Profile Data

Use one of the following options to perform a Save Profile Data for each managed system to save an additional copy of partition/profile configurations.
For dual HMCs managing the same server this step is only needed on the upgrade of the first HMC. It cannot be run on HMC with a server in "version mismatch - save area version mismatch" state.
Option 1: Use HMC GUI interface
a. Expand Resources, then All Systems
b. Select the first managed system by checking the box in front of the server name.
c. Under Actions select View All Actions > Legacy > Manage Partition Data > Backup.
d. In the Profile Data backup window, type a name for the backup file, and click OK.
e. You will get a popup window that the profile data has been backed up. Click OK.
Repeat a through e for each additional system managed by this HMC. Once you have a partition data backup for each managed system, continue with Step 3.

Option 2: Use restricted shell command line

At the command prompt, enter the following command which will save profile data for all servers:
lssyscfg -r sys -F type_model*serial_num | while read machine; do bkprofdata -m "$machine" -f Beforeupgrade$(date +%Y%m%d) ; done

Step 3: Save Upgrade Data

A Save Upgrade Data task must be done to preserve information on the HMC before performing the upgrade. You must upgrade immediately after the Save Upgrade Data task. If you restart the HMC again without doing the upgrade, you must log in and run the Save Upgrade Data task again before performing the upgrade.
 
a. Prepare media to use for Save Upgrade Data. You will need a USB flash drive.

USB flash drive must be formatted FAT32 with a single partition and it cannot be password protected. Plug the flash drive into a USB port on the front of the HMC. Wait until you hear 3 beeps (or approximately 1 minute) for the HMC to detect the flash drive.

Note: Save Upgrade Data will overwrite any existing save upgrade data on the media. It will not overwrite any backup Management Console Data already on the media.
 
b. Save Upgrade Data can be performed using either HMC GUI or restricted shell command line.

Use the HMC GUI:
1) Select HMC Management. > Console Management
2) Select Save Upgrade Data.
3) Select media type USB flash drive, click Next, and then click Finish.

Use restricted shell command line:
Use the following command specifying "diskusb" for USB flash drive:
saveupgdata -r diskusb
 
c. Wait for the Save Upgrade Data task to complete. If the task fails, contact your next level of support before proceeding. If the Save Upgrade Data task is successful, the following optional procedure can be performed to verify the data:

1. Open a restricted shell terminal

Local HMC: Select HMC Management > Console Management > Open a Restricted Shell Terminal
Remotely: Log in via ssh.
2. Mount the media:

a. Run the command lsmediadev to determine the mount point of the USB flash drive. In the example below, USB flash drive is /media/sda1
device=/dev/cdrom,mount_point=/media/cdrom,type=1,description=CD/DVD
device=/dev/fd0,mount_point=/media/floppy,type=2,description=internal diskette drive
device=/dev/hda,type=6,description=internal hard disk drive
device=/dev/sda1,mount_point=/media/sda1,type=3,description=USB flash memory device

b. Run the command mount (i.e., mount /media/sda1 for USB flash drive)

3. Run the command ls –l using the same mount point as in step b above - "Example" ls -l /media/sda1

4. Verify that there are five tar files with the following names:

ACMSaveData.tar
RSCTSaveUpgrade.tar
SaveCCFWUpgradeData.tar
SaveHSCSystemUpgradeData.tar
SaveProfileDataUpgrade.tar

If any of these tar files are missing, contact your next level of support.

5. Issue the command umount using the same mount point as in step b above

Note: The Save Upgrade Data will be saved to the hard disk drive on the HMC as well as the USB flash drive. The Save Upgrade Data on the media is used only to recover from an unexpected error under the direction of support personnel.

 
d. Once the Save Upgrade Data task is successful, remove the USB flash drive.
 

Step 4: Upgrade HMC to V10R1M1010 (from Bootable USB)

Do the following at the HMC interface to upgrade the HMC by means of the Bootable USB.
 
a. Insert V10R1M1010 formatted USB flash drive.
 
b. Reboot the HMC
Click HMC Management > Console Management, then click the Shutdown or restart the Management Console option Select restart HMC and click OK.
 
 
c. When the Petitboot menu is displayed, select the Install Hardware Management Console option that is located under USB. Press enter.
d. The HMC reads the media in the drive and displays the Hardware Management Console Install Wizard window. Highlight Next button (use tab/alt-Tab or arrow keys to move), and press Space bar or Enter to select.

Note: If the Save Upgrade Data (Step 3 above) was not performed, you will see a warning window that save upgrade data was not found on the hard disk drive. Cancel the upgrade, remove the recovery media from the DVD drive, reboot the HMC, complete Step 3 above to Save Upgrade Data, then start the upgrade process again.
 
e. Using tab or arrow keys to move the cursor and the space bar to select an option, select Upgrade to a new version (need asterisk on Upgrade to a new release as shown below):

( * ) Upgrade to a new version
( ) Install

Highlight Next button, and press Enter.
 
f. On Upgrade Confirmation screen, highlight Finish, and press Enter to start the Upgrade process.
 
g. The HMC installs V9 from the media, restores the data preserved by the Save Upgrade Data task, and then completes the booting process.

Note: The initial reboot can take 30-45 minutes. Do not reboot or power off; wait for the boot to complete. .
 
h. Select "Log on and launch the Hardware Management Console Web application", then log in using your user ID and password.
 
 

7063 Firmware updates can be found in fix central

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB08","label":"Cognitive Systems"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"HWQQQP_190","label":"Hardware Management Console (7063-CR1)"},"ARM Category":[],"ARM Case Number":[],"Platform":[{"code":"PF025","label":"Platform Independent"}]}]

Document Information

Modified date:
05 November 2021

UID

ibm16490357