DIGITAL_Open3D______________________________________ Installation Guide for DIGITAL UNIX Systems Order Number: AA-QZBZK-TE September 1998 This document contains instructions for installing DIGITAL Open3D[TM] on the DIGITAL UNIX[R] operating system. It also explains how to read the online release notes before or after installing the product. This document applies to DIGITAL Open3D Version 4.9. Revision/Update Information: This revised manual supersedes the information in the Installation Guide for DIGITAL UNIX Systems (Order No. AA-QZBZJ-TE.) Operating System and Version: DIGITAL UNIX Version 4.0d Software Version: DIGITAL Open3D Version 4.9 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ First Printing, April 1993 Revised: October 1993 Revised: February, June, August, December 1994 Revised: March, June, August, September, December 1995 Revised: March, June, September, December 1996 Revised: March, June, September, December 1997 Revised: March, June, September 1998 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. © Digital Equipment Corporation 1993, 1994, 1995, 1996, 1997, 1998. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DEC, DEC Open3D, DEC 3000, DECwindows, DIGITAL, DIGITAL Open3D, PowerStorm, and the DIGITAL logo. The following are third-party trademarks: OpenGL is a registered trademark of Silicon Graphics, Inc. PostScript is a registered trademark of Adobe Systems, Incorporated. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. ZK6281 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install DIGITAL Open3D 1.1 Reading the Online Release Notes.............. 1-1 1.2 Registering a License......................... 1-2 1.3 Checking the Media Distribution Kit........... 1-3 1.4 Verifying the Hardware Requirements........... 1-3 1.5 Verifying the Software Requirements........... 1-3 1.6 Required User Privileges...................... 1-4 1.7 Determining the Available and Used Disk Space......................................... 1-4 1.8 Backing Up Your System Disk................... 1-7 1.9 Error Recovery................................ 1-7 1.10 Determining and Reporting Problems............ 1-8 2 Installing DIGITAL Open3D 2.1 Loading the Software.......................... 2-1 2.2 Completing the Installation................... 2-5 2.2.1 DIGITAL Open3D Extensions Clause.......... 2-6 2.2.2 DECStereo Extension Load.................. 2-7 2.2.3 PCM Server and Library.................... 2-8 3 After Installing DIGITAL Open3D 3.1 Configuration Recommendations................. 3-1 3.2 Tuning Techniques............................. 3-2 iii A Files Installed on Your System B Sample Installation Tables 1 Conventions Used in this Guide............ vi 1-1 Subset Sizes (in KB)...................... 1-5 A-1 Installed Files for the DIGITAL Open3D Kit....................................... A-1 iv _________________________________________________________________ Preface This guide describes how to install DIGITAL Open3D Version 4.9 on Alpha processors running the DIGITAL UNIX operating system. In addition to this guide, you should read the Read Before Installing or Using DIGITAL Open3D for DIGITAL UNIX Systems letter. This letter provides information that is required for DIGITAL Open3D installation and may not be included either in this installation guide or in the release notes. Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall DIGITAL Open3D for any other reason. Intended Audience This guide is for system managers who install DIGITAL Open3D software on DIGITAL UNIX systems. Structure of this Document This manual is organized as follows: o Chapter 1 describes the preparations and requirements necessary for installing DIGITAL Open3D. o Chapter 2 describes the installation procedure for local installations. o Chapter 3 provides configuration and tuning information. o Appendix A lists the files installed with DIGITAL Open3D. o Appendix B contains a listing of a sample installation of the DIGITAL Open3D kit. v Related Manuals For information related to this manual, see the following DIGITAL UNIX manuals: o Installation Guide o Software License Management o Release Notes o Firmware Release Notes Manuals in the DIGITAL Open3D Documentation Set In addition to this manual, the DIGITAL Open3D documentation set includes the following manuals: o DEC Open3D IDL User Guide o DEC Open3D PEXlib C Binding Reference Manual o Using OpenGL Conventions Table 1 lists the conventions used in this guide: Table_1_Conventions_Used_in_this_Guide_____________________ Convention_______Meaning___________________________________ UPPERCASE and The DIGITAL UNIX system differentiates lowercase between lowercase and uppercase characters. Literal strings that appear in text, examples, syntax descriptions, and function descriptions must be typed exactly as shown. bold Boldface text is used in interactive examples to indicate typed user input. italic Italic text is used to indicate software function terms and commands, library names, file names, directory path names, and manual names. (continued on next page) vi Table_1_(Cont.)_Conventions_Used_in_this_Guide_____________ Convention_______Meaning___________________________________ system output This typeface is used in interactive and code examples to indicate system output. In text, this typeface is used to indicate the exact name of a command, option, partition, path name, directory, or file. % The default user prompt is your system name followed by a right angle bracket (>). In this manual, a percent sign (%) is used to represent this prompt. # A number sign is the default superuser prompt. In procedures, a sequence such as indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. In procedures, a key name is shown enclosed to indicate that you press a key on the keyboard. Vertical ellipsis in an example means that . some information has been omitted. . . DIGITAL Open3D References to DIGITAL Open3D refer to the DIGITAL Open3D (formerly DEC Open3D) _________________product.__________________________________ vii 1 _________________________________________________________________ Preparing to Install DIGITAL Open3D To make your installation run smoothly, you should complete the preparations outlined in this chapter before starting the installation procedure. This chapter will help you determine the following: o How to read the online release notes o How to register a software license o If installing DIGITAL Open3D from media, whether your distribution kit includes all the components listed on the Bill of Materials (BOM) o Whether the system on which you will install DIGITAL Open3D meets the DIGITAL Open3D hardware and software requirements o The privileges required to perform the installation o How much disk space you will need o How to back up your system disk o What to do if you find errors o How to report problems 1.1 Reading the Online Release Notes DIGITAL Open3D provides online release notes. DIGITAL strongly recommends that you read the release notes before using the product. The release notes may contain information about changes to the product. You can view or print the DIGITAL Open3D Version 4.9 release notes, the cover letter, and this installation guide at any time from the mounted media CD-ROM. (See Section 2.1 for information on mounting the CD-ROM.) Preparing to Install DIGITAL Open3D 1-1 The files containing these documents are located in the /cdrom/o3d490/documentation directory on the CD-ROM. To read the ASCII or PostScript versions of the release notes on the media CD, use one of the following commands: # more /cdrom/o3d490/documentation/open3d490.release_notes # more /cdrom/o3d490/documentation/open3d490.release_notes.PS To read the ASCII or PostScript versions of the release notes after installation, use one of the following commands: # more /usr/lib/OPEN3D/open3d490.release_notes # more /usr/lib/OPEN3D/open3d490.release_notes.PS 1.2 Registering a License Before you install and run DIGITAL Open3D Version 4.9, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The PAK is a paper certificate that contains information about the license that enables you to use the software. The License PAK is shipped with the kit if you ordered the license and media together; otherwise, the PAK is shipped separately to a location specified on your license order. If you are installing DIGITAL Open3D as an update on a node already licensed for this software, you have already completed the License PAK registration requirements. If you are installing prerequisite or optional software along with DIGITAL Open3D, review the PAK status and install the PAKs for this prerequisite or optional software before you install DIGITAL Open3D. To register a license on a DIGITAL UNIX system: 1. Log in as superuser. 2. At the superuser prompt, edit an empty PAK template with the lmf register command and include all the information on your License PAK as follows: # /usr/sbin/lmf register 1-2 Preparing to Install DIGITAL Open3D 3. After you register your license, use the following lmf reset command to copy the license details from the License Database (LDB) to the kernel cache: # /usr/sbin/lmf reset For complete information on using the DIGITAL UNIX License Management Facility, see the Software License Management guide or the lmf(8) reference page. 1.3 Checking the Media Distribution Kit For installations from media, use the Bill of Materials (BOM) to check the contents of your software distribution kit. If your kit is damaged or incomplete, call your DIGITAL representative. For more information on how to mount distribution media, see your processor-specific installation/operations guide, which also details several options for the installation procedure. 1.4 Verifying the Hardware Requirements You need the following hardware to install DIGITAL Open3D: o CD-ROM drive See the documentation for the CD-ROM drive you are using for information on how to load the media. o Terminal You can use either a hard copy or video terminal to perform the installation. o Adequate system disk space Disk space requirements for the DIGITAL Open3D kit are listed in Table 1-1. Refer to the DIGITAL Open3D Software Product Description (SPD) for additional hardware requirements. 1.5 Verifying the Software Requirements Before installing DIGITAL Open3D Version 4.9, you must install: DIGITAL UNIX operating system Version 4.0d Preparing to Install DIGITAL Open3D 1-3 DIGITAL also recommends that you install the following DIGITAL UNIX software Japanese subsets: o OSFFONT* - DECwindows[TM] 75 dpi fonts o OSFFONT15* - DECwindows 100 dpi fonts To install DIGITAL Open3D in a local environment, perform the following steps to determine which DIGITAL UNIX subsets are loaded: 1. Log in to the system where you plan to install DIGITAL Open3D. 2. Enter the following command: % /usr/sbin/setld -i 3. Check the displayed rows for the relevant subset names and for any related patch names. The word installed appears in a row after the subset identifier code when a subset is loaded. If the word installed does not appear (the second column in a row is blank), the subset or patch is missing and must be installed before you install DIGITAL Open3D. If you have a previous version of DIGITAL Open3D installed on your system, you must deinstall it before installing DIGITAL Open3D Version 4.9. 1.6 Required User Privileges You must have superuser privileges to install DIGITAL Open3D software. 1.7 Determining the Available and Used Disk Space The DIGITAL Open3D kit is divided into subsets. The size of these subsets determines the disk space you will require for installation. Table 1-1 provides the disk space requirements for the file system /usr/kits. 1-4 Preparing to Install DIGITAL Open3D Table_1-1_Subset_Sizes_(in_KB)___________________________________ Required KB Subset_Contents__________Subset_Name__________/Optional_Required_ DIGITAL Open3D Base O3DDWSBASE490 Required 5184 DIGITAL Open3D Common O3DDWSCOMMON490 Required 8784 DIGITAL Open3D O3DDWSCONFIG490 Required 17 Configuration DIGITAL Open3D MIT PEX O3DDWSMITPEX490 Optional 864 Programming DIGITAL Open3D MIT PEX O3DDWSMITPEXEXAM490 Optional 17 Programming examples DIGITAL Open3D MIT PEX O3DDWSMITPEXMAN490 Optional 1272 Programming man pages DIGITAL Open3D O3DDWSGLBASE490 Optional 2496 OpenGL[R] Base DIGITAL Open3D OpenGL O3DDWSGLEXAM490 Optional 5984 examples DIGITAL Open3D OpenGL O3DDWSGLMAN490 Optional 1032 man pages DIGITAL Open3D PCM O3DDWSPCM490 Optional 400 Server and Library DIGITAL Open3D PEX O3DDWSPEX490 Optional 17 Programming DIGITAL Open3D O3DDWSCMT490 Optional 184 PowerStorm 4D10T DIGITAL Open3D O3DDWSZE3490 Optional 13488 PowerStorm 4D40T/50T/51T/60T DIGITAL Open3D Stereo O3DDWSSTEREO490 Optional 94 Extension DIGITAL Open3D Stereo O3DDWSSTEREOMAN490 Optional 16 Extension man pages DIGITAL Open3D O3DDWSZLXE490 Optional 5488 PowerStorm 3D30 and PowerStorm 4D20 (continued on next page) Preparing to Install DIGITAL Open3D 1-5 Table_1-1_(Cont.)_Subset_Sizes_(in_KB)___________________________ Required KB Subset_Contents__________Subset_Name__________/Optional_Required_ DIGITAL Open3D ZLXp-L O3DDWSZLXL490 Optional 7920 DIGITAL PHIGS Japanese O3DDWSPHRJP490 Optional 1344 Run-Time Files DIGITAL PHIGS Japanese O3DDWSPHRMAN490 Optional 21 Manual Pages DIGITAL PHIGS Run-Time- O3DDWSPHRTO490 Optional 10704 Only Kit Total:___________________________________________________65,326__ ________________________ Note ________________________ The subset sizes listed in Table 1-1 are approximate. See the release notes for the exact subset sizes. ______________________________________________________ Before installing DIGITAL Open3D, you should determine the disk space available and used on the disks on which DIGITAL Open3D will reside, as follows: 1. Log in to the system where you plan to install DIGITAL Open3D. 2. Check which file systems are mounted and their locations by displaying the file /etc/fstab; for example: # more /etc/fstab /dev/rd0a /ufs rw 1 1 /dev/rd0g /usr ufs rw 1 2 /dev/rz8b swap1 ufs sw 0 2 The previous display indicates that /usr (mounted to /dev/rd0g) is the only mount point that affects where DIGITAL Open3D files will reside; the system has only one local disk drive and the /usr/sys/kits and /usr/opt file systems reside in the g partition of the disk on that drive. 3. Determine the total free space for /usr. 1-6 Preparing to Install DIGITAL Open3D Based on the previous display of the /etc/fstab file, which shows that only /usr is a mount point, you would need to verify the free space only in the /usr file system: # df /usr Filesystem Total kbytes kbytes % node kbytes used free used Mounted on /dev/rd0g 122598 54447 55892 49% /usr This display indicates that there are 55892 KB free, where each block is 512 bytes. This free space must accommodate the subset requirements listed in Table 1-1. 4. Using the disk space requirements table, calculate the total size for the subsets you wish to load in each file system. 5. If the disk space available is insufficient, you can increase the space by removing some subsets. 1.8 Backing Up Your System Disk DIGITAL recommends that you back up your system disk before installing any software. Use the backup procedures established at your site. For details on performing a system disk backup, see your operating system documentation. 1.9 Error Recovery If errors occur during the installation, the system displays failure messages. For example, if the installation fails due to insufficient disk space, the installation procedure displays the following message: There is not enough file system space for subset O3DDWSBASE490 DIGITAL Open3D Base V4.9 will not be loaded. If during the installation you encounter errors from the setld utility, see the Diagnostics section of the setld (8) reference page for an explanation of the error and the appropriate action to take. Errors may also occur if any of the following conditions exists: o The operating system version is incorrect. Preparing to Install DIGITAL Open3D 1-7 o The prerequisite software version is incorrect. o The system parameter values for successful installation are insufficient. o A previous version of DIGITAL Open3D is already installed. o The base subset (O3DDWSBASE490) has not been installed and you try to install any other subset. If you are notified that any of these conditions exist, take the appropriate action described in the message. For descriptions of error messages generated by these conditions, see the operating system documentation on system messages, recovery procedures, and operating system software installation. If the IVP fails, look in the /usr/var/adm/fverify file for information that may help you diagnose the problem. 1.10 Determining and Reporting Problems If you encounter a problem while using DIGITAL Open3D, report it to DIGITAL. Depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call DIGITAL if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). Review the Software Product Description (SPD) and Warranty Addendum for an explanation of your warranty. If you encounter a problem during the warranty period, report the problem as described in this section, or follow alternate instructions provided by DIGITAL for reporting SPD nonconformance problems. 1-8 Preparing to Install DIGITAL Open3D 2 _________________________________________________________________ Installing DIGITAL Open3D This chapter describes the DIGITAL Open3D installation procedure and how to recover from installation errors and report problems. For a complete installation listing, refer to Appendix B. The installation takes approximately 5 to 30 minutes, depending on your media and system configuration. Installing DIGITAL Open3D and running the Installation Verification Procedure (IVP) on your target system takes 5 to 30 minutes. You can stop the installation procedure at any time by using ; however, files created up to that point will not be deleted. You must delete these files interactively. Appendix A lists the files and directories created during the installation procedure. 2.1 Loading the Software This section describes the procedure for installing DIGITAL Open3D files from a CD-ROM on the system where you are performing the installation. When DIGITAL Open3D is run, its executable images are mapped into memory on this system. In the following installation procedure description, rz4 is the CD-ROM disk drive and /mnt is the free mount point: 1. Place the CD-ROM media in the appropriate disk drive. 2. Log in as superuser (login name "root") to the system where you are installing DIGITAL Open3D. 3. Ensure that the directory in which you wish to install DIGITAL Open3D does not already contain another DIGITAL Open3D kit. Installing DIGITAL Open3D 2-1 To determine if DIGITAL Open3D kit files are installed in this directory, enter the command: # setld -i | grep O3D If any of these files are installed, you must deinstall them using the setld -d command. For example, to remove the OpenGL example files, you would enter: # setld -d O3DDWSGLEXAM490 4. Mount the media on the free mount point by entering the following command: # mount -dr /dev/rz4c /mnt When you install from CD-ROM, the CD-ROM disk c partition must be mounted on a free mount point. 5. Make sure that you are at the root (/) directory by entering the command: # cd / 6. Start the installation. To start the installation, enter the setld command with the -l (load) function, and specify the path to the subsets on the CD-ROM disk drive mounted on //o3d490/kit. For example, for the mount point /mnt, the command would be: # setld -l /mnt/o3d490/kit 7. Specify the subsets you wish to install. The installation procedure displays the list of subsets available for installation and prompts you to choose the desired subsets. The following subsets are mandatory and will be installed automatically unless you choose to exit without installing any subsets: * Open3D Common V4.9 * Open3D Config V4.9 The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 2-2 Installing DIGITAL Open3D 1) DWS Open3D Base V4.9 2) DWS Open3D MIT PEX Programming V4.9 3) DWS Open3D MIT PEX Programming examples V4.9 4) DWS Open3D MIT PEX Programming man pages V4.9 5) DWS Open3D OpenGL Base V4.9 6) DWS Open3D OpenGL examples V4.9 7) DWS Open3D OpenGL man pages V4.9 8) DWS Open3D PCM Server and Library V4.9 9) DWS Open3D PEX Programming V4.9 10) DWS Open3D PowerStorm 3D30 and PowerStorm 4D20 V4.9 11) DWS Open3D PowerStorm 4D10T V4.9 12) DWS Open3D PowerStorm 4D40T/4D50T/4D51T/4D60T V4.9 13) DWS Open3D Stereo Extension V4.9 14) DWS Open3D Stereo Extension man pages V4.9 15) DWS Open3D ZLXp-L V4.9 16) Digital PHIGS Japanese Run-Time Files V4.9 17) Digital PHIGS Manual Pages V4.9 18) Digital PHIGS Run-Time-Only Kit V4.9 Or you may choose one of the following options: 19) ALL mandatory and all optional subsets 20) MANDATORY subsets only 21) CANCEL selections and redisplay menus 22) EXIT without installing any subsets Enter your choices or press RETURN to display menus. Choices (for example, 1 2 4-6): 1-15 8. Confirm your subset selection. The installation procedure displays the list of subsets you selected. You are installing the following mandatory subsets: Open3D Common V4.9 Open3D Config V4.9 You are installing the following optional subsets: Installing DIGITAL Open3D 2-3 DWS Open3D Base V4.9 DWS Open3D MIT PEX Programming V4.9 DWS Open3D MIT PEX Programming examples V4.9 DWS Open3D MIT PEX Programming man pages V4.9 DWS Open3D OpenGL Base V4.9 DWS Open3D OpenGL examples V4.9 DWS Open3D OpenGL man pages V4.9 DWS Open3D PCM Server and Library V4.9 DWS Open3D PEX Programming V4.9 DWS Open3D PowerStorm 3D30 and PowerStorm 4D20 V4.9 DWS Open3D PowerStorm 4D10T V4.9 DWS Open3D PowerStorm 4D40T/4D50T/4D51T/4D60T V4.9 DWS Open3D Stereo Extension V4.9 DWS Open3D Stereo Extension man pages V4.9 DWS Open3D ZLXp-L V4.9 Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. 16 subset(s) will be installed. Enter Yes if the subsets you wish to install are those listed. Enter No to specify other subsets. 9. Read the informational messages. The installation procedure generates messages as it checks that your system has enough space to install the requested subsets, copies these subsets, and then verifies that they were copied correctly. Loading 1 of 17 subset(s).... Open3D Common V4.9 Copying from /mnt (disk) Verifying Loading 2 of 17 subset(s).... DWS Open3D Base V4.9 Copying from /mnt (disk) Verifying . . . 2-4 Installing DIGITAL Open3D 10.Indicate whether you wish to modify the configuration file. Do you want to edit the configuration file? (y/n) [n]: The configuration file contains a variety of parameters that enable you to define information used by the X Server at startup. See Section 2.2 for details. Enter Yes if you wish to edit the configuration file. Press Return if you do not wish to edit the configuration file. 11.Dismount the CD-ROM disk drive from the mount point. For example, to dismount mount point /mnt, enter the command: # umount /mnt 12.Remove the CD-ROM from the disk drive. The installation is now completed. 2.2 Completing the Installation After loading the software, you can modify the X Server configuration file /usr/lib/X11/Xserver.conf. This file contains certain startup information used by the Xserver. The installation procedure copies Xserver.conf to Xserver.conf.pre.O3D490, and then modifies Xserver.conf. When you deinstall DIGITAL Open3D, the original Xserver.conf is restored. If you modify Xserver.conf after installing DIGITAL Open3D, these modifications will be lost when you deinstall DIGITAL Open3D. To ensure that these changes are not lost, you should modify Xserver.conf while DIGITAL Open3D is not installed on your system. The modifications you can make to the configuration file are described in the following sections. Installing DIGITAL Open3D 2-5 2.2.1 DIGITAL Open3D Extensions Clause The BASE subset installation adds the DIGITAL Open3D extensions clause, which causes the X Server to load the PEX and hardware-accelerated OpenGL extensions. If you do not wish to load certain extensions, modify the Xserver.conf file and remove the appropriate lines. The DIGITAL Open3D extensions clause is: ! ! Open3D Extensions List ! extensions < < _dec_3dlib lib_dec_3dlib.so ThreeDInitProc > < _dec_x3d_pex lib_dec_x3d_pex.so PexExtensionInit > < _dec_opengl lib_dec_opengl.so GLExtensionInit > < extMultibuf libextMultibuf.so MultibufferExtensionInit > < _dec_glXDECpeer lib_dec_glXDECpeer.so InitglXDECExtensionDEC-PEER-GLX > > If you do not include this extension clause in the file Xserver.conf, the server will not load the OpenGL and PEX extensions properly. Using the Software-Only Version of OpenGL By default, the DIGITAL Open3D installation modifies the Xserver.conf file to load the hardware-accelerated OpenGL software. You can, however, use a software-only version. You must load a software-only version of the OpenGL server extension to use OpenGL with the PowerStorm 3D10 devices. ________________________ Note ________________________ The software-only version of OpenGL operates correctly with graphics devices other than PowerStorm 3D10; however, the OpenGL performance is significantly lower than the OpenGL versions that use the graphics hardware directly. Therefore, DIGITAL recommends you use the software-only version only with PowerStorm 3D10 devices. ______________________________________________________ 2-6 Installing DIGITAL Open3D The software-only version of OpenGL cannot be configured to run on PowerStorm 4D40T/50T/51T/60T devices. These devices automatically configure the device-specific OpenGL code within the server. As only one version of this extension can be loaded at a time, you must modify Xserver.conf before running OpenGL. Using the Software-Only Version of OpenGL with PowerStorm 3D10 Devices To use the software-only version of OpenGL with the PowerStorm 3D10, modify Xserver.conf to include the following line in the DIGITAL Open3D extensions clause: < _dec_sampleGL lib_dec_sampleGL.so __glXExtensionInit S3TRIO > Using the Software-Only Version of OpenGL with Preconfigured Devices other than the PowerStorm 3D10 To use the software-only version of OpenGL with devices that already are preconfigured (devices other than PowerStorm 3D10), you need to modify the DIGITAL Open3D extensions clause in the Xserver.conf file to replace lib_ dec_opengl.so with lib_dec_sampleGL.so. For example, for the ZLXp-E1 device, you would make the following changes: 1 Delete the following line from the DIGITAL Open3D extensions clause: < _dec_opengl lib_dec_opengl.so __glXExtensionInit p00041011 > 2 Add the following line to the DIGITAL Open3D extensions clause: < _dec_opengl lib_dec_sampleGL.so __glXExtensionInit p00041011 > 2.2.2 DECStereo Extension Load If you are using a ZLX device, you must load the DECStereo extension at server initialization. To load this extension, add the following line to the extensions clause of the Xserver.conf file for ZLX devices: < _dec_Stereo lib_dec_Stereo.so DECStereoExtensionInit > If you do not include this line in the extensions clause, DECStereo will not work. Installing DIGITAL Open3D 2-7 2.2.3 PCM Server and Library After loading the PCM Server and library set, you must complete the installation by adding a line similar to the following in the /etc/inittab file, where is the name of the serial port to which the PCM is connected: pcms::23:respawn:/usr/bin/pcmserver To start the PCM server without rebooting, use the following command: # /usr/sbin/init 3 To verify that the PCM server is running properly and can communicate with the buttons and dials, make sure the X11 server is running and then run the example program as follows: # /usr/example/PCM/xpcmtest 2-8 Installing DIGITAL Open3D 3 _________________________________________________________________ After Installing DIGITAL Open3D After installing DIGITAL Open3D, you can configure your system to optimize performance, as described in the following sections. 3.1 Configuration Recommendations DIGITAL recommends performing the following configuration operations before you use DIGITAL Open3D: o Partitioning Disks When using a DIGITAL Open3D accelerated system, you should define a minimum of 400 MB pages of swap. For any system, you should divide swap space across two or more disks. No swap partition should be smaller than 100 MB pages. Example 1 A system with two disks could be configured to contain the following: disk1: operating system and swap1 disk2: 3D client application, user data, and swap2 Example 2 A system with three disks could be configured to contain the following: disk1: operating system and swap1 disk2: 3D client application, user data, and swap2 disk3: user model data o Configuring Physical Memory (RAM) After Installing DIGITAL Open3D 3-1 You should configure enough physical memory for the average workload to reduce paging activity to zero. The minimum memory requirements are determined by the size of the data and the application operations (such as detailing, animation, and mesh). On DIGITAL UNIX systems, most three-dimensional graphics applications require an absolute minimum of 64 MB. 3.2 Tuning Techniques When tuning a DIGITAL UNIX system, the most important goals are to minimize paging and use the physical memory as efficiently as possible. If your system has too little physical memory, these goals are extremely difficult to attain. The recommended method for configuring DIGITAL Open3D on DIGITAL UNIX Version 4.0d is to use the /sbin/sysconfig utility. First, you should determine which subsystems are configured: # sysconfig -s You can then display the values set for particular parts of a given subsystem, such as vm or proc, as shown: # sysconfig -q subsystem_name In this command, the value of "subsystem_name" is "vm" or "proc". The /etc/sysconfigtab configuration file is read during bootup, and sets the values appropriately. When using CAD/CAM/CAE or similar three-dimensional graphics applications on DIGITAL UNIX, one step that frequently helps improve performance is to add the following line to the end of the /etc/sysconfigtab file: vm: ubc-borrowpercent = 50 More advanced tuning of your DIGITAL UNIX system depends on the type of user activity and data files. For example, if you perform occasional assembly modeling operations with numerous view and edit operations on individual components, adding the following lines to the end of the /etc/sysconfigtab file can also improve performance: 3-2 After Installing DIGITAL Open3D vm: vm-maxvas = 1610612736 proc: per-proc-data-size = 268435456 max-per-proc-data-size = 1610612736 per-proc-stack-size = 4194304 max-per-proc-stack-size = 48000000 max-per-proc-address-space = 1610612736 This technique is a suggested "first level" of tuning to try for average workloads. To achieve the best possible performance on your system, however, you should consult the DIGITAL UNIX tuning documentation, experiment with the different tuning techniques proposed, and monitor the results while your application is running. After Installing DIGITAL Open3D 3-3 A _________________________________________________________________ Files Installed on Your System The DIGITAL Open3D installation procedure installs a number of files on your system and defines certain logical names. Table A-1 lists the files installed. Table_A-1_Installed_Files_for_the_DIGITAL_Open3D_Kit_____________ Directory________________File_Name______________Description______ O3DDWSBASE490_Subset_____________________________________________ /usr/opt/O3D490/swizzle S85vectored_x /usr/shlib/X11 lib_dec_3dlib.so 3D server shareable component lib_dec_GLX.so lib_dec_PEX.so lib_dec_glXDECpeer.so lib_dec_opengl.so OpenGL server loadable component lib_dec_sampleDDGL.so lib_dec_sampleGL.so lib_dec_x3d_pex.so PEX server loadable component libdirectx.so /usr/shlib libDirectX.so libVX11.so (continued on next page) Files Installed on Your System A-1 Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSCMT490_Subset______________________________________________ /usr/opt/comet comet.mod config.file files sysconfigtab /usr/shlib/X11 lib_dec_comet.so _________________________________________________________________ O3DDWSCOMMON490_Subset___________________________________________ /usr/dt/bin dtwm_overlay /usr/include/PEX MPEX.h MPEXlib.h MPEXoc.h MPEXproto.h MPEXprotostr.h PEX.h PEXlib.h PEXlibprotos.h PEXmacros.h PEXoc.h PEXocbuf.h PEXproto.h PEXprotost.h floatdef.h (continued on next page) A-2 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSCOMMON490_Subset___________________________________________ /usr/lib libdecpex.a /usr/lib/OPEN3D open3d490.release_ Release notes, in notes ASCII format open3d490.release_ Release notes, in notes.PS PostScript format /usr/lib/pex/examples pst_cube pst_cube.shell /usr/lib/X11 Xserver.O3D.conf /usr/lib/X11 font_*.fnt /strokefonts/pex /usr/opt/03D490 timestamp /usr/shlib libdecpex.so /usr/var/X11/shared_ readme.txt Readme file for desktop Shared Desktop software shared_desktop.tar Shared Desktop software _________________________________________________________________ O3DDWSCONFIG490_Subset___________________________________________ no files _________________________________________________________________ O3DDWSGLBASE490_Subset___________________________________________ /usr/bin/X11 gl_ivp xglinfo /usr/include/GL gl.h glu.h glut.h glx.h glxdecproto.h (continued on next page) Files Installed on Your System A-3 Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSGLBASE490_Subset___________________________________________ glxint.h glxmd.h glxproto.h glxtokens.h /usr/include/X11/GLw GLwDrawA.h GLwMDrawA.h /usr/lib libGLUdeprecated.a libGLdeprecated.a libGLwdeprecated.a /usr/lib/X11/config OpenGL.tmpl /usr/shlib libGL.so OpenGL API shared library libGLU.so libGLw.so libglProtocol.so libglut.so _________________________________________________________________ O3DDWSGLEXAM490_Subset___________________________________________ /usr/examples/GL Imakefile /usr/examples/GL Imakefile /examples README *.c jitter.h /usr/examples/GL/glut CHANGES Glut.cf Imakefile Makefile.sgi (continued on next page) A-4 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSGLEXAM490_Subset___________________________________________ mkmkfiles.imake mkmkfiles.sgi NOTICE README README.* vms_link_glut_ tree.opt /usr/examples/GL/glut Imakefile /GL fglut.h glut.h /usr/examples/GL/glut glut.column1.ps /doc glut3.0.ps /usr/examples/GL/glut Imakefile /lib Makefile.sgi /usr/examples/GL/glut Makefile.sgi /lib/fglut fglut.c fglut_*.c /usr/examples/GL/glut Imakefile /lib/glut Makefile.sgi cannotate.c glut_*.c glutbitmap.h glutint.ah glutint.h (continued on next page) Files Installed on Your System A-5 Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSGLEXAM490_Subset___________________________________________ glutstroke.h layerutil.c layerutil.h stroke.h vms_extra_mms_ defs.inc vms_link_glut.com /usr/examples/GL/glut MonoRoman.stroke /lib/helper Roman.stroke capturexfont.c strokegen.y strokelex.l /usr/examples/GL/glut Imakefile /progs Makefile.sgi /usr/examples/GL/glut Imakefile /progs/contrib Makefile.sgi agv_example.c agviewer.c agviewer.h fractals.c fracviewer.c fracviewer.h hanoi.c lineblend.c rand48.c rings.c (continued on next page) A-6 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSGLEXAM490_Subset___________________________________________ vms_extra_mms_ defs.inc worms.c /usr/examples/GL/glut Imakefile /progs/demos Makefile.sgi /usr/examples/GL/glut/progs/demos/atlantis Imakefile Makefile.sgi atlantis.c atlantis.h dolphin.c shark.c swim.c vms_extra_mms_ defs.inc whale.c /usr/examples/GL/glut/progs/demos/ideas Imakefile Makefile.sgi *.c objects.h vms_extra_mms_ defs.inc /usr/examples/GL/glut/progs/demos/walker Imakefile *.cset Makefile Makefile.sgi (continued on next page) Files Installed on Your System A-7 Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSGLEXAM490_Subset___________________________________________ models.c vms_extra_mms_ defs.inc walker.c walker.h walkviewer.c walkviewer.h /usr/examples/GL/glut Imakefile /progs/examples Makefile.sgi *.c trackball.h vms_extra_mms_ defs.inc /usr/examples/GL/glut Makefile.sgi /progs/fortran example.f fbitfont.f fscene.f sphere.f /usr/examples/GL/glut Imakefile /progs/inventor Makefile Makefile.sgi duck.iv globe.c++ globe.rgb glutduck.c++ (continued on next page) A-8 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSGLEXAM490_Subset___________________________________________ /usr/examples/GL/glut Imakefile /progs/redbook Makefile.sgi *.c aux2glut.sed jitter.h vms_extra_mms_ defs.inc /usr/examples/GL/glut Imakefile /test Makefile.sgi *.c vms_extra_mms_ defs.inc /usr/examples/GL/glx_ Imakefile sample README bezmesh.c get_visual.c win_utils.c win_utils.h /usr/examples/GL/ivp Imakefile gl_ivp.c /usr/examples/GL/libaux 3d.h Imakefile *.c *.h /usr/examples/GL Imakefile /libfont (continued on next page) Files Installed on Your System A-9 Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSGLEXAM490_Subset___________________________________________ font.c font.h /usr/examples/GL/librgb Imakefile rgb.c rgb.h /usr/examples/GL/libtk Imakefile README *.c *.h /usr/examples/GL *.rgb /samples *.c Imakefile README /usr/examples/GL Imakefile /samples/EXT *.c /usr/examples/GL Imakefile /visinfo README findvis.1 findvis.c visinfo.3 visinfo.c visinfo.h /usr/examples/GL Imakefile /widgets README double.c (continued on next page) A-10 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSGLEXAM490_Subset___________________________________________ simple.c /usr/examples/GL Imakefile /xglinfo global.h stringConversion.c xglinfo.c _________________________________________________________________ O3DDWSGLMAN490_Subset____________________________________________ /usr/man/man3 gl*.3gl Individual OpenGL man pages _________________________________________________________________ O3DDWSMITPEX490_Subset___________________________________________ /usr/include/X11/PEX5 PEX.h MIT PEXlib include files PEXlib.h PEXlibint.h PEXproto.h PEXprotost.h /usr/lib libPEX5.a /usr/shlib libPEX5.so _________________________________________________________________ O3DDWSMITPEXEXAM490_Subset_______________________________________ no files _________________________________________________________________ O3DDWSMITPEXMAN490_Subset________________________________________ /usr/man/man3 PEX*.3 MIT PEXlib man pages (continued on next page) Files Installed on Your System A-11 Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSPCM490_Subset______________________________________________ /usr/bin pcmserver /usr/examples/PCM Imakefile pct PCM (dials and buttons) test program xpcmtest xpcmtest.c /usr/include/PCM c_idl.h IDL (dials and buttons) include file /usr/lib libpcm.a PCM (dials and buttons) library /usr/lib/pcm custom.ss standard.ss /usr/shlib libpcm.so PCM (dials and buttons) shared library _________________________________________________________________ O3DDWSPEX490_Subset______________________________________________ no files _________________________________________________________________ O3DDWSPHRJP490_Subset____________________________________________ /usr/i18n/usr/share/ja_JP.deckanji/man/man3 phigs.3g Japanese manual pages /usr/kits/PHR510/usr font_jisx0201.fnt Japanese font /lib/GFX/font font_jisx0208.fnt Japanese font (continued on next page) A-12 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSPHRJP490_Subset____________________________________________ gfx_font_neg10001 Japanese font /usr/kits/PHR510/usr gfx_motif_jp.uid Japanese UID file /lib/X11/uid _________________________________________________________________ O3DDWSPHRMAN490_Subset___________________________________________ /usr/man/man3 phigs.3g DIGITAL PHIGS manual pages _________________________________________________________________ O3DDWSPHRTO490_Subset____________________________________________ /usr/kits/PHR510/usr gfx_font1 Stroke fonts /lib/GFX/font gfx_font2 gfx_font_neg1 gfx_font_neg2 gfx_font_neg3 gfx_font_neg4 gfx_font_neg5 gfx_font_neg6 gfx_font_neg7 gfx_font_neg8 gfx_font_neg9 gfx_font_neg10 gfx_font_neg11 gfx_font_neg12 gfx_font_neg13 gfx_font_neg14 gfx_font_neg15 gfx_font_neg16 (continued on next page) Files Installed on Your System A-13 Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSPHRTO490_Subset____________________________________________ gfx_font_neg17 gfx_font_neg18 gfx_font_neg19 gfx_font_neg20 gfx_font_neg21 gfx_font_neg22 gfx_font_neg23 gfx_font_neg24 /usr/kits/PHR510/usr/lib/GFX/messages vms_msgfil_0000.dat vms_msgfil_027C.dat vms_msgfil_027D.dat vms_msgfil_033F.dat /usr/kits/PHR510/usr /lib/GFX/servers gfx_motif_server_v2 /usr/kits/PHR510/usr phigs051_release_ DIGITAL PHIGS /lib/PHIGS notes.PS Version 5.1 release notes in PostScript format phigs051_release_ DIGITAL PHIGS notes.txt Version 5.1 release notes in ASCII format phigs_predef phigs_predef_display /usr/kits/PHR510/usr/lib/PHIGS/examples phigs_archive_ converter (continued on next page) A-14 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSPHRTO490_Subset____________________________________________ phigs_ivp DIGITAL PHIGS installation verification procedure run_phigsivp.sh (continued on next page) Files Installed on Your System A-15 Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSPHRTO490_Subset____________________________________________ /usr/kits/PHR510/usr gfx_motif.uid /lib/X11/uid gfx_motif_en.uid Motif user interface description files /usr/kits/PHR510/usr vaxgfx_ddif_color_ /lib table.dat /usr/kits/PHR510/usr libPHIGS.so DIGITAL PHIGS /shlib shared libraries libPHIGSC.so libPHIGSISO_C.so libPHIGScommon.so libPHIGSdecpex.so Shareable library for PEXlib support (used only if DIGITAL Open3D is not installed) libPHIGSgli3d.so Shareable library for OpenGL support libPHIGSpcm.so Shareable library for button and dial support (used only if DIGITAL Open3D is not installed) so_locations (continued on next page) A-16 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ _________________________________________________________________ O3DDWSSTEREO490_Subset___________________________________________ /usr/bin/X11 xstereo Stereo utility program /usr/include/DECStereo DECStereo.h Stereo API include files DECStereostr.h /usr/lib libDECStereo.a Stereo API library /usr/shlib libDECStereo.so Stereo API shared library /usr/shlib/X11 lib_dec_Stereo.so Stereo Extension server shareable component _________________________________________________________________ O3DDWSSTEREOMAN490_Subset________________________________________ /usr/man/man1 xstereo.1X Stereo utility man page /usr/man/man3 stereo.3X Stereo API library man page _________________________________________________________________ O3DDWSZE3490_Subset______________________________________________ /usr/bin/X11 e3special pantherpanel /usr/man/man7 ingr.7 /usr/opt/ZE3 config.file files ingr.mod sysconfigtab /usr/opt/ZE3/40D config.file files (continued on next page) Files Installed on Your System A-17 Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ Directory________________File_Name______________Description______ O3DDWSZE3490_Subset______________________________________________ ingr.mod sysconfigtab /usr/opt/ZE3/50 config.file files ingr.mod sysconfigtab /usr/opt/ZE3/large_mem config.file files ingr.mod sysconfigtab /usr/shlib/X11 lib_dec_DDGLe3sc.so lib_dec_e3sc.so lib_dec_e3sc_ linear.so /usr/shlib libE3DirectX.so libglPeerIGe3sc.so _________________________________________________________________ O3DDWSZLXE490_Subset_____________________________________________ /usr/opt/O3D490/tga2 tga.h tga.mod /usr/shlib/X11 lib_dec_ffb.so lib_dec_ffb.so.EV5 (continued on next page) A-18 Files Installed on Your System Table_A-1_(Cont.)_Installed_Files_for_the_DIGITAL_Open3D_Kit_____ _________________________________________________________________ O3DDWSZLXL490_Subset_____________________________________________ /usr/bin/X11 pvpRm pvRm /usr/include/X11 overlay.h X11 include file /extensions that supports overlay planes /usr/opt/O3D490/ZLXLp pvp.mod pvp_data.c /usr/shlib/X11 lib_dec_pvg.so _________________________lib_dec_pvp.so__________________________ Files Installed on Your System A-19 B _________________________________________________________________ Sample Installation This appendix provides a sample installation of a DIGITAL Open3D kit. # setld -l /mnt *** Enter subset selections *** The following subsets are mandatory and will be installed automatically unless you choose to exit without installing any subsets: * Open3D Common V4.9 * Open3D Config V4.9 The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. Sample Installation B-1 1) DWS Open3D Base V4.9 2) DWS Open3D MIT PEX Programming V4.9 3) DWS Open3D MIT PEX Programming examples V4.9 4) DWS Open3D MIT PEX Programming man pages V4.9 5) DWS Open3D OpenGL Base V4.9 6) DWS Open3D OpenGL examples V4.9 7) DWS Open3D OpenGL man pages V4.9 8) DWS Open3D PCM Server and Library V4.9 9) DWS Open3D PEX Programming V4.9 10) DWS Open3D PowerStorm 3D30 and PowerStorm 4D20 V4.9 11) DWS Open3D PowerStorm 4D10T V4.9 12) DWS Open3D PowerStorm 4D40T/4D50T/4D51T/4D60T V4.9 13) DWS Open3D Stereo Extension V4.9 14) DWS Open3D Stereo Extension man pages V4.9 15) DWS Open3D ZLXp-L V4.9 16) Digital PHIGS Japanese Run-Time Files V4.9 17) Digital PHIGS Manual Pages V4.9 18) Digital PHIGS Run-Time-Only Kit V4.9 Or you may choose one of the following options: 19) ALL mandatory and all optional subsets 20) MANDATORY subsets only 21) CANCEL selections and redisplay menus 22) EXIT without installing any subsets Enter your choices or press RETURN to display menus. Choices (for example, 1 2 4-6): 1-14 18 You are installing the following mandatory subsets: Open3D Common V4.9 Open3D Config V4.9 You are installing the following optional subsets: B-2 Sample Installation DWS Open3D Base V4.9 DWS Open3D MIT PEX Programming V4.9 DWS Open3D MIT PEX Programming examples V4.9 DWS Open3D MIT PEX Programming man pages V4.9 DWS Open3D OpenGL Base V4.9 DWS Open3D OpenGL examples V4.9 DWS Open3D OpenGL man pages V4.9 DWS Open3D PCM Server and Library V4.9 DWS Open3D PEX Programming V4.9 DWS Open3D PowerStorm 3D30 and PowerStorm 4D20 V4.9 DWS Open3D PowerStorm 4D10T V4.9 DWS Open3D PowerStorm 4D40T/4D50T/4D51T/4D60T V4.9 DWS Open3D Stereo Extension V4.9 DWS Open3D Stereo Extension man pages V4.9 DWS Open3D ZLXp-L V4.9 Digital PHIGS Run-Time-Only Kit V4.9 Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. 19 subset(s) will be installed. Loading 1 of 18 subset(s).... Open3D Common V4.9 Copying from /mnt (disk) Verifying Loading 2 of 18 subset(s).... Saved file ./usr/shlib/libX11.so as ./usr/shlib/libX11.so.pre.O3D490 DWS Open3D Base V4.9 Copying from /mnt (disk) Verifying Loading 3 of 18 subset(s).... DWS Open3D OpenGL Base V4.9 Copying from /mnt (disk) Verifying Loading 4 of 18 subset(s).... Sample Installation B-3 DWS Open3D PEX Programming V4.9 Copying from /mnt (disk) Verifying Loading 5 of 18 subset(s).... DWS Open3D MIT PEX Programming V4.9 Copying from /mnt (disk) Verifying Loading 6 of 18 subset(s).... DWS Open3D Stereo Extension V4.9 Copying from /mnt (disk) Verifying Loading 7 of 18 subset(s).... DWS Open3D PCM Server and Library V4.9 Copying from /mnt (disk) Verifying Loading 8 of 18 subset(s).... DWS Open3D OpenGL man pages V4.9 Copying from /mnt (disk) Verifying Loading 9 of 18 subset(s).... DWS Open3D MIT PEX Programming man pages V4.9 Copying from /mnt (disk) Verifying Loading 10 of 18 subset(s).... DWS Open3D Stereo Extension man pages V4.9 Copying from /mnt (disk) Verifying Loading 11 of 18 subset(s).... DWS Open3D OpenGL examples V4.9 Copying from /mnt (disk) Verifying Loading 12 of 18 subset(s).... DWS Open3D MIT PEX Programming examples V4.9 Copying from /mnt (disk) Verifying B-4 Sample Installation Loading 13 of 18 subset(s).... Installing Digital PHIGS and running the Installation Verification Procedure (IVP) takes approximately 5 to 30 minutes, depending on your type of media and your system configuration. Copyright Digital Equipment Corporation 1988, 1997. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Digital PHIGS Run-Time-Only Kit V4.9 Copying from /mnt (disk) Loading 14 of 18 subset(s).... *** IMPORTANT NOTE FOR MULTIPLE ZLX AND POWERSTORM CONFIGURATIONS *** If your system configuration contains multiple PowerStorm 3D30, PowerStorm 4D20, or ZLXp-L* graphics accelerators, then you are *REQUIRED* to *FULLY* reconfigure and rebuild the system as specified in the Digital UNIX Guide to System Administration manual. Failure to do so will result in the multiscreen options not functioning properly. Additional information is contained in the release notes found in /usr/lib/OPEN3D/open3d490.release_notes. **** Installation of 03DDWSZLXL490 requires reboot after kit install **** Saved file ./usr/shlib/X11/lib_dec_pvp.so as ./usr/shlib/X11/lib_dec_pvp.so.pre.O3D490 Saved file ./usr/bin/X11/pvpRm as ./usr/bin/X11/pvpRm.pre.O3D490 DWS Open3D ZLXp-L V4.9 Copying from /mnt (disk) Verifying Loading 15 of 18 subset(s).... *** IMPORTANT NOTE FOR MULTIPLE ZLX AND POWERSTORM CONFIGURATIONS *** Sample Installation B-5 If your system configuration contains multiple PowerStorm 3D30, PowerStorm 4D20, or ZLXp-L* graphics accelerators, then you are *REQUIRED* to *FULLY* reconfigure and rebuild the system as specified in the Digital UNIX Guide to System Administration manual. Failure to do so will result in the multiscreen options not functioning properly. Additional information is contained in the release notes found in /usr/lib/OPEN3D/open3d490.release_notes. **** Installation of 03DDWSZLXE490 requires reboot after kit install **** Saved file ./usr/shlib/X11/lib_dec_ffb.so as ./usr/shlib/X11/lib_dec_ffb.so.pre.O3D490 Saved file ./usr/shlib/X11/lib_dec_ffb_ev5.so as ./usr/shlib/X11/lib_dec_ffb_ev5.so.pre.O3D490 DWS Open3D PowerStorm 3D30 and PowerStorm 4D20 V4.9 Copying from /mnt (disk) Verifying Loading 16 of 18 subset(s).... DWS Open3D PowerStorm 4D40T/4D50T/4D51T/4D60T V4.9 Copying from /mnt (disk) Verifying Loading 17 of 18 subset(s).... DWS Open3D PowerStorm 4D10T V4.9 Copying from /mnt (disk) Verifying Loading 18 of 18 subset(s).... Open3D Config V4.9 Copying from /mnt (disk) Verifying 18 of 18 subset(s) installed successfully. Configuring "Open3D Common V4.9" (O3DDWSCOMMON490) Release notes can be found in /usr/lib/OPEN3D/open3d490.release_notes. Saved file ./sbin/init.d/vectored_x as ./sbin/init.d/vectored_x.pre.O3D490 Configuring "DWS Open3D Base V4.9" (O3DDWSBASE490) Modifying ./usr/var/X11/Xserver.conf B-6 Sample Installation **** Installation of 03DDWSBASE490 requires reboot after kit install **** To verify the installation of the O3DDWSGLBASE490 subset, if you have a ZLX graphics option and after you have rebuilt your kernel and rebooted your system, cd to /usr/bin/X11 and issue the command: ./gl_ivp However, if your configuration does NOT contain a PowerStorm 3D30/4D20, or PowerStorm 4D40T/50T/60T graphics option, then execution of this OpenGL IVP will fail. Configurations containing only an HX graphics option should NOT run the OpenGL IVP. Configuring "DWS Open3D OpenGL Base V4.9" (O3DDWSGLBASE490) To verify the installation of the O3DDWSPEX490 subset, if you have a ZLX graphics option and after you have rebuilt your kernel and rebooted your system, cd to /usr/lib/pex/examples and issue the command: ./pst_cube.shell However, if your configuration does NOT contain a PowerStorm 3D30 or PowerStorm 4D20 graphics option, then execution of this PEX IVP will fail. Configurations containing only an HX graphics option should NOT run the PEX IVP. Configuring "DWS Open3D PEX Programming V4.9" (O3DDWSPEX490) Configuring "DWS Open3D MIT PEX Programming V4.9" (O3DDWSMITPEX490) Configuring "DWS Open3D Stereo Extension V4.9" (O3DDWSSTEREO490) Modifying ./usr/var/X11/Xserver.conf To complete the installation of the PCM Server and Library, you must edit the file /etc/inittab to cause the PCM server to be started at system boot time. Add a line similar to: pcms:23:respawn:/usr/bin/pcmserver where is the name of the serial port to which the PCM is connected. This may be /dev/tty00 or /dev/tty01 or something similar. To start the PCM server without rebooting use the command: Sample Installation B-7 /sbin/init 3 To verify that the PCM server is running properly and can communicate with the buttons and dials, make sure the X11 server is running and then run the example program: /usr/examples/PCM/xpcmtest Configuring "DWS Open3D PCM Server and Library V4.9" (O3DDWSPCM490) Configuring "DWS Open3D OpenGL man pages V4.9" (O3DDWSGLMAN490) Configuring "DWS Open3D MIT PEX Programming man pages V4.9" (O3DDWSMITPEXMAN490) Configuring "DWS Open3D Stereo Extension man pages V4.9" (O3DDWSSTEREOMAN490) Configuring "DWS Open3D OpenGL examples V4.9" (O3DDWSGLEXAM490) Configuring "DWS Open3D MIT PEX Programming examples V4.9" (O3DDWSMITPEXEXAM490) *********************************************************************** * * * Digital PHIGS Run-Time-Only Kit installation completed successfully * * * *********************************************************************** Configuring "Digital PHIGS Run-Time-Only Kit V4.9" (O3DDWSPHRTO490) If you would like to run the Phigs IVP, issue the following command: /usr/lib/PHIGS/examples/run_phigsivp.sh Configuring "DWS Open3D ZLXp-L V4.9" (O3DDWSZLXL490) Configuring "DWS Open3D PowerStorm 3D30 and PowerStorm 4D20 V4.9" (O3DDWSZLXE490) Saved file ./sys/BINARY/tga.mod as ./sys/BINARY/tga.mod.pre.O3D490 Saved file ./sys/include/io/dec/ws/tga.h as ./sys/include/io/dec/ws/tga.h.pre.O3D490 Configuring "DWS Open3D PowerStorm 4D40T/4D50T/4D51T/4D60T V4.9" (O3DDWSZE3490) **** Installation of 03DDWSZE3490 requires reboot after kit install **** Configuring "DWS Open3D PowerStorm 4D10T V4.9" (O3DDWSCMT490) **** Installation of 03DDWSCMT490 requires reboot after kit install **** B-8 Sample Installation Configuring "Open3D Config V4.9" (O3DDWSCONFIG490) **** Auto Kernel Configuration **** *** KERNEL CONFIGURATION AND BUILD PROCEDURE *** Saving /sys/conf/AVALON as /sys/conf/AVALON.bck Do you want to edit the configuration file? (y/n) [n]: *** PERFORMING KERNEL BUILD *** The new kernel is /sys/AVALON/vmunix Saved file ./vmunix as ./vmunix.pre.O3D490 Moving new kernel to /vmunix... Installation of O3DDWSCONFIG490 Complete. **** REBOOT to enable new kernel **** # exit Sample Installation B-9