DECwindows Motif Version 1.2--5 for OpenVMS Installation Guide


Previous Contents Index

3.2.15 Using the AUTOGEN Utility to Set System Parameters

The installation procedure might automatically run AUTOGEN, depending on which type of system you are using:

3.2.16 Completing the Installation Procedure

When the installation is completed, a message similar to the following is displayed:


 
Installation of DWMOTIFVAXU5 V1.2 completed at 10:57 
 
VMSINSTAL procedure done at 12:45 

These messages indicate that the installation procedure completed successfully.

Your system automatically shuts down if AUTOGEN is run; you must then reboot your system. See the upgrade and installation supplement for your VAX processor for instructions on how to reboot your system.

Note

If you upgrade your system with a higher version of OpenVMS at a later time, you might need to reinstall the DECwindows Motif Version 1.2-5 for OpenVMS software.

3.3 Recovering from Errors

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

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.

3.4 Accessing the Release Notes

During the installation, the VMSINSTAL procedure copies theDECwindows Motif Version 1.2--5 for OpenVMS Release Notes to the SYS$HELP:DECW$MOTIFU5012.RELEASE_NOTES file. Once you return to DCL level, you can print this file or display it at a terminal. Refer to Section 3.2.5 for more information about accessing the release notes.


Chapter 4
After Installing the Software

This chapter discusses the tasks that you need to perform after the DECwindows Motif Version 1.2-5 for OpenVMS installation is completed:

If the DW--MOTIF license that is installed on your system is not valid, appropriate messages display on your console terminal and DECwindows Motif is not automatically started. If this situation occurs, log in to the system, install the valid license, and start your DECwindows Motif software. For complete information on installing licenses using LMF, see the OpenVMS License Management Utility Manual.

4.1 Starting the DECwindows Motif Software

If you perform a system reboot following the installation of DECwindows Motif for OpenVMS, the DECwindows startup procedure runs automatically when the system reboots. On OpenVMS Alpha systems, either the New Desktop login dialog box or the DECwindows desktop Start Session dialog box is displayed, depending on the value of the DECW$START_NEW_DESKTOP global symbol. (See Section 4.4 for more information.) On OpenVMS VAX systems the Start Session dialog box is displayed. Proceed to Section 4.2 if you allowed a system reboot and DECwindows has successfully started.

If you chose not to reboot the system after the installation, you must start or restart the DECwindows Motif software by running the DECwindows startup procedure, as described in the following paragraphs. When the startup procedure has successfully completed, either the New Desktop login dialog box or the DECwindows desktop Start Session dialog box is displayed, as explained in the previous paragraph.

DECwindows Motif Version 1.2-5 for OpenVMS software can be started only if your system parameters are correct. Proceed to one of the following sections if your system parameters are correct:

If your system parameters are not correct, then use one of the following methods to adjust them accordingly:

After the system is rebooted and the startup is completed, the Start Session dialog box displays.

The DECwindows Motif Version 1.2-5 for OpenVMS software is now installed and running on your system.

Run the Installation Verification Procedure (IVP) as described in Section 4.2 to verify that the installation of DECwindows Motif Version 1.2-5 for OpenVMS software is complete and accurate.

4.1.1 Standalone Systems

Perform one of the following procedures to start your DECwindows Motif software on a standalone system:

Note

If your system has a workstation display, then the command to restart DECwindows Motif will end your current session. The Start Session dialog box displays on your terminal, and you must log back in to continue using DECwindows Motif.

The DECwindows Motif Version 1.2-5 for OpenVMS software is now installed and running on your system.

Run the IVP as described in Section 4.2 to verify that the installation of DECwindows Motif Version 1.2-5 for OpenVMS is complete and accurate.

4.1.2 VMScluster Systems

Starting DECwindows Motif Version 1.2-5 for OpenVMS on nonsatellite and satellite nodes is described in the sections that follow.

4.1.2.1 Starting Nonsatellite and Boot Nodes

To start DECwindows Motif Version 1.2-5 for OpenVMS software on each of the nonsatellite nodes within your VMScluster, perform one of the following procedures:

Note

If the nonsatellite node or boot node has a workstation display, then the command to restart DECwindows Motif will end your current session. The Start Session dialog box displays on your terminal; log in again to continue using DECwindows Motif.

The DECwindows Motif Version 1.2-5 for OpenVMS software is now installed and running on your system.

Run the IVP as described in Section 4.2 to verify that the installation of the DECwindows Motif Version 1.2-5 for OpenVMS product is complete and accurate.

4.1.2.2 Starting Satellite Nodes

To start the DECwindows Motif Version 1.2-5 for OpenVMS software that is installed on the boot node, perform one of the following procedures on each satellite node in the VMScluster that will run DECwindows Motif Version 1.2-5 for OpenVMS software:

Once DECwindows Motif is started or restarted on each node in the VMScluster, then the installation is considered complete. Now run the IVP as described in Section 4.2.

