Compaq recommends that you back up your system disk before you install any software. At the beginning of the installation, the installation procedure asks whether your system disk is backed up. Use the backup procedures that are established at your site. For details about performing a system disk backup, see the section on the Backup utility in the OpenVMS System Management Utilities Reference Manual.

1.8.6 Notifying Other Users

Inform users on the system that you plan to install a product and that they must log out during the installation. To make sure that you are the only user logged in to the system, follow these steps:

1. Notify current users to log out. Enter the following command at the DCL prompt:

   $ REPLY/ALL/BELL/SHUTDOWN "Log out for the installation of - _$ DECwindows Motif Version 1.2-5 for OpenVMS please..."

2. Enter the following command at the DCL prompt to prevent nonprivileged users from logging in to the system:

   $ SET LOGINS/INTERACTIVE=0

If possible, give users an estimated time when they can log in to the system again.

This chapter describes how to install and configure DECwindows Motif Version 1.2-5 for OpenVMS software using the POLYCENTER Software Installation utility on Alpha and VAX systems. The DECwindows Motif Version 1.2-5 for OpenVMS product supports POLYCENTER Software installations using the Digital Command Language (DCL) interface.

This chapter presents information about the following topics:

• Section 2.1, Accessing Help Information
• Section 2.2, Extracting and Printing the Product Release Notes
• Section 2.3, Installing the Software
• Section 2.4, Recovering from Errors

Refer to the OpenVMS System Manager's Manual for complete details about installing and managing software products on your system. In addition to getting started information, the OpenVMS System Manager's Manual also provides information about several useful topics, such as:

• Removing installed products
• Reconfiguring installed products
• Copying software kits to new locations
• Retrieving product information
• Discussing differences between the POLYCENTER Software Installation utility and the VMSINSTAL procedure

Refer to Section 1.4 for information about prerequisite software and licenses.

Online help is available with the installation utility for all PRODUCT commands and qualifiers. For help on a specific command, enter the DCL command HELP followed by the command and product name.

Refer to the following documents for information about tasks and PRODUCT commands and qualifiers:

• OpenVMS System Manager's Manual
• OpenVMS System Management Utilities Reference Manual
• OpenVMS DCL Dictionary

Before you begin the installation procedure, you should read the product's release notes. To extract a copy of the DECwindows Motif Version 1.2--5 for OpenVMS Release Notes, define PCSI$SOURCE to point to the location (device name and directory) of the PCSI kit. Then enter the PRODUCT EXTRACT RELEASE_NOTES command followed by the product name, DWMOTIF, at the DCL prompt. For example:

$ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF125] $ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF

Once you extract the release notes to a file, you can print the file. Note that you do not need to install the product before you extract the release notes.

The DECwindows Motif Version 1.2--5 for OpenVMS Release Notes are also available in HTML and ASCII (.TXT) formats in the documentation directory on the DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM. Refer to the Guide to the DECwindows Motif Version 1.2--5 for OpenVMS CD--ROM for information about accessing the release notes and other DECwindows Motif documentation.

2.3 Installing the Software

The sections that follow take you through the stages of installing your DECwindows Motif Version 1.2-5 for OpenVMS software using the POLYCENTER Software Installation utility. The installation procedure is nearly identical on Alpha and VAX systems.

Refer to Chapter 1 for information about account quotas, disk space, and system parameters.

Refer to the OpenVMS System Manager's Manual for complete information about responding to questions that the POLYCENTER Software Installation utility asks during product installation. For example, when you respond to questions, you can do the following:

• Enter a value and press the Return key to select options.
• Press the Return key to accept default values.
• Confirm your responses.
  After you respond to questions by selecting options or accepting default values, the installation utility displays a summary of your answers.
  Then a question is displayed asking whether you are satisfied with your answers and whether you want to continue with the installation. If you decide to change your responses, type No and press the Return key. You can then either reenter your responses or answer No and exit from the installation utility.
• Stop the installation by pressing Ctrl/Y.
  Note that this option is not recommended.

To start the POLYCENTER Software Installation utility, enter one of the following commands at the DCL prompt:

$ DEFINE PCSI$SOURCE device:[PCSI_ALPHA_DWMOTIF125]

or

