Compaq_DECwindows_Motif_/Hanzi_for_OpenVMS__________ Installation Guide September 2002 This manual provides step-by-step instructions for installing Compaq DECwindows Motif /Hanzi for OpenVMS. Revision/Update This manual supersedes the Information: DECwindows Motif /Hanzi Version 1.2-3 for OpenVMS Installation Guide. Operating System: OpenVMS Alpha Version 6.2, 7.2-2, or 7.3 Software Version: Compaq DECwindows Motif /Hanzi for OpenVMS Alpha, Version 1.2-6 Compaq Computer Corporation Houston, Texas ________________________________________________________________ September 2002 © 2002 Compaq Computer Corporation COMPAQ, OpenVMS, VAX, VMS, the Compaq logo, and the DIGITAL logo Registered in U.S. Patent and Trademark Office. Motif, OSF/1, and UNIX are registered trademarks of The Open Group. All other product names mentioned herein may be the trademarks or registered trademarks of their respective companies. Confidential computer software. Valid license from Compaq or authorized sublicensor required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this publication is subject to change without notice and is provided "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH THE RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING SHALL APPLY REGARDLESS OF THE NEGLIGENCE OR OTHER FAULT OF EITHER PARTY AND REGARDLESS OF WHETHER SUCH LIABILITY SOUNDS IN CONTRACT, NEGLIGENCE, TORT, OR ANY OTHER THEORY OF LEGAL LIABILITY, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY. The limited warranties for Compaq products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty. SEG6434 The Compaq OpenVMS documentation set is available on CD- ROM. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install the Software 1.1 License Registration............................. 1-2 1.2 Supported Hardware............................... 1-2 1.3 Prerequisites for the Installation Procedures.... 1-3 1.4 Required Software................................ 1-3 1.5 Required ECO for POLYCENTER Software Installation Utility.......................................... 1-4 1.5.1 Upgrade Problem After Installing Required PCSI ECO............................................ 1-5 1.6 Installation Procedure Requirements.............. 1-6 1.6.1 Process Account Quotas ........................ 1-6 1.6.2 Disk Space .................................... 1-7 1.6.3 System Parameters ............................. 1-8 1.6.4 Additional System Maintenance Procedures ...... 1-9 1.6.4.1 Checking System Parameter Values............ 1-10 1.6.4.2 Calculating the Number of Free Global Pages and Global Sections......................... 1-10 1.6.4.3 Setting the Size of the Page File........... 1-11 1.6.4.4 Changing System Parameter Values Using the AUTOGEN Utility............................. 1-12 1.6.5 Backing Up Your System Disk ................... 1-13 1.6.6 Notifying Other Users ......................... 1-14 iii 2 Using the POLYCENTER Software Installation Utility 2.1 Accessing Help Information....................... 2-2 2.2 Extracting and Printing the Product Release Notes............................................ 2-2 2.3 Installing the Software.......................... 2-3 2.3.1 Starting the Installation ..................... 2-4 2.3.2 The Installation Dialog ....................... 2-4 2.3.2.1 Execution Dialog............................ 2-5 2.3.2.2 Reviewing Final Installation Notes.......... 2-5 2.4 Postinstallation Tasks........................... 2-6 2.4.1 Increase Page File Quota ...................... 2-6 2.4.2 How to change the default locale .............. 2-6 2.5 Recovering from Errors........................... 2-6 A POLYCENTER Software Installation Utility Sample Installations B Software Components Index Tables 1-1 Process Quotas for the Installation Account ... 1-6 1-2 Approximate Required Disk Space by Component (in Blocks).................................... 1-8 1-3 Minimum Required System Parameter Values ...... 1-8 1-4 Required Number of Contiguous Free Global Pages and Free Global Sections....................... 1-11 1-5 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 Compaq DECwindows Motif /Hanzi for OpenVMS software. Document Structure This manual contains the following chapters and appendixes: o Chapter 1 discusses how to prepare for installing Compaq DECwindows Motif /Hanzi for OpenVMS software. o Chapter 2 discusses how to install Compaq DECwindows Motif /Hanzi for OpenVMS 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 Compaq DECwindows Motif /Hanzi for OpenVMS product using the POLYCENTER Software Installation utility. Related Documents In addition to this manual, the following documents are useful when installing Compaq DECwindows Motif /Hanzi for OpenVMS software: o Compaq DECwindows Motif for OpenVMS Release Notes o Guide to the Compaq DECwindows Motif for OpenVMS CD-ROM 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 o A Comparison of System Management on OpenVMS AXP and OpenVMS VAX For additional information on the OpenVMS System Software Group (OSSG) products and services, access the following OpenVMS World Wide Web address: http://www.openvms.compaq.com Reader's Comments Compaq welcomes your comments on this manual. Please send comments to either of the follwing addresses: Internet openvmsdoc@compaq.com Mail Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 How To Order Additional Documentation Use the following World Wide Web address to order additional documentation: http://www.openvms.compaq.com:8000/ Conventions Compaq DECwindows Motif /Hanzi for OpenVMS Alpha contains a graphical user interface that is derived from the Common Desktop Environment (CDE). This interface is referred to throughout this document as the New Desktop. VMScluster systems are now referred to as OpenVMS Cluster systems. Unless otherwise specified, references to OpenVMS Clusters or clusters in this document are synonymous with VMSclusters. In this manual, every use of DECwindows and DECwindows Motif refers to Compaq DECwindows Motif /Hanzi for OpenVMS 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 Compaq DECwindows Motif /Hanzi for OpenVMS software using either the POLYCENTER Software Installation utility. Your Bill of Materials (BOM) specifies the number and contents of your media. Verify the contents of your kit with this information. If your kit is damaged or if you find that parts are missing, contact your Compaq representative. ________________________ Note ________________________ Compaq strongly recommends that you read the release notes before proceeding with the installation. The Compaq DECwindows Motif /Hanzi 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, Required ECO for POLYCENTER Software Installation Utility o Section 1.6, Installation Procedure Requirements 1-1 Preparing to Install the Software 1.1 License Registration 1.1 License Registration Before you install and run Compaq DECwindows Motif /Hanzi for OpenVMS software on a newly licensed node or cluster, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK is provided along with the kit if you ordered the license and media together; otherwise, it is provided separately to a location based on your license order. If you are installing Compaq DECwindows Motif /Hanzi 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. You must register and load your license for Compaq DECwindows Motif /Hanzi for OpenVMS 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 Compaq DECwindows Motif /Hanzi for OpenVMS 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 Compaq DECwindows Motif /Hanzi for OpenVMS software can be installed on any supported Alpha processor. For a complete list of supported hardware, see the Compaq DECwindows Motif /Hanzi for OpenVMS 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 Compaq DECwindows Motif /Hanzi 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 or the VMSINSTAL procedure to install your DECwindows Motif software according to the operating system information that follows. ___________________________________________________________ Operating_System___________Installation_Method_____________ OpenVMS Alpha POLYCENTER Software Installation ___________________________utility_________________________ 1.4 Required Software The Compaq DECwindows Motif /Hanzi for OpenVMS software requires one of the following operating systems: o OpenVMS Alpha Version 6.2, 7.2-2, or 7.3 If your system is not running one of these versions before you attempt to install Compaq DECwindows Motif /Hanzi for OpenVMS, the installation fails. A minimum of 128 MB of memory is required for OpenVMS Alpha systems. For OpenVMS Alpha V7.2-2, or V7.3, the Compaq DECwindows Motif /Hanzi for OpenVMS software requires the following Compaq C RTL ECO kit. o VMS722_ACRTL-V0100 for OpenVMS Alpha V7.2-2, or o VMS73_ACRTL-V0200 for OpenVMS Alpha V7.3 For more information of these ECO kits, please contact your local Compaq office. For OpenVMS Alpha V6.2, Compaq C RTL ECO kit is not required. 1-3 Preparing to Install the Software 1.4 Required Software OpenVMS locale support kit is required on OpenVMS Alpha. Please install the appropriate locale support on your system. o VMSI18N062 for OpenVMS Alpha V6.2, or o ALPVMSI18N04_072 for OpenVMS Alpha V7.2-2, or o ALPVMSI18N01_073 for OpenVMS Alpha V7.3 For more information of OpenVMS locale support kit, please contact your local Compaq office. For OpenVMS Alpha V7.2-2 or V7.3, please answer yes to the question about GB18030 and Chinese support. * Do you want GB18030 support [YES]? yes * Do you want Chinese support (not including GB18030) [YES]? yes For OpenVMS Alpha V6.2, please answer yes to the question about Chinese support. * Do you want Chinese support [YES]? yes Compaq DECwindows Motif /Hanzi for OpenVMS requires installation of Compaq DECwindows Motif V1.2-6 (US kit). Please install V1.2-6 US kit first and then install V1.2-6 Hanzi kit. For installation of the US kit, please refer to DECwindows Motif Version 1.2-6 for OpenVMS Installation Guide. 1.5 Required ECO for POLYCENTER Software Installation Utility If you are installing the Compaq DECwindows Motif /Hanzi for OpenVMS software on an OpenVMS Version 6.2 system, you must first install an ECO to the POLYCENTER Software Installation (PCSI) utility. See the Guide to the Compaq DECwindows Motif for OpenVMS CD-ROM for details about this ECO. OpenVMS Versions 7.2 and higher include this functionality in the operating system; therefore, you need not apply this ECO if you are running OpenVMS Version 7.2 or higher. 1-4 Preparing to Install the Software 1.5 Required ECO for POLYCENTER Software Installation Utility 1.5.1 Upgrade Problem After Installing Required PCSI ECO After installing the required POLYCENTER Software Installation utility ECO, your system will use the new features provided by this version of the PCSI utility. If a layered product is installed that makes use of this new functionality, then it may not be possible to revert back to an older version of the utility. The restriction occurs because there may be records in the software product database that the older version of the utility will not be able to interpret. This scenario occurs if you install the PCSI ECO, then install DECwindows Motif, and later install certain upgrades to the OpenVMS operating system. The steps below describe the situations when this will occur: 1. Install the PCSI ECO kit onto OpenVMS Version 6.2, 6.2- 1H1, 6.2-1H2, or 6.2-1H3. 2. Install DECwindows Motif Version 1.2-6. 3. Upgrade to (or reinstall) OpenVMS Version 6.2, 6.2-1H1, 6.2-1H2, or 6.2-1H3. Upgrading to any of the OpenVMS versions listed in item 3 may fail (or other PRODUCT command operations on the product database may fail) with one of the following errors: %SYSTEM-F-ACCVIO, access violation, ... %PCSI-E-UNSDOCENC, unsupported product document encoding version To prevent these failures after installing the PCSI ECO and DECwindows Motif, perform the following steps: 1. Remove DECwindows Motif using the following command: $ PRODUCT REMOVE DWMOTIF 2. Upgrade to (or reinstall) OpenVMS Version 6.2, 6.2-1H1, 6.2-1H2, or 6.2-1H3. 3. Reinstall the PCSI ECO. 4. Reinstall DECwindows Motif. This workaround is not needed if you upgrading to OpenVMS Alpha Version 7.2-2 or higher. These versions (and all later versions) already include the new functionality added by the PCSI ECO. 1-5 Preparing to Install the Software 1.6 Installation Procedure Requirements 1.6 Installation Procedure Requirements This section discusses the requirements for installing the Compaq DECwindows Motif /Hanzi for OpenVMS 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.6.1 Process Account Quotas The installation procedure requires that the installation account has the minimum quotas shown in Table 1-1. Table_1-1_Process_Quotas_for_the_Installation_Account______ Quota_Name__Value__________________________________________ ASTLM 250 BIOLM 150 BYTLM 64,000 DIOLM 150 ENQLM 2,000 FILLM__________100_________________________________________ Use the OpenVMS AUTHORIZE utility to verify and to change process quotas for the installation account in the user authorization file (UAF). (Some sites may restrict the use of the AUTHORIZE utility to certain accounts or users.) For example, to change the BYTLM quota for the account-name installation account, enter the following commands: 1-6 Preparing to Install the Software 1.6 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.6.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-7 Preparing to Install the Software 1.6 Installation Procedure Requirements Table 1-2 Approximate Required Disk Space by Component (in __________Blocks)__________________________________________ Component___Value__________________________________________ Hanzi_______160,000________________________________________ 1.6.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. 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 [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.6 Installation Procedure Requirements Table_1-3_(Cont.)_Minimum_Required_System_Parameter_Values_ System Parameter________Value_____________________________________ 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 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.6.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 Compaq DECwindows Motif /Hanzi 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 1-9 Preparing to Install the Software 1.6 Installation Procedure Requirements 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.6.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, increase the system parameter settings. Section 1.6.4.4 describes the procedures for using the AUTOGEN utility to increase these values. 1.6.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 Compaq DECwindows Motif /Hanzi 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. 1-10 Preparing to Install the Software 1.6 Installation Procedure Requirements 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-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.6.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 2,900 FREE_GBLSECTS_______17_____________________________________ 1.6.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. 1-11 Preparing to Install the Software 1.6 Installation Procedure Requirements 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.6.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 1-12 Preparing to Install the Software 1.6 Installation Procedure Requirements 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 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.6.5 Backing Up Your System Disk Compaq 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-13 Preparing to Install the Software 1.6 Installation Procedure Requirements 1.6.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-14 2 _________________________________________________________________ Using the POLYCENTER Software Installation Utility This chapter describes how to install and configure Compaq DECwindows Motif /Hanzi for OpenVMS software using the POLYCENTER Software Installation utility on Alpha. The Compaq DECwindows Motif /Hanzi 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, 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 Compaq DECwindows Motif /Hanzi for OpenVMS software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your Alpha) before you install Compaq DECwindows Motif /Hanzi 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 Compaq DECwindows Motif for OpenVMS 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:[PCSI_ALPHA_DWMOTIF126] $ 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 ______________________ Important ______________________ If you are installing Compaq DECwindows Motif /Hanzi for OpenVMS software on an OpenVMS Version 6.2 system, you must install an ECO for the POLYCENTER Software Installation utility before installing the DECwindows Motif software. See the Guide to the Compaq DECwindows Motif for OpenVMS CD-ROM for details about this ECO. See Section 1.5 for more information. ______________________________________________________ The sections that follow take you through the stages of installing your Compaq DECwindows Motif /Hanzi for OpenVMS software using the POLYCENTER Software Installation utility. 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 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_UI_HANZI 2.3.2 The Installation Dialog The installation dialog begins by displaying the name of the product which PCSI is installing. You are then asked to verify that you 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.2-6 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF_UI_HANZI V1.2-6: DECwindows Motif /HANZI (c) 2002 Compaq Computer Corporation Compaq Computer Corporation This product uses the PAK: DW-MOTIF and DW-MOTIF-UI-HANZI * This product does not have any configuration options. 2-4 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software 2.3.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_HANZI V1.2-6 DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90% 2.3.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_HANZI V1.2-6 Layered Product DEC AXPVMS DWMOTIF_UI_HANZI V1.2-6: DECwindows Motif /HANZI This product requires the following SYSGEN parameters: GBLPAGES add 2900 This product requires the following SYSGEN parameters: GBLSECTIONS add 17 Installation Verification Procedure can be run after reboot. Run the Installation Verification Procedure (IVP) after the installation is completed and the system is rebooted. The IVP is located in the following directory: SYS$TEST:DECW$IVP_ZH_CN.COM. Installation of DECwindows Motif /HANZI for OpenVMS AXP V1.2-6 is now complete. Check whether this product have the following PAKs registerd and loaded. 2-5 Using the POLYCENTER Software Installation Utility 2.3 Installing the Software PAK Name DW-MOTIF DW-MOTIF-UI-HANZI These are required to run any DECwindows Motif /HANZI for OpenVMS application. Please reboot your system. 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 70,000 "Page File Quota". 2.4.2 How to change the default locale From this version, 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. 2-6 Using the POLYCENTER Software Installation Utility 2.5 Recovering from Errors o Process quotas required by the installation utility are inadequate. o The OpenVMS Help library is currently in use. For descriptions of the error messages generated by these conditions, see the documents listed in the Associated Documents section in the Preface. These documents may help you diagnose errors and decide what corrective actions to take. If the installation procedure fails for any reason, the POLYCENTER Software Installation utility displays a message similar to the following: %PCSIUI-INSFAIL, The installation of DECwindows Motif Version 1.2-6 for OpenVMS has failed. If the installation fails, fix the problem and restart the installation procedure. 2-7 A _________________________________________________________________ POLYCENTER Software Installation Utility Sample Installations $ PRODUCT INSTALL DWMOTIF_UI_HANZI/SOURCE=SYS$SYSDEVICE:[KIT] The following product has been selected: DEC AXPVMS DWMOTIF_UI_HANZI V1.2-6 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF_UI_HANZI V1.2-6: DECwindows Motif /HANZI (c) 2002 Compaq Computer Corporation Compaq Computer Corporation 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.2-6 DISK$SYSTEM:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS DWMOTIF_UI_HANZI V1.2-6 Layered Product DEC AXPVMS DWMOTIF_UI_HANZI V1.2-6: DECwindows Motif /HANZI This product requires the following SYSGEN parameters: GBLPAGES add 2900 This product requires the following SYSGEN parameters: GBLSECTIONS add 17 Installation Verification Procedure can be run after reboot. A-1 POLYCENTER Software Installation Utility Sample Installations Run the Installation Verification Procedure (IVP) after the installation is completed and the system is rebooted. The IVP is located in the following directory: SYS$TEST:DECW$IVP_ZH_CN.COM. Installation of DECwindows Motif /HANZI for OpenVMS AXP V1.2-6 is now complete. Check whether this product have the following PAKs registerd and loaded. PAK Name DW-MOTIF DW-MOTIF-UI-HANZI These are required to run any DECwindows Motif /HANZI for OpenVMS application. Please reboot your system. A-2 B _________________________________________________________________ Software Components If you installed Compaq DECwindows Motif /Hanzi 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_hanzi B-1 _________________________________________________________________ Index A______________________________ D______________________________ Account quotas DIOLM parameter See also Quotas required quota for required for installation, installation, 1-6 1-6 Disk space ASTLM parameter determining required quota for amount, 1-7 installation, 1-6 number of free blocks, AUTHORIZE utility 1-7 using to change Quotas, 1-6 required AUTOGEN utility by component, 1-7 preparing for installation, 1-9 E______________________________ rebooting the system, 1-13 ENQLM parameter using to change system required quota for parameters, 1-12 installation, 1-6 B Example programs _______________________________ required disk space, 1-7 Backup backing up a system disk, F______________________________ 1-13 FILLM parameter Base kit required quota for required disk space, 1-7 installation, 1-6 BIOLM parameter Free blocks required quota for determining amount, 1-7 installation, 1-6 Free global pages Blocks calculating, 1-10 See Free blocks required, 1-11 BYTLM parameter Free global sections required quota for calculating, 1-10 installation, 1-6 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-7 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-6 Prerequisite software using the POLYCENTER Software L______________________________ Installation utility, 1-3 License registration, 1-2 Programming Logging out environment notifying users, 1-14 disk space requirements, 1-7 M______________________________ Q Memory requirements, 1-3 _______________________________ Quotas O minimum required for _______________________________ installation, 1-6 Operating system prerequisites verifying and changing, 1-6 using the POLYCENTER Software Installation utility, 1-3 R______________________________ P Release notes _______________________________ accessing Page file size POLYCENTER Software setting, 1-11 Installation utility, Parameters 2-2 See System parameters extracting to a file POLYCENTER Software POLYCENTER Software Installation utility Installation utility, accessing DCL help, 2-2 2-2, 2-3 backing up the system disk, 2-2 confirming your responses to questions, 2-3 displaying Index-2 free space required for S______________________________ installation, 1-7 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-12 SYSGEN utility changing checking system parameter by using the AUTOGEN values, 1-10 utility, 1-12 preparing for installation, values, 1-12 1-9 checking System values, 1-10 shutdown minimum required, 1-8 notifying users, 1-14 modifying System disk incremental adjustments, backing up, 2-2 1-12 determining recalculating, 1-13 number of free blocks, 1-7 T______________________________ Translated-image support required disk space, 1-7 Index-3