How to configure a VIOS Media

Repository/Virtual Media Library (ex. AIX

Install/Restore) 
Question & Answer 
 
Question 
What's the procedure to install an AIX base ISO to an AIX partition using a
VIOS media repository? What's the procedure to create/use/remove a virtual
media repository? Can a mksysb ISO be restored through the virtual media
repository? 
Cause 
This document provides a step by step command line procedure for using a
virtual media repository or Virtual Media Library (VML) to install/restore an AIX
partition. 
This applies to VIOS version 2.2.x. 
Answer 
PART I. REQUIREMENTS BEFORE PROCEEDING 
PART II. PERFORMING NEW AIX INSTALL WITH VML 
PART III. PERFORMING MKSYSB RESTORE WITH MKSYSB ISO AND
VML 
 
LPAR Placement sheet 
  
PART I. REQUIREMENTS BEFORE PROCEEDING: 
Please ensure the following requirements are met before proceeding: 
1. There should be an existing pair of virtual scsi adapters paired between
the VIO server (vhost) and the VIO client (vscsi). Since the client may not have an
OS, the adapter pairing can be verified through the partition properties/profile on
the HMC or IVM. 
2. A basic understanding of managing VIO virtual optical devices. 
3. A basic understanding of the AIX Installation Menu and how to install
AIX. 
  
  
Back to top 
  
 
PART II. PERFORMING NEW AIX INSTALL WITH VML: 
Step 1: Obtain AIX base ISO image from ESS and store on the VIO server. 
AIX base ISO images can be obtained by contacting Entitled Software
Support (ESS) at 1-800-879-2755 option 2, option 2. The representatives
should be able to verify entitlement and guide customers on how to download
the ISO image. Once the AIX ISO image has been downloaded, the image
can be stored in the /home/padmin directory of the VIO server. 
$ ls -al /home/padmin/AIX_iso 
total 8687952 
drwxr-xr-x  2 padmin  staff         256 Apr 13 17:07 . 
drwxr-x---  9 padmin  system       4096 Apr 13 17:10 .. 
-rw-r--r--  1 root    staff  4448223232 Apr 13
17:08 AIX_6.1_Base_Operating_System_TL_6100-07-00_DVD_1_of_2_102011.iso 
 
Step 2: Create/Modify the media repository 
1. Create the repository in rootvg: 
$ mkrep -sp rootvg -size 6G 
Virtual Media Repository Created 
Repository created within "VMLibrary" logical volume 
2. Create the repository in a new VG: 
$ mkvg -vg <new volume group name> hdisk# 
$ mkrep -sp <repository name> -size 6G 
3. Increasing the size of the media repository: 
$ lsrep 
Size(mb) Free(mb) Parent Pool  Parent Size   Parent Free 
6118     6118     rootvg       139776        26624 
$ chrep -size 4G > Adds an additional 4GB to the
repository 
$ lsrep 
Size(mb) Free(mb) Parent Pool  Parent Size   Parent Free 
10198    10198    rootvg       139776        22528 
NOTE: Increasing the size is currently the only option. To reduce the size, the
repository will need to be removed and recreated. 
 
Step 3: Create the virtual media disk 
$ mkvopt -name <new media disk name> -file <ISO
filename> -ro 
Example: 
$ mkvopt -name base_61_TL7 -file /home/padmin/AIX_iso/A
IX_6.1_Base_Operating_System_TL_6100-07-
00_DVD_1_of_2_102011.iso -ro 
NOTE: This command may take a few minutes to complete. 
 
Step 4: Verify the virtual media disk is part of the repository 
$ lsrep 
Size(mb) Free(mb) Parent Pool  Parent Size   Parent Free 
10198    5955     rootvg       139776        22528 
Name              File Size   Optical    Access 
base_61_TL7       4243        None       ro 
 
Step 5: Create the file backed optical device and map it to a vhost: 
~ Shown without the vtopt device ~ 
 
$lsmap –all 
 
$ lsmap -vadapter vhost0 
SVSA            Physloc                      Client Partition ID 
--------------- ---------------------------- ------------------- 
vhost0          U9117.MMA.10708D0-V1-C11     0x00000002 
 
