IBM Support

Copy of: Create a Client Partition (i, AIX, or Linux) Hosted by an IBMi Server Partition using CLI (Command Line Interface)

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).

Create the Client Partition via HMC Enhanced CLI
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

This is a screen shot of the CRTNWSD command on the Host i parittion.

This is a screen shot of the additional parameters  on the CRTNWSD command.
This is a screen shot of the additional parameters  on the CRTNWSD command.

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.

o CRTNWSSTG NWSSTG(P2DISK1) NWSSIZE(80000) FORMAT(*OPEN) OFFSET(*FORMAT) TEXT('P2 Disk1')
o The disk size does not need to match standard disk unit sizes; however, it needs to be a minimum of 17GB (Gigabyte) and maximum size of 1TB (Terabyte).

NOTE: IBM i release v7r1m0 requires 35gb minimum load source and IBM i release v7r2m0 requires a 70gb minimum load source.

The disk size will be slightly different on the client LPAR due to page size conversion. For more details reference dcf: http://www-01.ibm.com/support/docview.wss?uid=nas8N1012304
How to calculate the size of virtual disks.
o You are limited to 16 virtual drives per SCSI adapter.
o Once everything is working you will want to change this to power controlling.
o You can create the Network Storage space in an iASP by specifying which ASP to create the Network Storage space in on the ASPDEV parameter.

For recommendations on disk sizes for for client partitions, see the Performance Capabilities Reference: http://www-03.ibm.com/systems/i/advantages/perfmgmt/resource.html

9. Add Network Storage Link:

o ADDNWSSTGL NWSSTG(P2DISK1) NWSD(CP01) DYNAMIC(*YES)
o Up to 10 individual optical devices can be restricted using NWSD RSTDDEVRSC parameter on the CHGNWSD command.

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
o Up to 10 individual optical devices can be restricted using NWSD RSTDDEVRSC parameter on the CHGNWSD command.
o Using *ALLOPT restricts all optical devices for this NWSD. Which means no optical devices will be created on the client partition during NWSD vary on.


This is a screen shot of the RSTDDEVRSC parameter in the CHGNWSD command.

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.

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000C4BAAU","label":"IBM i"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0;7.4.0;7.5.0"}]

Historical Number

498958618

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

Manage My Notification Subscriptions