Creating IBM i or Linux Client Partitions Using Virtual Partition Manager (VPM)

Troubleshooting

Problem

This document provides steps, considerations, limitations, and links to information regarding creation of IBM i Client Partitions using the enhanced Virtual Partition Manager (VPM).

Resolving The Problem

Virtual Partition Manager Enhancement to Create IBM i Partitions
The Virtual Partition Manager (VPM) is a partition management tool that supports the creation of partitions that use only virtual I/O and does not require the Hardware Management Console (HMC), Systems Director Management Console (SDMC) or Integrated Virtualization Manager (IVM). In addition to being able to manage Linux guest partitions, the VPM now supports creation and management of IBM i partitions. AIX is NOT supported.

This enhanced VPM function is available on POWER6 and POWER7 Express Servers that do not have an external management console. With this enhancement to IBM i 7.1, the ability to create up to four IBM i partitions are enabled in VPM. Client IBM i partitions, that are created with VPM, use virtual I/O to connect back to the IBM i I/O server partition to access the physical disk and network. VPM in the IBM i I/O server partition is used to create the virtual SCSI and virtual Ethernet adapters for the client partitions. The user is then be able to use Network Storage Spaces (NWSSTG) and Network Storage Descriptions (NWSD) in the IBM i I/O server partition to define the storage for the client partitions. Tape, disk, and optical are allowed to be virtualized to the client partitions.

The client IBM i partitions can be IBM i 7.1 or IBM i 6.1 with either 6.1 or 6.1.1 machine code.

Ethernet Layer-2 Bridging
IBM i V7R1 Technology Refresh(TR) Three has new support for Ethernet layer-2 bridging between a physical network and the Power Systems virtual Ethernet. Using layer-2 bridging, one Ethernet port in an IBM i partition can provide network access for other logical partitions on the same platform. This is similar in functionality to the Shared Ethernet Adapter (SEA) support provided by a Power Systems Virtual I/O Server (VIOS) partition.

This works by putting two Ethernet adapters (one physical, one virtual) into a mode where they can receive traffic that is not specifically destined for their address, and selectively sending those frames onto the other network according to the IEEE 802.1D standard ("bridging"the frames). Because of this, frames transmitted by virtual Ethernet adapters on the same vlan as the bridging virtual Ethernet adapter can be sent to the physical network, and frames from the physical network can be received by adapters on
the virtual network.

Preparing for Ethernet layer-2 bridging
Select a physical Ethernet resource to use for layer-2 bridging.

o	Any Ethernet resource that supports line speeds of 1Gbps or greater is supported except for Host Ethernet Adapter (HEA) resources. The HEA adapter is not supported.
o	The resource must not be in use by any varied-on line description or configured as the Service Tools LAN adapter (LAN console, remote support).
o	An aggregate line description can also be used to bridge traffic to the external network.
o	Create a virtual Ethernet resource to use for layer-2 bridging, and record its resource name.
o	If using a Hardware Management Console, create a virtual Ethernet adapter for the desired VLAN ID, and check the "Access external network" box to indicate that this virtual Ethernet adapter will be used to bridge traffic to the physical network.
o	If using the IBM i Virtual Partition Manager in TR 3, the virtual Ethernet adapter will automatically be created with the ability to access the external network.
o	Choose an alphanumeric name (up to 10 characters) for the bridge itself, and make it unique from any existing bridge names.

Recommended practices
It is recommended that the selected Ethernet resources only be used for layer-2 bridging (not for IBM i TCP/IP configuration). There is significant processing overhead for any host traffic that uses bridged resources.

Configuring Ethernet layer-2 bridging
Create an Ethernet line description for the physical Ethernet resource, and set its Bridge identifier (BRIDGE) to your chosen bridge name.

Create an Ethernet line description for the selected virtual Ethernet resource, and set its Bridge identifier (BRIDGE) to the same bridge name.

When both line descriptions are varied on, traffic will be bridged between the two networks, and any other partitions with virtual Ethernet adapters on the same VLAN as the new virtual Ethernet resource will be able to access the same network as the physical Ethernet resource.

Common errors
CHGLINETH cannot be used to change the Bridge identifier of a line description that was created prior to TCP/IP Group PTF SF99367 level 5. If equivalent behavior is desired:

o	Use the "Copy" option on WRKLIND to make a temporary copy of the line description.
o	Delete the existing line description.
o	Use the "Copy" option again on WRKLIND to replicate the original line description, specifying the desired Bridge identifier.
o	Delete the temporary line description.

No more than one physical Ethernet adapter's line description with a given Bridge identifier can be varied on at the same time. Likewise, no more than one virtual Ethernet adapter's line description with a given Bridge identifier can be varied on at the same time. An error will be returned when trying to vary on any more line descriptions with that Bridge identifier, indicating that the configuration is in error. For a given bridge, select one physical Ethernet line description and one virtual line description to be bridged. If more than one bridge is required, use a different Bridge identifier for each additional bridge.