VTD                   L1_rootvg 
Status                Available 
LUN                   0x8100000000000000 
Backing device        lpar1_lv 
Physloc                 
Mirrored              N/A 
 
Create the vtopt device. 
$ mkvdev -fbo -vadapter vhost0 
vtopt0 Available 
 
~ Shown with the vtopt device ~ 
$ lsmap -vadapter vhost0 
SVSA            Physloc                       Client Partition ID 
--------------- ----------------------------- ------------------- 
vhost0          U9117.MMA.10708D0-V1-C11      0x00000002 
 
VTD                   vtopt0 
Status                Available 
LUN                   0x8200000000000000 
Backing device         
Physloc                 
Mirrored              N/A 
 
NOTE: Additional vtopt devices can be created and mapped to other vhosts.
Consequently, each vtopt device will appear as a virtual CD_ROM device on
the clients' side. Furthermore, the same virtual media disk (base_61_TL7 in
this example) can be simultaneously loaded (in Step 6) onto more than one
virtual optical (vopt) device allowing the same virtual media disk (ISO image)
to be used to install more than one AIX client at the same time. 
 
Step 6: Load the virtual media disk on the vtopt device: 
$ lsrep 
Size(mb) Free(mb) Parent Pool Parent Size Parent Free 
10198    5955    rootvg     139776     22528 
 
Name File Size Optical Access 
base_61_TL7 4243 None ro 
 
$ loadopt -vtd vtopt0 -disk base_61_TL7 
 
$ lsrep 
Size(mb) Free(mb) Parent Pool Parent Size Parent Free 
10198    5955    rootvg    139776     22528 
 
Name File Size Optical Access 
base_61_TL7 4243 vtopt0 ro 
 
 
 
 
 
 
Verify that the vtopt# backing device is the virtual media disk location. 
$lsmap -vadapter vhost0 
... 
VTD vtopt0 
Status Available 
LUN 0x8200000000000000 
Backing device /var/vio/VMLibrary/base_61_TL7 
Physloc 
Mirrored N/A 
 
Step 7: Boot the client partition from the virtual optical device: 
 
     A.) Activate the AIX Partition to the SMS Menu 
     B.) Select the virtual optical device (CD-ROM) 
 
SMS 1.7 (c) Copyright IBM Corp. 2000,2008 All rights reserved. 
------------------------------------------------------------------------------- 
Main Menu 
1. Select Language 
2. Setup Remote IPL (Initial Program Load) 
3. Change SCSI Settings 
4. Select Console 
5. Select Boot Options <<< 
 
Multiboot 
1. Select Install/Boot Device <<< 
2. Configure Boot Device Order 
3. Multiboot Startup <OFF> 
 
Select Device Type 
1. Diskette 
2. Tape 
3. CD/DVD 
4. IDE 
5. Hard Drive 
6. Network 
7. List all Devices <<< 
 
Select Device 
Device Current Device 
Number Position Name 
1. - Interpartition Logical LAN 
( loc=U9117.MMA.10708D0-V2-C3-T1 ) 
2. - SCSI CD-ROM 
( loc=U9117.MMA.10708D0-V2-C2-T1-L8200000000000000 ) <<< 
 
NOTE: The location code lun ID L8200000000000000 should match the LUN
ID of the vtopt mapped to the vhost: 
 
$lsmap -vadapter vhost0 
... 
VTD vtopt0 
Status Available 
LUN 0x8200000000000000 
Backing device /var/vio/VMLibrary/base_61_TL7 
Physloc 
Mirrored N/A 
 
SCSI CD-ROM 
( loc=U9117.MMA.10708D0-V2-C2-T1-L8200000000000000 ) 
 
1. Information 
2. Normal Mode Boot <<< 
3. Service Mode Boot 
 
Are you sure you want to exit System Management Services? 
1. Yes <<< 
2. No 
 
Upon exiting SMS, the AIX partition will boot up from the virtual optical device
to the AIX Installation Menus. 
 
Step 8: Install the AIX operating system. 
 
Step 9: Unloading the virtual media disk: 
$ unloadopt -vtd vtopt0 
 
