                                 H                     ____________________________________________________!                     Compaq Open3D @                     for OpenVMS Alpha Systems Installation Guide  -                     Order Number: AA-R3WQJ-TE                          June 2001   F                     This document contains instructions for installingH                     Compaq Open3D (formerly DIGITAL Open3D) for OpenVMS)C                     Alpha Systems. It also explains how to read the H                     online release notes before or after installing this                     product.              ?                     Revision/Update Information:  This document @                                                   supersedes the@                                                   DIGITAL Open3DH                                                   Installation Guide forG                                                   OpenVMS Alpha Systems   G                     Operating System and Version: OpenVMS Alpha Version H                                                   7.1, 7.1-1H1, 7.1-1H2,D                                                   7.1-2, 7.2, 7.2-1,A                                                   7.2-1H1, or 7.3   G                     Software Version:             Compaq Open3D Version 6                                                   4.9B  /                     Compaq Computer Corporation "                     Houston, Texas                 J           ________________________________________________________________  ,            2001 Compaq Computer Corporation  B           Compaq, VAX, VMS, and the Compaq logo Registered in U.S.&           Patent and Trademark Office.  =           All other product names mentioned herein may be the A           trademarks or registered trademarks of their respective            companies.  C           Confidential computer software. Valid license from Compaq C           required for possession, use, or copying. Consistent with >           FAR 12.211 and 12.212, Commercial Computer Software,A           Computer Software Documentation, and Technical Data for D           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.   E                                                                ZK6270   D           This document was prepared using DECdocument, Version 3.3-
           1b.                                  C   _________________________________________________________________   C                                                            Contents       C   Preface...................................................      v   '   1  Preparing to Install Compaq Open3D   C         1.1   Prerequisite Software.........................    1-2 C         1.2   Online Release Notes..........................    1-2 C         1.3   Media Distribution Kit........................    1-3 C         1.4   License Registration..........................    1-3 C         1.5   Installation Procedure Requirements...........    1-4 C         1.5.1     Privileges................................    1-4 C         1.5.2     Disk Space................................    1-4 <         1.5.3     Global Pagelets and Global Sections SystemC                   Parameters................................    1-5 7         1.5.3.1     Determining the Global Pagelets and C                     Global Sections Available...............    1-5 7         1.5.3.2     Determining the Global Pagelets and C                     Global Sections Currently in Use........    1-6 1         1.5.3.3     Modifying the Global Pagelets C                     Parameter...............................    1-7 1         1.5.3.4     Modifying the Global Sections C                     Parameter...............................    1-8 6         1.5.3.5     Recalculating the Global Pages andC                     Global Sections Parameters..............    1-8 C         1.5.4     Process Account Quotas....................    1-9 C         1.5.5     Virtual Page Count........................   1-10 C         1.5.6     Backing Up Your System Disk...............   1-10 C         1.6   Error Recovery................................   1-10               C                                                                 iii                         2  Installing Compaq Open3D   %     3  After Installing Compaq Open3D   E           3.1   System Tuning.................................    3-1 E           3.1.1     Minimum System Requirements...............    3-1 1           3.1.2     System Requirements for Large E                     Applications..............................    3-2 E           3.1.3     Optimizing Performance....................    3-3 E           3.2   Determining and Reporting Problems............    3-4   %     A  Files Installed on Your System          B  Sample Installation    
     Tables  5           1-1       Minimum Required System Parameter E                     Values....................................    1-5   =           1-2       Process Account Quotas for the Installing E                     Account...................................    1-9   9           3-1       Minimum Recommended Quotas for System E                     Tuning....................................    3-1   4           3-2       Recommended Quotas for DemandingE                     Applications..............................    3-3   E           A-1       Installed Files...........................    A-1                                iv                             I         _________________________________________________________________   I                                                                   Preface       F               This document describes how to install the Compaq Open3DC               Version 4.9B software on Alpha processors running the G               OpenVMS Alpha operating system. Because this installation H               guide is not revised for all software maintenance updates,H               you should read the Read Before Installing or Using CompaqF               Open3D for OpenVMS Alpha Systems letter for a summary ofD               the significant changes to the installation procedure.  E               Keep this document with your distribution kit. You will D               need it to install maintenance updates or to reinstall1               Compaq Open3D for any other reason.            Intended Audience   H               This guide is for system managers installing Compaq Open3D0               software on OpenVMS Alpha systems.           Document Structure  1               This guide is organized as follows:   F               o  Chapter 1 describes the operating system requirementsG                  for Compaq Open3D installation and the procedures that E                  you should complete before installing Compaq Open3D.   D               o  Chapter 2 describes the installation procedures for%                  local installations.   E               o  Chapter 3 describes the operations you perform after                   installation.  I               o  Appendix A lists the files installed with Compaq Open3D.   F               o  Appendix B contains a sample log from a Compaq Open3D                  installation.  I                                                                         v                    #     Compaq Open3D Documentation Set   D           In addition to this guide, the Compaq Open3D documentation-           set includes the following manuals:              o  Using OpenGL        Related Documents   B           For information related to this guide, see the following           manuals:  ,           o  OpenVMS System Manager's Manual  .           o  Guide to Maintaining a VMS System  6           o  OpenVMS License Management Utility Manual  4           o  Guide to OpenVMS Performance Management  B           For additional information about Compaq OpenVMS productsB           and services, access the Compaq website at the following           location:   (           http://www.openvms.compaq.com/       Reader's Comments   C           Compaq welcomes your comments on this manual. Please send 8           comments to either of the following addresses:  +           Internet    openvmsdoc@compaq.com   1           Mail        Compaq Computer Corporation :                       OSSG Documentation Group, ZKO3-4/U08       Conventions   ;           The following conventions are used in this guide:   C           UPPERCASE TEXT   Uppercase letters indicate the name of a B                            command, file, parameter, procedure, or#                            utility.   ?           bold             Boldface text is used in interactive A                            examples to indicate typed user input.        vi                     F               $                The dollar sign is used to indicate theG                                DCL prompt. This prompt may be different .                                on your system.  G               system output    This typeface is used in interactive and G                                code examples to indicate system output. I                                In text, this typeface is used to indicate C                                the exact name of a command, option, H                                partition, path name, directory, or file.  I               [logical-name]   Square brackets indicate that the enclosed E                                item is optional. (Square brackets are H                                not, however, optional in the syntax of aH                                directory name in a file specification orI                                in the syntax of a substring specification ;                                in an assignment statement.)   I               <Ctrl/X>         In procedures, a sequence such as <Ctrl/X> H                                indicates that you must hold down the keyG                                labeled Ctrl while you press another key G                                or a pointing device button, for example (                                <Ctrl/C>.  A               <Return>         In procedures, a key name is shown D                                enclosed to indicate that you press a3                                key on the keyboard.   I                                Vertical ellipsis in an example means that F                   .            information not directly related to the8                   .            example has been omitted.                   .   E               VMS              The terms VMS and OpenVMS refer to the 5               OpenVMS          same operating system.   G               Compaq Open3D    References to Compaq Open3D refer to the F                                Compaq Open3D (formerly DIGITAL Open3D)'                                product.             I                                                                       vii                          I                                                                         1 I         _________________________________________________________________   I                                        Preparing to Install Compaq Open3D     I               To make your installation run smoothly, you should complete C               the preparation requirements outlined in this chapter G               before starting the installation procedures in Chapter 2.   A               This chapter will help you determine the following:   D               o  Whether the system on which you will install Compaq?                  Open3D has the prerequisite software installed   5               o  How to read the online release notes   E               o  If installing Compaq Open3D from media, whether your G                  distribution kit includes all the components listed on ,                  the Bill of Materials (BOM)  3               o  How to register a software license   D               o  The privileges required to perform the installation  2               o  How much disk space you will need  H               o  Whether the global pagelets and sections parameters are!                  defined properly   I               o  Whether the process account quotas are defined correctly   ?               o  Whether the value of the virtual page count is                   sufficient   0               o  How to back up your system disk  A               o  How to recover from errors that may occur during                   installation       I                                    Preparing to Install Compaq Open3D 1-1                         1.1 Prerequisite Software   D           To install Compaq Open3D on an Alpha workstation, you must!           have already installed:   A           o  OpenVMS Alpha Operating System Version 7.1, 7.1-1H1, 8              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  A           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   D           o  Programming support-necessary to develop programs using              OpenGL   .           o  OpenVMS Alpha workstation support       1.2 Online Release Notes  D           Compaq strongly recommends that you read the Compaq Open3DC           release notes before using this product, because they may 4           contain information about product changes.  B           During installation, you can access release notes in theC           installation procedure when you invoke VMSINSTAL with the E           OPTIONS N parameter. This option lets you read or print the 8           release notes before installing Compaq Open3D.  >           After installation, you can obtain the Compaq Open3D8           release notes by printing the following files:  <           o  SYS$HELP:OPEN3D49B.RELEASE_NOTES (ASCII format)  D           o  SYS$HELP:OPEN3D49B_RELEASE_NOTES.PS (PostScript format)        *     1-2 Preparing to Install Compaq Open3D                   "         1.3 Media Distribution Kit  D               Your bill of materials (BOM) and indented bills reportB               (BIL) specify the number and contents of your media.B               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 localC               Compaq representative. For more information on how to C               mount distribution media, see your processor-specific G               installation/operations guide, which also details several 5               options for the installation procedure.             1.4 License Registration  F               Before you install and run Compaq Open3D Version 4.9B onG               a newly licensed node or cluster, you must first register E               a License Product Authorization Key (License PAK) using G               the License Management Facility (LMF). The PAK is a paper E               certificate that contains information about the license F               that enables you to use the software. The License PAK isG               shipped with the kit if you ordered the license and media E               together; otherwise, the PAK is shipped separately to a 7               location specified on your license order.   C               If you are installing Compaq Open3D as an update on a A               node or cluster already licensed for this software, E               you have already completed the License PAK registration A               requirements. If you are installing prerequisite or_D               optional software along with Compaq Open3D, review theF               PAK status and install the PAKs for this prerequisite orA               optional software before you install Compaq Open3D.   G               To register a license under the OpenVMS operating system, G               first log in to the system manager's account, SYSTEM. You ?               can then register the license in one of two ways:   H               o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When itH                  prompts you for information, respond with the data from"                  your License PAK.  G               o  Enter the LICENSE REGISTER command with the qualifiers >                  corresponding to the License PAK information.  H               For complete information on using the LMF, see the OpenVMS0               License Management Utility Manual.  I                                    Preparing to Install Compaq Open3D 1-3                    +     1.5 Installation Procedure Requirements,  @           This section describes the requirements for installingE           Compaq Open3D. The installation takes approximately 5 to 20 C           minutes, depending on your system configuration. A samplesD           installation is included in Appendix B of this document to           assist you.m       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:a             o  CMKRNL              o  WORLD             o  SYSPRVl  =           When you invoke VMSINSTAL to begin the installation >           procedure, VMSINSTAL turns off the BYPASS privilege.       1.5.2 Disk Space  A           During the installation of Compaq Open3D, approximately D           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 currentoE           system disk, enter the following command at the DCL prompt:t  .           $ SHOW DEVICE SYS$SYSDEVICE <Return>  D              _______________________ Warning _______________________  ?              You must ensure that your system has the necessaryn>              global pagelet (512-byte subpage unit) and globalC              section SYSGEN quotas for the installation. Otherwise, ;              the DCL tables may become corrupted in certains              situations.  C              ______________________________________________________   *     1-4 Preparing to Install Compaq Open3D s  e              C         1.5.3 Global Pagelets and Global Sections System Parameters   G               The installation of Compaq Open3D requires minimum valuesiD               for the system parameters defining the global pageletsG               and global sections. These values are shown in Table 1-1._I               Depending on the kinds of programs and applications runningtA               at your site, you may need to define larger values..  I               Table_1-1_Minimum_Required_System_Parameter_Values_________q  I               System_Parameter___________Minimum_Value___________________e  /               GBLSECTIONS[1]             n + 10.  0               GBLPAGES[1]                n + 750I               [1]The_n_variable_refers_to_the_system_parameter_values____   F               that are currently in use. To install Compaq Open3D, youA               must increase those values by the number indicated. H               These dynamic system parameters must be set permanently toG               values equal to or greater than the values listed. Do not ;               decrease these values after the installation. I               ___________________________________________________________l  5               The following sections describe how to:.  C               o  Determine the number of global pagelets and globalS#                  sections available-  G               o  Determine the global pagelets and global sections used   5               o  Modify the global pagelets parameter   5               o  Modify the global sections parameter   D               o  Recalculate the global pagelets and global sectionsH                  parameters in order to take the new values into account  C         1.5.3.1 Determining the Global Pagelets and Global Sectionsu                 Available   H               You can determine the available global pagelets and globalC               sections by using the WRITE command with the F$GETSYI B               lexical function. The following example shows how toD               display this information on your terminal (the default               for SYS$OUTPUT):  I                                    Preparing to Install Compaq Open3D 1-53                     ?           $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") <Return>.           15848y?           $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") <Return>t           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 C           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, asu.           described in the following sections.  >           You can also determine the number of global sections5           available by using the following procedure:.  '           1. Invoke the SYSGEN Utility:u  -              $ RUN SYS$SYSTEM:SYSGEN <Return> )              SYSGEN> USE CURRENT <Return>.  ?           2. Determine the number of global sections available:   V              Parameter Name        Current   Default   Minimum   Maximum Unit  DynamicV              --------------        -------   -------   -------   ------- ----  -------Q              GBLSECTIONS               400       250        20      4095 Sections_  E              The first number displayed is the total number of global B              sections. Compare this number to the number of globalE              sections in use displayed by the OpenVMS Install UtilitywE              (see Section 1.5.3.2). The difference will be the numbert*              of gloabl sections available.  *           3. Exit from the SYSGEN Utility:  "              SYSGEN> EXIT <Return>  ?     1.5.3.2 Determining the Global Pagelets and Global Sections              Currently in Use  D           To determine the global pagelets and global sections used:  0           1. Invoke the OpenVMS Install Utility:  9              $ INSTALL :== $INSTALL/COMMAND_MODE <Return>               $ INSTALL <Return>n  *     1-6 Preparing to Install Compaq Open3D O  3              >               2. Determine the number of global pagelets used:  6                  INSTALL> LIST/GLOBAL/SUMMARY <Return>  5                          Galaxy Group Global Sectionso  T                      nn Global Sections Used,  nnnn/nnnn Global Pagelets Used/Unused  '                  INSTALL> EXIT <Return>   7               3. Exit from the OpenVMS Install Utility:o  '                  INSTALL> EXIT <Return>   7         1.5.3.3 Modifying the Global Pagelets Parameter   6               To modify the number of global pagelets:  G               1. If there are fewer than 750 pagelets available, modifyr/                  the GBLPAGES system parameter.   E                  You can modify the GBLPAGES parameter by editing theeE                  SYS$SYSTEM:MODPARAMS.DAT file. To change a parametersG                  value in this file, delete the current value and enter F                  the new value. (Another way of allocating space is toH                  delete an existing known image with the OpenVMS Install                  Utility.)  G                  To modify GBLPAGES, use ADD_GBLPAGES as shown, where n 9                  is the number of global pagelets to add:   !                  ADD_GBLPAGES = nt  F                 ________________________ Note ________________________  E                 When you set the pagelet file quota, you should use a E                 value that does not exceed the amount of pagelet file .                 space available on the system.  F                 ______________________________________________________  !               2. Exit the editor.t  F               3. Update the GBLPAGES parameter by invoking the AUTOGEN@                  command procedure described in Section 1.5.3.5.  I                                    Preparing to Install Compaq Open3D 1-7h o  w              3     1.5.3.4 Modifying the Global Sections Parameter   2           To modify the number of global sections:  D           1. If the number of global sections in use plus 10 exceedsA              the current number of global sections (i.e. if there E              are fewer than 10 global sections available), modify the #              GBLSECTIONS parameter.i  D              You can modify the GBLSECTIONS parameter by editing theA              SYS$SYSTEM:MODPARAMS.DAT file. To change a parameter C              value in this file, delete the current value and enter               the new value.   A              To modify GBLSECTIONS, use ADD_GBLSECTIONS as shown, =              where n is the number of global sections to add:i                 ADD_GBLSECTIONS = n             2. Exit the editor.   E           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  C           To update the GBLPAGES and GBLSECTIONS parameters, invoke @           the AUTOGEN command procedure, SYS$UPDATE:AUTOGEN.COM:  7           $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT <Return>e  @           AUTOGEN automatically recalculates the parameters withC           the values you defined manually. When you specify REBOOT, @           AUTOGEN performs an automatic system shutdown and thenC           reboots the system. Any users logged on to the system aret7           immediately disconnected during the shutdown.   ?           AUTOGEN also automatically adjusts some of the SYSGEN A           parameters, based on the consumption of resources since B           the last reboot. If you do not want to take advantage ofE           this automatic adjustment, include the NOFEEDBACK qualifier &           on the AUTOGEN command line.  C           For more information about using AUTOGEN, see the OpenVMS #           System Management Subkit.s  *     1-8 Preparing to Install Compaq Open3D                   $         1.5.4 Process Account Quotas  C               The account you use to install Compaq Open3D requires G               certain minimum quota values. These values are summarized                in Table 1-2.   I               Table_1-2_Process_Account_Quotas_for_the_Installing_Account   I               Account_Quota_________________Value________________________r  1               ASTLM                            24r  1               BIOLM                            18r  2               BYTLM                         18,000  1               DIOLM                            18)  1               ENQLM                            30   I               FILLM____________________________20________________________   H               These values are defined in the SYSUAF.DAT file. To verifyG               and change user account quotas, use the OpenVMS Authorize_               Utility as shown:   I               1. Set your directory to SYS$SYSTEM and then run AUTHORIZE:   2                  $ SET DEFAULT SYS$SYSTEM <Return>)                  $ RUN AUTHORIZE <Return>p                  UAF>t  E               2. At the AUTHORIZE prompt (UAF>), use the SHOW commandoD                  with an account name to check a particular account:  )                  UAF> SHOW SMITH <Return>e  I               3. To change a quota, use the MODIFY command, where nnnn is 6                  the value of the quota to be changed:  5                  MODIFY account-name /quota-name=nnnn   H                  The following example changes the FILLM quota value for#                  the SMITH account:e  5                  UAF> MODIFY SMITH /FILLM=50 <Return>O  1               4. Exit from the Authorize Utility:e  #                  UAF> EXIT <Return>   I                                    Preparing to Install Compaq Open3D 1-9y w                 A              After you exit from the utility, the system displays @              messages indicating whether changes were made. OnceD              the changes have been made, you must log out and log in5              again for the new quotas to take effect.   ?           For more information on modifying account quotas, seeiC           the description of the Authorize Utility in the operatingnC           system documentation on system management and operations.        1.5.5 Virtual Page Count  D           It is no longer necessary to adjust the virtual page countB           value. Starting with OpenVMS Version 7.0, VIRTUALPAGECNT@           has been an obsolete parameter on Alpha systems. Note,C           however, that the parameter remains in existence on Alpha,B           systems for compatability purposes and has a default andC           maximum value of %X7FFFFFFF. SYSBOOT and AUTOGEN are used (           to enforce this default value.  %     1.5.6 Backing Up Your System Diskl  E           Compaq recommends that you back up your system disk, before A           installing any software. Use the backup procedures thatfA           are established at your site. For details on performings@           a backup, see the section on the backup utility in the-           operating system documentation set.        1.6 Error Recovery  A           If errors occur during installation, VMSINSTAL displays D           failure messages. If the installation fails, the following           message is displayed:   L           %VMSINSTAL-E-INSFAIL, The installation of OPEN3D V4.9B has failed.  @           Errors can occur during the installation if any of the&           following conditions exists:  7           o  The operating system version is incorrect.   :           o  A prerequisite software version is incorrect.  =           o  Quotas necessary for successful installation aree              insufficient.  D           o  System parameter values for successful installation are              insufficient.  D           o  The product license has not been registered and loaded.  +     1-10 Preparing to Install Compaq Open3D     .              E               If you are notified that any of these conditions exist,iE               you should take the appropriate action, as described in H               the error message. For descriptions of the error messages,H               see the operating system documentation on system messages,=               recovery procedures, and software installation.                                                                                 I                                   Preparing to Install Compaq Open3D 1-11a n  e                    I                                                                         2eI         _________________________________________________________________a  I                                                  Installing Compaq Open3Dc    C               This chapter describes the Compaq Open3D installationzH               procedure. For a list of the files and directories createdF               during the installation procedure, see Appendix A. For a?               sample installation example, refer to Appendix B.   D               To abort the installation procedure at any time, pressG               Ctrl/Y. When you press Ctrl/Y, the installation procedure,C               deletes all files it has created up to that point andd?               exits. You can then start the installation again.oC               Attempting to link programs against the Compaq Open3D 6               run-time library results in link errors.  F               Before you install Compaq Open3D, Compaq recommends thatB               you back up your system disk. Once you have done so,D               you can begin the installation. The installation takesE               approximately 5 to 20 minutes, depending on your systemw               configuration.  F               Following is the procedure for installing Compaq Open3D.  D               1. Log in to a privileged account and set your default4                  device and directory to SYS$UPDATE.  D                  Compaq recommends that you use the system manager's                  account.t  +                  Username: SYSTEM  <Return> +                  Password:         <Return>y2                  $ SET DEFAULT SYS$UPDATE <Return>  "               2. Invoke VMSINSTAL.  D                  When you invoke VMSINSTAL, it checks the following:  F                  o  Whether you are logged in to a privileged account.I                     You should install software from the system manager's I                     account with your default device and directory set to                      SYS$UPDATE.e  I                                              Installing Compaq Open3D 2-1                    <              o  Whether the installing account has adequate:                      Disk spacef"                    Global pagelets"                    Global sections!                    Account quotast  B              o  Whether you have adequate quotas for installation.>                 VMSINSTAL requires the following minimum quota                 values:                       ASTLM = 24                     BIOLM = 18R                     BYTLM = 18000                    DIOLM = 18                     ENQLM = 30                     FILLM = 20s  7              o  Whether the following conditions exist:   4                 -  DECnet network is up and running.  5                 -  Users are logged in to the system.i  E              If VMSINSTAL detects problems, you will be asked whetheri>              you want to continue the installation. You shouldD              correct these problems before resuming the installationA              procedure. If you want to continue, type YES. If you 9              want to stop the installation, press Return._  >              To invoke the VMSINSTAL command procedure, enter:  P              $ @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N <Return>  E              All VMSINSTAL parameters are optional. If not entered oni3              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-nameB              The name of the device on which you plan to mount theD              distribution volumes for the Compaq Open3D installationC              media. The format of the device name is ddcu, where ddsC              is the device code, c is the controller code, and u isn        2-2 Installing Compaq Open3D i                 H                  the unit number. For example, DKA400 is the device name                  for a CD-ROM.  D                  You do not have to use the console drive to installI                  Compaq Open3D. If you do use the console drive after the G                  installation, you should replace any media you removed :                  from the drive prior to the installation.  E                  For CD-ROM media, you must also supply the directoryOI                  location of the Compaq Open3D save set on the CD-ROM. TodG                  obtain this location, see the Software Product Library F                  Master Index that accompanies the CD-ROM distributionI                  kit, or complete the following steps before starting the                   installation:  I                  a. Determine whether the CD-ROM drive is already mounteds,                     by entering the command:  3                     $  SHOW DEVICE DKA400: <Return>   G                     If the device is mounted, skip to the next step. IfdI                     it is not mounted, type the appropriate MOUNT commandeI                     to mount the CD-ROM, omitting the /FOREIGN qualifier.   F                  b. Obtain the directory name by entering the command:  D                     $ DIRECTORY DKA400:[000000]*open3d*.dir <Return>  F                     The directory name will be displayed; for example:  -                     Directory DKA400:[000000]h  $                     OPEN3DB049.DIR;1  I                  c. Obtain the save set name by using a DIRECTORY command C                     specifying the directory file from the previous )                     command; for example:a  C                     $ DIRECTORY DKA400:[OPEN3DB049.KIT]*.A <Return>                     OPTIONS NE                  An optional parameter that enables you to access theUC                  release notes. If you do not include the OPTIONS N H                  parameter, VMSINSTAL does not ask you about the releaseB                  notes. You should review the release notes beforeG                  proceeding with the installation, because they containa?                  additional information about the installation.h  H                  There are several other options you can select when you"                  invoke VMSINSTAL:  I                                              Installing Compaq Open3D 2-3                    &              o  Auto_answer option (A)  B                 This option initially creates a file that contains@                 your answers to VMSINSTAL questions and prompts.D                 You can then use the option (and the answer file) toB                 save time during a reinstallation (typically after'                 upgrading your system).   '              o  Get save set option (G)   C                 This option lets you temporarily store product save ?                 sets on a magnetic tape or in a disk directory.   #              o  File log option (L)   D                 This option logs all activity to the terminal during                 installation.g  )              o  Alternate root option (R)u  D                 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,c>              and options, VMSINSTAL prompts you for them later>              in the installation. If you specify more than oneD              option, separate the options with commas (for instance,C              OPTIONS A,N). See the OpenVMS System Management SubkiteE              documentation for detailed information on these options.$  ?              The following example invokes VMSINSTAL to installL.              Compaq Open3D from drive DKA400::  Z              $ @SYS$UPDATE:VMSINSTAL OPEN3DB049 DKA400:[OPEN3DB049.KIT] OPTIONS N <Return>  K                    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.   E              If DECnet software is running, VMSINSTAL displays a listlE              of all active processes and asks if you want to continue.              the installation:        2-4 Installing Compaq Open3D h  u              L                  %VMSINSTAL-W-DECNET, Your DECnet network is up and running.                     .                      .p                     . @                  * Do you want to continue anyway [NO]? <Return>  H                  You should install Compaq Open3D on a standalone systemG                  or cluster with DECnet shut down; therefore, NO is the 2                  default response to the question.                                                                        I                                              Installing Compaq Open3D 2-5A ,  e              #           4. Confirm system backup.i    T              * Are you satisfied with the backup of your system disk [YES]? <Return>  >              You should always back up your system disk beforeB              performing an installation. If you are satisfied withE              the backup of your system disk, press Return. Otherwise,l@              enter NO and press Return to stop the installation.D              After you back up your system disk, you can restart the              installation.  C              In most cases, the distribution media is a CD-ROM thatNE              has been mounted before the installation. If this is not 9              the case, refer to your media documentation.q             5. Mount the media.   D              If you omitted the device name on the VMSINSTAL command0              line, the following prompt appears:  N              * Where will the distribution volume be mounted: DKA400: <Return>  @              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-ROMN@              located on unit DKA400:, and the Compaq Open3D saveC              set is located in the directory OPEN3DB049.KIT, enter:   $              DKA400:[OPEN3DB049.KIT]  C              Depending on the type of device and whether the deviceCE              is already mounted, the following may or may not appear:   A              Please mount the first volume of the set on DKA400:. (              * Are you ready? Y <Return>  B              If you entered the wrong device name when you invokedB              VMSINSTAL and need to restart the installation, enterD              NO in response to the "Are you ready?" question. If youB              respond YES to indicate that you are ready, VMSINSTALB              indicates that the media containing Compaq Open3D hasD              been mounted, and then prompts for the product name and.              any desired installation options:        2-6 Installing Compaq Open3D .  e              2                  MOUNT-I-MOUNTED, DKA400: mounted)  [                  Enter the products to be processed from the first distribution volume set.   '                  * Products: OPEN3DB049 E                  * Enter installation options you wish to use (none):S  :                  The following products will be processed:                      OPEN3DB V49  H                          Beginning installation of OPEN3DB V49 at hh:mm.  E                  %VMSINSTAL-I-RESTORE, Restoring product saveset A...a  /               6. Select a release notes option.i  G                  This step applies only if you specified OPTIONS N when-'                  you invoked VMSINSTAL.   '                  Release Notes Options:o  -                      1. Display release noteso+                      2. Print release notes $                      3. Both 1 and 2)                      4. None of the aboveb  0                  * Select option [2]: 1 <Return>  G                  If you select option 1, VMSINSTAL displays the release_C                  notes immediately on the console terminal. You can F                  terminate the display at any time by pressing Ctrl/C.  D                  If you select option 2, VMSINSTAL prompts you for aH                  queue name. Either type a queue name or press Return toB                  send the file to the default output print device:  3                  * Queue name [SYS$PRINT]: <Return>u  G                  If you select option 3, VMSINSTAL displays the releaseuG                  notes on the terminal and then prompts you for a queuesE                  name for the printed version. After you type a queuenE                  name or press Return to send the file to the default F                  output print device, the release notes are copied to:  C                  o  SYS$HELP:OPEN3D49B.RELEASE_NOTES (ASCII format)   C                  o  SYS$HELP:OPEN3D49B_RELEASE_NOTES.PS (PostScript                      format)e  I                                              Installing Compaq Open3D 2-7n i                 @              If you select option 4, VMSINSTAL does not display,=              print, or copy the release notes. This option isi:              typically used when you wish to terminate the              installation.  C              ________________________ 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 for0              previous versions of Compaq Open3D.  C              ______________________________________________________   :              VMSINSTAL then displays the following prompt:  H              * Do you want to continue the installation [N]?: Y <Return>X              %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.  A              If you selected release notes option 4 and now presstC              Return to stop the installation, the release notes are E              copied to the SYS$HELP directory. If you selected option B              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.n  W              * Do you want to purge files replaced by this installation [YES]? <Return>   D              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 aremA              not automatically purged. Purging is recommended. InrB              response to the purging prompt, press Return to purge/              the files or type NO to keep them.o  D              Appendix A lists the files on the system that are added8              or modified when you install Compaq Open3D.  5           8. Respond to license registration queries.a              2-8 Installing Compaq Open3D e  l              B                  Compaq Open3D supports the VMS License ManagementD                  Facility (LMF). The installation procedure displaysH                  license information about your product and then asks ifF                  you have registered and loaded your authorization keyG                  for Compaq Open3D. The following is an example of thisa                  information:a    )                     Product:       OPEN3D &                     Producer:      DEC'                     Version:       4.9Bs.                     Release Date:  20-NOV-1998  `                  * Does this product have an authorization key registered and loaded? Y <Return>  ?                  Your PAK must be registered and loaded for thesF                  installation to complete successfully. If this is notD                  the case, you must answer NO to this question, stopG                  the installation, register and load your PAK, and thent*                  restart the installation.  G               9. Install the PowerStorm 3D30 and PowerStorm 4D20 device                   files.   d                  * Do you wish to install PowerStorm 3D30 and PowerStorm 4D20 files [YES]?  <Return>  H                  Press Return if you wish to install the PowerStorm 3D30H                  and PowerStorm 4D20 device files. Type NO if you do not#                  want this support.   1              10. Install the ZLXp-L device files.   U                  * Do you wish to install ZLXp-L1 and ZLXp-L2 files [YES]? N <Return>r  F                  Press Return if you wish to install the ZLXp-L files.9                  Type NO if you do not want this support.   >              11. Install the button and dial box device files.  l                  * Do you wish to install PCM and IDL (Button and Dial Box Support) files [YES]?  N <Return>  F                  Press Return if you wish to install PCM and IDL filesG                  for button and dial box support. Type NO if you do nott#                  want this support.p  I                                              Installing Compaq Open3D 2-9a r  l              E          12. Install the X multibuffering and stereo extension files.d    a              * Do you wish to install X multibuffering and Stereo extension files [YES]? <Return>   E              Press Return if you wish to install the X multibufferingoC              and stereo extension files. Type NO if you do not want               this support.  E          13. Install the DEC PEXlib application programming interfaceo              files.   d              * Do you wish to install DEC PEXlib (PEX programming interface) files [YES]? N <Return>  ?              Press Return if you wish to install the DEC PEXlibtD              programming interface files. Type NO if you do not want              this support.  E          14. Install the MIT PEXlib application programming interfacev              files.   d              * Do you wish to install MIT PEXlib (PEX programming interface) files [YES]? N <Return>  ?              Press Return if you wish to install the MIT PEXlibiD              programming interface files. Type NO if you do not want              this support.  (          15. Install the PEX font files.  F              * Do you wish to install PEX Font files [YES]? N <Return>  D              Press Return if you wish to install the PEX font files.5              Type NO if you do not want this support.p  +          16. Install the OpenGL Base files.   G              * Do you wish to install OpenGL Base files [YES]? <Return>   @              Press Return if you wish to install the OpenGL BaseB              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.  V              * Do you wish to install OpenGL Programming Example Files [YES]? <Return>  !     2-10 Installing Compaq Open3D                    I                  Press Return if you wish to install the files containingyH                  OpenGL programming examples. Type NO if you do not want                  this support.  1              18. Read the informational messages.c  E                  At this point, the installation procedure displays aeD                  number of informational messages that report on theC                  progress of the installation; there are no furtherVB                  questions. If the installation procedure has beenE                  successful up to this point, VMSINSTAL moves the newVG                  or modified files to their target directories, updatesmI                  help files, and updates DCL tables, if necessary. If yourH                  requested that files be purged, they are purged at this                  time.  ,                  The messages displayed are:  G                          STARTING to perform all the installation work.dR                          No additional user actions are necessary from this point.  D                          The remaining part of the installation willC                          take 5 - 20 minutes depending on your CPU.o  G                  %VMSINSTAL-I-RESTORE, Restoring product save set N ... G                  %VMSINSTAL-I-RESTORE, Restoring product save set B ...aG                  %VMSINSTAL-I-RESTORE, Restoring product save set C ... G                  %VMSINSTAL-I-RESTORE, Restoring product save set D ...dG                  %VMSINSTAL-I-RESTORE, Restoring product save set E ...oG                  %VMSINSTAL-I-RESTORE, Restoring product save set F ... G                  %VMSINSTAL-I-RESTORE, Restoring product save set G ...sG                  %VMSINSTAL-I-RESTORE, Restoring product save set H ... G                  %VMSINSTAL-I-RESTORE, Restoring product save set I ...fG                  %VMSINSTAL-I-RESTORE, Restoring product save set J ...eG                  %VMSINSTAL-I-RESTORE, Restoring product save set K ...pG                  %VMSINSTAL-I-RESTORE, Restoring product save set L ... G                  %VMSINSTAL-I-RESTORE, Restoring product save set M ...                              .                              .E                             .   D                      Installation of OPEN3DB V4.9 completed at hh:mm  O                      Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY   Y                      Creating installation data file: VMI$ROOT:[SYSUPD]OPEN3D49B.VMI_DATAt  I                                             Installing Compaq Open3D 2-11  4  [              6                      VMSINSTAL procedure done at hh:mm  @              The installation procedure is complete. You can nowC              install additional products or log out. If you removed B              any media from the console drive before beginning the5              installation, you should replace it now.p  /          19. Log out of the privileged account.a                $ LOGOUT <Return>=              SYSTEM     logged out at dd-mmm-yyyy hh:mm:ss.ssO  @              VMSINSTAL deletes or changes entries in the processE              symbol tables during the installation. Therefore, if youIE              are going to continue using the system manager's accounteB              and you want to restore these symbols, you should log"              out and log in again.                                                        !     2-12 Installing Compaq Open3Du h  n                    I                                                                         3 I         _________________________________________________________________   I                                            After Installing Compaq Open3Ds    A               After installing Compaq Open3D, you must reboot thetG               system. You can then tune your system for running complexmD               applications and report any problems discovered during               installation.m           3.1 System Tuningp  E               The DECwindows server for Compaq Open3D applications is B               very demanding on system resources and requires someB               specific tuning. The following sections describe howC               to modify various system parameters to ensure optimal E               server performance. For additional information on these =               parameters, refer to the OpenVMS documentation.o  )         3.1.1 Minimum System Requirementss  G               System tuning is a two-step process: you must modify bothoE               SYSTEM account quota values and the server quota valuestH               to improve performance. Table 3-1 shows the minimum SYSTEMF               account quota values for a three-dimensional acceleratedH               system with at least 33 megabytes (MB) of physical memory,2               running complex client applications.  I               Table_3-1_Minimum_Recommended_Quotas_for_System_Tuning_____t  I               Parameter__________________Quota___________________________   ,               FILLM                      400  -               ENQLM                      1024K  .               WSDEF                      10240  .               WSQUO                      16384  .               WSEXTENT                   20480  I                                                  (continued on next page)   I                                        After Installing Compaq Open3D 3-1n g  M              A           Table 3-1 (Cont.) Minimum Recommended Quotas for SystemnE           __________________Tuning___________________________________m  E           Parameter__________________Quota___________________________o  E           PGFLQUO____________________370000__________________________   A           To set the SYSTEM account quotas to the values shown in 7           Table 3-1, you can use the AUTHORIZE utility.o  3           In addition to the SYSTEM account quotas, .           you must modify the server quotas inB           [SYSMGR]DECW$PRIVATE_SERVER_SETUP.COM. If this file does?           not exist, copy DECW$PRIVATE_SERVER_SETUP.TEMPLATE to B           DECW$PRIVATE_SERVER_SETUP.COM. Then define the following           values in this file:  B              $ DEF/NOLOG/PROC DECW$SERVER_FILE_LIMIT           400B              $ DEF/NOLOG/PROC DECW$SERVER_ENQUEUE_LIMIT       1024B              $ DEF/NOLOG/PROC DECW$SERVER_WSDEF              10240B              $ DEF/NOLOG/PROC DECW$SERVER_WSQUOTA            16384B              $ DEF/NOLOG/PROC DECW$SERVER_WSEXTENT           20480B              $ DEF/NOLOG/PROC DECW$SERVER_PAGE_FILE         370000  C              ________________________ Note ________________________   C              You must define quotas for both the SYSTEM account andm=              the server, and these values should be the same.e  C              ______________________________________________________d  4     3.1.2 System Requirements for Large Applications  B           If you are using a demanding application-for example, anE           application with lengthy animation sequences, large models,eC           or large assemblies-you should set the working set quotas D           of the SYSTEM account to the values shown in Table 3-2 for           better performance.m              &     3-2 After Installing Compaq Open3D d  i              I               Table_3-2_Recommended_Quotas_for_Demanding_Applications____e  I               Parameter__________________Quota___________________________   .               WSDEF                      10240  .               WSQUO                      20480  I               WSEXTENT___________________32768___________________________   G               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  I               If the quotas shown in the preceding sections do not resultiE               in the desired performance, you may need to define evenhC               larger values. To determine if this is necessary, you C               should monitor the server process during the heaviest D               display usage to see if its working set use approaches3               the maximum WSEXTENT parameter value.u  D               When monitoring the process, you should pay particular)               attention to the following:   ,               o  Maximum size of working set  E                  The maximum size of the process working set, defined B                  by the WSMAX parameter, must at least be equal toE                  the largest WSEXTENT value set for your accounts. If D                  this is not the case, add the following line to the/                  SYS$SYSTEM:MODPARAMS.DAT file:-  "                  MIN_WSMAX = 32768              I                                        After Installing Compaq Open3D 3-3s o  o                         o  Page file  :              You should increase the size of the page fileA              (DECW$SERVER_PAGE_FILE parameter) to accommodate the]E              page file quotas of both the server and the clients. ThelD              page file quota for the server is defined by the SYSTEM%              account page file quota.i             o  Virtual page counts  B              Refer to Section 1.5.5 for information on determining2              and modifying the virtual page count.  B           You should only set large parameter values if necessary,=           because if values are too large, performance may benB           degraded. After you redefine the parameters, run AUTOGENC           and reboot the system for the new values to be taken intom           account.  B           If after initial tuning and considerable use, the serverA           is failing or is unnecessarily unresponsive, the server C           may be out of memory or the memory may be fragmented. ForeE           example, you may find a message similar to the following inLC           the server error log SYS$MANAGER:DECW$SERVER_0_ERROR.LOG:R             "xxx:  Out of memory"   A           In such a case, you should perform the following steps:   D           1. Increase the server's page file quota by modifying bothD              the system quota (PGFLQUO) and the server quota (in the1              file DECW$PRIVATE_SERVER_SETUP.COM).   D           2. Increase the virtual page count (MIN_VIRTUALPAGECNT) in$              the MODPARAMS.DAT file.  =           3. Run AUTOGEN to take into account the new values.e  D           If these steps do not resolve the problem, then you should"           submit a problem report.  *     3.2 Determining and Reporting Problems  C           If you encounter a problem while using Compaq Open3D, you D           should report it to Compaq. Depending on the nature of theD           problem and the type of support you have, you can take one#           of the following actions:t  >           o  Call Compaq if your software contract or warranty9              agreement entitles you to telephone support.   &     3-4 After Installing Compaq Open3D o  r              8               o  Submit a Software Problem Report (SPR).  H               Review the Software Product Description (SPD) and WarrantyI               Addendum for an explanation of warranty. If you encounter a G               problem during the warranty period, report the problem asrI               described in this section, or follow alternate instructionseA               provided by Compaq for reporting SPD nonconformancee               problems.p                                                                          I                                        After Installing Compaq Open3D 3-5e r                       I                                                                         AeI         _________________________________________________________________o  I                                            Files Installed on Your Systeme    C               The Compaq Open3D installation procedure installs the =               directories and file names listed in Table A-1.-  I               Table_A-1_Installed_Files__________________________________n  I               Directory__________File_Name_______________________________i  I               Save_Set_A-Release_Notes___________________________________u                 SYS$HELP  9                                  OPEN3DB049.RELEASE_NOTESi  <                                  OPEN3DB049_RELEASE_NOTES.PS  I               ___________________________________________________________ I               Save_Set_N-Driver_Files_Required_for_all_Devices___________                  SYS$LOADABLE_                IMAGES  2                                  SYS$GUBDRIVER.EXE  2                                  SYS$GYCDRIVER.EXE  I                                                  (continued on next page)                     I                                        Files Installed on Your System A-1t c  ,              E           Table_A-1_(Cont.)_Installed_Files__________________________e  E           ___________________________________________________________.  E           Save_Set_B-Files_Required_for_All_Devices__________________c             SYS$LIBRARYs  8                              DECW$GRAPHICS_ICBM_0302.EXE  8                              DECW$GRAPHICS_ICBM_0402.EXE  8                              DECW$GRAPHICS_ICBM_0702.EXE             SYS$MANAGERP  1                              DECW$MWM_OVERLAY.COM   2                              SYCONFIG_ADDITION.COM  0                              SYCONFIG_OPEN3D.COM             SYS$SYSTEM  1                              DECW$MWM_OVERLAY.EXE   *           SYS$SYSROOT:[VUE$LIBRARY.SYSTEM]  0                              VUE$MWM_OVERLAY.COM  (           SYS$SYSROOT:[VUE$LIBRARY.USER]  6                              DECW$MWM_OVERLAYS.VUE$DAT  E           ___________________________________________________________SE           Save_Set_C-Files_Required_by_All_Servers___________________u             SYS$LIBRARYI  6                              DECW$SERVER_DEC_3DLIB.EXE  5                              DECW$SVEXT_DECSTEREO.EXEo  /                              DECW$SVEXT_GLX.EXE   ;                              DECW$SVEXT_MULTI_BUFFERING.EXE1  3                              DECW$SVEXT_X3D_PEX.EXEl  7                              DECW$SVEXT_X3D_PEX_GRM.EXEe             SYS$MANAGER   2                              DECW$XSERVER_O3D.CONF  E                                              (continued on next page)s  &     A-2 Files Installed on Your System                   I               Table_A-1_(Cont.)_Installed_Files__________________________o  I               ___________________________________________________________E  I               Save_Set_D_ZLX-M_Files_____________________________________                  SYS$LIBRARYC  7                                  DECW$SERVER_DDX_GV.EXE                  SYS$MANAGER   :                                  DECW$DEVICE_CONFIG_GV.COM                 SYS$SYSTEM  5                                  DECW$SERVER_PVRM.EXEn  I               ___________________________________________________________ I               Save_Set_E_PowerStorm_3D30/4D20,_ZLX-E,_and_ZLXp-E_Files___o                 SYS$LIBRARYe  7                                  DECW$SERVER_DDX_GY.EXE   ;                                  DECW$SERVER_DDX_GY_WMB.EXEh                 SYS$MANAGERE  :                                  DECW$DEVICE_CONFIG_GY.COM  I               ___________________________________________________________tI               Save_Set_F-ZLX-L_and_ZLXp-L_Files__________________________                  SYS$LIBRARYi  7                                  DECW$SERVER_DDX_GU.EXEs  8                                  DECW$SERVER_DDX_GUB.EXE                 SYS$MANAGERi  :                                  DECW$DEVICE_CONFIG_GU.COM                 SYS$SYSTEM  5                                  DECW$SERVER_PVRM.EXEl  6                                  DECW$SERVER_GUBRM.EXE  I                                                  (continued on next page)   I                                        Files Installed on Your System A-3t f  s              E           Table_A-1_(Cont.)_Installed_Files__________________________t  E           ___________________________________________________________a  E           Save_Set_G-PCM_and_IDL_Files_(Button_and_Dial_Box_Support)_e             SYS$LIBRARY   $                              C_IDL.H  +                              PCM$LIBSHR.EXEt             SYS$SYSTEM  +                              PCM$SERVER.EXEt             SYS$MANAGER   .                              PCM$CUSTOM_SS.DAT  0                              PCM$STANDARD_SS.DAT  #           SYS$SYSROOT:[SYS$STARTUP]i  ,                              PCM$STARTUP.COM  +           SYS$SYSROOT:[SYSHLP.EXAMPLES.PCM]   '                              XPCMTEST.Ct  )                              XPCMTEST.EXE.  )                              XPCMTEST.OPTr  /                              XPCMTEST_BUILD.COMa  /                              XPCMTEST_BUILD.MMS   E           ___________________________________________________________ E           Save_Set_H-X_Multibuffering_and_Stereo_Extension_Support___   /           SYS$SYSROOT:[DECW$INCLUDE.EXTENSIONS]U  (                              DECSTEREO.H  +                              DECSTEREOSTR.H              SYS$LIBRARY,  2                              DECW$STEREOLIBSHR.EXE  &                              EXTUTIL.H  '                              MULTIBUF.H-  )                              MULTIBUFST.H   #                              XEXT.Hs  E                                              (continued on next page)s  &     A-4 Files Installed on Your System    %              I               Table_A-1_(Cont.)_Installed_Files__________________________T  I               Directory__________File_Name_______________________________,  I               Save_Set_I-DEC_PEXlib_Files________________________________s                 SYS$LIBRARYe  3                                  DECW$PEXLIBSHR.EXEu  ;                                  DECW$PEXLIBSHR_D_FLOAT.EXEo  ;                                  DECW$PEXLIBSHR_G_FLOAT.EXET  +                                  FLOATDEF.H   '                                  MPEX.H   *                                  MPEXLIB.H  )                                  MPEXOC.HV  ,                                  MPEXPROTO.H  /                                  MPEXPROTOSTR.HI  &                                  PEX.H  )                                  PEXLIB.H4  /                                  PEXLIBPROTOS.H   ,                                  PEXMACROS.H  (                                  PEXOC.H  +                                  PEXOCBUF.Hs  +                                  PEXPROTO.H   -                                  PEXPROTOST.H.                 SYS$TEST  -                                  PST_CUBE.COMn  -                                  PST_CUBE.EXEe  I               ___________________________________________________________ I               Save_Set_J-MIT_PEXlib_Files________________________________h                 SYS$LIBRARYS  6                                  DECW$MITPEXLIBSHR.EXE  -               SYS$SYSROOT:[DECW$INCLUDE.PEX5]f  &                                  PEX.H  )                                  PEXLIB.H   I                                                  (continued on next page)   I                                        Files Installed on Your System A-5     -              E           Table_A-1_(Cont.)_Installed_Files__________________________   E           Directory__________File_Name________________________________  E           Save_Set_J-MIT_PEXlib_Files________________________________   (                              PEXLIBINT.H  '                              PEXPROTO.Hg  )                              PEXPROTOST.H   ,                              PL_GLOBAL_DEF.H  )                              PL_OC_UTIL.Ha  &                              PL_UTIL.H  E           ___________________________________________________________ E           Save_Set_K-PEX_Font_Files__________________________________   (           SYS$SYSROOT:[SYSFONT.DECW.PEX]  .                              FONT_JISX0201.FNT  .                              FONT_JISX0208.FNT  2                              VAXGFX$FONT_NEG01.FNT  2                              VAXGFX$FONT_NEG02.FNT  2                              VAXGFX$FONT_NEG03.FNT  2                              VAXGFX$FONT_NEG04.FNT  2                              VAXGFX$FONT_NEG05.FNT  2                              VAXGFX$FONT_NEG06.FNT  2                              VAXGFX$FONT_NEG07.FNT  2                              VAXGFX$FONT_NEG08.FNT  2                              VAXGFX$FONT_NEG09.FNT  2                              VAXGFX$FONT_NEG10.FNT  5                              VAXGFX$FONT_NEG10001.FNT,  2                              VAXGFX$FONT_NEG11.FNT  2                              VAXGFX$FONT_NEG12.FNT  2                              VAXGFX$FONT_NEG13.FNT  2                              VAXGFX$FONT_NEG14.FNT  2                              VAXGFX$FONT_NEG15.FNT  2                              VAXGFX$FONT_NEG16.FNT  E                                              (continued on next page)   &     A-6 Files Installed on Your System                   I               Table_A-1_(Cont.)_Installed_Files__________________________   I               Directory__________File_Name_______________________________g  I               Save_Set_K-PEX_Font_Files__________________________________r  6                                  VAXGFX$FONT_NEG17.FNT  6                                  VAXGFX$FONT_NEG18.FNT  6                                  VAXGFX$FONT_NEG19.FNT  6                                  VAXGFX$FONT_NEG20.FNT  6                                  VAXGFX$FONT_NEG21.FNT  6                                  VAXGFX$FONT_NEG22.FNT  6                                  VAXGFX$FONT_NEG23.FNT  6                                  VAXGFX$FONT_NEG24.FNT  I               ___________________________________________________________oI               Save_Set_L-OpenGL_Base_Files_______________________________E                 SYS$LIBRARYe  3                                  DECW$OPENGLSHR.EXE   4                                  DECW$OPENGLUSHR.EXE  9                                  DECW$OPENGLWIDGETSHR.EXE   9                                  DECW$OPENGL_PROTOCOL.EXE   %                                  GL.HG  &                                  GLU.H  +                                  GLWDRAWA.HX  ,                                  GLWMDRAWA.H  &                                  GLX.H  .                                  GLXDECPROTO.H  )                                  GLXINT.H   (                                  GLXMD.H  +                                  GLXPROTO.Hh  I                                                  (continued on next page)_  I                                        Files Installed on Your System A-7     y              E           Table_A-1_(Cont.)_Installed_Files__________________________t  E           Directory__________File_Name_______________________________   E           Save_Set_L-OpenGL_Base_Files_______________________________e             SYS$SYSTEM  (                              XGLINFO.EXE             SYS$TEST  '                              GL_IVP.COM   '                              GL_IVP.EXEu  E           ____________________________________________________________E           Save_Set_M-OpenGL_Programming_Example_Files________________   3           SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.EXAMPLES]   )                              *.C 70 FILES_  %                              JITTER.H_  -                              VMS_EXAMPLES.COMn  -                              VMS_EXAMPLES.MMSP  0                              VMS_EXAMPLES.README  2                              VMS_LINK_EXAMPLES.OPT  .           SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.IVP]  %                              GL_IVP.CR  (                              VMS_IVP.COM  (                              VMS_IVP.MMS  -                              VMS_LINK_IVP.OPTi  1           SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.LIBAUX]e  !                              3D.Hg  "                              AUX.C  "                              AUX.H  '                              LIBAUX.OLB   %                              SHAPES.Ct  %                              TEAPOT.C   %                              TEAPOT.H   %                              VECT3D.Cs  E                                              (continued on next page)   &     A-8 Files Installed on Your System t                 I               Table_A-1_(Cont.)_Installed_Files__________________________b  I               Directory__________File_Name_______________________________t  I               Save_Set_M-OpenGL_Programming_Example_Files________________c  /                                  VMS_LIBAUX.COM   /                                  VMS_LIBAUX.MMS   2                                  VMS_LIBAUX.README  (                                  XFORM.C  6               SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.LIBFONT]  '                                  FONT.C   '                                  FONT.H_  ,                                  LIBFONT.OLB  0                                  VMS_LIBFONT.COM  0                                  VMS_LIBFONT.MMS  5               SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.LIBRGB]   +                                  LIBRGB.OLBs  &                                  RGB.C  &                                  RGB.H  /                                  VMS_LIBRGB.COM   /                                  VMS_LIBRGB.MMSs  4               SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.LIBTK]  )                                  CURSOR.Ce  (                                  EVENT.C  )                                  GETSET.C   *                                  LIBTK.OLB  *                                  PRIVATE.H  )                                  SHAPES.Cc  %                                  TK.H   .                                  VMS_LIBTK.COM  .                                  VMS_LIBTK.MMS  1                                  VMS_LIBTK.READMEv  )                                  WINDOW.CL  I                                                  (continued on next page)u  I                                        Files Installed on Your System A-9i q  a              E           Table_A-1_(Cont.)_Installed_Files__________________________t  E           Directory__________File_Name_______________________________c  E           Save_Set_M-OpenGL_Programming_Example_Files________________D  2           SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.SAMPLES]  "                              1.RGB  "                              2.RGB  "                              3.RGB  "                              4.RGB  )                              *.C 30 Filesf  1                              VMS_LINK_SAMPLES.OPTo  ,                              VMS_SAMPLES.COM  ,                              VMS_SAMPLES.MMS  /                              VMS_SAMPLES.README   4                              VMS_SYMBOLS_SAMPLES.COM  2           SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.VISINFO]  &                              FINDVIS.C  &                              VISINFO.C  &                              VISINFO.H  +                              VMS_README.TXT   ,                              VMS_VISINFO.COM  ,                              VMS_VISINFO.MMS  ,                              VMS_VISINFO.OPT  2           SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.WIDGETS]  %                              DOUBLE.Ce  %                              SIMPLE.Ca  1                              VMS_LINK_WIDGETS.OPTr  ,                              VMS_WIDGETS.COM  ,                              VMS_WIDGETS.MMS  E                                              (continued on next page)   '     A-10 Files Installed on Your System                    I               Table_A-1_(Cont.)_Installed_Files__________________________   I               Directory__________File_Name_______________________________   I               Save_Set_M-OpenGL_Programming_Example_Files________________   3                                  VMS_WIDGETS.READMEe  6               SYS$SYSROOT:[SYSHLP.EXAMPLES.GL.XGLINFO]  )                                  GLOBAL.H-  3                                  STRINGCONVERSION.C   0                                  VMS_XGLINFO.COM  0                                  VMS_XGLINFO.MMS  0                                  VMS_XGLINFO.OPT  I               ___________________XGLINFO.C________________________________                                                I                                       Files Installed on Your System A-11_ _  _                    I                                                                         B I         _________________________________________________________________   I                                                       Sample InstallationR    D               This appendix contains a sample installation of CompaqE               Open3D. The sample installation assumes that DECnet haslG               been shut down and no users are logged on to your system.-      K                Welcome to OpenVMS (TM) Alpha Operating System, Version V7.3_                 Username: system               Password:eZ                  Welcome to OpenVMS (TM) Alpha Operating System, Version V7.3 on node GULPN                   Last interactive login on Wednesday, 18-APR-2001 18:54:55.22R                   Last non-interactive login on Wednesday, 18-APR-2001 18:42:33.66%               $ @SYS$UPDATE:VMSINSTAL   N                       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.   L               * Are you satisfied with the backup of your system disk [YES]?K               * Where will the distribution volumes be mounted: SYS$UPDATE:O  X               Enter the products to be processed from the first distribution volume set.!               * Products: OPEN3DB_B               * Enter installation options you wish to use (none):  7               The following products will be processed:                    OPEN3DB V4.9  E                       Beginning installation of OPEN3DB V4.9 at 18:56.  D               %VMSINSTAL-I-RESTORE, Restoring product save set A ...Y               %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP._  Q               * Do you want to purge files replaced by this installation [YES]? N   I                                                   Sample Installation B-1                    &                   Product:      OPEN3D#                   Producer:     DECy$                   Version:      4.9B+                   Release Date: 05-JUN-2001_  P           * Does this product have an authorization key registered and loaded? Y  S           * Do you wish to install PowerStorm 3D30 and PowerStorm 4D20 files [YES]?_  C           * Do you wish to install ZLXp-L1 and ZLXp-L2 files [YES]?C  Z           * Do you wish to install PCM and IDL files (Button and Dial Box Support) files [           YES]?M  U           * Do you wish to install X multibuffering and Stereo extension files [YES]?   V           * Do you wish to install DEC PEXlib (PEX programming interface) files [YES]?  V           * Do you wish to install MIT PEXlib (PEX programming interface) files [YES]?  8           * Do you wish to install PEX Font files [YES]?  ;           * Do you wish to install OpenGL Base files [YES]?h  J           * Do you wish to install OpenGL Programming Example Files [YES]?  @                   STARTING to perform all the installation work.K                   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 ...  N                 This installation appends to the file SYS$MANAGER:SYCONFIG.COM                 the following:  5                    $ @SYS$MANAGER:SYCONFIG_OPEN3D.COM        B-2 Sample InstallationP S  T              M                     Note: You MUST reboot your system to use the new drivers.S  Z                     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._  W                    This kit has supplied a window manager capable of supporting overlay U                    planes on the ZLXp-L1, ZLXp-L2 and PowerStorm 4D20. Please see theOO                    release notes for further information on the window manager.   ^               %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.PCM]               .E  V                   If you intend to execute this layered product on other nodes in yourR                   cluster, and you have the appropriate software license, you mustU                   prepare the system-specific roots on the other nodes by issuing theiW                   following command on each node (using a suitably privileged account):l  L                       $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.PCM]S                     If you have a button or dial box connected to your workstation,_F                     you must edit the file SYS$STARTUP:PCM$STARTUP.COMM                     to insert the correct name for the PCM serial port and/orCN                     the Spaceball serial port.  You also need to edit the fileY                     SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM to insert the following line:   5                        $ @SYS$STARTUP:PCM$STARTUP.COM   W                     If the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM does not exist, R                     you can create the file following the instructions in the file@                     SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE  N                     PCM demo programs, along with their sources will be put in(                     SYS$EXAMPLES:[.PCM].  Q                     The IVP for DEC PEXLIB will be copied to SYS$TEST.  After the R                     kitinstall completes and the system has been rebooted, you mayA                     run the IVP by issuing the following command:   +                        $ @SYS$TEST:PST_CUBE   ]               %VMSINSTAL-I-SYSDIR, This product creates system directory [DECW$INCLUDE.PEX5].J  V                   If you intend to execute this layered product on other nodes in yourR                   cluster, and you have the appropriate software license, you mustU                   prepare the system-specific roots on the other nodes by issuing the W                   following command on each node (using a suitably privileged account):e  J                       $ CREATE /DIRECTORY SYS$SPECIFIC:[DECW$INCLUDE.PEX5]\               %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSFONT.DECW.PEX].  I                                                   Sample Installation B-3                    R               If you intend to execute this layered product on other nodes in yourN               cluster, and you have the appropriate software license, you mustQ               prepare the system-specific roots on the other nodes by issuing the S               following command on each node (using a suitably privileged account):   E                   $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSFONT.DECW.PEX]a  I                 The IVP for OpenGL will be copied to SYS$TEST.  After theYN                 kitinstall completes and the system has been rebooted, you may=                 run the IVP by issuing the following command:   %                    $ @SYS$TEST:GL_IVP   Z           %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL].  R               If you intend to execute this layered product on other nodes in yourN               cluster, and you have the appropriate software license, you mustQ               prepare the system-specific roots on the other nodes by issuing the S               following command on each node (using a suitably privileged account):   G                   $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL] Z           %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.E           XAMPLES].   R               If you intend to execute this layered product on other nodes in yourN               cluster, and you have the appropriate software license, you mustQ               prepare the system-specific roots on the other nodes by issuing the S               following command on each node (using a suitably privileged account):t  P                   $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.EXAMPLES]Z           %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.L           IBAUX].g  R               If you intend to execute this layered product on other nodes in yourN               cluster, and you have the appropriate software license, you mustQ               prepare the system-specific roots on the other nodes by issuing theFS               following command on each node (using a suitably privileged account):   N                   $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.LIBAUX]Z           %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.L           IBTK].  R               If you intend to execute this layered product on other nodes in yourN               cluster, and you have the appropriate software license, you mustQ               prepare the system-specific roots on the other nodes by issuing the.S               following command on each node (using a suitably privileged account):        B-4 Sample Installation.                   Q                       $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.LIBTK].^               %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.S               AMPLES].  V                   If you intend to execute this layered product on other nodes in yourR                   cluster, and you have the appropriate software license, you mustU                   prepare the system-specific roots on the other nodes by issuing the W                   following command on each node (using a suitably privileged account):   S                       $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.SAMPLES] ^               %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.W               IDGETS].  V                   If you intend to execute this layered product on other nodes in yourR                   cluster, and you have the appropriate software license, you mustU                   prepare the system-specific roots on the other nodes by issuing the.W                   following command on each node (using a suitably privileged account):   S                       $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.WIDGETS]S^               %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.I               VP].  V                   If you intend to execute this layered product on other nodes in yourR                   cluster, and you have the appropriate software license, you mustU                   prepare the system-specific roots on the other nodes by issuing the W                   following command on each node (using a suitably privileged account):   O                       $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.IVP]i^               %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.L               IBFONT].  V                   If you intend to execute this layered product on other nodes in yourR                   cluster, and you have the appropriate software license, you mustU                   prepare the system-specific roots on the other nodes by issuing the W                   following command on each node (using a suitably privileged account):   S                       $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.LIBFONT]e^               %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.L               IBRGB].   V                   If you intend to execute this layered product on other nodes in yourR                   cluster, and you have the appropriate software license, you mustU                   prepare the system-specific roots on the other nodes by issuing the W                   following command on each node (using a suitably privileged account):   R                       $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.LIBRGB]^               %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.V               ISINFO].  I                                                   Sample Installation B-5                    R               If you intend to execute this layered product on other nodes in yourN               cluster, and you have the appropriate software license, you mustQ               prepare the system-specific roots on the other nodes by issuing theMS               following command on each node (using a suitably privileged account):   O                   $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.VISINFO] Z           %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.GL.X           GLINFO].  R               If you intend to execute this layered product on other nodes in yourN               cluster, and you have the appropriate software license, you mustQ               prepare the system-specific roots on the other nodes by issuing the S               following command on each node (using a suitably privileged account):   O                   $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GL.XGLINFO] X           %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  A                   Installation of OPEN3DB V4.9 completed at 19:00   H               Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  S               Creating installation data file: VMI$ROOT:[SYSUPD]OPEN3DB049.VMI_DATA   S           Enter the products to be processed from the next distribution volume set.            * Products:   3                   VMSINSTAL procedure done at 19:01                                          B-6 Sample Installation 