DIGITAL_Open3D______________________________________ Installation Guide for OpenVMS Alpha Systems Order Number: AA-R3WQB-TE April 1997 This document contains instructions for installing DIGITAL Open3D[TM] (formerly DEC Open3D[TM]) on the OpenVMS[TM] Alpha operating system. It also explains how to read the online release notes before or after installing this product. Revision/Update Information: This revised document supplements the Version 3.6 DIGITAL Open3D Installation Guide for OpenVMS Alpha Systems (Order No. AA-PX76P-TE). Operating System and Version: OpenVMS Alpha Version 7.1 Software Version: DIGITAL Open3D Version 4.3 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ First Printing, March 1993 Revised: October 1993 Revised: January, May, July, November 1994 Revised: January, April, July, October 1995 Revised: January, April, July, October 1996 Revised: January, April 1997 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. © Digital Equipment Corporation 1993, 1994, 1995, 1996, 1997. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DEC, DECnet, DEC Open3D, DECwindows, DIGITAL, DIGITAL Open3D, OpenVMS, PowerStorm, TURBOchannel, VAX, VMS, and the DIGITAL logo. The following are third-party trademarks: Motif is a registered trademark of Open Software Foundation, Inc. OpenGL is a registered trademark of Silicon Graphics, Inc. PostScript is a registered trademark of Adobe Systems, Incorporated. This document is available on CD-ROM. ZK6270 This document was prepared using VAX DOCUMENT Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install DIGITAL 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 Used.................... 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-11 iii 2 Installing DIGITAL Open3D 3 After Installing DIGITAL 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 Conventions Used in this Guide............ vi 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 DIGITAL Open3D Version 4.3 on Alpha processors running the OpenVMS Alpha operating system. Because this installation guide is not always revised for software maintenance updates, you should read the Read Before Installing or Using DIGITAL 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 DIGITAL Open3D for any other reason. Intended Audience This guide is for system managers installing DIGITAL Open3D software on OpenVMS Alpha systems. Structure of this Document This guide is organized as follows: o Chapter 1 describes the operating system requirements for DIGITAL Open3D installation, and the procedures that you should complete before installing DIGITAL 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 DIGITAL Open3D. o Appendix B contains a sample log from a DIGITAL Open3D installation. v Manuals in the DIGITAL Open3D Documentation Set In addition to this guide, the DIGITAL Open3D documentation set includes the following manuals: o DEC Open3D PEXlib C Binding Reference Manual o DEC Open3D IDL User Guide o Using OpenGL Related Manuals 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 Conventions The conventions used in this guide are shown in Table 1. Table_1_Conventions_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. $ 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. (continued on next page) vi Table_1_(Cont.)_Conventions_Used_in_this_Guide_____________ [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[TM] The terms VMS and OpenVMS refer to the OpenVMS[TM] same operating system. DIGITAL Open3D References to DIGITAL Open3D refer to the DIGITAL Open3D (formerly DEC Open3D) _________________product.__________________________________ vii 1 _________________________________________________________________ Preparing to Install DIGITAL 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 DIGITAL Open3D has the prerequisite software installed o How to read the online release notes o If installing DIGITAL 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 DIGITAL Open3D 1-1 1.1 Prerequisite Software To install DIGITAL Open3D on an Alpha workstation, you must have already installed: o OpenVMS Alpha Operating System Version 7.1 o DECwindows[TM] Motif[R] Version 1.2-4 or higher for OpenVMS Alpha DIGITAL 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[R] o OpenVMS Alpha workstation support 1.2 Online Release Notes DIGITAL strongly recommends that you read the DIGITAL 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 DIGITAL Open3D. After installation, you can obtain the DIGITAL Open3D release notes by printing the following files: o SYS$HELP:OPEN3D043.RELEASE_NOTES (ASCII format) o SYS$HELP:OPEN3D043_RELEASE_NOTES.PS (PostScript[R] format) 1-2 Preparing to Install DIGITAL 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 DIGITAL 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 DIGITAL Open3D Version 4.3 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 DIGITAL 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 DIGITAL Open3D, review the PAK status and install the PAKs for this prerequisite or optional software before you install DIGITAL 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 DIGITAL Open3D 1-3 1.5 Installation Procedure Requirements This section describes the various requirements for installing DIGITAL Open3D. The installation takes approximately 5 to 20 minutes, depending on your system configuration. 1.5.1 Privileges To install DIGITAL 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 DIGITAL Open3D, 45,000 blocks of free disk space are required. Once DIGITAL Open3D is installed, the required disk space is also 45,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 _______________________ Caution _______________________ 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 DIGITAL Open3D 1.5.3 Global Pagelets and Global Sections System Parameters The installation of DIGITAL 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 DIGITAL 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 DIGITAL 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 in Table 1-1, you do not need to increase the values for these parameters. If the value of free 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: SYSGEN> SHOW GBLSECTIONS Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- GBLSECTIONS 400 250 20 4095 Sections The first number displayed is the current 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). 3. Exit from the SYSGEN Utility: SYSGEN> EXIT 1.5.3.2 Determining the Global Pagelets and Global Sections Used 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 DIGITAL Open3D 2. Determine the number of global pagelets used: INSTALL> LIST/GLOBAL/SUMMARY Summary of Local Memory 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 DIGITAL 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, 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 DIGITAL Open3D 1.5.4 Process Account Quotas The account you use to install DIGITAL 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 name of the quota to be changed: MODIFY account-name /quota-name=nnnn The following example changes the FILLM quota for the SMITH account: UAF> MODIFY SMITH /FILLM=50 4. Exit from the Authorize Utility: UAF> EXIT Preparing to Install DIGITAL 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 To determine the current virtual page count a process is allowed to have, use the SYSGEN utility to issue the command SHOW VIRTUALPAGECNT. If the value is less than 525,000, you can change the VIRTUALPAGECNT parameter value by adding the following line to the SYS$SYSTEM:MODPARAMS.DAT file: MIN_VIRTUALPAGECNT = 525000 ________________________ Note ________________________ When a ZLX-E, ZLXp-E, PowerStorm[TM] 3D30, or PowerStorm 4D20 option is used, the minimum value of VIRTUALPAGECNT for a working X server is 525,000. If you use a smaller value, you may not be able to run DECwindows. ______________________________________________________ Set the MIN_VIRTUALPAGECNT parameter value as high as the equivalent of your total available physical memory and page file space. If the VIRTUALPAGECNT value is less than the sum of your WSEXTENT and PGFLQUO values, the server cannot make full use of the quotas. 1.5.6 Backing Up Your System Disk DIGITAL 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-10 Preparing to Install DIGITAL Open3D 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.3 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. 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 DIGITAL Open3D 1-11 2 _________________________________________________________________ Installing DIGITAL Open3D This chapter describes the DIGITAL Open3D installation procedure and the operations you may need to perform after the installation. For a list of the files and directories created during the installation procedure, see Appendix A. For a complete installation listing, 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 DIGITAL Open3D run-time library results in link errors. Before you install DIGITAL Open3D, DIGITAL recommends that you back up your system disk. Once you have done so, you can begin the installation. The installation takes approximately 5 to 30 minutes, depending on your system configuration. The procedure for installing DIGITAL Open3D is: 1. Log in to a privileged account and set your default device and directory to SYS$UPDATE. DIGITAL 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 DIGITAL 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[TM] 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 The VMSINSTAL parameters are: saveset-name The installation name for the component. For DIGITAL Open3D, use the name: OPEN3D043 device-name The name of the device on which you plan to mount the distribution volumes for the DIGITAL 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 the unit number. For example, DKA400 is the device name for a CD-ROM. 2-2 Installing DIGITAL Open3D You do not have to use the console drive to install DIGITAL 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 DIGITAL 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] OPEN3D043.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:[OPEN3D043.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: o Auto_answer option (A) Installing DIGITAL Open3D 2-3 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 and device names, VMSINSTAL prompts you for them later in the installation. VMSINSTAL does not prompt you for any options, however, so be sure to include the desired options on the VMSINSTAL command line. 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 DIGITAL Open3D from drive DKA400:: $ @SYS$UPDATE:VMSINSTAL OPEN3D043 DKA400:[OPEN3D043.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 DIGITAL Open3D %VMSINSTAL-W-DECNET, Your DECnet network is up and running. . . . * Do you want to continue anyway [NO]? You should install DIGITAL Open3D on a standalone system or cluster with DECnet shut down; therefore, NO is the default response to the question. 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 DIGITAL Open3D save set. For example, if the media is contained on a CD-ROM located on unit DKA400:, and the DIGITAL Open3D save set is located in the directory OPEN3D043.KIT, enter: DKA400:[OPEN3D043.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 Installing DIGITAL Open3D 2-5 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 DIGITAL Open3D has been mounted, and then prompts for the product name and any desired installation options: %MOUNT-I-MOUNTED, DKA400: mounted Enter the products to be processed from the first distribution volume set. * Products: OPEN3D043 * Enter installation options you wish to use (none): The following products will be processed: OPEN3D V4.3 Beginning installation of OPEN3D V4.3 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 VMSINTAL. 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]: 2-6 Installing DIGITAL Open3D 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:OPEN3D043.RELEASE_NOTES (ASCII format) o SYS$HELP:OPEN3D043_RELEASE_NOTES.PS (PostScript format) 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 DIGITAL 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. After the installation, you can enter the following command to review the release notes through the Help facility. For example: $ HELP OPEN3D043 RELEASE_NOTES 7. Purge the old DIGITAL Open3D files. * Do you want to purge files replaced by this installation [YES]? Installing DIGITAL Open3D 2-7 The directories SYS$SYSROOT:[SYSLIB] and SYS$SYSTEM may contain previous versions of DIGITAL 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 DIGITAL Open3D. 8. Respond to license registration queries. DIGITAL 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 DIGITAL Open3D. The following is an example of this information: Product: OPEN3D Producer: DEC Version: 4.3 Release Date: 02-MAY-1997 * 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 ZLX-M device files. * Do you wish to install ZLX-M1 and M2 files [YES]? Press Return if you wish to install the low-module (ZLX-M1) and mid-module (ZLX-M2) Pixelvision files. Type NO if you do not want this support. 10.Install the ZLX-E, ZLXp-E, PowerStorm 3D30, and PowerStorm 4D20 device files. * Do you wish to install ZLX-E1, E2, E3, ZLXp-E1, E2, E3, PowerStorm 3D30, and PowerStorm 4D20 files [YES]? N 2-8 Installing DIGITAL Open3D Press Return if you wish to install the ZLX-E, ZLXp-E, PowerStorm 3D30, and PowerStorm 4D20 device files. Type NO if you do not want this support. 11.Install the ZLX-L and ZLXp-L device files. * Do you wish to install ZLX-L1, L2 and ZLXp-L1, L2 files [YES]? N Press Return if you wish to install the ZLX-L and ZLXp-L files. Type NO if you do not want this support. 12.Install the button and dial box device files. * Do you wish to install PCM and IDL (Button and Dial Box Support) files [YES]? 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. 13.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. 14.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. 15.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. 16.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. Installing DIGITAL Open3D 2-9 17.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. 18.Install the OpenGL programming example files. * Do you wish to install OpenGL Programming Example Files [YES]? Press Return if you wish to install the files containing OpenGL programming examples. Type NO if you do not want this support. 19.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. 2-10 Installing DIGITAL Open3D %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 OPEN3D V4.3 completed at hh:mm Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]OPEN3D043.VMI_DATA 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. 20.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. Installing DIGITAL Open3D 2-11 3 _________________________________________________________________ After Installing DIGITAL Open3D After installing DIGITAL 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 DIGITAL 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 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 DIGITAL 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 DIGITAL 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 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. After Installing DIGITAL Open3D 3-3 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 DIGITAL Open3D, you should report it to DIGITAL. Depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call DIGITAL if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance 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 DIGITAL for reporting SPD nonconformance problems. 3-4 After Installing DIGITAL Open3D A _________________________________________________________________ Files Installed on Your System The DIGITAL 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$SYSROOT:[SYS$HELP] OPEN3D043.RELEASE_NOTES OPEN3D043_RELEASE_NOTES.PS ___________________________________________________________ Save Set N-Driver Files Required for all Devices (OpenVMS Alpha_Version_7.1)_________________________________________ SYS$SYSROOT:[SYS$LDR] 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$SYSROOT:[SYS$LIBRARY] DECW$GRAPHICS_ICBM_0302.EXE DECW$GRAPHICS_ICBM_0402.EXE DECW$GRAPHICS_ICBM_0702.EXE SYS$SYSROOT:[SYS$MANAGER] DECW$MWM_OVERLAY.COM SYCONFIG_ADDITION.COM SYCONFIG_OPEN3D.COM SYS$SYSROOT:[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$SYSROOT:[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$SYSROOT:[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$SYSROOT:[SYS$LIBRARY] DECW$SERVER_DDX_GV.EXE SYS$SYSROOT:[SYS$MANAGER] DECW$DEVICE_CONFIG_GV.COM SYS$SYSROOT:[SYS$SYSTEM] DECW$SERVER_PVRM.EXE ___________________________________________________________ Save_Set_E-ZLX-E_and_ZLXp-E_Files__________________________ SYS$SYSROOT:[SYS$LIBRARY] DECW$SERVER_DDX_GY.EXE SYS$SYSROOT:[SYS$MANAGER] DECW$DEVICE_CONFIG_GY.COM ___________________________________________________________ Save_Set_F-ZLX-L_and_ZLXp-L_Files__________________________ SYS$SYSROOT:[SYS$LIBRARY] DECW$SERVER_DDX_GU.EXE SYS$SYSROOT:[SYS$MANAGER] DECW$DEVICE_CONFIG_GU.COM SYS$SYSROOT:[SYS$SYSTEM] DECW$SERVER_PVRM.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$SYSROOT:[SYS$LIBRARY] C_IDL.H PCM$LIBSHR.EXE SYS$SYSROOT:[SYS$SYSTEM] PCM$SERVER.EXE SYS$SYSROOT:[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___ DECW$INCLUDE:[EXTENSIONS] DECSTEREO.H DECSTEREOSTR.H SYS$SYSROOT:[SYS$LIBRARY] DECW$STEREOLIBSHR.EXE EXTUTIL.H MULTIBUF.H (continued on next page) A-4 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files__________________________ Directory__________File_Name_______________________________ MULTIBUFST.H XEXT.H ___________________________________________________________ Save_Set_I-DEC_PEXlib_Files________________________________ SYS$SYSROOT:[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$SYSROOT:[SYS$TEST] PST_CUBE.COM PST_CUBE.EXE ___________________________________________________________ Save_Set_J-MIT_PEXlib_Files________________________________ SYS$SYSROOT:[SYS$LIBRARY] DECW$MITPEXLIBSHR.EXE (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________________________________ DECW$INCLUDE:[PEX5] PEX.H PEXLIB.H 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 (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_NEG14.FNT VAXGFX$FONT_NEG15.FNT VAXGFX$FONT_NEG16.FNT 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$SYSROOT:[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 (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_______________________________ GLXPROTO.H SYS$SYSROOT:[SYS$SYSTEM] XGLINFO.EXE SYS$SYSROOT:[SYS$TEST] GL_IVP.COM GL_IVP.EXE ___________________________________________________________ Save_Set_M-OpenGL_Programming_Example_Files________________ SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.EXAMPLES] *.C JITTER.H VMS_EXAMPLES.COM VMS_EXAMPLES.MMS VMS_EXAMPLES.README VMS_LINK_EXAMPLES.OPT XFONT.C 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 (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________________ TEAPOT.H VECT3D.C 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_LIBFONT.COM VMS_LIBFONT.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 (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________________ VMS_LIBTK.README WINDOW.C SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.SAMPLES] *.RGB *.C VMS_LINK_SAMPLES.OPT VMS_SAMPLES.COM VMS_SAMPLES.MMS VMS_SAMPLES.README VMS_SYMBOLS_SAMPLES.COM WAVE.C SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.VISINFO] FINDVIS.C VISINFO.C VISINFO.H VMS_README.TXT VMS_VISINFO.COM VMS_VISINFO.MMS VMS_VISINFO.OPT (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________________ SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.WIDGETS] DOUBLE.C SIMPLE.C VMS_LINK_WIDGETS.OPT VMS_WIDGETS.COM VMS_WIDGETS.MMS 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 DIGITAL Open3D. The sample installations assume that DECnet has been shut down, and no users are logged on to your system. $ @VMSINSTAL OPEN3D043 OpenVMS AXP Software Product Installation Procedure V7.1 It is 3-APR-1997 at 12:48. 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: DKA400: Enter the products to be processed from the first distribution volume set. * Products: OPEN3D043 * Enter installation options you wish to use (none): The following products will be processed: OPEN3D V4.3 Beginning installation of OPEN3D V4.3 at 12:48 %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]? Product: OPEN3D Producer: DEC Version: 4.3 Release Date: 02-MAY-1997 * Does this product have an authorization key registered and loaded? Y * Do you wish to install ZLX-M1 and M2 files [YES]? * Do you wish to install ZLX-E1, E2, E3, ZLXp-E1, E2, E3, PowerStorm 3D30, and PowerStorm 4D20 files [YES]? Sample Installation B-1 * Do you wish to install ZLX-L1, L2 and ZLXp-L1, L2 files [YES]? * Do you wish to install PCM and IDL (Button and Dial Box Support) files [YES]? * Do you wish to install the 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 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. @sys$manager:syconfig_open3d.com B-2 Sample Installation This kit has supplied a window manager capable of supporting overlay planes on the ZLX-M1, ZLX-M2, ZLX-L1, ZLX-L2, ZLX-E2, ZLX-E3, ZLXp-E2, ZLXp-E3, ZLXp-L1, ZLXp-L2, PowerStorm 3D30, and PowerStorm 4D20. Please see the release notes for further information on the window manager. 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 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-MOVEFILES, Files will now be moved to their target directories... Installation of OPEN3D V4.3 completed at 12:52 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]OPEN3D043.VMI_DATA VMSINSTAL procedure done at 12:53 Sample Installation B-3