____________________________________________________ DECwindows Motif Version 1.2-4 for OpenVMS Installation Guide Order Number: AA-Q1EAC-TE April 1996 This manual describes the POLYCENTER Software Installation utility and the VMSINSTAL installation procedure for installing DECwindows Motif Version 1.2-4 for OpenVMS software. Revision/Update Information: This manual supersedes the DECwindows Motif Version 1.2-3 for OpenVMS Installation Guide. Operating System: OpenVMS Alpha Version 6.2 VMS Version 5.5-2 Software Version: DECwindows Motif Version 1.2-4 for OpenVMS Alpha DECwindows Motif Version 1.2-4 for OpenVMS VAX Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ April 1996 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. © Digital Equipment Corporation 1996. All rights reserved. The following are trademarks of Digital Equipment Corporation: Bookreader, CDA, DDIF, DEC, DECfonts, DECimage, DECmigrate, DECnet, DECpresent, DECterm, DECwindows, DECwrite, Digital, DTIF, LAT, OpenVMS, POLYCENTER, ULTRIX, VAX, VAX DOCUMENT, VMS, VT320, VT330, VT340, XUI, and the Digital logo. The following are third-party trademarks: Display POSTSCRIPT and POSTSCRIPT are registered trademarks of Adobe Systems Incorporated. Motif and OSF/Motif are registered trademarks of the Open Software Foundation, Inc. NCSA Mosaic and Mosaic are trademarks of the University of Illinois at Urbana-Champaign. This version is based on Enhanced NCSA Mosaic developed by Spyglass, Inc. POSIX is a registered trademark of the IEEE. UNIX is a registered trademark licensed exclusively by X/Open Company Limited. Windows is a trademark, and Windows NT, NT, and Microsoft are registered trademarks of Microsoft Corporation. X Window System is a trademark of the Massachusetts Institute of Technology. All other trademarks and registered trademarks are the property of their respective holders. ZK6434 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. _________________________________________________________________ Contents Preface................................................... vii 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-4 1.5 OSF/Motif Release 1.1.3 and XUI Programming Support....................................... 1-5 1.6 Saving Customized Bookreader Files............ 1-7 1.7 Installation Procedure Requirements........... 1-8 1.7.1 Process Account Quotas.................... 1-8 1.7.2 Disk Space................................ 1-9 1.7.3 System Parameters......................... 1-11 1.7.4 Additional System Maintenance Procedures................................ 1-13 1.7.4.1 Checking System Parameter Values........ 1-13 1.7.4.2 Calculating the Amount of Free Global Pages and Global Sections............... 1-14 1.7.4.3 Setting the Size of the Page File....... 1-15 1.7.4.4 Changing System Parameter Values Using the AUTOGEN Utility..................... 1-16 1.7.5 Selecting the Desktop..................... 1-17 1.7.6 Backing Up Your System Disk............... 1-18 1.7.7 Notifying Other Users..................... 1-18 iii 2 Using the POLYCENTER Software Installation Utility 2.1 Accessing Help Information.................... 2-2 2.2 Preparing to Install DECwindows Motif Version 1.2-4 for OpenVMS............................. 2-3 2.2.1 Extracting and Printing the Product Release Notes............................. 2-3 2.2.2 Notifying System Users.................... 2-3 2.3 Installing the Software....................... 2-4 2.3.1 Software Kit Names........................ 2-5 2.3.2 Starting the Installation................. 2-5 2.3.2.1 Displaying the Copyright Message........ 2-7 2.3.2.2 Determining System Information.......... 2-7 2.3.2.3 Verifying Sufficient Allocation for the GBLPAGES and CLISYMTBL Values........... 2-8 2.3.2.4 Verifying DECwindows Motif Support Files................................... 2-8 2.3.2.5 Displaying DECwindows Motif Language Variants................................ 2-10 2.3.2.6 Saving the Programming Environment...... 2-10 2.3.3 Installing the Product on an Alpha System.................................... 2-11 2.3.3.1 Asking About Selecting a Desktop........ 2-11 2.3.3.2 Asking About Rebooting the System....... 2-12 2.3.3.3 Locating the PCSI Kit................... 2-13 2.3.3.4 Executing the Installation Procedure on an Alpha System......................... 2-15 2.3.4 Installing the Product on a VAX System.... 2-16 2.3.4.1 Asking About Rebooting the System....... 2-16 2.3.4.2 Locating the PCSI Kit................... 2-17 2.3.4.3 Executing the Installation Procedure on a VAX System............................ 2-19 2.3.5 Locating the Installation Verification Procedure (IVP)........................... 2-20 2.3.6 Verifying the System Parameters........... 2-20 2.4 Recovering from Errors........................ 2-22 iv 3 Using the VMSINSTAL Procedure 3.1 Installation Procedure Requirements........... 3-2 3.1.1 Process Privileges........................ 3-2 3.1.2 Using an Alternate Working Device......... 3-3 3.1.3 Using the Distributed File Service........ 3-4 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-8 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 3.2.11 Verifying Disk Space...................... 3-14 3.2.12 Verifiying License Registration........... 3-15 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 VMScluster 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 Alternative Console............... 4-7 v 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 to Remove Files......................................... 5-7 5.3 Adding DECwindows Base-Support Files.......... 5-14 5.3.1 Reinstalling the OpenVMS Operating System.................................... 5-15 5.3.2 Using the SYS$UPDATE:DECW$TAILOR.EXE Command................................... 5-15 5.4 Determining and Reporting Problems............ 5-19 A POLYCENTER Software Installation Utility Sample Installations B VMSINSTAL Sample Installation B.1 Sample Product Authorization Key Registration.................................. B-1 B.2 Sample Installation Using VMSINSTAL on an OpenVMS VAX System............................ B-5 C Software Components Index Examples 4-1 Sample IVP................................ 4-6 5-1 Sample DECW$MOTIF_TAILOR Session.......... 5-11 5-2 Sample DECW$TAILOR Session................ 5-18 A-1 Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS Alpha System...................... A-1 A-2 Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS VAX System........................ A-7 B-1 Sample Product Authorization Key Registration.............................. B-1 B-2 Sample Installation Using VMSINSTAL....... B-5 vi Tables 1-1 Directories for Previous XUI or OSF/Motif Programming Environments.................. 1-6 1-2 Process Quotas for the Installing Account................................... 1-8 1-3 Required Disk Space by Component (in Blocks)................................... 1-9 1-4 Minimum Required System Parameter Values.................................... 1-11 1-5 Required Number of Free Global Pages and Global Sections........................... 1-15 1-6 Recommended System Parameter Values to Use with the ADD_ Option...................... 1-16 5-1 DECwindows Keymap......................... 5-4 5-2 Classes of OpenVMS Files That Can Be Removed with the DECW$MOTIF_TAILOR Utility................................... 5-8 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 DECwindows Motif Version 1.2-4 for OpenVMS software. Document Structure This manual contains the following chapters and appendixes: o Chapter 1 discusses how to prepare for installing DECwindows Motif Version 1.2-4 for OpenVMS software. o Chapter 2 presents the procedure for installing DECwindows Motif Version 1.2-4 for OpenVMS software using the POLYCENTER Software Installation utility. You can optionally use this utility to install DECwindows Motif software on OpenVMS Version 6.1 systems. Note that you must install DECwindows Motif software on OpenVMS Version 6.2 (or higher) systems using the POLYCENTER Software Installation utility. o Chapter 3 discusses how to install DECwindows Motif Version 1.2-4 for OpenVMS software on VAX systems 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 OpenVMS Alpha and OpenVMS VAX systems. vii o Appendix B shows a sample Product Authorization Key (PAK) registration and a sample product installation using the VMSINSTAL procedure on an OpenVMS VAX system. o Appendix C shows how to obtain a list of the software components for the DECwindows Motif Version 1.2-4 for OpenVMS product using the POLYCENTER Software Installation utility. Associated Documents In addition to this manual, the following documents are useful when installing DECwindows Motif Version 1.2-4 for OpenVMS software: o DECwindows Motif Version 1.2-4 for OpenVMS Release Notes o DECwindows Motif Version 1.2-4 for OpenVMS Software Product Description (SPD) 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 OpenVMS products and services, access the Digital OpenVMS World Wide Web site. Use the following URL: http://www.openvms.digital.com Reader's Comments Digital welcomes your comments on this manual. Print or edit the online form SYS$HELP:OPENVMSDOC_ COMMENTS.TXT and send us your comments by: Internet openvmsdoc@zko.mts.dec.com Fax 603 881-0120, Attention: OpenVMS Documentation, ZK03-4/U08 viii Mail OpenVMS Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 How To Order Additional Documentation Use the following table to order additional documentation or information. If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825). Conventions DECwindows Motif Version 1.2-4 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. In this manual, every use of OpenVMS Alpha means the OpenVMS Alpha operating system, every use of OpenVMS VAX means the OpenVMS VAX operating system, and every use of OpenVMS means both the OpenVMS Alpha operating system and the OpenVMS VAX operating system. In this manual, every use of DECwindows and DECwindows Motif refers to DECwindows Motif for OpenVMS software. The following conventions are used to identify information specific to OpenVMS Alpha or to OpenVMS VAX: 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.) ix . . . 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, if you choose more than one option, you must enclose the choices in parentheses. [ ] 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, braces surround a required choice of options; you must choose one of the options listed. boldface text Boldface text represents the introduction of a new term or the name of an argument, an attribute, or a reason (user action that triggers a callback). Boldface text is also used to show user input in Bookreader versions of the manual. x italic text Italic text emphasizes important information and indicates complete titles of manuals and variables. Variables include information that varies in system messages (Internal error number), in command lines (/PRODUCER=name), and in command parameters in text (where device- name contains up to five alphanumeric characters). UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege. - 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. xi 1 _________________________________________________________________ Preparing to Install the Software This chapter describes the preparation and requirements for installing DECwindows Motif Version 1.2-4 for OpenVMS software using either the POLYCENTER Software Installation utility or the VMSINSTAL procedure. Your Bill of Materials (BOM) and Indented Bills Report (BIL) specify 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 Digital representative. ________________________ Note ________________________ Digital strongly recommends that you read the release notes before proceeding with the installation. The DECwindows Motif Version 1.2-4 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.1. 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 1-1 Preparing to Install the Software o Section 1.5, OSF/Motif Release 1.1.3 and XUI Programming Support o Section 1.6, Saving Customized Bookreader Files o Section 3.2.1, Product and Device Names o Section 1.7, Installation Procedure Requirements 1.1 License Registration Before you install and run DECwindows Motif Version 1.2-4 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 DECwindows Motif Version 1.2-4 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 DECwindows Motif Version 1.2-4 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 DECwindows Motif Version 1.2-4 for OpenVMS software on more than one node in a VMScluster, load the license on the other nodes after you complete this installation. 1-2 Preparing to Install the Software 1.1 License Registration For complete information about using LMF, see the OpenVMS License Management Utility Manual. See Appendix B for a sample installation of a PAK. 1.2 Supported Hardware DECwindows Motif Version 1.2-4 for OpenVMS software can be installed on any supported Alpha or VAX processor. For a complete list of supported hardware, see the DECwindows Motif Version 1.2-4 for OpenVMS Software Product Description (SPD). 1.3 Prerequisites for the Installation Procedures Before you can install and configure DECwindows Motif Version 1.2-4 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) OpenVMS VAX Version 6.1 POLYCENTER Software Installation utility or the VMSINSTAL procedure VMS Version 5.5-2 through VMSINSTAL procedure OpenVMS_VAX_Version_6.0____________________________________ 1-3 Preparing to Install the Software 1.4 Required Operating System Software 1.4 Required Operating System Software The DECwindows Motif Version 1.2-4 for OpenVMS software requires OpenVMS Alpha Version 6.2 (or higher) and VAX VMS Version 5.5-2 (or higher) operating systems. If your system is not running one of these versions before you attempt to install DECwindows Motif Version 1.2-4 for OpenVMS, the installation fails. A minimum of 12 MB of memory is required for OpenVMS VAX systems; 16 MB of memory is highly recommended. A minimum of 32 MB of memory is required for OpenVMS Alpha systems; additional memory is highly recommended. The OpenVMS operating system provides two subsets of components to support DECwindows Motif Version 1.2-4 for OpenVMS. To use DECwindows Motif Version 1.2-4 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 DECwindows Motif Version 1.2-4 for OpenVMS and to run DECwindows Motif Version 1.2-4 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 Use the DECwindows tailoring utility (DECW$TAILOR) to tailor on the DECwindows base support files using the DECwindows save sets that are provided with the OpenVMS kit as follows: $ RUN SYS$UPDATE:DECW$TAILOR.EXE See Section 5.3.2 for more details about this process. o DECwindows X11 display server for OpenVMS, fonts, and device drivers, which are necessary to display DECwindows Motif Version 1.2-4 for OpenVMS applications or any other X11 applications on your Alpha or VAX system 1-4 Preparing to Install the Software 1.4 Required Operating System Software 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 DECwindows Motif Version 1.2-4 for OpenVMS applications on your Alpha or VAX system. However, you can run DECwindows Motif Version 1.2-4 for OpenVMS applications that display on a DECwindows X11 display server that runs on another system. The DECwindows Motif Version 1.2-4 for OpenVMS installation procedure asks whether you want to continue the installation without workstation support. Use the DECwindows tailoring utility (DECW$TAILOR) to tailor on the device-support files and the 75 or 100 dots-per-inch (dpi) font files using the DECwindows Motif save sets provided with the OpenVMS kit as follows: $ RUN SYS$UPDATE:DECW$TAILOR.EXE See Section 5.3.2 for a more detailed description of this process. ________________________ 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 OSF/Motif Release 1.1.3 and XUI Programming Support The X Window and OSF/Motif libraries that are provided with DECwindows Motif Version 1.2-4 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 OSF/Motif Release 1.1.3 and XUI programming environments are not compatible. 1-5 Preparing to Install the Software 1.5 OSF/Motif Release 1.1.3 and XUI Programming Support 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 DECwindows Motif Version 1.2-4 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 SYS$LIBRARY Non-C SYS$SYSROOT:[SYSLIB.DECW$113] language ______________bindings___________________________________________ Refer to Section 2.3.2.6 and 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-6 Preparing to Install the Software 1.6 Saving Customized Bookreader Files 1.6 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 DECwindows Motif Version 1.2-4 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] 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 1-7 Preparing to Install the Software 1.6 Saving Customized Bookreader Files For more information about customizing your DECwindows Motif environment, see Managing DECwindows Motif for OpenVMS Systems. 1.7 Installation Procedure Requirements This section discusses the requirements for installing your DECwindows Motif Version 1.2-4 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 See Section 3.1 for information on requirements specific to VMSINSTAL installations. 1.7.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_Installing_Account________ Value (OpenVMS Quota_Name__VAX)_____________Value_(OpenVMS_Alpha)_________ ASTLM 24 250 BIOLM 18 150 BYTLM 32,768 64,000 DIOLM 18 150 ENQLM 30 2,000 FILLM_______20_______________100___________________________ Use the OpenVMS AUTHORIZE utility to verify and to change process quotas for the installation account in the user 1-8 Preparing to Install the Software 1.7 Installation Procedure Requirements 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 = 18000 UAF> SHOW account-name UAF> EXIT $ LOGOUT After you change the quotas for the installation account, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation. User account quotas are stored in the file SYS$SYSTEM:SYSUAF.DAT. For more information about modifying account quotas, see the description of the AUTHORIZE utility in the OpenVMS System Management Utilities Reference Manual. 1.7.2 Disk Space Use Table 1-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 Table_1-3_Required_Disk_Space_by_Component_(in_Blocks)_____ Component__________________Alpha____VAX____________________ Base kit 50,000 48,500 (continued on next page) 1-9 Preparing to Install the Software 1.7 Installation Procedure Requirements Table 1-3 (Cont.) Required Disk Space by Component (in __________________Blocks)__________________________________ Component__________________Alpha____VAX____________________ Desktop support 49,500[1]Not applicable New Desktop 42,000 Not applicable DECwindows desktop 8,000 Not applicable Programming environment 12,800[2]12,100[2] C, C++ 7,200 6,700 Fortran 2,400 2,400 Pascal 3,000 3,000 New Desktop 150 Not applicable Example programs 13,000 10,700 Translated image support 34,000 Not applicable Total disk space 177,500 73,000 required: [1]This_number_includes_all_desktop_support._The_actual____ number of blocks required may be fewer depending on the desktop support you select. [2]This number includes all programming language support. The actual number of blocks required may be fewer depending on the language support you select. ___________________________________________________________ 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 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. 1-10 Preparing to Install the Software 1.7 Installation Procedure Requirements 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. ______________________________________________________ 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 during VMSINSTAL installations. 1.7.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. Table_1-4_Minimum_Required_System_Parameter_Values_________ System Parameter________Alpha_Value______VAX_Value________________ GBLSECTIONS 600[1] 420[1] GBLPAGES 110,000[1] 62,000[1] GBLPAGFIL 1,024 6,024 SWPOUTPGCNT 512 500 MAXBUF 8,192 2,048 VIRTUALPAGECNT 73,536 50,000 [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-11 Preparing to Install the Software 1.7 Installation Procedure Requirements Table_1-4_(Cont.)_Minimum_Required_System_Parameter_Values_ System Parameter________Alpha_Value______VAX_Value________________ 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 40,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 265 265 GH_RES_CODE 1,024[2] - IMGREG_PAGES 2,000[2] - WINDOW_SYSTEM 1 1 NPAGEDYN 1,300,000 1,000,000 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 amount of global pages and global sections for the installation, the DCL tables can become corrupted. ______________________________________________________ 1-12 Preparing to Install the Software 1.7 Installation Procedure Requirements 1.7.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 DECwindows Motif Version 1.2-4 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.7.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.7.4.4 describes the procedures for using the AUTOGEN utility to increase these values. If the current values are less than the values in Table 1-4, increase the system parameter settings. Section 1.7.4.4 describes the procedures for using the AUTOGEN utility to increase these values. 1-13 Preparing to Install the Software 1.7 Installation Procedure Requirements 1.7.4.2 Calculating the Amount 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 DECwindows Motif Version 1.2-4 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. Enter the WRITE command with the F$GETSYI lexical function to find the number of free global pages and 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 amount of free global pages and global sections is sufficient. If these values are not sufficient to continue with the installation, then see Section 1.7.4.4, which describes the procedures for increasing these values using the AUTOGEN utility. 1-14 Preparing to Install the Software 1.7 Installation Procedure Requirements Table 1-5 Required Number of Free Global Pages and Global __________Sections_________________________________________ ____________Currently_Running_DECwindows_Motif_____________ System Parameter________Alpha_Value______VAX_Value________________ GBLPAGES 12,000 6,000 GBLSECTIONS 20 20 ___________________________________________________________ __________Not_Currently_Running_DECwindows_Motif___________ System Parameter________Alpha_Value______VAX_Value________________ GBLPAGES 84,000 26,000 GBLSECTIONS______260______________130______________________ 1.7.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. 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. 1-15 Preparing to Install the Software 1.7 Installation Procedure Requirements 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.7.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 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 Parameter________Alpha_Increment__VAX_Increment____________ SYSMWCNT - 235 GBLSECTIONS 280 140 GBLPAGES 92,000 30,000 GBLPAGFIL 768 5,000 (continued on next page) 1-16 Preparing to Install the Software 1.7 Installation Procedure Requirements Table 1-6 (Cont.) Recommended System Parameter Values to __________________Use_with_the_ADD__Option_________________ System Parameter________Alpha_Increment__VAX_Increment____________ 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.7.5 Selecting the Desktop On OpenVMS Alpha systems, DECwindows Motif Version 1.2- 4 for OpenVMS provides a choice of two desktops: the New Desktop, which is derived from the Common Desktop Environment (CDE), and the traditional DECwindows desktop. During the installation, if you choose to install both the New Desktop and the DECwindows desktop, the New Desktop is started by default after the installation. If you choose to install only one desktop, the desktop you install is started. To start the DECwindows desktop instead of the New Desktop after the installation, perform the following steps. 1. If the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM does not exist, copy it from DECW$PRIVATE_APPS_SETUP.TEMPLATE (or create it if an earlier version of DECwindows Motif 1-17 Preparing to Install the Software 1.7 Installation Procedure Requirements for OpenVMS has not been installed on your system). For example: $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE - _$ SYS$COMMON:[SYSMGR]DECW$PRIVATE_APPS_SETUP.COM 2. Edit SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM and add the following global symbol definition: $ DECW$START_NEW_DESKTOP == "FALSE" 3. Install DECwindows, as explained in Chapter 2. ________________________ Note ________________________ In order to switch from one desktop to the other, you must define the DECW$START_NEW_DESKTOP symbol as detailed in the preceding steps and then reboot the system. To avoid having to reboot the system twice, you should edit or create the DECW$PRIVATE_ APPS_SETUP.COM file before installing the DECwindows Motif Version 1.2-4 for OpenVMS software.<> ______________________________________________________ 1.7.6 Backing Up Your System Disk Digital 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.7.7 Notifying Other Users To ensure 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: $ REPLY/ALL/BELL/SHUTDOWN "Log out for the installation of - _$ DECwindows Motif Version 1.2-4 for OpenVMS please..." 1-18 Preparing to Install the Software 1.7 Installation Procedure Requirements 2. Enter the following command to prevent nonprivileged users from logging in to the system: $ SET LOGINS/INTERACTIVE=0 1-19 2 _________________________________________________________________ Using the POLYCENTER Software Installation Utility This chapter describes how to install and configure DECwindows Motif Version 1.2-4 for OpenVMS software using the POLYCENTER Software Installation utility on Alpha and VAX systems. The DECwindows Motif Version 1.2-4 for OpenVMS product supports POLYCENTER Software installations using the Digital Command Language (DCL) interface. Specifically, this chapter presents information about the following topics: o Section 2.1, Accessing Help Information o Section 2.2, Preparing to Install DECwindows Motif Version 1.2-4 for OpenVMS 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 licences. ________________________ Note ________________________ You must use the POLYCENTER Software Installation utility to install your DECwindows Motif software on OpenVMS Alpha Version 6.2 (or higher) systems. Using the POLYCENTER Software Installation utility is optional for OpenVMS VAX Version 6.1. ______________________________________________________ _______________________ Caution _______________________ If you do not have a satisfactory backup copy of your system disk, do not attempt to install DECwindows Motif Version 1.2-4 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 DECwindows Motif Version 1.2-4 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 Preparing to Install DECwindows Motif Version 1.2-4 for OpenVMS 2.2 Preparing to Install DECwindows Motif Version 1.2-4 for OpenVMS Before you begin the installation procedure, perform the following tasks: o Extract the DECwindows Motif Version 1.2-4 for OpenVMS release notes. o Notify system users that you are about to install the product. 2.2.1 Extracting and Printing the Product Release Notes To extract a copy of the DECwindows Motif Version 1.2-4 for OpenVMS Release Notes, define PCSI$SOURCE to point to the location (device name and directory) of the PCSI kit. Then enter the PRODUCT EXTRACT RELEASE_NOTES command followed by the product name, DWMOTIF, at the DCL prompt. For example: $ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF124] $ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF Once you extract the release notes to a file, you can print the file. Note that you do not need to install the product before you extract the release notes. The DECwindows Motif Version 1.2-4 for OpenVMS Release Notes are also available in Bookreader and ASCII (.TXT) formats in the documentation directory on the DECwindows Motif Version 1.2-4 for OpenVMS CD-ROM. Refer to the Guide to the DECwindows Motif Version 1.2-4 for OpenVMS CD-ROM for information about accessing the release notes and other DECwindows Motif documentation. 2.2.2 Notifying System Users Inform users on the system that you plan to install a product and that they must log out during the installation. To make sure that you are the only user logged in to the system, follow these steps: 1. Notify current users to log out. Enter the following command at the DCL prompt: $ REPLY/ALL/BELL/SHUTDOWN "Log out for the installation of - _$ DECwindows Motif Version 1.2-4 for OpenVMS please..." 2-3 Using the POLYCENTER Software Installation Utility 2.2 Preparing to Install DECwindows Motif Version 1.2-4 for OpenVMS 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. 2.3 Installing the Software The sections that follow take you through the stages of installing your DECwindows Motif Version 1.2-4 for OpenVMS software using the POLYCENTER Software Installation utility. The first part of the installation procedure is nearly identical on Alpha and VAX systems; later, however, the installation dialog diverges depending on your system. o Section 2.3.3 discusses the installation steps and activities on an Alpha system. o Section 2.3.4 discusses the installation steps and activities on a VAX system. 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. 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 2-4 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 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 Software Kit Names The names of the DECwindows Motif Version 1.2-4 for OpenVMS kits are as follows: o OpenVMS Alpha kit: DEC-AXPVMS-DWMOTIF-V0102-4-1.PCSI o OpenVMS VAX kit: DEC-VAXVMS-DWMOTIF-V0102-4-1.PCSI When you install DECwindows Motif Version 1.2-4 for OpenVMS software, the installation procedure looks for the product kits in the PCSI$SOURCE directory. The appropriate kit is installed according to whether you are installing the software on an OpenVMS Alpha or VAX system. ________________________ Note ________________________ The PCSI_INSTALLATION.COM command procedure determines the system and version on which you are installing the DECwindows Motif software. See Section 2.3.2 for information about this command procedure. ______________________________________________________ 2.3.2 Starting the Installation Run the PCSI_INSTALLATION.COM command procedure, which is part of the POLYCENTER Software installation save set, at the DCL level to start the installation. Enter the following command at the DCL prompt: $ @ddcu:[dir]PCSI_INSTALLATION For ddcu:[dir], specify the device name and directory that contains the distribution media and the PCSI_ INSTALLATION.COM installation procedure. This command procedure includes the following phases of the installation: o Running preinstallation procedures o Installing the save sets 2-5 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software o Running postinstallation procedures The sections that follow discuss the steps and activities that take place once you execute the PCSI_INSTALLATION command procedure. As the installation progresses, the installation utility displays a percentage that indicates how much of the installation is completed. For example: Portion Done: 0% ...10% ...20% ...30% When the installation is successfully completed, an informational message is displayed by the installation procedure. The following information is displayed after DECwindows Motif Version 1.2-4 for OpenVMS Alpha is successfully installed: Portion Done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% ...100% The following product has been installed: DEC AXPVMS DWMOTIF V1.2-4 A similar message is displayed following successful installations on OpenVMS VAX systems. 2-6 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2.1 Displaying the Copyright Message The installation utility displays the following copyright message: DECwindows Motif V1.2-4 for OpenVMS installation procedure. Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. 2.3.2.2 Determining System Information The installation utility checks and stores information about the supported version of your OpenVMS Alpha or OpenVMS VAX system. For example: **** Supported OpenVMS Alpha Version 7.0 DETECTED **** Refer to Section 1.4 for information about system prerequisites. The information that is displayed if your version of the OpenVMS operating system does not meet the criteria depends on the OpenVMS system. On OpenVMS Alpha systems, the following warning is displayed: WARNING: This kit may be installed only on OpenVMS Alpha Version 6.2 systems or higher.<> On OpenVMS VAX systems: WARNING: This kit may be installed only on OpenVMS VAX Version 6.1 systems or higher.<> 2-7 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2.3 Verifying Sufficient Allocation for the GBLPAGES and CLISYMTBL Values The installation utility checks to ensure that adequate values are allocated for GBLPAGES and CLISYMTB system parameters: o On OpenVMS Alpha systems, the minimum value for the GBLPAGES system parameter is 110,000; on OpenVMS VAX systems, the minimum value is 62,000. o On all OpenVMS systems, the minimum value for the CLISYMTBL system parameter is 265. On OpenVMS Alpha systems, if your settings are not sufficient, the installation fails and a message similar to the following is displayed: %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 90000, should be at least 110000 %DECW-W-BADVALUE, Free GBLPAGES is 53648, should be at least 92000 %DECW-W-BADVALUE, SYSGEN parameter CHANNELCNT is 100, should be at least 255 The installation procedure determined that some system parameter values require modification to install the DECwindows Motif Version 1.2-4 for OpenVMS software. If you type YES, AUTOGEN will change these parameters and reboot your system. If you type NO, AUTOGEN will not run or cause a reboot, but the installation cannot continue. Do you want the system to run AUTOGEN for you? A similar message is displayed on OpenVMS VAX systems. 2.3.2.4 Verifying DECwindows Motif Support Files The installation procedure verifies that DECwindows Motif applications and run-time support files are installed on the operating system (for example, transport and font files, which are required for running DECwindows Motif software). **** DECwindows Motif application and run-time support files DETECTED **** If the files are not installed, the following message is displayed: 2-8 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 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. The installation procedure checks for the presence of support files that are needed to use the system as a workstation or as a workstation boot server. If the support files are installed, the following message is displayed: **** DECwindows device support files DETECTED **** If the files are not installed, users are warned with the following message that their systems cannot be a workstation or a workstation boot server: The DECwindows device support files for using this machine as a workstation or as a boot node for workstations have not been installed. You can use the 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 Then the installation procedure 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. Then you can run the DECW$MOTIF_ TAILOR utility and tailor on 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. Refer to Section 5.2 for information about using the DECW$MOTIF_TAILOR utility. 2-9 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2.5 Displaying DECwindows Motif Language Variants The installation procedure checks for the existence of installed language variant versions of DECwindows Motif (for example, Russian). If any language variants have been installed, the installation procedure displays the list of installed languages along with a warning message, as follows: The following DECwindows Motif language variants have been installed on this system: Japanese Russian You should not install DECwindows Motif Version 1.2-4 unless you will also install DECwindows Motif Version 1.2-4 language variants for all the languages that you wish to use. Do you wish to continue with this installation (Y/[N])? 2.3.2.6 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. The XUI programming environment is also no longer included in DECwindows Motif Version 1.2-4. 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. If the OSF/Motif Release 1.1.3 and the XUI programming environments currently exist on your system, the following question is displayed: Save the OSF/Motif Release 1.1.3 and XUI programming environment? 2-10 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software If you answer Yes and press the Return key to save the OSF/Motif Release 1.1.3 and XUI programming environments, a subdirectory called [.DECW$113] is created. The files that support that programming environment are moved to the [.DECW$113] subdirectory. If you answer No and press the Return key, the files are deleted. Refer to Section 1.5 for information about accessing files related to the OSF/Motif Release 1.1.3 programming environment. 2.3.3 Installing the Product on an Alpha System This section discusses the continuation of the installation on an Alpha system. The Alpha installation dialog differs from the VAX dialog because on an Alpha system, you can install the DECwindows Motif desktop or the New Desktop. The New Desktop is a graphical user interface that is derived from the Common Desktop Environment (CDE). If you are installing the product on a VAX system, see Section 2.3.4. 2.3.3.1 Asking About Selecting a Desktop 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. 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. 2-11 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Do you want the New Desktop to be your default desktop ([Y]/N)? See Section 1.7.5 for instructions about how to change the choice of desktop after the installation has completed. 2.3.3.2 Asking About Rebooting the System In this step of the installation, the installation utility tells you whether the DECwindows Motif Version 1.2-4 for OpenVMS product will not start because of incorrect system parameters. (See Section 1.7.3 for a list of the minimum required system parameter values.) If your system parameters are incorrect, the procedure asks whether you want to reboot the system using the AUTOGEN utility after installing the software. Or, if you prefer, a procedure can instruct you on how to reboot your system when a reboot is necessary. The installation utility displays the following message: The installation of DECwindows Motif Version 1.2-4 on systems with OpenVMS Alpha Version 6.2 (or higher) requires a system reboot after this installation if the DECwindows shareable images have previously been installed using the share=address_data qualifier. Images which have been installed using the share=address_data qualifier cannot be replaced by simply using the DCL install replace command. CAUTION: If you answer No and images were previously installed using the /SHARE=ADDRESS_DATA qualifier, your system may contain a mix of old and new shareable images after the installation. NOTE: It is possible to override the installation of DECwindows images by defining the DECW$IGNORE_SHARE_ADDRESS logical to True. If this logical is defined the images will be installed normally without using the /SHARE=ADDRESS_DATA qualifier. Disabling this qualifier will result in slower performance and increased memory usage by the DECwindows shareable images. The installation utility asks the following question: Will you allow a system reboot after this product is installed? If you answer Yes (default) and press the Return key, the system is rebooted after the installation, if necessary. 2-12 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software If you answer No and press the Return key, the installation continues. The installation utility tells you whether you need to modify your system parameters to start the DECwindows Motif Version 1.2-4 for OpenVMS product. The installation utility displays the following message: DECwindows Motif will not start if your system parameters are not set correctly. o If you allow a system shutdown, the installation procedure reboots the system at the end of the installation. If your system parameters are incorrect, the installation runs AUTOGEN prior to the system reboot. o If you do not allow a system shutdown, the installation procedure continues; you are informed at the end of the installation whether you need to modify your system parameters to start DECwindows Motif. 2.3.3.3 Locating the PCSI Kit As the installation continues, the POLYCENTER Software Installation utility installs the DECwindows Motif Version 1.2-4 for OpenVMS software. The utility displays messages and asks a series of questions. For example: To answer the following question, enter the directory specification of the DECwindows Motif for OpenVMS POLYCENTER Software Installation utility kit. Where is the PCSI kit located? If you do not enter the correct directory specification, the following message is displayed. The DECwindows Motif V1.2-4 for OpenVMS ALPHA PCSI kit not found Type Control C to exit installation procedure or reenter kit location. Then the following question is displayed again: Where is the PCSI kit located? If you enter the correct directory specification, the installation utility locates the software and proceeds with the installation. If you press Ctrl/C, the following message is displayed: Terminating installation of DECwindows Motif V1.2-4 for OpenVMS 2-13 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Once the installation utility locates the kit, the procedure asks whether you want to continue with the installation. Do you want to continue? [Yes] If you enter Yes (default) and press Return, the installation procedure displays the following information, which includes previously displayed copyright information. (Note that the NET-APP-SUP-250 and NET-APP-SUP-300 PAKs are also valid.) *** DEC AXPVMS DWMOTIF V1.2-4: DECwindows Motif Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Digital Equipment Corporation This product uses the PAK: DW-MOTIF Do you want all the default values for this product? [YES] No If you answer No (you do not accept the default values), you are questioned about accepting each individual item or subitem. DECwindows Motif runtime support files [YES] Desktop Support [YES] Do you want all the defaults for the subitems? [YES] No New Desktop [YES] Do you want all the defaults for the subitems? [YES] No Manual (reference) pages for the New Desktop [YES] DECwindows Desktop [NO] Programming Support [YES] Do you want all the defaults for the subitems? [YES] No 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] Do you want all the defaults for the subitems? [YES] No 2-14 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Sound example files [YES] Programming examples for the DECwindows [YES] Programming examples for the New Desktop [YES] Translated Image Support (OSF/Motif V1.1.3) [YES] Do you want to view the values? [NO] Yes If you answer Yes to view the default values, the following information is displayed, followed by a question asking whether you are satisfied with these default values (default is Yes): DEC AXPVMS DWMOTIF V1.2-4: DECwindows Motif [Available] DEC AXPVMS VMS V6.2 [Available] DECwindows Motif runtime support files: YES Desktop Support: YES New Desktop: YES Manual (reference) pages for the New Desktop: YES DECwindows Desktop: NO Programming Support: 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 the DECwindows: YES Programming examples for the New Desktop: YES Translated Image Support (OSF/Motif V1.1.3): YES Are you satisfied with the values? [YES] If you are not satisfied with the values, type No and press Return; you can now change your responses to these questions. 2.3.3.4 Executing the Installation Procedure on an Alpha System Once you select the programming and translated-image support options, the installation utility begins the software installation. A message is displayed that shows you when the product installation begins and when it is completed, as in the following example. 2-15 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software %PCSIUI-I-DONEASK, execution phase starting The following product will be installed: DEC AXPVMS DWMOTIF V1.2-4 %PCSI-I-VOLINFO, estimated space information for volume DISK$ALPHA -PCSI-I-VOLSPC, 13009 required; 641884 available; 628875 net Portion Done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% ...100% The following product has been installed: DEC AXPVMS DWMOTIF V1.2-4 If you wish to use any language other than English, install the appropriate DECwindows Motif Version 1.2-4 language variant product after this installation has completed. For information about locating the Installation Verification Procedure (IVP), see Section 2.3.5.<> 2.3.4 Installing the Product on a VAX System This section discusses the continuation of the installation on a VAX system. The VAX installation dialog differs from the Alpha dialog because the New Desktop is not available on VAX systems. If you are installing the product on an Alpha system, see Section 2.3.3. 2.3.4.1 Asking About Rebooting the System In this step of the installation, the installation utility tells you whether the DECwindows Motif Version 1.2-4 for OpenVMS product will not start because of incorrect system parameters. (See Section 1.7.3 for a list of the minimum required system parameter values.) 2-16 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software If your system parameters are incorrect, the procedure asks whether you want to reboot the system using the AUTOGEN utility after installing the software. Or, if you prefer, a procedure can instruct you on how to reboot your system when a reboot is necessary. The installation utility asks the following question: Will you allow a system reboot after this product is installed? If you answer Yes (default) and press the Return key, the system is rebooted after the installation, if necessary. If you answer No and press the Return key, the installation continues. The installation utility tells you whether you need to modify your system parameters to start the DECwindows Motif Version 1.2-4 for OpenVMS product. The installation utility displays the following message: DECwindows Motif will not start if your system parameters are not set correctly. o If you allow a system shutdown, the installation procedure reboots the system at the end of the installation. If your system parameters are incorrect, the installation runs AUTOGEN prior to the system reboot. o If you do not allow a system shutdown, the installation procedure continues; you are informed at the end of the installation whether you need to modify your system parameters to start DECwindows Motif. 2.3.4.2 Locating the PCSI Kit As the installation continues, the POLYCENTER Software Installation utility installs the DECwindows Motif Version 1.2-4 for OpenVMS software. The utility displays messages and asks a series of questions. For example: To answer the following question, enter the directory specification of the DECwindows Motif for OpenVMS POLYCENTER Software Installation utility kit. Where is the PCSI kit located? If you do not enter the correct directory specification, the following message is displayed. The DECwindows Motif V1.2-4 for OpenVMS VAX PCSI kit not found Type Control C to exit installation procedure or reenter kit location. 2-17 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Then the following question is displayed again: Where is the PCSI kit located? If you enter the correct directory specification, the installation utility locates the software and proceeds with the installation. If you press Ctrl/C, the following message is displayed: Terminating installation of DECwindows Motif V1.2-4 for OpenVMS Once the installation utility locates the kit, the procedure asks whether you want to continue with the installation. Do you want to continue? [Yes] If you enter Yes (default) and press Return, the installation procedure displays the following information, which includes previously displayed copyright information. (Note that the NET-APP-SUP-250 and NET-APP-SUP-300 PAKs are also valid.) *** DEC VAXVMS DWMOTIF V1.2-4: DECwindows Motif Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Digital Equipment Corporation This product uses the PAK: DW-MOTIF Do you want all the default values for this product? [YES] No If you answer No (you do not accept the default values), you are questioned about accepting each individual item or subitem. DECwindows Motif runtime support files [YES] Programming Support [YES] Programming Support (C Language) [YES] Fortran Programming Support [YES] Pascal Programming Support [YES] Programming examples [YES] Do you want to view the values? [NO] Yes 2-18 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software If you answer Yes to view the default values, the following information is displayed, followed by a question asking whether you are satisfied with these default values (default is Yes): DEC VAXVMS DWMOTIF V1.2-4: DECwindows Motif [Available] DECwindows Motif runtime support files: YES Programming Support (C Language): YES Fortran programming support: YES PASCAL programming support: YES Programming examples: YES Are you satisfied with the values? [YES] If you are not satisfied with the values, type No and press Return; you can now change your responses to these questions. 2.3.4.3 Executing the Installation Procedure on a VAX System Once you select the programming and translated-image support options, the installation utility begins the software installation. A message is displayed that shows you when the product installation begins and when it is completed, as in the following example. %PCSIUI-I-DONEASK, execution phase starting The following product will be installed: DEC VAXVMS DWMOTIF V1.2-4 %PCSI-I-VOLINFO, estimated space information for volume DISK$VAX -PCSI-I-VOLSPC, 46 required; 84294 available; 84248 net Portion Done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% ...100% The following product has been installed: DEC VAXVMS DWMOTIF V1.2-4 2-19 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software If you wish to use any language other than English, install the appropriate DECwindows Motif Version 1.2-4 language variant product after this installation has completed. For information about locating the Installation Verification Procedure (IVP), see Section 2.3.5.<> 2.3.5 Locating the Installation Verification Procedure (IVP) The installation procedure tells you the location of the IVP, which you should run after the installation is successfully completed and DECwindows Motif is restarted. The following message is displayed: Run the Installation Verification Procedure (IVP) after the installation is completed and DECwindows Motif is restarted. The IVP is located in the following directory: SYS$TEST:DECW$IVP.COM. Refer to Section 4.2 for information about running the IVP. 2.3.6 Verifying the System Parameters The installation procedure checks to ensure the following: o Correct settings for the system parameters o Detection of the required AUTOGEN file, DECW$AUTOGEN.COM The installation procedure checks whether a system reboot is necessary. The following message is displayed: Checking to see if system parameters are set correctly.... The installation procedure has determined that your system parameters are set correctly and that it will not be necessary to run AUTOGEN or reboot the system. If your system is already running DECwindows Motif, restart DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP RESTART If your system is NOT already running DECwindows Motif, start DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP * * * N O T E * * * 2-20 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software If you are installing DECwindows Motif from your workstation console, log off after you enter the command to start DECwindows Motif. If your system parameters are set correctly, the installation procedure displays status information and tells you how to restart or start your DECwindows Motif Version 1.2-4 for OpenVMS software. If the parameters are not set correctly, the following message is displayed: The installation procedure determined that some system parameter values require modification to start the DECwindows Motif Version 1.2-4 for OpenVMS software. To set your parameters correctly, run AUTOGEN using the following DCL command: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK This procedure adjusts your system parameters and reboots the system. The installation procedure displays messages similar to the following: %DECW-W-BADVALUE, SYSGEN parameter GBLSECTIONS is 250, should be at least 600 %DECW-W-BADVALUE, Free GBLSECTIONS is 89, should be at least 210 %DECW-W-BADVALUE, SYSGEN parameter GBLPAGFIL is 128, should be at least 1024 %DECW-W-BADVALUE, SYSGEN parameter PROCSECTCNT is 32, should be at least 64 . . . %AUTOGEN-I-BEGIN, GETDATA phase is beginning. . . . %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. 2-21 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software The system will automatically reboot after the shutdown and the upgrade will be complete. When you run AUTOGEN, the system parameters are reset correctly and the system is rebooted. 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. o The OpenVMS Help library is currently in use. 2-22 3 _________________________________________________________________ Using the VMSINSTAL Procedure This chapter explains how to install DECwindows Motif Version 1.2-4 for OpenVMS software using the VMSINSTAL procedure on OpenVMS VAX systems. The VMSINSTAL installation procedure is only provided for VAX systems and should only be used on OpenVMS versions prior to Version 6.2. (Use the POLYCENTER Software Installation utility to install DECwindows Motif on OpenVMS Alpha systems; see Chapter 2.) Included is a step-by-step description of the installation procedure, information about error recovery, and instructions for accessing the release notes. Using the VMSINSTAL procedure, the DECwindows Motif Version 1.2-4 for OpenVMS installation takes approximately 45 minutes, depending on the processor type. The VMSINSTAL procedure installs the DECwindows Motif Version 1.2-4 for OpenVMS product on your system disk. ________________________ Note ________________________ A Product Authorization Key (PAK) for DECwindows Motif Version 1.2-4 for OpenVMS must be registered and loaded before starting the DECwindows Motif Version 1.2-4 for OpenVMS installation. ______________________________________________________ _______________________ Caution _______________________ If you do not have a satisfactory backup copy of your system disk, do not attempt to install DECwindows Motif Version 1.2-4 for OpenVMS software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your VAX processor) before you install DECwindows Motif Version 1.2-4 for OpenVMS software. 3-1 Using the VMSINSTAL Procedure 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.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 DECwindows Motif Version 1.2-4 for OpenVMS VAX software using the VMSINSTAL installation procedure. Refer to Section 1.7 for information on requirements common to both VMSINSTAL and PCSI installations. Prepare to install DECwindows Motif Version 1.2-4 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 Digital prefers that you perform the installation using the operator console or other hardcopy terminal, you can perform the installation from a DECterm window. 3.1.1 Process Privileges To install DECwindows Motif Version 1.2-4 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 turns it back on when the installation is completed. 3-2 Using the VMSINSTAL Procedure 3.1 Installation Procedure Requirements 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 DECwindows Motif Version 1.2-4 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. 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. 3-3 Using the VMSINSTAL Procedure 3.1 Installation Procedure Requirements 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 DECwindows Motif Version 1.2-4 for OpenVMS installation, the value of facunvvv is DWMOTIFVAXU4012. 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 DECwindows Motif Version 1.2-4 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 DWMOTIFVAXU4012 source-drive - _$ OPTIONS N,AWD=DKA2: 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-4 Using the VMSINSTAL Procedure 3.2 Installation Procedure 3.2 Installation Procedure The DECwindows Motif Version 1.2-4 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. 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 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 DECwindows Motif Version 1.2-4 for OpenVMS installation, use the installation name DWMOTIFVAXU4012. o ddcu Specifies the device name of the source drive that holds the distribution media. 3-5 Using the VMSINSTAL Procedure 3.2 Installation Procedure 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 DECwindows Motif Version 1.2-4 for OpenVMS software: 1. Locate the DECwindows Motif Version 1.2-4 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. Place the distribution media in the source drive. If your DECwindows Motif Version 1.2-4 for OpenVMS distribution kit contains more than one piece of media, place the first piece in the drive. During the installation procedure, you will be prompted to load the next piece of media. 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): DWMOTIFVAXU4012 for OpenVMS VAX systems. Specify OPTIONS N to access the release notes, which are included in your media kit. The DECwindows Motif Version 1.2-4 for OpenVMS Release Notes can be displayed or printed before the installation begins. Enter the following command at the DCL prompt: $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU4012 ddcu: OPTIONS N 3-6 Using the VMSINSTAL Procedure 3.2 Installation Procedure 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 DECwindows Motif Version 1.2-4 for OpenVMS from a magnetic tape cartridge in drive MUA0:, enter the following command to invoke the VMSINSTAL command procedure: $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU4012 MUA0: OPTIONS N If you install DECwindows Motif Version 1.2-4 for OpenVMS using the alternate working device (AWD) option described in Chapter 1, invoke the VMSINSTAL command procedure as follows: $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU4012 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]. For example, if you are installing DECwindows Motif Version 1.2-4 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 DWMOTIFVAXU4012 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. 3-7 Using the VMSINSTAL Procedure 3.2 Installation Procedure The VMSINSTAL procedure displays messages similar to the following: OpenVMS VAX Version 6.1 Software Product Installation Procedure It is 26-MAR-1996 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. 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 DWMOTIFVAXU4012. Enter the names of the product to be processed from the first distribution volume set. * Product: DWMOTIFVAXU4012 3-8 Using the VMSINSTAL Procedure 3.2 Installation Procedure When the installation begins, the VMSINSTAL procedure displays informational text similar to the following: The following products will be processed: DWMOTIFVAX V1.2-4 Beginning installation of DWMOTIFVAXU4 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. 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 ________________________ Digital 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 3-9 Using the VMSINSTAL Procedure 3.2 Installation Procedure 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. %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. *** Installing DECwindows Motif for OpenVMS VAX software *** Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. 3-10 Using the VMSINSTAL Procedure 3.2 Installation Procedure 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 DECwindows Motif Version 1.2-4 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 DECwindows Motif Version 1.2-4 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-4. The XUI programming environment is also not included in DECwindows Motif Version 1.2-4. 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]? 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.5 for information about how to reference the previous version of the programming support files. 3-11 Using the VMSINSTAL Procedure 3.2 Installation Procedure 3.2.8 Installing the Entire Kit You can install the entire DECwindows Motif Version 1.2-4 for OpenVMS software kit, or you can install part of the kit. The DECwindows Motif base kit is always installed; the DECwindows Motif Version 1.2-4 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]? Press the Return key to install programming support. The following message is displayed: Support files are supplied for the following OpenVMS programming languages: Fortran, Pascal In addition, support files are supplied for programming in the C language using conventions and standards developed at the Massachusetts Institute of Technology. 3-12 Using the VMSINSTAL Procedure 3.2 Installation Procedure If you choose not to install programming support, enter No and proceed to the instructions in Section 3.2.10. The installation procedure asks whether you want to install all of the programming support files: * Do you want to install all programming language support files [Yes]? Press the Return key if you want to install all the languages. If you do not want to install all the languages, enter No and press the Return key. Each language then is displayed. Enter Yes for each language that you want to install. The installation procedure asks whether you want to install DECwindows Motif programming example files: * Do you want to install DECwindows Motif programming examples [Yes]? Press the Return key if you want to install the programming example files. If you enter No, the example files are not installed. 3.2.10 Verifying Kit Selections The components of the kit that you selected now display; you can verify that these choices are correct. A message similar to the following is displayed: You have selected the following portions of the kit: o DECwindows Motif Applications and Run-time Libraries o DECwindows Motif programming examples o DECwindows Motif programming support Fortran, Pascal MIT C language programming conventions o OSF/Motif Release 1.1.3 and XUI saved programming support * Are these selections correct [Yes]? Press the Return key if the choices are correct. If you want to change your selections, enter No and press the Return key. You are prompted by the previous questions again, beginning with whether you want to install the entire kit (see Section 3.2.8). After you repeat the selection procedure and are satisfied with your selections, enter Yes and press the Return key. 3-13 Using the VMSINSTAL Procedure 3.2 Installation Procedure 3.2.11 Verifying Disk Space The installation procedure checks whether your system disk contains a sufficient number of free blocks. 1. If the blocks are available, the installation continues (see Section 3.2.12). 2. If you do not have sufficient system disk space to install the portions you chose, the installation displays a message similar to the following: Your system disk has only 25364 free blocks, and you have selected to install approximately 76050 blocks. * * * N O T E * * * The installation procedure has determined that you do not have enough disk space to complete the installation. However, it may be possible to continue successfully if you are installing DECwindows Motif on a system that already has DECwindows Motif installed. * Do you want to reselect which DECwindows Motif options to install [Yes]? If you press the Return key, you can reselect the DECwindows Motif options beginning with those described in Section 3.2.8. If you enter No, the procedure asks whether you want to continue the installation: * Do you want to continue the installation anyway [Yes]? _______________________ Caution _______________________ If you press the Return key, the installation continues. However, if you exceed the amount of available disk space, the installation fails. ______________________________________________________ If you enter No, the installation ends. You can then either free up blocks on the system disk and restart the installation or start the installation again using the AWD option. (See Section 3.1.2 for information about using the AWD option.) 3. If you specify an alternate working device that does not have sufficient disk space to install the portions you have chosen, the installation displays a message similar to the following: 3-14 Using the VMSINSTAL Procedure 3.2 Installation Procedure Your specified alternate working directory device has only 68977 free blocks, and this installation will require approximately 76050 blocks. You should either reselect which DECwindows Motif options to install, or restart this installation using an alternate working directory device with more free blocks. * * * NOTE * * * Although the installation procedure estimates you do not have enough disk space to complete the installation, it may be possible to continue successfully if you are installing DECwindows Motif on a system which already has DECwindows installed. * Do you want to reselect which DECwindows Motif options to install [Yes]? If you press the Return key, you can reselect the DECwindows Motif options beginning with those described in Section 3.2.8. If you enter No, the procedure asks whether you want to continue the installation: * Do you want to continue the installation anyway [Yes]? If you press the Return key, the installation continues. _______________________ Caution _______________________ If you lack sufficient free disk space for installation on the alternate working device, the installation procedure ends. ______________________________________________________ If you enter No, the installation procedure ends. Restart the installation once you set up an alternate working device with sufficient disk space. (See Section 3.1.2 for more information about using the AWD option.) 3.2.12 Verifiying License Registration The installation procedure continues and displays license information similar to the following: A registered and loaded product authorization key for DW-MOTIF is required to run any DECwindows Motif for OpenVMS application. If you answer No to the next question, the installation of DECwindows Motif for OpenVMS will be terminated. 3-15 Using the VMSINSTAL Procedure 3.2 Installation Procedure Product: DW-MOTIF Producer: DEC Version: Release Date: * Does this product have an authorization key registered and loaded ? Note that the NET-APP-SUP-250 and NET-APP-SUP-300 PAKs are also valid. Enter Yes to continue with the installation if your authorization key is registered and loaded. If you enter No, the following message is displayed and the installation ends: Installation of DECwindows Motif cannot continue because you do not have a registered and loaded authorization key. See Section 1.1 for more information about license registration. After you register and load your authorization key, restart the DECwindows Motif Version 1.2-4 for OpenVMS installation beginning at step 4 in Section 3.2.2. 3.2.13 Performing a System Reboot The installation procedure suggests that you perform a system reboot to ensure successful installation of DECwindows Motif Version 1.2-4 for OpenVMS software: DECwindows Motif will not start if your system parameters are not correct. o If you allow a system shutdown, the installation procedure will reboot the system at the end of the installation. If your system parameters are incorrect, the installation will run AUTOGEN prior to the system reboot. o If you do not allow a system shutdown, the installation procedure will continue, and you will be informed at the end of the installation whether you need to modify your system parameters in order to start DECwindows Motif. To complete the installation of this product, you should reboot the system. If it is not convenient to reboot at this time, then enter No to the following question. If you enter No, the installation procedure will continue. * Will you allow a system reboot after this product is installed [Yes]? 3-16 Using the VMSINSTAL Procedure 3.2 Installation Procedure If you entered No to the shutdown question, no further questions are asked. If you answered Yes to the shutdown question, the VMSINSTAL procedure displays the following questions about the shutdown: * How many minutes for system shutdown [0]? * Do you want to do an automatic system reboot [Yes]? No further questions will be asked. _______________________ Caution _______________________ To avoid confusion with file versions when activating an image or application, perform the necessary procedures to restart the DECwindows Motif Version 1.2-4 for OpenVMS software as indicated during the installation in Section 3.2.15. ______________________________________________________ 3.2.14 Reading Informational Messages The VMSINSTAL procedure lists the directories that are created and the save sets that are restored. The VMSINSTAL procedure prints out a message indicating that the files will be moved to their target directories. o If you perform the installation using media other than 9-track magnetic tape, messages similar to the following display: 3-17 Using the VMSINSTAL Procedure 3.2 Installation Procedure %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECW$INCLUDE.DECW$113]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSEXE.DECW$113]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSLIB.DECW$113]. %VMSINSTAL-I_RESTORE, Restoring product save set B ... %VMSINSTAL-I_RESTORE, Restoring product save set C ... %VMSINSTAL-I_RESTORE, Restoring product save set D ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set F ... %VMSINSTAL-I-RESTORE, Restoring product save set G ... %VMSINSTAL-I-RESTORE, Restoring product save set H ... %VMSINSTAL-I-RESTORE, Restoring product save set I ... %VMSINSTAL-I-RESTORE, Restoring product save set J ... %VMSINSTAL-I-RESTORE, Restoring product save set L ... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... o If you perform the installation using 9-track magnetic tape, some of the files are compressed into text libraries. The installation procedure informs you that the data is being decompressed and displays messages similar to the following: %VMSINSTAL-I_RESTORE, Restoring product save set B ... %VMSINSTAL-I_RESTORE, Restoring product save set C ... %VMSINSTAL-I_RESTORE, Restoring product save set D ... %VMSINSTAL-I_RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set F ... %VMSINSTAL-I-RESTORE, Restoring product save set G ... %VMSINSTAL-I-RESTORE, Restoring product save set H ... %VMSINSTAL-I-RESTORE, Restoring product save set I ... Decompressing H_E_DECW$INCLUDE Decompressing H_E_SYSLIB %VMSINSTAL-I_RESTORE, Restoring product save set J ... %VMSINSTAL-I-RESTORE, Restoring product save set L ... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... The installation procedure then informs you that a spurious error message will be displayed, which you can safely ignore: 3-18 Using the VMSINSTAL Procedure 3.2 Installation Procedure You can ignore the following NCP error message(s). %NCP-I-SUCCESS, Success Object = X$X0 %NML-I-RECDELET, Database entry deleted The installation procedure then reminds you to install the language variant product after the installation, if necessary. If you wish to use any language other than English, install the appropriate DECwindows Motif Version 1.2-4 language variant product after this installation has completed. You are notified that you should run the Installation Verification Procedure (IVP) after the installation is completed and after you start the DECwindows Motif software. (See Section 4.2 for more information about running the IVP.) The Installation Verification Procedure (IVP) should be run after the installation has been completed and DECwindows Motif has been restarted. The IVP can be found in SYS$TEST:DECW$IVP.COM. 3.2.15 Using the AUTOGEN Utility to Set System Parameters The installation procedure might automatically run AUTOGEN, depending on which type of system you are using: o A nonworkstation system If you install DECwindows Motif Version 1.2-4 for OpenVMS on a nonworkstation system (that is, an OpenVMS host system), the following message is displayed: This system is not a workstation. It will not be necessary to run AUTOGEN. o A workstation system that runs DECwindows Motif Version 1.2-4 for OpenVMS software with correct system parameters If you install DECwindows Motif Version 1.2-4 for OpenVMS on a workstation system and your system parameters are correct, the following message is displayed: 3-19 Using the VMSINSTAL Procedure 3.2 Installation Procedure The installation procedure has determined that your system parameters are set correctly and that it will not be necessary to run AUTOGEN or reboot the system. If your system is already running DECwindows Motif, restart DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP RESTART If your system is NOT already running DECwindows Motif, start DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP * * * N O T E * * * If you are installing DECwindows Motif from your workstation console, log off after you enter the command to start DECwindows Motif. o A workstation system that runs DECwindows Motif Version 1.2-4 for OpenVMS software with incorrect system parameters If you install DECwindows Motif Version 1.2-4 for OpenVMS on a workstation system and your system parameters need to be reset, the following message is displayed: The installation of DECwindows Motif has determined that some of your system parameter values will require modification in order to start DECwindows Motif Version 1.2-4 for OpenVMS. To set your parameters correctly, run AUTOGEN using the following DCL command: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK This will adjust your system parameters and reboot the system. o A workstation system that runs DECwindows Motif Version 1.2-4 for OpenVMS with incorrect system parameters, and you answered Yes to a system shutdown The OpenVMS AUTOGEN procedure will now be run to set your system parameters. After that, your system will be automatically rebooted. After the system has been rebooted, successful installation of the workstation software will be indicated by the appearance of the Start Session window. 3-20 Using the VMSINSTAL Procedure 3.2 Installation Procedure %AUTOGEN-I-BEGIN, GETDATA phase is beginning. . . . %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning. . . . %AUTOGEN-I-BEGIN, GENFILES phase is beginning. . . . %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning. . . . Installation of DWMOTIFVAXU4 V1.2 completed at 10:57 %VMSINSTAL-I-SHUTDOWN, This product requires that the system be rebooted. SHUTDOWN -- Perform an Orderly System Shutdown on node NODE01 . . . 3.2.16 Completing the Installation Procedure When the installation is completed, a message similar to the following is displayed: Installation of DWMOTIFVAXU4 V1.2 completed at 10:57 VMSINSTAL procedure done at 12:45 These messages indicate that the installation procedure completed successfully. Your system automatically shuts down if AUTOGEN is run; you must then reboot your system. See the upgrade and installation supplement for your VAX processor for instructions on how to reboot your system. ________________________ Note ________________________ If you upgrade your system with a higher version of OpenVMS at a later time, you might need to reinstall 3-21 Using the VMSINSTAL Procedure 3.2 Installation Procedure the DECwindows Motif Version 1.2-4 for OpenVMS software. ______________________________________________________ 3.3 Recovering from Errors Errors can occur during the installation if any of the following conditions exist: o Incorrect OpenVMS operating system version. o Insufficient quotas. o Insufficient values for system parameters. o OpenVMS help library is currently in use. o Product license is not registered and loaded. 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. 3.4 Accessing the Release Notes During the installation, the VMSINSTAL procedure copies the DECwindows Motif Version 1.2-4 for OpenVMS Release Notes to the SYS$HELP:DECW$MOTIFU4012.RELEASE_NOTES file. Once you return to DCL level, you can print this file or display it at a terminal. Refer to Section 3.2.5 for more information about accessing the release notes.<> 3-22 4 _________________________________________________________________ After Installing the Software This chapter discusses the tasks that you need to perform after the DECwindows Motif Version 1.2-4 for OpenVMS installation is completed: o Section 4.1, Starting the DECwindows Motif Software o Section 4.2, Running the IVP o Section 4.3, Choosing an Alternative Console If the DW-MOTIF license that is installed on your system is not valid, appropriate messages display on your console terminal and DECwindows Motif is not automatically started. If this situation occurs, log in to the system, install the valid license, and start your DECwindows Motif software. For complete information on installing licenses using LMF, see the OpenVMS License Management Utility Manual. 4.1 Starting the DECwindows Motif Software If you allowed a system reboot during the installation of DECwindows Motif for OpenVMS, the DECwindows startup procedure runs automatically when the system reboots. On OpenVMS Alpha systems, either the New Desktop login dialog box or the DECwindows desktop Start Session dialog box is displayed, depending on the value of the DECW$START_ NEW_DESKTOP global symbol. (See Section 1.7.5 for more information.) On OpenVMS VAX systems the Start Session dialog box is displayed. Proceed to Section 4.2 if you allowed a system reboot and DECwindows has successfully started. If you did not allow a system reboot during the installation, you must start or restart the DECwindows Motif software by running the DECwindows startup procedure, as described in the following paragraphs. When the startup procedure has successfully completed, either the New 4-1 After Installing the Software 4.1 Starting the DECwindows Motif Software Desktop login dialog box or the DECwindows desktop Start Session dialog box is displayed, as explained in the previous paragraph. DECwindows Motif Version 1.2-4 for OpenVMS software can be started only if your system parameters are correct. Proceed to one of the following sections if your system parameters are correct: o Section 4.1.1, Standalone Systems o Section 4.1.2, VMScluster Systems If your system parameters are not correct, then use one of the following methods to adjust them accordingly: o Invoke the AUTOGEN utility: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK o Attempt to start the DECwindows Motif software. The DECwindows Motif startup procedure checks your system parameters; if they are too low, the following question is displays: 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 run or cause a reboot, but DECwindows will not start. To run AUTOGEN at a later date, enter the following command: $ @SYS$UPDATE:AUTOGEN getdata reboot check_feedback Do you want the system to run AUTOGEN for you [Yes]? After the system is rebooted and the startup is completed, the Start Session dialog box displays. The DECwindows Motif Version 1.2-4 for OpenVMS software is now installed and running on your system. Run the Installation Verification Procedure (IVP) as described in Section 4.2 to verify that the installation of DECwindows Motif Version 1.2-4 for OpenVMS software is complete and accurate. 4-2 After Installing the Software 4.1 Starting the DECwindows Motif Software 4.1.1 Standalone Systems Perform one of the following procedures to start your DECwindows Motif software on a standalone system: o If your system is not running DECwindows Motif, then start DECwindows Motif with the following command: $ @SYS$MANAGER:DECW$STARTUP o If your system is currently running DECwindows Motif, then restart DECwindows Motif with the following command: $ @SYS$MANAGER:DECW$STARTUP RESTART ________________________ Note ________________________ If your system has a workstation display, then the command to restart DECwindows Motif will end your current session. The Start Session dialog box displays on your terminal, and you must log back in to continue using DECwindows Motif. ______________________________________________________ The DECwindows Motif Version 1.2-4 for OpenVMS software is now installed and running on your system. Run the IVP as described in Section 4.2 to verify that the installation of DECwindows Motif Version 1.2-4 for OpenVMS is complete and accurate. 4.1.2 VMScluster Systems Starting DECwindows Motif Version 1.2-4 for OpenVMS on nonsatellite and satellite nodes is described in the sections that follow. 4.1.2.1 Starting Nonsatellite and Boot Nodes To start DECwindows Motif Version 1.2-4 for OpenVMS software on each of the nonsatellite nodes within your VMScluster, perform one of the following procedures: o If your system is not running DECwindows Motif, then start DECwindows Motif with the following command: $ @SYS$MANAGER:DECW$STARTUP 4-3 After Installing the Software 4.1 Starting the DECwindows Motif Software o If your system is currently running DECwindows Motif, then restart DECwindows Motif with the following command: $ @SYS$MANAGER:DECW$STARTUP RESTART ________________________ Note ________________________ If the nonsatellite node or boot node has a workstation display, then the command to restart DECwindows Motif will end your current session. The Start Session dialog box displays on your terminal; log in again to continue using DECwindows Motif. ______________________________________________________ The DECwindows Motif Version 1.2-4 for OpenVMS software is now installed and running on your system. Run the IVP as described in Section 4.2 to verify that the installation of the DECwindows Motif Version 1.2-4 for OpenVMS product is complete and accurate. 4.1.2.2 Starting Satellite Nodes To start the DECwindows Motif Version 1.2-4 for OpenVMS software that is installed on the boot node, perform one of the following procedures on each satellite node in the VMScluster that will run DECwindows Motif Version 1.2-4 for OpenVMS software: o If the node is not running DECwindows Motif, then start DECwindows Motif with the following command: $ @SYS$MANAGER:DECW$STARTUP o If the node is currently running DECwindows Motif, then restart DECwindows Motif with the following command: $ @SYS$MANAGER:DECW$STARTUP RESTART Once DECwindows Motif is started or restarted on each node in the VMScluster, then the installation is considered complete. Now run the IVP as described in Section 4.2. 4-4 After Installing the Software 4.2 Running the IVP 4.2 Running the IVP Run the IVP, SYS$TEST:DECW$IVP.COM, after you install and start the DECwindows Motif Version 1.2-4 for OpenVMS product. This procedure contains four tests, which verify that the software installation is complete and accurate. First, the IVP procedure attempts to run two display- oriented tests. When you invoke the IVP, it identifies your type of hardware. o If you are using a workstation, you are asked where the display-oriented tests should display. Your current workstation is the default. o If you are not using a workstation, the procedure prompts you for a display name. Press Ctrl/Z at the prompt if you do not want to run the display-oriented tests. The IVP runs these tests only if the images exist on the system. If the IVP does not find the images, a message displays to inform you that the tests will not be run. ________________________ Note ________________________ If you are invoking the IVP from a LAT Xterminal using LAT software, enter the following command first: $ SET DISPLAY/CREATE/NODE=LAT_nnnnnnnnnnnn/TRANSPORT=LAT Substitute your actual LAT terminal number for nnnnnnnnnn. Enter the default at the _Display: prompt. ______________________________________________________ Next, the IVP runs two nondisplay-oriented tests. o The first of these tests invokes the Motif UIL compiler. If you did not install programming support, the IVP informs you that this test will not be run because the Motif UIL image does not exist. If this test is run, you are notified of its completion status. 4-5 After Installing the Software 4.2 Running the IVP o The last test converts a text file to DDIF format and then converts it back to text, comparing the original text file with the result. If the files match, the test is successful. You are notified of its completion status. Example 4-1 shows you how to run the IVP. Example 4-1 Sample IVP $ @SYS$TEST:DECW$IVP Copyright Digital Equipment Corporation 1988, 1994. All rights reserved. DECwindows Motif for OpenVMS Installation Verification Procedure (IVP) This IVP is intended to test some of the functionality of DECwindows Motif for OpenVMS and to provide a quick method of verifying the installation. This machine is not a workstation. Please provide the nodename of a workstation on which to display the IVP tests. You must be sure that this account and node have security access to the display node, or the IVP will fail. To skip the display-oriented tests, press Ctrl/Z at the following prompt. _Display: NODE33::0.0 %DECW-I-IVP, The IVP will display on NODE33::0.0 %DECW-I-IVP, Running DECW$EXAMPLES:ICO.EXE for up to a minute. %DECW-I-IVP, Press Ctrl/Y to interrupt test. %DCL-S-SPAWNED, process DECW$IVP_ICO spawned %DECW-I-IVP, Running SYS$SYSTEM:DECW$CLOCK for up to a minute. %DECW-I-IVP, Press Ctrl/Y to interrupt test. %DCL-S-SPAWNED, process DECW$IVP_CLOCK spawned %DECW-I-IVP, Invoking the UIL Motif compiler... %DECW-S-IVP, The UIL Motif compiler test completed successfully. %DECW-I-IVP, Beginning CONVERT/DOCUMENT IVP... %DECW-S-IVP, CONVERT/DOCUMENT IVP passed. %DECW-S-IVP, The IVP has completed. $ 4-6 After Installing the Software 4.3 Choosing an Alternative Console 4.3 Choosing an Alternative Console The DECwindows Motif Version 1.2-4 for OpenVMS software allows you to boot all configurations from the main console. You can then toggle between displaying and not displaying the operator window by pressing Ctrl/F2. The main console is always a workstation screen. If you are logged in to the main console (workstation screen), you must log out before DECwindows will start. Issue the following command from the main console: $ @SYS$MANAGER:DECW$STARTUP Once the command procedure completes, log out of the main console. Otherwise the server will not start and a login box will not appear. For an alternative console, you can use a terminal connected to the workstation by means of a terminal port. If you boot from the main console, the alternative console is connected when you invoke the DECwindows Motif startup command procedure. If you boot the system from an alternative console, you cannot start the Console Window application. This application is described in the release notes. 4-7 5 _________________________________________________________________ Managing DECwindows Motif Software This chapter contains information about managing the performance of your DECwindows Motif Version 1.2-4 for OpenVMS software. It also describes how to add and remove DECwindows Motif files from your system disk using tailoring utilities. See Managing DECwindows Motif for OpenVMS Systems for additional system management information. The following topics are discussed in this chapter: o Section 5.1, Customizing the DECwindows X11 Display Server Startup Procedure o Section 5.2, Using the DECW$MOTIF_TAILOR Utility to Remove Files o Section 5.3, Adding DECwindows Base-Support Files o Section 5.4, Determining and Reporting Problems After you install the DECwindows Motif Version 1.2- 4 for OpenVMS product, you can tune your system to enhance performance or to decrease the use of some system resources. For information about tuning your system, see Managing DECwindows Motif for OpenVMS Systems. 5.1 Customizing the DECwindows X11 Display Server Startup Procedure The DECwindows X11 display server manages the graphics devices on your workstation, such as the display, keyboard, and mouse. ________________________ Note ________________________ Start the DECwindows X11 display server on workstation systems only. ______________________________________________________ 5-1 Managing DECwindows Motif Software 5.1 Customizing the DECwindows X11 Display Server Startup Procedure The startup command procedures automatically determine most of the configuration parameters for the DECwindows X11 display server. However, the command procedures cannot determine some items, such as the following: o Whether you have a 75-dpi or 100-dpi monitor o Whether you have a North American keyboard layout (such as for an LK201-AA or -LA or an LK401-AA or -LA keyboard) o Whether the DECwindows X11 display server uses only DECnet for OpenVMS software and local transports o Whether the DECwindows X11 display server logs both successful and unsuccessful connect and disconnect messages to the DECW$SERVER_n_ERROR.LOG file To ensure that the DECwindows X11 display server is set up correctly, modify the server startup file as follows: 1. Make a copy of the file SYS$MANAGER:DECW$PRIVATE_ SERVER_SETUP.TEMPLATE and rename it to SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM. This server startup file shows how to customize individual workstations by adding a section of DCL commands for each workstation. You can add setup options in either of two sections in the server startup file. Setup options added to the "Cluster Common or Standalone Workstation Setup" section affect all nodes in a cluster. Setup options added to the "Cluster Member Workstation-Specific Setup" section affect only individual nodes. If you add a workstation- specific option, you must also update the variable node_ list. 2. If your screen supports 100 dots-per-inch, add the following line: $ DECW$SERVER_DENSITY == "100" Add this line to the section for each workstation that has a 100 dots-per-inch monitor, or add it to the common section for all workstations (if all the workstations have 100-dpi monitors). 5-2 Managing DECwindows Motif Software 5.1 Customizing the DECwindows X11 Display Server Startup Procedure 3. If you want the server to log successful connect and disconnect messages, add the following line: $ DECW$SERVER_CONNECT_LOG == "TRUE" 4. Add the following line to the section for monochrome GPX workstations: $ DECW$COLOR == "FALSE" No modification is necessary for grayscale (intensity) screens. 5. Add the following line to the section for workstations with keyboards that are not North American LK201 models: $ DECW$DEFAULT_KEYMAP == "xxxxx" In the previous line, replace xxxxx with the correct DECwindows keymap name. You can determine the correct name from the model number of your LK201 or LK401 keyboard. Turn the keyboard upside down and look for a label that specifies the model number. The model number is in a format similar to LK201-xx or LK401-xx. The model number may also be listed as LK201 or LK401. In this case, the xx that you need is in another part of the label where there is a number that looks similar to the following: nn-nnnnn-xx Use the xx part of this number to choose a keymap name from Table 5-1. Choose the keymap ending in _DP for data-processing keyboard layout and the keymap ending in _TW for typewriter layout. Table 5-1 is arranged according to the dialect for which each keyboard is designed. After you choose a keymap name, modify the DECwindows X11 display server startup file. For example, to change the keyboard layout to a Dutch typewriter layout, add the following line to the DECwindows X11 display server startup file: $ DECW$DEFAULT_KEYBOARD_MAP == "DUTCH_LK201LH_TW" 5-3 Managing DECwindows Motif Software 5.1 Customizing the DECwindows X11 Display Server Startup Procedure Add a similar line for each workstation that does not have a North American keyboard layout or add the line to the common section for all workstations (if all the workstations use the same keyboard layout). 6. Enter the following command to restart DECwindows Motif on the workstations for which you customized the server startup by using the following command: $ @SYS$MANAGER:DECW$STARTUP RESTART Table_5-1_DECwindows_Keymap______________________________________ Dialect_________Model_____________DECwindows_Keymap______________ Austrian LK201- AUSTRIAN_GERMAN_LK201LG_DP /German (AG,LG,BG,MG) AUSTRIAN_GERMAN_LK201LG_TW LK201-(NG,PG) AUSTRIAN_GERMAN_LK201NG_DP AUSTRIAN_GERMAN_LK201NG_TW LK401-(AG) AUSTRIAN_GERMAN_LK401AG_TW Belgian/French LK201- BELGIAN_FRENCH_LK201LP_DP (AP,LP,BP,MP) BELGIAN_FRENCH_LK201LP_TW Belgian/French LK401-(AP) BELGIAN_FRENCH_LK401AP_DP BELGIAN_FRENCH_LK401AP_TW British LK201- BRITISH_LK201LE_DP (AE,LE,BE,ME) BRITISH_LK201LE_TW British LK401-(AA,PA) BRITISH_LK401AA_DP BRITISH_LK401AA_TW Canadian LK201- CANADIAN_FRENCH_LK201LC_DP /French (AC,LC,BC,MC) CANADIAN_FRENCH_LK201LC_TW Canadian LK401- CANADIAN_FRENCH_LK401AC_DP /French (AC,LC,BC,MC) CANADIAN_FRENCH_LK401AC_TW (continued on next page) 5-4 Managing DECwindows Motif Software 5.1 Customizing the DECwindows X11 Display Server Startup Procedure Table_5-1_(Cont.)_DECwindows_Keymap______________________________ Dialect_________Model_____________DECwindows_Keymap______________ Danish LK201- DANISH_LK201LD_DP (AD,LD,BD,MD) DANISH_LK201LD_TW LK201-(ED,RD,FD) DANISH_LK201RD_DP DANISH_LK201RD_TW Danish LK401- DANISH_LK401AD_DP (AD,LD,BD,MD) DANISH_LK401AD_TW Dutch LK201- DUTCH_LK201LH_DP (AH,LH,BH,MH) DUTCH_LK201LH_TW LK201-(NH,PH) DUTCH_LK201NH LK401-(NH,PH) DUTCH_LK401AH Finnish LK201- FINNISH_LK201LF_DP (AF,LF,BF,MF) FINNISH_LK201LF_TW LK201-(NX,PX) FINNISH_LK201NX_DP FINNISH_LK201NX_TW Finnish LK401- FINNISH_LK401AF_DP (AF,LF,BF,MF) FINNISH_LK401AF_TW Flemish LK201- FLEMISH_LK201LB_DP (AB,LB,BB,MB) FLEMISH_LK201LB_TW Flemish LK401- FLEMISH_LK401AB_DP (AB,LB,BB,MB) FLEMISH_LK401AB_TW Icelandic LK201- ICELANDIC_LK201LU_DP (AU,LU,BU,MU) ICELANDIC_LK201LU_TW (continued on next page) 5-5 Managing DECwindows Motif Software 5.1 Customizing the DECwindows X11 Display Server Startup Procedure Table_5-1_(Cont.)_DECwindows_Keymap______________________________ Dialect_________Model_____________DECwindows_Keymap______________ Italian LK201- ITALIAN_LK201LI_DP (AI,LI,BI,MI) ITALIAN_LK201LI_TW Italian LK401- ITALIAN_LK401AI_DP (AI,LI,BI,MI) ITALIAN_LK401AI_TW North American LK201- NORTH_AMERICAN_LK201LA (AA,LA,BA,MA) North American LK401- NORTH_AMERICAN_LK401AA (AA,LA,BA,MA) Norwegian LK201- NORWEGIAN_LK201LN_DP (AN,LN,BN,MN) NORWEGIAN_LK201LN_TW LK201-(EN,RN,FN) NORWEGIAN_LK201RN_DP NORWEGIAN_LK201RN_TW Norwegian LK401- NORWEGIAN_LK401AN_DP (AN,LN,BN,MN) NORWEGIAN_LK401AN_TW Portuguese LK201- PORTUGUESE_LK201LV (AV,LV,BV,MV) Portuguese LK401- PORTUGUESE_LK401AV (AV,LV,BV,MV) Spanish LK201- SPANISH_LK201LS_DP (AS,LS,BS,MS) SPANISH_LK201LS_TW Spanish LK401- SPANISH_LK401AS_DP (AS,LS,BS,MS) SPANISH_LK401AS_TW Swedish LK201- SWEDISH_LK201LM_DP (AM,LM,BM,MM) SWEDISH_LK201LM_TW (continued on next page) 5-6 Managing DECwindows Motif Software 5.1 Customizing the DECwindows X11 Display Server Startup Procedure Table_5-1_(Cont.)_DECwindows_Keymap______________________________ Dialect_________Model_____________DECwindows_Keymap______________ LK201-(NM,PM) SWEDISH_LK201NM_DP SWEDISH_LK201NM_TW Swedish LK401- SWEDISH_LK401AM_DP (AM,LM,BM,MM) SWEDISH_LK401AM_TW Swiss/French LK201- SWISS_FRENCH_LK201LK_DP (AK,LK,BK,MK) SWISS_FRENCH_LK201LK_TW Swiss/French LK401- SWISS_FRENCH_LK401AK_DP (AK,LK,BK,MK) SWISS_FRENCH_LK401AK_TW Swiss/German LK201- SWISS_GERMAN_LK201LL_DP (AL,LL,BL,ML) SWISS_GERMAN_LK201LL_TW Swiss/German LK401- SWISS_GERMAN_LK401AL_DP (AL,LL,BL,ML) SWISS_GERMAN_LK401AL_TW Combined US/UK LK201-(EE,RE,PE) UK_LK201RE US_LK201RE Combined US/UK LK401-(EE,RE,PE) UK_LK401AA __________________________________US_LK401AA_____________________ 5.2 Using the DECW$MOTIF_TAILOR Utility to Remove Files The DECW$MOTIF_TAILOR utility is used to remove DECwindows Motif files from the system disk (for example, support files for the Toolkit, applications, and programming). If you later decide that you want DECwindows Motif programming support, add the files to the system disk by reinstalling the system. See Section 5.3 for information about adding files. ________________________ Note ________________________ Use the DECW$MOTIF_TAILOR utility only if you installed the DECwindows Motif for OpenVMS kit using 5-7 Managing DECwindows Motif Software 5.2 Using the DECW$MOTIF_TAILOR Utility to Remove Files VMSINSTAL. If you installed the DECwindows Motif for OpenVMS kit using the POLYCENTER Software Installation utility (PCSI), remove files using the PCSI commands PRODUCT REMOVE or PRODUCT RECONFIGURE. (For more information on PCSI commands, enter HELP PRODUCT at the DCL prompt or refer to the POLYCENTER Software Installation Utility User's Guide. ______________________________________________________ The DECW$MOTIF_TAILOR process includes two phases: o The first phase lists each class of DECwindows Motif files and asks whether you want to delete the class from the system disk. o The second phase deletes the files you indicated from the system disk. Table 5-2 lists the classes (or groups) and subclasses of DECwindows Motif files that you can delete using the DECW$MOTIF_TAILOR utility. For a list of DECwindows Motif files and their descriptions and classes, see Appendix C. Table 5-2 Classes of OpenVMS Files That Can Be Removed with __________the_DECW$MOTIF_TAILOR_Utility____________________ Class__________Subclass_______Description__________________ DECwindows No subclasses DECwindows Motif run-time Motif run- in this support. time support tailor class DECwindows No subclasses DECwindows Motif CDA support. Motif CDA in this support tailor class DECwindows DECwindows The DECwindows Motif Motif Motif applications files provide applications computer- a variety of applications. files based instruction (CBI) (continued on next page) 5-8 Managing DECwindows Motif Software 5.2 Using the DECW$MOTIF_TAILOR Utility to Remove Files Table 5-2 (Cont.) Classes of OpenVMS Files That Can Be Removed with the DECW$MOTIF_TAILOR __________________Utility__________________________________ Class__________Subclass_______Description__________________ DECwindows No subclasses DECwindows Motif C and C++ Motif C in this programming support files and C++ tailor class are needed only to develop programming applications and are not support files required to run DECwindows Motif applications. These files are provided for programming in C and C++ languages using conventions and standards developed at the Massachusetts Institute of Technology (MIT). Fortran files No subclasses Fortran support files are in this provided for this programming tailor class language. The files are needed only to develop applications and are not required to run DECwindows Motif applications. Pascal files No subclasses Pascal support files are in this provided for this programming tailor class language. The files are needed only to develop applications and are not required to run DECwindows Motif applications. (continued on next page) 5-9 Managing DECwindows Motif Software 5.2 Using the DECW$MOTIF_TAILOR Utility to Remove Files Table 5-2 (Cont.) Classes of OpenVMS Files That Can Be Removed with the DECW$MOTIF_TAILOR __________________Utility__________________________________ Class__________Subclass_______Description__________________ DECwindows No subclasses DECwindows Motif example Motif example in this files. files tailor class Sound files No subclasses Sound-editor support files. in this tailor class Spyglass No subclasses Spyglass Enhanced Mosaic web Enhanced in this browser. Mosaic tailor class NCSA Mosaic No subclasses NCSA Mosaic web browser. in this _______________tailor_class________________________________ ________________________ Note ________________________ The DECwindows Motif installation procedure installs Spyglass Enhanced Mosaic on OpenVMS Version 6.1 and higher, and installs NCSA Mosaic on OpenVMS versions prior to Version 6.1. ______________________________________________________ Removing DECwindows Motif Files from the System Disk To remove DECwindows Motif files from the system disk, do the following: 1. Log in to the SYSTEM account. 2. Enter the following command at the DCL prompt: $ RUN SYS$UPDATE:DECW$MOTIF_TAILOR After a brief overview, the DECW$MOTIF_TAILOR utility lists each group, or class, of files and its size in blocks. Files are grouped according to their function. For example, all the files required for DECwindows for OpenVMS device support are in one class. A file class is made up of many small subclasses. You can eliminate an entire class of files, or you can eliminate one or more of its subclasses. For example: 5-10 Managing DECwindows Motif Software 5.2 Using the DECW$MOTIF_TAILOR Utility to Remove Files CLASS - VMS DECwindows Motif applications files Size of entire class (with subclasses): 12157 Size of common files required for any subclass: 11136 Do you wish to select the entire class (default = NO)? Do you wish to select any of its subclasses (default = NO)? . . . 3. Decide which file classes or subclasses you do not need to support your system. The DECW$MOTIF_TAILOR utility displays step-by-step instructions. Follow these instructions to specify which of the classes or subclasses you want to remove. 4. The DECW$MOTIF_TAILOR utility deletes the files you select and displays the names of those files. You can ignore "file not found" messages in the log files; tailoring functions are not affected by these messages. The installation procedure deletes files that it does not read. _______________________ Caution _______________________ To cancel DECW$MOTIF_TAILOR during the first phase, press Ctrl/C, Ctrl/Y, or Ctrl/Z. If you cancel DECW$MOTIF_TAILOR during the second phase, a partially tailored disk may result. For a description of both phases, see Section 5.2. ______________________________________________________ Example 5-1 shows how to use DECW$MOTIF_TAILOR to remove files from a system disk. Example 5-1 Sample DECW$MOTIF_TAILOR Session $ RUN SYS$UPDATE:DECW$MOTIF_TAILOR . . . (continued on next page) 5-11 Managing DECwindows Motif Software 5.2 Using the DECW$MOTIF_TAILOR Utility to Remove Files Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session TAILOR-OFF ---------- You will now be prompted with a list of the classes and subclasses of DECwindows files that are optional. The size of each class and subclass is included in the list. This will help you decide whether or not you want to remove a class or subclass from your system. Under some classes there is a set of common files that is required in order for any subclasses to work. These files will only be deleted if you remove the ENTIRE class. If you choose to keep any subclass, this set of files is not deleted. NOTE: The files associated with selected classes and subclasses will be removed from your system. Total size of the system disk is 2050860 blocks. Total space used on the system disk is 684720 blocks. Total space left on the system disk is 1366140 blocks. CLASS - VMS DECwindows Runtime Support Size of entire class (with subclasses): 44853 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? CLASS - VMS DECwindows CDA Support Size of entire class (with subclasses): 5153 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? Yes CLASS - VMS DECwindows Motif applications files Size of entire class (with subclasses): 16344 Size of common files required for any subclass: 15323 Do you wish to select the entire class (default = NO)? Do you wish to select any of its subclasses (default = NO)? CLASS - DECwindows C programming support files Size of entire class (with subclasses): 6904 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? Yes (continued on next page) 5-12 Managing DECwindows Motif Software 5.2 Using the DECW$MOTIF_TAILOR Utility to Remove Files Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session CLASS - DECwindows Fortran programming support files Size of entire class (with subclasses): 2429 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? Yes CLASS - DECwindows Pascal programming support files Size of entire class (with subclasses): 3010 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? CLASS - DECwindows Motif example files Size of entire class (with subclasses): 13365 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? Yes CLASS - Spyglass Enhanced Mosaic Size of entire class (with subclasses): 4493 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? CLASS - NCSA Mosaic Size of entire class (with subclasses): 1904 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? (continued on next page) 5-13 Managing DECwindows Motif Software 5.2 Using the DECW$MOTIF_TAILOR Utility to Remove Files Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session Files have been selected Do you wish to remove all of the options selected? Do you wish to remove all of the options selected? Yes Removing files, please wait... %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[CDA$LIBRARY]DEFSTYLE.DDIF;* %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$CSW.UID;* %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEW.UID;* %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEWWGT.UID;* %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEWWGT12.UID;* %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[SYSEXE]CDA$CONVERT.EXE;* . . . %RMS-E-FNF, file not found . . . %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[VUE$LIBRARY.SYSTEM]SOUND$PROFILE.VUE$DAT;* %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[VUE$LIBRARY.SYSTEM]SOUND$VUE_STARTUP.COM;* %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[SYSLIB]DIVA$LIB_SHR.EXE;* %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[SYSLIB]DIVA$WGT_SHR.EXE;* %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[SYSMSG]DIVA$LIB_MSG.EXE;* _DW002$DKA100:$log SYSTEM logged out at 20-JAN-1995 15:04:44.24 <> 5.3 Adding DECwindows Base-Support Files If you previously chose not to install or if you removed DECwindows software, perform one of the following procedures to add DECwindows base-support files: o Reinstall the OpenVMS system, specifing that you want only DECwindows Motif support. o If you originally installed OpenVMS from a VMSINSTAL kit, use the SYS$UPDATE:DECW$TAILOR.EXE procedure to add or remove support files from the system disk.<> 5-14 Managing DECwindows Motif Software 5.3 Adding DECwindows Base-Support Files 5.3.1 Reinstalling the OpenVMS Operating System To reinstall the OpenVMS operating system to add DECwindows Motif support, perform the following steps: 1. Follow the installation procedure as described in Chapter 2 and Chapter 3. 2. When the installation procedure asks whether you want to install the entire kit, type No. The procedure displays optional parts of the kit and asks whether you want to install each part. Type Yes for each part you want to install. 3. All kit sections that you chose are displayed; you are asked to verify that the choices are correct. 4. Once you verifiy the selections, the installation procedure continues. 5.3.2 Using the SYS$UPDATE:DECW$TAILOR.EXE Command You can use the DECW$TAILOR utility to add or remove some or all DECwindows base-support files from the system disk. ________________________ Note ________________________ Use the DECW$TAILOR utility only if you installed the DECwindows Motif for OpenVMS kit using VMSINSTAL. ______________________________________________________ DECW$TAILOR is similar to DECW$MOTIF_TAILOR. However, the DECW$TAILOR utility is used to add or remove files that support the DECwindows display server (for example: base- support, workstation, and font files). DECW$TAILOR includes three phases: o The first phase asks whether you want to tailor your system by adding files ("tailor on") or by deleting files ("tailor off"). o In the second phase, if you choose the tailor-on procedure, DECW$TAILOR lists each class of DECwindows files and asks whether you want to include them on the system disk. If you choose the tailor-off procedure, DECW$TAILOR lists each class of DECwindows files and asks whether you want to delete them from the system disk. 5-15 Managing DECwindows Motif Software 5.3 Adding DECwindows Base-Support Files o In the third phase, DECW$TAILOR carries out your instructions. ________________________ Note ________________________ To cancel DECW$TAILOR during the first and second phases, press Ctrl/C, Ctrl/Y, or Ctrl/Z. If you cancel DECW$TAILOR during the third phase, a partially tailored disk may result. To tailor the OpenVMS operating system, run SYS$UPDATE:VMSTAILOR. ______________________________________________________ Table 5-3 lists the classes and subclasses of DECwindows files that you can add or remove from your system using DECW$TAILOR. Table 5-3 Classes of Files That Can Be Added or Removed __________with_the_DECW$TAILOR_Utility_____________________ Class__________Subclass_______Description__________________ DECwindows No subclasses Files necessary to run the base support in this DECwindows Motif client and files tailor class DECwindows display server. DECwindows PEX for PHIGS Files necessary to run the workstation support files DECwindows display server; support files the PEX subclass includes support files for three- dimensional graphics. 75-dpi video No subclasses Device support files for font files in this 75-dpi monitiors. tailor class 100-dpi video No subclasses Device support files for font files in this 100-dpi monitors. _______________tailor_class________________________________ Adding DECwindows Files to the System Disk To add DECwindows files to the system disk, perform the following steps: 1. Log in to the SYSTEM account. 5-16 Managing DECwindows Motif Software 5.3 Adding DECwindows Base-Support Files 2. Enter the following command at the DCL prompt to invoke the utility: $ RUN SYS$UPDATE:DECW$TAILOR After a brief overview, the DECW$TAILOR program lists each group, or class, of files and its size in blocks. Files are grouped according to their function. For example, all the files required for DECwindows base support are in one class. A file class is made up of many small subclasses. You can eliminate an entire class of files, or you can eliminate one or more of its subclasses. For example: CLASS - DECwindows workstation support files Size of entire class (with subclasses): 12380 Size of common files required for any subclass: 8919 Do you wish to select the entire class (default = NO)? Do you wish to select any of its subclasses (default = NO)? . . . 3. Decide which file classes or subclasses are needed to support your system. DECW$TAILOR displays step-by-step instructions. Follow these instructions to specify which of the classes or subclasses you want to add. 4. DECW$TAILOR creates a temporary command file and asks for the name of the device that contains the distribution media. ________________________ Note ________________________ The distribution media is the OpenVMS distribution media that contains the DECwindows save sets. ______________________________________________________ 5. DECW$TAILOR adds the files you selected and displays the names of those files. _______________________ Caution _______________________ To cancel DECW$TAILOR during the first phase, press Ctrl/C, Ctrl/Y, or Ctrl/Z. If you cancel DECW$TAILOR 5-17 Managing DECwindows Motif Software 5.3 Adding DECwindows Base-Support Files during the second phase, a partially tailored disk may result. ______________________________________________________ Example 5-2 shows how to use DECW$TAILOR to add files to a system disk. Example 5-2 Sample DECW$TAILOR Session $ RUN SYS$UPDATE:DECW$TAILOR . . . Do you want to tailor files "ON" or "OFF"? ON TAILOR-ON --------- You will now be prompted with a list of the classes and subclasses of DECwindows files that are optional. The size of each class and subclass is included in the list. This will help you decide whether or not you want to add a class or subclass to your system. Under some classes, there is a set of common files that is required in order for any subclasses to work. These files are added when you ask for either the entire class or any of its subclasses. Total size of the system disk is 1216665 blocks. Total space used on the system disk is 1121958 blocks. Total space left on the system disk is 94707 blocks. CLASS - DECwindows base support files Size of entire class (with subclasses): 3110 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? YES CLASS - DECwindows workstation support files Size of entire class (with subclasses): 12380 Size of common files required for any subclass: 8919 Do you wish to select the entire class (default = NO)? Do you wish to select any of its subclasses (default = NO)? (continued on next page) 5-18 Managing DECwindows Motif Software 5.3 Adding DECwindows Base-Support Files Example 5-2 (Cont.) Sample DECW$TAILOR Session CLASS - 75 dots/inch video font files Size of entire class (with subclasses): 4538 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? CLASS - 100 dots/inch video font files Size of entire class (with subclasses): 3693 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? Files have been selected Do you wish to add all of the options selected? YES Creating temporary command file, please wait... * Enter device containing DECwindows distribution media: . . . <> 5.4 Determining and Reporting Problems If you encounter a problem while using DECwindows Motif, review the Software Product Description (SPD) and Warranty Addendum for an explanation of the warranty. If you encounter a problem during the warranty period, use the following methods to report the problem or follow alternate instructions provided by Digital for reporting problems: o Call Digital if your software contract or warranty agreement includes telephone support. o Submit a Software Performance Report (SPR). o If you discover a problem with or have comments about the documentation, print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by Internet, fax, or mail. (See the Reader's Comments section in the Preface for addresses.) 5-19 A _________________________________________________________________ POLYCENTER Software Installation Utility Sample Installations Example A-1 in this appendix presents a sample DECwindows Motif installation on an OpenVMS Alpha Version 7.0 operating system using the POLYCENTER Software Installation utility. Example A-2 presents a sample DECwindows Motif installation on an OpenVMS VAX Version 6.1 operating system. Refer to Chapter 2 for details about using the POLYCENTER Software Installation utility to install DECwindows Motif Version 1.2-4 for OpenVMS software. Refer to Section B.1 to see a sample registration of a DECwindows Motif Version 1.2-4 for OpenVMS PAK. Example A-1 Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS Alpha System Welcome to the OpenVMS Alpha Operating System, Version 7.0 $ @PRODUCT INSTALL DWMOTIF DECwindows Motif V1.2-4 for OpenVMS installation procedure Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. **** Supported OpenVMS Version 7.0 DETECTED **** (continued on next page) A-1 POLYCENTER Software Installation Utility Sample Installations Example A-1 (Cont.) Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS Alpha System **** DECwindows Motif application and run-time support files DETECTED **** **** DECwindows device support files DETECTED **** 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. Do you want the New Desktop to be your default desktop ([Y]/N)? Yes The installation of DECwindows Motif Version 1.2-4 on systems with OpenVMS Alpha Version 6.2 (or higher) will require a system reboot after this installation if the DECwindows shareable images have previously been installed using the share=address_data qualifier. Images which have been installed using the share=address_data qualifier cannot be replaced by simply using the DCL install replace command. CAUTION: If you answer no and images were previously installed using the share=address_data qualifier your system may contain a mixture of old and new shareable images after the installation. (continued on next page) A-2 POLYCENTER Software Installation Utility Sample Installations Example A-1 (Cont.) Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS Alpha System NOTE: It is possible to overide the installation of DECwindows images by defining the DECW$IGNORE_SHARE_ADDRESS logical to True. If this logical is defined the images will be installed normally without using the share=address_data qualifier. Disabling this qualifier will result in slower performance and increased memory usage by the DECwindows shareable images. Will you allow a system reboot after this product is installed? Yes NOTE: DECwindows Motif will not start if your system parameters are not set correctly. o If you allow a system shutdown, the installation procedure reboots the system at the end of the installation. If your system parameters are incorrect, the installation runs AUTOGEN prior to the system reboot. o If you do not allow a system shutdown, the installation procedure continues; you are informed at the end of the installation whether you need to modify your system parameters to start DECwindows Motif. Will you allow a system reboot after this product is installed? Yes To answer the following question, enter the directory specification of the DECwindows Motif for OpenVMS POLYCENTER Software Installation utility kit. Answer the following question with the location of the DECwindows Motif for OpenVMS PCSI kit. Where is the PCSI kit located? DAD1:[000000] The following product has been selected: DEC AXPVMS DWMOTIF V1.2-4 [Available] Do you want to continue? [YES] *** DEC AXPVMS DWMOTIF V1.2-4: DECwindows Motif Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Digital Equipment Corporation (continued on next page) A-3 POLYCENTER Software Installation Utility Sample Installations Example A-1 (Cont.) Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS Alpha System This product uses the PAK: DW-MOTIF Do you want all the default values for this product? [YES] No *** DEC AXPVMS VMS V7.0 [Available] %PCSIUI-I-ALRDYINST, product already installed; use RECONFIGURE to modify DECwindows Motif runtime support files [YES] Desktop Support [YES] Do you want all the defaults for the subitems? [YES] No New Desktop [YES] Do you want all the defaults for the subitems? [YES] No Manual (reference) pages for the New Desktop [YES] DECwindows Desktop [NO] Programming Support [YES] Do you want all the defaults for the subitems? [YES] No 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] Do you want all the defaults for the subitems? [YES] No Sound example files [YES] Programming examples for the DECwindows [YES] Programming examples for the New Desktop [YES] Translated Image Support (OSF/Motif V1.1.3) [YES] Do you want to view the values? [NO] Yes (continued on next page) A-4 POLYCENTER Software Installation Utility Sample Installations Example A-1 (Cont.) Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS Alpha System DEC AXPVMS DWMOTIF V1.2-4: DECwindows Motif DEC AXPVMS VMS V7.0 [Available] DECwindows Motif runtime support files: YES Desktop Support: YES New Desktop: YES Manual (reference) pages for the New Desktop: YES DECwindows Desktop: NO Programming Support: 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 the DECwindows: YES Programming examples for the New Desktop: YES Translated Image Support (OSF/Motif V1.1.3): YES Are you satisfied with the values? [YES] %PCSIUI-I-DONEASK, execution phase starting The following product will be installed: DEC AXPVMS DWMOTIF V1.2-4 %PCSI-I-VOLINFO, estimated space information for volume DISK$DISK1 -PCSI-I-VOLSPC, 13009 required; 641884 available; 628875 net Portion Done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% ...100% The following product has been installed: (continued on next page) A-5 POLYCENTER Software Installation Utility Sample Installations Example A-1 (Cont.) Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS Alpha System DEC AXPVMS DWMOTIF V1.2-4 If you wish to use any language other than English, install the appropriate DECwindows Motif Version 1.2-4 language variant product after this installation has completed. Run the Installation Verification Procedure (IVP) after the installation is completed and DECwindows Motif is restarted. The IVP is located in the following directory: SYS$TEST:DECW$IVP.COM. Checking to see if your system parameters are set correctly.... The installation procedure has determined that your system parameters set correctly and that it will not be necessary to run AUTOGEN or reboot the system. If your system is already running DECwindows Motif, restart DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP RESTART If your system is NOT already running DECwindows Motif, start DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP * * * N O T E * * * If you are installing DECwindows Motif from your workstation console, log off after you enter the command to start DECwindows Motif. @SYS$MANAGER:DECW$STARTUP RESTART Restarting the DECwindows Software stops everything displaying on your workstation. Do you really want to restart the DECwindows Software? Yes Restarting DECwindows Software, server 0. Please wait. %RUN-S-PROC_ID, identification of created process is 00000067 $ Logout (continued on next page) A-6 POLYCENTER Software Installation Utility Sample Installations Example A-1 (Cont.) Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS Alpha System SYSTEM logged out at 26-MAR-1996 13:39:17.75 Example A-2 Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS VAX System Welcome to the OpenVMS VAX Operating System, Version 6.1 $ @PRODUCT INSTALL DWMOTIF DECwindows Motif V1.2-4 for OpenVMS installation procedure Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. **** Supported OpenVMS Version 6.1 DETECTED **** **** DECwindows Motif application and run-time support files DETECTED **** **** DECwindows device support files DETECTED **** Will you allow a system reboot after this product is installed? No NOTE: DECwindows Motif will not start if your system parameters are not set correctly (continued on next page) A-7 POLYCENTER Software Installation Utility Sample Installations Example A-2 (Cont.) Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS VAX System o If you allow a system shutdown, the installation procedure reboots the system at the end of the installation. If your system parameters are incorrect, the installation runs AUTOGEN prior to the system reboot. o If you do not allow a system shutdown, the installation procedure continues; you are informed at the end of the installation whether you need to modify your system parameters to start DECwindows Motif. To answer the following question, enter the directory specification of the DECwindows Motif for OpenVMS POLYCENTER Software Installation utility kit. Where is the PCSI kit located? DISK1:[000000] The following product has been selected: DEC VAXVMS DWMOTIF V1.2-4 [Available] Do you want to continue? [YES] *** DEC VAXVMS DWMOTIF V1.2-4: DECwindows Motif Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Digital Equipment Corporation This product uses the PAK: DW-MOTIF Do you want all the default values for this product? [YES] No DECwindows Motif runtime support files [YES] Programming Support (C Language) [YES] Fortran programming support [YES] PASCAL programming support [YES] Programming examples [YES] Do you want to view the values? [NO] Yes (continued on next page) A-8 POLYCENTER Software Installation Utility Sample Installations Example A-2 (Cont.) Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS VAX System DEC VAXVMS DWMOTIF V1.2-4: DECwindows Motif [Available] DECwindows Motif runtime support files: YES Programming Support (C Language): YES Fortran programming support: YES PASCAL programming support: YES Programming examples: YES Are you satisfied with the values? [YES] %PCSIUI-I-DONEASK, execution phase starting The following product will be installed: DEC VAXVMS DWMOTIF V1.2-4 The following product will be removed: DEC VAXVMS DWMOTIF V1.2-3 %PCSI-I-VOLINFO, estimated space information for volume DISK$VAXVMS552 -PCSI-I-VOLSPC, 46 required; 84294 available; 84248 net Portion Done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% ...100% The following product has been installed: DEC VAXVMS DWMOTIF V1.2-4 If you wish to use any language other than English, install the appropriate DECwindows Motif Version 1.2-4 language variant product after this installation has completed. Run the Installation Verification Procedure (IVP) after the installation is completed and DECwindows Motif is restarted. The IVP is located in the following directory: SYS$TEST:DECW$IVP.COM. (continued on next page) A-9 POLYCENTER Software Installation Utility Sample Installations Example A-2 (Cont.) Sample Installation Using the POLYCENTER Software Installation Utility on an OpenVMS VAX System Checking to see if system parameters are set correctly.... The installation procedure has determined that your system parameters are set correctly and that it will not be necessary to run AUTOGEN or reboot the system. If your system is already running DECwindows Motif, restart DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP RESTART If your system is NOT already running DECwindows Motif, start DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP * * * N O T E * * * If you are installing DECwindows Motif from your workstation console, log off after you enter the command to start DECwindows Motif. The installation procedure has determined that your system parameter values are acceptable. A reboot of the system is not required. $ Logout SYSTEM logged out at 26-MAR-1996 14:05:00.7 A-10 B _________________________________________________________________ VMSINSTAL Sample Installation This appendix contains a sample Product Authorization Key (PAK) registration and a product installation. B.1 Sample Product Authorization Key Registration Example B-1 contains a sample registration of a DECwindows Motif Version 1.2-4 for OpenVMS PAK. Example B-1 Sample Product Authorization Key Registration $ @SYS$UPDATE:VMSLICENSE.COM VMS License Management Utility Options: 1. REGISTER a Product Authorization Key 2. AMEND an existing Product Authorization Key 3. CANCEL an existing Product Authorization Key 4. LIST the Product Authorization Keys 5. MODIFY an existing Product Authorization Key 6. DISABLE an existing Product Authorization Key 7. DELETE an existing Product Authorization Key 8. COPY an existing Product Authorization Key 9. MOVE an existing Product Authorization Key 10. ENABLE an existing Product Authorization Key 11. SHOW the licenses loaded on this node 12. SHOW the unit requirements for this node 99. EXIT this procedure Type '?' at any prompt for a description of the information requested. Press Ctrl/Z at any prompt to exit this procedure. Enter one of the above choices [1] Do you have your Product Authorization Key? [Yes] (continued on next page) B-1 VMSINSTAL Sample Installation B.1 Sample Product Authorization Key Registration Example B-1 (Cont.) Sample Product Authorization Key Registration The REGISTER option allows you add a new license to a license database. A Product Authorization Key (PAK) provides the product name and information you need to register the license. You must enter all the information provided by your PAK exactly as specified. PAK ID: Issuer [DEC] Authorization Number [] LAB030419 PRODUCT ID: Product Name [] DW-MOTIF Producer [DEC] NUMBER OF UNITS: Number of Units [] 400 KEY LEVEL: Version [] PRODUCT RELEASE DATE: [] KEY TERMINATION DATE: Key Termination Date [] RATING: Availability Table Code [] H Activity Table Code [] MISCELLANEOUS: Key Options [] Product Token [] Hardware-Id [] Checksum [] 2-fbic-odnh-enwj-lled (continued on next page) B-2 VMSINSTAL Sample Installation B.1 Sample Product Authorization Key Registration Example B-1 (Cont.) Sample Product Authorization Key Registration License Database File: SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB Issuer: DEC Authorization: LAB030419 Producer: DEC Product Name: DW-MOTIF Units: 400 Date: Version: Termination Date: Availability: H Activity: Options: Token: Hardware ID: Checksum: 2-FBIC-ODNH-ENWJ-LLED Is this information correct? [Yes] Registering DW-MOTIF license in SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB... Do you want to LOAD this license on this system? [Yes] %LICENSE-I-LOADED, DEC DW-MOTIF was successfully loaded with 400 units VMS License Management Utility Options: 1. REGISTER a Product Authorization Key 2. AMEND an existing Product Authorization Key 3. CANCEL an existing Product Authorization Key 4. LIST the Product Authorization Keys 5. MODIFY an existing Product Authorization Key 6. DISABLE an existing Product Authorization Key 7. DELETE an existing Product Authorization Key 8. COPY an existing Product Authorization Key 9. MOVE an existing Product Authorization Key 10. ENABLE an existing Product Authorization Key 11. SHOW the licenses loaded on this node 12. SHOW the unit requirements for this node 99. EXIT this procedure Type '?' at any prompt for a description of the information requested. Press Ctrl/Z at any prompt to exit this procedure. (continued on next page) B-3 VMSINSTAL Sample Installation B.1 Sample Product Authorization Key Registration Example B-1 (Cont.) Sample Product Authorization Key Registration Enter one of the above choices [1] 99 $ B-4 VMSINSTAL Sample Installation B.2 Sample Installation Using VMSINSTAL on an OpenVMS VAX System B.2 Sample Installation Using VMSINSTAL on an OpenVMS VAX System Example B-2 contains a sample installation of the DECwindows Motif Version 1.2-4 for OpenVMS software on an OpenVMS VAX Version 5.5-2 operating system using the VMSINSTAL procedure. The sample installation assumes that no users are logged in to the system and that you specified OPTIONS N to display the release notes. Example B-2 Sample Installation Using VMSINSTAL $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU4012 VAX/VMS Software Product Installation Procedure V5.5-2 It is 26-MAR-1996 at 10:36. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? * Where will the distribution volumes be mounted: DAD2:[000000] Enter the products to be processed from the first distribution volume set. * Products: dwmotifvaxu4012 * Enter installation options you wish to use (none): The following products will be processed: DWMOTIFVAXU4 V1.2 Beginning installation of DWMOTIFVAXU4 V1.2 at 10:36 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. *** Installing DECwindows Motif for OpenVMS VAX software *** Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. (continued on next page) B-5 VMSINSTAL Sample Installation B.2 Sample Installation Using VMSINSTAL on an OpenVMS VAX System Example B-2 (Cont.) Sample Installation Using VMSINSTAL This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. You can install the DECwindows Motif kit completely or in selected portions. A complete installation requires as many as 68,400 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 [Y]? No 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 [Y]? Support files are supplied for the following OpenVMS programming languages: Fortran, Pascal In addition, support files are supplied for programming in the C language using conventions and standards developed at the Massachusetts Institute of Technology. * Do you want to install all programming language support files [Y]? * Do you want to install DECwindows Motif programming examples [Y]? You have selected the following portions of the kit: o DECwindows Motif Applications and Run-time Libraries o DECwindows Motif programming examples o DECwindows Motif programming support Fortran, Pascal MIT C language programming conventions * Are these selections correct [Y]? (continued on next page) B-6 VMSINSTAL Sample Installation B.2 Sample Installation Using VMSINSTAL on an OpenVMS VAX System Example B-2 (Cont.) Sample Installation Using VMSINSTAL A registered and loaded product authorization key for DW-MOTIF is required to run any DECwindows Motif for OpenVMS application. If you answer NO to the next question, the installation of DECwindows Motif for OpenVMS will be terminated. Product: DW-MOTIF Producer: DEC Version: Release Date: * Does this product have an authorization key registered and loaded? Yes DECwindows Motif will not start if your system parameters are not correct. o If you allow a system shutdown, the installation procedure will reboot the system at the end of the installation. If your system parameters are incorrect, the installation will run AUTOGEN prior to the system reboot. o If you do not allow a system shutdown, the installation procedure will continue, and you will be informed at the end of the installation whether you need to modify your system parameters in order to start DECwindows Motif. To complete the installation of this product, you should reboot the system. If it is not convenient to reboot at this time, then enter NO to the following question. If you enter NO, the installation procedure will continue. * Will you allow a system shutdown after this product is installed [YES]? No No further questions will be asked. (continued on next page) B-7 VMSINSTAL Sample Installation B.2 Sample Installation Using VMSINSTAL on an OpenVMS VAX System Example B-2 (Cont.) Sample Installation Using VMSINSTAL %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set F ... %VMSINSTAL-I-RESTORE, Restoring product save set G ... %VMSINSTAL-I-RESTORE, Restoring product save set H ... %VMSINSTAL-I-RESTORE, Restoring product save set I ... %VMSINSTAL-I-RESTORE, Restoring product save set J ... %VMSINSTAL-I-RESTORE, Restoring product save set L ... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... You may safely ignore the following NCP error message(s): %NCP-I-SUCCESS, Success Object = X$X0 %NML-I-RECDELET, Database entry deleted The Installation Verification Procedure (IVP) should be run after the installation has been completed and DECwindows Motif has been restarted. The IVP can be found in SYS$TEST:DECW$IVP.COM. The installation procedure has determined that your system parameters are set correctly and that it will not be necessary to run AUTOGEN or reboot the system. If your system is already running DECwindows Motif, restart DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP RESTART If your system is NOT already running DECwindows Motif, start DECwindows Motif with the following DCL command: $ @SYS$MANAGER:DECW$STARTUP * * * N O T E * * * If you are installing DECwindows Motif from your workstation console, log off after you enter the command to start DECwindows Motif. The installation procedure has determined that your system parameter values are acceptable. A reboot of the system is not required. (continued on next page) B-8 VMSINSTAL Sample Installation B.2 Sample Installation Using VMSINSTAL on an OpenVMS VAX System Example B-2 (Cont.) Sample Installation Using VMSINSTAL Installation of DWMOTIFVAXU4 V1.2 completed at 10:57 Enter the products to be processed from the next distribution volume set. * Products: VMSINSTAL procedure done at 12:45 B-9 C _________________________________________________________________ Software Components If you installed DECwindows Motif Version 1.2-4 for OpenVMS using the POLYCENTER Software Installation utility, you can obtain a list of all installed files and the directories and subdirectories into which the files were installed. To obtain this list, enter the following POLYCENTER Software Installation utility command: $ PRODUCT SHOW OBJECT/product=dwmotif Following is a sample output from this command. OBJECT OBJECT TYPE ------ ----------- [000000] directory [000000]DEC-AXPVMS-DWMOTIF-V0102-4-1.PCSI$DESCRIPTION file [000000]DEC-AXPVMS-DWMOTIF-V0102-4-1.PCSI$TLB file [CDA$LIBRARY] directory [CDA$LIBRARY]CL_DAY.DOC_STYLE file [CDA$LIBRARY]DEFSTYLE.DDIF file [CDE$DEFAULTS] directory [CDE$DEFAULTS] directory [CDE$DEFAULTS.SYSTEM] directory [CDE$DEFAULTS.SYSTEM] directory [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS] directory [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C] directory [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DT.DAT file [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCALC.DAT file [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCREATE.DAT file [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTFILE.DAT file [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTHELLO.DAT file C-1 _________________________________________________________________ Index A AWD option _______________________________ specifying (cont'd) Account quotas variables, 3-4 See also Quotas using required for installation, with fewer than required 1-8 free blocks, 3-3 Alternate working device See AWD option B______________________________ Alternative console Backup See Console backing up a system disk, ASTLM parameter 1-18 required quota for confirming system backup, installation, 1-8 3-8 AUTHORIZE utility Base kit using to change Quotas, 1-8 required disk space, 1-9 AUTOGEN utility BIOLM parameter invoking during installation, required quota for 2-22, 3-19 installation, 1-8 preparing for installation, Blocks 1-13 See Free blocks rebooting the system, 1-17 Bookreader using to change system copying customized files to parameters, 1-16 another directory, 1-7 AWD option saving customized files, 1-7 installing, 3-7 Booting lacking sufficient disk space DECwindows Motif for OpenVMS, , 3-15 4-1 restarting the installation, standalone systems, 4-3 3-14 BYTLM parameter specifying required quota for another storage disk, 3-3 installation, 1-8 command line, 3-4 directory, 3-3 Index-1 DECwindows X11 Display server C______________________________ customizing startup, 5-1 CDE, 1-17 Desktop CLISYMTBL selecting, 1-17, 2-11 See also PCSI_INSTALLATION.COM Device name procedure AWD verifying values during ddcu, 3-7 installation, 2-8 source drive Components ddcu, 3-7 DECwindows X11 display specifying for installation, server, fonts, device 3-5 Device-support files drivers, 1-4 tailoring on to the system, operating system 1-5 DECwindows transports and DFS-mounted disk base-system support, determining free disk space, 1-4 3-4 Console for AWD, 3-4 alternative, 4-7 on the system disk, 3-4 main, 4-7 DIOLM parameter Copyright information required quota for displaying with the installation, 1-8 POLYCENTER Software Disk space Installation utility, determining 2-14, 2-18 amount, 1-9 Customize number of free blocks, system after installation, 1-9 5-1 on the DFS-mounted AWD, 3-4 Customizing required Bookreader files by component, 1-9 saving, 1-7 verifying, 3-14 Distributed File Service (DFS) D______________________________ See DFS-mounted disk DECW$MOTIF_TAILOR utility Distribution media overview, 5-7 mounting, 3-8 removing files from a system disk, 5-10 E______________________________ using the utility, 2-9 ENQLM parameter DECW$TAILOR utility required quota for adding base support files to installation, 1-8 a system disk, 5-16 Error recovery, 3-22 overview, 5-15 Example programs tailoring on DECwindows base required disk space, 1-9 support files, 1-4 using, 5-15 Index-2 Installation requirements, F______________________________ 1-8, 3-2 Facility name, 3-5 Installation Verification Files Procedure adding DECwindows files, See IVP 5-14 Insufficient quotas FILLM parameter See Error recovery required quota for IVP installation, 1-8 notification during product Free blocks installation, 3-19 determining amount, 1-9 running Free global pages after starting the product calculating, 1-14 , 4-5 required, 1-14 procedure, 3-19 Free global sections calculating, 1-14 K required, 1-14 _______________________________ Keyboard G______________________________ customizing layout, 5-3 GBLPAGES model number, 5-3 See also PCSI_INSTALLATION.COM Keymap names determining, 5-4 procedure list, 5-4 verifying values during Kit installation, 2-8 installing, 3-12 Global pages loading distribution media, See Free global pages 3-6 Global sections preserving OSF/Motif Release See Free global sections 1.1.3, 3-11 H L______________________________ _______________________________ Language variants Hardware installing, 2-10 supported by DECwindows Motif Languages , 1-3 installing, 3-13 I License registration, 1-2 _______________________________ sample PAK registration, B-1 Installation name verifying, 3-15 See Facility name Logging out Installation procedure notifying users, 1-18, 2-3 completing, 3-21 Index-3 PCSI_INSTALLATION.COM M______________________________ procedure Magnetic tape checking (cont'd) installation procedure, 3-7 programming environment, Main console, 4-7 2-10 Memory requirements, 1-4 supported versions, 2-7 Monitor displaying 100 dpi, 5-2 copyright notice, 2-7 Monochrome workstations, 5-3 installation progress, 2-6 N______________________________ language variants, 2-10 NET-APP-SUP-250 license, 2-14, status information, 2-21 2-18, 3-16 GBLPAGES, 2-8 NET-APP-SUP-300 license, 2-14, rebooting 2-18, 3-16 system, 2-20 New Desktop rebooting the system, 2-12, selecting, 1-17, 2-11 2-17 North American keyboard layout verifying , 5-2 applications and run-time Notifying network users support files, 2-8 before installation, 2-3 device support files, 2-9 values for GBLPAGES and O CLISYMTBL, 2-8 _______________________________ POLYCENTER Software Operating system prerequisites Installation utility using the POLYCENTER Software See also PCSI_INSTALLATION.COM Installation utility, 1-3 procedure Operator window, 4-7 accessing DCL help, 2-2 P backing up the system disk, _______________________________ 2-2 Page file size confirming your responses to setting, 1-15 questions, 2-4 PAK registration, B-1 displaying See also License registration copyright information, Parameters 2-18 See System parameters displaying copyright PCSI_INSTALLATION.COM information, 2-14 procedure extracting the release notes, See also POLYCENTER Software 2-3 Installation utility location of kits, 2-5 checking notifying users, 2-3 incorrect system OpenVMS Alpha and VAX product parameters, 2-12, 2-16 kit names, 2-5 Index-4 POLYCENTER Software Programming Installation utility environment (cont'd) (cont'd) installing support files, phases of the installation 3-12 command procedure, 2-5 preserving, 3-11 prerequisites for saving, 2-10 installation, 1-3 examples rebooting the system, 2-12, installing, 3-13 2-16 support responding to questions compatibililty in the during installation, 2-4 XUI and OSF/Motif running the installation environments, 1-5 command procedure, 2-5 OSF/Motif Release 1.1.3, selecting the desktop, 2-11 1-5 using the installation command procedure, 2-5 Q______________________________ Postinstallation Quotas, 3-4 determining and reporting minimum required for problems, 5-19 installation, 1-8 tasks verifying and changing, 1-8 customizing DECwindows Motif, 5-1 R______________________________ Postinstallation tasks, 4-1 Rebooting the system, 2-12, choosing and alternative 2-16, 3-16 console, 4-7 Release notes running the IVP, 4-5 accessing, 3-9, 3-22 starting DECwindows software, POLYCENTER Software 4-1 Installation utility, Prerequisite software 2-3 using the POLYCENTER Software VMSINSTAL procedure, 3-6 Installation utility, 1-3 displaying, 3-9, 3-10, 3-22 Privileges extracting to a file required for installation, POLYCENTER Software 3-2 Installation utility, Product Authorization Key 2-3 See PAK registration options, 3-9 Product name printing, 3-9, 3-10, 3-22 specifying for installation, specifying OPTIONS N, 3-6 3-5 Programming environment disk space requirements, 1-9 installing, 3-12, 3-13 Index-5 System Generation utility S______________________________ See SYSGEN utility Selecting a desktop, 1-17 System parameters Server startup adding customizing, 5-1 new parameters, 1-16 /SHARE=ADDRESS_DATA qualifier, changing 2-12 by using the AUTOGEN Shutting down the system utility, 1-16 notifying users, 1-18, 2-3 values, 1-16 Software checking required operating system values, 1-13 version, 1-4 minimum required, 1-11 Starting DECwindows Motif, 4-1 modifying on boot nodes, 4-3 incremental adjustments, on nonsatellites, 4-3 1-16 on satellites, 4-4 recalculating, 1-17 on standalone systems, 4-3 reset by AUTOGEN, 3-20 on VMScluster systems, 4-3 setting WINDOW_SYSTEM, 4-1 SYSGEN utility checking system parameter T______________________________ values, 1-13 Tailoring utilities preparing for installation, See also DECW$MOTIF_TAILOR 1-13 utility System See also DECW$TAILOR utility shutdown tailoring on device-support notifying users, 1-18, files, 1-5 2-3 Translated-image support tuning, 5-1 required disk space, 1-9 SYSTEM account, 3-6 Tuning the system, 5-1 System disk adding DECwindows base support files, 5-14 V______________________________ backing up, 2-2, 3-8 VMSINSTAL procedure customizing backing up the system disk, DECW$MOTIF_TAILOR utility, 3-1 5-10 changing selections, 3-13 DECW$TAILOR utility, 5-16 copying the release notes to determining SYS$HELP, 3-10 number of free blocks, displaying release notes, 1-9 3-9 free space required for entering directory installation, 1-9, 3-14 specifications, 3-8 entering product name, 3-8 installing entire kit, 3-12 Index-6 VMSINSTAL procedure running the Installation installing (cont'd) Verification Procedure programming examples, (IVP), 3-19 3-13 specifying incorrect name for listing directories and save the source drive, 3-7 sets, 3-17 specifying product name, 3-6 locating the VMSINSTAL.COM starting the installation, file, 3-6 3-6 mounting distribution volumes stopping the installation, , 3-8 3-5 preserving the programming using the AWD option, 3-7 environment, 3-11 rebooting the system, 3-16 W______________________________ registering and installing Window operator, 4-7 the Product Authorization WINDOW_SYSTEM system parameter Key (PAK), 3-1 setting, 4-1 reselecting options, 3-15 Workstations, 5-3 Index-7