As mentioned above, the selected virtual Ethernet resource must be marked as allowing access to the external network. If an incorrect virtual Ethernet resource is selected, an error will be returned when trying to vary on its line description, indicating that the selected resource cannot enable promiscuous mode. Create a virtual Ethernet resource that can be used to access the external network.

Managing Ethernet layer-2 bridging
While an Ethernet line description is varied off, its Bridge identifier (BRIDGE) can be changed to a different name (or to *NONE, indicating that it is not to be used for bridging).

Note: In IBM i V7R1, an Ethernet line description's Bridge identifier will not be visible from DSPLIND. Use the CHGLINETH command and prompt to see the Bridge identifier for an Ethernet line description.

Overview

NOTE: To create a Linux partition reference the PDF in the link below and start at section 3.3
https://www.ibm.com/developerworks/community/forums/ajax/download/b392f5e7-cc45-4261-a6cf-ee6acc3ba93e/d61b0887-7ab0-49b7-81c1-749e6931e7fe/iVirtualization%20-%20IBM%20iHost%20and%20Client%20LPAR%20Easy%20Install%20Gui.pdf

Creating an IBM i hosting i client using VPM and ethernet layer-2 bridging

A. Configure the Host partition using Virtual Partition Manager
This section provides step-by-step instructions on how to configure resources on the hosting IBM i partition using the Virtual Partition Manager, in preparation for defining new IBM i partitions.

B. Create the IBM i Guest using Virtual Partition Manager
This section provides step-by-step instructions on how to create a new guest IBM i partition.

C. Configure the virtual storage for the guest
This section provides step-by-step instructions on how to create and assign storage (disk, etc) for the new guest partition.

D. Configure the ethernet bridge
This section provides step-by-step instructions on how to bridge the virtual ethernet network that exists between the guest and host partitions to the outside network.

E. Configure the console
This section provides tips for preparing the operations console to connect to the new guest partition.

F. Install the guest.
This section provides step-by-step instructions on how to install IBM i on the new guest partition.

A. Configure the Host partition using Virtual Partition Manager

This section provides step-by-step instructions on how you can remove logical resources from IBM i using the Virtual Partition Manager, in preparation for defining new IBM i partitions. With your new Power System, by default, the IBM i partition currently owns all of the processor, memory, and I/O resources. You can invoke the Virtual Partition Manager either through Dedicated Service Tools (DST) or System Service Tools (SST) tasks. The advantage of using SST is that you can bring your Power System to full operational mode rather than having to do your partition definitions in a restricted state where the rest of the operating system has not started, and users are not able to use the system.

We recommend that you manage your IBM i partition, creation, and management through SST tasks, which enables you to use your IBM i environment concurrently. After you define the partitions, a system IPL is required to complete the removal of resources from IBM i.

Let's see how it works through an example:

1.	From the IBM i command line, type the following: STRSST Press the Enter key.
2.	Sign on with a service tool user profile that at least has authority to 'System partitions - operations', 'System partitions - administration', 'Hardware service manager' and 'Start Service Tools' functions.
3.	Select Option 5, Work with system partitions, and press the Enter key. If this is the first time, you will see an initial information panel: `Logical Partitioning Environment Supported` `System: ZD8AP1` `Virtual Partition Manager is supported. The system is in a` `state that does allow this operating system to partition the` `server. Refer to the Virtual Partition Manager documentation` `for more information.` `Press ENTER to confirm using Virtual Partition Manager to` `Partition the server.` `Press the Enter key to continue.`
4.	You will see the Work with System Partitions panel: `Work with System Partitions` `System: ZD8AP1` `Attention: Incorrect use of this utility can cause damage` `to data in this system. See service documentation.` `Number of partitions . . . . . . . : 2` `Partition release . . . . . . . . . : V7R1M0` `Partition identifier . . . . . . . : 1` `Partition name . . . . . . . . . . : ZD8AP1 ` `Select one of the following:` `2. Work with partition status` `3. Work with partition configuration` `4. Clear configuration data` `5. Create a new partition` `Selection` `_` `F3=Exit F12=Cancel` Note:* Option 1: Display Partition Information is not enabled for Virtual Partition Manager. Instead, use Option 2: Work with Partition Status, or use Option 3: Work with Partition Configuration to manage logical partitions using Virtual Partition Manager.
5.	Select Option 3, Work with partition configuration, and press the Enter key. `Work with Partition Configuration` `System: ZD8AP1` `Available processor units . . . . : 2.90` `Available memory (MB) . . . . . . : 3808` `Memory region size (MB) . . . . . : 32` `Type option, press Enter.` `1=Display 2=Change 9=Delete` `Virtual` `Partition ---------Processor---------- Memory Ethernet ID` `Opt ID Name Total Units Uncap Weight (MB) WLM 1 2 3 4` `_ 1 ZD8AP1 1 1.00 1 Med 2048 2 1 2 2 2` `_ 2 XPF71 1 0.10 1 Med 1536 2 3 2 2 2`
6.	If you are creating your first guest or from the previous screen you perceive there are not enough resources (processor units and memory, highlighted in red) to define another new IBM i partition, you will need your host partition (Partition ID 1) to remove some resources and make them available for the guest partitions. If so, continue with the next step. Otherwise, skip to Step 10.
7.	Select Option 2, Change, next to your host partition (partition ID 1), and press the Enter key. `Change Partition Configuration` `System: ZD8AP1` `Type changes, press Enter.` `Partition identifier and name . . . . . . . . 1 ZD8AP1` `Number of available system processors . . . : 2` `Number of partition processors . . . . . . . .` `1` `Minimum / maximum number of processors` `. . . .` `1` `/` `4` `Use shared processor pool` `. . . . . . . . . .` `1` `1=Yes, 2=No` `Shared processor pool units . . . . . . . .` `1` `.` `00` `Minimum / maximum processor pool units` `. . . 0 . 10 /` `4` `.` `00` `Uncapped processing` `. . . . . . . . . . . . 1 1=Yes, 2=No` `Uncapped processing weight` `. . . . . . . .` `128` `0, 64, 128, 255` `Size of available memory (MB) . . . . . . . : 3808` `Size of partition memory (MB)` `. . . . . . . .` `2048` `Minimum / maximum size of memory (MB) . . . .` `512` `/` `8192` `Enable workload management` `. . . . . . . . . .` `2` `1=Yes, 2=No` `Virtual Ethernet Identifiers` `(1=Yes, 2=No)` `1 2 3 4` `1` `2` `2` `2` `F3=Exit F12=Cancel` Minimum / Maximum Number of Processors: Enter the value for the minimum number of processors you anticipate needing for your IBM i environment, and the maximum number of processors available for IBM i. In our sample environment, we had one processor and we left the maximum value at 4, enabling IBM i to utilize all of the processors if the Linux or IBM i partitions are not being used. Use Shared Processor Pool: The shared processor pool is a group of physical processors that provide processing capacity that can be shared among multiple logical partitions. The shared processor pool allows you to assign partial processors to a logical partition. Another advantage for changing the partition configuration to use the shared processor pool is that the partition has the capability to use processor resources unused by other partitions. Note: When the current value of 2 is changed to 1, indicating shared processor pool is desired, the system prompts for new shared processor pool values once the Enter key is pressed. Shared Processor Pool Units: Specifies the total number of processing units that are available to the partition after the resources are removed. In this example, the IBM i partition is left with 100 processing units, or a full processor after we remove the CPU resources. Minimum / Maximum Shared Processor Pool Units: A minimum of 0.10 processing units is required for every full processor that may be utilized for the given partition. Uncapped processing: By changing the value from 2= NO, to 1=YES, the partition may utilize excess shared processor cycles. The quantity assigned is dependent on the setting of the uncapped processing weight field that follows. If the value is 2=NO, then this partition is not assigned excess shared processor cycles and is a capped partition. A capped partition indicates that the logical partition will never exceed its assigned processing capacity. You can use the capped mode if you know that a software application would never require more than a certain amount of processing power. Any unused processing resources are used only by the uncapped partitions in the shared processor pool. A partition using the uncapped mode indicates that the partition's assigned current processing capacity can be exceeded up to the partition's current virtual processor setting when the shared process or pool has any unused processing power. Note: Virtual Partition Manager client partitions do not support dynamic movement of physical resources. The host LPAR will allow DLPAR remove and add of processor and memory. Uncapped Processing Weight: With Virtual Partition Manager, since you can only create four additional Linux partitions, this range is restricted to a set of predefined values: 0=None, 64=Low, 128=Medium, and 255=High. By setting the uncapped weight (255 being the highest weight), any available unused capacity is distributed to contending logical partitions in proportion to the established value of the uncapped weight. The default uncapped weight value is 128. For example, if partition 2 had an uncapped weight of 64 and partition 3 had an uncapped weight of 255, partition 3 would get up to four times the unused processing resources that partition 2 received. A value of zero is required to be set for partitions that are capped. Size of Partition Memory: IBM i partitions require a minimum of 1024 megabytes. In this example, the value indicates the amount of main storage that remains with your host partition. Make the new value multiples of the value set as the Memory region size (highlighted in blue on Step 5). Enable Workload Manager: The default value for Virtual Partition Manager is set to 2=No, meaning that the partition is not allowed to use the future workload management tool within the partition to automatically adjust resource assignments, such as the IBM Enterprise Workload Manager. Virtual Ethernet Identifiers: A value of 1 indicates you enabled one of the virtual Ethernet communications ports for inter-partition communications between Linux or IBM i partitions and your host partition. In this example, we changed the value for one of the ports to 1, which creates a virtual Ethernet adapter under IBM i with a resource type of 268C and an associated resource name that is used during the set up of Ethernet line description. Note: IBM support recommends that for the initial configuration of ethernet bridging, you configure only one virtual ethernet. This ensures the correct virtual adapter is selected to bridge the virtual network. If a second network is needed, it can be added dynamically later, after the bridge has been successfully tested. Example configuration with virtual ethernet 1 selected ("1=yes") for bridging from host: Virtual Ethernet Identifiers (1=Yes, 2=No) 1 2 3 4 1 2 2 2 Make several changes here, based on the resources you want to release and thus make available for the guest partitions.
8.	Press the Enter key. You will see the Confirm Changed Partition panel. `Confirm Changed Partition` `System: ZD8AP1` `Verify information, press Enter.` `Partition identifier and name . . . . . . . : 1 ZD8AP1` `Number of partition processors . . . . . . . : 1` `Minimum / maximum number of processors . . . : 1 / 4` `Use shared processor pool . . . . . . . . . : Yes` `Shared processor pool units . . . . . . . : 1.00` `Minimum / maximum processor pool units . . : 0.10 / 4.00` `Uncapped processing . . . . . . . . . . . : Yes` `Uncapped processing weight . . . . . . . : Med` `Size of partition memory (MB) . . . . . . . : 2048` `Minimum / maximum size of memory (MB) . . . : 512 / 8192` `Enable workload management . . . . . . . . . : No` `Virtual Ethernet Identifiers (1=Yes, 2=No)` `1 2 3 4` `1 2 2 2` `F12=Cancel`
9.	Press the Enter key. You will get a completion message: Partition 1 change was successful.

