Replacing the Licensed Internal Code

Follow these steps to replace the Licensed Internal Code by using the manual installation method.

Start of change As you perform these steps, reference codes appear on the data display of the control panel or the virtual control panel of the Hardware Management Console (HMC) or Integrated Virtualization Manager. When the system attention light is on and a reference code starting with A6 appears, the system is waiting for you to respond to a message or make a device ready. When this information lists a reference code with xx (such as A6xx 6001), it means that any combination of characters can occur where the xx appears. The console can also display reference codes during the installation of Licensed Internal Code. For more details about reference codes, refer to Reference codes for IBM i software installation. End of change

Start of change If you are using image catalogs, then you must complete steps 1 through step 5 in the topic Preparing to upgrade or replace software using an image catalog. Then return to this topic. In the following procedures, ignore the steps that refer to loading volumes. End of change

Start of change If you are using virtual optical storage using the Network File System, then you must complete the steps in the topic Preparing to upgrade or replace software with virtual optical storage using the Network File System. Then return to this topic. In the following procedure, ignore the steps that refer to loading volumes. End of change

If you have not previously performed an IPL to change the disk configuration (optional), you must do this IPL now before you power down the system or logical partition in step 8.
If you are using an image catalog (virtual media device) to upgrade, perform this step at least a day before you do the actual installation. If you are not using an image catalog, go to step 3.
To verify the image catalog entries are sorted in the correct sequence and to validate that all your images are in loaded status, enter the following command:
```
WRKIMGCLGE IMGCLG(catalog-name)
```
Ensure your catalog is in ready status and that all image catalog entries are in loaded or mounted status. To sort and verify your image catalog for installation, press PF7 to prompt for the VFYIMGCLG command. Enter *UPGRADE for the type and *YES for the sort field.

Another method to sort and verify your image catalog is to enter the following command to put the images in the correct order. By default, the volume with the lowest index is mounted. Then all the other volumes are loaded.
```
VFYIMGCLG IMGCLG(catalog-name) TYPE(*UPGRADE) SORT(*YES)
```
After you ensure that your images are in loaded status, continue with step 4.
If you are using physical media to upgrade, arrange the installation media that you plan to install in the following order (you might not have all of these). Verify that your media contains the correct primary language.
1. Licensed Internal Code for IBM i.
2. IBM i operating system, IBM-supplied libraries QGPL and QUSRSYS, and all IBM i no-charge options.
3. No-charge licensed programs and keyed products.
4. Single licensed programs.
Keep the following installation media available for later use:
1. Secondary Language Media
2. Cumulative PTF Package (if ordered, Cydddvrm_01 )
For descriptions of the optical media, refer to Media labels and their contents.
On your console, ensure that you have a connection to the system. If you are working on a logical partition, ensure that power is on for the console of that logical partition.
If you are upgrading a logical partition, verify that this partition has an alternate initial program load (IPL) resource assigned. For most cases, this is the optical device that supports the optical media class.
For more information about locating and selecting the alternate IPL resource, see the I/O devices topic.
If you are using physical media, load the first volume of installation media that contains Licensed Internal Code into the installation device that is defined for the system. Throughout these procedures, load the next volume when prompted by the system. Wait for the In Use indicator to go out. Also ensure that you have removed other media from devices that are not involved in these procedures.
1. If you are using a tape device instead of an optical device, verify that the tape unit is varied on and allocated to your system.
2. If you are using a device that is enabled as an alternate installation device, you need to load the Licensed Internal Code media in your primary device and your installation media in your alternate installation device. Your installation will fail if both media do not contain the same release level of Licensed Internal Code. For more information, see Using an alternate installation device.
Use the control panel to set the mode selection to Manual. If you are upgrading a logical partition, use the virtual control panel function of your HMC or Integrated Virtualization Manager. Also make sure that you have already selected the alternate IPL device before you perform the initial program load (IPL) in the next step.
Power down the system or logical partition:
- If you are using an image catalog to do the upgrade, ensure you have reviewed Information APAR II14482 in the preventive service planning information from the Support for System i® Web page. Select the link for technical databases; then select the link for Authorized Problem Analysis Reports (APARs). Follow the instructions in the section entitled For upgrading to Version 7 Release 1 using virtual media, the following PTFs must be applied.
  After you have loaded and applied the appropriate PTFs, type the following:
```
PWRDWNSYS OPTION(*IMMED) RESTART(*YES) IPLSRC(*IMGCLG)
 IMGCLG(catalog-name)
```
- If you are using a virtual optical storage using the Network File System to do the upgrade, ensure you have reviewed Information APAR II14482 in the preventive service planning information from the Support for System i Web page. Select the link for technical databases; then select the link for Authorized Problem Analysis Reports (APARs). Follow the instructions in the section entitled For upgrading to Version 7 Release 1 using virtual optical storage using the Network File System, the following PTFs must be applied.
  After you have loaded and applied the appropriate PTFs, type the following:
