____________________________________________________ Compaq Open3D for OpenVMS Alpha Systems Installation Guide Order Number: AA-R3WQJ-TE June 2001 This document contains instructions for installing Compaq Open3D (formerly DIGITAL Open3D) for OpenVMS) Alpha Systems. It also explains how to read the online release notes before or after installing this product. Revision/Update Information: This document supersedes the DIGITAL Open3D Installation Guide for OpenVMS Alpha Systems Operating System and Version: OpenVMS Alpha Version 7.1, 7.1-1H1, 7.1-1H2, 7.1-2, 7.2, 7.2-1, 7.2-1H1, or 7.3 Software Version: Compaq Open3D Version 4.9B Compaq Computer Corporation Houston, Texas ________________________________________________________________ © 2001 Compaq Computer Corporation Compaq, VAX, VMS, and the Compaq logo Registered in U.S. Patent and Trademark Office. All other product names mentioned herein may be the trademarks or registered trademarks of their respective companies. Confidential computer software. Valid license from Compaq 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 document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. ZK6270 This document was prepared using DECdocument, Version 3.3- 1b. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install Compaq Open3D 1.1 Prerequisite Software......................... 1-2 1.2 Online Release Notes.......................... 1-2 1.3 Media Distribution Kit........................ 1-3 1.4 License Registration.......................... 1-3 1.5 Installation Procedure Requirements........... 1-4 1.5.1 Privileges................................ 1-4 1.5.2 Disk Space................................ 1-4 1.5.3 Global Pagelets and Global Sections System Parameters................................ 1-5 1.5.3.1 Determining the Global Pagelets and Global Sections Available............... 1-5 1.5.3.2 Determining the Global Pagelets and Global Sections Currently in Use........ 1-6 1.5.3.3 Modifying the Global Pagelets Parameter............................... 1-7 1.5.3.4 Modifying the Global Sections Parameter............................... 1-8 1.5.3.5 Recalculating the Global Pages and Global Sections Parameters.............. 1-8 1.5.4 Process Account Quotas.................... 1-9 1.5.5 Virtual Page Count........................ 1-10 1.5.6 Backing Up Your System Disk............... 1-10 1.6 Error Recovery................................ 1-10 iii 2 Installing Compaq Open3D 3 After Installing Compaq Open3D 3.1 System Tuning................................. 3-1 3.1.1 Minimum System Requirements............... 3-1 3.1.2 System Requirements for Large Applications.............................. 3-2 3.1.3 Optimizing Performance.................... 3-3 3.2 Determining and Reporting Problems............ 3-4 A Files Installed on Your System B Sample Installation Tables 1-1 Minimum Required System Parameter Values.................................... 1-5 1-2 Process Account Quotas for the Installing Account................................... 1-9 3-1 Minimum Recommended Quotas for System Tuning.................................... 3-1 3-2 Recommended Quotas for Demanding Applications.............................. 3-3 A-1 Installed Files........................... A-1 iv _________________________________________________________________ Preface This document describes how to install the Compaq Open3D Version 4.9B software on Alpha processors running the OpenVMS Alpha operating system. Because this installation guide is not revised for all software maintenance updates, you should read the Read Before Installing or Using Compaq Open3D for OpenVMS Alpha Systems letter for a summary of the significant changes to the installation procedure. Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall Compaq Open3D for any other reason. Intended Audience This guide is for system managers installing Compaq Open3D software on OpenVMS Alpha systems. Document Structure This guide is organized as follows: o Chapter 1 describes the operating system requirements for Compaq Open3D installation and the procedures that you should complete before installing Compaq Open3D. o Chapter 2 describes the installation procedures for local installations. o Chapter 3 describes the operations you perform after installation. o Appendix A lists the files installed with Compaq Open3D. o Appendix B contains a sample log from a Compaq Open3D installation. v Compaq Open3D Documentation Set In addition to this guide, the Compaq Open3D documentation set includes the following manuals: o Using OpenGL Related Documents For information related to this guide, see the following manuals: o OpenVMS System Manager's Manual o Guide to Maintaining a VMS System o OpenVMS License Management Utility Manual o Guide to OpenVMS Performance Management For additional information about Compaq OpenVMS products and services, access the Compaq website at the following location: http://www.openvms.compaq.com/ Reader's Comments Compaq welcomes your comments on this manual. Please send comments to either of the following addresses: Internet openvmsdoc@compaq.com Mail Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 Conventions The following conventions are used in this guide: UPPERCASE TEXT Uppercase letters indicate the name of a command, file, parameter, procedure, or utility. bold Boldface text is used in interactive examples to indicate typed user input. vi $ The dollar sign is used to indicate the DCL prompt. This prompt may be different on your system. system output This typeface is used in interactive and code examples to indicate system output. In text, this typeface is used to indicate the exact name of a command, option, partition, path name, directory, or file. [logical-name] Square brackets indicate that the enclosed item is optional. (Square brackets are not, however, optional in the syntax of a directory name in a file specification or in the syntax of a substring specification in an assignment statement.) In procedures, a sequence such as indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button, for example . In procedures, a key name is shown enclosed to indicate that you press a key on the keyboard. Vertical ellipsis in an example means that . information not directly related to the . example has been omitted. . VMS The terms VMS and OpenVMS refer to the OpenVMS same operating system. Compaq Open3D References to Compaq Open3D refer to the Compaq Open3D (formerly DIGITAL Open3D) product. vii 1 _________________________________________________________________ Preparing to Install Compaq Open3D To make your installation run smoothly, you should complete the preparation requirements outlined in this chapter before starting the installation procedures in Chapter 2. This chapter will help you determine the following: o Whether the system on which you will install Compaq Open3D has the prerequisite software installed o How to read the online release notes o If installing Compaq Open3D from media, whether your distribution kit includes all the components listed on the Bill of Materials (BOM) o How to register a software license o The privileges required to perform the installation o How much disk space you will need o Whether the global pagelets and sections parameters are defined properly o Whether the process account quotas are defined correctly o Whether the value of the virtual page count is sufficient o How to back up your system disk o How to recover from errors that may occur during installation Preparing to Install Compaq Open3D 1-1 1.1 Prerequisite Software To install Compaq Open3D on an Alpha workstation, you must have already installed: o OpenVMS Alpha Operating System Version 7.1, 7.1-1H1, 7.1-1H2, 7.1-2, 7.2, 7.2-1, 7.2-1H1, or 7.3 o DECwindows Motif Version 1.2-4, 1.2-5, or 1.2-6 for OpenVMS Alpha Compaq Open3D also requires the following OpenVMS Alpha classes for full functionality: o OpenVMS Alpha required save set o Network support-where full DECwindows network functionality is necessary o Programming support-necessary to develop programs using OpenGL o OpenVMS Alpha workstation support 1.2 Online Release Notes Compaq strongly recommends that you read the Compaq Open3D release notes before using this product, because they may contain information about product changes. During installation, you can access release notes in the installation procedure when you invoke VMSINSTAL with the OPTIONS N parameter. This option lets you read or print the release notes before installing Compaq Open3D. After installation, you can obtain the Compaq Open3D release notes by printing the following files: o SYS$HELP:OPEN3D49B.RELEASE_NOTES (ASCII format) o SYS$HELP:OPEN3D49B_RELEASE_NOTES.PS (PostScript format) 1-2 Preparing to Install Compaq Open3D 1.3 Media Distribution Kit Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your local Compaq representative. For more information on how to mount distribution media, see your processor-specific installation/operations guide, which also details several options for the installation procedure. 1.4 License Registration Before you install and run Compaq Open3D Version 4.9B 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 PAK is a paper certificate that contains information about the license that enables you to use the software. The License PAK is shipped with the kit if you ordered the license and media together; otherwise, the PAK is shipped separately to a location specified on your license order. If you are installing Compaq Open3D as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements. If you are installing prerequisite or optional software along with Compaq Open3D, review the PAK status and install the PAKs for this prerequisite or optional software before you install Compaq Open3D. To register a license under the OpenVMS operating system, first log in to the system manager's account, SYSTEM. You can then register the license in one of two ways: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with the data from your License PAK. o Enter the LICENSE REGISTER command with the qualifiers corresponding to the License PAK information. For complete information on using the LMF, see the OpenVMS License Management Utility Manual. Preparing to Install Compaq Open3D 1-3 1.5 Installation Procedure Requirements This section describes the requirements for installing Compaq Open3D. The installation takes approximately 5 to 20 minutes, depending on your system configuration. A sample installation is included in Appendix B of this document to assist you. 1.5.1 Privileges To install Compaq Open3D, you must be logged in to an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV When you invoke VMSINSTAL to begin the installation procedure, VMSINSTAL turns off the BYPASS privilege. 1.5.2 Disk Space During the installation of Compaq Open3D, approximately 49,000 blocks of free disk space are required. Once Compaq Open3D is installed, the required disk space is also approximately 49,000 blocks. To determine the number of free blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE _______________________ Warning _______________________ You must ensure that your system has the necessary global pagelet (512-byte subpage unit) and global section SYSGEN quotas for the installation. Otherwise, the DCL tables may become corrupted in certain situations. ______________________________________________________ 1-4 Preparing to Install Compaq Open3D 1.5.3 Global Pagelets and Global Sections System Parameters The installation of Compaq Open3D requires minimum values for the system parameters defining the global pagelets and global sections. These values are shown in Table 1-1. Depending on the kinds of programs and applications running at your site, you may need to define larger values. Table_1-1_Minimum_Required_System_Parameter_Values_________ System_Parameter___________Minimum_Value___________________ GBLSECTIONS[1] n + 10 GBLPAGES[1] n + 750 [1]The_n_variable_refers_to_the_system_parameter_values____ that are currently in use. To install Compaq Open3D, you must increase those values by the number indicated. These dynamic system parameters must be set permanently to values equal to or greater than the values listed. Do not decrease these values after the installation. ___________________________________________________________ The following sections describe how to: o Determine the number of global pagelets and global sections available o Determine the global pagelets and global sections used o Modify the global pagelets parameter o Modify the global sections parameter o Recalculate the global pagelets and global sections parameters in order to take the new values into account 1.5.3.1 Determining the Global Pagelets and Global Sections Available You can determine the available global pagelets and global sections by using the WRITE command with the F$GETSYI lexical function. The following example shows how to display this information on your terminal (the default for SYS$OUTPUT): Preparing to Install Compaq Open3D 1-5 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 If the values displayed by the system are greater than the values (the number shown added to the value n) in Table 1-1, you do not need to increase the values for these parameters. If the value of free (available) global pagelets or global sections is less than the value in Table 1-1, you must increase the parameter values, as described in the following sections. You can also determine the number of global sections available by using the following procedure: 1. Invoke the SYSGEN Utility: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE CURRENT 2. Determine the number of global sections available: Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- GBLSECTIONS 400 250 20 4095 Sections The first number displayed is the total number of global sections. Compare this number to the number of global sections in use displayed by the OpenVMS Install Utility (see Section 1.5.3.2). The difference will be the number of gloabl sections available. 3. Exit from the SYSGEN Utility: SYSGEN> EXIT 1.5.3.2 Determining the Global Pagelets and Global Sections Currently in Use To determine the global pagelets and global sections used: 1. Invoke the OpenVMS Install Utility: $ INSTALL :== $INSTALL/COMMAND_MODE $ INSTALL 1-6 Preparing to Install Compaq Open3D 2. Determine the number of global pagelets used: INSTALL> LIST/GLOBAL/SUMMARY Galaxy Group Global Sections nn Global Sections Used, nnnn/nnnn Global Pagelets Used/Unused INSTALL> EXIT 3. Exit from the OpenVMS Install Utility: INSTALL> EXIT 1.5.3.3 Modifying the Global Pagelets Parameter To modify the number of global pagelets: 1. If there are fewer than 750 pagelets available, modify the GBLPAGES system parameter. You can modify the GBLPAGES parameter by editing the SYS$SYSTEM:MODPARAMS.DAT file. To change a parameter value in this file, delete the current value and enter the new value. (Another way of allocating space is to delete an existing known image with the OpenVMS Install Utility.) To modify GBLPAGES, use ADD_GBLPAGES as shown, where n is the number of global pagelets to add: ADD_GBLPAGES = n ________________________ Note ________________________ When you set the pagelet file quota, you should use a value that does not exceed the amount of pagelet file space available on the system. ______________________________________________________ 2. Exit the editor. 3. Update the GBLPAGES parameter by invoking the AUTOGEN command procedure described in Section 1.5.3.5. Preparing to Install Compaq Open3D 1-7 1.5.3.4 Modifying the Global Sections Parameter To modify the number of global sections: 1. If the number of global sections in use plus 10 exceeds the current number of global sections (i.e. if there are fewer than 10 global sections available), modify the GBLSECTIONS parameter. You can modify the GBLSECTIONS parameter by editing the SYS$SYSTEM:MODPARAMS.DAT file. To change a parameter value in this file, delete the current value and enter the new value. To modify GBLSECTIONS, use ADD_GBLSECTIONS as shown, where n is the number of global sections to add: ADD_GBLSECTIONS = n 2. Exit the editor. 3. Update the GBLSECTIONS parameter by invoking the AUTOGEN command procedure described in Section 1.5.3.5. 1.5.3.5 Recalculating the Global Pages and Global Sections Parameters To update the GBLPAGES and GBLSECTIONS parameters, invoke the AUTOGEN command procedure, SYS$UPDATE:AUTOGEN.COM: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT AUTOGEN automatically recalculates the parameters with the values you defined manually. When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. AUTOGEN also automatically adjusts some of the SYSGEN parameters, based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the NOFEEDBACK qualifier on the AUTOGEN command line. For more information about using AUTOGEN, see the OpenVMS System Management Subkit. 1-8 Preparing to Install Compaq Open3D 1.5.4 Process Account Quotas The account you use to install Compaq Open3D requires certain minimum quota values. These values are summarized in Table 1-2. Table_1-2_Process_Account_Quotas_for_the_Installing_Account Account_Quota_________________Value________________________ ASTLM 24 BIOLM 18 BYTLM 18,000 DIOLM 18 ENQLM 30 FILLM____________________________20________________________ These values are defined in the SYSUAF.DAT file. To verify and change user account quotas, use the OpenVMS Authorize Utility as shown: 1. Set your directory to SYS$SYSTEM and then run AUTHORIZE: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> 2. At the AUTHORIZE prompt (UAF>), use the SHOW command with an account name to check a particular account: UAF> SHOW SMITH 3. To change a quota, use the MODIFY command, where nnnn is the value of the quota to be changed: MODIFY account-name /quota-name=nnnn The following example changes the FILLM quota value for the SMITH account: UAF> MODIFY SMITH /FILLM=50 4. Exit from the Authorize Utility: UAF> EXIT Preparing to Install Compaq Open3D 1-9 After you exit from the utility, the system displays messages indicating whether changes were made. Once the changes have been made, you must log out and log in again for the new quotas to take effect. For more information on modifying account quotas, see the description of the Authorize Utility in the operating system documentation on system management and operations. 1.5.5 Virtual Page Count It is no longer necessary to adjust the virtual page count value. Starting with OpenVMS Version 7.0, VIRTUALPAGECNT has been an obsolete parameter on Alpha systems. Note, however, that the parameter remains in existence on Alpha systems for compatability purposes and has a default and maximum value of %X7FFFFFFF. SYSBOOT and AUTOGEN are used to enforce this default value. 1.5.6 Backing Up Your System Disk Compaq recommends that you back up your system disk, before installing any software. Use the backup procedures that are established at your site. For details on performing a backup, see the section on the backup utility in the operating system documentation set. 1.6 Error Recovery If errors occur during installation, VMSINSTAL displays failure messages. If the installation fails, the following message is displayed: %VMSINSTAL-E-INSFAIL, The installation of OPEN3D V4.9B has failed. Errors can occur during the installation if any of the following conditions exists: o The operating system version is incorrect. o A prerequisite software version is incorrect. o Quotas necessary for successful installation are insufficient. o System parameter values for successful installation are insufficient. o The product license has not been registered and loaded. 1-10 Preparing to Install Compaq Open3D If you are notified that any of these conditions exist, you should take the appropriate action, as described in the error message. For descriptions of the error messages, see the operating system documentation on system messages, recovery procedures, and software installation. Preparing to Install Compaq Open3D 1-11 2 _________________________________________________________________ Installing Compaq Open3D This chapter describes the Compaq Open3D installation procedure. For a list of the files and directories created during the installation procedure, see Appendix A. For a sample installation example, refer to Appendix B. To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again. Attempting to link programs against the Compaq Open3D run-time library results in link errors. Before you install Compaq Open3D, Compaq recommends that you back up your system disk. Once you have done so, you can begin the installation. The installation takes approximately 5 to 20 minutes, depending on your system configuration. Following is the procedure for installing Compaq Open3D. 1. Log in to a privileged account and set your default device and directory to SYS$UPDATE. Compaq recommends that you use the system manager's account. Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE 2. Invoke VMSINSTAL. When you invoke VMSINSTAL, it checks the following: o Whether you are logged in to a privileged account. You should install software from the system manager's account with your default device and directory set to SYS$UPDATE. Installing Compaq Open3D 2-1 o Whether the installing account has adequate: Disk space Global pagelets Global sections Account quotas o Whether you have adequate quotas for installation. VMSINSTAL requires the following minimum quota values: ASTLM = 24 BIOLM = 18 BYTLM = 18000 DIOLM = 18 ENQLM = 30 FILLM = 20 o Whether the following conditions exist: - DECnet network is up and running. - Users are logged in to the system. If VMSINSTAL detects problems, you will be asked whether you want to continue the installation. You should correct these problems before resuming the installation procedure. If you want to continue, type YES. If you want to stop the installation, press Return. To invoke the VMSINSTAL command procedure, enter: $ @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N All VMSINSTAL parameters are optional. If not entered on the command line, you will be prompted The VMSINSTAL parameters are: saveset-name The installation name for the component. For this release of Compaq Open3D, use the name: OPEN3DB049 device-name The name of the device on which you plan to mount the distribution volumes for the Compaq Open3D installation media. The format of the device name is ddcu, where dd is the device code, c is the controller code, and u is 2-2 Installing Compaq Open3D the unit number. For example, DKA400 is the device name for a CD-ROM. You do not have to use the console drive to install Compaq Open3D. If you do use the console drive after the installation, you should replace any media you removed from the drive prior to the installation. For CD-ROM media, you must also supply the directory location of the Compaq Open3D save set on the CD-ROM. To obtain this location, see the Software Product Library Master Index that accompanies the CD-ROM distribution kit, or complete the following steps before starting the installation: a. Determine whether the CD-ROM drive is already mounted by entering the command: $ SHOW DEVICE DKA400: If the device is mounted, skip to the next step. If it is not mounted, type the appropriate MOUNT command to mount the CD-ROM, omitting the /FOREIGN qualifier. b. Obtain the directory name by entering the command: $ DIRECTORY DKA400:[000000]*open3d*.dir The directory name will be displayed; for example: Directory DKA400:[000000] OPEN3DB049.DIR;1 c. Obtain the save set name by using a DIRECTORY command specifying the directory file from the previous command; for example: $ DIRECTORY DKA400:[OPEN3DB049.KIT]*.A OPTIONS N An optional parameter that enables you to access the release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation, because they contain additional information about the installation. There are several other options you can select when you invoke VMSINSTAL: Installing Compaq Open3D 2-3 o Auto_answer option (A) This option initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system). o Get save set option (G) This option lets you temporarily store product save sets on a magnetic tape or in a disk directory. o File log option (L) This option logs all activity to the terminal during installation. o Alternate root option (R) This option lets you install the product to a system root other than that of the current system. If you do not supply the save set, device names, and options, VMSINSTAL prompts you for them later in the installation. If you specify more than one option, separate the options with commas (for instance, OPTIONS A,N). See the OpenVMS System Management Subkit documentation for detailed information on these options. The following example invokes VMSINSTAL to install Compaq Open3D from drive DKA400:: $ @SYS$UPDATE:VMSINSTAL OPEN3DB049 DKA400:[OPEN3DB049.KIT] OPTIONS N OpenVMS AXP Software Product Installation Procedure V7.1 It is dd-MMM-yyyy at hh:mm. Enter a question mark (?) at any time for help. 3. Check DECnet status. If DECnet software is running, VMSINSTAL displays a list of all active processes and asks if you want to continue the installation: 2-4 Installing Compaq Open3D %VMSINSTAL-W-DECNET, Your DECnet network is up and running. . . . * Do you want to continue anyway [NO]? You should install Compaq Open3D on a standalone system or cluster with DECnet shut down; therefore, NO is the default response to the question. Installing Compaq Open3D 2-5 4. Confirm system backup. * Are you satisfied with the backup of your system disk [YES]? You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press Return. Otherwise, enter NO and press Return to stop the installation. After you back up your system disk, you can restart the installation. In most cases, the distribution media is a CD-ROM that has been mounted before the installation. If this is not the case, refer to your media documentation. 5. Mount the media. If you omitted the device name on the VMSINSTAL command line, the following prompt appears: * Where will the distribution volume be mounted: DKA400: Enter the name of the distribution media device and directory that contains the Compaq Open3D save set. For example, if the media is contained on a CD-ROM located on unit DKA400:, and the Compaq Open3D save set is located in the directory OPEN3DB049.KIT, enter: DKA400:[OPEN3DB049.KIT] Depending on the type of device and whether the device is already mounted, the following may or may not appear: Please mount the first volume of the set on DKA400:. * Are you ready? Y If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the "Are you ready?" question. If you respond YES to indicate that you are ready, VMSINSTAL indicates that the media containing Compaq Open3D has been mounted, and then prompts for the product name and any desired installation options: 2-6 Installing Compaq Open3D MOUNT-I-MOUNTED, DKA400: mounted) Enter the products to be processed from the first distribution volume set. * Products: OPEN3DB049 * Enter installation options you wish to use (none): The following products will be processed: OPEN3DB V49 Beginning installation of OPEN3DB V49 at hh:mm. %VMSINSTAL-I-RESTORE, Restoring product saveset A... 6. Select a release notes option. This step applies only if you specified OPTIONS N when you invoked VMSINSTAL. Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 1 If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C. If you select option 2, VMSINSTAL prompts you for a queue name. Either type a queue name or press Return to send the file to the default output print device: * Queue name [SYS$PRINT]: If you select option 3, VMSINSTAL displays the release notes on the terminal and then prompts you for a queue name for the printed version. After you type a queue name or press Return to send the file to the default output print device, the release notes are copied to: o SYS$HELP:OPEN3D49B.RELEASE_NOTES (ASCII format) o SYS$HELP:OPEN3D49B_RELEASE_NOTES.PS (PostScript format) Installing Compaq Open3D 2-7 If you select option 4, VMSINSTAL does not display, print, or copy the release notes. This option is typically used when you wish to terminate the installation. ________________________ Note ________________________ The release notes file installed by VMSINSTAL is labeled with the current product name and version number. Be sure not to delete release notes for previous versions of Compaq Open3D. ______________________________________________________ VMSINSTAL then displays the following prompt: * Do you want to continue the installation [N]?: Y %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. If you selected release notes option 4 and now press Return to stop the installation, the release notes are copied to the SYS$HELP directory. If you selected option 4 and now enter YES to continue the installation, the release notes are not copied to this directory. 7. Purge the old Compaq Open3D files. * Do you want to purge files replaced by this installation [YES]? The system disk may contain previous versions of Compaq Open3D files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended. In response to the purging prompt, press Return to purge the files or type NO to keep them. Appendix A lists the files on the system that are added or modified when you install Compaq Open3D. 8. Respond to license registration queries. 2-8 Installing Compaq Open3D Compaq Open3D supports the VMS License Management Facility (LMF). The installation procedure displays license information about your product and then asks if you have registered and loaded your authorization key for Compaq Open3D. The following is an example of this information: Product: OPEN3D Producer: DEC Version: 4.9B Release Date: 20-NOV-1998 * Does this product have an authorization key registered and loaded? Y Your PAK must be registered and loaded for the installation to complete successfully. If this is not the case, you must answer NO to this question, stop the installation, register and load your PAK, and then restart the installation. 9. Install the PowerStorm 3D30 and PowerStorm 4D20 device files. * Do you wish to install PowerStorm 3D30 and PowerStorm 4D20 files [YES]? Press Return if you wish to install the PowerStorm 3D30 and PowerStorm 4D20 device files. Type NO if you do not want this support. 10. Install the ZLXp-L device files. * Do you wish to install ZLXp-L1 and ZLXp-L2 files [YES]? N Press Return if you wish to install the ZLXp-L files. Type NO if you do not want this support. 11. Install the button and dial box device files. * Do you wish to install PCM and IDL (Button and Dial Box Support) files [YES]? N Press Return if you wish to install PCM and IDL files for button and dial box support. Type NO if you do not want this support. Installing Compaq Open3D 2-9 12. Install the X multibuffering and stereo extension files. * Do you wish to install X multibuffering and Stereo extension files [YES]? Press Return if you wish to install the X multibuffering and stereo extension files. Type NO if you do not want this support. 13. Install the DEC PEXlib application programming interface files. * Do you wish to install DEC PEXlib (PEX programming interface) files [YES]? N Press Return if you wish to install the DEC PEXlib programming interface files. Type NO if you do not want this support. 14. Install the MIT PEXlib application programming interface files. * Do you wish to install MIT PEXlib (PEX programming interface) files [YES]? N Press Return if you wish to install the MIT PEXlib programming interface files. Type NO if you do not want this support. 15. Install the PEX font files. * Do you wish to install PEX Font files [YES]? N Press Return if you wish to install the PEX font files. Type NO if you do not want this support. 16. Install the OpenGL Base files. * Do you wish to install OpenGL Base files [YES]? Press Return if you wish to install the OpenGL Base files, which are required when you run an application that uses OpenGL. Type NO if you do not want this support. 17. Install the OpenGL programming example files. * Do you wish to install OpenGL Programming Example Files [YES]? 2-10 Installing Compaq Open3D Press Return if you wish to install the files containing OpenGL programming examples. Type NO if you do not want this support. 18. Read the informational messages. At this point, the installation procedure displays a number of informational messages that report on the progress of the installation; there are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. If you requested that files be purged, they are purged at this time. The messages displayed are: STARTING to perform all the installation work. No additional user actions are necessary from this point. The remaining part of the installation will take 5 - 20 minutes depending on your CPU. %VMSINSTAL-I-RESTORE, Restoring product save set N ... %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set F ... %VMSINSTAL-I-RESTORE, Restoring product save set G ... %VMSINSTAL-I-RESTORE, Restoring product save set H ... %VMSINSTAL-I-RESTORE, Restoring product save set I ... %VMSINSTAL-I-RESTORE, Restoring product save set J ... %VMSINSTAL-I-RESTORE, Restoring product save set K ... %VMSINSTAL-I-RESTORE, Restoring product save set L ... %VMSINSTAL-I-RESTORE, Restoring product save set M ... . . . Installation of OPEN3DB V4.9 completed at hh:mm Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]OPEN3D49B.VMI_DATA Installing Compaq Open3D 2-11 VMSINSTAL procedure done at hh:mm The installation procedure is complete. You can now install additional products or log out. If you removed any media from the console drive before beginning the installation, you should replace it now. 19. Log out of the privileged account. $ LOGOUT SYSTEM logged out at dd-mmm-yyyy hh:mm:ss.ss VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again. 2-12 Installing Compaq Open3D 3 _________________________________________________________________ After Installing Compaq Open3D After installing Compaq Open3D, you must reboot the system. You can then tune your system for running complex applications and report any problems discovered during installation. 3.1 System Tuning The DECwindows server for Compaq Open3D applications is very demanding on system resources and requires some specific tuning. The following sections describe how to modify various system parameters to ensure optimal server performance. For additional information on these parameters, refer to the OpenVMS documentation. 3.1.1 Minimum System Requirements System tuning is a two-step process: you must modify both SYSTEM account quota values and the server quota values to improve performance. Table 3-1 shows the minimum SYSTEM account quota values for a three-dimensional accelerated system with at least 33 megabytes (MB) of physical memory, running complex client applications. Table_3-1_Minimum_Recommended_Quotas_for_System_Tuning_____ Parameter__________________Quota___________________________ FILLM 400 ENQLM 1024 WSDEF 10240 WSQUO 16384 WSEXTENT 20480 (continued on next page) After Installing Compaq Open3D 3-1 Table 3-1 (Cont.) Minimum Recommended Quotas for System __________________Tuning___________________________________ Parameter__________________Quota___________________________ PGFLQUO____________________370000__________________________ To set the SYSTEM account quotas to the values shown in Table 3-1, you can use the AUTHORIZE utility. In addition to the SYSTEM account quotas, you must modify the server quotas in [SYSMGR]DECW$PRIVATE_SERVER_SETUP.COM. If this file does not exist, copy DECW$PRIVATE_SERVER_SETUP.TEMPLATE to DECW$PRIVATE_SERVER_SETUP.COM. Then define the following values in this file: $ DEF/NOLOG/PROC DECW$SERVER_FILE_LIMIT 400 $ DEF/NOLOG/PROC DECW$SERVER_ENQUEUE_LIMIT 1024 $ DEF/NOLOG/PROC DECW$SERVER_WSDEF 10240 $ DEF/NOLOG/PROC DECW$SERVER_WSQUOTA 16384 $ DEF/NOLOG/PROC DECW$SERVER_WSEXTENT 20480 $ DEF/NOLOG/PROC DECW$SERVER_PAGE_FILE 370000 ________________________ Note ________________________ You must define quotas for both the SYSTEM account and the server, and these values should be the same. ______________________________________________________ 3.1.2 System Requirements for Large Applications If you are using a demanding application-for example, an application with lengthy animation sequences, large models, or large assemblies-you should set the working set quotas of the SYSTEM account to the values shown in Table 3-2 for better performance. 3-2 After Installing Compaq Open3D Table_3-2_Recommended_Quotas_for_Demanding_Applications____ Parameter__________________Quota___________________________ WSDEF 10240 WSQUO 20480 WSEXTENT___________________32768___________________________ You must also set the following server quotas in the file DECW$PRIVATE_SERVER_SETUP.COM: $ DEF/NOLOG/PROC DECW$SERVER_WSDEF 10240 $ DEF/NOLOG/PROC DECW$SERVER_WSQUOTA 20480 $ DEF/NOLOG/PROC DECW$SERVER_WSEXTENT 32768 3.1.3 Optimizing Performance If the quotas shown in the preceding sections do not result in the desired performance, you may need to define even larger values. To determine if this is necessary, you should monitor the server process during the heaviest display usage to see if its working set use approaches the maximum WSEXTENT parameter value. When monitoring the process, you should pay particular attention to the following: o Maximum size of working set The maximum size of the process working set, defined by the WSMAX parameter, must at least be equal to the largest WSEXTENT value set for your accounts. If this is not the case, add the following line to the SYS$SYSTEM:MODPARAMS.DAT file: MIN_WSMAX = 32768 After Installing Compaq Open3D 3-3 o Page file You should increase the size of the page file (DECW$SERVER_PAGE_FILE parameter) to accommodate the page file quotas of both the server and the clients. The page file quota for the server is defined by the SYSTEM account page file quota. o Virtual page count Refer to Section 1.5.5 for information on determining and modifying the virtual page count. You should only set large parameter values if necessary, because if values are too large, performance may be degraded. After you redefine the parameters, run AUTOGEN and reboot the system for the new values to be taken into account. If after initial tuning and considerable use, the server is failing or is unnecessarily unresponsive, the server may be out of memory or the memory may be fragmented. For example, you may find a message similar to the following in the server error log SYS$MANAGER:DECW$SERVER_0_ERROR.LOG: "xxx: Out of memory" In such a case, you should perform the following steps: 1. Increase the server's page file quota by modifying both the system quota (PGFLQUO) and the server quota (in the file DECW$PRIVATE_SERVER_SETUP.COM). 2. Increase the virtual page count (MIN_VIRTUALPAGECNT) in the MODPARAMS.DAT file. 3. Run AUTOGEN to take into account the new values. If these steps do not resolve the problem, then you should submit a problem report. 3.2 Determining and Reporting Problems If you encounter a problem while using Compaq Open3D, you should report it to Compaq. Depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call Compaq if your software contract or warranty agreement entitles you to telephone support. 3-4 After Installing Compaq Open3D o Submit a Software Problem Report (SPR). Review the Software Product Description (SPD) and Warranty Addendum for an explanation of warranty. If you encounter a problem during the warranty period, report the problem as described in this section, or follow alternate instructions provided by Compaq for reporting SPD nonconformance problems. After Installing Compaq Open3D 3-5 A _________________________________________________________________ Files Installed on Your System The Compaq Open3D installation procedure installs the directories and file names listed in Table A-1. Table_A-1_Installed_Files__________________________________ Directory__________File_Name_______________________________ Save_Set_A-Release_Notes___________________________________ SYS$HELP OPEN3DB049.RELEASE_NOTES OPEN3DB049_RELEASE_NOTES.PS ___________________________________________________________ Save_Set_N-Driver_Files_Required_for_all_Devices___________ SYS$LOADABLE_ IMAGES SYS$GUBDRIVER.EXE SYS$GYCDRIVER.EXE (continued on next page) Files Installed on Your System A-1 Table_A-1_(Cont.)_Installed_Files__________________________ ___________________________________________________________ Save_Set_B-Files_Required_for_All_Devices__________________ SYS$LIBRARY DECW$GRAPHICS_ICBM_0302.EXE DECW$GRAPHICS_ICBM_0402.EXE DECW$GRAPHICS_ICBM_0702.EXE SYS$MANAGER DECW$MWM_OVERLAY.COM SYCONFIG_ADDITION.COM SYCONFIG_OPEN3D.COM SYS$SYSTEM DECW$MWM_OVERLAY.EXE SYS$SYSROOT:[VUE$LIBRARY.SYSTEM] VUE$MWM_OVERLAY.COM SYS$SYSROOT:[VUE$LIBRARY.USER] DECW$MWM_OVERLAYS.VUE$DAT ___________________________________________________________ Save_Set_C-Files_Required_by_All_Servers___________________ SYS$LIBRARY DECW$SERVER_DEC_3DLIB.EXE DECW$SVEXT_DECSTEREO.EXE DECW$SVEXT_GLX.EXE DECW$SVEXT_MULTI_BUFFERING.EXE DECW$SVEXT_X3D_PEX.EXE DECW$SVEXT_X3D_PEX_GRM.EXE SYS$MANAGER DECW$XSERVER_O3D.CONF (continued on next page) A-2 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files__________________________ ___________________________________________________________ Save_Set_D_ZLX-M_Files_____________________________________ SYS$LIBRARY DECW$SERVER_DDX_GV.EXE SYS$MANAGER DECW$DEVICE_CONFIG_GV.COM SYS$SYSTEM DECW$SERVER_PVRM.EXE ___________________________________________________________ Save_Set_E_PowerStorm_3D30/4D20,_ZLX-E,_and_ZLXp-E_Files___ SYS$LIBRARY DECW$SERVER_DDX_GY.EXE DECW$SERVER_DDX_GY_WMB.EXE SYS$MANAGER DECW$DEVICE_CONFIG_GY.COM ___________________________________________________________ Save_Set_F-ZLX-L_and_ZLXp-L_Files__________________________ SYS$LIBRARY DECW$SERVER_DDX_GU.EXE DECW$SERVER_DDX_GUB.EXE SYS$MANAGER DECW$DEVICE_CONFIG_GU.COM SYS$SYSTEM DECW$SERVER_PVRM.EXE DECW$SERVER_GUBRM.EXE (continued on next page) Files Installed on Your System A-3 Table_A-1_(Cont.)_Installed_Files__________________________ ___________________________________________________________ Save_Set_G-PCM_and_IDL_Files_(Button_and_Dial_Box_Support)_ SYS$LIBRARY C_IDL.H PCM$LIBSHR.EXE SYS$SYSTEM PCM$SERVER.EXE SYS$MANAGER PCM$CUSTOM_SS.DAT PCM$STANDARD_SS.DAT SYS$SYSROOT:[SYS$STARTUP] PCM$STARTUP.COM SYS$SYSROOT:[SYSHLP.EXAMPLES.PCM] XPCMTEST.C XPCMTEST.EXE XPCMTEST.OPT XPCMTEST_BUILD.COM XPCMTEST_BUILD.MMS ___________________________________________________________ Save_Set_H-X_Multibuffering_and_Stereo_Extension_Support___ SYS$SYSROOT:[DECW$INCLUDE.EXTENSIONS] DECSTEREO.H DECSTEREOSTR.H SYS$LIBRARY DECW$STEREOLIBSHR.EXE EXTUTIL.H MULTIBUF.H MULTIBUFST.H XEXT.H (continued on next page) A-4 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files__________________________ Directory__________File_Name_______________________________ Save_Set_I-DEC_PEXlib_Files________________________________ SYS$LIBRARY DECW$PEXLIBSHR.EXE DECW$PEXLIBSHR_D_FLOAT.EXE DECW$PEXLIBSHR_G_FLOAT.EXE FLOATDEF.H MPEX.H MPEXLIB.H MPEXOC.H MPEXPROTO.H MPEXPROTOSTR.H PEX.H PEXLIB.H PEXLIBPROTOS.H PEXMACROS.H PEXOC.H PEXOCBUF.H PEXPROTO.H PEXPROTOST.H SYS$TEST PST_CUBE.COM PST_CUBE.EXE ___________________________________________________________ Save_Set_J-MIT_PEXlib_Files________________________________ SYS$LIBRARY DECW$MITPEXLIBSHR.EXE SYS$SYSROOT:[DECW$INCLUDE.PEX5] PEX.H PEXLIB.H (continued on next page) Files Installed on Your System A-5 Table_A-1_(Cont.)_Installed_Files__________________________ Directory__________File_Name_______________________________ Save_Set_J-MIT_PEXlib_Files________________________________ PEXLIBINT.H PEXPROTO.H PEXPROTOST.H PL_GLOBAL_DEF.H PL_OC_UTIL.H PL_UTIL.H ___________________________________________________________ Save_Set_K-PEX_Font_Files__________________________________ SYS$SYSROOT:[SYSFONT.DECW.PEX] FONT_JISX0201.FNT FONT_JISX0208.FNT VAXGFX$FONT_NEG01.FNT VAXGFX$FONT_NEG02.FNT VAXGFX$FONT_NEG03.FNT VAXGFX$FONT_NEG04.FNT VAXGFX$FONT_NEG05.FNT VAXGFX$FONT_NEG06.FNT VAXGFX$FONT_NEG07.FNT VAXGFX$FONT_NEG08.FNT VAXGFX$FONT_NEG09.FNT VAXGFX$FONT_NEG10.FNT VAXGFX$FONT_NEG10001.FNT VAXGFX$FONT_NEG11.FNT VAXGFX$FONT_NEG12.FNT VAXGFX$FONT_NEG13.FNT VAXGFX$FONT_NEG14.FNT VAXGFX$FONT_NEG15.FNT VAXGFX$FONT_NEG16.FNT (continued on next page) A-6 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files__________________________ Directory__________File_Name_______________________________ Save_Set_K-PEX_Font_Files__________________________________ VAXGFX$FONT_NEG17.FNT VAXGFX$FONT_NEG18.FNT VAXGFX$FONT_NEG19.FNT VAXGFX$FONT_NEG20.FNT VAXGFX$FONT_NEG21.FNT VAXGFX$FONT_NEG22.FNT VAXGFX$FONT_NEG23.FNT VAXGFX$FONT_NEG24.FNT ___________________________________________________________ Save_Set_L-OpenGL_Base_Files_______________________________ SYS$LIBRARY DECW$OPENGLSHR.EXE DECW$OPENGLUSHR.EXE DECW$OPENGLWIDGETSHR.EXE DECW$OPENGL_PROTOCOL.EXE GL.H GLU.H GLWDRAWA.H GLWMDRAWA.H GLX.H GLXDECPROTO.H GLXINT.H GLXMD.H GLXPROTO.H (continued on next page) Files Installed on Your System A-7 Table_A-1_(Cont.)_Installed_Files__________________________ Directory__________File_Name_______________________________ Save_Set_L-OpenGL_Base_Files_______________________________ SYS$SYSTEM XGLINFO.EXE SYS$TEST GL_IVP.COM GL_IVP.EXE ___________________________________________________________ Save_Set_M-OpenGL_Programming_Example_Files________________ SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.EXAMPLES] *.C 70 FILES JITTER.H VMS_EXAMPLES.COM VMS_EXAMPLES.MMS VMS_EXAMPLES.README VMS_LINK_EXAMPLES.OPT SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.IVP] GL_IVP.C VMS_IVP.COM VMS_IVP.MMS VMS_LINK_IVP.OPT SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.LIBAUX] 3D.H AUX.C AUX.H LIBAUX.OLB SHAPES.C TEAPOT.C TEAPOT.H VECT3D.C (continued on next page) A-8 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files__________________________ Directory__________File_Name_______________________________ Save_Set_M-OpenGL_Programming_Example_Files________________ VMS_LIBAUX.COM VMS_LIBAUX.MMS VMS_LIBAUX.README XFORM.C SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.LIBFONT] FONT.C FONT.H LIBFONT.OLB VMS_LIBFONT.COM VMS_LIBFONT.MMS SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.LIBRGB] LIBRGB.OLB RGB.C RGB.H VMS_LIBRGB.COM VMS_LIBRGB.MMS SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.LIBTK] CURSOR.C EVENT.C GETSET.C LIBTK.OLB PRIVATE.H SHAPES.C TK.H VMS_LIBTK.COM VMS_LIBTK.MMS VMS_LIBTK.README WINDOW.C (continued on next page) Files Installed on Your System A-9 Table_A-1_(Cont.)_Installed_Files__________________________ Directory__________File_Name_______________________________ Save_Set_M-OpenGL_Programming_Example_Files________________ SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.SAMPLES] 1.RGB 2.RGB 3.RGB 4.RGB *.C 30 Files VMS_LINK_SAMPLES.OPT VMS_SAMPLES.COM VMS_SAMPLES.MMS VMS_SAMPLES.README VMS_SYMBOLS_SAMPLES.COM SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.VISINFO] FINDVIS.C VISINFO.C VISINFO.H VMS_README.TXT VMS_VISINFO.COM VMS_VISINFO.MMS VMS_VISINFO.OPT SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.WIDGETS] DOUBLE.C SIMPLE.C VMS_LINK_WIDGETS.OPT VMS_WIDGETS.COM VMS_WIDGETS.MMS (continued on next page) A-10 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files__________________________ Directory__________File_Name_______________________________ Save_Set_M-OpenGL_Programming_Example_Files________________ VMS_WIDGETS.README SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.XGLINFO] GLOBAL.H STRINGCONVERSION.C VMS_XGLINFO.COM VMS_XGLINFO.MMS VMS_XGLINFO.OPT ___________________XGLINFO.C_______________________________ Files Installed on Your System A-11 B _________________________________________________________________ Sample Installation This appendix contains a sample installation of Compaq Open3D. The sample installation assumes that DECnet has been shut down and no users are logged on to your system. Welcome to OpenVMS (TM) Alpha Operating System, Version V7.3 Username: system Password: Welcome to OpenVMS (TM) Alpha Operating System, Version V7.3 on node GULP Last interactive login on Wednesday, 18-APR-2001 18:54:55.22 Last non-interactive login on Wednesday, 18-APR-2001 18:42:33.66 $ @SYS$UPDATE:VMSINSTAL OpenVMS AXP Software Product Installation Procedure V7.3 It is 18-APR-2001 at 18:56. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? * Where will the distribution volumes be mounted: SYS$UPDATE: Enter the products to be processed from the first distribution volume set. * Products: OPEN3DB * Enter installation options you wish to use (none): The following products will be processed: OPEN3DB V4.9 Beginning installation of OPEN3DB V4.9 at 18:56 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. * Do you want to purge files replaced by this installation [YES]? N Sample Installation B-1 Product: OPEN3D Producer: DEC Version: 4.9B Release Date: 05-JUN-2001 * Does this product have an authorization key registered and loaded? Y * Do you wish to install PowerStorm 3D30 and PowerStorm 4D20 files [YES]? * Do you wish to install ZLXp-L1 and ZLXp-L2 files [YES]? * Do you wish to install PCM and IDL files (Button and Dial Box Support) files [ YES]? * Do you wish to install X multibuffering and Stereo extension files [YES]? * Do you wish to install DEC PEXlib (PEX programming interface) files [YES]? * Do you wish to install MIT PEXlib (PEX programming interface) files [YES]? * Do you wish to install PEX Font files [YES]? * Do you wish to install OpenGL Base files [YES]? * Do you wish to install OpenGL Programming Example Files [YES]? STARTING to perform all the installation work. No additional user actions are necessary from this point. The remaining part of the installation will take 5 - 20 minutes, depending on your CPU. %VMSINSTAL-I-RESTORE, Restoring product save set N ... %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set F ... %VMSINSTAL-I-RESTORE, Restoring product save set G ... %VMSINSTAL-I-RESTORE, Restoring product save set H ... %VMSINSTAL-I-RESTORE, Restoring product save set I ... %VMSINSTAL-I-RESTORE, Restoring product save set J ... %VMSINSTAL-I-RESTORE, Restoring product save set K ... %VMSINSTAL-I-RESTORE, Restoring product save set L ... %VMSINSTAL-I-RESTORE, Restoring product save set M ... This installation appends to the file SYS$MANAGER:SYCONFIG.COM the following: $ @SYS$MANAGER:SYCONFIG_OPEN3D.COM B-2 Sample Installation Note: You MUST reboot your system to use the new drivers. If this is the first installation of a graphics device in this system, please check the release notes for a manual command to enable the device. This kit has supplied a window manager capable of supporting overlay planes on the ZLXp-L1, ZLXp-L2 and PowerStorm 4D20. Please see the release notes for further information on the window manager. %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.PCM] . If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.PCM] If you have a button or dial box connected to your workstation, you must edit the file SYS$STARTUP:PCM$STARTUP.COM to insert the correct name for the PCM serial port and/or the Spaceball serial port. You also need to edit the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM to insert the following line: $ @SYS$STARTUP:PCM$STARTUP.COM If the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM does not exist, you can create the file following the instructions in the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE PCM demo programs, along with their sources will be put in SYS$EXAMPLES:[.PCM]. The IVP for DEC PEXLIB will be copied to SYS$TEST. After the kitinstall completes and the system has been rebooted, you may run the IVP by issuing the following command: $ @SYS$TEST:PST_CUBE %VMSINSTAL-I-SYSDIR, This product creates system directory [DECW$INCLUDE.PEX5]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[DECW$INCLUDE.PEX5] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSFONT.DECW.PEX]. Sample Installation B-3 If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSFONT.DECW.PEX] The IVP for OpenGL will be copied to SYS$TEST. After the kitinstall completes and the system has been rebooted, you may run the IVP by issuing the following command: $ @SYS$TEST:GL_IVP %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.E XAMPLES]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.EXAMPLES] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.L IBAUX]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.LIBAUX] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.L IBTK]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): B-4 Sample Installation $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.LIBTK] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.S AMPLES]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.SAMPLES] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.W IDGETS]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.WIDGETS] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.I VP]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.IVP] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.L IBFONT]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.LIBFONT] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.L IBRGB]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.LIBRGB] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.V ISINFO]. Sample Installation B-5 If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.VISINFO] %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.X GLINFO]. If you intend to execute this layered product on other nodes in your cluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.XGLINFO] %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Installation of OPEN3DB V4.9 completed at 19:00 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]OPEN3DB049.VMI_DATA Enter the products to be processed from the next distribution volume set. * Products: VMSINSTAL procedure done at 19:01 B-6 Sample Installation