IBM Support

Performing IBM i Upgrades on Power Virtual Servers

How To


Summary

This document explains options available for performing IBM i operating system upgrades in the Power Virtual Servers offering in the IBM Cloud.

Steps

Performing IBM i Upgrades in PowerVS

There are two options when upgrading your IBM i in PowerVS. 

1. If you have an entitled on-prem system that allows you to access the IBM Entitled Systems Support (ESS) website, you can download the image and transfer it to your PowerVS IBM i instance to perform a normal image catalog upgrade. https://www.ibm.com/servers/eserver/ess/landing/index.html
Note that the serial number displayed in the QSRLNBR system value on your PowerVS IBM i   instance is not entitled to ESS.  If you do not have the ability to download install media from ESS, proceed to option 2.
2. The PowerVS offering provides install images, PTFs, group PTFs, and cumulative PTF packages for supported releases within a Cloud Object Repository (COR). To access these objects, an IBM i COR image is provided to deploy an install server that has the images within the IFS. There are two ways to use these images. 
       
a. Deploy an IBM i instance using the COR image and FTP the required media to the IBM i instance to be upgraded, then proceed with the upgrade just as if you had downloaded the media from ESS. 
       
b. Deploy an IBM i instance using the COR image and configure it as an IBM i Network Install Server.  Then upgrade the IBM i using the images over NFS. 

Creating the COR IBM i instance

Refer to the section in the following document titled, “Configuring a Power Systems Virtual Server Instance.” When selecting the IBM i boot image, select the IBMi_COR-7x-xx-x image.  There will be only one COR image listed, create a virtual server instance using this image.    

https://cloud.ibm.com/docs/power-iaas?topic=power-iaas-creating-power-virtual-server

Note: When creating the instance, attach a private network. The VLAN (existing network) that is created is the same one that will be utilized from the CLIENT side when performing a network install. 

image-20230924150749-1

Figure 1

More information about VLANs in the IBM Cloud: https://cloud.ibm.com/docs/vlans?topic=vlans-getting-started

When the IBM i COR instance has been created, you are ready to proceed to:

   Option 1: FTP install image to the client partition.

                                        or

   Option 2: Set up an IBM i network install server.

Option 1:  FTP install image to the client partition.

FTP from the client partition to the IBM i COR instance and get the required install images from the /install directory in the IFS.  There will be a subdirectory for all supported releases that contain the install images. 

From this point proceed as you would have if the images were downloaded from ESS. 

Option 2: Set up an IBM i Network Install Server.

Refer to Setting up an IBM i network install server  

From the IBM Cloud UI

The Network File System (NFS) is already set up on the NFS server (COR) system.  The IFS directories containing the media are in the IFS directory /install

Use WRKLNK ‘/install’ to verify the directory exists on the NFS server.      

image-20230924151054-2

Figure 2

Within each release directory (V7RxM0) are the necessary files for standard upgrades, language changes, etc.

All the directories (Figure 2) have been exported to /install

Identify the VLAN IP address of the NFS server instance from your Cloud GUI

image-20230924151122-3

Figure 3

IBM i NFS client setup

Deploy another IBM Cloud Virtual server instance or use an existing one. This will be your CLIENT

system.

There are two ways to assign an adapter to the Client.

Option 1: Add a new adapter to the VM

Option 2: Re-use an existing an adapter

Option 1: Add a new adapter to the VM

When setting up the Client instance, select the option for ‘Private network’ use the “Attach existing +”

to add VLAN.

image-20230924151320-4

Figure 4

Select the same network the NFS Server is on.

After signing into the Client instance, sign-on and accept licenses if it is a newly deployed instance. 

Verify the interfaces are configured (via CFGTCP, option 1), go back to the UI screen for the Client instance, add another adapter to the same network the NFS Server is on.

For the NFS set up, it’s not necessary to configure this new IP address in CFGTCP, option 1

image-20230924151320-5

Figure 5

Now it shows a second IP address on VLAN2. Make note of it, along with the Gateway IP address.

image-20230924151320-6

Figure 6

Use Alternate method to select LAN resource for an online reference to the following directions.

Use the UI to access IBM i operations, Action (21) Activate dedicated service tools, ‘run action’ to access the ‘Dedicated Service tools’ sign-on. Or, alternately, use STRSST.

image-20230924151320-7

Figure 7

* You may need to change the Service Tools password if this is your first time into the Service Tools

Option 5. Work with DST environment

Option 2. System Devices

Press F13= Select STS Lan Adapter

A new resource is listed.

1= select

Fill in ‘Internet address’ of the new client IP address that was created (ex. 172.2.2.65 in figure 6).

Fill in ‘Gateway router address’ to match the VLAN Gateway (ex. 172.2.2.2 in figure 6)

Fill in Subnet mask

image-20230924151320-8

Figure 8

F7 = Store

F17 = Deactivate followed by activate

F3 = exit

1. Create a device description for a virtual optical device.

Example:

CRTDEVOPT DEVD(COR_IMG) RSRCNAME(*VRT) LCLINTNETA(*SRVLAN)

