hp DECwindows Motif for_hp_OpenVMS_Alpha________________________________ Installation Guide Order Number: AA-RT26A-TE February 2003 This manual provides step-by-step instructions for installing HP DECwindows Motif for HP OpenVMS Alpha Version 1.3. Revision/Update Information: This manual supersedes the DECwindows Motif Version 1.2-6 for OpenVMS Installation Guide. Operating System: HP OpenVMS Alpha Version 7.3-1 Software Version: HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 Hewlett-Packard Company Palo Alto, California ________________________________________________________________ © 2003 Hewlett-Packard Development Company, L.P. Motif, OSF/1, UNIX, and the "X" device are registered trademarks and The Open Group is a trademark of The Open Group in the U.S. and other countries. Confidential computer software. Valid license from HP and/or its subsidiaries required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Neither HP nor any of its subsidiaries shall be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. ZK6434 The HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 documentation set is available on CD-ROM. _________________________________________________________________ Contents Preface................................................... vii 1 Preparing to Install the Software 1.1 License Registration.......................... 1-2 1.2 Supported Hardware............................ 1-2 1.3 Prerequisites for the Installation Procedures.................................... 1-3 1.4 Required Operating System Software............ 1-3 1.5 OSF/Motif Release 1.1.3 and XUI Programming Support....................................... 1-5 1.6 Saving Customized Bookreader Files............ 1-6 1.7 Installation Procedure Requirements........... 1-7 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 Number 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 Backing Up Your System Disk............... 1-18 1.7.6 Notifying Other Users..................... 1-18 iii 2 Using the POLYCENTER Software Installation Utility 2.1 Accessing Help Information.................... 2-2 2.2 Extracting and Printing the Product Release Notes......................................... 2-3 2.3 Installing the DECwindows Motif Software...... 2-5 2.3.1 Starting the Installation................. 2-5 2.3.2 The Installation Dialog................... 2-6 2.3.2.1 Verifying Sufficient Allocation for the GBLPAGES and CLISYMTBL Values........... 2-7 2.3.2.2 Running AUTOGEN......................... 2-8 2.3.2.3 Saving the Programming Environment...... 2-9 2.3.2.4 Default Installation.................... 2-9 2.3.2.5 Installation of Server Software......... 2-10 2.3.2.6 Euro Currency Sign Support.............. 2-10 2.3.2.7 LBX Proxy Installation.................. 2-11 2.3.2.8 Selecting Installation of Client Software................................ 2-11 2.3.2.9 Asking About Selecting a Desktop........ 2-11 2.3.2.10 Programming Language Support Options.... 2-13 2.3.2.11 Translated Image Support................ 2-14 2.3.2.12 Language Variants Notice................ 2-14 2.3.2.13 Reviewing the Installation Options...... 2-14 2.3.2.14 Execution Dialog........................ 2-15 2.3.2.15 Verifying DECwindows Motif Support Files................................... 2-16 2.3.2.16 Reviewing Final Installation Notes...... 2-17 2.4 Recovering from Errors........................ 2-18 2.5 Adjusting Parameters After Installation....... 2-18 3 After Installing the Software 3.1 Starting the DECwindows Motif Software........ 3-1 3.2 Running the IVP............................... 3-2 3.3 Choosing an Alternate Console................. 3-4 3.4 Selecting the Desktop......................... 3-5 iv 4 Managing DECwindows Motif Software 4.1 Customizing the DECwindows X11 Display Server Startup Procedure............................. 4-2 4.2 Determining and Reporting Problems............ 4-3 A POLYCENTER Software Installation Utility Sample Installation A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System.......................... A-2 B Software Components Index Examples 3-1 Sample IVP................................ 3-3 A-1 Sample Installation of an Upgrade of the DECwindows Motif Software on an OpenVMS Alpha Version 7.3-1 System With Sufficient System Resources.......................... A-2 Tables 1-1 DECwindows Motif Support Options for OpenVMS................................... 1-4 1-2 Directories for Previous XUI or OSF/Motif Programming Environments.................. 1-5 1-3 Process Quotas for the Installation Account................................... 1-8 1-4 Required Disk Space by Component (in Blocks)................................... 1-10 1-5 Minimum Required System Parameter Values.................................... 1-11 1-6 Required Number of Contiguous Free Global Pages and Free Global Sections............ 1-15 1-7 Recommended System Parameter Values to Use with the ADD_ Option...................... 1-17 v _________________________________________________________________ Preface Intended Audience This manual is intended for anyone who plans to install the HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software. Document Structure This manual contains the following chapters and appendixes: o Chapter 1 discusses how to prepare for installing DECwindows Motif software. o Chapter 2 discusses how to install DECwindows Motif using the POLYCENTER Software Installation utility. o Chapter 3 provides startup procedures. This chapter also includes a sample Installation Verification Procedure (IVP). o Chapter 4 discusses customizing the environment, and reporting errors. o Appendix A presents a sample DECwindows Motif installation using the POLYCENTER Software Installation utility on an OpenVMS Alpha Version 7.3-1 system. o Appendix B shows how to obtain a list of the software components for the DECwindows Motif product using the POLYCENTER Software Installation utility. vii Related Documents In addition to this manual, the following documents are useful when installing the DECwindows Motif software: o HP DECwindows Motif for HP OpenVMS Alpha New Features o HP DECwindows Motif for HP OpenVMS Alpha Release Notes o Guide to the HP DECwindows Motif for HP OpenVMS Alpha CD-ROM o Getting Started With the New Desktop o Managing DECwindows Motif for OpenVMS Systems o OpenVMS System Manager's Manual o OpenVMS System Management Utilities Reference Manual For additional information about OpenVMS or DECwindows Motif products and services, visit the following web site: http://www.openvms.compaq.com Reader's Comments HP welcomes your comments on this manual. Please send comments to either of the following addresses: Internet openvmsdoc@hp.com Mail Hewlett-Packard Company OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 How To Order Additional Documentation For information about how to order additional documentation, visit the following World Wide Web address: http://www.openvms.compaq.com/doc/ viii Conventions DECwindows Motif contains a graphical user interface that is derived from the Common Desktop Environment (CDE). This interface is referred to throughout this document as the New Desktop. Unless otherwise specified, references to OpenVMS Clusters, VMSclusters, or clusters in this document are synonymous with HP OpenVMS Clusters. All uses of DECwindows and DECwindows Motif refer to the HP DECwindows Motif for HP OpenVMS Alpha software; and all uses of X server and X display server refer to the HP DECwindows X11 Display Server. Additionally, all uses of DECwindows XUI (X User Interface) refer to the DECwindows product prior to DECwindows Motif Version 1.0. ix The following conventions are also used in this manual: Ctrl/x A sequence such as Ctrl/x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.) In the HTML version of this document, this convention appears as brackets, rather than a box. . . . Horizontal ellipsis points in examples indicate one of the following possibilities: o Additional optional arguments in a statement have been omitted. o The preceding item or items can be repeated one or more times. o Additional parameters, values, or other information can be entered. . Vertical ellipsis points indicate the . omission of items from a code example . or command format; the items are omitted because they are not important to the topic being discussed. ( ) In command format descriptions, parentheses indicate that you must enclose the choices in parentheses if you choose more than one. x [ ] In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.) | In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options. { } In command format descriptions, braces surround a required choice of options; you must choose one of the options listed. text style This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason. In the HTML version of this document, this convention appears as italic text. italic text Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system messages (Internal error number), in command lines (/PRODUCER=name), and in command parameters in text (where dd represents the predefined code for the device type). UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege. xi Monospace type Monospace type indicates code examples and interactive screen displays. In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example. - A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line. numbers All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes-binary, octal, or hexadecimal-are explicitly indicated. xii 1 _________________________________________________________________ Preparing to Install the Software This chapter describes the preparation and requirements for installing HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software using the POLYCENTER Software Installation utility. ________________________ Note ________________________ HP strongly recommends that you read the release notes before proceeding with the installation. The DECwindows Motif product provides online release notes. See Section 2.2 for instructions on how to access this information. ______________________________________________________ This chapter presents information about the following topics: o Section 1.1, License Registration o Section 1.2, Supported Hardware o Section 1.3, Prerequisites for the Installation Procedures o Section 1.4, Required Operating System Software o Section 1.5, OSF/Motif Release 1.1.3 and XUI Programming Support o Section 1.6, Saving Customized Bookreader Files o Section 1.7, Installation Procedure Requirements 1-1 Preparing to Install the Software 1.1 License Registration 1.1 License Registration Before you install and run DECwindows Motif software on a newly licensed node or cluster, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK is provided along with the kit if you ordered the license and media together; otherwise, it is provided separately to a location based on your license order. If you are installing DECwindows Motif software as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements. You must register and load your license for DECwindows Motif before you run the Installation Verification Procedure (IVP) and use the software. To register a license, log in to the system manager account (SYSTEM). Then choose one of the following options to register the license: 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 software on more than one node in a VMScluster, load the license on the other nodes after you complete this installation. For complete information about using LMF, see the OpenVMS License Management Utility Manual. 1.2 Supported Hardware HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software can be installed on any supported Alpha processor. For a complete list of supported hardware, see the OpenVMS Alpha Version 7.3-1 and HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 Software Product Descriptions (SPDs). 1-2 Preparing to Install the Software 1.3 Prerequisites for the Installation Procedures 1.3 Prerequisites for the Installation Procedures Before you can install and configure DECwindows Motif software, you must have the required version of the OpenVMS operating system software, sufficient memory, and a license. (Refer to Section 1.1 for information about registering a License Product Authorization Key [PAK].) Use the POLYCENTER Software Installation utility to install your DECwindows Motif software according to the following operating system information. 1.4 Required Operating System Software The HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software requires that the OpenVMS Alpha Version 7.3-1 operating system be installed with the DECwindows support options described in Table 1-1. If your system is not running a supported version of OpenVMS before you attempt to install DECwindows Motif, the installation fails. A minimum of 64 MB of memory is required; at least 128 MB of memory is highly recommended. The OpenVMS operating system provides two subsets of components to support DECwindows Motif. To use DECwindows Motif software, your system must be running a version of the OpenVMS system that includes the following components, as described in Table 1-1. 1-3 Preparing to Install the Software 1.4 Required Operating System Software Table_1-1_DECwindows_Motif_Support_Options_for_OpenVMS_____ Option____________Description______________________________ DECwindows This component is required to install Motif network DECwindows Motif and to run DECwindows transport and Motif applications. During the base system installation of OpenVMS, you are prompted support to specify whether you want to install this option. To determine whether this option was installed during the installation of OpenVMS, check for the existence of the following file: SYS$LIBRARY:DECW$TRANSPORT_COMMON.EXE DECwindows X11 This component is necessary to display Display Server, DECwindows Motif applications or any fonts, and other X Window applications on your device drivers system. During the installation of OpenVMS, you are prompted to specify whether you want to install this option. To determine whether this option was installed during the installation of OpenVMS, check for the existence of the following file: SYS$SYSTEM:DECW$SERVER_MAIN.EXE If the DECW$SERVER_MAIN.EXE file is not on your system, you cannot display DECwindows Motif or other X Window applications on your local system[1]. The DECwindows Motif installation procedure asks whether you want to continue the installation without workstation support. [1]If_this_component_is_not_installed_locally,_note_that___ you can run DECwindows Motif applications and redirect their display to a remote system that does have the DECwindows X11 Display Server installed. ___________________________________________________________ ________________________ Note ________________________ See the release notes and cover letter for the version of the OpenVMS operating system that you are running 1-4 Preparing to Install the Software 1.4 Required Operating System Software for more information about the DECwindows X11 Display Server. ______________________________________________________ 1.5 OSF/Motif Release 1.1.3 and XUI Programming Support The X Window System and OSF/Motif libraries that are provided with DECwindows Motif software are incompatible with those libraries provided with versions of DECwindows Motif prior to Version 1.2. Run-time compatibility is preserved, but the earlier OSF/Motif Release 1.1.3 and XUI programming environments are not compatible with the later OSF/MOTIF Release 1.2 programming environment. Programming in the XUI and OSF/Motif Release 1.1.3 environments that were provided in previous versions of DECwindows Motif is no longer supported in the DECwindows Motif product. However, the installation procedure gives you the option of saving the XUI and OSF/Motif Release 1.1.3 programming files that already exist on your system. If you choose to save these programming files, they are moved to subdirectories where you can access them for programming. Specifically, the installation creates a subdirectory called [.DECW$113] in each of the directories listed in Table 1-2 and moves the previous files into the new [.DECW$113] subdirectory. Table 1-2 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___________________________________________ 1-5 Preparing to Install the Software 1.5 OSF/Motif Release 1.1.3 and XUI Programming Support ________________________ Note ________________________ The process for using the saved programming environment is documented in the programmer chapter of the release notes. ______________________________________________________ 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 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 1-6 Preparing to Install the Software 1.6 Saving Customized Bookreader Files 3. If the SYS$MANAGER directory does not contain the DECW$PRIVATE_APPS_SETUP.COM command file, copy the template file to a command file as follows: $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE - _$ SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM/LOG 4. Edit the DECW$PRIVATE_APPS_SETUP.COM file and define the global symbol DECW$BOOK to point to your Bookreader directory by adding the following line to the file: $ DECW$BOOK == "SYS$COMMON:[DECW$BOOK_LOCAL]" 5. Restart DECwindows Motif using the following command if you performed step 4 after installing the product and after DECwindows had been started (for example, after a reboot): $ @SYS$MANAGER:DECW$STARTUP RESTART For more information about customizing your DECwindows Motif environment, see Managing DECwindows Motif for OpenVMS Systems. 1.7 Installation Procedure Requirements This section discusses the requirements for installing the DECwindows Motif software using PCSI. The installation procedure checks the following: o Whether any other users are logged in to the system o Whether you have the minimum required system account quotas and limits o Whether you have the minimum required disk space o Whether you have the minimum required system parameter values 1-7 Preparing to Install the Software 1.7 Installation Procedure Requirements 1.7.1 Process Account Quotas The installation procedure requires that the installation account has the minimum quotas shown in Table 1-3. Table_1-3_Process_Quotas_for_the_Installation_Account______ Quota_Name__Value__________________________________________ ASTLM 250 BIOLM 150 BYTLM 64,000 DIOLM 150 ENQLM 2,000 FILLM__________100_________________________________________ Use the OpenVMS AUTHORIZE utility to verify and to change process quotas for the installation account in the user authorization file (UAF). (Some sites may restrict the use of the AUTHORIZE utility to certain accounts or users.) For example, to change the BYTLM quota for the account-name installation account, enter the following commands: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> SHOW account-name UAF> MODIFY account-name /BYTLM = 64000 UAF> SHOW account-name UAF> EXIT $ LOGOUT After you change the quotas for the installation account, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation. User account quotas are stored in the file SYS$SYSTEM:SYSUAF.DAT. For more information about modifying account quotas, see the description of the AUTHORIZE utility in the OpenVMS System Management Utilities Reference Manual. 1-8 Preparing to Install the Software 1.7 Installation Procedure Requirements 1.7.2 Disk Space Use Table 1-4 to determine the amount of free disk space that is required on the system disk to install DECwindows Motif components. However, because you can choose not to install all the components, your actual disk space requirement may be less. To determine the number of free blocks on the system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE The installation procedure checks for free disk space on the system disk. If sufficient space is not available, the installation procedure provides the following options: o Install fewer optional files. o Terminate the installation, create more free disk space on the system disk, and restart the installation. o Continue the installation and risk running out of disk space. ________________________ Note ________________________ If you run out of free disk space during the installation, the installation procedure fails. ______________________________________________________ 1-9 Preparing to Install the Software 1.7 Installation Procedure Requirements Table_1-4_Required_Disk_Space_by_Component_(in_Blocks)_____ Component/Subcomponent___Requirement_Subtotals___Totals____ Installation overhead: 40,000[1] 40,000 40,000 Server software: Server base kit 4,120 4,120 Euro currency 19,880 19,880 support Server total 24,000 LBX support: 950 950 950 Client software: Client base kit 58,450 58,450 Desktop support New Desktop 42,340 DECwindows 7,860 desktop Manual pages 2,810 for New Desktop Desktop 53,010 subtotal Programming environment C, C++ 7,870 FORTRAN 2,060 Pascal 3,020 New Desktop 150 Programming 13,100 subtotal [1]Includes_excess_disk_space_allocation_(dependent_on_____ disk cluster size), PCSI overhead, and log files. The value shown is for the combined installation of the server, LBX, and client software. (continued on next page) 1-10 Preparing to Install the Software 1.7 Installation Procedure Requirements Table 1-4 (Cont.) Required Disk Space by Component (in __________________Blocks)__________________________________ Component/Subcomponent___Requirement_Subtotals___Totals____ Example programs Sound examples 1,560 Programming 10,220 examples New Desktop 1,250 examples Examples 13,030 subtotal Translated image 28,330 28,330 support Client total 165,920 Total for all 230,870 components:________________________________________________ 1.7.3 System Parameters Table 1-5 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-5_Minimum_Required_System_Parameter_Values_________ System Parameter________Value_____________________________________ GBLSECTIONS 600[1] [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-5_(Cont.)_Minimum_Required_System_Parameter_Values_ System Parameter________Value_____________________________________ GBLPAGES 150,000[1] GBLPAGFIL 1,024 SWPOUTPGCNT 512 MAXBUF 8,192 VIRTUALPAGECNT - CHANNELCNT 255 PROCSECTCNT 64 PQL_DPGFLQUOTA - PQL_MPGFLQUOTA 32,768 PQL_MASTLM 100 PQL_MBIOLM 100 PQL_MBYTLM 100,000 PQL_MDIOLM 100 PQL_MENQLM 300 PQL_MFILLM 100 PQL_MPRCLM 10 PQL_MWSDEFAULT 1,024 PQL_MWSQUOTA 2,048 PQL_MWSEXTENT 8,192 CLISYMTBL 512 GH_RES_CODE 1,024 GH_RES_DATA 512 [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-12 Preparing to Install the Software 1.7 Installation Procedure Requirements Table_1-5_(Cont.)_Minimum_Required_System_Parameter_Values_ System Parameter________Value_____________________________________ IMGREG_PAGES 2,000 WINDOW_SYSTEM 1 NPAGEDYN 1,998,848 PAGEDYN 600,000 WSMAX______________12,000__________________________________ _______________________ Caution _______________________ If you do not ensure that your system has the necessary number of global pages and global sections for the installation, the DCL tables can become corrupted. ______________________________________________________ 1.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 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> 1-13 Preparing to Install the Software 1.7 Installation Procedure Requirements 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-5, increase the system parameter settings. Section 1.7.4.4 describes the procedures for using the AUTOGEN utility to increase these values. 1.7.4.2 Calculating the Number of Free Global Pages and Global Sections If your system parameter values are equal to or greater than the minimum values specified in Table 1-5, you can continue with the product installation. However, to install and run DECwindows Motif 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 contiguous free global pages and the number of free global sections. The following example shows how to obtain this information at your terminal, which is the default for SYS$OUTPUT: 1-14 Preparing to Install the Software 1.7 Installation Procedure Requirements $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 See Table 1-6 to determine whether the number of contiguous free global pages and the number of free global sections is sufficient. If these values are not sufficient to continue with the installation, then see Section 1.7.4.4, which describes the procedures for increasing these values using the AUTOGEN utility. Table 1-6 Required Number of Contiguous Free Global Pages __________and_Free_Global_Sections_________________________ ____________Currently_Running_DECwindows_Motif_____________ System_Resource__Value_____________________________________ CONTIG_GBLPAGES 12,000 FREE_GBLSECTS 20 ___________________________________________________________ __________Not_Currently_Running_DECwindows_Motif___________ System_Resource__Value_____________________________________ CONTIG_GBLPAGES 92,000 FREE_GBLSECTS______260_____________________________________ 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. However, this size 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. 1-15 Preparing to Install the Software 1.7 Installation Procedure Requirements Normally, you should run AUTOGEN with feedback and let AUTOGEN calculate the size of the page file based on the usage pattern on your system. To run AUTOGEN with feedback, enter the following DCL command: $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT FEEDBACK You can also increase the size of the page file by running the SYSGEN utility or by invoking the command procedure SYS$UPDATE:SWAPFILES.COM. For more information about setting the size of the page file and running AUTOGEN, see the section about the AUTOGEN utility in the OpenVMS System Manager's Manual and the AUTOGEN section in OpenVMS System Management Utilities Reference Manual. For more information about performance tuning in general, see the OpenVMS Performance Management manual. 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, prefix the parameter name with ADD_. The following example increases the global pages value by 30,000: ADD_GBLPAGES = 30000 1-16 Preparing to Install the Software 1.7 Installation Procedure Requirements Table 1-7 lists the system parameters that you need to adjust incrementally. Table 1-7 Recommended System Parameter Values to Use with __________the_ADD__Option__________________________________ System Parameter________Increment_________________________________ SYSMWCNT - GBLSECTIONS 280 GBLPAGES 92,000 GBLPAGFIL 768 NPAGEDYN 300,000 PAGEDYN__________180,000___________________________________ 1-17 Preparing to Install the Software 1.7 Installation Procedure Requirements 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 Backing Up Your System Disk HP recommends that you back up your system disk before you install any software. At the beginning of the installation, the installation procedure asks whether your system disk is backed up. Use the backup procedures that are established at your site. For details about performing a system disk backup, see the section on the Backup utility in the OpenVMS System Management Utilities Reference Manual. 1.7.6 Notifying Other Users Inform users on the system that you plan to install a product and that they must log out during the installation. To make sure that you are the only user logged in to the system, follow these steps: 1. Notify current users to log out. Enter the following command at the DCL prompt: $ REPLY/ALL/BELL/SHUTDOWN "Log out for the installation of - _$ Compaq DECwindows Motif for OpenVMS Alpha, Version 1.3 please..." 2. Enter the following command at the DCL prompt to prevent nonprivileged users from logging in to the system: $ SET LOGINS/INTERACTIVE=0 If possible, give users an estimated time when they can log in to the system again. 1-18 2 _________________________________________________________________ Using the POLYCENTER Software Installation Utility This chapter describes how to install and configure DECwindows Motif software using the POLYCENTER Software Installation (PCSI) utility. The DECwindows Motif product supports POLYCENTER Software installations using the Digital Command Language (DCL) interface. This chapter presents information about the following topics: o Section 2.1, Accessing Help Information o Section 2.2, Extracting and Printing the Product Release Notes o Section 2.3, Installing the DECwindows Motif Software o Section 2.4, Recovering from Errors 2-1 Using the POLYCENTER Software Installation Utility For HP DECwindows Motif for HP OpenVMS Alpha Version 1.3, the DECwindows X11 Display Server installs a patch kit that provides the necessary, updated server images to the OpenVMS Alpha Version 7.3-1 software. This installation is an integral part of the PCSI installation of Version 1.3. The server and client software will be installed in the proper order. 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 Refer to Section 1.4 for information about prerequisite software and licenses. _______________________ Caution _______________________ If you do not have a satisfactory backup copy of your system disk, do not attempt to install DECwindows Motif software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your system) before you install DECwindows Motif 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. 2-2 Using the POLYCENTER Software Installation Utility 2.1 Accessing Help Information 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 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 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.2 Extracting and Printing the Product Release Notes Before you begin the installation procedure, you should read the product's release notes. To extract a copy of the HP DECwindows Motif for HP OpenVMS Alpha Release Notes, define PCSI$SOURCE to point to the location (device name and directory) of the PCSI kit. Then enter the PRODUCT EXTRACT RELEASE_NOTES command followed by the product name, DWMOTIF, at the DCL prompt. 2-3 Using the POLYCENTER Software Installation Utility 2.2 Extracting and Printing the Product Release Notes For example: $ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF13] $ 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 HP DECwindows Motif for HP OpenVMS Alpha Release Notes are also available in HTML and ASCII (.TXT) formats in the documentation directory on the DECwindows Motif CD- ROM. Refer to the Guide to the HP DECwindows Motif for HP OpenVMS Alpha CD-ROM for information about accessing the release notes and other DECwindows Motif documentation. 2-4 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software 2.3 Installing the DECwindows Motif Software _______________________ Warning _______________________ The DECwindows Motif software installation includes patches to the server software that is included in the OpenVMS Alpha operating system. Once these patches are installed, you cannot uninstall them. Removing the DECwindows Motif software using the PRODUCT REMOVE command does not remove the patches. The only method to restore your system to its former state is to reinstall the OpenVMS Alpha operating system. See Section 2.3.2.5 for more information. ______________________________________________________ The sections that follow take you through the stages of installing your DECwindows Motif software using the POLYCENTER Software Installation utility. Refer to Chapter 1 for information about account quotas, disk space, and system parameters. 2.3.1 Starting the Installation To start the POLYCENTER Software Installation utility, enter the following command at the DCL prompt: $ DEFINE PCSI$SOURCE device:[PCSI_ALPHA_DWMOTIF13] where device is the name of the device on which the distribution CD-ROM is mounted or on which the installation kit is located. Next, invoke the POLYCENTER Software Installation utility: $ PRODUCT INSTALL DWMOTIF ________________________ Note ________________________ If you want to see the help text shown in this chapter, use the /HELP qualifier with the PRODUCT INSTALL command. ______________________________________________________ 2-5 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software 2.3.2 The Installation Dialog The installation dialog begins by displaying the name of the product which PCSI is installing. You are then asked to verify that you want to continue with the installation. The dialog continues with a display of product name, copyright, and Product Authorization Key (PAK) information. The following product has been selected: DEC AXPVMS DWMOTIF V1.3-0 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif Compaq DECwindows Motif for OpenVMS Alpha, Version 1.3 is based on Version 11 Release 6.6 of the X Window System (X11R6.6) and OSF/Motif Version 1.2.3. DECwindows Motif V1.3-0 provides both runtime and development support for the X Window System. Runtime and development support is provided for X11 Release 6.6 (X11R6.6) and OSF/Motif Version 1.2.3. For OSF/Motif Version 1.1.3, only runtime support is provided. Copyright 2003 Compaq Information Technologies Group, L.P. Compaq and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Motif is a registered trademark and The Open Group is a trademark of The Open Group in the United States and/or other countries. Confidential computer software. Valid license from Compaq or authorized sublicensor required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Compaq Computer Corporation This software product is sold by Compaq Computer Corporation This product uses the PAK: DW-MOTIF 2-6 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software This software is furnished under the licensing provisions of Compaq Computer Corporation's Standard Terms and Conditions. For more in- formation about Compaq's licensing terms and policies, contact your local Compaq office. 2.3.2.1 Verifying Sufficient Allocation for the GBLPAGES and CLISYMTBL Values The installation command procedure checks to ensure that adequate values are allocated for the system parameters shown in Table 1-5 and Table 1-6. If your system values are sufficient, the installation procedure continues. If any of the values are insufficient, the procedure abandons the installation and instructs you to run AUTOGEN and then restart the installation. On OpenVMS Alpha systems, the procedure displays messages similar to the following: Checking values of system parameters... %DECW-W-BADVALUE, SYSGEN parameter GBLSECTIONS is 380, should be at least 600 %DECW-W-BADVALUE, Free GBLSECTIONS is 15, should be at least 260 %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 120000, should be at least 150000 %DECW-W-BADVALUE, SYSGEN parameter NPAGEDYN is 1294336, should be at least 1998848 %DECW-W-BADVALUE, SYSGEN parameter CLISYMTBL is 265, should be at least 512 The installation procedure has determined that some system parameter values require modification to install the DECwindows Motif Version 1.3 for OpenVMS software. Please type the following command to run AUTOGEN and reboot your system before restarting the DECwindows installation. This will set the system parameters to appropriate values for running DECwindows Motif Version 1.3. @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK The DECwindows installation is being terminated. Please run AUTOGEN and restart the installation. %PCSI-E-S_OPFAIL, operation failed %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error condition 2-7 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software 2.3.2.2 Running AUTOGEN If the installation procedure has prompted you to run AUTOGEN to correct your system values, enter the following command: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK The system runs AUTOGEN and produces a log similar to the following example: %AUTOGEN-I-BEGIN, GETDATA phase is beginning. %AUTOGEN-I-NEWFILE, Previous contents of SYS$SYSTEM:CLU$PARAMS.DAT have been copied to SYS$SYSTEM:CLU$PARAMS.OLD. You may wish to purge SYS$SYSTEM:CLU$PARAMS.OLD. %AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:PARAMS.DAT has been created. You may wish to purge this file. %AUTOGEN-I-END, GETDATA phase has successfully completed. %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning. %AUTOGEN-I-NEWFILE, A new version of SYS$MANAGER:VMSIMAGES.DAT has been created. You may wish to purge this file. %AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:SETPARAMS.DAT has been created. You may wish to purge this file. %AUTOGEN-I-END, GENPARAMS phase has successfully completed. %AUTOGEN-I-BEGIN, GENFILES phase is beginning. %AUTOGEN-I-REPORT, AUTOGEN has produced some informational messages which have been stored in the file SYS$SYSTEM:AGEN$PARAMS.REPORT. You may wish to review the information in that file. %AUTOGEN-I-END, GENFILES phase has successfully completed. %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning. %AUTOGEN-I-SYSGEN, parameters modified %AUTOGEN-I-END, SETPARAMS phase has successfully completed. %AUTOGEN-I-BEGIN, REBOOT phase is beginning. The system is shutting down to allow the system to boot with the generated site-specific parameters and installed images. The system will automatically reboot after the shutdown and the upgrade will be complete. SHUTDOWN -- Perform an Orderly System Shutdown on node MYNODE You can now restart the installation procedure (see Section 2.3.1). 2-8 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software 2.3.2.3 Saving the Programming Environment The installation procedure checks whether the OSF/Motif Release 1.1.3 programming environment exists on your system. If it is present, the installation procedure displays the following information and asks whether you want to save the OSF/Motif Release 1.1.3 programming environment: The DECwindows Motif programming environment was installed with a previous version of this kit. This environment is incompatible with the OSF/Motif Release 1.2 environment provided with DECwindows Motif Version V1.3-0. The XUI programming environment is also not included in DECwindows Motif Version 1.3. If you intend to continue developing programs for XUI or OSF/Motif Release 1.1.3, then save this environment. Please refer to the installation guide for more details and information on accessing these files in their new location. If you do not choose to save the XUI and OSF/Motif Release 1.1.3 programming environment, those files will be removed from the system disk. Save the OSF/Motif Release 1.1.3 and XUI programming environment? If you answer Yes and press the Return key to save the OSF/Motif Release 1.1.3 and XUI programming environment, a subdirectory called [.DECW$113] is created. The files that support that programming environment are moved to the [.DECW$113] subdirectory. If you answer No and press the Return key, the files are deleted. Refer to Section 1.5 for information about accessing files related to the OSF/Motif Release 1.1.3 programming environment. 2.3.2.4 Default Installation Next, the dialog asks if you want the default installation. On systems with no previous DECwindows Motif installation, the installation procedure installs all options that apply to your hardware platform. On systems with a previous DECwindows Motif installation, the installation procedure installs all options selected during the previous installation. Any options not present in the installed 2-9 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software version are installed according to the defaults for those options in Version 1.3. Do you want the defaults for all options? [YES] The remainder of this chapter assumes that you answer No to this question. 2.3.2.5 Installation of Server Software The installation proceeds with an important warning about the DECwindows Motif server patch about to be installed by the installation procedure. DECwindows Motif V1.3-0 cannot be uninstalled. The DECwindows Motif for OpenVMS Alpha Version 1.3 software upgrade also updates certain images that are part of the OpenVMS Alpha operating system. Removing the DECwindows Motif Version 1.3 product (using PRODUCT REMOVE) does not restore the operating system images to their proper state. To revert to a previous version of DECwindows Motif, you must first reinstall the OpenVMS Alpha operating system and then install the appropriate version of DECwindows Motif. Be sure that you want to install the DECwindows Motif Version 1.3 software before proceeding. Do you want to continue? [YES] Note that the server patch is always installed with DECwindows Motif. The question in this section asks if you want to continue with the product installation, not if you want to install the server software. 2.3.2.6 Euro Currency Sign Support The dialog asks if you want to install support for the Euro currency sign. This option provides Euro sign support for Compaq DECwindows Motif for OpenVMS Alpha Version 1.3. After installing the option and performing the setup process, you can enter and display the Euro sign. Install the DECwindows Motif Euro sign support [NO] See the HP DECwindows Motif for HP OpenVMS Alpha New Features manual for more information about the Euro option. 2-10 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software 2.3.2.7 LBX Proxy Installation Following the server installation, the dialog asks if you want to install the Low-Bandwidth X (LBX) proxy option. The LBX proxy reduces the overall network bandwidth required for client-to-server communications. The LBX proxy can be installed as a standalone option or in conjunction with the DECwindows Motif client software. Install Low Bandwidth X (LBX) Support [YES] See the HP DECwindows Motif for HP OpenVMS Alpha New Features manual for more information about the LBX feature. 2.3.2.8 Selecting Installation of Client Software Next, the installation procedure asks if you want to install the client software: Install the DECwindows Motif Version 1.3 client software? [YES] Answer Yes if you intend to run any programs requiring a DECwindows display, either on this system or on any remote system. If you answer No, skip to Section 2.3.2.12. If you answer Yes, the dialog asks if you want the default client installation: Do you want the defaults for all suboptions? [YES] Answer Yes if you want to take all the defaults for the client installation. If you answer Yes, skip to Section 2.3.2.12. If you answer No, proceed to Section 2.3.2.9. 2.3.2.9 Asking About Selecting a Desktop The installation procedure displays information about the New Desktop and traditional DECwindows desktop. You can elect to install one of the desktops or both desktops. If you elect to install the New Desktop, the dialog asks whether the New Desktop should be the default desktop. The New Desktop is a graphical user interface that is derived from the Common Desktop Environment (CDE). It offers the following features not available with the traditional DECwindows desktop: o Multiple workspaces for greater flexibility in managing windows on the screen. 2-11 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software o An icon-based File Manager to make it easier to manipulate files from the graphical user interface. o Enhanced support for the drag-and-drop feature, which is fully supported in the new File Manager and Application Manager applications. o New Image Viewer and Icon Editor applications. Both the New Desktop and the DECwindows desktop provide the same underlying X and Motif libraries and the same DECterm, Bookreader, Mail, and Calendar applications. Install New Desktop [YES] The manual pages provide online help text for New Desktop functions. If installed they can be viewed using the man page viewer from the Application Manager. Install Manual (reference) pages for the New Desktop [YES] If the New Desktop is the default, the new login box will be used and the user has the option at login to use either the New or the traditional desktop. If the New Desktop is not the default, the traditional login box will be used and only the traditional desktop will be available. You can change the default desktop by editing the file [SYSMGR]DECW$DEFAULT_DESKTOP.COM and restarting DECwindows. Make the New Desktop the default desktop [YES] The traditional DECwindows Desktop is that provided since Version 1.2 of DECwindows. If both new and traditional desktops are installed the user can select which to run when logging in. Install traditional DECwindows Desktop [YES] See Section 3.4 for instructions about how to change the choice of desktop after the installation has completed. 2-12 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software 2.3.2.10 Programming Language Support Options Next, the dialog asks you which programming languages you want to install and whether you want to install the programming examples. The installation procedure uses the following dialog: Headers and related files to support programs in C that will use the DECwindows libraries. Programming Support for the C Language [YES] Include files to support programs in Pascal that will use the DECwindows libraries. Programming Support for the Pascal Language [YES] Include files to support programs in FORTRAN that will use the DECwindows libraries. Programming Support for the FORTRAN Language [YES] Headers and related files to support programs in C that will use the New Desktop widgets. Programming Support for the New Desktop [YES] Examples of programming to use the various libraries. Programming examples [YES] Do you want all the defaults for the subitems? [YES] no Sample sound files that can be used with DECsound. Sound example files [YES] Examples, in various programming languages, of using the DECwindows and standard widgets and libraries. Programming examples for DECwindows [YES] Examples, in C, of using the new widgets provided with the New Desktop. Programming examples for the New Desktop [YES] 2-13 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software 2.3.2.11 Translated Image Support The dialog now prompts you to install Translated Image Support (TIS), which enables VAX programs to work in the Alpha environment. Note that TIS support is only available for the traditional DECwindows desktop environment. Translated image support allows programs translated from the VAX environment to work in the Alpha environment with the DECwindows libraries. Translated image support is not available for the New Desktop. Translated Image Support [YES] 2.3.2.12 Language Variants Notice The dialog now displays a warning about the need to update any language variants. You should not install DECwindows Motif Version 1.3 unless you will also install DECwindows Motif Version 1.3 language variants for all the languages that you want to use. If a Local Language Variant is installed, refer to the Installation Guide. If you have a language variant of DECwindows Motif installed, then you must upgrade to the version for DECwindows Motif Version 1.3 after completing this installation and before rebooting the system. A failure to do so could prevent DECwindows from starting. If there is no local language variant upgrade available for DECwindows Motif Version 1.3, then you should remove the local language variant before installing DECwindows Motif Version 1.3. Do you want to continue? [YES] 2.3.2.13 Reviewing the Installation Options The dialog gives you a chance to review the options you have selected during the installation dialog. Do you want to review the options? [NO] y 2-14 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif DEC AXPVMS VMS V7.3-1 [Installed] Install the DECwindows Motif Euro sign support: NO Install Low Bandwidth X (LBX) Support: YES Install the DECwindows Motif V1.3-0 client software: YES Install New Desktop: YES Install Manual (reference) pages for the New Desktop: YES Make the New Desktop the default desktop: YES Install traditional DECwindows Desktop: YES Programming Support for the C Language: YES Programming Support for the Pascal Language: YES Programming Support for the FORTRAN Language: YES Programming Support for the New Desktop: YES Programming examples: YES Sound example files: YES Programming examples for DECwindows: YES Programming examples for the New Desktop: YES Translated Image Support: YES Are you satisfied with these options? [YES] 2.3.2.14 Execution Dialog During the execution phase, the installation utility begins by displaying the names of all products it will install or remove. This is followed by an indication of the procedure's progress. ________________________ Note ________________________ During the execution phase, a check is made for DECwindows Motif support files. If these files are not available, the dialog may ask if you want to continue. See Section 2.3.2.15 for more information. ______________________________________________________ Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF V1.3-0 DISK$ALPHASYS:[VMS$COMMON.] The following product will be removed from destination: DEC AXPVMS DWMOTIF V1.2-6 DISK$ALPHASYS:[VMS$COMMON.] 2-15 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software Portion done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% 2.3.2.15 Verifying DECwindows Motif Support Files The installation procedure verifies that DECwindows Motif applications and run-time support files are installed on the operating system (for example, transport and font files, which are required for running DECwindows Motif software). **** DECwindows Motif application and run-time support files DETECTED **** On OpenVMS Alpha systems, the files are always installed. Next, the installation procedure checks for the presence of support files that are needed to use the system as a workstation or as a workstation boot server. If the support files are installed, the following message is displayed: **** DECwindows device support files DETECTED **** If the files are not installed, users are warned with the following message that their systems cannot be a workstation or a workstation boot server: The DECwindows device support files for using this machine as a workstation or as a boot node for workstations have not been installed. You can use the POLYCENTER Software Installation utility to change the options selected when the OpenVMS Alpha software was installed. See the POLYCENTER Software Installation Utility User's Guide for more information. To add the support files and the 75DPI and/or the 100DPI font files using the DECwindows save sets which are shipped with the OpenVMS kit, use the PRODUCT RECONFIGURE command as follows: $ PRODUCT RECONFIGURE VMS You should add the "Support for DECwindows" subclass in the Utilities class. 2-16 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software The installation procedure then asks the following question: Do you wish to continue with this installation without the workstation support? If you answer No (default) and press the Return key, the installation is stopped. Add the necessary support files. Once you install the necessary support files, restart the installation procedure. If you answer Yes and press the Return key, the installation continues. 2.3.2.16 Reviewing Final Installation Notes If the installation is successful, the dialog displays a list of all products installed and removed. Finally, the procedure displays additional installation notes for the DECwindows Motif product. ...100% The following product has been installed: DEC AXPVMS DWMOTIF V1.3-0 Layered Product The following product has been removed: DEC AXPVMS DWMOTIF V1.2-6 Layered Product DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif System reboot is required. If using a language variant, reboot after upgrade of language variant. A system reboot is required to install the new DECwindows Motif images. If this is a new installation you should execute AUTOGEN using the following command: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK This command adjusts your system parameters and reboots the system. If you wish to use DECwindows with any language other than English, install the appropriate DECwindows Motif Version 1.3 language variant product before using AUTOGEN or rebooting the system. Installation Verification Procedure can be run after reboot. Run the Installation Verification Procedure (IVP) after the installation is completed and the system is rebooted. The IVP is located in the following directory: SYS$TEST:DECW$IVP.COM. 2-17 Using the POLYCENTER Software Installation Utility 2.3 Installing the DECwindows Motif Software 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. For descriptions of the error messages generated by these conditions, see the documents listed in the Associated Documents section in the Preface. These documents may help you diagnose errors and decide what corrective actions to take. If the installation procedure fails for any reason, the POLYCENTER Software Installation utility displays a message similar to the following: %PCSIUI-INSFAIL, The installation of DECwindows Motif Version 1.3 for OpenVMS has failed. If the installation fails, fix the problem and restart the installation procedure. 2.5 Adjusting Parameters After Installation If you are simultaneously installing or upgrading the OpenVMS operating system with DECwindows from the CD- ROM, the installation procedure will will check the system parameters at this point (see Table 1-5 and Table 1-6). ________________________ Note ________________________ You will not see this message if this is a new installation of DECwindows. ______________________________________________________ 2-18 Using the POLYCENTER Software Installation Utility 2.5 Adjusting Parameters After Installation When DECwindows Motif attempts to start after successful installation, you will see messages similar to the following: %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 120000, should be at least 150000 %DECW-W-BADVALUE, Free GBLPAGES is 75040 should be at least 92000 %DECW-W_BADVALUE, SYSGEN parameter CLISYMTBL is 256, should be at least 512 Some SYSGEN parameters must be reset for DECwindows to start. If you type YES, AUTOGEN will change these parameters and reboot your system. If you type NO, AUTOGEN will not be run or cause a reboot but DECwindows will not start. Do you want the system to run AUTOGEN for you [YES] At this point, press RETURN. The system will run AUTOGEN, adjust your system parameters, reboot the system and display the DECwindows login. 2-19 3 _________________________________________________________________ After Installing the Software This chapter discusses the tasks that you need to perform after the DECwindows Motif installation is completed: o Section 3.1, Starting the DECwindows Motif Software o Section 3.2, Running the IVP o Section 3.3, Choosing an Alternate Console o Section 3.4, Selecting the Desktop 3.1 Starting the DECwindows Motif Software The DECwindows startup procedure runs automatically when the system reboots. 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 3.4 for more information.) 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. For information on starting DECwindows, see the chapter entitled "Starting DECwindows Motif" in Managing DECwindows Motif for OpenVMS Systems. 3-1 After Installing the Software 3.2 Running the IVP 3.2 Running the IVP Run the IVP, SYS$TEST:DECW$IVP.COM, after you install and start the DECwindows Motif product. This procedure contains six 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. Next, if the display-oriented tests were selected and the display has been configured to support the LBX feature, the IVP repeats the same display-oriented tests using an LBX proxy server. For a description of how to configure support for the LBX feature, see the HP DECwindows Motif for HP OpenVMS Alpha New Features manual. Finally, 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. 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. 3-2 After Installing the Software 3.2 Running the IVP Example 3-1 shows you how to run the IVP. Example 3-1 Sample IVP $ @SYS$TEST:DECW$IVP Copyright 2003 Compaq Information Technologies Group, L.P. Compaq DECwindows Motif for OpenVMS Alpha Installation Verification Procedure (IVP) This IVP is intended to test some of the functionality of DECwindows Motif 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, Server does not support LBX. Proxy test skipped. %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. $ If the server supports LBX proxies, the following messages are displayed instead of the Server does not support LBX message shown in the preceding example: 3-3 After Installing the Software 3.2 Running the IVP %DECW-I-IVP, LBX Proxy tests, test will execute through a proxy %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_LBX spawned PROXY_MANAGER=local/MISATO:9999 $ lbxproxy %DECW-I-ATTACHED, transport TCPIP attached to its network %DECW-I-ATTACHED, transport DECNET attached to its network %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 3.3 Choosing an Alternate Console The DECwindows Motif 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. 3-4 After Installing the Software 3.4 Selecting the Desktop 3.4 Selecting the Desktop DECwindows Motif 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, you are asked which desktop you wish to be the default desktop. To select the other desktop as the default desktop, 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 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 a symbol definition for DECW$START_NEW_DESKTOP. If you wish the New Desktop as the default enter the following global symbol definition: $ DECW$START_NEW_DESKTOP == "TRUE" If you want the DECwindows desktop as the default, enter the following global symbol definition: $ DECW$START_NEW_DESKTOP == "FALSE" 3. Restart DECwindows using the following command: $ @SYS$MANAGER:DECW$STARTUP RESTART 3-5 4 _________________________________________________________________ Managing DECwindows Motif Software After you install the HP DECwindows Motif for HP OpenVMS Alpha product, you can tune your system to enhance performance, decrease the use of some system resources, and specify certain server settings. This chapter contains information about setting up your DECwindows Motif environment. See Managing DECwindows Motif for OpenVMS Systems and HP DECwindows Motif for HP OpenVMS Alpha New Features for additional system management information. The following topics are discussed in this chapter: o Section 4.1, Customizing the DECwindows X11 Display Server Startup Procedure o Section 4.2, Determining and Reporting Problems 4-1 Managing DECwindows Motif Software 4.1 Customizing the DECwindows X11 Display Server Startup Procedure 4.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. The initial 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: o List of screens associated with this server o Font, resolution, and color capabilities for each screen o Layout of the keyboard (such as, LK201-AA or LK401-AA) o Appropriate network transport o List of valid font servers and whether to active the font server on this system o Level of auditing for client connections o List of X server extensions to activate (such as, XINERAMA, SECURITY, or XKB) o Current security policy (if using SECURITY) o Current location of X authority file o List of users that have trusted access to this server o Number and order of screens in a multihead configuration (if using XINERAMA) o X keyboard layout and related options (if using XKB) You can specify these display server settings by modifying 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. 4-2 Managing DECwindows Motif Software 4.1 Customizing the DECwindows X11 Display Server Startup Procedure 2. Edit the file to add or change the desired setup options in either of two sections in the server startup file. Details on these options are available from Managing DECwindows Motif for OpenVMS Systems, HP DECwindows Motif for HP OpenVMS Alpha New Features, and the file itself. 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. 3. Restart DECwindows Motif on the workstations for which you customized the server startup using the following command: $ @SYS$MANAGER:DECW$STARTUP RESTART 4.2 Determining and Reporting Problems If you encounter a problem while using DECwindows Motif, report it to HP. Review the Software Product Description (SPD) for an explanation of warranty. If you encounter a problem during the warranty period, you can take one of the following actions: o Call your HP support representative if your software contract or warranty agreement entitles you to telephone support. 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.) 4-3 A _________________________________________________________________ POLYCENTER Software Installation Utility Sample Installation This appendix contains a sample installation of the DECwindows Motif software on the OpenVMS Alpha Version 7.3-1 operating system. Refer to Chapter 2 for details about using the POLYCENTER Software Installation utility to install DECwindows Motif software. The sample installation assumes that you have set the default directory to the device name and directory containing the DECwindows Motif saveset, as well as any necessary ECOs. A-1 POLYCENTER Software Installation Utility Sample Installation A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System Example A-1 contains a sample of the DECwindows Motif software installation on an OpenVMS Alpha Version 7.3-1 operating system with sufficient system resources. Example A-1 Sample Installation of an Upgrade of the DECwindows Motif Software on an OpenVMS Alpha Version 7.3-1 System With Sufficient System Resources $ PRODUCT INSTALL DWMOTIF The following product has been selected: DEC AXPVMS DWMOTIF V1.3-0 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif Copyright 2003 Compaq Information Technologies Group, L.P. Compaq Computer Corporation This product uses the PAK: DW-MOTIF Checking values of system parameters... OK DECWindows Motif V1.3-0 cannot be uninstalled. The DECwindows Motif for OpenVMS Alpha Version 1.3 software upgrade also updates certain images that are part of the OpenVMS Alpha operating system. Removing the DECwindows Motif Version 1.3 product (using PRODUCT REMOVE) does not restore the operating system images to their proper state. (continued on next page) A-2 POLYCENTER Software Installation Utility Sample Installation A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System Example A-1 (Cont.) Sample Installation of an Upgrade of the DECwindows Motif Software on an OpenVMS Alpha Version 7.3-1 System With Sufficient System Resources To revert to a previous version of DECwindows Motif, you must first reinstall the OpenVMS Alpha operating system and then install the appropriate version of DECwindows Motif. Be sure that you want to install the DECwindows Motif Version 1.3 software before proceeding. Do you want the defaults for all options? [YES] If a Local Language Variant is installed, refer to the Installation Guide. Do you want to continue? [YES] Do you want to review the options? [NO] Y DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif DEC AXPVMS VMS V7.3-1 [Installed] Install the DECwindows Motif Euro sign support: NO Install Low Bandwidth X (LBX) Support: YES Install the DECwindows Motif V1.3-0 client software: YES Install New Desktop: YES Install Manual (reference) pages for the New Desktop: YES Make the New Desktop the default desktop: YES Install traditional DECwindows Desktop: YES Programming Support for the C Language: YES Programming Support for the Pascal Language: YES Programming Support for the FORTRAN Language: YES Programming Support for the New Desktop: YES Programming examples: YES Sound example files: YES Programming examples for DECwindows: YES Programming examples for the New Desktop: YES Translated Image Support: YES Are you satisfied with these options? [YES] (continued on next page) A-3 POLYCENTER Software Installation Utility Sample Installation A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System Example A-1 (Cont.) Sample Installation of an Upgrade of the DECwindows Motif Software on an OpenVMS Alpha Version 7.3-1 System With Sufficient System Resources Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF V1.3-0 DISK$2:[VMS$COMMON.] The following product will be removed from destination: DEC AXPVMS DWMOTIF V1.2-6 DISK$2:[VMS$COMMON.] Portion done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% **** DECwindows Motif application and run-time support files DETECTED **** **** DECwindows device support files DETECTED **** ...100% The following product has been installed: DEC AXPVMS DWMOTIF V1.3-0 Layered Product The following product has been removed: DEC AXPVMS DWMOTIF V1.2-6 Layered Product DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif System reboot is required. Installation Verification Procedure can be run after reboot. $ Logout (continued on next page) A-4 POLYCENTER Software Installation Utility Sample Installation A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System Example A-1 (Cont.) Sample Installation of an Upgrade of the DECwindows Motif Software on an OpenVMS Alpha Version 7.3-1 System With Sufficient System Resources A-5 B _________________________________________________________________ Software Components If you installed DECwindows Motif 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 STATUS ------ ----------- ------ [000000] directory OK [000000]DEC-AXPVMS-DWMOTIF-V0103-1.PCSI$DESCRIPTION file OK [000000]DEC-AXPVMS-DWMOTIF-V0103-1.PCSI$TLB file OK [CDA$LIBRARY] directory OK [CDA$LIBRARY]CL_DAY.DOC_STYLE file OK [CDA$LIBRARY]DEFSTYLE.DDIF file OK [CDE$DEFAULTS] directory OK [CDE$DEFAULTS] directory OK [CDE$DEFAULTS.SYSTEM] directory OK [CDE$DEFAULTS.SYSTEM] directory OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS] directory OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C] directory OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DT.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCALC.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCREATE.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTFILE.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTHELLO.DAT file OK . . . B-1 _________________________________________________________________ Index A Bookreader _______________________________ copying customized files to Account quotas another directory, 1-6 See also Quotas saving customized files, 1-6 required for installation, Booting 1-8 DECwindows Motif, 3-1 Alternative console BYTLM parameter See Console required quota for ASTLM parameter installation, 1-8 required quota for C installation, 1-8 _______________________________ AUTHORIZE utility CDE, 3-5 using to change Quotas, 1-8 Components AUTOGEN utility DECwindows network transport preparing for installation, and base-system support, 1-13 1-3 rebooting the system, 1-18 DECwindows X11 Display Server using to change system , 1-3 parameters, 1-16 Console alternative, 3-4 B______________________________ main, 3-4 Backup Customize backing up a system disk, system after installation, 1-18 4-1 Base kit Customizing required disk space, 1-9 Bookreader files BIOLM parameter saving, 1-6 required quota for installation, 1-8 Blocks See Free blocks Index-1 D______________________________ G______________________________ DECwindows X11 Display Server Global pages customizing startup, 4-2 See Free global pages installing, 1-3 Global sections Desktop See Free global sections selecting, 2-11, 3-5 DIOLM parameter H required quota for _______________________________ installation, 1-8 Hardware Disk space supported by DECwindows Motif determining , 1-2 amount, 1-9 number of free blocks, I______________________________ 1-9 Installation requirements, 1-7 required IVP by component, 1-9 running E after starting the product _______________________________ , 3-2 ENQLM parameter required quota for L______________________________ installation, 1-8 Language variants Euro currency support installing, 2-14 selecting, 2-10 License registration, 1-2 Example programs Logging out required disk space, 1-9 notifying users, 1-18 F Low-Bandwidth X (LBX) _______________________________ IVP support, 3-2 FILLM parameter Low-Bandwidth X (LBX) support required quota for selecting, 2-11 installation, 1-8 Free blocks M______________________________ determining amount, 1-9 Main console, 3-4 Free global pages Memory requirements, 1-3 calculating, 1-14 required, 1-15 N Free global sections _______________________________ calculating, 1-14 New Desktop required, 1-15 selecting, 2-11, 3-5 Index-2 POLYCENTER Software O______________________________ Installation utility Operating system prerequisites (cont'd) using the POLYCENTER Software responding to questions Installation utility, 1-3 during installation, 2-3 Operator window, 3-4 running the installation command procedure, 2-5 P______________________________ selecting Euro support, 2-10 Page file size selecting LBX support, 2-11 setting, 1-15 selecting the desktop, 2-11 Parameters Postinstallation See System parameters determining and reporting PCSI installation problems, 4-3 checking tasks programming environment, customizing DECwindows 2-9 Motif, 4-2 displaying Postinstallation tasks, 3-1 language variants, 2-14 choosing an alternate console installing , 3-4 TIS support, 2-14 running the IVP, 3-2 selecting Euro support, 2-10 starting DECwindows Motif selecting LBX support, 2-11 software, 3-1 verifying Prerequisite software applications and run-time using the POLYCENTER Software support files, 2-16 Installation utility, 1-3 device support files, Programming 2-16 environment system parameters, 2-7 disk space requirements, POLYCENTER Software 1-9 Installation utility saving, 2-9 accessing DCL help, 2-2 support backing up the system disk, compatibility in the 2-2 XUI and OSF/Motif confirming your responses to environments, 1-5 questions, 2-3 OSF/Motif Release 1.1.3, displaying 1-5 messages when the Q installation fails, _______________________________ 2-18 Quotas extracting the release notes, minimum required for 2-3 installation, 1-7 prerequisites for verifying and changing, 1-8 installation, 1-3 Index-3 System parameters R______________________________ changing (cont'd) Release notes by using the AUTOGEN accessing utility, 1-16 POLYCENTER Software values, 1-16 Installation utility, checking 2-3 values, 1-13 extracting to a file minimum required, 1-11 POLYCENTER Software modifying Installation utility, incremental adjustments, 2-3, 2-4 1-16 recalculating, 1-18 S______________________________ setting WINDOW_SYSTEM, 3-1 Selecting a desktop, 3-5 T Server startup _______________________________ customizing, 4-2 TIS support Shutting down the system installing, 2-14 notifying users, 1-18 Tuning the system, 4-1 Software required operating system W______________________________ version, 1-3 WINDOW_SYSTEM system parameter Starting DECwindows Motif, 3-1 setting, 3-1 SYSGEN utility checking system parameter values, 1-13 preparing for installation, 1-13 System shutdown notifying users, 1-18 System disk backing up, 2-2 determining number of free blocks, 1-9 free space required for installation, 1-9 System Generation utility See SYSGEN utility System parameters adding new parameters, 1-16 changing Index-4