# Compaq DECwindows Motif
for OpenVMS
Installation Guide

Previous | Contents | Index

## 3.2.3 Confirming System Backup

The VMSINSTAL procedure asks the following question:

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

If you made a backup copy of your system disk, press the Return key and proceed to Section 3.2.4.

If you did not make a backup copy of the system disk, do the following:

1. Enter No and press the Return key. The VMSINSTAL procedure exits and returns you to DCL level.
2. Back up the system disk as described in the OpenVMS upgrade and installation supplement for your VAX processor.
3. After you make a backup copy of the system disk, restart the installation procedure from step 4 in Section 3.2.2.

## 3.2.4 Mounting Distribution Media

The VMSINSTAL procedure asks you where you will mount the distribution volumes:

    * Where will the distribution volumes be mounted:

Enter the directory specification in the following format:

    device-name:[directory]

Then the procedure tells you to enter the name of the product (facility name); enter DWMOTIFVAXU6012.

    Enter the names of the product to be processed from the first
    distribution volume set.
    * Product: DWMOTIFVAXU6012

When the installation begins, the VMSINSTAL procedure displays informational text similar to the following:

    The following products will be processed:

     DWMOTIFVAX V1.2-6

      Beginning installation of DWMOTIFVAXU6 Version 1.2 at 10:36

    %VMSINSTAL-I-RESTORE, Restoring product save set  A...

## 3.2.5 Choosing a Release Notes Option

If you specify OPTIONS N during step 4 in Section 3.2.2, the VMSINSTAL procedure prompts you to select a release notes option:

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

        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]:

Enter the number of the option you want:

- Option 1 displays the release notes on the terminal.
- Option 2 prints the release notes (default).
- Option 3 displays and prints the release notes.
- Option 4 allows you to continue with the installation if you do not want to display or print the release notes.

Note Compaq strongly recommends that you read the release notes before continuing the installation.

If you choose option 1, the release notes display on the terminal. You are prompted to press Return to continue reading the release notes. If you want to end the display and continue the installation, press Ctrl/C. After you press Ctrl/C, you are asked whether you want to continue with the installation; you are informed that the release notes have been moved to SYS$HELP.

Caution Do not press Ctrl/Y; if you do, the installation ends.

If you choose option 2 or 3, you are prompted for the name of the print queue. If you do not specify a print queue, the release notes are queued to SYS$PRINT by default.

## 3.2.6 Continuing the Installation

After the VMSINSTAL procedure processes your release notes option, the following message is displayed:

    * Do you want to continue the installation [No]?

If you want to continue with the installation, enter Yes and press Return. If you want to end the installation, press the Return key.

Regardless of the release notes option you select, the VMSINSTAL procedure copies the release notes to the SYS$HELP directory. See Section 3.4 for information about how to access the release notes once they are copied to the SYS$HELP directory.

            %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

                  *** Installing Compaq DECwindows Motif for OpenVMS VAX software ***

              Copyright 2000 Compaq Computer Corporation

              Confidential computer software. Valid license from Compaq or authorized
              sublicensor required for possession, use , or copying. Consistent with
              FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
              Documentation, and Technical Data for Commercial Items are licensed
              to the U.S. Government under vendor's standard commercial license.

## 3.2.7 Preserving the OSF/Motif Release 1.1.3 Programming Environment

If DECwindows Motif is already installed on your system, the OSF/Motif Release 1.1.3 programming environment is incompatible with Compaq DECwindows Motif for OpenVMS software. (Note that the OSF/Motif Release 1.2 programming environment is overwritten with the OSF/Motif Release 1.2.3 Toolkit when you install the Compaq DECwindows Motif for OpenVMS software.)