```
STRNETINS DEV(virtual-device-name) OPTION(*ALL) KEYLCKMOD(*MANUAL)
```
- If you are performing any other upgrade, type the following and press Enter:
```
PWRDWNSYS OPTION(*IMMED) RESTART(*YES) IPLSRC(D)
```
Powering down could take approximately 15 minutes or more for this step. The data display area of the control panel continues to display reference codes.
If the system attention light appears and a reference code listed in the topic Reference codes for IBM i software installation appears in the data display on the control panel, complete the instructions for that reference code.
If you are upgrading a logical partition, the system attention light will not appear. You must monitor the logical partition reference codes from the HMC or Integrated Virtualization Manager. When the State changes to Failed, that is the equivalent of having the attention light on for the logical partition.
If you are using an image catalog (virtual media device) to upgrade, go to step 17.
The Select a Language Group display shows the service tools language that is currently installed on the system.
Note: The installation media for Licensed Internal Code is language-independent. It is important that you complete this step carefully.
```
               Select a Language Group
 
 
   The language feature shown is the service tools
   language feature installed on the system.
 
   Attention: To keep the same language, ensure that the
   media you use for installing the operating system
   matches the language feature shown.  If the operating
   system media does not match what is shown, the
   installation process will attempt to install the
   operating system in a different language feature than
   Licensed Internal Code.
 
 
   Type choice, press Enter.
 
     Language feature . . . . . . . . . . . . . .   2924
 
 
 
```
To keep the same service tools language, verify that the displayed language feature matches the service tools language that you want.
Note: The language you select and the language of the operating system typically should match. If they do not match, your service tools language will be different than your primary language.

To change the service tools language to match the primary language, type the language feature of your primary language. Press Enter.

Refer to Feature codes for language version for a list of the language feature codes.

After you enter the language feature, the Confirm Language Group display appears.

               Confirm Language Group
 
 
   Language feature  . . . . . . . . . . . . . . :   2924
 
   Press Enter to confirm your choice for language feature.
   Press F12 to change your choice for language feature.

Press Enter.

The Install Licensed Internal Code display appears.
```
                        Install Licensed Internal Code
                                                         System: XXXX
 Select one of the following:
 
      1. Install Licensed Internal Code
      2. Work with Dedicated Service Tools (DST)
      3. Define alternate installation device
 
```
Either select the option to install Licensed Internal Code or the option to define an alternate installation device:
- If you are not using an alternate installation device, type 1 (Install Licensed Internal Code). (The alternate installation device function supports installation from optical or tape media that you have created. The topic Using an alternate installation device describes when you can use an alternate installation device.) If you are not using an alternate installation device, continue with step 16.
- If you have an alternate installation device attached to the system, type 3 to verify its address and determine whether it is enabled or disabled. Continue with the Verifying Alternate Installation Device Subtask in step 14. If you have an alternate installation device configured and do not want to use it, type 3 to clear the alternate installation device configuration information.
Press Enter.

Verifying and selecting alternate installation device subtask: The Select Alternate Installation Device Bus display appears.

                    Select Alternate Installation Device Bus                      
                                                               System: XXXX  
Type Option, press Enter.                                                     
   1=Select                                                                   
                                                                              
Option      Bus Number          Selected                                      
  _             1                                                             
  _             2                                                             
  1             3                  *                                          
  _             4                                                             
  _             10                                                            
  _             11                                                            
  _             12                                                            
  _             13                                                            
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                              More.....       
F2=Deselect Device  F3=Exit       F12=Cancel

Verify that the selected device is on the correct system bus. Type 1 in the Options field next to the selected bus, and press Enter to view information about the device that is attached to the bus. This might take several minutes. If you see the message No alternate installation device configured, wait one minute and refresh the display.
When the Select Media Type display appears, select 1 for tape or 2 for optical media. Press Enter.

The Select Alternate Installation Device display appears. Use this display to verify the resource name, type, model, and serial number for the device. The following display shows an example of a tape device.

                      Select Alternate Installation Device
                                                           System:   SYSTEMA

Additional devices may be available for use.  Press F5 to see
if any additional devices have been detected.

Type option, press Enter.
  1=Select   5=Display details
 
         Bus      Resource                    Serial
 Option  Number   Name         Type   Model   Number           Selected
   _        1     TAP08        6386   001     00-11111
   _        3     TAP19        3570   B11     13-22222             *
  
 
 
F2=Deselect device    F3=Exit    F5=Refresh    F12=Cancel

Type 1 and press Enter to select the device to use or press F2 to deselect the currently selected device.
The message Alternate installation device selected appears. Press F3 to return to the Install Licensed Internal Code display.
Type 1 and press Enter to install the Licensed Internal Code.

This completes the subtask for verifying and selecting alternate installation device.

If there is an alternate installation device defined and enabled, the Confirm Alternate Installation Device display appears. Perform one of these tasks.
- To install from the alternate installation device, press Enter.
- If you do not want to install from the alternate installation device and want to continue using the primary media, press F12 to Cancel. You see the Licensed Internal Code display. Perform step 13 and select option 3 (Define alternate installation device). Perform step 14 and deselect the alternate installation device.

