hp_DECwindows_Motif/Hanyu_for_hp_OpenVMS_Alpha______ Installation Guide July 2003 This manual provides instructions for installing HP DECwindows Motif/Hanyu for HP OpenVMS Alpha Version 1.3. Revision/Update Information: This manual supersedes the DECwindows Motif /Hanyu Version 1.2 for OpenVMS Installation Guide. Operating System: HP OpenVMS Alpha Version 7.3-1 Software Version: HP DECwindows Motif /Hanyu for HP OpenVMS Alpha Version 1.3 Hewlett-Packard Company Palo Alto, California ________________________________________________________________ © 2003 Hewlett-Packard Development Company, L.P. Motif, OSF/1, UNIX, and the "X" device are registered trademarks and The Open Group is a trademark of The Open Group in the U.S. and other countries. Confidential computer software. Valid license from HP and/or its subsidiaries required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Neither HP or any of its subsidiaries shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. _________________________________________________________________ Contents Preface................................................... vii 1 Preparing to Install the Software 1.1 Prerequisite Software............................ 1-1 1.1.1 OpenVMS Alpha V7.3-1 .......................... 1-1 1.1.2 OpenVMS XPG4 Locale Data File kit ............. 1-1 1.1.3 DECwindows Motif for OpenVMS Alpha V1.3 ....... 1-2 1.2 License Registration............................. 1-2 1.3 Installation Procedure Requirements.............. 1-2 1.3.1 Disk Space .................................... 1-2 1.3.2 SYSTEM Account Quota .......................... 1-2 2 Installation of the Software 2.1 Installation of DECwindows Motif/Hanyu........... 2-1 2.1.1 PCSI kits ..................................... 2-1 2.1.2 Installation of International Motif kit ....... 2-1 2.1.3 Installation of Hanyu Motif kit ............... 2-2 2.1.4 Post installation tasks ....................... 2-2 2.2 Upgrade installation from previous versions...... 2-2 3 After Installing the Software 3.1 Setting the System Parameters and Reboot......... 3-1 3.2 Running the IVP.................................. 3-2 3.3 Process Account Quota............................ 3-2 iii A Sample Installation A.1 Sample Installation of International Motif kit... A-1 A.2 Sample Installation on Hanyu Motif kit........... A-3 B Software Components Examples A-1 Sample Installation of International Motif kit............................................ A-1 A-2 Sample Installation of Hanyu Motif kit ........ A-3 iv _________________________________________________________________ Preface Intended Audience This manual is intended for anyone who plans to install the HP DECwindows Motif/Hanyu for HP OpenVMS Alpha Version 1.3 software. Document Structure This manual contains the following chapters and appendixes: o Chapter 1 discusses how to prepare for installing DECwindows Motif/Hanyu software. o Chapter 2 discusses how to install DECwindows Motif /Hanyu using the POLYCENTER Software Installation utility. o Chapter 3 provides the tasks to be done after the installation. o Appendix A presents a sample DECwindows Motif/Hanyu installation using the POLYCENTER Software Installation utility on an OpenVMS Alpha Version 7.3-1 system. o Appendix B shows how to obtain a list of the software components for the DECwindows Motif/Hanyu product using the POLYCENTER Software Installation utility. Conventions All uses of DECwindows Motif/Hanyu refer to the HP DECwindows Motif/Hanyu for HP OpenVMS Alpha software. vii 1 _________________________________________________________________ Preparing to Install the Software This chapter describes the preparation and requirements for installing HP DECwindows Motif/Hanyu for HP OpenVMS Alpha Version 1.3 software. 1.1 Prerequisite Software Prior to install DECwindows Motif/Hanyu V1.3, the following products must be installed and configured properly: o OpenVMS Alpha V7.3-1 o OpenVMS XPG4 Locale Data File kit o DECwindows Motif for OpenVMS Alpha V1.3 1.1.1 OpenVMS Alpha V7.3-1 Refer to "OpenVMS Alpha Version 7.3-1 Upgrade and Installation Manual" for the installation of OpenVMS Alpha V7.3-1. 1.1.2 OpenVMS XPG4 Locale Data File kit DECwindows Motif/Hanyu V1.3 requires Hanyu locale database. The locale database is provided by OpenVMS XPG4 Locale Data File kit. The kit is included in the Layered Products CD-ROM of OpenVMS Alpha V7.3-1. Mount the Layered Products CD-ROM. $ MOUNT/OVER=ID device Where device is the device name of CD-ROM drive on your system. Install XPG4 Locale Database kit. $ @SYS$UPDATE:VMSINSTAL ALPVMSI18N02_073 device:[VMSI18N_ALPHA073.KIT] 1-1 Preparing to Install the Software 1.1 Prerequisite Software During the installation, select "Chinese support (not including GB18030)". Other language supports are not required. * Do you want European and US support [YES]? no * Do you want GB18030 support [YES]? no * Do you want Chinese support (not including GB18030) [YES]? yes * Do you want Japanese support [YES]? no * Do you want Korean support [YES]? no * Do you want Thai support [YES]? no * Do you want Unicode support [YES]? no 1.1.3 DECwindows Motif for OpenVMS Alpha V1.3 Refer to "hp DECwindows Motif for OpenVMS Alpha Installation Guide" for the installation of DECwindows Motif for OpenVMS Alpha V1.3. 1.2 License Registration DECwindows Motif/Hanyu V1.3 requires the Hanyu Motif license DW-MOTIF-UI-HANYU in addition to the license for base product (DW-MOTIF). Register and load those licenses before installing DECwindows Motif/Hanyu V1.3. 1.3 Installation Procedure Requirements 1.3.1 Disk Space The installation of DECwindows Motif/Hanyu V1.3 requires 300,000 blocks of free disk spaces in addition to the base product. 1.3.2 SYSTEM Account Quota PGFLQUO quota of SYSTEM account must be set at least 100,000 prior to the installation. Use the OpenVMS AUTHORIZE utility to verify and to change process quotas for the installation account in the user authorization file (UAF). To change the PGFLQUO quota for the SYSTEM account, enter the following commands: 1-2 Preparing to Install the Software 1.3 Installation Procedure Requirements $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> SHOW SYSTEM UAF> MODIFY SYSTEM /PGFLQUO=100000 UAF> SHOW SYSTEM UAF> EXIT 1-3 2 _________________________________________________________________ Installation of the Software This chapter describes how to install HP DECwindows Motif /Hanyu for HP OpenVMS Alpha Version 1.3 software using the POLYCENTER Software Installation (PCSI) utility. 2.1 Installation of DECwindows Motif/Hanyu 2.1.1 PCSI kits DECwindows Motif/Hanyu V1.3 is provided as a part of Software Products Library. Refer to the "Master Index" of Software Products Library for the CD-ROM number for DECwindows Motif/Hanyu V1.3. DECwindows Motif/Hanyu V1.3 consists of two kits: o International Motif kit (DEC-AXPVMS-DWMOTIF_I18N-V0103- A-1.PCSI) o Hanyu Motif kit (DEC-AXPVMS-DWMOTIF_UI_HANYU-V0103-0- 1.PCSI) You need to install both kits to complete the installation of DECwindows Motif/Hanyu V1.3. They are in the same directory of CD-ROM. 2.1.2 Installation of International Motif kit First, you need to install International Motif kit. Mount the Software Products Library CD-ROM. $ MOUNT /OVER=ID device Where device is the device name of CD-ROM drive on your system. $ PRODUCT INSTALL DWMOTIF_I18N /SOURCE=device:[DWMA_ZH_TWU013.KIT] There are no options during the installation. Refer to Example A-1 for the sample installation log. 2-1 Installation of the Software 2.1 Installation of DECwindows Motif/Hanyu 2.1.3 Installation of Hanyu Motif kit Then install Hanyu Motif kit. $ PRODUCT INSTALL DWMOTIF_UI_HANYU /SOURCE=device:[DWMA_ZH_TWU013.KIT] There are no options during the installation. Refer to Example A-2 for the sample installation log. 2.1.4 Post installation tasks After the installation, you need to modify system parameters and reboot the system. Refer to Section 3.1 for detail. 2.2 Upgrade installation from previous versions If you are using DECwindows Motif/Hanyu V1.2-3 or prior and want to upgrade to V1.3, simply follow the same steps as described in Section 2.1. 2-2 3 _________________________________________________________________ After Installing the Software This chapter discusses the tasks that you need to perform after the HP DECwindows Motif/Hanyu for HP OpenVMS Alpha Version 1.3 installation is completed: o Section 3.1, Setting the System Parameters and Reboot o Section 3.2, Running the IVP o Section 3.3, Process Account Quota 3.1 Setting the System Parameters and Reboot International Motif kit requires the following SYSGEN parameters: o GBLPAGES add 3900 o GBLSECTIONS add 11 Hanyu Motif kit requires the following SYSGEN parameters: o GBLPAGES add 11400 o GBLSECTIONS add 40 To make incremental adjustments for both kits, edit the file SYS$SYSTEM:MODPARAMS.DAT and add the following lines: ADD_GBLPAGES = 15300 ADD_GBLSECTIONS = 51 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 3-1 After Installing the Software 3.1 Setting the System Parameters and 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. 3.2 Running the IVP After the system is rebooted and the startup is completed, the Start Session dialog box displays. The DECwindows Motif /Hanyu V1.3 software is now installed and running on your system. Login to SYSTEM account and run the Installation Verification Procedure (IVP) to verify that the installation is complete and accurate. $ @SYS$TEST:DECW$IVP_ZH_TW.COM 3.3 Process Account Quota To use DECwindows Motif/Hanyu, PGFLQUO quota of each user account must be set at least 100,000. Use the OpenVMS AUTHORIZE utility to verify and to change process quotas for the installation account in the user authorization file (UAF). To change the PGFLQUO quota for each account, enter the following commands: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> SHOW UAF> MODIFY /PGFLQUO=100000 UAF> SHOW UAF> EXIT After you change the quotas for each user account, log out of the account and log in again for the new quotas to take effect. 3-2 A _________________________________________________________________ Sample Installation This appendix contains a sample installation of the HP DECwindows Motif/Hanyu for HP OpenVMS Alpha Version 1.3 software on the OpenVMS Alpha Version 7.3-1 operating system. A.1 Sample Installation of International Motif kit Example A-1 contains a sample of International Motif kit installation on an OpenVMS Alpha Version 7.3-1. Example A-1 Sample Installation of International Motif kit (continued on next page) A-1 Sample Installation A.1 Sample Installation of International Motif kit Example A-1 (Cont.) Sample Installation of International Motif kit $ PRODUCT INSTALL DWMOTIF_I18N /SOURCE=DQA0:[DWMA_ZH_TWU013] The following product has been selected: DEC AXPVMS DWMOTIF_I18N V1.3-A 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-A: DECwindows Motif/I18N Copyright 2003 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_I18N V1.3-A DISK$ALPHASYS:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...90%...100% The following product has been installed: DEC AXPVMS DWMOTIF_I18N V1.3-A Layered Product DEC AXPVMS DWMOTIF_I18N V1.3-A: 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. (continued on next page) A-2 Sample Installation A.1 Sample Installation of International Motif kit Example A-1 (Cont.) Sample Installation of International Motif kit You can install Locale Language Variant of DECwindows Motif. $ A.2 Sample Installation on Hanyu Motif kit Example A-2 contains a sample of Hanyu Motif kit installation on an OpenVMS Alpha Version 7.3-1. Example A-2 Sample Installation of Hanyu Motif kit $ PRODUCT INSTALL DWMOTIF_UI_HANYU /SOURCE=DQA0:[DWMA_ZH_TWU013] The following product has been selected: DEC AXPVMS DWMOTIF_UI_HANYU V1.3-0 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF_UI_HANYU V1.3-0: DECwindows Motif/Hanyu Copyright 2003 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company This product uses the PAK: DW-MOTIF and DW-MOTIF-UI-HANYU * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: (continued on next page) A-3 Sample Installation A.2 Sample Installation on Hanyu Motif kit Example A-2 (Cont.) Sample Installation of Hanyu Motif kit DEC AXPVMS DWMOTIF_UI_HANYU V1.3-0 DISK$ALPHASYS:[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.3-0 Layered Product DEC AXPVMS DWMOTIF_UI_HANYU V1.3-0: DECwindows Motif/Hanyu This product requires the following SYSGEN parameters: GBLPAGES add 11400 This product requires the following SYSGEN parameters: GBLSECTIONS add 40 Installation Verification Procedure (IVP) can be run after reboot. The IVP is SYS$TEST:DECW$IVP_ZH_TW.COM. Installation of DECwindows Motif/Hanyu for OpenVMS Alpha completed. Check whether this product have the following PAKs registerd and loaded. PAK Name DW-MOTIF DW-MOTIF-UI-HANYU These are required to run any DECwindows Motif/Hanyu for OpenVMS application. Reboot the system to start DECwindows Motif/Hanyu for OpenVMS Alpha. $ A-4 B _________________________________________________________________ Software Components When you installed HP DECwindows Motif/Hanyu for HP OpenVMS Alpha Version 1.3, 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_I18N Following is a sample output from this command. ----------------------------------------------- ----------------- -------- OBJECT NAME OBJECT TYPE STATUS ----------------------------------------------- ----------------- -------- [CDA$LIBRARY] directory OK [CDA$LIBRARY]ADECW$DEFSTYLE.DDIF file OK [CDE$DEFAULTS] directory OK [CDE$DEFAULTS.SYSTEM] directory OK [CDE$DEFAULTS.SYSTEM.APPCONFIG] directory OK [CDE$DEFAULTS.SYSTEM.APPCONFIG.HELP] directory OK [CDE$DEFAULTS.SYSTEM.APPCONFIG.HELP.C] directory OK [CDE$DEFAULTS.SYSTEM.APPCONFIG.HELP.C]DXIM.SDL file OK . . . $ PRODUCT SHOW OBJECT/PRODUCT=DWMOTIF_UI_HANYU Following is a sample output from this command. B-1 Software Components ----------------------------------------------- ----------------- -------- 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-2