The installation procedure asks whether you want to preserve the OSF/Motif Release 1.1.3 programming environment:

              The DECwindows Motif programming environment was installed with a
              previous version of this kit.  This environment is incompatible with the
              OSF/Motif Release 1.2 environment provided with DECwindows Motif Version
              1.2-6. The XUI programming environment is also not included in
              DECwindows Motif Version 1.2-6.

              If you intend to continue developing programs for XUI or OSF/Motif
              Release 1.1.3 you should save this environment.  Please refer to the
              installation guide for more details and information on accessing these
              files in their new location.

              If you do not choose to save the XUI and OSF/Motif Release 1.1.3
              programming environment, those files will be removed from the system
              disk.

            * Do you want to save the OSF/Motif Release 1.1.3 and XUI
            * programming support files [No]?

If you want to preserve the XUI and OSF/Motif Release 1.1.3 programming environment, enter Yes and press the Return key. The installation procedure creates subdirectories that contain the OSF/Motif Release 1.1.3 programming files so that they can be used for programming at a later time.

See Section 1.6 for information about how to reference the previous version of the programming support files.

## 3.2.8 Installing the Entire Kit

You can install the entire Compaq DECwindows Motif for OpenVMS software kit, or you can install part of the kit. The DECwindows Motif base kit is always installed; the Compaq DECwindows Motif for OpenVMS programming environment is optional.

The procedure asks you whether you want to install the entire kit:

              You can install the DECwindows Motif kit completely or in selected
              portions.  A complete installation requires as many as 82,500 blocks.
              If you choose to perform a partial installation, you can select
              (tailor) the programming support files that support your DECwindows
              Motif application development.  Whether you perform a complete or partial
              installation, this kit provides support for running DECwindows Motif
              applications on OpenVMS compute servers.

            * Do you want to install the entire kit [Yes]?

If you want to install the entire kit, press the Return key and verify your kit selections (see Section 3.2.10). If you choose not to install the entire kit, enter No and continue with questions about installing programming support (see Section 3.2.9).

## 3.2.9 Choosing Programming Support Files

The installation procedure asks whether you want to install programming support:

              This installation procedure provides support files for developing
              DECwindows Motif applications in several programming languages.  These
              files are needed only to develop applications and are not required to run
              DECwindows Motif applications.  The free disk space requirement for each
              programming support file ranges from 3000 to 8000 blocks.

            * Do you want to install DECwindows Motif programming support [Yes]?

Press the Return key to install programming support. The following message is displayed:

              Support files are supplied for the following OpenVMS programming languages:

                    FORTRAN, Pascal

              In addition, support files are supplied for programming in the C language
              using conventions and standards developed at the Massachusetts Institute
              of Technology.

If you choose not to install programming support, enter No and proceed to the instructions in Section 3.2.10. The installation procedure asks whether you want to install all of the programming support files:

            * Do you want to install all programming language support files [Yes]?

Press the Return key if you want to install all the languages. If you do not want to install all the languages, enter No and press the Return key. Each language is then displayed. Enter Yes for each language that you want to install.

The installation procedure asks whether you want to install DECwindows Motif programming example files:

            * Do you want to install DECwindows Motif programming examples [Yes]?

Press the Return key if you want to install the programming example files. If you enter No, the example files are not installed.

## 3.2.10 Verifying Kit Selections

The components of the kit that you selected now display; you can verify that these choices are correct. A message similar to the following is displayed:

    You have selected the following portions of the kit:

            o  DECwindows Motif Applications and Run-time Libraries

            o  DECwindows Motif programming examples

            o  DECwindows Motif programming support

               FORTRAN, Pascal
               MIT C language programming conventions

            o  OSF/Motif Release 1.1.3 and XUI saved programming
               support

    * Are these selections correct [Yes]?

Press the Return key if the choices are correct. If you want to change your selections, enter No and press the Return key. You are prompted by the previous questions again, beginning with whether you want to install the entire kit (see Section 3.2.8). After you repeat the selection procedure and are satisfied with your selections, enter Yes and press the Return key.

## 3.2.11 Verifying Disk Space

The installation procedure checks whether your system disk contains a sufficient number of free blocks.