RMTINTNETA('172.2.2.47') NETIMGDIR('/INSTALL/V7R4M0/LATEST/LANGGRP3') UID(0)

GID(0)

RMTINTNETA = IP address of the COR server (figure 3)

NETIMGDIR = point to whichever COR server directory that is appropriate for the task that you     are performing.

2. Vary on the virtual optical device. Note: If the images or VOLUME_LIST file is changed on

               the NFS server, the virtual optical device must be varied off and then varied back on to use the

virtual images.

VRYCFG CFGOBJ(COR_IMG) CFGTYPE(*DEV) STATUS(*ON)

* Verify that a ping is successful from the Server to client.

3. Load the image catalog

LODIMGCLGE IMGCLG(*DEV) DEV(COR_IMG) IMGCLGIDX(*FIRST)

After the optical device has been created and varied on, specify this device description

name when performing the intended operation (i.e. upgrade, language change, etc.).

Option 2: Re-use an existing adapter

From the UI, deploy a new VM and use the option to ‘Attach existing network’ to create an adapter

that is on the same network as the NFS server.

image-20230924151320-9

Figure 9

Accept the Software Agreements after signing on for the first time.

1. End the TCP interface of the network that was created. In the ‘Figure 9’ example, it would be 172.2.2.210.

image-20230924151320-10

Figure 9

2. Vary off the line associated with this interface.

VRYCFG CFGOBJ(CLOUDINIT1) CFGTYPE(*LIN) STATUS(*OFF)

3. Use the UI to access IBM i operations, Action (21) Activate dedicated service tools, ‘run

action’ to access the ‘Dedicated Service tools’ sign-on. Or, alternately, use STRSST.

image-20230924151320-11

Figure 10

4. Use DST to select the adapter

Option 5. Work with DST environment

Option 2. System Devices

Press F13= Select STS Lan Adapter

Option 1. Select resource name

image-20230924151320-12

Figure 11

F7 = Store

F17 = Deactivate followed by activate

F3 = exit

1. Create a device description for a virtual optical device.

Example:

CRTDEVOPT DEVD(COR_IMG) RSRCNAME(*VRT) LCLINTNETA(*SRVLAN)

RMTINTNETA('172.2.2.47') NETIMGDIR('/INSTALL/V7R4M0/LATEST/LANGGRP3') UID(0)

GID(0)

RMTINTNETA = IP address of the COR server

NETIMGDIR = point to whichever COR server directory that is appropriate for the task

that you are performing.

2. Vary on the virtual optical device. Note: If the images or VOLUME_LIST file is changed on

the NFS server, the virtual optical device must be varied off and then varied back on to use

the virtual images.

VRYCFG CFGOBJ(COR_IMG) CFGTYPE(*DEV) STATUS(*ON)

* Verify that a ping is successful from the Server to client.

3. Load the image catalog
4. LODIMGCLGE IMGCLG(*DEV) DEV(COR_IMG) IMGCLGIDX(*FIRST)

Additional resources:

Media labels and their contents can be found here :

https://www.ibm.com/docs/en/i/7.4?topic=reference-media-labels-their-contents -

rzahcswsmedialabel

Tips and Techniques:

  • From the client type in "WRKIMGCLGE *DEV < virtual_device_name >". This should

display the "Work with Image Catalog Entries" panel showing a catalog of type *RMTCLG

and show all the volumes. If all the volumes are displayed, this means the prep work on

the server consisting of ensuring NFS servers were running, exporting the correct

directory, and proper authorizations of the catalog directory contents.

  • When displaying the ‘Configure Service Tools LAN adapter’ (figure 11), confirm the

Internet Address field contains the IP address of the client’s private network IP address.

  • For OPT1605 RC1, Prior to activating the DST Service Tools server, ensure that the IP

address cannot be pinged. After the activate of the DST service tool server, verify that the

IP address assigned can be pinged.

To check and see if NFS is up and running properly, do the following:

WRKACTJOB SBS(QSYSWRK) JOB(QNFS*)

If you see the following active, all is good:

QNFSMNTD QUSER BCH .0 SELW <=== *Mnt

QNFSNFSD QUSER BCH .0 TIMW <=== *SRV

QNFSNFSD QUSER BCH .0 DEQW <=== *SRV

QNFSRPCD QUSER BCH .0 SELW <=== *RPC

  • On the COR (Server instance), to verify the image catalog directory has been exported,

do the following:

CALL QZNFRTVE and then press F10 to confirm this message is displayed:

CPIB41A - /INSTALL currently exported

OPT1860 will be logged if the NFS backed virtual optical device is not varied on.

  • Verify the Server and Client instances are on the same private network.

  • Ensure PING ‘x.x.x.x’ from the Server to Client instance is successful.

Document Location

Worldwide

[{"Type":"MASTER","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":"a8m0z0000000CHuAAM","label":"Backup Recovery Install Migration"},{"code":"a8m0z000000cwp6AAA","label":"Save Restore"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0;7.2.0;7.3.0;7.4.0;7.5.0;and future releases"}]

Document Information

Modified date:
24 September 2023

UID

ibm17038540