# Compaq DECwindows Motif
for OpenVMS
Installation Guide

Previous | Contents | Index

### 2.3.2.7 Translated Image Support

The dialog now prompts you to install Translated Image Support (TIS), which enables VAX programs to work in the DECwindows Motif for OpenVMS Alpha environment. Note that TIS support is only available for the traditional DECwindows desktop environment.

    Translated Image Support

    Translated image support allows programs translated from the VAX
    enviroment to work in the Alpha environment with the DECwindows
    libraries. Translated image support is not available for the New Desktop.

    Translated Image Support [YES]

### 2.3.2.8 Language Variants Notice

The dialog now displays a warning about the need to update any language variants. You should not install DECwindows Motif Version 1.2--6 unless you will also install DECwindows Motif Version 1.2--6 language variants for all the languages that you wish to use.

    If a Local Language Variant is installed, refer to the Installation Guide.

    If you have a language variant of DECwindows Motif installed then you
    must upgrade to the version for DECwindows Motif Version 1.2-6 after
    completing this installation and before rebooting the system. A failure
    to do so could prevent DECwindows from starting.

    If there is no local language variant upgrade available for DECwindows Motif
    Version 1.2-6 then you should remove the local language variant before
    installing DECwindows Motif Version 1.2-6.

    Do you want to continue? [YES]

### 2.3.2.9 Reviewing the Installation Options

The dialog gives you a chance to review the options you have selected during the installation dialog.

    Do you want to review the options? [NO] y

    DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif
        Install New Desktop: YES
          Install Manual (reference) pages for the New Desktop: YES
          Make the New Desktop the default desktop: YES
        Install traditional DECwindows Desktop: YES
        Programming Support for the C Language: YES
        Programming Support for the Pascal Language: YES
        Programming Support for the FORTRAN Language: YES
        Programming Support for the New Desktop: YES
        Programming examples: YES
          Sound example files: YES
          Programming examples for DECwindows: YES
          Programming examples for the New Desktop: YES
        Translated Image Support: YES

    Are you satisfied with these options? [YES]

### 2.3.2.10 Execution Dialog

During the execution phase, the installation utility begins by displaying the names of all products it will install or remove. This is followed by an indication of the procedure's progress.

Note During the execution phase, a check is made for DECwindows Motif support files. If these files are not available, the dialog may ask if you want to continue. See Section 2.3.2.11 for more information.

    Execution phase starting ...

    The following product will be installed to destination:
        DEC AXPVMS DWMOTIF V1.2-6              DISK$2:[VMS$COMMON.]
    The following product will be removed from destination:
        DEC AXPVMS DWMOTIF V1.2-5              DISK$2:[VMS$COMMON.]

    Portion done: 0%
    ...10%
    ...20%
    ...30%
    ...40%
    ...50%
    ...60%
    ...70%
    ...80%
    ...90%

### 2.3.2.11 Verifying DECwindows Motif Support Files

The installation procedure verifies that DECwindows Motif applications and run-time support files are installed on the operating system (for example, transport and font files, which are required for running DECwindows Motif software).

    **** DECwindows Motif application and run-time support files DETECTED ****

On OpenVMS VAX systems, if the files are not installed, the following message is displayed:

    The DECwindows Motif application and run-time support files have not been
    installed.

    You can use the DECwindows tailoring facility to tailor on the device
    support files and the 75DPI and/or the 100DPI font files using the
    DECwindows save sets which are shipped with the OpenVMS kit as follows:

       $ RUN SYS$UPDATE:DECW$TAILOR

    The installation of DECwindows Motif cannot continue.

On OpenVMS Alpha systems, the files are always installed.

Next, the installation procedure checks for the presence of support files that are needed to use the system as a workstation or as a workstation boot server. If the support files are installed, the following message is displayed:

    **** DECwindows device support files DETECTED ****

On OpenVMS VAX systems, if the files are not installed, users are warned with the following message that their systems cannot be a workstation or a workstation boot server:

    The DECwindows device support files for using this machine as a workstation
    or as a boot node for workstations have not been installed.

    You can use the DECwindows tailoring facility to tailor on the device
    support files and the 75DPI and/or the 100DPI font files using the
    DECwindows save sets, which are shipped with the OpenVMS kit, as follows:

      $ RUN SYS$UPDATE:DECW$TAILOR