$ DEFINE PCSI$SOURCE device:[PCSI_VAX_DWMOTIF125]

where device is the name of the device on which the distribution CD-ROM is mounted.

Next, invoke the POLYCENTER Software Installation utility:

$ PRODUCT INSTALL DWMOTIF

2.3.2 The Installation Dialog

The installation dialog begins by displaying the name of the product which PCSI is installing. You are then asked to verify that you wish to continue with the installation. The dialog continues with a display of product name, copyright, and Product Authorization Key (PAK) information.

The following product has been selected: DEC AXPVMS DWMOTIF V1.2-5 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif DECwindows Motif Version 1.2-5 for OpenVMS Alpha is based on Release 5 (R5) of the MIT X11 Window System and OSF/Motif Version 1.2.3. DECwindows Motif V1.2-5 provides both runtime support and development support for the X Window system. Runtime and development support is provided for MIT X11 Release 5 and OSF/Motif Version 1.2.3. Runtime only support is provided for OSF/Motif Version 1.1.3. Copyright Digital Equipment Corporation 1988, 1998. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Digital Equipment Corporation This software product is sold by Digital Equipment Corporation This product uses the PAK: DW-MOTIF This software is furnished under the licensing provisions of Digital Equipment Corporation's Standard Terms and Conditions. For more in- formation about Digital's licensing terms and policies, contact your local Digital office.

2.3.2.1 Verifying Sufficient Allocation for the GBLPAGES and CLISYMTBL Values

The installation command procedure checks to ensure that adequate values are allocated for GBLPAGES, CLISYMTBL, and NPAGEDYN system parameters:

• On OpenVMS Alpha systems, the minimum value for the GBLPAGES system parameter is 150,000; on OpenVMS VAX systems, the minimum value is 62,000.
• On OpenVMS Alpha systems, the minimum value for the CLISYMTBL system parameter is 512; on OpenVMS VAX systems, the minimum value is 256.
• On OpenVMS Alpha systems, the minimum value for the NPAGEDYN system parameter is 1,998,848; on OpenVMS VAX systems, the minimum value is 999,936.

If your system values are sufficient, the installation procedure continues. If the values are insufficient, the procedure abandons the installation and instructs you to run AUTOGEN and then restart the installation. On OpenVMS Alpha systems, the procedure displays a message similar to the following:

Checking values of system parameters... %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 120000, should be at least 150000 %DECW-W-BADVALUE, SYSGEN parameter NPAGEDYN is 1294336, should be at least 1998848 %DECW-W-BADVALUE, SYSGEN parameter CLISYMTBL is 265, should be at least 512 The installation procedure has determined that some system parameter values require modification to install the DECwindows Motif Version 1.2-5 for OpenVMS software. Please type the following command to run AUTOGEN and reboot your system before restarting the DECwindows installation. This will set the system parameters to appropriate values for running DECwindows Motif V1.2-5. @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK The DECwindows installation is being terminated. Please run AUTOGEN and restart the installation. %PCSI-E-S_OPFAIL, operation failed %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error condition

A similar message is displayed on OpenVMS VAX systems.

2.3.2.2 Running AUTOGEN

If the installation procedure has prompted you to run AUTOGEN to correct your system values, enter the following command:

$ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK

The system runs AUTOGEN and produces a log similar to the following example:

%AUTOGEN-I-BEGIN, GETDATA phase is beginning. %AUTOGEN-I-NEWFILE, Previous contents of SYS$SYSTEM:CLU$PARAMS.DAT have been copied to SYS$SYSTEM:CLU$PARAMS.OLD. You may wish to purge SYS$SYSTEM:CLU$PARAMS.OLD. %AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:PARAMS.DAT has been created. You may wish to purge this file. %AUTOGEN-I-END, GETDATA phase has successfully completed. %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning. %AUTOGEN-I-NEWFILE, A new version of SYS$MANAGER:VMSIMAGES.DAT has been created. You may wish to purge this file. %AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:SETPARAMS.DAT has been created. You may wish to purge this file. %AUTOGEN-I-END, GENPARAMS phase has successfully completed. %AUTOGEN-I-BEGIN, GENFILES phase is beginning. %AUTOGEN-I-REPORT, AUTOGEN has produced some informational messages which have been stored in the file SYS$SYSTEM:AGEN$PARAMS.REPORT. You may wish to review the information in that file. %AUTOGEN-I-END, GENFILES phase has successfully completed. %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning. %AUTOGEN-I-SYSGEN, parameters modified %AUTOGEN-I-END, SETPARAMS phase has successfully completed. %AUTOGEN-I-BEGIN, REBOOT phase is beginning. The system is shutting down to allow the system to boot with the generated site-specific parameters and installed images. The system will automatically reboot after the shutdown and the upgrade will be complete. SHUTDOWN -- Perform an Orderly System Shutdown on node MYNODE

