Troubleshooting
Problem
This document describes the steps needed to create a partition that is hosted by an i partition.
Resolving The Problem
For i client partitions, both partitions must be at V6R1M0 (or later) on an IBM POWER6 (or later) system with firmware at EM320 (or later).
HMC ENHANCED+ CLI
When using the enhanced+ HMC GUI, creating an "i hosting i" partition most of it needs to be done from command line interface (CLI)
Certain information is required prior to creating the partition and adapters
Determine the managed server NAME and TYPE/MODEL:
Server name can be found by typing: lssysconn -r all on HMC CLI

CREATE PARTITION:
This can be done from the HMC enhanced+ GUI:
Select the server where the partition will reside by clicking on the Resources ICON in the left navigation and putting a check mark on the server.
Click on Actions and select View Partitions
At the top you will see a button to create partition:


Name the partition and either assign a partition ID or let it assign the next available.
Select the OS .. either AIX/Linux or IBMi and click ok
Once it creates, it will be listed under All partitions and now can be configured with processor, memory, etc.
Select the partition and click on Actions
Click on View All Actions
Click on Manage Profiles
Click on the name default_profile
From here the rest of the partition properties can be configured.
CREATE SERVER VIRTUAL SCSI ADAPTER via HMC CLI
Creating virtual server and client adapters require HMC Command Line Interface (CLI)
This is an example of dynamically adding a virtual SCSI adapter:
chhwres -r virtualio -m {managed server name or type/serial number} -o a -p -s {server ID #} {Host Partition Name} --rsubtype fc -a "adapter_type=client,remote_lpar_name=vios,remote_slot_num={client adapter ID #}" -s {server adapter ID number}
Example:
chhwres -r virtualio -m P8T -o a -p P8TiOS --rsubtype scsi -a "adapter_type=server,remote_lpar_name=MOtest,remote_slot_num=13" -s 13
This is creating a virtual SCSI adapter on managed server P8T and hosting partition P8TiOS with adapter type of server adapter number 13
to client partition MO_iHOSTi under adapter number 13.
Once the server SCSI adapter is dynamically added, this creates a 290B COMM adapter on the HOST lpar.
To find the rsc name on the HOST partition type: wrkhdwrsc *cmn and look for the 290B with the same ID that was created.
For the client virtual SCSI adapter, go into Manage Profiles on the GUI to add the adapter.
Here is an example to create a virtual ethernet port on the server:
chhwres -r virtualio -m P8T -o a --id 5 --rsubtype eth -a "ieee_virtual_eth=1,port_vlan_id=4,is_trunk=1,trunk_priority=1"
The variables will be the managed server [-m], the server partition ID [--id], and the vlan ID [vland_id=]
6. Find the controller name associated with the Virtual SCSI Server adapter using WRKHDWRSC *CMN. Look for a resource with type 290B. 7. Create a NWSD (Network Server Description): CRTNWSD |
Use either partition name or partition ID of the partition created in Step 2.
Specify the Server Operating system. In this example we are creating an i5/OS partition so we selected *OPSYS. For an AIX partition, use *AIXPPC; for Linux, use *LINUXPPC. For IPL source use *PANEL for the IPL Source for the first IPL, and change it after the partition is installed to *NWSSTG.
**NOTE** prior to vary on of the NWSD, any tape or optical that is to be virtualized, should be varied on, on the hosting lpar.
If the network server description fails to vary on, check the qsysopr message queue using command DSPMSGQ QSYSOPR and find the reason code for the CPDB1AD error message. This will tell the reason it is failing.
8. Create Network Storage. Each Network Storage will represent a disk unit on the client partition.
|
9. Add Network Storage Link:
Please consider adding the following note: NOTE: If you plan to install LIC and OS on the client partition using a full system save tape or SAVSYS tape rather than an optical device then issue command CHGNWSD RSTDDEVRSC(*ALLOPT). This means tape device(s) will be created but no optical devices will be created on the client partition during NWSD vary on. |
10. By default, all optical devices up to 10 will get virtualized to the client partition. If you have more than one optical drive on the Host partition you must limit this down to one device so that you know which device you are using on the client partition:
Note: An NWSD is needed for each set of disks over the max of 16 (or 32 for R710 TR9 and later). o Starting at R710 Technology Refresh 2 Tape resources are virtualized by the NWSD. For more Hardware and Software requirement see: https://www.ibm.com/developerworks/ibmi/media
|
11. Vary on the NWSD.
o WRKCFGSTS CFGTYPE(*NWS), Option 1 to Vary on.
12. Install the partition. For System i, DM IPL the client partition from i_base install media.
====================================================
** NOTE**
Concurrent removal of external and virtual storage devices whether configured or non-configured is NOT supported by IBM i.
The support statement isn't limited to virtual (attached) disk. Removing external storage LUNs from an active partition is NOT supported on IBM i, regardless of whether they are attached natively or via a virtual adapter.
Virtual SCSI disks are also considered "external" storage by the client even when the backing hardware on the server partition are internal storage.
As for removing the volume group, it doesn't matter how they are connected (vSCSI, NPIV, or Natively), the volumes should always be removed from the configuration first, then the partition shut down, then the volume group can be destroyed/removed.
The partition should be shutdown prior to removing or unassigning and virtual disk units or LUNs.
====================================================
VIRTUAL ETHERNET BRIDGING
Here is a link to the document to setup virtual ethernet bridging:
http://www.ibm.com/support/docview.wss?uid=nas8N1011193
CREATE THE NetWork Storage Description:
CRTNWSD .. provide same info as shown below
If the SYNC setting is on no further action is required to save the changes. If the SYNC setting is off,
It is recommended to save current configuration to the profile so the changes are not lost if the partition profile
is activated later.
Historical Number
498958618
Was this topic helpful?
Document Information
More support for:
IBM i
Component:
IBM i
Software version:
7.3.0, 7.4.0, 7.5.0
Operating system(s):
IBM i
Document number:
729345
Modified date:
04 April 2025
UID
ibm10729345