____________________________________________________ HP DECwindows Motif /Hanyu for OpenVMS Alpha Installation Guide April 2007 This manual provides step-by-step instructions for installing HP DECwindows Motif /Hanyu for OpenVMS Alpha Version 1.6. Revision/Update Information: This manual supersedes the DECwindows Motif /Hanyu Version 1.3 for OpenVMS Installation Guide. Operating System: OpenVMS Alpha Version 8.3 Software Version: HP DECwindows Motif /Hanyu for OpenVMS Alpha Version 1.6 Hewlett-Packard Company Palo Alto, California ________________________________________________________________ April 2007 © 2007 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. UNIX is a registered trademark of The Open Group. The X device is a trademark of X/Open Company Ltd. in the UK and other countries. Printed in the US The HP OpenVMS documentation set is available on CD-ROM. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install the Software 1.1 License Registration.......................... 1-1 1.2 Supported Hardware............................ 1-2 1.3 Prerequisites for the Installation Procedures.................................... 1-3 1.4 Required Software............................. 1-3 1.5 Installation Procedure Requirements........... 1-4 1.5.1 Process Account Quotas.................... 1-4 1.5.2 Disk Space................................ 1-5 1.5.3 System Parameters......................... 1-6 1.5.4 Additional System Maintenance Procedures................................ 1-7 1.5.4.1 Checking System Parameter Values........ 1-8 1.5.4.2 Calculating the Number of Free Global Pages and Global Sections............... 1-8 1.5.4.3 Setting the Size of the Page File....... 1-9 1.5.4.4 Changing System Parameter Values Using the AUTOGEN Utility..................... 1-10 1.5.5 Backing Up Your System Disk............... 1-11 1.5.6 Notifying Other Users..................... 1-12 2 Using the POLYCENTER Software Installation Utility 2.1 Accessing Help Information.................... 2-2 2.2 Extracting and Printing the Product Release Notes......................................... 2-2 2.3 Installing the Software....................... 2-3 iii 2.3.1 Installing Internationalization Motif kit....................................... 2-4 2.3.1.1 Starting the Installation............... 2-4 2.3.1.2 The Installation Dialog................. 2-4 2.3.1.3 Execution Dialog........................ 2-5 2.3.1.4 Reviewing Final Installation Notes...... 2-5 2.3.2 Installing Hanyu Motif kit................ 2-5 2.3.2.1 Starting the Installation............... 2-6 2.3.2.2 The Installation Dialog................. 2-6 2.3.2.3 Execution Dialog........................ 2-7 2.3.2.4 Reviewing Final Installation Notes...... 2-7 2.4 Postinstallation Tasks........................ 2-8 2.4.1 Increase Page File Quota.................. 2-8 2.4.2 How to change the default locale.......... 2-8 2.5 Recovering from Errors........................ 2-8 A POLYCENTER Software Installation Utility Sample Installations A.1 Sample Installation of DECwindows Motif Internationalization Kit ..................... A-1 A.2 Sample Installation of DECwindows Motif Hanyu Kit .......................................... A-2 B Software Components Index Tables 1-1 Process Quotas for the Installation Account................................... 1-4 1-2 Minimum Required System Parameter Values.................................... 1-6 1-3 Required Number of Contiguous Free Global Pages and Free Global Sections............ 1-9 1-4 Recommended System Parameter Values to Use with the ADD_Option....................... 1-11 iv _________________________________________________________________ Preface Intended Audience This manual is intended for anyone who plans to install HP DECwindows Motif /Hanyu for OpenVMS Alpha software. Document Structure This manual contains the following chapters and appendixes: o Chapter 1 discusses how to prepare for installing HP DECwindows Motif /Hanyu for OpenVMS Alpha software. o Chapter 2 discusses how to install HP DECwindows Motif /Hanyu for OpenVMS Alpha using the POLYCENTER Software Installation utility. o Appendix A presents a sample DECwindows Motif I18n and Decwindows Motif /Hanyu installation using the POLYCENTER Software Installation utility on Alpha systems. o Appendix B shows how to obtain a list of the software components for the HP DECwindows Motif /Hanyu for OpenVMS Alpha product using the POLYCENTER Software Installation utility. Related Documents In addition to this manual, the following documents are useful when installing HP DECwindows Motif /Hanyu for OpenVMS Alpha software: o HP DECwindows Motif for OpenVMS New Features o HP DECwindows Motif for OpenVMS Release Notes v o HP DECwindows Motif /Hanyu for OpeVMS Alpha Release Notes 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.hp.com/go/openvms Conventions HP DECwindows Motif /Hanyu for OpenVMS Alpha contains a graphical user interface that is derived from the Common Desktop Environment (CDE). This interface is referred to throughout this document as the New Desktop. VMScluster systems are now referred to as OpenVMS Cluster systems. Unless otherwise specified, references to OpenVMS Clusters or clusters in this document are synonymous with VMSclusters. In this manual, every use of DECwindows and DECwindows Motif refers to HP DECwindows Motif /Hanyu for OpenVMS Alpha software. The following conventions are also used in this manual: Ctrl/x A sequence such as Ctrl/x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.) In the HTML version of this document, this convention appears as brackets, rather than a box. vi . . . Horizontal ellipsis points in examples indicate one of the following possibilities: o Additional optional arguments in a statement have been omitted. o The preceding item or items can be repeated one or more times. o Additional parameters, values, or other information can be entered. . Vertical ellipsis points indicate the . omission of items from a code example . or command format; the items are omitted because they are not important to the topic being discussed. ( ) In command format descriptions, parentheses indicate that you must enclose the choices in parentheses if you choose more than one. [ ] In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.) | In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options. { } In command format descriptions, braces surround a required choice of options; you must choose one of the options listed. vii text style This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason. In the HTML version of this document, this convention appears as italic text. italic text Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system messages (Internal error number), in command lines (/PRODUCER=name), and in command parameters in text (where dd represents the predefined code for the device type). UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege. Monospace type Monospace type indicates code examples and interactive screen displays. In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example. - A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line. numbers All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes-binary, octal, or hexadecimal-are explicitly indicated. viii 1 _________________________________________________________________ Preparing to Install the Software This chapter describes the preparation and requirements for installing HP DECwindows Motif /Hanyu for OpenVMS Alpha software using the POLYCENTER Software Installation utility. ________________________ Note ________________________ HP strongly recommends that you read the release notes before proceeding with the installation. The HP DECwindows Motif /Hanyu for OpenVMS Alpha product provides online release notes. For information about accessing the release notes, see Section 2.2. ______________________________________________________ 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 Software o Section 1.5, Installation Procedure Requirements 1.1 License Registration You must register and load your license for HP DECwindows Motif /Hanyu for OpenVMS Alpha before you run the Installation Verification Procedure (IVP) and use the software. 1-1 Preparing to Install the Software 1.1 License Registration 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 HP DECwindows Motif /Hanyu for OpenVMS Alpha 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. Before you install and run HP DECwindows Motif /Hanyu for OpenVMS Alpha 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. 1.2 Supported Hardware HP DECwindows Motif /Hanyu for OpenVMS Alpha software can be installed on any supported Alpha platform. For a complete list of supported hardware, see the HP DECwindows Motif /Hanyu for OpenVMS Alpha Software Product Description (SPD). A minimum of 128 MB of memory is required for OpenVMS Alpha systems. In general, 512 MB of memory is highly recommended. Refer to the support platform list in the OpenVMS SPD for more specific requirements. 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 HP DECwindows Motif /Hanyu for OpenVMS Alpha 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 to install your DECwindows Motif software. 1.4 Required Software The HP DECwindows Motif /Hanyu for OpenVMS Alpha software requires If your system is not running the version of operating system before you attempt to install HP DECwindows Motif /Hanyu for OpenVMS Alpha, the installation fails. The HP DECwindows Motif /Hanyu for OpenVMS Alpha software consists of the following two kits: o HP Internationalization (I18n) Motif kit o HP Hanyu Motif kit The HP DECwindows Motif /Hanyu for OpenVMS Alpha software requires the following software o OpenVMS Operating System Version 8.3 o OpenVMS Internationalization (I18n) locale support kit, VMSI18N, Version 8.3 o DECwindows Motif Version 1.6 OpenVMS Internationalization (I18n) locale support kit, VMSI18N, Version 8.3, is required on OpenVMS. Please answer yes to the question about Chinese locale support during the installation of the OpenVMS I18n locale support kit. * Do you want Chinese support [YES]? yes 1-3 Preparing to Install the Software 1.4 Required Software HP DECwindows Motif /Hanyu for OpenVMS Alpha requires installation of HP DECwindows Motif Version 1.6 (US kit). Please install Version 1.6 US kit first, I18n Motif kit second, and then install Hanyu Motif kit. For installation of the US kit, please refer to DECwindows Motif Version 1.6 for OpenVMS Installation Guide. 1.5 Installation Procedure Requirements This section discusses the requirements for installing the HP DECwindows Motif /Hanyu for OpenVMS Alpha 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.5.1 Process Account Quotas The installation procedure requires that the installation account has the minimum quotas shown in Table 1-1. Table_1-1_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.) 1-4 Preparing to Install the Software 1.5 Installation Procedure Requirements 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. For more information about modifying account quotas, see the description of the AUTHORIZE utility in the OpenVMS System Management Utilities Reference Manual. 1.5.2 Disk Space The installation of DECwindows Motif/Hanyu requires 320,000 blocks of free disk spaces in addition to the base product. 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 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-5 Preparing to Install the Software 1.5 Installation Procedure Requirements 1.5.3 System Parameters Table 1-2 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-2_Minimum_Required_System_Parameter_Values_________ System Parameter________Value_____________________________________ GBLSECTIONS 600[1] GBLPAGES 150,000[1] GBLPAGFIL 1,024 SWPOUTPGCNT 512 MAXBUF 8,192 CHANNELCNT 255 PROCSECTCNT 128 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 [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-6 Preparing to Install the Software 1.5 Installation Procedure Requirements Table_1-2_(Cont.)_Minimum_Required_System_Parameter_Values_ System Parameter________Value_____________________________________ PQL_MWSEXTENT 8,192 CLISYMTBL 512 GH_RES_CODE 1,584 IMGREG_PAGES 10,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.5.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 HP DECwindows Motif /Hanyu for OpenVMS Alpha 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 Preparing to Install the Software 1.5 Installation Procedure Requirements 1.5.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-2, increase the system parameter settings. Section 1.5.4.4 describes the procedures for using the AUTOGEN utility to increase these values. 1.5.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-2, you can continue with the product installation. However, to install and run HP DECwindows Motif /Hanyu for OpenVMS Alpha 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: $ DIRECTORY/SIZE SYS$LIBRARY:DCLTABLES.EXE This command returns the size (in blocks) of the file SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pages needed for the file. 1-8 Preparing to Install the Software 1.5 Installation Procedure Requirements Enter the WRITE command with the F$GETSYI lexical function to find the number of contiguous free global pages and the number of free global sections. The following example shows how to obtain this information at your terminal, which is the default for SYS$OUTPUT: $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 See Table 1-3 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.5.4.4, which describes the procedures for increasing these values using the AUTOGEN utility. Table 1-3 Required Number of Contiguous Free Global Pages __________and_Free_Global_Sections_________________________ System_Resource__Value_____________________________________ CONTIG_GBLPAGES 7,800 FREE_GBLSECTS_______28_____________________________________ 1.5.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 95,000 blocks on OpenVMS Alpha. 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. 1-9 Preparing to Install the Software 1.5 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 Guide to Setting Up an OpenVMS System. For more information about performance tuning in general, see the Guide to OpenVMS Performance Management. 1.5.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-4 lists the system parameters that you need to adjust incrementally. 1-10 Preparing to Install the Software 1.5 Installation Procedure Requirements Table 1-4 Recommended System Parameter Values to Use with __________the_ADD_Option___________________________________ System Parameter________Increment_________________________________ GBLSECTIONS 280 GBLPAGES 92,000 GBLPAGFIL 768 NPAGEDYN 300,000 PAGEDYN__________180,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.5.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-11 Preparing to Install the Software 1.5 Installation Procedure Requirements 1.5.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 DECwindows Hanyu installation, 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-12 2 _________________________________________________________________ Using the POLYCENTER Software Installation Utility This chapter describes how to install and configure HP DECwindows Motif /Hanyu for OpenVMS Alpha software using the POLYCENTER Software Installation utility on Alpha. The HP DECwindows Motif /Hanyu for OpenVMS Alpha product supports POLYCENTER Software installations using the DCL interface. This chapter presents information about the following topics: o Section 2.1, Accessing Help Information o Section 2.2, Extracting and Printing the Product Release Notes o Section 2.3, Installing the Software o Section 2.4, Postinstallation Tasks o Section 2.5, 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 Refer to Section 1.4 for information about prerequisite software and licenses. 2-1 Using the POLYCENTER Software Installation Utility _______________________ Caution _______________________ If you do not have a satisfactory backup copy of your system disk, do not attempt to install HP DECwindows Motif /Hanyu for OpenVMS Alpha software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your Alpha) before you install HP DECwindows Motif /Hanyu for OpenVMS Alpha 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 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 /Hanyu for 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_UI_HANYU, at the DCL prompt. For example: $ DEFINE PCSI$SOURCE DKA400:[PCSI_DWMOTIF16] $ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF_UI_HANYU 2-2 Using the POLYCENTER Software Installation Utility 2.2 Extracting and Printing the Product Release Notes Once you extract the release notes to a file, you can print the file. Note that you do not need to install the product before you extract the release notes. 2.3 Installing the Software The sections that follow take you through the stages of installing your HP DECwindows Motif /Hanyu for OpenVMS Alpha software using the POLYCENTER Software Installation utility. HP DECwindows Motif /Hanyu for OpenVMS Alpha consists of two kits o Internationalization Motif kit (DEC-AXPVMS-DWMOTIF_ I18N-V0106-1.PCSI$COMPRESSED) o Hanyu Motif kit (DEC-AXPVMS-DWMOTIF_UI_HANYU-V0106- 1.PCSI$COMPRESSED) The Internationalization Motif kit and Hanyu Motif kit are in the same directory of CD-ROM/DVD. You have to install Internationalization Motif kit first, then Hanyu Motif kit. 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 key to select options. o Press the 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. 2-3 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software o Stop the installation by pressing . Note that this option is not recommended. 2.3.1 Installing Internationalization Motif kit 2.3.1.1 Starting the Installation To start the POLYCENTER Software Installation utility, enter the following commands to point to the kit location at the DCL prompt: $ DEFINE PCSI$SOURCE device:[dir] where device and dir are the names of the device and directory of the kit. Next, invoke the POLYCENTER Software Installation utility: $ PRODUCT INSTALL DWMOTIF_I18N 2.3.1.2 The Installation Dialog The installation dialog begins by displaying the name of the product which PCSI is installing. You are then asked to verify that you wish to continue with the installation. The dialog continues with a display of product name, and copyright information. The following product has been selected: DEC AXPVMS DWMOTIF_I18N V1.6 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF_I18N V1.6: DECwindows Motif/I18N Copyright 2006 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company * This product does not have any configuration options. 2-4 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.1.3 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. ______________________________________________________ Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF_I18N V1.6 DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% 2.3.1.4 Reviewing Final Installation Notes If the installation is successful, the dialog displays a list of all products installed and removed. Finally, the procedure displays final installation notes for the DECwindows Motif product. The following product has been installed: DEC AXPVMS DWMOTIF_I18N V1.6 Layered Product DEC AXPVMS DWMOTIF_I18N V1.6: DECwindows Motif/I18N This product requires the following SYSGEN parameters: GBLPAGES add 3900 This product requires the following SYSGEN parameters: GBLSECTIONS add 11 Installation of DECwindows Motif/I18N for OpenVMS Alpha completed. You can install Locale Language Variant of DECwindows Motif. 2.3.2 Installing Hanyu Motif kit 2-5 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2.1 Starting the Installation To start the POLYCENTER Software Installation utility, enter the following commands to point to the kit location at the DCL prompt: $ DEFINE PCSI$SOURCE device:[dir] where device and dir are the names of the device and directory of the kit. Next, invoke the POLYCENTER Software Installation utility: $ PRODUCT INSTALL DWMOTIF_UI_HANYU 2.3.2.2 The Installation Dialog The installation dialog begins by displaying the name of the product which PCSI is installing. You are then asked to verify that you wish to continue with the installation. The dialog continues with a display of product name, copyright, and Product Authorization Key (PAK) information. The following product has been selected: DEC AXPVMS DWMOTIF_UI_HANYU V1.6 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF_UI_HANYU V1.6: DECwindows Motif/HANYU Copyright 2007 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company This product uses the PAK: DWMOTIF and DWMOTIF_UI_HANYU * This product does not have any configuration options. 2-6 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2.3 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. ______________________________________________________ Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF_UI_HANYU V1.6 DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% 2.3.2.4 Reviewing Final Installation Notes If the installation is successful, the dialog displays a list of all products installed and removed. Finally, the procedure displays final installation notes for the DECwindows Motif product. The following product has been installed: DEC AXPVMS DWMOTIF_UI_HANYU V1.6 Layered Product DEC AXPVMS DWMOTIF_UI_HANYU V1.6: DECwindows Motif /Hanyu This product requires the following SYSGEN parameters: GBLPAGES add 2900 This product requires the following SYSGEN parameters: GBLSECTIONS add 17 Installation of DECwindows Motif /Hanyu for OpenVMS Alpha completed. Installation Verification Procedure can be run after reboot. The IVP is SYS$TEST:DECW$IVP_ZH_TW.COM. System reboot is required. 2-7 Using the POLYCENTER Software Installation Utility 2.4 Postinstallation Tasks 2.4 Postinstallation Tasks 2.4.1 Increase Page File Quota After installation, system manager needs to increase every user's "Page File Quota". Every user needs at least 120,000 "Page File Quota". 2.4.2 How to change the default locale Since Version 1.2-6 release, the default locale is changed zh_TW.dechanyu. If you need to change the default locale to zh_TW.BIG5, do the following steps: 1. Login the system manager's account 2. Modify the following file: SYS$COMMON:[SYSMGR]DECW$DEFINE_LANG.COM In this file, you change "zh_TW.dechanyu" to "zh_ TW.BIG5". 3. Modify the following file: SYS$COMMON:[CDE$DEFAULTS.SYSTEM.CONFIG]XCONFIG.DAT The following line is changed "zh_TW.dechanyu" to "zh_ TW.BIG5". Dtlogin*language: zh_TW.BIG5 2.5 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-8 Using the POLYCENTER Software Installation Utility 2.5 Recovering from Errors 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.6 for OpenVMS has failed. If the installation fails, fix the problem and restart the installation procedure. 2-9 A _________________________________________________________________ POLYCENTER Software Installation Utility Sample Installations A.1 Sample Installation of DECwindows Motif Internationalization Kit $ PRODUCT INSTALL DWMOTIF_I18N /SOURCE=DISK$1:[KIT] Performing product kit validation ... %PCSI-I-VALPASSED, validation of DISK$1:[KIT]DEC-AXPVMS-DWMOTIF_ I18N-V0106--1.P CSI$COMPRESSED;1 succeeded The following product has been selected: DEC AXPVMS DWMOTIF_I18N V1.6 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF_I18N V1.6: DECwindows Motif/I18N Copyright 2006 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF_UI_I18N V1.6 DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS DWMOTIF_I18N V1.6 Layered Product DEC AXPVMS DWMOTIF_UI_I18N V1.6: DECwindows Motif/I18N This product requires the following SYSGEN parameters: GBLPAGES add 3900 A-1 POLYCENTER Software Installation Utility Sample Installations A.1 Sample Installation of DECwindows Motif Internationalization Kit This product requires the following SYSGEN parameters: GBLSECTIONS add 11 Installation of DECwindows Motif/I18N for OpenVMS Alpha completed. You can install Locale Language Variant of DECwindows Motif. A.2 Sample Installation of DECwindows Motif Hanyu Kit $ PRODUCT INSTALL DWMOTIF_UI_HANYU /SOURCE=DISK$1:[KIT] Performing product kit validation ... %PCSI-I-VALPASSED, validation of DISK$1:[KIT]DEC-AXPVMS-DWMOTIF_UI_ HANYU-V0106- -1.PCSI$COMPRESSED;1 succeeded The following product has been selected: DEC AXPVMS DWMOTIF_UI_HANYU V1.6 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF_UI_HANYU V1.6: DECwindows Motif/Hanyu Copyright 2007 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company This product uses the PAK: DWMOTIF and DWMOTIF_UI_HANYU * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF_UI_HANYU V1.6 DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS DWMOTIF_UI_HANYU V1.6 Layered Product DEC AXPVMS DWMOTIF_UI_HANYU V1.6: DECwindows Motif/Hanyu This product requires the following SYSGEN parameters: GBLPAGES add 2900 A-2 POLYCENTER Software Installation Utility Sample Installations A.2 Sample Installation of DECwindows Motif Hanyu Kit This product requires the following SYSGEN parameters: GBLSECTIONS add 17 Installation of DECwindows Motif/Hanyu for OpenVMS Alpha completed. Installation Verification Procedure can be run after reboot. The IVP is SYS$TEST:DECW$IVP_ZH_TW.COM. System reboot is required. A-3 B _________________________________________________________________ Software Components HP DECwindows Motif /Hanyu for OpenVMS Alpha was installed 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_ui_hanyu Following is a sample output from the command. ----------------------------------------------- ----------------- ------- OBJECT NAME OBJECT TYPE STATUS ----------------------------------------------- ----------------- ------- [CDE$DEFAULTS] directory OK [CDE$DEFAULTS.SYSTEM] directory OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS] directory OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.ZH_TW_BIG5] directory OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.ZH_TW_BIG5]DT.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.ZH_TW_BIG5]DTCALC.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.ZH_TW_BIG5]DTCREATE.DAT file OK . . . B-1 _________________________________________________________________ Index A______________________________ D______________________________ Account quotas DIOLM parameter See also Quotas required quota for required for installation, installation, 1-4 1-4 Disk space ASTLM parameter determining required quota for amount, 1-5 installation, 1-4 number of free blocks, AUTHORIZE utility 1-5 using to change Quotas, 1-4 required AUTOGEN utility by component, 1-5 preparing for installation, 1-7 E______________________________ rebooting the system, 1-11 ENQLM parameter using to change system required quota for parameters, 1-10 installation, 1-4 B Example programs _______________________________ required disk space, 1-5 Backup backing up a system disk, F______________________________ 1-11 FILLM parameter Base kit required quota for required disk space, 1-5 installation, 1-4 BIOLM parameter Free blocks required quota for determining amount, 1-5 installation, 1-4 Free global pages Blocks calculating, 1-8 See Free blocks required, 1-9 BYTLM parameter Free global sections required quota for calculating, 1-8 installation, 1-4 required, 1-9 Index-1 POLYCENTER Software G______________________________ Installation utility Global pages displaying (cont'd) See Free global pages messages when the Global sections installation fails, See Free global sections 2-9 extracting the release notes, H______________________________ 2-2 Hardware prerequisites for supported by DECwindows Motif installation, 1-3 , 1-2 responding to questions during installation, 2-3 running the installation I______________________________ command procedure, 2-4, Installation requirements, 1-4 2-6 Prerequisite software L______________________________ using the POLYCENTER Software License registration, 1-1 Installation utility, 1-3 Logging out Programming notifying users, 1-12 environment disk space requirements, M 1-5 _______________________________ Memory requirements, 1-2 Q______________________________ O Quotas _______________________________ minimum required for Operating system prerequisites installation, 1-4 using the POLYCENTER Software verifying and changing, 1-4 Installation utility, 1-3 R______________________________ P______________________________ Release notes Page file size accessing setting, 1-9 POLYCENTER Software Parameters Installation utility, See System parameters 2-2 POLYCENTER Software extracting to a file Installation utility POLYCENTER Software accessing DCL help, 2-2 Installation utility, backing up the system disk, 2-2, 2-3 2-1 confirming your responses to questions, 2-3 displaying Index-2 free space required for S______________________________ installation, 1-5 Shutting down the system System Generation utility notifying users, 1-12 See SYSGEN utility Software System parameters required operating system adding version, 1-3 new parameters, 1-10 SYSGEN utility changing checking system parameter by using the AUTOGEN values, 1-8 utility, 1-10 preparing for installation, values, 1-10 1-7 checking System values, 1-8 shutdown minimum required, 1-6 notifying users, 1-12 modifying System disk incremental adjustments, backing up, 2-1 1-10 determining recalculating, 1-11 number of free blocks, 1-5 T______________________________ Translated-image support required disk space, 1-5 Index-3