B.	Create the IBM i Guest using Virtual Partition Manager
10.	Press F3. Select Option 5, Create a new partition, and press the Enter key. `Select Operating Environment` `System: ZD8AP1` `Select one of the following:` `1. OS/400` `2. Guest` `Selection` `_` `F3=Exit F12=Cancel`
11.	Select Option 1, OS/400, and press the Enter key. `Create New Partition` `System: ZD8AP1` `Complete blanks, press Enter.` `Partition identifier and name . . . . . . . .` `3` `Number of available system processors . . . : 2` `Number of partition processors . . . . . . . .` `Minimum / maximum number of processors . . . .` `/` `Use shared processor pool . . . . . . . . . .` `1` `1=Yes, 2=No` `Shared processor pool units . . . . . . . .` `.` `Minimum / maximum processor pool units . . .` `.` `/` `.` `Uncapped processing . . . . . . . . . . . . 1 1=Yes, 2=No` `Uncapped processing weight . . . . . . . .` `128` `0, 64, 128, 255` `Size of available memory (MB) . . . . . . . : 3808` `Size of partition memory (MB) . . . . . . . .` `Minimum / maximum size of memory (MB) . . . .` `/` `Enable workload management . . . . . . . . . .` `2` `1=Yes, 2=No` `Virtual Ethernet Identifiers (1=Yes, 2=No)` `1 2 3 4` `2` `2` `2` `2` `F3=Exit F12=Cancel`
12.	Fill in the fields the following way: Create New Partition System: ZD8AP1 Complete blanks, press Enter. Partition identifier and name . . . . . . . . 3 XPF61 Number of available system processors . . . : 2 Number of partition processors . . . . . . . . 1 Minimum / maximum number of processors . . . . 1 / 1 Use shared processor pool . . . . . . . . . . 1 1=Yes, 2=No Shared processor pool units . . . . . . . . 0 . 10 Minimum / maximum processor pool units . . . 0 . 10 / 1 . 00 Uncapped processing . . . . . . . . . . . . 1 1=Yes, 2=No Uncapped processing weight . . . . . . . . 128 0, 64, 128, 255 Size of available memory (MB) . . . . . . . : 3808 Size of partition memory (MB) . . . . . . . . 1536 _ Minimum / maximum size of memory (MB) . . . . 1024 / 1536 Enable workload management . . . . . . . . . . 2 1=Yes, 2=No Virtual Ethernet Identifiers (1=Yes, 2=No) 1 2 3 4 3 2 2 2 F3=Exit F12=Cancel Note: You must use select one (and only one) Virtual Ethernet to be the lan console device by specifying a "3". The virtual ethernet identifier selected (virtual ethernet 1 in this example) must match the virtual ethernet selected on the host for bridging (step 7). This will create one virtual ethernet resource of type 268C in the guest that will be used for both console and the TCP interface on that network. On a Linux or other guest partition, you cannot specify a "3" because there isn't an Ops Console. You must instead specify a "1".
13.	Press the Enter key. You will see the Confirm New Partition panel: Confirm New Partition System: ZD8AP1 Verify information, press Enter. Partition identifier and name . . . . . . . : 3 XPF61 Number of partition processors . . . . . . . : 1 Minimum / maximum number of processors . . . : 1 / 1 Use shared processor pool . . . . . . . . . : Yes Shared processor pool units . . . . . . . : 0.10 Minimum / maximum processor pool units . . : 0.10 / 1.00 Uncapped processing . . . . . . . . . . . : Yes Uncapped processing weight . . . . . . . : Med Size of partition memory (MB) . . . . . . . : 1536 Minimum / maximum size of memory (MB) . . . : 1024 / 1536 Enable workload management . . . . . . . . . : No Virtual Ethernet Identifiers (1=Yes, 2=No) 1 2 3 4 3 2 2 2 F12=Cancel
14. 14B.	Press the Enter key. You will get a completion message: Partition 3 create was successful. A system IPL of the host partition is required at this time to activate the changes.
C.	Configure the virtual storage for the guest
15.	Press F16. Select Option 1, Start a service tool, and press the Enter key.
16.	Select Option 7, Hardware service manager, and press the Enter key.
17.	Select Option 1, Packaging hardware resources (systems, frames, cards,...), and press the Enter key.
18.	You will see the Packaging Hardware Resources panel: Packaging Hardware Resources Local system type . . . . : 9409 Local system serial number: HV-80001 Type options, press Enter. 2=Change detail 3=Concurrent maintenance 4=Remove 5=Display detail 8=Associated logical resource(s) 9=Hardware contained within package Type- Resource Opt Description Model Unit ID Name _ System 9409-E8A U9409.E8A.HV80001 SYS01 _ System Unit + 78A0-001 U78A0.001.DNWFR27 FR01 _ Virtual Backplane + < 268C-001 U9409.E8A.HV80001 P21 _ Disk Unit System + DE01 _ Tape Unit 6380-001 SD001 F3=Exit F5=Refresh F6=Print F8=Exclude non-reporting resources F9=Reserve frame space F10=Non-reporting resources F11=Display SPCN system information F12=Cancel F13=Unresolved locations
19.	Select Option 9, Hardware contained within package, next to Virtual Backplane and press the Enter key.
20	You will see the details for the Virtual Backplane. Page down until you find the first resource with a location code of V1-C230: `Packaging Hardware Resources` `Unit ID: U9409.E8A.HV80001` `Type options, press Enter.` `2=Change detail 3=Concurrent maintenance 4=Remove 5=Display detail` `8=Associated logical resource(s) 9=Hardware contained within package` `Type- Resource` `Opt Description Model Name Location` `_ Virtual Comm IOA 268C-002 P65 V1-C7` `_ Virtual Comm Port 268C-002 P66 V1-C7-T1` `_ Virtual Comm IOA 290B-001 P46 V1-C230` `_ Virtual Comm IOA 290B-001 P47 V1-C231` `_ Virtual Comm IOA 290B-001 P48 V1-C232` `_ Virtual Comm IOA 290B-001 P51 V1-C330` `_ Virtual Comm IOA 290B-001 P52 V1-C331` `_ Virtual Comm IOA 290B-001 P53 V1-C332` `Bottom` `F3=Exit F5=Refresh F6=Print F7=Include empty positions and not owned positions` `F8=Exclude non-reporting resources F10=Non-reporting resources` `F12=Cancel F13=Unresolved locations` Note: Every time you create an IBM i Client Partition using Virtual Partition Manager, three vSCSI adapters are created. The C label (C330) can be dissected: The first digit is the LPAR ID (3). The second and third digits represent the vSCSI identifier (30, 31, and 32). The vSCSI ID ending in 0 (30) is the Load Source and Alternate Restart Device. Since Linux only needs one SCSI device, only one vscsi adapter is created and identification of the SCSI resource will be identified as V1-Cx with no specific adapter number.
21.	Select Option 8, Associated logical resource(s), next to Virtual Comm IOA resource you identified in the previous step and press the Enter key: `Logical Resources Associated with a Packaging Resource` `Packaging resource:` `Type-Model Resource Name` `Virtual Comm IOA 290B-001 P51` `Type options, press Enter.` `2=Change detail 4=Remove 5=Display detail 6=I/O debug` `7=Verify 8=Associated packaging resource(s)` `Opt Description Type-Model Resource Name Status` `_ Virtual Comm IOA 290B-001 CTL06 Operational` `_ Virtual IOP 290B-001 CMB15 Operational` Write down the Resource Name for the Virtual Comm IOA.
22.	Press F3 two times. Press F10. You will access the IBM i command line.
23.	From the IBM i command line, type the following to create a Network Server Description for the new IBM i guest partition: *CRTNWSD NWSD(XPF61) RSRCNAME(CTL06) TYPE(GUEST OPSYS) PTNNBR(3) RSTDDEVRSC(OPT01) IPLSRC(PANEL) PWRCTL(NO) TEXT(XPF61)* Press the Enter key. Note: We are excluding OPT01 because we are going to use Virtual Media Images to install SLIC.
24.	You will get a completion message: Network server description XPF61 created.
25.	From the IBM i command line, type the following to create a Network Storage Space for the new IBM i guest partition: *SBMJOB CMD(CRTNWSSTG NWSSTG(XPF61) NWSSIZE(35840) FORMAT(OPEN) OFFSET(FORMAT) TEXT(XPF61)) JOB(XPF61) JOBQ(QSYSNOMAX)* Press the Enter key. Note: At V7R2M0 and beyond, the NWSSIZE must be 70GB or greater after initialization. Create a disk size of 70569 GB, which is 5 GB bytes larger than a physical 70.5 GB disk (like the 4327 which reports as 70564 GB).
26.	Once the creation of the Network Storage Space finishes, from the IBM i command line type the following to link the Network Storage Space to the Network Server Description: ADDNWSSTGL NWSSTG(XPF61) NWSD(XPF61) Press the Enter key.
27.	You will get a completion message: Network server storage space link added.

