Order Number: AA--RT26A--TE
This manual provides step-by-step instructions for installing HP DECwindows Motif for HP OpenVMS Alpha Version 1.3.
Revision/Update Information: This manual supersedes the DECwindows Motif Version 1.2--6 for OpenVMS Installation Guide.
Operating System: HP OpenVMS Alpha Version 7.3-1
Software Version: HP DECwindows Motif for HP OpenVMS Alpha Version 1.3
Hewlett-Packard Company Palo Alto, California
© 2003 Hewlett-Packard Development Company, L.P.
Motif, OSF/1, UNIX, and the "X" device are registered trademarks and The Open Group is a trademark of The Open Group in the U.S. and other countries.
Confidential computer software. Valid license from HP and/or its subsidiaries 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.
Neither HP nor any of its subsidiaries shall be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.
ZK6434
The HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 documentation set is available on CD-ROM.
This document was prepared using VAX DOCUMENT, Version V3.2n.
| Contents | Index |
This manual is intended for anyone who plans to install the HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software.
This manual contains the following chapters and appendixes:
In addition to this manual, the following documents are useful when installing the DECwindows Motif software:
For additional information about OpenVMS or DECwindows Motif products and services, visit the following web site:
http://www.openvms.compaq.com |
HP welcomes your comments on this manual. Please send comments to either of the following addresses:
| Internet | openvmsdoc@hp.com |
|
Hewlett-Packard Company
OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 |
For information about how to order additional documentation, visit the following World Wide Web address:
http://www.openvms.compaq.com/doc/ |
DECwindows Motif contains a graphical user interface that is derived from the Common Desktop Environment (CDE). This interface is referred to throughout this document as the New Desktop.
Unless otherwise specified, references to OpenVMS Clusters, VMSclusters, or clusters in this document are synonymous with HP OpenVMS Clusters.
All uses of DECwindows and DECwindows Motif refer to the HP DECwindows Motif for HP OpenVMS Alpha software; and all uses of X server and X display server refer to the HP DECwindows X11 Display Server. Additionally, all uses of DECwindows XUI (X User Interface) refer to the DECwindows product prior to DECwindows Motif Version 1.0.
The following conventions are also used in this manual:
| Ctrl/ x | A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. |
| [Return] |
In examples, a key name enclosed in a box indicates that you press a
key on the keyboard. (In text, a key name is not enclosed in a box.)
In the HTML version of this document, this convention appears as brackets, rather than a box. |
| ... |
Horizontal ellipsis points in examples indicate one of the following
possibilities:
|
|
.
. . |
Vertical ellipsis points indicate the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed. |
| ( ) | In command format descriptions, parentheses indicate that you must enclose the choices in parentheses if you choose more than one. |
| [ ] | In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.) |
| | | In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options. |
| { } | In command format descriptions, braces surround a required choice of options; you must choose one of the options listed. |
| text style |
This text style represents the introduction of a new term or the name
of an argument, an attribute, or a reason.
In the HTML version of this document, this convention appears as italic text. |
| italic text | Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system messages (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type). |
| UPPERCASE TEXT | Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege. |
| Monospace type |
Monospace type indicates code examples and interactive screen displays.
In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example. |
| - | A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line. |
| numbers | All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated. |
This chapter describes the preparation and requirements for installing HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software using the POLYCENTER Software Installation utility.
HP strongly recommends that you read the release notes before proceeding with the installation. The DECwindows Motif product provides online release notes. See Section 2.2 for instructions on how to access this information. |
This chapter presents information about the following topics:
Before you install and run DECwindows Motif software on a newly licensed node or cluster, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK is provided along with the kit if you ordered the license and media together; otherwise, it is provided separately to a location based on your license order.
If you are installing DECwindows Motif software as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements.
You must register and load your license for DECwindows Motif before you run the Installation Verification Procedure (IVP) and use the software.
To register a license, log in to the system manager account (SYSTEM). Then choose one of the following options to register the license:
If you plan to use DECwindows Motif software on more than one node in a VMScluster, load the license on the other nodes after you complete this installation.
For complete information about using LMF, see the OpenVMS License Management Utility Manual.
1.2 Supported Hardware
HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software can be installed on any supported Alpha
processor. For a complete list of supported hardware, see the OpenVMS
Alpha Version 7.3-1 and HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 Software Product
Descriptions (SPDs).
1.3 Prerequisites for the Installation Procedures
Before you can install and configure DECwindows Motif software, you must have the required version of the OpenVMS operating system software, sufficient memory, and a license. (Refer to Section 1.1 for information about registering a License Product Authorization Key [PAK].)
Use the POLYCENTER Software Installation utility to install your
DECwindows Motif software according to the following operating system
information.
1.4 Required Operating System Software
The HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software requires that the OpenVMS Alpha Version 7.3-1 operating system be installed with the DECwindows support options described in Table 1-1.
If your system is not running a supported version of OpenVMS before you attempt to install DECwindows Motif, the installation fails.
A minimum of 64 MB of memory is required; at least 128 MB of memory is highly recommended.
The OpenVMS operating system provides two subsets of components to support DECwindows Motif. To use DECwindows Motif software, your system must be running a version of the OpenVMS system that includes the following components, as described in Table 1-1.
| Option | Description |
|---|---|
| DECwindows Motif network transport and base system support |
This component is required to install DECwindows Motif and to run
DECwindows Motif applications. During the installation of OpenVMS, you are
prompted to specify whether you want to install this option.
To determine whether this option was installed during the
installation of OpenVMS, check for the existence of the following file:
|
| DECwindows X11 Display Server, fonts, and device drivers |
This component is necessary to display DECwindows Motif applications or any
other X Window applications on your system. During the installation of
OpenVMS, you are prompted to specify whether you want to install this
option.
To determine whether this option was installed during the
installation of OpenVMS, check for the existence of the following file:
If the DECW$SERVER_MAIN.EXE file is not on your system, you cannot display DECwindows Motif or other X Window applications on your local system 1. The DECwindows Motif installation procedure asks whether you want to continue the installation without workstation support. |
See the release notes and cover letter for the version of the OpenVMS operating system that you are running for more information about the DECwindows X11 Display Server. |
The X Window System and OSF/Motif libraries that are provided with DECwindows Motif software are incompatible with those libraries provided with versions of DECwindows Motif prior to Version 1.2. Run-time compatibility is preserved, but the earlier OSF/Motif Release 1.1.3 and XUI programming environments are not compatible with the later OSF/MOTIF Release 1.2 programming environment.
Programming in the XUI and OSF/Motif Release 1.1.3 environments that were provided in previous versions of DECwindows Motif is no longer supported in the DECwindows Motif product. However, the installation procedure gives you the option of saving the XUI and OSF/Motif Release 1.1.3 programming files that already exist on your system. If you choose to save these programming files, they are moved to subdirectories where you can access them for programming. Specifically, the installation creates a subdirectory called [.DECW$113] in each of the directories listed in Table 1-2 and moves the previous files into the new [.DECW$113] subdirectory.
| Directory | Contents | New Location |
|---|---|---|
| DECW$INCLUDE | C header files | SYS$SYSROOT:[DECW$INCLUDE.DECW$113] |
| SYS$SYSTEM | UIL compiler | SYS$SYSROOT:[SYSEXE.DECW$113] |
| SYS$LIBRARY | Non-C language bindings | SYS$SYSROOT:[SYSLIB.DECW$113] |
The process for using the saved programming environment is documented in the programmer chapter of the release notes. |
The installation procedure replaces the following file with a new version:
SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF
If you customized this file and want to save it, copy the file to another directory or rename the file prior to the installation of DECwindows Motif software so that it is not deleted.
To copy your customized file to another directory, create the directory and define a global symbol in the file DECW$PRIVATE_APPS_SETUP.COM.
To create a Bookreader directory called SYS$COMMON:[DECW$BOOK_LOCAL], perform the following steps:
$ CREATE/DIRECTORY/PROTECTION=WORLD:R - _$ SYS$COMMON:[DECW$BOOK_LOCAL] |
$ COPY SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF - _$ SYS$COMMON:[DECW$BOOK_LOCAL]*/LOG |
$ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE - _$ SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM/LOG |
$ DECW$BOOK == "SYS$COMMON:[DECW$BOOK_LOCAL]" |
$ @SYS$MANAGER:DECW$STARTUP RESTART |
For more information about customizing your DECwindows Motif environment,
see Managing DECwindows Motif for OpenVMS Systems.
1.7 Installation Procedure Requirements
This section discusses the requirements for installing the DECwindows Motif software using PCSI.
The installation procedure checks the following:
1.7.1 Process Account Quotas
The installation procedure requires that the installation account has
the minimum quotas shown in Table 1-3.
| Quota Name | Value |
|---|---|
| ASTLM | 250 |
| BIOLM | 150 |
| BYTLM | 64,000 |
| DIOLM | 150 |
| ENQLM | 2,000 |
| FILLM | 100 |
Use the OpenVMS AUTHORIZE utility to verify and to change process quotas for the installation account in the user authorization file (UAF). (Some sites may restrict the use of the AUTHORIZE utility to certain accounts or users.) For example, to change the BYTLM quota for the account-name installation account, enter the following commands:
$ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> SHOW account-name UAF> MODIFY account-name /BYTLM = 64000 UAF> SHOW account-name UAF> EXIT $ LOGOUT |
After you change the quotas for the installation account, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation.
User account quotas are stored in the file SYS$SYSTEM:SYSUAF.DAT. For
more information about modifying account quotas, see the description of
the AUTHORIZE utility in the OpenVMS System Management Utilities Reference Manual.
1.7.2 Disk Space
Use Table 1-4 to determine the amount of free disk space that is required on the system disk to install DECwindows Motif components. However, because you can choose not to install all the components, your actual disk space requirement may be less.
To determine the number of free blocks on the system disk, enter the following command at the DCL prompt:
$ SHOW DEVICE SYS$SYSDEVICE |
The installation procedure checks for free disk space on the system disk. If sufficient space is not available, the installation procedure provides the following options:
If you run out of free disk space during the installation, the installation procedure fails. |
| Component/Subcomponent | Requirement | Subtotals | Totals | ||
|---|---|---|---|---|---|
| Installation overhead: | 40,000 1 | 40,000 | 40,000 | ||
| Server software: | |||||
| Server base kit | 4,120 | 4,120 | |||
| Euro currency support | 19,880 | 19,880 | |||
| Server total | 24,000 | ||||
| LBX support: | 950 | 950 | 950 | ||
| Client software: | |||||
| Client base kit | 58,450 | 58,450 | |||
| Desktop support | |||||
| New Desktop | 42,340 | ||||
| DECwindows desktop | 7,860 | ||||
|
Manual pages for
New Desktop |
2,810 | ||||
| Desktop subtotal | 53,010 | ||||
| Programming environment | |||||
| C, C++ | 7,870 | ||||
| FORTRAN | 2,060 | ||||
| Pascal | 3,020 | ||||
| New Desktop | 150 | ||||
| Programming subtotal | 13,100 | ||||
| Example programs | |||||
| Sound examples | 1,560 | ||||
| Programming examples | 10,220 | ||||
| New Desktop examples | 1,250 | ||||
| Examples subtotal | 13,030 | ||||
| Translated image support | 28,330 | 28,330 | |||
| Client total | 165,920 | ||||
| Total for all components: | 230,870 | ||||
| Next | Contents | Index |