SGI® Opengl Vizserver™ Administrator's Guide
Total Page:16
File Type:pdf, Size:1020Kb
SGI® OpenGL Vizserver™ Administrator’s Guide Version 3.5.1 007-4481-011 CONTRIBUTORS Written by Jenn McGee and Ken Jones Illustrated by Chrystie Danzer Engineering contributions by Younghee Lee and Yochai Shefi-Simchon COPYRIGHT © 2002–2005 Silicon Graphics, Inc. All rights reserved; provided portions may be copyright in third parties, as indicated elsewhere herein. No permission is granted to copy, distribute, or create derivative works from the contents of this electronic documentation in any manner, in whole or in part, without the prior written permission of Silicon Graphics, Inc. LIMITED RIGHTS LEGEND The software described in this document is “commercial computer software” provided with restricted rights (except as to included open/free source) as specified in the FAR 52.227-19 and/or the DFAR 227.7202, or successive sections. Use beyond license provisions is a violation of worldwide intellectual property laws, treaties and conventions. This document is provided with limited rights as defined in 52.227-14. TRADEMARKS AND ATTRIBUTIONS Silicon Graphics, SGI, the SGI logo, IRIX, InfiniteReality, Octane, Onyx, Onyx2, OpenGL and Tezro are registered trademarks and InfinitePerformance, InfiniteReality2, InfiniteReality3, InfiniteReality4, Octane2, Onyx4, OpenGL Vizserver, Performance Co-Pilot, SGI ProPack, Silicon Graphics Fuel, Silicon Graphics Prism, and UltimateVision are trademarks of Silicon Graphics, Inc., in the United States and/or other countries worldwide. AMD is a registered trademark of Advanced Micro Devices, Inc. Fedora and Red Hat are registered trademarks of Red Hat, Inc. Linux is a registered trademark of Linus Torvalds, used with permission by Silicon Graphics, Inc. Intel is a registered trademark of Intel Corporation. MIPS is a registered trademark of MIPS Technologies, Inc. used under license by Silicon Graphics, Inc. Mac OS X and Macinstosh are registered trademarks of Apple Computer, Inc. Microsoft, Windows, and Windows NT are registered trademarks of Microsoft Corporation in the United States and/or other countries. MIPS is a registered trademark of MIPS Technologies, Inc. used under license by Silicon Graphics, Inc. Netscape is a registered trademark of Netscape Communications Corporation. QuickTransit is a trademark of Transitive Corporation and/or its affiliates in the United States and other countries. Solaris is a trademark of and SunOS is a registered trademark of Sun Microsystems, Inc. SUSE LINUX is a registered trademark of Novell, Inc. UNIX and the X device are registered trademarks of The Open Group in the United States and other countries. XFree86 is a trademark of The XFree86 Project, Inc. All other trademarks mentioned herein are the property of their respective owners. New Features in This Guide This revision of the guide documents OpenGL Vizserver support of the product QuickTransit for Silicon Graphics. 007-4481-011 iii Record of Revision Version Description 001 September 2002 Original publication; supports OpenGL Vizserver 3.0. 002 November 2002 Supports OpenGL Vizserver 3.0.1. 003 March 2003 Supports OpenGL Vizserver 3.1. 004 August 2003 Supports OpenGL Vizserver 3.2. 005 October 2003 Supports OpenGL Vizserver 3.2.1. 006 January 2004 Supports OpenGL Vizserver 3.3. 007 July 2004 Supports OpenGL Vizserver 3.4. 008 October 2004 Supports OpenGL Vizserver 3.4.1. 009 November 2004 Supports OpenGL Vizserver 3.4.2. 010 June 2005 Supports OpenGL Vizserver 3.5. 007-4481-011 v Record of Revision 011 July 2005 Supports OpenGL Vizserver 3.5.1. vi 007-4481-011 Contents Record of Revision . v Figures . xi Tables . xiii About This Guide. xv System Requirements . xv Related Publications . xvi Obtaining Publications . xvii Conventions . xvii Reader Comments . xviii 1. Installation. 1 Installing an IRIX Server . 1 Installing a Silicon Graphics Prism Server and Client . 4 Installing Other Clients . 5 IRIX. 5 Solaris . 7 32-Bit Linux . 8 Windows . 9 Mac OS X . 9 007-4481-011 vii Contents 2. Configuration . 11 Configuring the Server. 11 Starting and Stopping the Server Using the GUI . 12 Starting and Stopping the Server Using the Command Line Interface . 13 Allocating Graphics Pipes for OpenGL Vizserver . 14 Configuration Parameters . 16 Managing Users . 18 Adding a User. 18 Modifying a User . 20 Deleting a User . 20 Configuring the Reservation Web Interface . 21 Configuration Files . 23 The /var/vizserver/users File. 23 The /var/vizserver/config File . 24 The /var/vizserver/reservation_client.conf File . 29 The /var/vizserver/topology and /var/vizserver/videoGroups Files . 31 User Authentication . 32 AUTH-PASSWORD . .33 AUTH-PAM . 33 Graphics Pipe Allocation Guidelines. 33 Relevant Configuration File Parameters . .35 Static Pipe Allocation . 35 Dynamic Pipe Allocation . 35 Dynamic Pipe Allocation Policy . 37 Hardware Readback . 37 3. Tuning . 39 Understanding the OpenGL Vizserver Pipeline . 40 How It Operates . 41 Single-User Session . 41 Collaborative Session. 42 Main Components . 44 Tuning Objectives . 45 viii 007-4481-011 Contents Understanding the Environment . 46 Measuring the Application Performance Locally . 46 Measuring Network Bandwidth and Latency . 48 Monitoring OpenGL Vizserver Performance . 49 Performance Co-Pilot. 50 PCP OpenGL Vizserver PMDA . .50 vsmonitor . 57 Optimizing Compression . 59 Estimating the Network Bandwidth Required by OpenGL Vizserver . 60 Calculating Frames Per Second on a Given Network Bandwidth . 60 Calculating Network Bandwidth Necessary for k Frames Per Second . 62 Optimizing for High-Latency Networks . 62 4. Troubleshooting and Known Problems . 65 Looking at Log Files . 66 Server Log File . 66 Session Log File . 67 System Log File . 67 XFree86 Log File . 68 Accounting Log Files . 69 Shared Memory Input Queue (SHMIQ) Problem . 69 What is shmiq? . 70 Why Does This Cause a Problem? . .70 How To Resolve It . 70 No OpenGL Vizserver Console Window in Windows 2000 . 71 Cleaning Up Shared Memory . 71 Using Window Managers Other Than 4Dwm . 72 Application Not Updated. 72 Applications Masked as a Cross-Hatch Pattern Image . 72 Back-to-Front Rendering . 73 Using Customized XDM in Dynamic Pipe Allocation. 73 Index . 75 007-4481-011 ix Figures Figure 2-1 Configuration GUI . 12 Figure 2-2 Starting the OpenGL Vizserver Server Manager . 13 Figure 2-3 Graphics Pipes Panel . 15 Figure 2-4 Configuration Values Panel . 17 Figure 2-5 Add a User Panel . 19 Figure 2-6 Modify a User Panel . 20 Figure 2-7 Delete a User Panel. 21 Figure 2-8 Setting Reservation System Parameters . 22 Figure 3-1 Overall Diagram of OpenGL Vizserver . 40 Figure 3-2 OpenGL Vizserver PMDA. 51 Figure 3-3 pmchart Using OpenGL Vizserver PMDA . 56 Figure 3-4 vsmonitor Output . 58 007-4481-011 xi Tables Table 1-1 File Subsystems for IRIX Servers . 1 Table 1-2 File Subsystems for Silicon Graphics Prism Servers and Clients . 4 Table 1-3 File Subsystems for IRIX Clients . 5 Table 1-4 File Subsystems for Solaris Clients . 7 Table 1-5 File Subsystems for 32-Bit Linux Clients. 8 Table 1-6 File Subsystems for Macintosh Clients . 9 Table 3-1 Compression Trade-Offs . 59 007-4481-011 xiii About This Guide This document is intended for system administrators and gives information about installing, configuring, tuning, and troubleshooting OpenGL Vizserver. Using OpenGL Vizserver, you can run graphics applications on another system and OpenGL Vizserver serves the resulting graphics to your client machine. You can also use OpenGL Vizserver in conjunction with other products like QuickTransit for Silicon Graphics. QuickTransit allows you to transparently run applications compiled for IRIX MIPS platforms. Hence, QuickTransit greatly augments the number of applications you can run on Silicon Graphics Prism servers. System Requirements OpenGL Vizserver consists of client and server modules. The OpenGL Vizserver server module requires one of the following system types: • SGI Onyx 3000 series with InfiniteReality3 or InfiniteReality4 graphics • SGI Onyx 3000 series with InfinitePerformance graphics • SGI Onyx 300 systems with InfinitePerformance graphics • SGI Onyx 300 systems with InfiniteReality3 or InfiniteReality4 graphics • SGI Onyx 350 systems with InfinitePerformance graphics • SGI Onyx 350 systems with InfiniteReality3 or InfiniteReality4 graphics • Silicon Graphics Onyx2 systems with InfiniteReality2, InfiniteReality3, or InfiniteReality4 graphics • Silicon Graphics Octane or Octane2 systems • Silicon Graphics Onyx4 UltimateVision systems • Silicon Graphics Fuel systems • Silicon Graphics Tezro systems 007-4481-011 xv About This Guide • Silicon Graphics Prism systems A server module must have one of the following operating systems installed: • SGI ProPack for Silicon Graphics Prism platforms • IRIX 6.5.11 or later for other platforms OpenGL Vizserver supports clients running the following software platforms: • IRIX 6.5.11 or later • Red Hat Linux 8 or later • SUSE LINUX 9 or later • Fedora Core 2 or later • SGI ProPack • Solaris 2.6 or later • Windows NT 4.0 , Windows 2000, and Windows XP • Mac OS X 10.3.5 or later Related Publications The following documents contain additional information that may be helpful: • SGI OpenGL Vizserver User’s Guide • Performance Co-Pilot User’s and Administrator’s Guide • IRIX Admin: Networking and Mail • IRIX Admin: Software Iinstallation and Licensing • SGI ProPack for Linux Start Here • SGI Scalable Graphics Compositor User’s Guide • Silicon Graphics Scalable Graphics Capture PCI-X Option User’s Guide xvi 007-4481-011 About This Guide Obtaining Publications You can obtain SGI documentation in the following ways: •