Compaq DECwindows Motif for OpenVMS ___________________________________________ Installation Guide Order Number: AA-Q1EAE-TE April 2001 This manual provides step-by-step instructions for installing Compaq DECwindows Motif for OpenVMS. Revision/Update Information: This manual supersedes the DECwindows Motif Version 1.2-5 for OpenVMS Installation Guide. Operating System: OpenVMS Alpha Version 6.2, 7.1-2, 7.2-1, or 7.3 OpenVMS VAX Version 6.2, 7.1, 7.2, or 7.3 VMS Version 5.5-2 Software Version: Compaq DECwindows Motif for OpenVMS Alpha, Version 1.2-6 Compaq DECwindows Motif for OpenVMS VAX, Version 1.2-6 Compaq Computer Corporation Houston, Texas ________________________________________________________________ April 2001 © 2001 Compaq Computer Corporation COMPAQ, OpenVMS, VAX, VMS, the Compaq logo, and the DIGITAL logo Registered in U.S. Patent and Trademark Office. Motif, OSF/1, and UNIX are registered trademarks of The Open Group. All other product names mentioned herein may be the trademarks or registered trademarks of their respective companies. Confidential computer software. Valid license from Compaq or authorized sublicensor 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. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this publication is subject to change without notice and is provided "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH THE RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING SHALL APPLY REGARDLESS OF THE NEGLIGENCE OR OTHER FAULT OF EITHER PARTY AND REGARDLESS OF WHETHER SUCH LIABILITY SOUNDS IN CONTRACT, NEGLIGENCE, TORT, OR ANY OTHER THEORY OF LEGAL LIABILITY, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY. The limited warranties for Compaq products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty. ZK6434 The Compaq OpenVMS documentation set is available on CD- ROM. _________________________________________________________________ Contents Preface................................................... ix 1 Preparing to Install the Software 1.1 License Registration.......................... 1-2 1.2 Supported Hardware............................ 1-3 1.3 Prerequisites for the Installation Procedures.................................... 1-3 1.4 Required Operating System Software............ 1-3 1.5 Required ECO for POLYCENTER Software Installation Utility.......................... 1-6 1.5.1 Upgrade Problem After Installing Required PCSI ECO.................................. 1-7 1.6 OSF/Motif Release 1.1.3 and XUI Programming Support....................................... 1-8 1.7 Saving Customized Bookreader Files............ 1-9 1.8 Installation Procedure Requirements........... 1-10 1.8.1 Process Account Quotas.................... 1-11 1.8.2 Disk Space................................ 1-12 1.8.3 System Parameters......................... 1-14 1.8.4 Additional System Maintenance Procedures................................ 1-16 1.8.4.1 Checking System Parameter Values........ 1-17 1.8.4.2 Calculating the Number of Free Global Pages and Global Sections............... 1-17 1.8.4.3 Setting the Size of the Page File....... 1-18 1.8.4.4 Changing System Parameter Values Using the AUTOGEN Utility..................... 1-19 1.8.5 Backing Up Your System Disk............... 1-20 1.8.6 Notifying Other Users..................... 1-21 iii 2 Using the POLYCENTER Software Installation Utility 2.1 Accessing Help Information.................... 2-2 2.2 Extracting and Printing the Product Release Notes......................................... 2-3 2.3 Installing the Software....................... 2-4 2.3.1 Starting the Installation................. 2-5 2.3.2 The Installation Dialog................... 2-5 2.3.2.1 Verifying Sufficient Allocation for the GBLPAGES and CLISYMTBL Values........... 2-6 2.3.2.2 Running AUTOGEN......................... 2-8 2.3.2.3 Saving the Programming Environment...... 2-9 2.3.2.4 Default Installation.................... 2-10 2.3.2.5 Asking About Selecting a Desktop (Alpha Only)................................... 2-10 2.3.2.6 Programming Language Support Options.... 2-11 2.3.2.7 Translated Image Support................ 2-13 2.3.2.8 Language Variants Notice................ 2-13 2.3.2.9 Reviewing the Installation Options...... 2-13 2.3.2.10 Execution Dialog........................ 2-14 2.3.2.11 Verifying DECwindows Motif Support Files................................... 2-15 2.3.2.12 Reviewing Final Installation Notes...... 2-17 2.4 Recovering from Errors........................ 2-17 2.5 Adjusting Parameters After Installation....... 2-18 3 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.1 Installation Procedure Requirements........... 3-2 3.1.1 Process Privileges........................ 3-3 3.1.2 Using an Alternate Working Device......... 3-3 3.1.3 Using the Distributed File Service........ 3-5 3.2 Installation Procedure........................ 3-5 3.2.1 Product and Device Names.................. 3-5 3.2.2 Invoking the VMSINSTAL Procedure.......... 3-6 3.2.3 Confirming System Backup.................. 3-8 3.2.4 Mounting Distribution Media............... 3-9 3.2.5 Choosing a Release Notes Option........... 3-9 3.2.6 Continuing the Installation............... 3-10 3.2.7 Preserving the OSF/Motif Release 1.1.3 Programming Environment................... 3-11 3.2.8 Installing the Entire Kit................. 3-12 3.2.9 Choosing Programming Support Files........ 3-12 3.2.10 Verifying Kit Selections.................. 3-13 iv 3.2.11 Verifying Disk Space...................... 3-14 3.2.12 Verifying License Registration............ 3-16 3.2.13 Performing a System Reboot................ 3-16 3.2.14 Reading Informational Messages............ 3-17 3.2.15 Using the AUTOGEN Utility to Set System Parameters................................ 3-19 3.2.16 Completing the Installation Procedure..... 3-21 3.3 Recovering from Errors........................ 3-22 3.4 Accessing the Release Notes................... 3-22 4 After Installing the Software 4.1 Starting the DECwindows Motif Software........ 4-1 4.1.1 Standalone Systems........................ 4-3 4.1.2 OpenVMS Cluster Systems................... 4-3 4.1.2.1 Starting Nonsatellite and Boot Nodes.... 4-3 4.1.2.2 Starting Satellite Nodes................ 4-4 4.2 Running the IVP............................... 4-5 4.3 Choosing an Alternate Console................. 4-7 4.4 Selecting the Desktop (Alpha Only)............ 4-7 5 Managing DECwindows Motif Software 5.1 Customizing the DECwindows X11 Display Server Startup Procedure............................. 5-1 5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)........................... 5-8 5.3 Adding DECwindows Base-Support Files.......... 5-14 5.3.1 Reconfiguring the OpenVMS Operating System (Alpha Only).............................. 5-15 5.3.2 Using the SYS$UPDATE:DECW$TAILOR.EXE Command (VAX Only)........................ 5-15 5.4 Determining and Reporting Problems............ 5-20 A POLYCENTER Software Installation Utility Sample Installations A.1 Sample Installation on an OpenVMS Alpha Version 7.1-2 System.......................... A-2 A.2 Sample Installation on an OpenVMS VAX Version 7.1 System.................................... A-7 A.3 Sample Installation on an OpenVMS Alpha Version 6.2 System............................ A-11 v B VMSINSTAL Sample Installation B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2 System.......................... B-1 C Software Components Index Examples 4-1 Sample IVP................................ 4-6 5-1 Sample DECW$MOTIF_TAILOR Session.......... 5-12 5-2 Sample DECW$TAILOR Session................ 5-18 A-1 Sample Installation of the Mandatory ECO for PCSI on an OpenVMS Alpha System....... A-2 A-2 Sample Installation of an Upgrade of DECwindows Motif on an OpenVMS Alpha Version 7.1-2 System With Sufficient System Resources.......................... A-4 A-3 Sample Installation of an Upgrade of Compaq DECwindows Motif for OpenVMS on an OpenVMS VAX Version 7.1 System With Insufficient System Resources............. A-7 A-4 Sample Installation of the Mandatory ECO for PCSI on an OpenVMS Alpha System....... A-11 A-5 Sample Installation of an Upgrade of DECwindows Motif on an OpenVMS Alpha System With Insufficient System Resources................................. A-12 B-1 Sample Installation Using VMSINSTAL....... B-1 Tables 1-1 Directories for Previous XUI or OSF/Motif Programming Environments.................. 1-8 1-2 Process Quotas for the Installation Account................................... 1-11 1-3 Approximate Required Disk Space by Component (in Blocks)..................... 1-13 vi 1-4 Minimum Required System Parameter Values.................................... 1-15 1-5 Required Number of Contiguous Free Global Pages and Free Global Sections............ 1-18 1-6 Recommended System Parameter Values to Use with the ADD_ Option...................... 1-20 5-1 DECwindows Keymap......................... 5-5 5-2 Classes of OpenVMS Files That Can Be Removed with the DECW$MOTIF_TAILOR Utility................................... 5-9 5-3 Classes of Files That Can Be Added or Removed with the DECW$TAILOR Utility...... 5-16 vii _________________________________________________________________ Preface Intended Audience This manual is intended for anyone who plans to install Compaq DECwindows Motif for OpenVMS software. Document Structure This manual contains the following chapters and appendixes: o Chapter 1 discusses how to prepare for installing Compaq DECwindows Motif for OpenVMS software. o Chapter 2 discusses how to install Compaq DECwindows Motif for OpenVMS using the POLYCENTER Software Installation utility. o Chapter 3 discusses how to install Compaq DECwindows Motif for OpenVMS using the VMSINSTAL procedure. o Chapter 4 provides startup procedures. This chapter also includes a sample Installation Verification Procedure (IVP). o Chapter 5 discusses tuning, customizing the environment, removing unwanted files, and reporting errors. o Appendix A presents a sample DECwindows Motif installation using the POLYCENTER Software Installation utility on an OpenVMS Alpha Version 7.1-2 system, an OpenVMS VAX Version 7.1 system, and an OpenVMS Alpha Version 6.2 system. It also presents a sample installation of the PCSI ECO. o Appendix B shows a sample product installation using the VMSINSTAL procedure on a VMS Version 5.5-2 system. ix o Appendix C shows how to obtain a list of the software components for the Compaq DECwindows Motif for OpenVMS product using the POLYCENTER Software Installation utility. Related Documents In addition to this manual, the following documents are useful when installing Compaq DECwindows Motif for OpenVMS software: o Compaq DECwindows Motif for OpenVMS Release Notes o Guide to the Compaq DECwindows Motif for OpenVMS CD-ROM o Getting Started With the New Desktop o Managing DECwindows Motif for OpenVMS Systems o OpenVMS System Manager's Manual o OpenVMS System Management Utilities Reference Manual o A Comparison of System Management on OpenVMS AXP and OpenVMS VAX For additional information on the OpenVMS System Software Group (OSSG) products and services, access the following OpenVMS World Wide Web address: http://www.openvms.compaq.com Reader's Comments Compaq welcomes your comments on this manual. Please send comments to either of the follwing addresses: Internet openvmsdoc@compaq.com Mail Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 x How To Order Additional Documentation Use the following World Wide Web address to order additional documentation: http://www.openvms.compaq.com:8000/ Conventions Compaq DECwindows Motif for OpenVMS Alpha 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. VMScluster systems are now referred to as OpenVMS Cluster systems. Unless otherwise specified, references to OpenVMS Clusters or clusters in this document are synonymous with VMSclusters. In this manual, every use of DECwindows and DECwindows Motif refers to Compaq DECwindows Motif for OpenVMS software. 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. 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. xi . . . Horizontal ellipsis points in examples indicate one of the following possibilities: o Additional optional arguments in a statement have been omitted. o The preceding item or items can be repeated one or more times. o Additional parameters, values, or other information can be entered. . 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. xii 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. xiii 1 _________________________________________________________________ Preparing to Install the Software This chapter describes the preparation and requirements for installing Compaq DECwindows Motif for OpenVMS software using either the POLYCENTER Software Installation utility or the VMSINSTAL procedure. Your Bill of Materials (BOM) specifies the number and contents of your media. Verify the contents of your kit with this information. If your kit is damaged or if you find that parts are missing, contact your Compaq representative. ________________________ Note ________________________ Compaq strongly recommends that you read the release notes before proceeding with the installation. The Compaq DECwindows Motif for OpenVMS product provides online release notes. For information about accessing the release notes: o If you install the software using the POLYCENTER Software Installation utility, see Section 2.2. o If you use the VMSINSTAL procedure to install the software, see Section 3.2.5. ______________________________________________________ This chapter presents information about the following topics: o Section 1.1, License Registration o Section 1.2, Supported Hardware o Section 1.3, Prerequisites for the Installation Procedures o Section 1.4, Required Operating System Software o Section 1.5, Required ECO for POLYCENTER Software Installation Utility 1-1 Preparing to Install the Software o Section 1.6, OSF/Motif Release 1.1.3 and XUI Programming Support o Section 1.7, Saving Customized Bookreader Files o Section 1.8, Installation Procedure Requirements 1.1 License Registration Before you install and run Compaq DECwindows Motif for OpenVMS 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 Compaq DECwindows Motif for OpenVMS 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 Compaq DECwindows Motif for OpenVMS 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: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When the procedure prompts you for information, respond with data from your License PAK. o At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information. If you plan to use Compaq DECwindows Motif for OpenVMS 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 Preparing to Install the Software 1.2 Supported Hardware 1.2 Supported Hardware Compaq DECwindows Motif for OpenVMS software can be installed on any supported Alpha or VAX processor. For a complete list of supported hardware, see the Compaq DECwindows Motif for OpenVMS Software Product Description (SPD). 1.3 Prerequisites for the Installation Procedures Before you can install and configure Compaq DECwindows Motif for OpenVMS software, you must have the required versions 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 or the VMSINSTAL procedure to install your DECwindows Motif software according to the operating system information that follows. ___________________________________________________________ Operating_System___________Installation_Method_____________ OpenVMS Alpha Version 6.2 POLYCENTER Software Installation (or higher) utility OpenVMS VAX Version 6.2 (or higher) VMS_Version_5.5-2__________VMSINSTAL_procedure_____________ 1.4 Required Operating System Software The Compaq DECwindows Motif for OpenVMS software requires one of the following operating systems: o OpenVMS Alpha Version 6.2, 7.1-2, 7.2-1, or 7.3 o OpenVMS VAX Version 6.2, 7.1, 7.2, or 7.3 o VMS Version 5.5-2 If your system is not running one of these versions before you attempt to install Compaq DECwindows Motif for OpenVMS, the installation fails. 1-3 Preparing to Install the Software 1.4 Required Operating System Software A minimum of 16 MB of memory is required for OpenVMS VAX systems; 32 MB of memory is highly recommended. A minimum of 64 MB of memory is required for OpenVMS Alpha systems; at least 128 MB of memory is highly recommended. The OpenVMS operating system provides two subsets of components to support Compaq DECwindows Motif for OpenVMS. To use Compaq DECwindows Motif for OpenVMS software, your system should be running a version of the OpenVMS system that includes the following components: o DECwindows Motif transports and base system support This support is required to install Compaq DECwindows Motif for OpenVMS and to run Compaq DECwindows Motif for OpenVMS 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, enter the following command: $ DIR SYS$LIBRARY:DECW$TRANSPORT_COMMON.EXE See Section 5.3 for information on adding DECwindows base support files after OpenVMS has been installed. o DECwindows X11 display server for OpenVMS, fonts, and device drivers, which are necessary to display Compaq DECwindows Motif for OpenVMS applications or any other X11 applications on your Alpha or VAX 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, enter the following command: $ DIR SYS$SYSTEM:DECW$SERVER_MAIN.EXE If the DECW$SERVER_MAIN.EXE file is not on your system, you cannot display Compaq DECwindows Motif for OpenVMS applications on your Alpha or VAX system. However, you can run Compaq DECwindows Motif for OpenVMS applications that display on a DECwindows X11 display server that runs on another system. The Compaq DECwindows Motif for 1-4 Preparing to Install the Software 1.4 Required Operating System Software OpenVMS installation procedure asks whether you want to continue the installation without workstation support. See Section 5.3 for information on adding DECwindows device support files and 75- or 100-dpi font files after OpenVMS has been installed. ________________________ Note ________________________ 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. ______________________________________________________ 1-5 Preparing to Install the Software 1.5 Required ECO for POLYCENTER Software Installation Utility 1.5 Required ECO for POLYCENTER Software Installation Utility If you are installing the Compaq DECwindows Motif for OpenVMS software on an OpenVMS Version 6.2 or 7.1 system, you must first install an ECO to the POLYCENTER Software Installation (PCSI) utility. See the Guide to the Compaq DECwindows Motif for OpenVMS CD-ROM for details about this ECO. OpenVMS Versions 7.2 and higher include this functionality in the operating system; therefore, you need not apply this ECO if you are running OpenVMS Version 7.2 or higher. The following example shows a PCSI ECO installation on an OpenVMS Alpha Version 7.1 system (installations on other OpenVMS versions differ slightly): $ PRODUCT INSTALL VMS62TO71U2_PCSI The following product has been selected: DEC AXPVMS VMS62TO71U2_PCSI V1.0 Patch (maintenance update) 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 VMS62TO71U2_PCSI V1.0 * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: DEC AXPVMS VMS62TO71U2_PCSI V1.0 DISK$1:[VMS$COMMON.] Portion done: 0% ...10% ...40% ...70% ...80% ...90% ...100% The following product has been installed: DEC AXPVMS VMS62TO71U2_PCSI V1.0 Patch (maintenance update) 1-6 Preparing to Install the Software 1.5 Required ECO for POLYCENTER Software Installation Utility 1.5.1 Upgrade Problem After Installing Required PCSI ECO After installing the required POLYCENTER Software Installation utility ECO, your system will use the new features provided by this version of the PCSI utility. If a layered product is installed that makes use of this new functionality, then it may not be possible to revert back to an older version of the utility. The restriction occurs because there may be records in the software product database that the older version of the utility will not be able to interpret. This scenario occurs if you install the PCSI ECO, then install DECwindows Motif, and later install certain upgrades to the OpenVMS operating system. The steps below describe the situations when this will occur: 1. Install the PCSI ECO kit onto OpenVMS Version 6.2, 6.2- 1H1, 6.2-1H2, 6.2-1H3, 7.1, 7.1-1H1, or 7.1-1H2. 2. Install DECwindows Motif Version 1.2-6. 3. Upgrade to (or reinstall) OpenVMS Version 6.2, 6.2-1H1, 6.2-1H2, 6.2-1H3, 7.1, 7.1-1H1, or 7.1-1H2. Upgrading to any of the OpenVMS versions listed in item 3 may fail (or other PRODUCT command operations on the product database may fail) with one of the following errors: %SYSTEM-F-ACCVIO, access violation, ... %PCSI-E-UNSDOCENC, unsupported product document encoding version To prevent these failures after installing the PCSI ECO and DECwindows Motif, perform the following steps: 1. Remove DECwindows Motif using the following command: $ PRODUCT REMOVE DWMOTIF 2. Upgrade to (or reinstall) OpenVMS Version 6.2, 6.2-1H1, 6.2-1H2, 6.2-1H3, 7.1, 7.1-1H1, or 7.1-1H2. 3. Reinstall the PCSI ECO. 4. Reinstall DECwindows Motif. 1-7 Preparing to Install the Software 1.5 Required ECO for POLYCENTER Software Installation Utility This workaround is not needed if you upgrading to OpenVMS Alpha Version 7.2-1 or higher, or if you are upgrading to OpenVMS VAX Version 7.2 or higher. These versions (and all later versions) already include the new functionality added by the PCSI ECO. 1.6 OSF/Motif Release 1.1.3 and XUI Programming Support The X Window and OSF/Motif libraries that are provided with Compaq DECwindows Motif for OpenVMS software are incompatible with those libraries provided with versions of DECwindows Motif for OpenVMS 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 was provided in previous versions of DECwindows Motif is no longer supported in the Compaq DECwindows Motif for OpenVMS 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-1 and moves the previous files into the new [.DECW$113] subdirectory. Table 1-1 Directories for Previous XUI or OSF/Motif Programming __________Environments___________________________________________ Directory_____Contents____New_Location___________________________ DECW$INCLUDE C header SYS$SYSROOT:[DECW$INCLUDE.DECW$113] files SYS$SYSTEM UIL SYS$SYSROOT:[SYSEXE.DECW$113] compiler (continued on next page) 1-8 Preparing to Install the Software 1.6 OSF/Motif Release 1.1.3 and XUI Programming Support Table 1-1 (Cont.) Directories for Previous XUI or OSF/Motif __________________Programming_Environments_______________________ Directory_____Contents____New_Location___________________________ SYS$LIBRARY Non-C SYS$SYSROOT:[SYSLIB.DECW$113] language ______________bindings___________________________________________ Refer to Section 3.2.7 for additional information about saving previous programming environments. ________________________ Note ________________________ The process for using the saved programming environment is documented in the programmer chapter of the release notes. ______________________________________________________ 1.7 Saving Customized Bookreader Files 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 Compaq DECwindows Motif for OpenVMS 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: 1. Create the directory and assign world read access as follows: $ CREATE/DIRECTORY/PROTECTION=WORLD:R - _$ SYS$COMMON:[DECW$BOOK_LOCAL] 1-9 Preparing to Install the Software 1.7 Saving Customized Bookreader Files 2. Copy the LIBRARY.DECW$BOOKSHELF file to the new directory as follows: $ COPY SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF - _$ SYS$COMMON:[DECW$BOOK_LOCAL]*/LOG 3. If the SYS$MANAGER directory does not contain the DECW$PRIVATE_APPS_SETUP.COM command file, copy the template file to a command file as follows: $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE - _$ SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM/LOG 4. Edit the DECW$PRIVATE_APPS_SETUP.COM file and define the global symbol DECW$BOOK to point to your Bookreader directory by adding the following line to the file: $ DECW$BOOK == "SYS$COMMON:[DECW$BOOK_LOCAL]" 5. Restart DECwindows Motif using the following command if you performed step 4 after installing the product and after DECwindows had been started (for example, after a reboot): $ @SYS$MANAGER:DECW$STARTUP RESTART For more information about customizing your DECwindows Motif environment, see Managing DECwindows Motif for OpenVMS Systems. 1.8 Installation Procedure Requirements This section discusses the requirements for installing the Compaq DECwindows Motif for OpenVMS software using PCSI and the VMSINSTAL installation procedure. The installation procedure checks the following: o Whether you are logged in to an appropriately privileged account (VMSINSTAL installations only) o Whether any other users are logged in to the system o Whether you have the minimum required system account quotas and limits o Whether you have the minimum required disk space o Whether you have the minimum required system parameter values 1-10 Preparing to Install the Software 1.8 Installation Procedure Requirements See Section 3.1 for information on requirements specific to VMSINSTAL installations. 1.8.1 Process Account Quotas The installation procedure requires that the installation account has the minimum quotas shown in Table 1-2. Table_1-2_Process_Quotas_for_the_Installation_Account______ Quota_Name__Alpha_Value___VAX_Value________________________ ASTLM 250 24 BIOLM 150 18 BYTLM 64,000 32,768 DIOLM 150 18 ENQLM 2,000 30 FILLM__________100____________20___________________________ 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 = 32768 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-11 Preparing to Install the Software 1.8 Installation Procedure Requirements 1.8.2 Disk Space Use Table 1-3 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: o Install fewer optional files. o For VMSINSTAL installations, restart the installation and specify another disk to use as an alternate working device. See Section 3.1.2 for information about using an alternate working device. o Terminate the installation, create more free disk space on the system disk, and restart the installation. o Continue the installation and risk running out of disk space. ________________________ Note ________________________ If you run out of free disk space during the installation, the installation procedure fails. ______________________________________________________ 1-12 Preparing to Install the Software 1.8 Installation Procedure Requirements Table 1-3 Approximate Required Disk Space by Component (in __________Blocks)__________________________________________ Component_____________Alpha_________VAX____________________ Base kit[1] 65,818 81,891 Runtime support Not 66,021 applicable CDA support Not 3,650 applicable Motif Not 12,220 applications applicable Desktop support 71,066[2] Not applicable New Desktop 47,314 Not applicable DECwindows 20,952 Not applicable desktop Manual pages 2,800 Not applicable for New Desktop Programming 63,192[3] 13,500[2] environment C, C++ 19,916 8,190 FORTRAN 14,792 2,187 Pascal 15,656 3,123 New Desktop 12,828 Not applicable Example programs 51,652[4] 12,672 Sound examples 14,220 Not Applicable [1]This_number_includes_all_base_kit_files._For_Alpha______ systems, the indicated subcomponents are always included in the base kit. [2]This number includes all desktop support. The number of blocks required for the individual desktop options is shown in the subtable. [3]This number includes all programming language support. The actual number of blocks required for the individual programming languages is shown in the subtable. [4]This number includes all examples programs. The actual number of blocks required for the individual example programs is shown in the subtable. (continued on next page) 1-13 Preparing to Install the Software 1.8 Installation Procedure Requirements Table 1-3 (Cont.) Approximate Required Disk Space by __________________Component_(in_Blocks)____________________ Component_____________Alpha_________VAX____________________ Programming 23,440 12,672 examples New Desktop 13,992 Not Applicable examples Translated image 39,632 Not applicable support NCSA Mosaic Not 1,200[5] applicable Total disk space 291,360 109,263 required: [5]NCSA_Mosaic_available_only_on_VMS_5.5-2_systems.________ ___________________________________________________________ For VMSINSTAL installations, refer to Section 3.1.2 for information on using an alternate working device and Section 3.1.3 for information on using the Distributed File Service. 1.8.3 System Parameters Table 1-4 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings. 1-14 Preparing to Install the Software 1.8 Installation Procedure Requirements Table_1-4_Minimum_Required_System_Parameter_Values_________ System Parameter________Alpha_Value___VAX_Value___________________ GBLSECTIONS 600[1] 420[1] GBLPAGES 150,000[1] 62,000[1] GBLPAGFIL 1,024 6,024 SWPOUTPGCNT 512 500 MAXBUF 8,192 2,048 VIRTUALPAGECNT - 50,000 CHANNELCNT 255 255 PROCSECTCNT 64 40 PQL_DPGFLQUOTA - 32,768 PQL_MPGFLQUOTA 32,768 - PQL_MASTLM 100 100 PQL_MBIOLM 100 100 PQL_MBYTLM 100,000 48,000 PQL_MDIOLM 100 100 PQL_MENQLM 300 200 PQL_MFILLM 100 100 PQL_MPRCLM 10 8 PQL_MWSDEFAULT 1,024 512 PQL_MWSQUOTA 2,048 1,024 PQL_MWSEXTENT 8,192 2,048 CLISYMTBL 512 256 [1]If_you_have_installed_other_software_that_uses_global___ pages or global sections, you might need a higher minimum value. When you boot your system and DECwindows Motif starts, the values of free GBLPAGES and GBLSECTIONS are checked for your system. If you do not have sufficient values for GBLPAGES and GBLSECTIONS, the DECwindows Motif startup procedure prints a warning and provides a recommended value for these parameters. (continued on next page) 1-15 Preparing to Install the Software 1.8 Installation Procedure Requirements Table_1-4_(Cont.)_Minimum_Required_System_Parameter_Values_ System Parameter________Alpha_Value___VAX_Value___________________ GH_RES_CODE 1,024[2] - IMGREG_PAGES 2,000[2] - WINDOW_SYSTEM 1 1 NPAGEDYN 1,998,848 999,936 PAGEDYN 600,000 400,000 WSMAX 12,000 4,096 [2]This_system_parameter_is_available_only_on_OpenVMS_Alpha Version 6.2 (or higher) systems. ___________________________________________________________ _______________________ Caution _______________________ If you do not ensure that your system has the necessary number of global pages and global sections for the installation, the DCL tables can become corrupted. ______________________________________________________ 1.8.4 Additional System Maintenance Procedures This section explains how to use the System Generation utility (SYSGEN) and the AUTOGEN utility to prepare your system for the Compaq DECwindows Motif for OpenVMS installation. The AUTOGEN utility uses system configuration data to automatically set system parameters. ________________________ Note ________________________ The DECwindows Motif installation and startup procedures automatically check for required system parameter values and pass the appropriate values to AUTOGEN. Therefore, in most cases you do not have to check and modify these values manually. ______________________________________________________ 1-16 Preparing to Install the Software 1.8 Installation Procedure Requirements 1.8.4.1 Checking System Parameter Values To check the values of your system parameters, invoke the SYSGEN utility by entering the following command at the DCL prompt: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> At the SYSGEN prompt, enter the SHOW command to display the value of a system parameter. The following command displays the value for the MAXBUF system parameter: SYSGEN> SHOW MAXBUF After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN prompt to return to DCL level. If the current values are less than the values in Table 1-4, increase the system parameter settings. Section 1.8.4.4 describes the procedures for using the AUTOGEN utility to increase these values. 1.8.4.2 Calculating the Number of Free Global Pages and Global Sections If your system parameter values are equal to or greater than the minimum values specified in Table 1-4, you can continue with the product installation. However, to install and run Compaq DECwindows Motif for OpenVMS software, you must have sufficient free global pages and global sections for the DECwindows Motif software and the file SYS$LIBRARY:DCLTABLES.EXE. First, determine how many free global pages and global sections exist on your system and how many are required to reinstall a new version of SYS$LIBRARY:DCLTABLES.EXE. Then, if necessary, use the AUTOGEN utility to increase the values of the GBLPAGES and GBLSECTIONS system parameters. Enter the following DCL command to determine the number of global pages required for SYS$LIBRARY:DCLTABLES.EXE: $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE This command returns the size (in blocks) of the file SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pages needed for the file. 1-17 Preparing to Install the Software 1.8 Installation Procedure Requirements Enter the WRITE command with the F$GETSYI lexical function to find the number of contiguous free global pages and the number of free global sections. The following example shows how to obtain this information at your terminal, which is the default for SYS$OUTPUT: $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 See Table 1-5 to determine whether the number of contiguous free global pages and the number of free global sections is sufficient. If these values are not sufficient to continue with the installation, then see Section 1.8.4.4, which describes the procedures for increasing these values using the AUTOGEN utility. Table 1-5 Required Number of Contiguous Free Global Pages __________and_Free_Global_Sections_________________________ _____________Currently_Running_DECwindows_Motif____________ System_Resource__Alpha_Value___VAX_Value___________________ CONTIG_GBLPAGES 12,000 6,000 FREE_GBLSECTS 20 20 ___________________________________________________________ ___________Not_Currently_Running_DECwindows_Motif__________ System_Resource__Alpha_Value___VAX_Value___________________ CONTIG_GBLPAGES 92,000 47,000 FREE_GBLSECTS______260___________130_______________________ 1.8.4.3 Setting the Size of the Page File In order for DECwindows Motif to run with acceptable performance, the page file must be large enough to handle the virtual memory requirements of your system. The optimal size of the page file depends on many factors, such as the amount of physical memory on the system and the application work load. 1-18 Preparing to Install the Software 1.8 Installation Procedure Requirements As a general rule, the page file size should be at least 75,000 blocks on OpenVMS Alpha systems and 50,000 blocks on OpenVMS VAX systems. However, these sizes may be too small on systems where a large number of applications are run. On a heavily loaded system it may be possible to achieve large performance improvements by increasing the size of the page file by a factor of two or more. Normally you should run AUTOGEN with feedback and let AUTOGEN calculate the size of the page file based on the usage pattern on your system. To run AUTOGEN with feedback, enter the following DCL command: $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT FEEDBACK You can also increase the size of the page file by running the SYSGEN utility or by invoking the command procedure SYS$UPDATE:SWAPFILES.COM. For more information about setting the size of the page file and running AUTOGEN, see the Guide to Setting Up an OpenVMS System. For more information about performance tuning in general, see the Guide to OpenVMS Performance Management. 1.8.4.4 Changing System Parameter Values Using the AUTOGEN Utility Use the AUTOGEN utility to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the file SYS$SYSTEM:MODPARAMS.DAT. To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value. To add a new parameter, add a line to the file and include both the name of the parameter and its value. For example: MIN_MAXBUF = 8192 To make incremental adjustments to parameters, such as global pages and global sections, use ADD_. The following example increases the global pages value by 30,000: ADD_GBLPAGES = 30000 1-19 Preparing to Install the Software 1.8 Installation Procedure Requirements Table 1-6 lists the system parameters that you need to adjust incrementally. Table 1-6 Recommended System Parameter Values to Use with __________the_ADD__Option__________________________________ System Alpha Parameter________Increment_____VAX_Increment_______________ SYSMWCNT - 235 GBLSECTIONS 280 140 GBLPAGES 92,000 30,000 GBLPAGFIL 768 5,000 NPAGEDYN 300,000 500,000 PAGEDYN__________180,000_______100,000_____________________ After you enter all your changes, exit from the file and execute the AUTOGEN utility to recalculate your system parameters. Enter the following command to recalculate your system parameters and reboot the system: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT When you specify REBOOT, the AUTOGEN utility performs an automatic system shutdown and then reboots the system. Any users logged in to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect. For details about using AUTOGEN, see the section about the AUTOGEN utility in the OpenVMS System Manager's Manual and the AUTOGEN section in OpenVMS System Management Utilities Reference Manual. 1.8.5 Backing Up Your System Disk 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-20 Preparing to Install the Software 1.8 Installation Procedure Requirements 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 - _$ Compaq DECwindows Motif for OpenVMS, Version 1.2--6 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. 1-21 2 _________________________________________________________________ Using the POLYCENTER Software Installation Utility This chapter describes how to install and configure Compaq DECwindows Motif for OpenVMS software using the POLYCENTER Software Installation utility on Alpha and VAX systems. The Compaq DECwindows Motif for OpenVMS product supports POLYCENTER Software installations using the Digital Command Language (DCL) interface. This chapter presents information about the following topics: o Section 2.1, Accessing Help Information o Section 2.2, Extracting and Printing the Product Release Notes o Section 2.3, Installing the Software o 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: o Removing installed products o Reconfiguring installed products o Copying software kits to new locations o Retrieving product information o Discussing differences between the POLYCENTER Software Installation utility and the VMSINSTAL procedure 2-1 Using the POLYCENTER Software Installation Utility Refer to Section 1.4 for information about prerequisite software and licenses. ________________________ Note ________________________ You must use the VMSINSTAL Software Installation utility to install DECwindows Motif software on VMS Version 5.5-2 systems. ______________________________________________________ _______________________ Caution _______________________ If you do not have a satisfactory backup copy of your system disk, do not attempt to install Compaq DECwindows Motif for OpenVMS software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your Alpha or VAX processor) before you install Compaq DECwindows Motif for OpenVMS software. Before beginning the installation procedure, review Chapter 1 for information about installation preparations and requirements. ______________________________________________________ 2.1 Accessing Help Information 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: o OpenVMS System Manager's Manual o OpenVMS System Management Utilities Reference Manual o OpenVMS DCL Dictionary 2-2 Using the POLYCENTER Software Installation Utility 2.2 Extracting and Printing the Product Release Notes 2.2 Extracting and Printing the Product Release Notes Before you begin the installation procedure, you should read the product's release notes. To extract a copy of the Compaq DECwindows Motif 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. 2-3 Using the POLYCENTER Software Installation Utility 2.2 Extracting and Printing the Product Release Notes For example: $ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF126] $ 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 Compaq DECwindows Motif for OpenVMS Release Notes are also available in HTML and ASCII (.TXT) formats in the documentation directory on the Compaq DECwindows Motif for OpenVMS CD-ROM. Refer to the Guide to the Compaq DECwindows Motif for OpenVMS CD-ROM for information about accessing the release notes and other DECwindows Motif documentation. 2.3 Installing the Software ______________________ Important ______________________ If you are installing Compaq DECwindows Motif for OpenVMS software on an OpenVMS Version 7.1 or Version 6.2 system, you must install an ECO for the POLYCENTER Software Installation utility before installing the DECwindows Motif software. See the Guide to the Compaq DECwindows Motif for OpenVMS CD-ROM for details about this ECO. See Section 1.5 for more information. ______________________________________________________ The sections that follow take you through the stages of installing your Compaq DECwindows Motif 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: o Enter a value and press the Return key to select options. o Press the Return key to accept default values. 2-4 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software o 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. o Stop the installation by pressing Ctrl/Y. Note that this option is not recommended. 2.3.1 Starting the Installation To start the POLYCENTER Software Installation utility, enter one of the following commands at the DCL prompt: $ DEFINE PCSI$SOURCE device:[PCSI_ALPHA_DWMOTIF126] or $ DEFINE PCSI$SOURCE device:[PCSI_VAX_DWMOTIF126] 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-6 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. 2-5 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif Compaq DECwindows Motif for OpenVMS Alpha, Version 1.2-6 is based on Release 5 (R5) of the MIT X11 Window System and OSF/Motif Version 1.2.3. DECwindows Motif V1.2-6 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 2000 Compaq Computer Corporation COMPAQ and the Compaq logo Registered in U.S. Patent and Trademark Office. Motif is a registered trademark and The Open Group is a trademark of The Open Group in the United States and/or other countries. Confidential computer software. Valid license from Compaq or authorized sublicensor 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. Compaq Computer Corporation This software product is sold by Compaq Computer Corporation. This product uses the PAK: DW-MOTIF This software is furnished under the licensing provisions of Compaq Computer Corporation's Standard Terms and Conditions. For more in- formation about Compaq's licensing terms and policies, contact your local Compaq office. 2.3.2.1 Verifying Sufficient Allocation for the GBLPAGES and CLISYMTBL Values ________________________ Note ________________________ If you are simultaneously installing or upgrading the OpenVMS operating system with DECwindows from the CD- ROM, the installation procedure will continue without 2-6 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software checking your system values. It will check after the installation is complete (see Section 2.5). ______________________________________________________ The installation command procedure checks to ensure that adequate values are allocated for GBLPAGES, CLISYMTBL, and NPAGEDYN system parameters: o 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. o On OpenVMS Alpha systems, the minimum value for the CLISYMTBL system parameter is 512; on OpenVMS VAX systems, the minimum value is 256. o 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-6 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-6. @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK The DECwindows installation is being terminated. Please run AUTOGEN and restart the installation. 2-7 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software %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. 2-8 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 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 1.2-6. The XUI programming environment is also not included in DECwindows Motif Version 1.2-6. 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-9 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 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. 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 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 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 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] 2-10 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Make the New Desktop the default desktop [YES] Install traditional DECwindows Desktop 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. 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. On OpenVMS Alpha systems, the installation procedure uses the following dialog: Programming Support for the C Language Headers and related files to support programs in C that will use the DECwindows libraries. Programming Support for the C Language [YES] Programming Support for the Pascal Language Include files to support programs in Pascal that will use the DECwindows libraries. Programming Support for the Pascal Language [YES] Programming Support for the FORTRAN Language Include files to support programs in FORTRAN that will use the DECwindows libraries. Programming Support for the FORTRAN Language [YES] Programming Support for the New Desktop Headers and related files to support programs in C that will use the New Desktop widgets. Programming Support for the New Desktop [YES] Programming examples 2-11 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Examples of programming to use the various libraries. Programming examples [YES] Do you want all the defaults for the subitems? [YES] no Sound example files Sample sound files that can be used with DECsound. Sound example files [YES] Programming examples for DECwindows Examples, in various programming languages, of using the DECwindows and standard widgets and libraries. Programming examples for DECwindows [YES] Programming examples for the New Desktop Examples, in C, of using the new widgets provided with the New Desktop. Programming examples for the New Desktop [YES] On OpenVMS VAX systems, the installation procedure uses the following dialog: DECwindows Motif runtime support files [YES] Programming Support for the C Language Headers and related files to support programs in C that will use the DECwindows libraries. Programming Support for the C Language [YES] Programming Support for the Pascal Language Include files to support programs in Pascal that will use the DECwindows libraries. Programming Support for the Pascal Language [YES] Programming Support for the FORTRAN Language Include files to support programs in FORTRAN that will use the DECwindows libraries. Programming Support for the FORTRAN Language [YES] 2-12 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Programming examples [YES] 2.3.2.7 Translated Image Support The dialog now prompts you to install Translated Image Support (TIS), which enables VAX programs to work in the DECwindows Motif for OpenVMS Alpha environment. Note that TIS support is only available for the traditional DECwindows desktop environment. Translated Image Support Translated image support allows programs translated from the VAX enviroment 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.8 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-6 unless you will also install DECwindows Motif Version 1.2-6 language variants for all the languages that you wish 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.2-6 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-6 then you should remove the local language variant before installing DECwindows Motif Version 1.2-6. Do you want to continue? [YES] 2.3.2.9 Reviewing the Installation Options The dialog gives you a chance to review the options you have selected during the installation dialog. 2-13 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Do you want to review the options? [NO] y DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif 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.10 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. ________________________ Note ________________________ During the execution phase, a check is made for DECwindows Motif support files. If these files are not available, the dialog may ask if you want to continue. See Section 2.3.2.11 for more information. ______________________________________________________ Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF V1.2-6 DISK$2:[VMS$COMMON.] The following product will be removed from destination: DEC AXPVMS DWMOTIF V1.2-5 DISK$2:[VMS$COMMON.] 2-14 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Portion done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% 2.3.2.11 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: 2-15 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 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-16 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2.12 Reviewing Final Installation Notes If the installation is successful, the dialog displays a list of all products installed and removed. Finally, the procedure displays final installation notes for the DECwindows Motif product. ...100% The following product has been installed: DEC AXPVMS DWMOTIF V1.2-6 Layered Product The following product has been removed: DEC AXPVMS DWMOTIF V1.2-5 Layered Product DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif System reboot will be required following upgrade of language variants. A system reboot will be required to install the new DECwindow 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.2-6 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: o The operating system version is incorrect. o The prerequisite software version is incorrect. o Quotas necessary for successful installation are inadequate. o Process quotas required by the installation utility are inadequate. 2-17 Using the POLYCENTER Software Installation Utility 2.4 Recovering from Errors o 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.2-6 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. ________________________ Note ________________________ You will not see this message if this is a new installation of DECwindows. ______________________________________________________ When Compaq DECwindows Motif for OpenVMS attempts to start after successful installation, you will see a message 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. 2-18 3 _________________________________________________________________ Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) This chapter explains how to install Compaq DECwindows Motif for OpenVMS software using the VMSINSTAL procedure on VMS Version 5.5-2 systems. Included is a step-by-step description of the installation procedure, information about error recovery, and instructions for accessing the release notes. ________________________ Note ________________________ The VMSINSTAL installation procedure is only provided for VMS Version 5.5-2 systems and should not be used on OpenVMS Version 6.2 and OpenVMS Version 7.1 systems. Use the POLYCENTER Software Installation utility to install DECwindows Motif on these OpenVMS systems; see Chapter 2. ______________________________________________________ Using the VMSINSTAL procedure, the Compaq DECwindows Motif for OpenVMS installation takes approximately 45 minutes, depending on the processor type. The VMSINSTAL procedure installs the Compaq DECwindows Motif for OpenVMS product on your system disk. ________________________ Note ________________________ A Product Authorization Key (PAK) for Compaq DECwindows Motif for OpenVMS must be registered and loaded before starting the Compaq DECwindows Motif for OpenVMS installation. ______________________________________________________ 3-1 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) _______________________ Caution _______________________ If you do not have a satisfactory backup copy of your system disk, do not attempt to install Compaq DECwindows Motif for OpenVMS software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your VAX processor) before you install Compaq DECwindows Motif for OpenVMS software. Before beginning the installation procedure, review Chapter 1 for information about installation preparations and requirements. ______________________________________________________ This chapter presents information about the following topics: o Section 3.1, Installation Procedure Requirements o Section 3.2, Installation Procedure o Section 3.3, Recovering from Errors o Section 3.4, Accessing the Release Notes 3.1 Installation Procedure Requirements This section discusses the requirements for installing your Compaq DECwindows Motif for OpenVMS VAX software using the VMSINSTAL installation procedure. Refer to Section 1.8 for information on requirements common to both VMSINSTAL and PCSI installations. Prepare to install Compaq DECwindows Motif for OpenVMS software by logging in to a privileged account, such as the system manager (SYSTEM) account. See Section 3.1.1 for the prerequisite privileges. Although Compaq prefers that you perform the installation using the operator console or other hardcopy terminal, you can perform the installation from a DECterm window. 3-2 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.1 Installation Procedure Requirements 3.1.1 Process Privileges To install Compaq DECwindows Motif for OpenVMS software, you must be logged in to an account that has the SETPRV privilege or the following privileges: o CMKRNL o WORLD o SYSPRV The installation procedures turn off the BYPASS privilege at the start of the installation and turn it back on when the installation is completed. 3.1.2 Using an Alternate Working Device You can use the alternate working device (AWD) option to specify another disk to temporarily store the files while they are being unpacked from the save sets on the distribution media. Once the save sets are unpacked, the installation procedure adds or replaces the files that are necessary for the installation of Compaq DECwindows Motif for OpenVMS software from the AWD to the system disk. If this installation is to upgrade an existing DECwindows Motif environment, then the AWD option allows you to perform an installation with fewer free blocks on the system disk than are otherwise required. The installation procedure creates a temporary working directory either on the AWD device or by default in the following location: SYS$SYSROOT:[SYSUPD.facunvvv] If you use the AWD option, you can specify a directory. Specifying a directory is optional, but the following guidelines apply: o If you specify an existing directory, the installation procedure creates a working directory as a subdirectory within the directory that you specify (for example, [WORK.facunvvv]). The installation procedure deletes the working subdirectory after the installation is completed. 3-3 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.1 Installation Procedure Requirements o If you do not specify a directory, the installation procedure creates a working directory on the specified device with a directory specification of [000000.facunvvv]. The installation procedure deletes the working directory after the installation is completed. o If you specify a nonexistent directory, the installation procedure creates both the specified directory and a working directory as subdirectories within the directory that you specify. The installation procedure deletes only the working directory and not the originally specified directory after the installation is completed. You must delete the specified directory manually. Use the following format to invoke the VMSINSTAL procedure and specify the AWD option: $ @SYS$UPDATE:VMSINSTAL facunvvv dkcu OPTIONS N,AWD=ddcu:[dir] Use the following definitions for the variables in the command line: o For facunvvv, supply the product name and version number. For the Compaq DECwindows Motif for OpenVMS installation, the value of facunvvv is DWMOTIFVAXU6012. o For dkcu, give the device name of the source drive that holds the distribution media. o For ddcu, give the device name of the alternate working device. o For dir, specify the name of the directory on the alternate working device where the product subdirectory will be created. The default is [000000]. For example, to install the Compaq DECwindows Motif for OpenVMS product from the compact disc onto an OpenVMS VAX system using DKA2 as the alternate working device, enter the following command: $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 source-drive - _$ OPTIONS N,AWD=DKA2: 3-4 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.1 Installation Procedure Requirements 3.1.3 Using the Distributed File Service You can specify a temporary working directory on a disk that uses the Distributed File Service (DFS). If you use a DFS-mounted disk as your alternate working device, the installation procedure erroneously reports that there are -1 free blocks on the alternate working device. This error occurs because the DFS client (the installation procedure, in this case) cannot determine the amount of free disk space on the DFS-mounted disk. Before using a DFS-mounted disk, manually determine its free disk space. Log in to the system on which the disk is mounted, and enter the SHOW DEVICE command as follows: $ SHOW DEVICE 3.2 Installation Procedure The Compaq DECwindows Motif for OpenVMS installation procedure consists of a series of questions and informational messages. Enter a question mark (?) for help at any time during the installation. See Appendix B for a sample VMSINSTAL installation of DECwindows Motif on an OpenVMS VAX system. To stop the installation procedure, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files created up to that point and then exits. You can then restart the installation. ________________________ Note ________________________ This option is not recommended. ______________________________________________________ 3.2.1 Product and Device Names During the installation, you must tell the system what product is being installed and which drive contains the distribution media. Refer to a product with its facility name and version; refer to a drive with its device name. Use the following format to enter product and device names: o facunvvv 3-5 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.2 Installation Procedure Represents the facility name and version number of the product being installed, also known as the installation name. The following table explains the format of facunvvv. ________________________________________________________ Variable__Definition____________________________________ fac Product name code (1 to 36 alphanumeric characters) u Update character "u" (1 character) n Update version number (1 digit) vvv_______Major_version_number_(3_digits)_______________ For the Compaq DECwindows Motif for OpenVMS installation, use the installation name DWMOTIFVAXU6012. o ddcu Specifies the device name of the source drive that holds the distribution media. For additional information about device names on your system, see the upgrade and installation supplement for your VAX processor. 3.2.2 Invoking the VMSINSTAL Procedure To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. The VMSINSTAL.COM file is located in the SYS$UPDATE directory. When the system prompts you with a question during the installation procedure, the default answer is often listed in brackets ([]). Perform the following steps to run the VMSINSTAL procedure and install Compaq DECwindows Motif for OpenVMS software: 1. Locate the Compaq DECwindows Motif for OpenVMS distribution media. 2. If your system is not already running, start up the system and log in to a privileged account, such as the system manager (SYSTEM) account. 3-6 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.2 Installation Procedure 3. Place the distribution media in the source drive. If your Compaq DECwindows Motif for OpenVMS distribution kit contains more than one volume, place the first volume in the drive. During the installation procedure, you will be prompted to load the next volume. The paper labels on the media indicate the order in which you load them. 4. Start the VMSINSTAL procedure. On the command line, specify the product name (that is, the facility name): DWMOTIFVAXU6012 for OpenVMS VAX systems. Specify OPTIONS N to access the release notes, which are included in your media kit. The Compaq DECwindows Motif for OpenVMS Release Notes can be displayed or printed before the installation begins. Enter the following command at the DCL prompt: $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 ddcu: OPTIONS N For ddcu, specify the device name of the source drive that holds the distribution media. See Section 3.2.1 for more information about the format of product and device names. Also, see the OpenVMS upgrade and installation supplement for your VAX processor. For example, if you install Compaq DECwindows Motif for OpenVMS from a magnetic tape cartridge in drive MUA0:, enter the following command to invoke the VMSINSTAL command procedure: $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 MUA0: OPTIONS N If you install Compaq DECwindows Motif for OpenVMS using the alternate working device (AWD) option described in Section 3.1.2, invoke the VMSINSTAL command procedure as follows: $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 ddcu: OPTIONS N,AWD=ddcu:[dir] The first instance of ddcu is the device name of the source drive that holds the distribution media. The second instance of ddcu is the device name of the AWD, which is the target device. The variable dir is the name of the directory on the alternate working device in which the product subdirectory is created. The default directory is [000000]. 3-7 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.2 Installation Procedure For example, if you are installing Compaq DECwindows Motif for OpenVMS from a magnetic tape cartridge in drive MUA0: using alternate working device DUA2: and directory [INSTALL], enter the following command: $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 MUA0: OPTIONS N,AWD=DUA2:[INSTALL] If the command to execute the VMSINSTAL procedure fails, check to see if any of the following conditions occurred: o You entered the product name incorrectly. VMSINSTAL displays the following message: %VMSINSTAL-E-NOPRODS, None of the specified products were found o You specified an incorrect name for the source drive. VMSINSTAL displays an "invalid device" error message and prompts you until you enter the name of a source device that exists on the system. Remember to enter a colon (:) after the device name. The VMSINSTAL procedure displays messages similar to the following: VAX/VMS Software Product Installation Procedure V5.5-2 It is 26-MAR-2000 at 08:02 Enter a question mark (?) at any time for help. 3.2.3 Confirming System Backup The VMSINSTAL procedure asks the following question: * Are you satisfied with the backup of your system disk [Yes]? If you made a backup copy of your system disk, press the Return key and proceed to Section 3.2.4. If you did not make a backup copy of the system disk, do the following: 1. Enter No and press the Return key. The VMSINSTAL procedure exits and returns you to DCL level. 2. Back up the system disk as described in the OpenVMS upgrade and installation supplement for your VAX processor. 3-8 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.2 Installation Procedure 3. After you make a backup copy of the system disk, restart the installation procedure from step 4 in Section 3.2.2. 3.2.4 Mounting Distribution Media The VMSINSTAL procedure asks you where you will mount the distribution volumes: * Where will the distribution volumes be mounted: Enter the directory specification in the following format: device-name:[directory] Then the procedure tells you to enter the name of the product (facility name); enter DWMOTIFVAXU6012. Enter the names of the product to be processed from the first distribution volume set. * Product: DWMOTIFVAXU6012 When the installation begins, the VMSINSTAL procedure displays informational text similar to the following: The following products will be processed: DWMOTIFVAX V1.2-6 Beginning installation of DWMOTIFVAXU6 Version 1.2 at 10:36 %VMSINSTAL-I-RESTORE, Restoring product save set A... 3.2.5 Choosing a Release Notes Option If you specify OPTIONS N during step 4 in Section 3.2.2, the VMSINSTAL procedure prompts you to select a release notes option: Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: Enter the number of the option you want: o Option 1 displays the release notes on the terminal. 3-9 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.2 Installation Procedure o Option 2 prints the release notes (default). o Option 3 displays and prints the release notes. o Option 4 allows you to continue with the installation if you do not want to display or print the release notes. ________________________ Note ________________________ Compaq strongly recommends that you read the release notes before continuing the installation. ______________________________________________________ If you choose option 1, the release notes display on the terminal. You are prompted to press Return to continue reading the release notes. If you want to end the display and continue the installation, press Ctrl/C. After you press Ctrl/C, you are asked whether you want to continue with the installation; you are informed that the release notes have been moved to SYS$HELP. _______________________ Caution _______________________ Do not press Ctrl/Y; if you do, the installation ends. ______________________________________________________ If you choose option 2 or 3, you are prompted for the name of the print queue. If you do not specify a print queue, the release notes are queued to SYS$PRINT by default. 3.2.6 Continuing the Installation After the VMSINSTAL procedure processes your release notes option, the following message is displayed: * Do you want to continue the installation [No]? If you want to continue with the installation, enter Yes and press Return. If you want to end the installation, press the Return key. Regardless of the release notes option you select, the VMSINSTAL procedure copies the release notes to the SYS$HELP directory. See Section 3.4 for information about how to access the release notes once they are copied to the SYS$HELP directory. 3-10 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.2 Installation Procedure %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. *** Installing Compaq DECwindows Motif for OpenVMS VAX software *** Copyright 2000 Compaq Computer Corporation Confidential computer software. Valid license from Compaq or authorized sublicensor 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. 3.2.7 Preserving the OSF/Motif Release 1.1.3 Programming Environment If DECwindows Motif is already installed on your system, the OSF/Motif Release 1.1.3 programming environment is incompatible with Compaq DECwindows Motif for OpenVMS software. (Note that the OSF/Motif Release 1.2 programming environment is overwritten with the OSF/Motif Release 1.2.3 Toolkit when you install the Compaq DECwindows Motif for OpenVMS software.) The installation procedure asks whether you want to preserve 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-6. The XUI programming environment is also not included in DECwindows Motif Version 1.2-6. If you intend to continue developing programs for XUI or OSF/Motif Release 1.1.3 you should 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. * Do you want to save the OSF/Motif Release 1.1.3 and XUI * programming support files [No]? 3-11 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.2 Installation Procedure If you want to preserve the XUI and OSF/Motif Release 1.1.3 programming environment, enter Yes and press the Return key. The installation procedure creates subdirectories that contain the OSF/Motif Release 1.1.3 programming files so that they can be used for programming at a later time. See Section 1.6 for information about how to reference the previous version of the programming support files. 3.2.8 Installing the Entire Kit You can install the entire Compaq DECwindows Motif for OpenVMS software kit, or you can install part of the kit. The DECwindows Motif base kit is always installed; the Compaq DECwindows Motif for OpenVMS programming environment is optional. The procedure asks you whether you want to install the entire kit: You can install the DECwindows Motif kit completely or in selected portions. A complete installation requires as many as 82,500 blocks. If you choose to perform a partial installation, you can select (tailor) the programming support files that support your DECwindows Motif application development. Whether you perform a complete or partial installation, this kit provides support for running DECwindows Motif applications on OpenVMS compute servers. * Do you want to install the entire kit [Yes]? If you want to install the entire kit, press the Return key and verify your kit selections (see Section 3.2.10). If you choose not to install the entire kit, enter No and continue with questions about installing programming support (see Section 3.2.9). 3.2.9 Choosing Programming Support Files The installation procedure asks whether you want to install programming support: This installation procedure provides support files for developing DECwindows Motif applications in several programming languages. These files are needed only to develop applications and are not required to run DECwindows Motif applications. The free disk space requirement for each programming support file ranges from 3000 to 8000 blocks. * Do you want to install DECwindows Motif programming support [Yes]? 3-12 Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) 3.2 Installation Procedure Press the Return key to install programming support. The following message is displayed: