IBM Support

IBM Power HMC How to : Install Virtual I/O server using HMC

How To


Summary

This document provides instructions on various methods to install the Virtual I/O Server (VIOS) using the Hardware Management Console (HMC).

Objective

There are multiple methods available for installing a Virtual I/O Server from the HMC. The pre-requisites and steps vary depending on the method.

Review the pre-requisites section then jump to the install method by clicking below:

In addition to the install methods, you can click the below link to jump to the troubleshooting section:

Environment

HMC Version V10 R2 and above. 

Steps

1) Complete Prerequisites checks.

- Steps a and b can be done at the same time as install when using the GUI methods.

  1. VIOS partition and profile should be created.

    i.  The Virtual I/O Server logical partition creation can be done either using HMC GUI or by using the HMC CLI as well . For GUI instructions, see Creating the Virtual I/O Server logical partition and partition profile manually by using the HMC

    ii. For creating the Virtual I/O server logical partition using HMC Command line interface. You can use the command “mksyscfg" for creation. For CLI instructions, see  HMC Manual Reference Pages - MKSYSCFG
     
  2. The install Virtual I/O Server logical partition requires at least one Ethernet adapter, a minimum  of 30 GB disk space, and a minimum of 12Gb memory. Depending on the number and type of IO adapters additional memory may be required; high speed network adapters may require significantly more memory.  Adding additional adapters or disks can lead to longer install times and potential issues. Once install is complete,  additional I/O can be added.  
  3. A VIOS image downloaded from ESS either on a NIM server, Imported to the HMC, or on a USB.
  4. VIOS installs happen through the HMC's open network and not through the private network [HMC-FSPs]. Ensure these protocols are enabled on the firewall:
    icmp - 5813
    rsh - 513 - 1023 TCP
    bootp - 67 - 68 UDP
    tftp - 69 and 32,768 - 65,535  UDP
    nfs - 2049 TCP
    mountd - 32,768 - 65,535  TCP
    portmapper - 111  UDP 


    For more info see Ports and Protocols to be allowed on Firewall for installios
  5. You need to have "hmcsuperadmin" authority like for (eg: hscroot)
  6. Gather the following information from you network team 
     i. Static IP address for the Virtual I/O Server 
     ii. Subnet mask for the Virtual I/O Server 
     iii. Default gateway for the Virtual I/O Server    


2) Installing the Virtual I/O server. 
 
Select from an installation option listed below.

2a. Installing from HMC GUI (no template).
  1. In the navigation area, Expand System resources and then select the virtual I/O servers.

    image-20240307202242-1
  2. Select the newly created virtual I/O server, expand operations and then select the Install VIOS option.

    image-20240307154530-9
  3. The Install VIOS wizard opens.
  4. From the Partition Configuration list, select the required partition configuration profile. You can select only the profile that is associated to the selected partition. When you create a partition a default profile is always associated to the partition. This is indicated with the profile name being followed by default in parentheses. 

    image-20240307154724-10
  5. Click on next, The VIOS installation configuration tab displayed. 
  6. Under installation method , Select Management Console Image and specify the following options: 
    A. From the Management Console IPv4 Address list, select the IP address of the adapter on the management console that you plan to do the NIM or NIMoL of the VIOS. See the pre-req section for network requirements that the chosen adapter's network must have before install.
    B. The installation method will have a few options like NIM Server, Management Console Image, etc. If you have Imported a VIOS image to the HMC, then you can select Management Console Image. 
    C. Under the VIOS network, select an Ethernet adapter port.
    D. Specify the VIOS IP address, the Subnet Mask, and the Default Gateway used to configure the network on the VIOS.

    image-20240307154933-11
  7.  In the VIOS Installation Configuration tab, click Advanced Settings to view and change the following configuration settings for the selected partition:
    A. From the Adapter Speed list, select the speed of the ethernet adapter for the target partition. By default, Auto is selected to enable the system to determine the required speed of the adapter. 
    B. From the Adapter Duplex list, select duplex value for the Ethernet adapter. By default, Auto is selected to enable the system to determine the required duplex for the adapter. 
    C. From the VLAN Tag Priority list, select the virtual local area network (VLAN) tag priority value to determine the priority of the client partition. You can select the VLAN priority within the range 0 to 7. The default value is 0.   
    D. In the VLAN Tag Identifier field, specify a valid value. The valid value is in the range 1 - 4094.  Note:  If OS vlan tagging is specified the install image must support vlan tagging  or the install will fail part way through. Perform the install using a switch data port  or SR-IOV logical port configured for the desired vlan if the install image does not support OS layer vlan tagging.
  8. Click Next. The VIOS Installation Progress tab is displayed. 
  9. In the VIOS Installation Progress tab, click Start to start the VIOS software installation on the VIOS. You must accept the VIOS licenses for each VIOS
  10. Click Finish to complete the VIOS software installation. The Install VIOS wizard closes.

2b. Installing from HMC GUI with a template

Create Virtual IO Server (VIOS) and Install VIOS using a template 


2c. Installation from HMC CLI with installios

  1. Login to the HMC command line as "hmcsuperadmin" user like for eg: hscroot.
  2. Then execute the command installios to have interactive prompting, or enter the entire command at once.
  3. Select the managed system where you need to install the VIOS.   
  4. Select the newly created VIOS partition   
  5. Select the profile created for the VIOS   
  6.  Enter the source of the installation images [/dev/cdrom]: /extra/viosimages/viosdirectory. Default directory where the images is saved in the HMC.   
  7.  Enter the client's intended IP address: eg.(X.X.X.X) Need to give the IP address for the VIOS partition in order to communicate  
  8.  Enter the client's intended subnet mask: eg.(X.X.X.X) Need to give the subnet mask for the VIOS  
  9.  Enter the client's gateway: eg: (X.X.X.X) Need to give the gateway for the VIOS partition  
  10.  Enter the client's speed [100]: default (Note: To use the adapter's default setting, enter 'default' for speed)  
  11.  Please select an adapter you would like to use for this installation (WARNING: The client IP address must be reachable through this adapter) 
    A. eth0 X.X.X.X  
    B. eth1 X.X.X.X  
    C. eth2 X X X X 
    D. eth3 X X X X 
  12. The following objects of type "ethernet adapters" were found.  Please select one:  
    A. ent U9117.XXX.XXXXXX-P1-C2-T1
    B. ent U9117.XXX.XXXXXX-P1-C2-T2
    C. ent U9117.XXX.XXXXXX-P1-C2-T3  
    D. ent U9117.XXX.XXXXXX-P1-C2-T4
  13.  Press enter to proceed or type Ctrl-C to cancel. 

2d. Installing VIOS from backup


2e. Troubleshooting common issues

- If the ping test fails, ensure that the cabling is correct. If the cables are correct and the firewall is open, then you can follow this document on booting to SMS and testing ping. Use the HMC as the server IP to ping. If ping is not working from the port to the HMC, the install will fail.
- If a previous install fails for any reason, ensure that you clean up the operation with:
installios -u
If this fails or any errors over labels is seen, check for labels with:
installios -q
Then remove any listed labels, for example default1 label:
installios -F -e -R default1
Then restart the install and confirm the results.
- If the install hangs or prompts "verifying_data_files" or "prompting_for_data_at_console" there are a couple possible issues. It may be that there is not enough memory assigned to the partition. Example: If they have 3x 25/10Gb network adapters and 2x 16Gb fibre, we recommend 16GB memory (at least 12GB) for the install. Also it may be the image it corrected or truncated. See IBM PowerVM (VIOS) HowTo: Verifying the integrity of an ESS downloaded VIOS image/file without a checksum or hash file.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB08","label":"Cognitive Systems"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSOQ2E","label":"Hardware Management Console V10"},"ARM Category":[{"code":"a8m0z0000001iPhAAI","label":"Hardware Management Console-\u003EVIOS Installation"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
05 June 2024

UID

ibm17130802