D.	Configure the ethernet bridge Note: Verify Virtual Switch Management in ASM is disabled ASM Virtual Switch Management must be disabled (the default value). a. Log into ASM as admin, Open a browser to the FSP Log in with the user admin. The default password if it has not been set is admin. b. Expand System Configuration > Virtual Ethernet Switches. If the Number of Virtual Ethernet Switches is 0 then the VPM can be used to define and manage virtual ethernet adapters; no change is needed. If the number of switches is greater than 0, the administrator must undefine the switch(es). c. To disable ASM Virtual Switch Management: Power off all partitions and the server. In ASM under System Configuration > Virtual Ethernet Switches set the value to 0 and save the setting. For further information on configuring the bridging see IBM Software Technical Document Number N1011193 Ethernet Bridging Between IBM i Host and IBM i Guest
28.	From the IBM i command line, type the following to identify the Physical Ethernet Resource that will act as the bridge: *DSPHDWRSC TYPE(CMN)** Press the Enter key.
29.	You will see the Display Communication Resources panel. Page down until to find the physical Ethernet card/port you wish to use for the bridge. o It must be a 1Gig capable adapter and cannot be the HEA. In this example it is the top/right T1 port of a 5767 dual port ethernet card. o Use option 7 to determine the physical location and port . o Use option 5 and verify there are no existing line descriptions. Display Communication Resources System: ZD8AP1 Type options, press Enter. 5=Display configuration descriptions 7=Display resource detail Opt Resource Type Status Text _ LIN04 5767 Operational LAN Adapter _ CMN07 5767 Operational Ethernet Port _ CMN08 5767 Operational Ethernet Port _ CMB10 6B20 Operational Comm Processor _ CTL02 6B20 Operational Comm Adapter _ CMB25 268C Operational Comm Processor _ LIN11 268C Operational LAN Adapter _ CMN37 268C Operational Ethernet Port _ CMB11 290B Operational Comm Processor _ CTL03 290B Operational Comm Adapter _ CMB12 290B Operational Comm Processor _ CTL04 290B Operational Comm Adapter _ CMB13 290B Operational Comm Processor _ CTL05 290B Operational Comm Adapter _ CMB14 6B04 Operational Comm Processor More... F3=Exit F5=Refresh F6=Print F12=Cancel
30.	From the IBM i command line, type the following to create the Ethernet line description for the bridge physical adapter: CRTLINETH LIND(ETHLINE1) RSRCNAME(CMN07) BRIDGE(B1) Press the Enter key. Note: Carefully note the bridge name. This name B1 in our example must match the name specified on the virtual adapter to form the bridge.
31.	From the IBM i command line, type the following to vary on the Ethernet line description: *VRYCFG CFGOBJ(ETHLINE1) CFGTYPE(LIN) STATUS(ON)* Press the Enter key. This completes the configuration of the physical port that will connect the virtual network to the external network. Next, you will configure the virtual Ethernet adapter to bridge to this adapter.
32.	From the IBM i command line, type the following to identify the Virtual Ethernet Resource: *DSPHDWRSC TYPE(CMN)** Press the Enter key.
33.	You will see the Display Communication Resources panel. Page down until you find the first Ethernet port of type 268C and write it down. Display Communication Resources System: ZD8AP1 Type options, press Enter. 5=Display configuration descriptions 7=Display resource detail Opt Resource Type Status Text _ LIN04 5767 Operational LAN Adapter _ CMN07 5767 Operational Ethernet Port _ CMN08 5767 Operational Ethernet Port _ CMB10 6B20 Operational Comm Processor _ CTL02 6B20 Operational Comm Adapter _ CMB25 268C Operational Comm Processor _ LIN11 268C Operational LAN Adapter _ CMN37 268C Operational Ethernet Port _ CMB11 290B Operational Comm Processor _ CTL03 290B Operational Comm Adapter _ CMB12 290B Operational Comm Processor _ CTL04 290B Operational Comm Adapter _ CMB13 290B Operational Comm Processor _ CTL05 290B Operational Comm Adapter _ CMB14 6B04 Operational Comm Processor More... F3=Exit F5=Refresh F6=Print F12=Cancel
34.	From the IBM i command line, type the following to create the Ethernet line description for the virtual adapter: CRTLINETH LIND(VETHLINE) RSRCNAME(CMN37) BRIDGE(B1) Press the Enter key. Note: Carefully note the bridge name. This name, "B1" in our example, must match the name specified on the physical adapter line description in step 30 to form the bridge.
35.	From the IBM i command line, type the following to vary on the Ethernet line description: *VRYCFG CFGOBJ(VETHLINE) CFGTYPE(LIN) STATUS(ON)* Press the Enter key.
	The following diagram shows the resulting virtual network.