1. If the blocks are available, the installation continues (see Section 3.2.12).
2. If you do not have sufficient system disk space to install the portions you chose, the installation displays a message similar to the following:

                Your system disk has only 25364 free blocks, and
                you have selected to install approximately 76050 blocks.

                                          * * * N O T E * * *

                The installation procedure has determined that you do not have enough
                disk space to complete the installation.  However, it may be possible
                to continue successfully if you are installing DECwindows Motif on a
                system that already has DECwindows Motif installed.

              * Do you want to reselect which DECwindows Motif options to install [Yes]?

   If you press the Return key, you can reselect the DECwindows Motif options beginning with those described in Section 3.2.8. If you enter No, the procedure asks whether you want to continue the installation:

       * Do you want to continue the installation anyway [Yes]?

   Caution If you press the Return key, the installation continues. However, if you exceed the amount of available disk space, the installation fails.

   If you enter No, the installation ends. You can then either free up blocks on the system disk and restart the installation or start the installation again using the AWD option. (See Section 3.1.2 for information about using the AWD option.)
3. If you specify an alternate working device that does not have sufficient disk space to install the portions you have chosen, the installation displays a message similar to the following:

               Your specified alternate working directory device has only 68977
               free blocks, and this installation will require approximately 76050 blocks.

               You should either reselect which DECwindows Motif options to install, or
               restart this installation using an alternate working directory device with
               more free blocks.

                               *  *  *  NOTE  *  *  *

               Although the installation procedure estimates you do not have enough disk
               space to complete the installation, it may be possible to continue
               successfully if you are installing DECwindows Motif on a system which
               already has DECwindows installed.

             * Do you want to reselect which DECwindows Motif options to install [Yes]?

   If you press the Return key, you can reselect the DECwindows Motif options beginning with those described in Section 3.2.8. If you enter No, the procedure asks whether you want to continue the installation:

       * Do you want to continue the installation anyway [Yes]?

   If you press the Return key, the installation continues.

   Caution If you lack sufficient free disk space for installation on the alternate working device, the installation procedure ends.

   If you enter No, the installation procedure ends. Restart the installation once you set up an alternate working device with sufficient disk space. (See Section 3.1.2 for more information about using the AWD option.)

## 3.2.12 Verifying License Registration

The installation procedure continues and displays license information similar to the following:

              A registered and loaded product authorization key for DW-MOTIF is
              required to run any DECwindows Motif for OpenVMS application. If you
              answer No to the next question, the installation of DECwindows Motif for
              OpenVMS will be terminated.

                    Product:      DW-MOTIF
                    Producer:     DEC
                    Version:
                    Release Date:

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

Note that the NET-APP-SUP-250 and NET-APP-SUP-300 PAKs are also valid. Enter Yes to continue with the installation if your authorization key is registered and loaded. If you enter No, the following message is displayed and the installation ends:

    Installation of DECwindows Motif cannot continue because you do
    not have a registered and loaded authorization key.

See Section 1.1 for more information about license registration. After you register and load your authorization key, restart the Compaq DECwindows Motif for OpenVMS installation beginning at step 4 in Section 3.2.2.

## 3.2.13 Performing a System Reboot

The installation procedure suggests that you perform a system reboot to ensure successful installation of Compaq DECwindows Motif for OpenVMS software:

              DECwindows Motif will not start if your system parameters are not
              correct.

              o If you allow a system shutdown, the installation procedure will
                reboot the system at the end of the installation.  If your system
                parameters are incorrect, the installation will run AUTOGEN prior
                to the system reboot.

              o If you do not allow a system shutdown, the installation procedure
                will continue, and you will be informed at the end of the
                installation whether you need to modify your system parameters in
                order to start DECwindows Motif.

              To complete the installation of this product, you should reboot
              the system.  If it is not convenient to reboot at this time, then
              enter No to the following question.

              If you enter No, the installation procedure will continue.

            * Will you allow a system reboot after this product is installed [Yes]?