Step 10: Removing the VM Library 
 
A.) Unmap the vtopt# VTDs from the vhost(s) 
$ rmvdev -vtd <VTDname> 
 
B.) Remove the virtual media disk(s) from the Virtual Media Repository: 
$ rmvopt -name <name of virtual optical disk> 
 
C.) Remove the repository: 
$ rmrep [-f] 
  
Back to top 
  
  
PART III: PERFORMING MKSYSB RESTORE WITH MKSYSB ISO AND
VML: 
 
Step 1: Check the remaining space of the repository and the size of
the mksysb ISO file (in this example, it will be cd_image_6357164): 
 
$ lsrep 
Size(mb) Free(mb) Parent Pool Parent Size Parent Free 
10198    5955    rootvg     139776     22528 
 
Name File Size Optical Access 
base_61_TL7 4243 None ro 
# ls -al 
total 38609016 
... 
-rw-r--r-- 1 root system 3120545792 Apr 25 19:01 cd_image_6357164 
... 
 
Step 2: Create the virtual media disk out of the mksysb ISO and add to the
repository: 
Note: The file must be a bootable, mksysb ISO file.  Prior to doing this
step, ensure the 
file is created as noted at Creating ISO image from a mksysb backup file. 
$ mkvopt -name lpar1_sysb -file /home/padmin/mount/cd_image_6357164 -
ro 
Step 3: Verify the new virtual media disk in the repository: 
$ lsrep 
Size(mb) Free(mb) Parent Pool Parent Size Parent Free 
10198    2979    rootvg     139776     22528 
 
Name File Size Optical Access 
base_61_TL7 4243 None ro 
lpar1_sysb 2976 None ro 
 
Step 4: As it was done in Part II Step 6, load the new mksysb virtual media
disk to the available virtual optical device mapped to the vhost: 
 
$ lsmap -vadapter vhost0 
SVSA Physloc Client Partition ID 
--------------- -------------------------------------------- ------------------ 
vhost0 U9117.MMA.10708D0-V1-C11 0x00000002 
 
VTD L1_rootvg 
Status Available 
LUN 0x8100000000000000 
Backing device lpar1_lv 
Physloc 
Mirrored N/A 
 
VTD vtopt0 
Status Available 
LUN 0x8200000000000000 
Backing device <== Available to add backing device 
Physloc 
Mirrored N/A 
 
Verify that the virtual media disk is assigned as the backing device: 
$ lsmap -vadapter vhost0 
SVSA Physloc Client Partition ID 
--------------- -------------------------------------------- ------------------ 
vhost0 U9117.MMA.10708D0-V1-C11 0x00000002 
 
VTD L1_rootvg 
Status Available 
LUN 0x8100000000000000 
Backing device lpar1_lv 
Physloc 
Mirrored N/A 
 
VTD vtopt0 
Status Available 
LUN 0x8200000000000000 
Backing device /var/vio/VMLibrary/lpar1_sysb 
Physloc 
Mirrored N/A 
 
Follow Step 6 and Step 7 to boot the client LPAR and restore from the virtual
media disk. 
 
Step 5: Restoring a mksysb with multiple volumes 
 
Locate the directory with your multiple ISO images. 
 
NOTE: Ensure that the volume order (vol1,vol2, etc.) are identifiable to reduce
the probability of corrupting the restore. 
 