E.	Configure the Console
36.	Next, configure the LAN operations console for the new partition. - The partition id must match the partition number as shown in Virtual Partition Manager. The first guest is partition id 2, the 2nd is 3, and so on. - For initial bring up, the operations console pc should be cabled directly to the card port that acts as the bridge for the virtual network (the card and port identified in Step 29). This is required since the initial assignment of the console IP address relies on UDP broadcast frames which many network switches block. - After IBM i OS has been installed, the bridge adapter and console PC can be cabled to the network for remote access. - A TCP interface for the guest can be configured on the same 268C virtual Ethernet resource used for the console.

F.	Install the OS
37	From the IBM i command line, type the following to vary on the Network Server Description: *VRYCFG CFGOBJ(XPF61) CFGTYPE(NWS) STATUS(ON)* Press the Enter key.
38.	At this point, we assume that you already had set up an Image Catalog for IBM i installation and that it is loaded into OPTVRT01 virtual optical device.
39.	Now it is time to IPL the new partition. Press F3 to return to SST.
40.	Select Option 2, Work with active service tools, and press the Enter key. Work with Active Service Tools Type options, press Enter. 1=Select service tool 4=End service tool Option Service Tool Status _ Work with system partitions Active
41.	Select Option 1, Select service tool, next to Work with system partitions and press the Enter key. Work with System Partitions System: ZD8AP1 Attention: Incorrect use of this utility can cause damage to data in this system. See service documentation. Number of partitions . . . . . . . : 3 Partition release . . . . . . . . . : V7R1M0 Partition identifier . . . . . . . : 1 Partition name . . . . . . . . . . : ZD8AP1 * Select one of the following: 2. Work with partition status 3. Work with partition configuration 4. Clear configuration data 5. Create a new partition Selection _ F3=Exit F12=Cancel
40.	Select Option 2, Work with partition status, and press the Enter key. Work with Partition Status System: ZD8AP1 Type options, press Enter. 1=Power on 3=IPL restart 7=Delayed power off 8=Immediate power off 9=Mode normal 10=Mode manual A=Source A B=Source B C=Source C D=Source D Partition IPL IPL Reference Opt Identifier Name Source Mode State Codes __ 1 ZD8AP1 B Normal On __ 2 XPF71 A Manual Off __ 3 XPF61 D Manual Off
42.	Select Option 1, Power on, next to Partition XPF61 and press the Enter key. Work with Partition Status System: ZD8AP1 Type options, press Enter. 1=Power on 3=IPL restart 7=Delayed power off 8=Immediate power off 9=Mode normal 10=Mode manual A=Source A B=Source B C=Source C D=Source D Partition IPL IPL Reference Opt Identifier Name Source Mode State Codes __ 1 ZD8AP1 B Normal On __ 2 XPF71 A Manual On __ 3 XPF61 D Manual Power On C200 3150
43.	After a while, you will get the Install screen with just the language prompt. LANGUAGE FEATURE ===> 2924
44.	Press the Enter Key to continue. You will get the Confirm Language Group panel: Confirm Language Group Language feature . . . . . . . . . . . . . . : 2924 Press Enter to confirm your choice for language feature. Press F12 to change your choice for language feature.
45.	Press the Enter key to confirm your choice for language feature. You will get the Install Licensed Internal Code panel: Install Licensed Internal Code System: DH080001 Select one of the following: 1. Install Licensed Internal Code 2. Work with Dedicated Service Tools (DST) 3. Define alternate installation device
46.	Select Option 1, Install Licensed Internal Code, and press the Enter key. You will see this panel for a while: Install Licensed Internal Code System: DH080001 Select one of the following: 1. Install Licensed Internal Code 2. Work with Dedicated Service Tools (DST) 3. Define alternate installation device Selection 1
47.	You will see the Select Load Source Device: Select Load Source Device Type 1 to select, press Enter. Sys Sys I/O I/O Opt Serial Number Type Model Bus Card Adapter Bus Ctl Dev _ YXGC7SV47R8Q 6B22 050 255 30 0 0 0 0
48.	Type 1 next to the Device you want to select as the Load Source. and press the Enter key.
49.	You will get the Confirm Load Source Device panel: Confirm Load Source Device You have chosen the following device to be the load source. Press F10 to confirm your choice. Sys Sys I/O I/O Serial Number Type Model Bus Card Adapter Bus Ctl Dev YXGC7SV47R8Q 6B22 050 255 30 0 0 0 0
50.	Press F10 to confirm your choice and continue. You will get the Install Licensed Internal Code (LIC) panel: Install Licensed Internal Code (LIC) Disk selected to write the Licensed Internal Code to: Serial Number Type Model I/O Bus Controller Device YXGC7SV47R8Q 6B22 050 0 0 0 Select one of the following: 1. Restore Licensed Internal Code 2. Install Licensed Internal Code and Initialize system 3. Install Licensed Internal Code and Recover Configuration 4. Install Licensed Internal Code and Restore Disk Unit Data 5. Install Licensed Internal Code and Upgrade Load Source
51.	Select Option 2, Install Licensed Internal Code and Initialize system, and press Enter to continue. You will get the Install LIC and Initialize System - Confirmation panel: Install LIC and Initialize System - Confirmation Warning: All data on this system will be destroyed and the Licensed Internal Code will be written to the selected disk if you choose to continue the initialize and install. Return to the install selection screen and choose one of the other options if you want to perform some type of recovery after the install of the Licensed Internal Code is complete.
52.	Press F10 to continue the installation: Initialize the Disk - Status The load source disk is being initialized. Elapsed time in minutes . . . . . . . . : 0.0
53.	Then, you will see the Install Licensed Internal Code - Status panel: Install Licensed Internal Code - Status Install of the Licensed Internal Code in progress. +--------------------------------------------------+ Percent \| 15% \| complete +--------------------------------------------------+ Elapsed time in minutes . . . . . . . . : 0.5
54.	Once the installation of the Licensed Internal Code completes, an automatic IPL will take place. After that, you will be prompted to change the Service Tools User ID password. Once you do that, you will get the Disk Configuration Attention Report: Disk Configuration Attention Report Type option, press Enter. 5=Display Detailed Report Press F10 to accept all the following problems and continue. The system will attempt to correct them. Opt Problem _ New disk configuration
55.	Press F10 to accept and continue. You will get the IPL or Install the System panel: IPL or Install the System System: DH080001 Select one of the following: 1. Perform an IPL 2. Install the operating system 3. Use Dedicated Service Tools (DST) 4. Perform automatic installation of the operating system 5. Save Licensed Internal Code
5.	From here on, it is business as usual. For further information, review the Software Installation Guide.