On OpenVMS Alpha systems, if the files are not installed, users are warned with the following message that their systems cannot be a workstation or a workstation boot server:

        The DECwindows device support files for using this machine as a workstation
        or as a boot node for workstations have not been installed.

        You can use the POLYCENTER Software Installation utility to change the
        options selected when the OpenVMS Alpha software was installed.
        See the POLYCENTER Software Installation Utility User's Guide for more
        information. To add the support files and the 75DPI and/or the 100DPI font
        files using the DECwindows save sets which are shipped with the OpenVMS
        kit, use the PRODUCT RECONFIGURE command as follows:

          $ PRODUCT RECONFIGURE VMS

        You should add the "Support for DECwindows" subclass in the Utilities
        class.

On both systems, the installation procedure then asks the following question:

    Do you wish to continue with this installation without the workstation support?

If you answer No (default) and press the Return key, the installation is stopped. See Section 5.3 for information on adding the necessary support files. Once you install the necessary support files, restart the installation procedure.

If you answer Yes and press the Return key, the installation continues.

Note that this portion of the installation does not occur if you are simultaneously installing or upgrading the OpenVMS operating system with DECwindows.

### 2.3.2.12 Reviewing Final Installation Notes

If the installation is successful, the dialog displays a list of all products installed and removed. Finally, the procedure displays final installation notes for the DECwindows Motif product.

    ...100%

    The following product has been installed:
        DEC AXPVMS DWMOTIF V1.2-6              Layered Product
    The following product has been removed:
        DEC AXPVMS DWMOTIF V1.2-5              Layered Product

    DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif

        System reboot will be required following upgrade of language variants.

        A system reboot will be required to install the new DECwindow Motif
        images. If this is a new installation you should execute AUTOGEN
        using the following command:

                $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK

        This command adjusts your system parameters and reboots the system.

        If you wish to use DECwindows with any language other than English,
        install the appropriate DECwindows Motif Version 1.2-6 language
        variant product before using AUTOGEN or rebooting the system.

        Installation Verification Procedure can be run after reboot.

        Run the Installation Verification Procedure (IVP) after the installation
        is completed and the system is rebooted. The IVP is located in the
        following directory: SYS$TEST:DECW$IVP.COM.

# 2.4 Recovering from Errors

An error during installation can occur if one or more of the following conditions exists:

- The operating system version is incorrect.
- The prerequisite software version is incorrect.
- Quotas necessary for successful installation are inadequate.
- Process quotas required by the installation utility are inadequate.
- The OpenVMS Help library is currently in use.

For descriptions of the error messages generated by these conditions, see the documents listed in the Associated Documents section in the Preface. These documents may help you diagnose errors and decide what corrective actions to take.

If the installation procedure fails for any reason, the POLYCENTER Software Installation utility displays a message similar to the following:

    %PCSIUI-INSFAIL, The installation of DECwindows Motif Version 1.2-6 for
    OpenVMS has failed.

If the installation fails, fix the problem and restart the installation procedure.

# 2.5 Adjusting Parameters After Installation

If you are simultaneously installing or upgrading the OpenVMS operating system with DECwindows from the CD-ROM, the installation procedure will will check the system parameters at this point.

Note You will not see this message if this is a new installation of DECwindows.

When Compaq DECwindows Motif for OpenVMS attempts to start after successful installation, you will see a message similar to the following:

    %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 120000, should be at least 150000
    %DECW-W-BADVALUE, Free GBLPAGES is 75040 should be at least 92000
    %DECW-W_BADVALUE, SYSGEN parameter CLISYMTBL is 256, should be at least 512
    Some SYSGEN parameters must be reset for DECwindows to start. If you type
    YES, AUTOGEN will change these parameters and reboot your system. If you type
    NO, AUTOGEN will not be run or cause a reboot but DECwindows will not start.
    Do you want the system to run AUTOGEN for you [YES]

At this point, press RETURN. The system will run AUTOGEN, adjust your system parameters, reboot the system and display the DECwindows login.

# Chapter 3
Using the VMSINSTAL Procedure (VMS Version 5.5--2 Only)

This chapter explains how to install Compaq DECwindows Motif for OpenVMS software using the VMSINSTAL procedure on VMS Version 5.5--2 systems. Included is a step-by-step description of the installation procedure, information about error recovery, and instructions for accessing the release notes.

Note The VMSINSTAL installation procedure is only provided for VMS Version 5.5--2 systems and should not be used on OpenVMS Version 6.2 and OpenVMS Version 7.1 systems. Use the POLYCENTER Software Installation utility to install DECwindows Motif on these OpenVMS systems; see Chapter 2.

