2 KAP C Installation Procedure

This chapter explains how to install KAP. The following sections provide a step-by-step description of the installation procedure and describe what to do if you encounter an error during installation.

The KAP installation procedure consists of a series of questions and informational messages.

To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again.

Installing the KAP and running the Installation Verification Procedure (IVP) takes less than 5 minutes.

1. Invoke VMSINSTAL.

   $ @SYS$UPDATE:VMSINSTAL  saveset-name   device-name OPTIONS N
   

   To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. The following list defines the elements of the VMSINSTAL command procedure:

   • saveset-name is the installation name for the component. For KAP, the installation name is KCC.

   • device-name is the name of the device on which you plan to mount the media. For example, DKA100: is the device name for CD-ROM reader. You must also include the name of the directory containing the saveset. To obtain this directory, refer to the booklet OpenVMS Alpha Layered Products Disc User Guide that is included with the distribution kit.

   • OPTIONS N is an optional parameter that indicates you want to see the question on release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N.

2. Note that there are several other options you can select when you invoke VMSINSTAL:

   • Auto_answer option (A): Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system).

   • Get save set option (G): Lets you store product save sets temporarily on a magnetic tape or in a disk directory.

   • File log option (L): Logs all activity to the terminal during installation.

   • Alternate root option (R): Lets you install the product to a system root other than that of the running system.

   See the OpenVMS documentation on software installation in the OpenVMS System Management Subkit for detailed information about these options. If you specify more than one option, separate the options with commas (OPTIONS A,N).

3. The following example invokes VMSINSTAL to install KAP from CD-ROM drive DKA100: and shows the system response. This example uses the OPTIONS N release note parameter.

   $   @SYS$UPDATE:VMSINSTAL  KCC   DKA100: OPTIONS N
   

      OpenVMS Alpha Software  Product  Installation Procedure V3.1
                     It is 08-APR-1997 at 06:12.
   
           Enter a question mark (?) at any time for help.
   
             If you do not supply either the product  name
             or the device name, VMSINSTAL prompts you for
             this information later  in  the  installation
             procedure.  VMSINSTAL does not prompt you for
             any options, so be sure to include OPTIONS  N
             on  the  VMSINSTAL command line to access the
             release notes during the installation.
   

4. Confirm system backup.

   * Are you satisfied with the backup  of  your system disk [YES]?
   

   VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press Return. Otherwise, enter No to discontinue the installation. After you back up your system disk, you can restart the installation.

5. Mount the media.

   Please mount the volume on DKA100:
   
             * Are you ready? YES
   
         The following products will  be  processed:
                     KCC V3.1
           Beginning installation of KCC V3.1 at 06:13
       %VMSINSTAL-I-RESTORE, Restoring  product saveset A...
   

   You should now mount the distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question.

   VMSINSTAL then asks you if you are ready to continue with the installation.

   If you respond Yes to indicate that you are ready, VMSINSTAL displays a message that the media containing the KCC saveset has been mounted on the specified device and that the installation has begun.

   If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter No in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/Y.

6. Select a release notes option.

   Release notes included with this kit are always copied to SYS$HELP.

   If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the four options for reviewing the release notes.

   Additional Release Notes Options:
   
     1  Display release notes
     2  Print release notes
     3  Both 1 and 2
     4  None of the above
   
     * Select option [2]:
   

   • If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C.

   • If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use:

     * Queue name [SYS$PRINT]:
     

     You can press Return to send the file to the default output print device or you can enter another queue name.

   • If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version.

   • Select option 4 if you have already reviewed the release notes and are restarting the installation.

7. Next, VMSINSTAL displays the following question:

     * Do you want to  continue  the  installation [N]?: YES
   
             %VMSINSTAL-I-RELMOVED,
     The product's release notes  have  been  successfully moved
     to SYS$HELP.
   

   To continue the installation, enter Yes. Otherwise, press Return. In either case, the release notes are copied to a file in the SYS$HELP directory:

   SYS$HELP:KCC031_RELEASE_NOTES.TXT
   

8. License confirmation.

   If the license PAK has been registered and loaded, answer Yes to the following question. If you answer No, the IVP phase of the installation will be cancelled.

   * Does this product have an authorization key ready and loaded?
   

9. Purge files.

   You have the option to purge files from previous versions of KAP that are superseded by this installation. Purging is recommended; however, if you need to keep files from the previous version, enter No in response to the following question.

   * Do you want to purge files replaced by this installation [YES]?
   

10. Read informational messages.

    At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. If you chose to have files purged, that work is done now.

11. End the installation procedure.

    Installation of KCC V3.1 completed at 6:15
    

    This is followed by history and data file informational messages.

    ---

    Note

    The KCC$STARTUP.COM file must be executed to define the KAP foreign command @SYS$STARTUP:KCC$STARTUP. This startup must be executed each time a user logs on to the system. See Section 3.3 for additional information.

    ---

12. Error recovery.

    If an error occurs during installation, VMSINSTAL displays an error message. If the installation fails, you see the following message:

     %VMSINSTAL-E-INSFAIL, The installation  of KCC V3.1 has failed.
    

    Errors can occur during the installation if any of the following conditions exist:

    • The operating system version is incorrect.

    • A prerequisite software version is incorrect.

    • Quotas necessary for successful installation are insufficient.

    • System parameter values for successful installation are insufficient.

    For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message.