HP_DECwindows_Motif_/Hanzi_for_OpenVMS_Alpha________ Installation Guide March 2005 This manual provides step-by-step instructions for installing HP DECwindows Motif /Hanzi for OpenVMS Alpha. Revision/Update This manual supersedes the Information: DECwindows Motif /Hanzi Version 1.2-6 for OpenVMS Installation Guide. Operating System: OpenVMS Alpha Version 7.3-2 Software Version: HP DECwindows Motif /Hanzi for OpenVMS Alpha, Version 1.3-1 Hewlett-Packard Company Palo Alto, California ________________________________________________________________ March 2005 © 2005 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. 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-8 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-9 1.5.4.3 Setting the Size of the Page File........... 1-10 1.5.4.4 Changing System Parameter Values Using the AUTOGEN Utility............................. 1-11 1.5.5 Backing Up Your System Disk ................... 1-12 1.5.6 Notifying Other Users ......................... 1-13 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 International Motif kit ............ 2-4 2.3.1.1 Starting the Installation................... 2-4 2.3.1.2 Starting the Installation................... 2-4 2.3.1.3 The Installation Dialog..................... 2-4 2.3.1.4 Execution Dialog............................ 2-5 2.3.1.5 Reviewing Final Installation Notes.......... 2-5 2.3.2 Installing Hanzi Motif kit .................... 2-6 2.3.2.1 Starting the Installation................... 2-6 2.3.2.2 Starting the Installation................... 2-6 2.3.2.3 The Installation Dialog..................... 2-6 2.3.2.4 Execution Dialog............................ 2-7 2.3.2.5 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 International Kit ............................... A-1 A.2 Sample Installation of DECwindows Motif Hanzi Kit ................................................. A-2 B Software Components Index Tables 1-1 Process Quotas for the Installation Account ... 1-4 1-2 Approximate Required Disk Space by Component (in Blocks).................................... 1-6 1-3 Minimum Required System Parameter Values ...... 1-7 1-4 Required Number of Contiguous Free Global Pages and Free Global Sections....................... 1-10 1-5 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 /Hanzi 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 /Hanzi for OpenVMS Alpha software. o Chapter 2 discusses how to install HP DECwindows Motif /Hanzi for OpenVMS Alpha using the POLYCENTER Software Installation utility. o Appendix A presents a sample DECwindows Motif 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 /Hanzi 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 /Hanzi for OpenVMS Alpha software: o HP DECwindows Motif for OpenVMS Alpha New Features o HP DECwindows Motif for OpenVMS Alpha Release Notes o Getting Started With the New Desktop o Managing DECwindows Motif for OpenVMS Systems v 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 Reader's Comments HP welcomes your comments on this manual. Please send comments to either of the follwing 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.hp.com/go/openvms/doc/order Conventions HP DECwindows Motif /Hanzi for OpenVMS Alpha 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 /Hanzi for OpenVMS Alpha software. vi 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. vii [ ] 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. viii 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. ix 1 _________________________________________________________________ Preparing to Install the Software This chapter describes the preparation and requirements for installing HP DECwindows Motif /Hanzi for OpenVMS Alpha software using either the POLYCENTER Software Installation utility. ________________________ Note ________________________ HP strongly recommends that you read the release notes before proceeding with the installation. The HP DECwindows Motif /Hanzi 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 Before you install and run HP DECwindows Motif /Hanzi 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 1-1 Preparing to Install the Software 1.1 License Registration is provided separately to a location based on your license order. If you are installing HP DECwindows Motif /Hanzi for OpenVMS Alpha 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 HP DECwindows Motif /Hanzi for OpenVMS Alpha 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 HP DECwindows Motif /Hanzi 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. 1.2 Supported Hardware HP DECwindows Motif /Hanzi for OpenVMS Alpha software can be installed on any supported Alpha processor. For a complete list of supported hardware, see the HP DECwindows Motif /Hanzi for OpenVMS Alpha Software Product Description (SPD). 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 /Hanzi 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 /Hanzi for OpenVMS Alpha software requires one of the following operating systems: o OpenVMS Alpha Version 7.3-2 If your system is not running the version before you attempt to install HP DECwindows Motif /Hanzi for OpenVMS Alpha, the installation fails. A minimum of 128 MB of memory is required for OpenVMS Alpha systems. OpenVMS locale support kit is required on OpenVMS Alpha. Please install VMSI18N V7.3-2 ECO1 for OpenVMS Alpha V7.3- 2. o ALPVMSI18N04E1_073 for OpenVMS Alpha V7.3-2 ________________________ Note ________________________ Remedial kits for HP products are available online at the HP IT Resource Center (ITRC). Use of the ITRC patch download site requires user registration and login. Registration is open to all users and no service contract is required. You can register and log in from the following URL: http://www2.itrc.hp.com/service/patch/mainPage.do You can also use FTP to access patches from the following location: ftp://ftp.itrc.hp.com/openvms_patches ______________________________________________________ 1-3 Preparing to Install the Software 1.4 Required Software For more information of OpenVMS locale support kit, please contact your local HP office. Please answer yes to the question about GB18030,Chinese and Unicode support. * Do you want GB18030 support [YES]? yes * Do you want Chinese support (not including GB18030) [YES]? yes * Do you want Unicode support [YES]? yes HP DECwindows Motif /Hanzi for OpenVMS Alpha requires installation of HP DECwindows Motif V1.3-1 (US kit). Please install V1.3-1 US kit first and then install V1.3-1 Hanzi kit. For installation of the US kit, please refer to DECwindows Motif Version 1.3-1 for OpenVMS Alpha Installation Guide. 1.5 Installation Procedure Requirements This section discusses the requirements for installing the HP DECwindows Motif /Hanzi 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 (continued on next page) 1-4 Preparing to Install the Software 1.5 Installation Procedure Requirements Table 1-1 (Cont.) Process Quotas for the Installation __________________Account__________________________________ Quota_Name__Value__________________________________________ 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 = 32768 UAF> SHOW account-name UAF> EXIT $ LOGOUT After you change the quotas for the installation account, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation. User account quotas are stored in the file SYS$SYSTEM:SYSUAF.DAT. For more information about modifying account quotas, see the description of the AUTHORIZE utility in the OpenVMS System Management Utilities Reference Manual. 1.5.2 Disk Space Use Table 1-2 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. 1-5 Preparing to Install the Software 1.5 Installation Procedure Requirements 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. ______________________________________________________ Table 1-2 Approximate Required Disk Space by Component (in __________Blocks)__________________________________________ Component___Value__________________________________________ Hanzi_______320,000________________________________________ 1.5.3 System Parameters Table 1-3 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings. 1-6 Preparing to Install the Software 1.5 Installation Procedure Requirements Table_1-3_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 64 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 IMGREG_PAGES 2,000 [1]If_you_have_installed_other_software_that_uses_global___ pages or global sections, you might need a higher minimum value. When you boot your system and DECwindows Motif starts, the values of free GBLPAGES and GBLSECTIONS are checked for your system. If you do not have sufficient values for GBLPAGES and GBLSECTIONS, the DECwindows Motif startup procedure prints a warning and provides a recommended value for these parameters. (continued on next page) 1-7 Preparing to Install the Software 1.5 Installation Procedure Requirements Table_1-3_(Cont.)_Minimum_Required_System_Parameter_Values_ System Parameter________Value_____________________________________ 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 /Hanzi 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.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> 1-8 Preparing to Install the Software 1.5 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-3, 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-3, you can continue with the product installation. However, to install and run HP DECwindows Motif /Hanzi 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: $ 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-9 Preparing to Install the Software 1.5 Installation Procedure Requirements $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 See Table 1-4 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-4 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 75,000 blocks on OpenVMS Alpha systems. However, these sizes may be too small on systems where a large number of applications are run. On a heavily loaded system it may be possible to achieve large performance improvements by increasing the size of the page file by a factor of two or more. Normally you should run AUTOGEN with feedback and let AUTOGEN calculate the size of the page file based on the usage pattern on your system. To run AUTOGEN with feedback, enter the following DCL command: $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT FEEDBACK 1-10 Preparing to Install the Software 1.5 Installation Procedure Requirements 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-5 lists the system parameters that you need to adjust incrementally. Table 1-5 Recommended System Parameter Values to Use with __________the_ADD__Option__________________________________ System Parameter________Increment_________________________________ GBLSECTIONS 280 GBLPAGES 92,000 (continued on next page) 1-11 Preparing to Install the Software 1.5 Installation Procedure Requirements Table 1-5 (Cont.) Recommended System Parameter Values to __________________Use_with_the_ADD__Option_________________ System Parameter________Increment_________________________________ 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-12 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 Hanzi 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-13 2 _________________________________________________________________ Using the POLYCENTER Software Installation Utility This chapter describes how to install and configure HP DECwindows Motif /Hanzi for OpenVMS Alpha software using the POLYCENTER Software Installation utility on Alpha. The HP DECwindows Motif /Hanzi for OpenVMS Alpha product supports POLYCENTER Software installations using the Digital Command Language (DCL) interface. This chapter presents information about the following topics: o Section 2.1, Accessing Help Information o Section 2.2, Extracting and Printing the Product Release Notes o Section 2.3, Installing the Software o Section 2.4, 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 o Discussing differences between the POLYCENTER Software Installation utility and the VMSINSTAL procedure 2-1 Using the POLYCENTER Software Installation Utility Refer to Section 1.4 for information about prerequisite software and licenses. _______________________ Caution _______________________ If you do not have a satisfactory backup copy of your system disk, do not attempt to install HP DECwindows Motif /Hanzi 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 /Hanzi 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 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_HANZI, at the DCL prompt. 2-2 Using the POLYCENTER Software Installation Utility 2.2 Extracting and Printing the Product Release Notes For example: $ DEFINE PCSI$SOURCE DKA400:[CMOTIF131] $ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF_UI_HANZI 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 /Hanzi for OpenVMS Alpha software using the POLYCENTER Software Installation utility. HP DECwindows Motif /Hanzi for OpenVMS Alpha consists of two kits o International Motif kit (DEC-AXPVMS-DWMOTIF_I18N-V0103- 1A-1.PCSI$COMPRESSED) o Hanzi Motif kit (DEC-AXPVMS-DWMOTIF_UI_HANZI-V0103-1- 1.PCSI$COMPRESSED) They are in the same directory of CD-ROM. First, install International Motif kit, then install Hanzi 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 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. 2-3 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software Then a question is displayed asking whether you are satisfied with your answers and whether you want to continue with the installation. If you decide to change your responses, type No and press the Return key. You can then either reenter your responses or answer No and exit from the installation utility. o Stop the installation by pressing Ctrl/Y. Note that this option is not recommended. 2.3.1 Installing International Motif kit 2.3.1.1 Starting the Installation To start the POLYCENTER Software Installation utility, enter the following commands at the DCL prompt: $ DEFINE PCSI$SOURCE device:[dir] where device and dir are the names of the device and directory of the kit. 2.3.1.2 Starting the Installation Next, invoke the POLYCENTER Software Installation utility: $ PRODUCT INSTALL DWMOTIF_I18N 2.3.1.3 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.3-1A 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.3-1A: DECwindows Motif /I18N Copyright 2005 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company 2-4 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software * This product does not have any configuration options. 2.3.1.4 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.3-1A DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90% 2.3.1.5 Reviewing Final Installation Notes If the installation is successful, the dialog displays a list of all products installed and removed. Finally, the procedure displays final installation notes for the DECwindows Motif product. ...100% The following product has been installed: DEC AXPVMS DWMOTIF_I18N V1.3-1A Layered Product DEC AXPVMS DWMOTIF_I18N V1.3-1A: 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-5 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2 Installing Hanzi Motif kit 2.3.2.1 Starting the Installation To start the POLYCENTER Software Installation utility, enter the following commands at the DCL prompt: $ DEFINE PCSI$SOURCE device:[dir] where device and dir are the names of the device and directory of the kit. 2.3.2.2 Starting the Installation Next, invoke the POLYCENTER Software Installation utility: $ PRODUCT INSTALL DWMOTIF_UI_HANZI 2.3.2.3 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_HANZI V1.3-1 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_HANZI V1.3-1: DECwindows Motif/HANZI Copyright 2005 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company This product uses the PAK: DW-MOTIF and DW-MOTIF-UI-HANZI * This product does not have any configuration options. 2-6 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2.4 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_HANZI V1.3-1 DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90% 2.3.2.5 Reviewing Final Installation Notes If the installation is successful, the dialog displays a list of all products installed and removed. Finally, the procedure displays final installation notes for the DECwindows Motif product. ...100% The following product has been installed: DEC AXPVMS DWMOTIF_UI_HANZI V1.3-1 Layered Product DEC AXPVMS DWMOTIF_UI_HANZI V1.3-1: DECwindows Motif/HANZI This product requires the following SYSGEN parameters: GBLPAGES add 2900 This product requires the following SYSGEN parameters: GBLSECTIONS add 17 Installation of DECwindows Motif/Hanzi for OpenVMS Alpha completed. Installation Verification Procedure can be run after reboot. The IVP is SYS$TEST:DECW$IVP_ZH_CN.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 From V1.2-6, the default locale is changed zh_CN.GB18030 from zh_CN.dechanzi. If you need to change the default locale to zh_CN.dechanzi, do the following tasks: 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_CN.GB18030" to "zh_ CN.dechanzi". 3. Modify the following file: SYS$COMMON:[CDE$DEFAULTS.SYSTEM.CONFIG]XCONFIG.DAT The following line is changed "zh_CN.GB18030" to "zh_ CN.dechanzi". Dtlogin*language: zh_CN.GB18030 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.3-1 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 International Kit $ PRODUCT INSTALL DWMOTIF_I18N/SOURCE=SYS$SYSDEVICE:[KIT] The following product has been selected: DEC AXPVMS DWMOTIF_I18N V1.3-1A 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.3-1A: DECwindows Motif/I18N Copyright 2005 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.3-1A 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.3-1A Layered Product DEC AXPVMS DWMOTIF_UI_I18N V1.3-1A: 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. A-1 POLYCENTER Software Installation Utility Sample Installations A.1 Sample Installation of DECwindows Motif International Kit You can install Locale Language Variant of DECwindows Motif. A.2 Sample Installation of DECwindows Motif Hanzi Kit $ PRODUCT INSTALL DWMOTIF_UI_HANZI/SOURCE=SYS$SYSDEVICE:[KIT] The following product has been selected: DEC AXPVMS DWMOTIF_UI_HANZI V1.3-1 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_HANZI V1.3-1: DECwindows Motif/Hanzi Copyright 2005 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company This product uses the PAK: DW-MOTIF and DW-MOTIF-UI-HANZI * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF_UI_HANZI V1.3-1 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_HANZI V1.3-1 Layered Product DEC AXPVMS DWMOTIF_UI_HANZI V1.3-1: DECwindows Motif /Hanzi This product requires the following SYSGEN parameters: GBLPAGES add 2900 This product requires the following SYSGEN parameters: GBLSECTIONS add 17 Installation of DECwindows Motif/Hanzi for OpenVMS Alpha completed. Installation Verification Procedure can be run after reboot. The IVP is SYS$TEST:DECW$IVP_ZH_CN.COM. System reboot is required. A-2 B _________________________________________________________________ Software Components If you installed HP DECwindows Motif /Hanzi for OpenVMS Alpha 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_hanzi 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-6 installation, 1-4 number of free blocks, AUTHORIZE utility 1-6 using to change Quotas, 1-5 required AUTOGEN utility by component, 1-6 preparing for installation, 1-8 E______________________________ rebooting the system, 1-12 ENQLM parameter using to change system required quota for parameters, 1-11 installation, 1-4 B Example programs _______________________________ required disk space, 1-6 Backup backing up a system disk, F______________________________ 1-12 FILLM parameter Base kit required quota for required disk space, 1-6 installation, 1-4 BIOLM parameter Free blocks required quota for determining amount, 1-6 installation, 1-4 Free global pages Blocks calculating, 1-9 See Free blocks required, 1-10 BYTLM parameter Free global sections required quota for calculating, 1-9 installation, 1-4 required, 1-10 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-13 environment disk space requirements, M 1-6 _______________________________ Memory requirements, 1-3 Q______________________________ O Quotas _______________________________ minimum required for Operating system prerequisites installation, 1-4 using the POLYCENTER Software verifying and changing, 1-5 Installation utility, 1-3 R______________________________ P______________________________ Release notes Page file size accessing setting, 1-10 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-2 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-13 See SYSGEN utility Software System parameters required operating system adding version, 1-3 new parameters, 1-11 SYSGEN utility changing checking system parameter by using the AUTOGEN values, 1-8 utility, 1-11 preparing for installation, values, 1-11 1-8 checking System values, 1-8 shutdown minimum required, 1-6 notifying users, 1-13 modifying System disk incremental adjustments, backing up, 2-2 1-11 determining recalculating, 1-12 number of free blocks, 1-6 T______________________________ Translated-image support required disk space, 1-6 Index-3