4.2 Running the IVP

Run the IVP, SYS$TEST:DECW$IVP.COM, after you install and start the DECwindows Motif Version 1.2-5 for OpenVMS product. This procedure contains four tests, which verify that the software installation is complete and accurate.

First, the IVP procedure attempts to run two display-oriented tests. When you invoke the IVP, it identifies your type of hardware.

Press Ctrl/Z at the prompt if you do not want to run the display-oriented tests. The IVP runs these tests only if the images exist on the system. If the IVP does not find the images, a message displays to inform you that the tests will not be run.

Note

If you are invoking the IVP from a LAT Xterminal using LAT software, enter the following command first:


$ SET DISPLAY/CREATE/NODE=LAT_nnnnnnnnnnnn/TRANSPORT=LAT 

Substitute your actual LAT terminal number for nnnnnnnnnn.

Enter the default at the _Display: prompt.

Next, the IVP runs two nondisplay-oriented tests.

Example 4-1 shows you how to run the IVP.

Example 4-1 Sample IVP

 
        $ @SYS$TEST:DECW$IVP
 
            Copyright Digital Equipment Corporation 1988, 1998.  All rights reserved. 
 
               DECwindows Motif for OpenVMS Installation Verification Procedure (IVP) 
 
            This IVP is intended to test some of the functionality of DECwindows Motif 
            for OpenVMS and to provide a quick method of verifying the installation. 
 
            This machine is not a workstation.  Please provide the nodename of a 
            workstation on which to display the IVP tests.  You must be sure that this 
            account and node have security access to the display node, or the IVP will 
            fail. 
 
            To skip the display-oriented tests, press Ctrl/Z at the following prompt. 
 
        _Display: NODE33::0.0
        %DECW-I-IVP, The IVP will display on NODE33::0.0 
        %DECW-I-IVP, Running DECW$EXAMPLES:ICO.EXE for up to a minute. 
        %DECW-I-IVP, Press Ctrl/Y to interrupt test. 
        %DCL-S-SPAWNED, process DECW$IVP_ICO spawned 
        %DECW-I-IVP, Running SYS$SYSTEM:DECW$CLOCK for up to a minute. 
        %DECW-I-IVP, Press Ctrl/Y to interrupt test. 
        %DCL-S-SPAWNED, process DECW$IVP_CLOCK spawned 
        %DECW-I-IVP, Invoking the UIL Motif compiler... 
        %DECW-S-IVP, The UIL Motif compiler test completed successfully. 
        %DECW-I-IVP, Beginning CONVERT/DOCUMENT IVP... 
        %DECW-S-IVP, CONVERT/DOCUMENT IVP passed. 
        %DECW-S-IVP, The IVP has completed. 
        $
 

4.3 Choosing an Alternative Console

The DECwindows Motif Version 1.2-5 for OpenVMS software allows you to boot all configurations from the main console. You can then toggle between displaying and not displaying the operator window by pressing Ctrl/F2. The main console is always a workstation screen.

If you are logged in to the main console (workstation screen), you must log out before DECwindows will start. Issue the following command from the main console:


$@SYS$MANAGER:DECW$STARTUP

Once the command procedure completes, log out of the main console. Otherwise the server will not start and a login box will not appear.

For an alternative console, you can use a terminal connected to the workstation by means of a terminal port.

If you boot from the main console, the alternative console is connected when you invoke the DECwindows Motif startup command procedure.

If you boot the system from an alternative console, you cannot start the Console Window application. This application is described in the release notes.

4.4 Selecting the Desktop (Alpha Only)

On OpenVMS Alpha systems, DECwindows Motif Version 1.2--5 for OpenVMS provides a choice of two desktops: the New Desktop, which is derived from the Common Desktop Environment (CDE), and the traditional DECwindows desktop.

During the installation, if you choose to install both the New Desktop and the DECwindows desktop, you are asked which desktop you wish to be the default desktop.

To select the other desktop as the default desktop, perform the following steps.

  1. If the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM does not exist, copy it from DECW$PRIVATE_APPS_SETUP.TEMPLATE (or create it if an earlier version of DECwindows Motif for OpenVMS has not been installed on your system). For example:


    $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE - 
    _$ SYS$COMMON:[SYSMGR]DECW$PRIVATE_APPS_SETUP.COM 
    

  2. Edit SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM and add a symbol definition for DECW$START_NEW_DESKTOP. If you wish the New Desktop as the default enter the following global symbol definition:


    $ DECW$START_NEW_DESKTOP == "TRUE" 
    

    If you wish the DECwindows desktop as the default, enter the following global symbol definition:


    $ DECW$START_NEW_DESKTOP == "FALSE" 
    

  3. Restart DECwindows using the following command:


    $ @SYS$MANAGER:DECW$STARTUP RESTART 
    


Previous Next Contents Index