HP_DECwindows_Motif_/Hangul_for_OpenVMS_____________ Installation Guide April 2005 This manual provides step-by-step instructions for installing HP DECwindows Motif /Hangul for OpenVMS. Revision/Update Information: This manual supersedes the DECwindows Motif /Hangul Version 1.3- 1 for OpenVMS Alpha Installation Guide. Operating System: OpenVMS Version 8.2 Software Version: HP DECwindows Motif /Hangul for OpenVMS, Version 1.5 Hewlett-Packard Company Palo Alto, California ________________________________________________________________ April 2005 © 2005 Hewlett-Packard Development Company, L.P. Proprietary 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 and the "X" device are registered trademarks of The Open Group. SEG6434 The HP OpenVMS documentation set is available on CD-ROM. _________________________________________________________________ Contents Preface................................................... ix 1 Preparing to Install the Software 1.1 License Registration............................. 1-2 1.1.1 For OpenVMS Alpha Systems ..................... 1-2 1.1.2 For OpenVMS I64 Systems ....................... 1-3 1.2 Supported Hardware............................... 1-3 1.3 Prerequisites for the Installation Procedures.... 1-3 1.4 Required Software................................ 1-3 1.5 Installation Procedure Requirements.............. 1-5 1.5.1 Process Account Quotas ........................ 1-5 1.5.2 Disk Space .................................... 1-6 1.5.3 System Parameters ............................. 1-7 1.5.4 Additional System Maintenance Procedures ...... 1-10 1.5.4.1 Checking System Parameter Values............ 1-10 1.5.4.2 Calculating the Number of Free Global Pages and Global Sections......................... 1-11 1.5.4.3 Setting the Size of the Page File........... 1-12 1.5.4.4 Changing System Parameter Values Using the AUTOGEN Utility............................. 1-13 1.5.5 Backing Up Your System Disk ................... 1-14 1.5.6 Notifying Other Users ......................... 1-14 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 The Installation Dialog..................... 2-4 2.3.1.2.1 Execution Dialog ......................... 2-5 2.3.1.2.2 Reviewing Final Installation Notes ....... 2-5 2.3.2 Installing Hangul 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.2.1 Execution Dialog ......................... 2-6 2.3.2.2.2 Reviewing Final Installation Notes ....... 2-7 2.4 Recovering from Errors........................... 2-7 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 Hangul kit ............................................. A-2 B Software Components Index Tables 1-1 Process Quotas for the Installation Account ... 1-5 1-2 Approximate Required Disk Space (in Blocks) ... 1-7 1-3 Minimum Required System Parameter Values ...... 1-7 1-4 Minimum Required System Parameter Values for OpenVMS Alpha System........................... 1-8 1-5 Required Number of Contiguous Free Global Pages and Free Global Sections....................... 1-12 1-6 Recommended System Parameter Values to Use with the ADD_ Option................................ 1-13 iv _________________________________________________________________ Preface Intended Audience This manual is intended for anyone who plans to install HP DECwindows Motif /Hangul for OpenVMS software. Document Structure This manual contains the following chapters and appendixes: o Chapter 1 discusses how to prepare for installing HP DECwindows Motif /Hangul for OpenVMS software. o Chapter 2 discusses how to install HP DECwindows Motif /Hangul for OpenVMS using the POLYCENTER Software Installation utility. o Appendix A presents a sample DECwindows Motif installation using the POLYCENTER Software Installation utility on I64 and Alpha systems. o Appendix B shows how to obtain a list of the software components for the HP DECwindows Motif /Hangul for OpenVMS product using the POLYCENTER Software Installation utility. Related Documents In addition to this manual, the following documents are useful when installing HP DECwindows Motif /Hangul for OpenVMS software: o HP DECwindows Motif for OpenVMS New Features o HP DECwindows Motif for OpenVMS Release Notes o Getting Started With the New Desktop o HP DECwindows Motif for OpenVMS Management Guide ix o HP OpenVMS System Manager's Manual o HP 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 We welcome your comments on this manual. Send us your comments through any of the following channels: 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 The following product names may appear in this manual: o HP OpenVMS Industry Standard 64 for Integrity servers o OpenVMS I64 o I64 All three names-the longer form and the two abbreviated forms-refer to the version of the OpenVMS operating system that runs on the Intel Itanium architecture. HP DECwindows Motif /Hangul for OpenVMS contains a graphical user interface that is derived from the Common Desktop Environment (CDE). This interface is referred to throughout this document as the New Desktop. Unless otherwise specified, references to OpenVMS Clusters or clusters in this document are synonymous with VMSclusters. x In this manual, every use of DECwindows and DECwindows Motif refers to HP DECwindows Motif /Hangul for OpenVMS 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. . . . 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. xi [ ] 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. xii 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. xiii 1 _________________________________________________________________ Preparing to Install the Software This chapter describes the preparation and requirements for installing HP DECwindows Motif /Hangul for OpenVMS 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 /Hangul for OpenVMS product provides online release notes. For information about accessing the release notes: o If you install the software using the POLYCENTER Software Installation utility, see Section 2.2. ______________________________________________________ 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 Preparing to Install the Software 1.1 License Registration 1.1 License Registration You must register and load your license for HP DECwindows Motif /Hangul for OpenVMS before you run the Installation Verification Procedure (IVP) and use the software. To register a license using the License Management Facility (LMF), log into 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 /Hangul for OpenVMS software on more than one node in a OpenVMS Cluster, load the license on the other nodes after you complete this installation. If you are installing HP DECwindows Motif /Hangul for OpenVMS software as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements. For complete information about using LMF, see the HP OpenVMS License Management Utility Manual. The following sections describe additional platform- specific license requirements. 1.1.1 For OpenVMS Alpha Systems Before you install and run HP DECwindows Motif /Hangul for OpenVMS software on a newly licensed node or cluster, you must first register a DW-MOTIF-HANGUL License PAK. 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 Preparing to Install the Software 1.1 License Registration 1.1.2 For OpenVMS I64 Systems Before you install the HP DECwindows Motif /Hangul for OpenVMS software, you must have first registered a license for an OpenVMS I64 Operating Environment (OE) that includes the DECwindows Motif layered product. See the HP OpenVMS I64 and DECwindows Motif SPDs for a complete list of the OpenVMS I64 OEs that include the DECwindows Motif layered product. 1.2 Supported Hardware HP DECwindows Motif /Hangul for OpenVMS software can be installed on any supported I64 or Alpha processor. For a complete list of supported hardware, see the HP DECwindows Motif /Hangul for OpenVMS Software Product Description (SPD). 1.3 Prerequisites for the Installation Procedures Before you can install and configure HP DECwindows Motif /Hangul for OpenVMS software, you must have the required versions of the OpenVMS operating system software, sufficient memory, and a license. (Refer to Section 1.1 for information about registering a License Product Authorization Key [PAK].) Use the POLYCENTER Software Installation utility to install your DECwindows Motif software . 1.4 Required Software The HP DECwindows Motif /Hangul for OpenVMS software requires one of the following operating systems: o OpenVMS Version 8.2 If your system is not running one of these versions before you attempt to install HP DECwindows Motif /Hangul for OpenVMS, the installation fails. A minimum of 128 MB of memory is required for OpenVMS Alpha systems. 1-3 Preparing to Install the Software 1.4 Required Software On OpenVMS I64 systems, the minimum amount of memory is dependent upon the specific Integrity Server platform. In general for DECwindows Motif, 512 MB of memory is recommended. Refer to the supported platform list in the OpenVMS SPD for more specific requirements. OpenVMS locale support kit is required. Please install VMSI18N V8.2 ECO1 for OpenVMS V8.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 ______________________________________________________ For more information of OpenVMS locale support kit, please contact your local HP office. Please answer yes to the question about Chinese and Unicode support. * Do you want Chinese support [YES]? yes * Do you want Unicode support [YES]? yes HP DECwindows Motif /Hangul for OpenVMS requires installation of HP DECwindows Motif V1.5 (US kit). Please install V1.5 US kit first and then install V1.5 Hangul kit. For installation of the US kit, please refer to DECwindows Motif Version 1.5 for OpenVMS Installation Guide. 1-4 Preparing to Install the Software 1.5 Installation Procedure Requirements 1.5 Installation Procedure Requirements This section discusses the requirements for installing the HP DECwindows Motif /Hangul for OpenVMS software using PCSI installation procedure. 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__Alpha_Value____________________________________ ASTLM 250 BIOLM 150 BYTLM 64,000 DIOLM 150 ENQLM 2,000 FILLM__________100_________________________________________ Use the OpenVMS AUTHORIZE utility to verify and to change process quotas for the installation account in the user authorization file (UAF). (Some sites may restrict the use of the AUTHORIZE utility to certain accounts or users.) For example, to change the BYTLM quota for the account-name installation account, enter the following commands: 1-5 Preparing to Install the Software 1.5 Installation Procedure Requirements $ 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. To determine the number of free blocks on the system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE The installation procedure checks for free disk space on the system disk. If sufficient space is not available, the installation procedure provides the following options: o Install fewer optional files. o Terminate the installation, create more free disk space on the system disk, and restart the installation. o Continue the installation and risk running out of disk space. ________________________ Note ________________________ If you run out of free disk space during the installation, the installation procedure fails. ______________________________________________________ 1-6 Preparing to Install the Software 1.5 Installation Procedure Requirements Table_1-2_Approximate_Required_Disk_Space_(in_Blocks)______ Component___I64_________Alpha______________________________ Hangul______120,000_____120,000____________________________ 1.5.3 System Parameters Table 1-3 and Table 1-4 list 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-3_Minimum_Required_System_Parameter_Values_________ System Parameter________Value_____________________________________ GBLSECTIONS 1,000[1] GBLPAGES 150,000[1] GBLPAGFIL 4,096 SWPOUTPGCNT 512 MAXBUF 8,192 CHANNELCNT 255 PROCSECTCNT 64 PQL_MASTLM 100 PQL_MBIOLM 100 PQL_MBYTLM 100,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_____________________________________ PQL_MDIOLM 100 PQL_MENQLM 300 PQL_MFILLM 100 PQL_MPRCLM 10 PQL_MWSDEFAULT 4,096 PQL_MWSQUOTA 8,192 PQL_MWSEXTENT 16,384 CLISYMTBL 512 GH_RES_CODE 3,072 IMGREG_PAGES 10,000 WINDOW_SYSTEM 1 NPAGEDYN 4,194,304 PAGEDYN 4,194,304 WSMAX______________131,072_________________________________ Table 1-4 Minimum Required System Parameter Values for __________OpenVMS_Alpha_System_____________________________ System Parameter________Value_____________________________________ GBLSECTIONS 600[1] GBLPAGES 150,000[1] GBLPAGFIL 4,096 [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-8 Preparing to Install the Software 1.5 Installation Procedure Requirements Table 1-4 (Cont.) Minimum Required System Parameter Values __________________for_OpenVMS_Alpha_System_________________ System Parameter________Value_____________________________________ SWPOUTPGCNT 512 MAXBUF 8,192 CHANNELCNT 255 PROCSECTCNT 128 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,584 IMGREG_PAGES 10,000 WINDOW_SYSTEM 1 NPAGEDYN 1,998,848 PAGEDYN 704,288 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-9 Preparing to Install the Software 1.5 Installation Procedure Requirements 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 /Hangul for OpenVMS installation. The AUTOGEN utility uses system configuration data to automatically set system parameters. ________________________ Note ________________________ The DECwindows Motif installation and startup procedures automatically check for required system parameter values and pass the appropriate values to AUTOGEN. Therefore, in most cases you do not have to check and modify these values manually. ______________________________________________________ 1.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-3 and Table 1-4, increase the system parameter settings. Section 1.5.4.4 describes the procedures for using the AUTOGEN utility to increase these values. 1-10 Preparing to Install the Software 1.5 Installation Procedure Requirements 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 and Table 1-4, you can continue with the product installation. However, to install and run HP DECwindows Motif /Hangul for OpenVMS software, you must have sufficient free global pages and global sections for the DECwindows Motif software and the file SYS$LIBRARY:DCLTABLES.EXE. First, determine how many free global pages and global sections exist on your system and how many are required to reinstall a new version of SYS$LIBRARY:DCLTABLES.EXE. Then, if necessary, use the AUTOGEN utility to increase the values of the GBLPAGES and GBLSECTIONS system parameters. Enter the following DCL command to determine the number of global pages required for SYS$LIBRARY:DCLTABLES.EXE: $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE This command returns the size (in blocks) of the file SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pages needed for the file. Enter the WRITE command with the F$GETSYI lexical function to find the number of 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-5 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. 1-11 Preparing to Install the Software 1.5 Installation Procedure Requirements Table 1-5 Required Number of Contiguous Free Global Pages __________and_Free_Global_Sections_________________________ System_Resource__Alpha_Value_______________________________ CONTIG_GBLPAGES 4,520 FREE_GBLSECTS_______17_____________________________________ 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 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-12 Preparing to Install the Software 1.5 Installation Procedure Requirements 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-6 lists the system parameters that you need to adjust incrementally. Table 1-6 Recommended System Parameter Values to Use with __________the_ADD__Option__________________________________ System Parameter________Alpha_Increment___________________________ 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 1-13 Preparing to Install the Software 1.5 Installation Procedure Requirements 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.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 Hangul 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-14 2 _________________________________________________________________ Using the POLYCENTER Software Installation Utility This chapter describes how to install and configure HP DECwindows Motif /Hangul for OpenVMS software using the POLYCENTER Software Installation utility on Alpha. The HP DECwindows Motif /Hangul for OpenVMS 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, 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. _______________________ Caution _______________________ If you do not have a satisfactory backup copy of your system disk, do not attempt to install HP DECwindows 2-1 Using the POLYCENTER Software Installation Utility Motif /Hangul for OpenVMS software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your Alpha processor) before you install HP DECwindows Motif /Hangul for OpenVMS software. Before beginning the installation procedure, review Chapter 1 for information about installation preparations and requirements. ______________________________________________________ 2.1 Accessing Help Information Online help is available with the installation utility for all PRODUCT commands and qualifiers. For help on a specific command, enter the DCL command HELP followed by the command and product name. Refer to the following documents for information about tasks and PRODUCT commands and qualifiers: o OpenVMS System Manager's Manual o OpenVMS System Management Utilities Reference Manual o OpenVMS DCL Dictionary 2.2 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-HANGUL, at the DCL prompt. For example: $ DEFINE PCSI$SOURCE DKA400:[KMOTIF15] $ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF-UI-HANGUL 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-2 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3 Installing the Software The sections that follow take you through the stages of installing your HP DECwindows Motif /Hangul for OpenVMS software using the POLYCENTER Software Installation utility. HP DECwindows Motif /Hangul for OpenVMS I64 consists of two kits o International Motif kit (HP-I64VMS-DWMOTIF_I18N-V0105-A- 1.PCSI$COMPRESSED) o Hanzi Motif kit (HP-I64VMS-DWMOTIF_UI_HANGUL-V0105- 1.PCSI$COMPRESSED) HP DECwindows Motif /Hangul for OpenVMS Alpha consists of two kits o International Motif kit (DEC-AXPVMS-DWMOTIF_I18N-V0105- A-1.PCSI$COMPRESSED) o Hanzi Motif kit (DEC-AXPVMS-DWMOTIF_UI_HANGUL-V0105- 1.PCSI$COMPRESSED) They are in the same directory of CD-ROM. First, install International Motif kit, then install Hangul 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. 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.5-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.5-A: DECwindows Motif/I18N Copyright 2005 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.2.1 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.5-A DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90% 2.3.1.2.2 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.5-A Layered Product DEC AXPVMS DWMOTIF_I18N V1.5-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. You can install Locale Language Variant of DECwindows Motif. 2.3.2 Installing Hangul Motif kit 2-5 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2.1 Starting the Installation Invoke the POLYCENTER Software Installation utility: $ PRODUCT INSTALL DWMOTIF-UI-HANGUL 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. DEC AXPVMS DWMOTIF_UI_HANGUL V1.5: DECwindows Motif/Hangul Copyright 2005 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company. This product uses the PAK: DW-MOTIF and DW-MOTIF-UI-HANGUL * This product does not have any configuration options. -- 2.3.2.2.1 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_HANGUL V1.5 DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90% 2-6 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.2.2.2 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_HANGUL V1.5 Layered Product DEC AXPVMS DWMOTIF_UI_HANGUL V1.5: DECwindows Motif/Hangul This product requires the following SYSGEN parameters: GBLPAGES add 620 This product requires the following SYSGEN parameters: GBLSECTIONS add 6 Installation of DECwindows Motif/Hangul for OpenVMS Alpha completed. Installation Verification Procedure (IVP) can be run after reboot. The IVP is SYS$TEST:DECW$IVP_KO_KR.COM. System reboot is required. 2.4 Recovering from Errors An error during installation can occur if one or more of the following conditions exists: o The operating system version is incorrect. o The prerequisite software version is incorrect. o Quotas necessary for successful installation are inadequate. o Process quotas required by the installation utility are inadequate. o The OpenVMS Help library is currently in use. For descriptions of the error messages generated by these conditions, see the documents listed in the Associated Documents section in the Preface. These documents may help you diagnose errors and decide what corrective actions to take. 2-7 Using the POLYCENTER Software Installation Utility 2.4 Recovering from Errors 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 /Hangul Version 1.5 for OpenVMS has failed. If the installation fails, fix the problem and restart the installation procedure. 2-8 A _________________________________________________________________ POLYCENTER Software Installation Utility Sample Installations A.1 Sample Installation of DECwindows Motif Internationalization kit $ PRODUCT INSTALL DWMOTIF_I18N The following product has been selected: DEC AXPVMS DWMOTIF_I18N V1.5-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.5-A: 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_I18N V1.5-A DISK$1:[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.5-A Layered Product DEC AXPVMS DWMOTIF_I18N V1.5-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. A-1 POLYCENTER Software Installation Utility Sample Installations A.1 Sample Installation of DECwindows Motif Internationalization kit You can install Locale Language Variant of DECwindows Motif. $ A.2 Sample Installation of DECwindows Motif Hangul kit $ PRODUCT INSTALL DWMOTIF_UI_HANGUL The following product has been selected: DEC AXPVMS DWMOTIF_UI_HANGUL V1.5 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_HANGUL V1.5: DECwindows Motif/Hangul Copyright 2005 Hewlett- Packard Development Company, L.P. Hewlett-Packard Company. This product uses the PAK: DW-MOTIF and DW-MOTIF-UI- HANGUL * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF_UI_ HANGUL V1.5 DISK$1:[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_HANGUL V1.5 Layered Product DEC AXPVMS DWMOTIF_UI_HANGUL V1.5: DECwindows Motif/Hangul This product requires the following SYSGEN parameters: GBLPAGES add 620 This product requires the following SYSGEN parameters: GBLSECTIONS add 6 Installation of DECwindows Motif/Hangul for OpenVMS Alpha completed. Installation Verification Procedure (IVP) can be run after reboot. The IVP is SYS$TEST:DECW$IVP_KO_KR.COM. A-2 POLYCENTER Software Installation Utility Sample Installations A.2 Sample Installation of DECwindows Motif Hangul kit System reboot is required. A-3 B _________________________________________________________________ Software Components If you installed HP DECwindows Motif /Hangul for OpenVMS using the POLYCENTER Software Installation utility, you can obtain a list of all installed files and the directories and subdirectories into which the files were installed. To obtain this list, enter the following POLYCENTER Software Installation utility command: $ PRODUCT SHOW OBJECT/product=dwmotif-ui-hangul B-1 _________________________________________________________________ Index A______________________________ D______________________________ Account quotas DIOLM parameter See also Quotas required quota for required for installation, installation, 1-5 1-5 Disk space ASTLM parameter determining required quota for amount, 1-6 installation, 1-5 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-10 E______________________________ rebooting the system, 1-13 ENQLM parameter using to change system required quota for parameters, 1-13 installation, 1-5 B Example programs _______________________________ required disk space, 1-6 Backup backing up a system disk, F______________________________ 1-14 FILLM parameter Base kit required quota for required disk space, 1-6 installation, 1-5 BIOLM parameter Free blocks required quota for determining amount, 1-6 installation, 1-5 Free global pages Blocks calculating, 1-11 See Free blocks required, 1-11 BYTLM parameter Free global sections required quota for calculating, 1-11 installation, 1-5 required, 1-11 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-8 extracting the release notes, H______________________________ 2-2 Hardware prerequisites for supported by DECwindows Motif installation, 1-3 , 1-3 responding to questions during installation, 2-3 running the installation I______________________________ command procedure, 2-4, Installation requirements, 1-5 2-6 Prerequisite software L______________________________ using the POLYCENTER Software License registration, 1-2 Installation utility, 1-3 Logging out Programming notifying users, 1-14 environment disk space requirements, M 1-6 _______________________________ Memory requirements, 1-3 Q______________________________ O Quotas _______________________________ minimum required for Operating system prerequisites installation, 1-5 using the POLYCENTER Software verifying and changing, 1-5 Installation utility, 1-3 R______________________________ P______________________________ Release notes Page file size accessing setting, 1-12 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-1 confirming your responses to questions, 2-3 displaying Index-2 free space required for S______________________________ installation, 1-6 Shutting down the system System Generation utility notifying users, 1-14 See SYSGEN utility Software System parameters required operating system adding version, 1-3 new parameters, 1-13 SYSGEN utility changing checking system parameter by using the AUTOGEN values, 1-10 utility, 1-13 preparing for installation, values, 1-13 1-10 checking System values, 1-10 shutdown minimum required, 1-7 notifying users, 1-14 modifying System disk incremental adjustments, backing up, 2-1 1-13 determining recalculating, 1-13 number of free blocks, 1-6 T______________________________ Translated-image support required disk space, 1-6 Index-3