HP OpenVMS Systems Documentation

HP DECwindows Motif for OpenVMS
Installation Guide

Use the table appropriate to your operating system to determine the minimum recommended system parameter values for running DECwindows. The DECwindows installation supplies a NEWPARAMS.DAT file which AUTOGEN uses as input for its CLU$PARAMS.DAT file. The CLU$PARAMS.DAT file captures system parameter requirements from layered products that use the NEWPARAMS.DAT method of supplying their system parameter requirements to AUTOGEN. In most cases, this process eliminates the need to modify the MODPARAMS.DAT file.

Depending on the kinds of programs and applications running at your site, you might need higher values for some settings. If you need higher settings, you should modify the MODPARAMS.DAT file before running the AUTOGEN procedure. See the HP DECwindows Motif for OpenVMS Management Guide for additional system tuning recommendations.

HP 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 HP OpenVMS System Management Utilities Reference Manual.

1.6.5 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 - _$ HP DECwindows Motif for OpenVMS, Version 1.5 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 software using the POLYCENTER Software Installation (PCSI) utility. The DECwindows Motif product supports PCSI 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 DECwindows Motif Software
• Section 2.4, Recovering from Errors

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

• Removing installed products
• Reconfiguring installed products
• Copying software kits to new locations
• Retrieving product information

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

2.1 Accessing Help Information

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

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

Refer to the HP OpenVMS System Manager's Manual for complete information about responding to questions that the PCSI 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.)

Before you begin the installation procedure, you should read the product release notes. To extract a copy of the 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:[KITS]
$ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF

In the above example, the directory in which the installation kit is located is referred to as dka400:[kits]. You should substitute this directory name with the actual location of the DECwindows Motif kit. To obtain the directory location of the DECwindows Motif kit, refer to the documentation that accompanies the product distribution media.

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.

2.3 Installing the DECwindows Motif Software

The following sections describe how to install the DECwindows Motif software using the PCSI utility.

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

2.3.1 Starting the Installation

To start the PCSI utility, enter the following command at the DCL prompt:

$ DEFINE PCSI$SOURCE device:[KITS]

where device is the name of the device on which the distribution media is mounted or the installation kit is located. In the above example, the directory in which the installation kit is located is referred to as [KITS]. You should substitute this directory name with the actual directory location of the DECwindows Motif kit. To obtain the location of the kit, refer to the documentation that accompanies the product distribution media.

Next, invoke PCSI:

$ PRODUCT INSTALL DWMOTIF

The installation dialog begins by displaying the name of the product which PCSI is installing. You are then asked to verify that you want to continue with the installation. The dialog continues with a display of product name, copyright, and licensing information.

The following product has been selected:
DEC AXPVMS DWMOTIF V1.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.5: DECwindows Motif

HP DECwindows for OpenVMS Version 1.5 is based on Version 11
Release 6.6 of the X Window System (X11R6.6) and OSF/Motif Version 1.2.5.

DECwindows Motif V1.5 provides both runtime and development support for
the X Window System. Runtime and development support is provided for
X11 Release 6.6 (X11R6.6) and OSF/Motif Version 1.2.5. For OSF/Motif
Version 1.1.3, only runtime support is provided.





(c) Copyright 2004 Hewlett-Packard Development Company, L.P.


Proprietary computer software. Valid license from HP required for
possession, use, or copying. Consistent with FAR 12.211 and 12.212,
Commercial Computer Software, Computer Software Documentation, and
Technical Data for Commercial Items are licensed to the U.S. Government
under vendor's standard commercial license.


Hewlett-Packard Company.

This software product is sold by Hewlett-Packard Company.

This product uses the PAK: DW-MOTIF

This software is furnished under the licensing provisions of
Hewlett-Packard Company's Standard Terms and Conditions.
For more information about HP's licensing terms and policies,
contact your local HP office.

The DECwindows Motif Alpha 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.5.
XUI programming environment is also not included in
DECwindows Motif Version 1.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 HP DECwindows Motif for OpenVMS Release Notes 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 installing or upgrading the OpenVMS operating system and the DECwindows Motif software simultaneously.

2.3.2.2 Default Installation

If this is an upgrade, and a prior version of DECwindows Motif is present, the procedure installs all options selected previously. Any options that were not available in the prior version are installed according to their current default settings.

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.3 LBX Proxy Installation

Next, 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 OpenVMS Management Guide for more information about the LBX feature.

2.3.2.4 Selecting Installation of Client Software

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

Install the DECwindows Motif Version 1.5 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.8.

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.8. If you answer No, proceed to Section 2.3.2.5.

2.3.2.5 Asking About Selecting a Desktop

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

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$PRIVATE_APPS_SETUP.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 is complete.

2.3.2.6 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]