If you entered No to the shutdown question, no further questions are asked.

If you answered Yes to the shutdown question, the VMSINSTAL procedure displays the following questions about the shutdown:

    * How many minutes for system shutdown [0]?
    * Do you want to do an automatic system reboot [Yes]?

      No further questions will be asked.

Caution To avoid confusion with file versions when activating an image or application, perform the necessary procedures to restart the Compaq DECwindows Motif for OpenVMS software as indicated during the installation in Section 3.2.15.

## 3.2.14 Reading Informational Messages

The VMSINSTAL procedure lists the directories that are created and the save sets that are restored. The VMSINSTAL procedure prints out a message indicating that the files will be moved to their target directories.

- If you perform the installation using media other than 9-track magnetic tape, messages similar to the following display:

              %VMSINSTAL-I-SYSDIR, This product creates system disk directory
              VMI$ROOT:[DECW$INCLUDE.DECW$113].
              %VMSINSTAL-I-SYSDIR, This product creates system disk directory
              VMI$ROOT:[SYSEXE.DECW$113].
              %VMSINSTAL-I-SYSDIR, This product creates system disk directory
              VMI$ROOT:[SYSLIB.DECW$113].
              %VMSINSTAL-I_RESTORE, Restoring product save set B ...
              %VMSINSTAL-I_RESTORE, Restoring product save set C ...
              %VMSINSTAL-I_RESTORE, Restoring product save set D ...
              %VMSINSTAL-I-RESTORE, Restoring product save set E ...
              %VMSINSTAL-I-RESTORE, Restoring product save set F ...
              %VMSINSTAL-I-RESTORE, Restoring product save set G ...
              %VMSINSTAL-I-RESTORE, Restoring product save set H ...
              %VMSINSTAL-I-RESTORE, Restoring product save set I ...
              %VMSINSTAL-I-RESTORE, Restoring product save set J ...
              %VMSINSTAL-I-RESTORE, Restoring product save set L ...
              %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

- If you perform the installation using 9-track magnetic tape, some of the files are compressed into text libraries. The installation procedure informs you that the data is being decompressed and displays messages similar to the following:

              %VMSINSTAL-I_RESTORE, Restoring product save set B ...
              %VMSINSTAL-I_RESTORE, Restoring product save set C ...
              %VMSINSTAL-I_RESTORE, Restoring product save set D ...
              %VMSINSTAL-I_RESTORE, Restoring product save set E ...
              %VMSINSTAL-I-RESTORE, Restoring product save set F ...
              %VMSINSTAL-I-RESTORE, Restoring product save set G ...
              %VMSINSTAL-I-RESTORE, Restoring product save set H ...
              %VMSINSTAL-I-RESTORE, Restoring product save set I ...
              Decompressing H_E_DECW$INCLUDE
              Decompressing H_E_SYSLIB
              %VMSINSTAL-I_RESTORE, Restoring product save set J ...
              %VMSINSTAL-I-RESTORE, Restoring product save set L ...
              %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

The installation procedure then informs you that a spurious error message will be displayed, which you can safely ignore:

    You can ignore the following NCP error message(s).

    %NCP-I-SUCCESS,  Success
    Object = X$X0
    %NML-I-RECDELET, Database entry deleted

The installation procedure then reminds you to install the language variant product after the installation, if necessary.

    If you wish to use any language other than English, install the appropriate
    DECwindows Motif Version 1.2-6 language variant product after
    this installation has completed.

You are notified that you should run the Installation Verification Procedure (IVP) after the installation is completed and after you start the DECwindows Motif software. (See Section 4.2 for more information about running the IVP.)

    The Installation Verification Procedure (IVP) should be run after the
    installation has been completed and DECwindows Motif has been restarted.
    The IVP can be found in SYS$TEST:DECW$IVP.COM.

Previous | Next | Contents | Index