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:

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:

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:

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:

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

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:

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