$ ls -al /home/padmin/mount/*lpar2* 
total 6139912 
drwxr-xr-x 2 root system 256 Apr 26 07:21 . 
drwxr-xr-x 5 root system 4096 Apr 25 22:28 .. 
-rw-r--r-- 1 root system 674078720 Apr 26 00:24 cd_image_3014874.vol1 
-rw-r--r-- 1 root system 676304896 Apr 26 02:20 cd_image_3014874.vol2 
-rw-r--r-- 1 root system 676304896 Apr 26 04:10 cd_image_3014874.vol3 
-rw-r--r-- 1 root system 676304896 Apr 26 05:56 cd_image_3014874.vol4 
-rw-r--r-- 1 root system 440211456 Apr 26 07:21 cd_image_3014874.vol5 
 
(Total Sum of ISO file sizes = 3143204864 or 3.143 G) 
 
Ensure that the repository has enough space: 
 
$ lsrep 
Size(mb) Free(mb) Parent Pool Parent Size Parent Free 
10198    2979     rootvg     139776      22528 
 
Name File Size Optical Access 
base_61_TL7 4243 None ro 
lpar1_sysb 2976 vtopt0 ro 
 
The repository needs more space. Increase the size of the repository. 
$ chrep -size 2G 
 
Check the space available. 
$ lsrep 
Size(mb) Free(mb) Parent Pool Parent Size Parent Free 
12238    5019     rootvg     139776     20480 
 
Name File Size Optical Access 
base_61_TL7 4243 None ro 
lpar1_sysb 2976 vtopt0 ro 
 
Now, create the virtual media disks out of each volume. 
 
Volume1 
$ mkvopt -name lpar2_sysb_vol1 -file /home/padmin/mount/vioc_lpar2_ba
ckup/cd_image_3014874.vol1 
 
Volume2 
$ mkvopt -name lpar2_sysb_vol2 -file /home/padmin/mount/vioc_lpar2_ba
ckup/cd_image_3014874.vol2 
 
Volume3 
$ mkvopt -name lpar2_sysb_vol3 -file /home/padmin/mount/vioc_lpar2_ba
ckup/cd_image_3014874.vol3 
 
Volum4 
$ mkvopt -name lpar2_sysb_vol4 -file /home/padmin/mount/vioc_lpar2_ba
ckup/cd_image_3014874.vol4 
 
Volume5 
$ mkvopt -name lpar2_sysb_vol5 -file /home/padmin/mount/vioc_lpar2_ba
ckup/cd_image_3014874.vol5 
 
Verify that all of the volumes have been made into a virtual disk: 
$ lsrep 
Size(mb) Free(mb) Parent Pool Parent Size Parent Free 
12239    2022     rootvg     139776     20480 
 
Name File Size Optical Access 
base_61_TL7 4243 None ro 
lpar1_sysb 2976 vtopt0 ro 
lpar2_sysb_vol1 643 None rw 
lpar2_sysb_vol2 645 None rw 
lpar2_sysb_vol3 645 None rw 
lpar2_sysb_vol4 645 None rw 
lpar2_sysb_vol5 420 None rw 
 
Check that a vtopt has been mapped to the appropriate vhost serving the
client and that the backing device is available: 
$ lsmap -vadapter vhost1 
SVSA Physloc Client Partition ID 
--------------- -------------------------------------------- ------------------ 
vhost1 U9117.MMA.10708D0-V1-C12 0x00000003 
 
VTD L2_rootvg 
Status Available 
LUN 0x8100000000000000 
Backing device lpar2_lv 
Physloc 
Mirrored N/A 
 
VTD vtopt1 
Status Available 
LUN 0x8200000000000000 
Backing device <== Available for a virtual media disk from repository 
Physloc 
Mirrored N/A 
 
Load volume 1 of the virtual media disks to the virtual optical device: 
$ loadopt -vtd vtopt1 -disk lpar2_sysb_vol1 
 
Verify it's been assigned as the backing device: 
$ lsmap -vadapter vhost1 
... 
VTD vtopt1 
Status Available 
LUN 0x8200000000000000 
Backing device /var/vio/VMLibrary/lpar2_sysb_vol1 
Physloc 
Mirrored N/A 
 
 
Boot the client from the virtual optical device and begin the install with virtual
media disk volume 1 (Follow Part II Steps 7 and 8) 
 
When prompted for volume 2 (and every additional volume) "Please remove
volume 1, insert volume 2, and press the ENTER key.", on the VIOS we'll
need to unload the current volume and load the next volume: 
 
Example: 
$ unloadopt -vtd vtopt1 
$ set -o vi 
$ loadopt -vtd vtopt1 -disk lpar2_sysb_vol2 
 
     Back
on the client getting installed, strike ENTER/RETURN to begin reading
from the second volume and continue the install. 
 
     Continue
the process of unloading and loading the virtual media disk
volumes in order as the client asks for them until the restore has completed.