You can now restart the installation procedure (see Section 2.3.1).

2.3.2.3 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-5 unless you will also install DECwindows Motif Version 1.2-5 language variants for all the languages that you wish to use.

Local Language Variants of DECwindows Motif must be upgraded at this time. If you have a language variant of DECwindows Motif installed then you must upgrade to the version for DECwindows Motif Version 1.2-5 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-5 then you should remove the local language variant before installing DECwindows Motif Version 1.2-5. Do you want to continue? [YES]

2.3.2.4 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.5 Saving the Programming Environment

The installation procedure checks whether the OSF/Motif Release 1.1.3 programming environment exists on your system. If it is present, the installation procedure displays the following information and asks whether you want to save the OSF/Motif Release 1.1.3 programming environment:

The DECwindows Motif programming environment was installed with a previous version of this kit. This environment is incompatible with the OSF/Motif Release 1.2 environment provided with DECwindows Motif Version 1.2-5. The XUI programming environment is also not included in DECwindows Motif Version 1.2-5. If you intend to continue developing programs for XUI or OSF/Motif Release 1.1.3, then save this environment. Please refer to the installation guide for more details and information on accessing these files in their new location. If you do not choose to save the XUI and OSF/Motif Release 1.1.3 programming environment, those files will be removed from the system disk. Save the OSF/Motif Release 1.1.3 and XUI programming environment?

If you answer Yes and press the Return key to save the OSF/Motif Release 1.1.3 and XUI programming environment, a subdirectory called [.DECW$113] is created. The files that support that programming environment are moved to the [.DECW$113] subdirectory.

If you answer No and press the Return key, the files are deleted.

Refer to Section 1.6 for information about accessing files related to the OSF/Motif Release 1.1.3 programming environment.

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.6 Default Installation

Next, the dialog asks if you want the default installation. On systems with no previous DECwindows Motif installation, the installation procedure installs all options that apply to your hardware platform. On systems with a previous DECwindows Motif installation, the installation procedure installs all options selected during the previous installation.

Do you want the defaults for all options? [YES]

The remainder of this chapter assumes that you answer No to this question.

2.3.2.7 Asking About Selecting a Desktop (Alpha Only)

On OpenVMS Alpha systems, the installation procedure displays information about the New Desktop and asks you whether the New Desktop should be the default desktop.

Install New Desktop Requires 42000 disk blocks. The New Desktop is a graphical user interface that is derived from the Common Desktop Environment (CDE). It offers the following features not available with the traditional DECwindows desktop: o Multiple workspaces for greater flexibility in managing windows on the screen. o An icon-based File Manager to make it easier to manipulate files from the graphical user interface. o Enhanced support for the drag-and-drop feature, which is fully supported in the new File Manager and Application Manager applications. o New Image Viewer and Icon Editor applications. Both the New Desktop and the DECwindows desktop provide the same underlying X and Motif libraries and the same DECterm, Bookreader, Mail, and Calendar applications. Install New Desktop [YES] Install Manual (reference) pages for the New Desktop Requires 2803 disk blocks. The manual pages provide online help text for New Desktop functions. If installed they can be viewed using the man page viewer from the Application Manager. Install Manual (reference) pages for the New Desktop [YES] Make the New Desktop the default desktop [YES] Install traditional DECwindows Desktop Requires 7843 disk blocks. The traditional DECwindows Desktop is that provided since Version 1.2 of DECwindows. If both new and traditional desktops are installed the user can select which to run when logging in. Install traditional DECwindows Desktop [YES]

See Section 4.4 for instructions about how to change the choice of desktop after the installation has completed.