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

• A nonworkstation system
  If you install DECwindows Motif Version 1.2-5 for OpenVMS on a nonworkstation system (that is, an OpenVMS host system), the following message is displayed:

  This system is not a workstation. It will not be necessary to run AUTOGEN.

• A workstation system that runs DECwindows Motif Version 1.2-5 for OpenVMS software with correct system parameters
  If you install DECwindows Motif Version 1.2-5 for OpenVMS on a workstation system and your system parameters are correct, the following message is displayed:

  The installation procedure has determined that your system parameters are set correctly and that it will not be necessary to run AUTOGEN or reboot the system. If your system is already running DECwindows Motif, restart DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP RESTART If your system is NOT already running DECwindows Motif, start DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP * * * N O T E * * * If you are installing DECwindows Motif from your workstation console, log off after you enter the command to start DECwindows Motif.

• A workstation system that runs DECwindows Motif Version 1.2-5 for OpenVMS software with incorrect system parameters
  If you install DECwindows Motif Version 1.2-5 for OpenVMS on a workstation system and your system parameters need to be reset, the following message is displayed:

  The installation of DECwindows Motif has determined that some of your system parameter values will require modification in order to start DECwindows Motif Version 1.2-5 for OpenVMS. To set your parameters correctly, run AUTOGEN using the following DCL command: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK This will adjust your system parameters and reboot the system.

• A workstation system that runs DECwindows Motif Version 1.2-5 for OpenVMS with incorrect system parameters, and you answered Yes to a system shutdown

  The OpenVMS AUTOGEN procedure will now be run to set your system parameters. After that, your system will be automatically rebooted. After the system has been rebooted, successful installation of the workstation software will be indicated by the appearance of the Start Session window. %AUTOGEN-I-BEGIN, GETDATA phase is beginning. . . . %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning. . . . %AUTOGEN-I-BEGIN, GENFILES phase is beginning. . . . %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning. . . . Installation of DWMOTIFVAXU5 V1.2 completed at 10:57 %VMSINSTAL-I-SHUTDOWN, This product requires that the system be rebooted. SHUTDOWN -- Perform an Orderly System Shutdown on node NODE01 . . .

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.

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

• Incorrect OpenVMS operating system version.
• Insufficient quotas.
• Insufficient values for system parameters.
• OpenVMS help library is currently in use.
• Product license is not registered and loaded.

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.

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

• Section 4.1, Starting the DECwindows Motif Software
• Section 4.2, Running the IVP
• Section 4.3, Choosing an Alternative Console
• Section 4.4, Selecting the Desktop (Alpha Only)

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:

• Section 4.1.1, Standalone Systems
• Section 4.1.2, VMScluster Systems

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

• Invoke the AUTOGEN utility:

  $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK

• Attempt to start the DECwindows Motif software. The DECwindows Motif startup procedure checks your system parameters. If they are too low, the procedure displays a series of messages describing the required system parameters. These same parameters are adjusted in the system's MODPARAMS.DAT file. Then the procedure displays following:

  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 run or cause a reboot, but DECwindows will not start. To run AUTOGEN at a later date, enter the following command: $ @SYS$UPDATE:AUTOGEN getdata reboot check_feedback Do you want the system to run AUTOGEN for you [Yes]?

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:

• If your system is not running DECwindows Motif, then start DECwindows Motif with the following command:

  $ @SYS$MANAGER:DECW$STARTUP

• If your system is currently running DECwindows Motif, then restart DECwindows Motif with the following command:

  $ @SYS$MANAGER:DECW$STARTUP RESTART

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:

• If your system is not running DECwindows Motif, then start DECwindows Motif with the following command:

  $ @SYS$MANAGER:DECW$STARTUP

• If your system is currently running DECwindows Motif, then restart DECwindows Motif with the following command:

  $ @SYS$MANAGER:DECW$STARTUP RESTART

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:

• If the node is not running DECwindows Motif, then start DECwindows Motif with the following command:

  $ @SYS$MANAGER:DECW$STARTUP

• If the node is currently running DECwindows Motif, then restart DECwindows Motif with the following command:

  $ @SYS$MANAGER:DECW$STARTUP RESTART

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.

• If you are using a workstation, you are asked where the display-oriented tests should display. Your current workstation is the default.
• If you are not using a workstation, the procedure prompts you for a display name.

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.

Next, the IVP runs two nondisplay-oriented tests.

• The first of these tests invokes the Motif UIL compiler. If you did not install programming support, the IVP informs you that this test will not be run because the Motif UIL image does not exist. If this test is run, you are notified of its completion status.
• The last test converts a text file to DDIF format and then converts it back to text, comparing the original text file with the result. If the files match, the test is successful. You are notified of its completion status.

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