Using the VMSINSTAL procedure, the Compaq DECwindows Motif for OpenVMS installation takes approximately 45 minutes, depending on the processor type. The VMSINSTAL procedure installs the Compaq DECwindows Motif for OpenVMS product on your system disk.

Note A Product Authorization Key (PAK) for Compaq DECwindows Motif for OpenVMS must be registered and loaded before starting the Compaq DECwindows Motif for OpenVMS installation.

Caution If you do not have a satisfactory backup copy of your system disk, do not attempt to install Compaq DECwindows Motif for OpenVMS software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your VAX processor) before you install Compaq DECwindows Motif for OpenVMS software. Before beginning the installation procedure, review Chapter 1 for information about installation preparations and requirements.

This chapter presents information about the following topics:

- Section 3.1, Installation Procedure Requirements
- Section 3.2, Installation Procedure
- Section 3.3, Recovering from Errors
- Section 3.4, Accessing the Release Notes

# 3.1 Installation Procedure Requirements

This section discusses the requirements for installing your Compaq DECwindows Motif for OpenVMS VAX software using the VMSINSTAL installation procedure.

Refer to Section 1.8 for information on requirements common to both VMSINSTAL and PCSI installations.

Prepare to install Compaq DECwindows Motif for OpenVMS software by logging in to a privileged account, such as the system manager (SYSTEM) account. See Section 3.1.1 for the prerequisite privileges. Although Compaq prefers that you perform the installation using the operator console or other hardcopy terminal, you can perform the installation from a DECterm window.

## 3.1.1 Process Privileges

To install Compaq DECwindows Motif for OpenVMS software, you must be logged in to an account that has the SETPRV privilege or the following privileges:

- CMKRNL
- WORLD
- SYSPRV

The installation procedures turn off the BYPASS privilege at the start of the installation and turn it back on when the installation is completed.

## 3.1.2 Using an Alternate Working Device

You can use the alternate working device (AWD) option to specify another disk to temporarily store the files while they are being unpacked from the save sets on the distribution media. Once the save sets are unpacked, the installation procedure adds or replaces the files that are necessary for the installation of Compaq DECwindows Motif for OpenVMS software from the AWD to the system disk.

If this installation is to upgrade an existing DECwindows Motif environment, then the AWD option allows you to perform an installation with fewer free blocks on the system disk than are otherwise required.

The installation procedure creates a temporary working directory either on the AWD device or by default in the following location:

    SYS$SYSROOT:[SYSUPD.facunvvv]

If you use the AWD option, you can specify a directory. Specifying a directory is optional, but the following guidelines apply:

- If you specify an existing directory, the installation procedure creates a working directory as a subdirectory within the directory that you specify (for example, [WORK.facunvvv]). The installation procedure deletes the working subdirectory after the installation is completed.
- If you do not specify a directory, the installation procedure creates a working directory on the specified device with a directory specification of [000000.facunvvv]. The installation procedure deletes the working directory after the installation is completed.
- If you specify a nonexistent directory, the installation procedure creates both the specified directory and a working directory as subdirectories within the directory that you specify. The installation procedure deletes only the working directory and not the originally specified directory after the installation is completed. You must delete the specified directory manually.

Use the following format to invoke the VMSINSTAL procedure and specify the AWD option:

    $ @SYS$UPDATE:VMSINSTAL facunvvv dkcu OPTIONS N,AWD=ddcu:[dir]

Use the following definitions for the variables in the command line:

- For facunvvv, supply the product name and version number.
  For the Compaq DECwindows Motif for OpenVMS installation, the value of facunvvv is DWMOTIFVAXU6012.
- For dkcu, give the device name of the source drive that holds the distribution media.
- For ddcu, give the device name of the alternate working device.
- For dir, specify the name of the directory on the alternate working device where the product subdirectory will be created. The default is [000000].

For example, to install the Compaq DECwindows Motif for OpenVMS product from the compact disc onto an OpenVMS VAX system using DKA2 as the alternate working device, enter the following command:

    $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 source-drive -
    _$ OPTIONS N,AWD=DKA2:

## 3.1.3 Using the Distributed File Service

You can specify a temporary working directory on a disk that uses the Distributed File Service (DFS).

If you use a DFS-mounted disk as your alternate working device, the installation procedure erroneously reports that there are --1 free blocks on the alternate working device. This error occurs because the DFS client (the installation procedure, in this case) cannot determine the amount of free disk space on the DFS-mounted disk.

