The installation command procedure checks to ensure that adequate values are allocated for the system parameters shown in Table 1-5 and Table 1-6. If your system values are sufficient, the installation procedure continues. If any of 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 messages similar to the following:

Checking values of system parameters... %DECW-W-BADVALUE, SYSGEN parameter GBLSECTIONS is 380, should be at least 600 %DECW-W-BADVALUE, Free GBLSECTIONS is 15, should be at least 260 %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.3 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 Version 1.3. @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

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 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 V1.3-0. The XUI programming environment is also not included in DECwindows Motif Version 1.3. 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.5 for information about accessing files related to the OSF/Motif Release 1.1.3 programming environment.

2.3.2.4 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. Any options not present in the installed version are installed according to the defaults for those options in Version 1.3.

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.5 Installation of Server Software

The installation proceeds with an important warning about the DECwindows Motif server patch about to be installed by the installation procedure.

DECwindows Motif V1.3-0 cannot be uninstalled. The DECwindows Motif for OpenVMS Alpha Version 1.3 software upgrade also updates certain images that are part of the OpenVMS Alpha operating system. Removing the DECwindows Motif Version 1.3 product (using PRODUCT REMOVE) does not restore the operating system images to their proper state. To revert to a previous version of DECwindows Motif, you must first reinstall the OpenVMS Alpha operating system and then install the appropriate version of DECwindows Motif. Be sure that you want to install the DECwindows Motif Version 1.3 software before proceeding. Do you want to continue? [YES]

Note that the server patch is always installed with DECwindows Motif. The question in this section asks if you want to continue with the product installation, not if you want to install the server software.

2.3.2.6 Euro Currency Sign Support

The dialog asks if you want to install support for the Euro currency sign.

This option provides Euro sign support for Compaq DECwindows Motif for OpenVMS Alpha Version 1.3. After installing the option and performing the setup process, you can enter and display the Euro sign. Install the DECwindows Motif Euro sign support [NO]

See the HP DECwindows Motif for HP OpenVMS Alpha New Features manual for more information about the Euro option.

2.3.2.7 LBX Proxy Installation

Following the server installation, the dialog asks if you want to install the Low-Bandwidth X (LBX) proxy option.

The LBX proxy reduces the overall network bandwidth required for client-to-server communications. The LBX proxy can be installed as a standalone option or in conjunction with the DECwindows Motif client software. Install Low Bandwidth X (LBX) Support [YES]

See the HP DECwindows Motif for HP OpenVMS Alpha New Features manual for more information about the LBX feature.

2.3.2.8 Selecting Installation of Client Software

Next, the installation procedure asks if you want to install the client software:

Install the DECwindows Motif Version 1.3 client software? [YES]

Answer Yes if you intend to run any programs requiring a DECwindows display, either on this system or on any remote system.

If you answer No, skip to Section 2.3.2.12.

If you answer Yes, the dialog asks if you want the default client installation:

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

Answer Yes if you want to take all the defaults for the client installation. If you answer Yes, skip to Section 2.3.2.12. If you answer No, proceed to Section 2.3.2.9.

2.3.2.9 Asking About Selecting a Desktop

The installation procedure displays information about the New Desktop and traditional DECwindows desktop. You can elect to install one of the desktops or both desktops. If you elect to install the New Desktop, the dialog asks whether the New Desktop should be the default desktop.

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] 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] If the New Desktop is the default, the new login box will be used and the user has the option at login to use either the New or the traditional desktop. If the New Desktop is not the default, the traditional login box will be used and only the traditional desktop will be available. You can change the default desktop by editing the file [SYSMGR]DECW$DEFAULT_DESKTOP.COM and restarting DECwindows. Make the New Desktop the default desktop [YES] 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 3.4 for instructions about how to change the choice of desktop after the installation has completed.

2.3.2.10 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.

The installation procedure uses the following dialog:

Headers and related files to support programs in C that will use the DECwindows libraries. Programming Support for the C Language [YES] Include files to support programs in Pascal that will use the DECwindows libraries. Programming Support for the Pascal Language [YES] Include files to support programs in FORTRAN that will use the DECwindows libraries. Programming Support for the FORTRAN Language [YES] Headers and related files to support programs in C that will use the New Desktop widgets. Programming Support for the New Desktop [YES] Examples of programming to use the various libraries. Programming examples [YES] Do you want all the defaults for the subitems? [YES] no Sample sound files that can be used with DECsound. Sound example files [YES] Examples, in various programming languages, of using the DECwindows and standard widgets and libraries. Programming examples for DECwindows [YES] Examples, in C, of using the new widgets provided with the New Desktop. Programming examples for the New Desktop [YES]

2.3.2.11 Translated Image Support

The dialog now prompts you to install Translated Image Support (TIS), which enables VAX programs to work in the Alpha environment. Note that TIS support is only available for the traditional DECwindows desktop environment.

Translated image support allows programs translated from the VAX environment 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.12 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.3 unless you will also install DECwindows Motif Version 1.3 language variants for all the languages that you want 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.3 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.3, then you should remove the local language variant before installing DECwindows Motif Version 1.3. Do you want to continue? [YES]

2.3.2.13 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.3-0: DECwindows Motif DEC AXPVMS VMS V7.3-1 [Installed] Install the DECwindows Motif Euro sign support: NO Install Low Bandwidth X (LBX) Support: YES Install the DECwindows Motif V1.3-0 client software: YES 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.14 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.

Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF V1.3-0 DISK$ALPHASYS:[VMS$COMMON.] The following product will be removed from destination: DEC AXPVMS DWMOTIF V1.2-6 DISK$ALPHASYS:[VMS$COMMON.] Portion done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90%

2.3.2.15 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 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 ****

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.

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. Add 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.

2.3.2.16 Reviewing Final Installation Notes

If the installation is successful, the dialog displays a list of all products installed and removed. Finally, the procedure displays additional installation notes for the DECwindows Motif product.

...100% The following product has been installed: DEC AXPVMS DWMOTIF V1.3-0 Layered Product The following product has been removed: DEC AXPVMS DWMOTIF V1.2-6 Layered Product DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif System reboot is required. If using a language variant, reboot after upgrade of language variant. A system reboot is required to install the new DECwindows 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.3 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:

• The operating system version is incorrect.
• The prerequisite software version is incorrect.
• Quotas necessary for successful installation are inadequate.
• Process quotas required by the installation utility are inadequate.
• The OpenVMS Help library is currently in use.

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.3 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 (see Table 1-5 and Table 1-6).

When DECwindows Motif attempts to start after successful installation, you will see messages 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.