These steps show how you create an image
catalog and an image catalog entry, add an image catalog entry, and
load the image catalog in preparation of performing an IBM® i software upgrade.
The steps use a virtual optical device in the example. The server
setup requires an image catalog setup that will then be shared with
the client partition.
- Create a virtual optical device.
To create a device description, enter the following:
CRTDEVOPT DEVD(virtual-device-name) RSRCNAME(*VRT)+
ONLINE(*YES) TEXT(text-description)
- Vary on the virtual optical device
Enter
the following:
VRYCFG CFGOBJ(virtual-device-name) CFGTYPE(*DEV) STATUS(*ON)
- Create an image catalog
Create an
image catalog for the licensed programs that you want to install.
The Create Image Catalog (CRTIMGCLG) command associates an image catalog
with a target directory where the optical image files are loaded.
CRTIMGCLG IMGCLG(catalog-name) DIR(catalog-path)
CRTDIR(*YES) TEXT(text-description)
- Add an image catalog entry
Add an
image catalog entry for each physical media or optical image file
that you have. You need to repeat this step for each volume of media.
You should add the physical media or optical image files in the same
order as if you were going to install from them. Start with the first
media in the list and continue until all the media are loaded.
You
can add the entries from either an optical device or from an existing
optical image file. Select one of the following ways:
From an
image file:
- (This is the fastest way.) To add an image entry to an image catalog
from an integrated-file-system file that is already in the image catalog
directory, enter the following:
ADDIMGCLGE IMGCLG(catalog-name) FROMFILE(file-name)
TOFILE(*fromfile) TEXT(text-description)
- To add an image catalog entry to an image catalog from an existing
integrated-file-system optical image file from a directory other than
the image catalog directory, enter the following:
ADDIMGCLGE IMGCLG(catalog-name)
FROMFILE(/directory-name/directory-name/file-name)
TOFILE(file-name or *FROMFILE) TEXT(text-description)
From a physical device:
Note: To generate a name for the TOFILE parameter, specify *GEN.
To generate a text description from the media, specify *GEN.
- Load the image catalog
This step associates the virtual optical device to the image
catalog. Only one image catalog at a time can be associated with a
specific virtual optical device. To load the image catalog, type the
following command:
LODIMGCLG IMGCLG(catalog-name)
DEV(virtual-device-name) OPTION(*LOAD)
- Verify that the images are
in the correct order
If
you are preparing for an upgrade, you need to verify that the required
media for an upgrade exist and are sorted in the correct sequence.
You also need to verify that your software agreements have been accepted,
that you have enough storage on the load source, and that you have
enough reserved storage for the Licensed Internal Code.
Enter
the following command:
VFYIMGCLG IMGCLG(catalog-name) TYPE(*UPGRADE) SORT(*YES)
To
verify that images are added, an additional method would be to enter
the following:
WRKIMGCLGE IMGCLG(catalog-name)
Then
press PF7 to prompt for the VFYIMGCLG command. Enter *UPGRADE for
the type and *YES for the sort field.
The
system puts the images in the correct order. (If you are not successful,
refer to Image catalog recovery.)
By default, the volume with the lowest index is mounted. Then all
the other volumes are loaded. To see the order of the images, use
the Work with Image Catalog Entries (WRKIMGCLGE) command:
WRKIMGCLGE IMGCLG(catalog-name)
After completing these steps, your image catalog is ready
for use.