The Install Licensed Internal Code (LIC) display appears on your console.

                      Install Licensed Internal Code (LIC)
 
 Disk selected to write the Licensed Internal Code to:
     Serial Number     Type     Model     I/O Bus      Controller     Device
      xx-xxxxxxx       xxxx      xxx          x              x            x
 
 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

Attention: Be sure to select option 1. Some options on this display remove all data from your system.

Type 1 (Restore Licensed Internal Code) and press Enter.

Start of change If you did not previously accept the software agreement for the Licensed Internal Code, error messages are shown. Follow the instructions in the error messages. More information is in the topicRequired: Accepting software agreements. End of change

The Install Licensed Internal Code - Status display appears on your console. You do not need to respond to this display. It remains on your console for up to 30 minutes.
```
                   Install Licensed Internal Code - Status
 
 Install of the Licensed Internal Code in progress.
 
             +-------------------------------------------------------+ 
 Percent     |                           XX %                        | 
 complete    +-------------------------------------------------------+ 
 
 
 Elapsed time in minutes  . . . . . . . . :     x.x
 
 
 
Please wait.
 
 
```
If you are using an image catalog (virtual media device) for the upgrade, you will see status messages that indicate the progress of the Licensed Internal Code installation:
1. C6xx41DC is a status reference code that indicates the progress of the Licensed Internal Code decompression. The xx indicates the percent that is decompressed. No action is required.
2. C6xx41CC is a status reference code that indicates the progress of the Licensed Internal Code installation. The xx indicates the percent of the Licensed Internal Code that is installed. No action is required.
If you are using optical media or tape for the upgrade and an error occurs, you might see a display that requires a response. Perform the action necessary as prompted by the display. If you are using an image catalog for the upgrade and an error occurs, see Image catalog recovery for the recovery actions.

The Disk Configuration Attention Report display might appear. If it does, display the detailed report for each problem shown on the display. Press the Help key from the Disk Configuration Attention Report display for more information about your choices. You can also refer to the topic Disk configuration warning and error messages.

                      Disk Configuration Attention Report
 
 Type option, press Enter.
    5=Display Detailed Report
 
 Press F10 to accept all the problems and continue the IPL.
 The system will attempt to correct them.
 
 OPT  Warning
  _   xxxxxxxx xxxx xxxxxxxxx xxxxx xx xxxxx xxxxxxxx
  _   xxxxx_xx_xxxxx xxxxxx_ xxxxxxxx xxxxxxx xxxxxxxxxx________
  _   __________________________________________________________
  _   __________________________________________________________
  _   __________________________________________________________
  _   __________________________________________________________
  _   __________________________________________________________
  _   __________________________________________________________
  _   __________________________________________________________
  _   __________________________________________________________
                                                                        More...
 
 F3=Exit    F10=Accept the problems and continue    F12=Cancel
 ______________________________________________________________________________

If the problem Disk unit not formatted for optimal performance appears on this display, do the following:

Type 5, and press Enter to display the detailed report.
Write down the information displayed. After the upgrade is completed, you will need this information to format these disk units to gain optimal performance.
Press F12 to cancel and return to the Disk Unit Attention Report.
Press F10 to accept the problems and continue the IPL.

If the console mode value is zero, the Accept Console display appears. If this display appears, follow these steps:
1. Press F10 to accept the current console type. The Accept and Set New Console Type on this IPL display appears. The old value (zero) and the new value to be set (your current console type) are shown.
2. Press Enter to set the new value and continue with these instructions.
If your system processor configuration has changed, you could see other displays at this point. After you supply the requested information, the installation continues and the IPL or Install the System display appears. Refer to System password for more information.
After approximately 10 minutes, the IPL or Install the System display appears. The Licensed Internal Code is now installed. Do not remove the distribution media at this time.
If the partition is not HMC managed and you want to change the console type, or you want to enable Console takeover and recovery follow these steps. For more information about console takeover and recovery, see the topic Console takeover and recovery.
1. At the IPL or Install the system display, select option 3 to access Dedicated Service Tools (DST).
2. Sign on as security officer (QSECOFR user profile / QSECOFR password). When prompted, change the password to what you want to use for this partition.
3. Select option 5 (Work with DST environment).
4. Select option 2 (System devices).
5. Select option 6 (Console mode).
6. Select the valid console that you have for this partition.
  Note: If you are using Operations Console (LAN) as your console type, press Enter on the verify window. You can also press F11 to review your network configuration.
7. Select 1 (Yes) or 2 (No) for the option to allow the console to be taken over by another console in the event of a 5250 console failure (does not include twinaxial console). When this option is turned on, the system does not stop with a failure but continues to run uninterrupted.
  Press Enter and then press F3 to return to the DST main menu.
8. Press F3 to exit DST and return to the IPL or Install the System display.