Related publications

Creating IBM i Client Partitions UsingVirtual Partition Manager
http://www.redbooks.ibm.com/redpapers/pdfs/redp4806.pdf

Configuring the Windows Firewall for Operations Console
http://www-912.ibm.com/s_dir/slkbase.NSF/DocNumber/354061448

Running Operations Console in Vista or Windows 7
http://www-912.ibm.com/s_dir/slkbase.NSF/DocNumber/520706577

LAN Console Connection for Power6 and Power7 Quick Start
http://www-912.ibm.com/s_dir/slkbase.NSF/DocNumber/509240963

New System Setup - Beyond the Basic Console Connection
http://www-912.ibm.com/s_dir/slkbase.NSF/DocNumber/521205188

How to Change the Operations Console LAN IP Address
http://www-912.ibm.com/s_dir/slkbase.NSF/DocNumber/561389998

Service Device ID Option Not Available in SST
http://www-912.ibm.com/s_dir/slkbase.NSF/DocNumber/433140772

Using NWSD (Network Server Description) to Virtualize Optical Drive to
Share Optical Between i Partitions
http://www-01.ibm.com/support/docview.wss?uid=nas8N1011898

Installing a Hosted Partition from an Image Catalog
http://www-01.ibm.com/support/docview.wss?uid=nas8N1013156

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]

Historical Number

610132357

Was this topic helpful?

Document Information

Modified date:
08 September 2021

UID

nas8N1011358

Tips