Using the Work with Licensed Programs menu to install IBM licensed programs
If you have logical partitions, you must perform this procedure on each IBM® i logical partition to which you want to install the IBM licensed programs.
- If you are not already signed on to the system as the security
officer (QSECOFR user profile), do so now. Note: The IBM i Main Menu (or the menu you chose as your initial menu) appears on the console.
- If you are installing from an image catalog
(virtual media device), the setup instructions are in the topic Preparing to upgrade or replace software using an image catalog.
If you are installing from optical media, insert the volume of the licensed program that you want to install into the installation device. If this is a new installation, insert the first volume containing the operating system. For more information about the optical media you received with your order, see Latest version of media labels and their contents. Wait until the In Use indicator goes out before you continue.
- If you are installing from virtual optical storage using the Network File System, the setup instructions are in the topic Preparing to upgrade or replace software with virtual optical storage using the Network File System.
- Do the following to put the system in a restricted
state and filter the messages that appear.
- Type CHGMSGQ QSYSOPR *BREAK SEV(60) and press Enter.
- A message display could appear. Press Enter.
- Type ENDSBS *ALL *IMMED and press Enter.
- When the following message appears, press Enter to continue:
ENDSBS SBS(*ALL) command being processed - The message System ended to restricted condition appears. Press Enter to continue.
- Type CHGMSGQ QSYSOPR SEV(95) and press Enter.
- A message display could appear. Press Enter.
- Type GO LICPGM and press Enter.
- The Work with Licensed Programs display
appears.
LICPGM Work with Licensed Programs System: XXXX Select one of the following: Manual Install 1. Install all Preparation 5. Prepare for install Licensed Programs 10. Display installed licensed programs 11. Install licensed programs 12. Delete licensed programs 13. Save licensed programsIf you were referred here from step 4, complete this step and then return to step 5. If you are following the tasks in this topic and want to accept software agreements for your licensed programs individually, continue with step 7.
If you have many licensed programs to install, accepting them together is faster than accepting them individually through manual installation. If you want to preaccept your licensed program agreements all at one time, select option 5 (Prepare for install).
- Select the option to work with software agreements. If a licensed program that you want to install does not appear on the Work with Software Agreements display, use F22 (Restore software agreements). Otherwise, continue with the next step.
- Type a 5 to display the software agreements for the licensed programs that you want to install and press Enter. Press F14 to accept the software agreements and then return to the Work with Licensed Programs display.
- On the Work with Licensed Programs display,
either type 1 (Install all) or type 11 (Install
licensed programs). Read the following note to help you decide. Note: If you want to install all licensed programs that are on the distribution media, use Manual Install option 1, Install all. This will save time for the installation. If you want most of the licensed programs on the media, then Manual Install option 1 is also the preferred choice. You will have to delete the extra unwanted licensed programs. The Manual Install display appears after selecting Manual Install option 1.Type the following on this display:
- Install option: 2 (2=all products)
- Installation device: OPT01
- Replace if current: N
- Nonaccepted agreement: 2 (2=Display software agreement)
- Automatic IPL: N
In this example, OPT01 is used for the installation device. If you use a different naming convention, type the name that you have assigned to the installation device.
For more information about using option 1, refer to Manual installation Option 1. Install all.
Press Enter. If you typed 1, continue with step 11 of these instructions.
- If you typed 11, the Install
Licensed Programs display appears.
Page through the display to find the licensed programs you want. Type a 1 in the Option column next to the licensed programs to be installed.
Install Licensed Programs System: XXXX Type options, press Enter. 1=Install Licensed Product Option Program Option Description _ _______ _______ _ 5770SS1 Library QGPL _ 5770SS1 Library QUSRSYS _ 5770SS1 1 Extended Base Support _ 5770SS1 2 Online Information _ 5770SS1 3 Extended Base Directory Support _ 5770SS1 5 System/36 Environment _ 5770SS1 6 System/38 Environment _ 5770SS1 7 Example Tools Library _ 5770SS1 8 AFP Compatibility Fonts _ 5770SS1 9 *PRV CL Compiler Support _ 5770SS1 12 Host Servers _ 5770SS1 13 System Openness Includes More... F3=Exit F11=Display status/release F12=Cancel F19=Display trademarksNotes:- The following items are preselected if you are
installing licensed programs as part of a new system installation.
- 5770-SS1 Library QGPL
- 5770-SS1 Library QUSRSYS
- 5770-SS1 option 1, Extended Base Support
- 5770-SS1 option 3, Extended Base Directory Support
- 5770-SS1 option 30, QSHELL
- 5770-SS1 option 33, Portable App Solutions Environment
- 5770-DG1, IBM HTTP Server for i
- 5770-JV1, IBM Developer Kit for Java™
- 5770-JV1 option 11, Java SE 6 32 bit
- A licensed program you want to install might not be listed on
the Install Licensed Programs display. If a licensed program is not
listed, it can be added to the list by entering information into the
blank fields at the top of the list. After you press Enter, this product
then appears on the list with the other products.
- Type 1 in the Option column.
- Type the product identifier in the Licensed Program column.
- Type the product option value in the Product Option column.
- Press Enter.
When you are typing the product option, the system accepts only the following three values: *BASE, option number, or *ALL.- A value of *BASE installs only the base product of the associated product identifier.
- The product option number installs only the particular option of the associated product identifier. To be able to install options, you must install the base product (*BASE).
- A value of *ALL installs the base product and all options of the associated product identifier that are found on the media.
Keep in mind that licensed programs that you add will appear on the list with only the product identifier and will not give a descriptive name of the product. Also, you should check the documentation that came with the product to see whether there are any special instructions.
If you get a message that the product already appears in the list, scroll down to the product. Make sure that there is a 1 in the Option column. Make sure that it is selected for installation.
Press Enter.
- The following items are preselected if you are
installing licensed programs as part of a new system installation.
- The Confirm Install of Licensed Programs display appears on the console. Press Enter to confirm your choices.
- The Install Options display appears.
Install Options System: XXXX Type choices, press Enter. Installation device . . . OPT01 Name Objects to install . . . . 1 1=Programs and language objects 2=Programs 3=Language objects Nonaccepted agreement. . . 2 1=Do not install licensed program 2=Display software agreement Automatic IPL . . . . . . N Y=Yes N=NoType the following on this display:- Installation device: OPT01 (In this example, OPT01 is used for the installation device. If you use a different naming convention, type the name that you have assigned to the installation device.)
- Objects to install: 1
- Nonaccepted agreement: 2
- Automatic IPL: N
- One or both of the following displays show
the status of the licensed programs and language objects as they are
being installed on the system. You do not need to respond to these
status displays.
The following display is an example of the display that appears during the installation process.Installing Licensed Programs System: XXXX Licensed programs processed . . . . . . . . . . : 0 of XXX Licensed program install in progressInstalling Licensed Programs System: XXXX Licensed programs processed . . . . . . . . . . . . . . . : X of XXX Licensed Program Option Description Type 5770SS1 12 Host Servers 2924Note: This display shows which licensed programs and optional parts of licensed programs are being installed. After the *PGM objects and *LNG objects for each licensed program or optional part have been installed, the licensed program identifier disappears from the display and the number in the licensed programs processed field changes to show how many are processed. - You might see the Display Messages display. If you have
another media volume that contains licensed programs to load, you
can load it at this time. If you are installing from optical media,
wait for the In Use indicator to go out before responding to the message.
Display Messages System: XXXX Queue . . . . . : QSYSOPR Program . . . . : *DSPMSG Library . . . : QSYS Library . . . : Severity . . . . : 95 Delivery . . . : *BREAK Type reply (if required), press Enter. Load the next volume in optical device OPT01 (X G) Reply . . . . GType G and press Enter. After you load each volume, type G and press Enter. If there are no more volumes to load that contain licensed programs, or if you want to end the loading process, type X and press Enter.
- If a licensed program requires acceptance of a software
agreement, the Software Agreements display appears. Do either of the
following:
- Press F14 to accept the agreement and allow the licensed program to continue installing.
- Press F16 to decline the agreement and end the installation of that licensed program.
- The Work with Licensed Programs display
appears on your console when the installation process is completed.
One of the following messages appears on the bottom of the Work with
Licensed Programs display.
Work with licensed programs function not complete. Go to the topic Troubleshooting software installation problems to determine the problem.
Work with licensed programs function has completed. Continue with the next step.
- Verify the installed status values of your licensed programs
and check for compatibility. It is important to make sure all of your
licensed programs are compatible with the operating system.
Use LICPGM menu option 10 (Display licensed programs) to see the release and installed status values of the installed licensed programs. If the installed status value of a licensed program is *COMPATIBLE, it is ready for use. If the installed status value of a licensed program is *BACKLEVEL, the licensed program is installed, but its version, release, and modification is not compatible with the currently installed level of the operating system. Check the topic, Licensed program releases and sizes, to verify the current version, release, and modification of the licensed program. Installed status values lists the possible installed status value descriptions.
You have completed this task.
- Do you have more licensed programs or optional parts to install,
but they did not appear in the list displayed in step 8 (or could not be added to the list)?
- No. Go to the next step (step 2).
- Yes. Go to Using the Restore Licensed Programs command to install IBM or non-IBM licensed programs to install these licensed programs or optional parts.
- Do you need to install a secondary
language?
- No. Go to the next step (step 3).
- Yes. Go to Installing a secondary language and complete the instructions.
- You must complete the installation process before you put your system into operation. Go to Checklist: Completing the IBM i installation and complete the instructions.