Before using a DFS-mounted disk, manually determine its free disk space. Log in to the system on which the disk is mounted, and enter the SHOW DEVICE command as follows:

    $ SHOW DEVICE

# 3.2 Installation Procedure

The Compaq DECwindows Motif for OpenVMS installation procedure consists of a series of questions and informational messages. Enter a question mark (?) for help at any time during the installation. See Appendix B for a sample VMSINSTAL installation of DECwindows Motif on an OpenVMS VAX system.

To stop the installation procedure, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files created up to that point and then exits. You can then restart the installation.

Note This option is not recommended.

## 3.2.1 Product and Device Names

During the installation, you must tell the system what product is being installed and which drive contains the distribution media. Refer to a product with its facility name and version; refer to a drive with its device name. Use the following format to enter product and device names:

- facunvvv
  Represents the facility name and version number of the product being installed, also known as the installation name. The following table explains the format of facunvvv.

  Variable | Definition
  --- | ---
  fac | Product name code (1 to 36 alphanumeric characters)
  u | Update character "u" (1 character)
  n | Update version number (1 digit)
  vvv | Major version number (3 digits)

  For the Compaq DECwindows Motif for OpenVMS installation, use the installation name DWMOTIFVAXU6012.
- ddcu
  Specifies the device name of the source drive that holds the distribution media.

For additional information about device names on your system, see the upgrade and installation supplement for your VAX processor.

## 3.2.2 Invoking the VMSINSTAL Procedure

To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. The VMSINSTAL.COM file is located in the SYS$UPDATE directory.

When the system prompts you with a question during the installation procedure, the default answer is often listed in brackets ([]).

Perform the following steps to run the VMSINSTAL procedure and install Compaq DECwindows Motif for OpenVMS software:

1. Locate the Compaq DECwindows Motif for OpenVMS distribution media.
2. If your system is not already running, start up the system and log in to a privileged account, such as the system manager (SYSTEM) account.
3. Place the distribution media in the source drive. If your Compaq DECwindows Motif for OpenVMS distribution kit contains more than one volume, place the first volume in the drive. During the installation procedure, you will be prompted to load the next volume. The paper labels on the media indicate the order in which you load them.
4. Start the VMSINSTAL procedure. On the command line, specify the product name (that is, the facility name): DWMOTIFVAXU6012 for OpenVMS VAX systems.
   Specify OPTIONS N to access the release notes, which are included in your media kit. The Compaq DECwindows Motif for OpenVMS Release Notes can be displayed or printed before the installation begins. Enter the following command at the DCL prompt:

       $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 ddcu: OPTIONS N

   For ddcu, specify the device name of the source drive that holds the distribution media. See Section 3.2.1 for more information about the format of product and device names. Also, see the OpenVMS upgrade and installation supplement for your VAX processor.
   For example, if you install Compaq DECwindows Motif for OpenVMS from a magnetic tape cartridge in drive MUA0:, enter the following command to invoke the VMSINSTAL command procedure:

       $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 MUA0: OPTIONS N

   If you install Compaq DECwindows Motif for OpenVMS using the alternate working device (AWD) option described in Section 3.1.2, invoke the VMSINSTAL command procedure as follows:

       $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 ddcu: OPTIONS N,AWD=ddcu:[dir]

   The first instance of ddcu is the device name of the source drive that holds the distribution media. The second instance of ddcu is the device name of the AWD, which is the target device. The variable dir is the name of the directory on the alternate working device in which the product subdirectory is created. The default directory is [000000].
   For example, if you are installing Compaq DECwindows Motif for OpenVMS from a magnetic tape cartridge in drive MUA0: using alternate working device DUA2: and directory [INSTALL], enter the following command:

       $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 MUA0: OPTIONS N,AWD=DUA2:[INSTALL]

   If the command to execute the VMSINSTAL procedure fails, check to see if any of the following conditions occurred:
   - You entered the product name incorrectly. VMSINSTAL displays the following message:

         %VMSINSTAL-E-NOPRODS, None of the specified products were found

   - You specified an incorrect name for the source drive. VMSINSTAL displays an "invalid device" error message and prompts you until you enter the name of a source device that exists on the system. Remember to enter a colon (:) after the device name.

The VMSINSTAL procedure displays messages similar to the following:

            VAX/VMS Software Product Installation Procedure V5.5-2

    It is 26-MAR-2000 at 08:02

    Enter a question mark (?) at any time for help.

Previous | Next | Contents | Index