DECwindows Motif Version 1.2--5 for OpenVMS Installation Guide


Previous Contents Index

2.3.2.8 Programming Language Support Options

Next, the dialog asks you which programming languages you want to install and whether you want to install the programming examples.

On OpenVMS Alpha systems, the installation procedure uses the following dialog:


    Programming Support for the C Language 
 
    Requires 7321 disk blocks. 
 
    Headers and related files to support programs in C that will use the 
    DECwindows libraries. 
 
 
    Programming Support for the C Language [YES] 
 
    Programming Support for the Pascal Language 
 
    Requires 3010 disk blocks. 
 
    Include files to support programs in Pascal that will use the 
    DECwindows libraries. 
 
 
    Programming Support for the Pascal Language [YES] 
 
    Programming Support for the FORTRAN Language 
 
    Requires 2429 disk blocks. 
 
    Include files to support programs in FORTRAN that will use the 
    DECwindows libraries. 
 
 
    Programming Support for the FORTRAN Language [YES] 
 
    Programming Support for the New Desktop 
 
    Requires 145 disk blocks. 
 
    Headers and related files to support programs in C that will use the 
    New Desktop widgets. 
 
 
    Programming Support for the New Desktop [YES] 
 
    Programming examples 
 
    Requires from 0 to 12964 disk blocks depending upon configuration. 
 
    Examples of programming to use the various libraries. 
 
 
    Programming examples [YES] 
 
    Do you want all the defaults for the subitems? [YES] no 
 
        Sound example files 
 
        Requires 1556 disk blocks. 
 
        Sample sound files that can be used with DECsound. 
 
 
        Sound example files [YES] 
 
        Programming examples for DECwindows 
 
        Requires 10140 disk blocks. 
 
        Examples, in various programming languages, of using the DECwindows and 
        standard widgets and libraries. 
 
 
        Programming examples for DECwindows [YES] 
 
        Programming examples for the New Desktop 
 
        Requires 1268 disk blocks. 
 
        Examples, in C, of using the new widgets provided with the New Desktop. 
 
 
        Programming examples for the New Desktop [YES] 
 
    Translated Image Support 
 
    Requires 33562 disk blocks. 
 
    Translated image support to allow programs translated from the VAX 
    to work on the Alpha with the DECwindows libraries. Translated image 
    support is not available for the New Desktop. 
 
 
    Translated Image Support [YES] 
 

On OpenVMS VAX systems, the installation procedure uses the following dialog:


    DECwindows Motif runtime support files [YES] 
 
    Programming Support for the C Language 
 
    Requires 7321 disk blocks. 
 
    Headers and related files to support programs in C that will use the 
    DECwindows libraries. 
 
 
    Programming Support for the C Language [YES] 
 
    Programming Support for the Pascal Language 
 
    Requires 3010 disk blocks. 
 
    Include files to support programs in Pascal that will use the 
    DECwindows libraries. 
 
 
    Programming Support for the Pascal Language [YES] 
 
    Programming Support for the FORTRAN Language 
 
    Requires 2429 disk blocks. 
 
    Include files to support programs in FORTRAN that will use the 
    DECwindows libraries. 
 
 
    Programming Support for the FORTRAN Language [YES] 
 
    Programming examples [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-5: 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

At this point, you have answered all installation dialog questions. 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.

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.


Execution phase starting ... 
 
The following product will be installed to destination: 
    DEC AXPVMS DWMOTIF V1.2-5              DISK$2:[VMS$COMMON.] 
The following product will be removed from destination: 
    DEC AXPVMS DWMOTIF V1.2-4              DISK$2:[VMS$COMMON.] 
 
Portion done: 0% 
...10% 
...20% 
...30% 
...40% 
...50% 
...60% 
...70% 
...80% 
...90% 
...100% 
 
The following product has been installed: 
    DEC AXPVMS DWMOTIF V1.2-5              Layered Product 
The following product has been removed: 
    DEC AXPVMS DWMOTIF V1.2-4              Layered Product 
 
DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif 
 
    System reboot will be required following upgrade of language variants. 
 
    A system reboot will be required to install the new DECwindow Motif 
    for OpenVMS 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-5 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-5 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 DECwindows Motif Version 1.2-5 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 DECwindows Motif Version 1.2-5 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 DECwindows Motif Version 1.2-5 for OpenVMS installation takes approximately 45 minutes, depending on the processor type. The VMSINSTAL procedure installs the DECwindows Motif Version 1.2-5 for OpenVMS product on your system disk.

Note

A Product Authorization Key (PAK) for DECwindows Motif Version 1.2-5 for OpenVMS must be registered and loaded before starting the DECwindows Motif Version 1.2-5 for OpenVMS installation.

Caution

If you do not have a satisfactory backup copy of your system disk, do not attempt to install DECwindows Motif Version 1.2-5 for OpenVMS software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your VAX processor) before you install DECwindows Motif Version 1.2-5 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 DECwindows Motif Version 1.2-5 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 DECwindows Motif Version 1.2-5 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 DECwindows Motif Version 1.2-5 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 DECwindows Motif Version 1.2-5 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 DECwindows Motif Version 1.2-5 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 DWMOTIFVAXU5012 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 DECwindows Motif Version 1.2-5 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 DECwindows Motif Version 1.2-5 for OpenVMS software:

  1. Locate the DECwindows Motif Version 1.2-5 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 DECwindows Motif Version 1.2-5 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): DWMOTIFVAXU5012 for OpenVMS VAX systems.
    Specify OPTIONS N to access the release notes, which are included in your media kit. The DECwindows Motif Version 1.2--5 for OpenVMS Release Notes can be displayed or printed before the installation begins. Enter the following command at the DCL prompt:


    $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU5012 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 DECwindows Motif Version 1.2-5 for OpenVMS from a magnetic tape cartridge in drive MUA0:, enter the following command to invoke the VMSINSTAL command procedure:


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

    If you install DECwindows Motif Version 1.2-5 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 DWMOTIFVAXU5012 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 DECwindows Motif Version 1.2-5 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 DWMOTIFVAXU5012 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-1998 at 08:02 
 
        Enter a question mark (?) at any time for help. 

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.


Previous Next Contents Index