Creating IBM I Client Partition
Creating IBM I Client Partition
ibm.com/redbooks
partition creates the virtual SCSI and virtual Ethernet adapters for the client partitions. The user can then 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 IBM i Client partitions can be IBM i 7.1 or IBM i 6.1 with either 6.1 or 6.1.1 machine code. A PowerVM license is required to partition the server using VPM.
Note: Use the selected Ethernet resources only for layer-2 bridging (not for IBM i TCP/IP configuration). Even when you can use it for TCP/IP, there is significant processing overhead for any host traffic that uses bridged resources.
Common errors
CHGLINETH cannot be used to change the Bridge identifier of a line description that was created prior to the latest TR. If equivalent behavior is desired: 1. Use the Copy option on WRKLIND to make a temporary copy of the line description. 2. Delete the existing line description. 3. Use the Copy option again on WRKLIND to replicate the original line description, specifying the desired Bridge identifier. 4. 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 is 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 previously mentioned, 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 is 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.
Note: In IBM i V7R1, an Ethernet line description's Bridge identifier is not visible from DSPLIND. Use the CHGLINETH command and prompt to see the Bridge identifier for an Ethernet line description.
2. Press Enter. 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 Enter. If this is the first time, you will see an initial information panel similar to Figure 2. Logical Partitioning Environment Supported System: 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.
Figure 2 Logical Partitioning Environment Supported panel
ZD8AP1
4. Press Enter. The Work with System Partitions panel is displayed, as shown in Figure 3. 4
Creating IBM i Client Partitions Using Virtual Partition Manager
Work with System Partitions System: Attention: Incorrect use of this utility can cause damage to data in this system. See service documentation. Number of partitions . . . . . . . : Partition release . . . . . . . . . : Partition identifier . . . . . . . : Partition name . . . . . . . . . . : Select one of the following: 2 V7R1M0 1 ZD8AP1 ZD8AP1
2. 3. 4. 5.
Work with partition status Work with partition configuration Clear configuration data Create a new partition
5. Select option 3, Work with partition configuration, and press Enter. The Work with Partition Configuration panel is displayed, as shown in Figure 4 on page 6.
Work with Partition Configuration System: Available processor units . . . . : Available memory (MB) . . . . . . : Memory region size (MB) . . . . . : Type option, press Enter. 1=Display 2=Change 9=Delete Virtual Ethernet ID WLM 1 2 3 4 2 1 2 2 2 2 3 2 2 2 2.90 3808 32 ZD8AP1
F3=Exit
F5=Refresh
F12=Cancel
6. If from the previous panel you perceive there are not enough resources (processor units and memory, highlighted) to define a new IBM i partition, edit your host partition (Partition ID 1) to remove some resources, and make them available for the guest partitions. Note: Considering that Virtual Partition Manager does not support dynamic movement of resources, you might want to define your partitions as uncapped partitions to automatically assign unused processing units to a partition that needs the resources. 7. Press F3. Select option 5, Create a new partition, and press Enter. The Select Operating Environment Panel is displayed, as shown in Figure 5 on page 7.
Select Operating Environment System: Select one of the following: 1. OS/400 2. Guest ZD8AP1
8. Select option 1, OS/400, and press Enter. The Create New Partition Panel is shown. Complete the fields (highlighted), as shown in Figure 6 on page 8.
Create New Partition System: Complete blanks, press Enter. Partition identifier and name . . . . . . . . . . . . . . . . . . . . : . . . . . . . : . . . 3 XPF61 ZD8AP1
Number of available system processors . . Number of partition processors . . . . . . Minimum / maximum number of processors . . Use shared processor pool . . . . . . . . Shared processor pool units . . . . . . Minimum / maximum processor pool units . Uncapped processing . . . . . . . . . . Uncapped processing weight . . . . . . Size of available memory (MB) . . . . . . Size of partition memory (MB) . . . . . . Minimum / maximum size of memory (MB) . . Enable workload management . . . . . . . . Virtual Ethernet Identifiers (1=Yes, 2=No) 1 2 3 4 3 2 2 2 F3=Exit F12=Cancel
2 1 1 / 1 1 1=Yes, 2=No 0 . 10 0 . 10 / 1 . 00 1 1=Yes, 2=No 128 0, 64, 128, 255 3808 1536 _ 1024 / 1536 2 1=Yes, 2=No
Figure 6 Create New Partition panel - Entering the values for the new partition
Note: you must use option 3 for the Virtual Ethernet ID 1 to select it as the console device. 9. Press Enter twice. A confirmation message is displayed, as shown in Figure 7. Partition 3 create was successful.
10.Press F16. Select option 1, Start a service tool, and press Enter. 11.Select option 7, Hardware service manager, and press Enter. 12.Select option 1, Packaging hardware resources (systems, frames, cards,...), and press Enter. The Packaging Hardware Resources panel is displayed, as shown in Figure 8 on page 9.
Packaging Hardware Resources Local system type . . . . : Local system serial number: 9409 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 TypeModel 9409-E8A 78A0-001 268C-001 6380-001 Resource Name SYS01 FR01 P21 DE01 SD001
Opt Description _ System _ System Unit _ Virtual Backplane _ Disk Unit System _ Tape Unit
+ + +
<
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
Figure 8 Packaging Hardware Resources panel
13.Select option 9, Hardware contained within package, next to Virtual Backplane, and press Enter. The details for the Virtual Backplane are displayed. Page down until you find the first resource with a location code of V1-C330, as shown in Figure 9 on page 10. Note: Every time you create an IBM i Client Partition using Virtual Partition Manager, 3 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.
Packaging Hardware Resources Unit ID: Type options, press Enter. 2=Change detail 3=Concurrent maintenance 4=Remove 8=Associated logical resource(s)
TypeOpt Description _ _ _ _ _ _ _ _ Virtual Comm IOA Virtual Comm Port Virtual Comm IOA Virtual Comm IOA Virtual Comm IOA Virtual Comm IOA Virtual Comm IOA Virtual Comm IOA Model
Resource Name Location V1-C7 V1-C7-T1 V1-C230 V1-C231 V1-C232 V1-C330 V1-C331 V1-C332
268C-002 P65 268C-002 P66 290B-001 P46 290B-001 P47 290B-001 P48 290B-001 P51 290B-001 P52 290B-001 P53
Bottom
F3=Exit F5=Refresh F6=Print F7=Include empty positions and not owned positions F8=Exclude non-reporting resources F12=Cancel F10=Non-reporting resources F13=Unresolved locations
Figure 9 Packaging Hardware Resources panel - Locating the Virtual Comm IOA
14.Select option 8, Associated logical resource(s), next to Virtual Comm IOA resource you identified in the previous step, and press Enter. The Logical Resources Associated with a Packaging Resource panel is displayed, as shown in Figure 10 on page 11.
10
Logical Resources Associated with a Packaging Resource Packaging resource: Virtual Comm IOA Type-Model Resource Name 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 _ Virtual Comm IOA _ Virtual IOP Type-Model Resource Name Status 290B-001 CTL06 Operational 290B-001 CMB15 Operational
F3=Exit
F5=Refresh
F6=Print
F12=Cancel
Write down the Resource Name for the Virtual Comm IOA.
15.Press F3 twice. Press F10. You will access the IBM i command line. 16.From the IBM i command line, type the command in Figure 11 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)
Figure 11 CRTNWSD command
Note: We are excluding OPT01 because we are going to use Virtual Media Images to install SLIC. 17.Press Enter. From the IBM i command line, type the command in Figure 12 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)
Figure 12 CRTNWSSTG command
11
18.Press Enter. After the creation of the Network Storage Space finishes, from the IBM i command line, type the command in Figure 13 to link the Network Storage Space to the Network Server Description. ADDNWSSTGL NWSSTG(XPF61) NWSD(XPF61)
Figure 13 ADDNWSSTGL command
19.Press Enter. Assume that the Ethernet line description that is associated to the host partition is ETHLINE. From the IBM i command line type the command in Figure 14 to retrieve the Bridge Identifier. CHGLINETH LIND(ETHLINE) + F4
Figure 14 CHGLINETH command
The details of the Ethernet line description are displayed, as shown in Figure 15.
Change Line Desc (Ethernet) (CHGLINETH) Type choices, press Enter. Line description . Resource name . . *NWID... Bridge identifier Online at IPL . . Vary on wait . . . . . . . . . . > ETHLINE . . . . . . . CMN08 . . . . . . . . . . . . . . . . . . . . . B1 *YES *NOWAIT Name Name, *SAME, *AGG, Name, *SAME, *NONE *SAME, *YES, *NO *NOWAIT, 15-180 seconds
Bottom F3=Exit F4=Prompt F24=More keys F5=Refresh F12=Cancel F13=How to use this display
Note: If the Bridge identifier is currently set to *NONE, you must vary off the line and then change the line description to include a Bridge identifier. For further information, review Common errors on page 3.
12
20.Write the Bridge identifier down, and press F3. From the IBM i command line, type the command in Figure 16 to identify the Virtual Ethernet Resource. DSPHDWRSC TYPE(*CMN)
Figure 16 DSPHDWRSC command
21.Press Enter. The Display Communication Resources panel is displayed, as shown in Figure 17. Page down until you locate the first Ethernet port of type 268C, and write it down.
Display Communication Resources System: ZD8AP1 Type options, press Enter. 5=Display configuration descriptions Opt _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Resource LIN04 CMN07 CMN08 CMB10 CTL02 CMB25 LIN11 CMN37 CMB11 CTL03 CMB12 CTL04 CMB13 CTL05 CMB14 Type 5767 5767 5767 6B20 6B20 268C 268C 268C 290B 290B 290B 290B 290B 290B 6B04 Status Operational Operational Operational Operational Operational Operational Operational Operational Operational Operational Operational Operational Operational Operational Operational
7=Display resource detail Text LAN Adapter Ethernet Port Ethernet Port Comm Processor Comm Adapter Comm Processor LAN Adapter Ethernet Port Comm Processor Comm Adapter Comm Processor Comm Adapter Comm Processor Comm Adapter Comm Processor
More... F3=Exit
F5=Refresh
F6=Print
F12=Cancel
22.From the IBM i command line, type the command in Figure 18 to create the Ethernet line description to be linked to the host Ethernet line description. CRTLINETH LIND(VETHLINE) RSRCNAME(CMN37) BRIDGE(B1)
Figure 18 CRTLINETH command
23.Press Enter. From the IBM i command line, type the command in Figure 19 on page 14 to vary on the Ethernet line description.
13
24.Press Enter. From the IBM i command line, type the command in Figure 20 to vary on the Network Server Description. VRYCFG CFGOBJ(XPF61) CFGTYPE(*NWS) STATUS(*ON)
Figure 20 VRYCFG command - Varying on the Network Server Description
25.Press Enter. At this point, we assume that you already set up an Image Catalog for IBM i installation and that it is loaded into OPTVRT01 virtual optical device. 26.Configure the LAN console of the new partition. 27.It is time to IPL the new partition. Press F3 to return to SST, as shown in Figure 21.
System Service Tools (SST) Select one of the following: 1. 2. 3. 4. 5. Start a service tool Work with active service tools Work with disk units Work with diskette data recovery Work with system partitions
7. Work with system security 8. Work with service tools user IDs and Devices
28.Select option 2, Work with active service tools, shown in Figure 22 on page 15. Press Enter.
14
Work with Active Service Tools Type options, press Enter. 1=Select service tool Option _
F3=Exit
F5=Refresh
F12=Cancel
F16=SST menu
29.Select option 1, Select service tool, to Work with system partitions, as shown in Figure 23 on page 16. Press Enter.
15
Work with System Partitions System: Attention: Incorrect use of this utility can cause damage to data in this system. See service documentation. Number of partitions . . . . . . . : Partition release . . . . . . . . . : Partition identifier . . . . . . . : Partition name . . . . . . . . . . : Select one of the following: 3 V7R1M0 1 ZD8AP1 ZD8AP1
2. 3. 4. 5.
Work with partition status Work with partition configuration Clear configuration data Create a new partition
30.Select option 2, Work with partition status, and press Enter. The Work with Partition Status panel is displayed, as shown in Figure 24 on page 17.
16
Work with Partition Status System: Type options, press Enter. 1=Power on 3=IPL restart 7=Delayed power off 9=Mode normal 10=Mode manual A=Source A B=Source B C=Source C Partition Identifier 1 2 3 IPL Source B A D IPL Mode Normal Manual Manual ZD8AP1
Opt __ __ __
31.Select option 1, Power on, next to Partition XPF61, as shown in Figure 25 on page 18. Press Enter. The Reference Codes are displayed while the IPL is progresses.
17
Work with Partition Status System: Type options, press Enter. 1=Power on 3=IPL restart 7=Delayed power off 9=Mode normal 10=Mode manual A=Source A B=Source B C=Source C Partition Identifier 1 2 3 IPL Source B A D IPL Mode Normal Manual Manual ZD8AP1
Opt __ __ __
State On On Power On
C200 3150
Figure 25 Work with Partition Status panel - IBM i Client partition IPL in progress...
18
Online resources
Installing, upgrading, or deleting IBM i and related software http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/topic/rzahc /sc415120.pdf Preparing an optical image catalog to install software http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/topic/rzahc/scenariopre pareimagecatalog.htm Installing IBM i fixes from an image catalog http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/topic/rzam8/rzam8fixins tallimage.htm IBM i virtual optical storage http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/topic/rzam4/rzam4virtua l.htm
19
Hernando Bedoya is a Senior IT Specialist at STG Lab Services and Training, in Rochester, Minnesota. He writes extensively and teaches IBM classes worldwide in all areas of DB2 for i. Before joining STG Lab Services he worked in the ITSO for nine years writing multiple IBM Redbooks publications. He also worked for IBM Colombia as an IBM AS/400 IT Specialist doing presales support for the Andean countries. He has 25 years of experience in the computing field and has taught database classes in Colombian universities. His areas of expertise are database technology, performance, and data warehousing. He has a Masters degree in Computer Science from EAFIT, Colombia.
Thanks to the following people for their contributions to this project: Ahmed Mansour IBM Software Engineer ECM for SAP, Egypt Bob Jacobsen IBM GTS Service Delivery, Rochester MN Data Center Jenifer Servais IBM Redbooks (ITSO Global Content Services), Rochester MN Jiri Sochr IBM Delivery Center Central Europe, Brno, Czech Republic Michael Harper IBM ANZ Techline, Australia Tom Vernaillen IBM MTS, Belgium
20
Comments welcome
Your comments are important to us! We want our papers to be as helpful as possible. Send us your comments about this paper or other IBM Redbooks publications in one of the following ways: Use the online review Redbooks form found at the following address: http://www.redbooks.ibm.com Send your comments in an email to: [email protected]
21
22
Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, NY 10504-1785 U.S.A. The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.
Copyright International Business Machines Corporation 2011. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
23
This document REDP-4806-00 was created or updated on October 26, 2011. Send us your comments in one of the following ways: Use the online Contact us review Redbooks form found at: ibm.com/redbooks Send your comments in an email to: [email protected] Mail your comments to: IBM Corporation, International Technical Support Organization Dept. HYTD Mail Station P099 2455 South Road Poughkeepsie, NY 12601-5400 U.S.A.
Redpaper
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. These and other IBM trademarked terms are marked on their first occurrence in this information with the appropriate symbol ( or ), indicating US registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml The following terms are trademarks of the International Business Machines Corporation in the United States, other countries, or both:
AS/400 DB2 eServer Express Servers i5/OS IBM iSeries OS/400 Power Systems POWER4 POWER5 POWER6 POWER7 Redbooks Redpaper Redbooks (logo) System i
The following terms are trademarks of other companies: SAP, and SAP logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others.
24