Chapter 1. Installation
Prev   Next

Chapter 1. Installation

This chapter explains how to install the OpenGL Vizserver server module and client modules. The following topics are covered:

It is assumed that your operating system (OS) is already installed and configured before installing OpenGL Vizserver. For OS installation and configuration information, refer to your system installation and administration guide.

Once your operating system is properly configured, use the following sections for installing OpenGL Vizserver over a network or from a CD.

You can also go to http://www.sgi.com/software/vizserver and click the Downloads link.

Installing an IRIX Server

The OpenGL Vizserver 3.x server module for IRIX consists of the file subsystems shown in Table 1-1.

Table 1-1. File Subsystems for IRIX Servers

Subsystem

Description

vizserver_server.sw.vizserver

The OpenGL Vizserver server's main software.

It contains session manager and server manager executables, as well as libraries and scripts needed for server systems.

vizserver_server.modules.auth

Authentication module for the server.

vizserver_server.modules.pam_auth

Pluggable Authentication Modules ( PAM) for the server. It requires the installation of IRIX 6.5.22 or later, including eoe.sw.pam.

vizserver_server.modules.comp

Compression module for the server.

vizserver_server.modules.perf

Performance Co-Pilot module for the server.
It requires the installation of pcp_eoe.sw.eoe and pcp_eoe.sw.monitor.

vizserver_server.modules.readback

Hardware readback module for the server. It requires the installation of ml_sgc.sw.eoe and can be installed only on Onyx4 systems.

vizserver_server.modules.resclient

Reservation client module for the server.

vizserver_server.collab.client

Collaborative session support.
It requires the installation of vizserver_client.sw.client.

vizserver_server.books.Vizserver_AG

OpenGL Vizserver Administrator's Guide.

vizserver_server.man.relnotes

Release notes.

vizserver_server.man.vizserver

Man pages.

vizserver_server.web.res

Web module for OpenGL Vizserver pipe reservation.
It requires either Netscape or SGI Apache web server to operate.

vizserver_server.web.doc

OpenGL Vizserver online documentation.
It requires either Netscape or SGI Apache web server to operate.


Note: Please note that the OpenGL Vizserver 3.x server software is not compatible with a client running OpenGL Vizserver 2.0.1 or earlier and vice versa.

The following steps describe how you install OpenGL Vizserver.

  1. Before installing the OpenGL Vizserver server, check if you have any previous versions of it in your system by entering one of the following commands:

    # versions vizserver\*

    or

    # showprods vizserver\*

    This will show all of the OpenGL Vizserver server software as well as the OpenGL Vizserver clients, if any, on your system.

  2. Log in as root and use inst or swmgr to install the OpenGL Vizserver server software. For more details on installation software on IRIX, see the IRIX Admin: Software Installation and Licensing manual.

  3. If you are installing from a CD, enter the following command:

    # inst -f /CDROM/dist

    or

    If you are installing over the network, enter a command similar to the following:

    # inst -f machine:distribution_directory

  4. Resolve conflicts, if any, and continue the installation process. When done, verify your installation by entering the following command:

    # versions vizserver\*

While installing the OpenGL Vizserver server software, you may also want to install an OpenGL Vizserver IRIX client because the installation process is the same and the installable images are packaged in the same directory in the OpenGL Vizserver CD. Also, if you want to run a collaborative session, you need to install vizserver_server.collab.client, which requires the installation of the vizserver_client.sw.client module.

Installing a Silicon Graphics Prism Server and Client

This section describes the installation of OpenGL Vizserver for Silicon Graphics Prism systems. The Silicon Graphics Prism version of OpenGL Vizserver is installed by default when installing the SGI ProPack package. OpenGL Vizserver contains the subsystems listed in Table 1-2, where * denotes a version number.

Table 1-2. File Subsystems for Silicon Graphics Prism Servers and Clients

Subsystem

Description

sgi-vizserver-*.ia64.rpm

The OpenGL Vizserver client GUI program.
It also contains authentication and compression libraries, man pages, release notes, a user's guide, and so on.

sgi-vizserver-server-*.ia64.rpm

The OpenGL Vizserver server.
It contains several programs required for the normal operation of the OpenGL Vizserver server, as well as man pages, an administrator's guide, configuration files, and so on.
The installation of the server subsystem requires the installation of the client subsystem.

sgi-vizserver-devel-*.ia64.rpm

The OpenGL Vizserver modules development toolkit.
It contains header files, libraries, and example code.

Detailed documentation of the rpm utility for managing software installation on Linux is available in the rpm(8) man page.

Note: By default, operation of the OpenGL Vizserver server daemon on the Silicon Graphics Prism platform is turned off.

In order for the server daemon to start automatically upon system startup, use the chkconfig command as shown in the following:

# chkconfig vizserver on

For information on the chkconfig command, see the chkconfig(8) man page.

Installing Other Clients

OpenGL Vizserver supports clients running on the following operating systems:

  • IRIX

  • Solaris

  • 32-Bit Linux

  • 64-Bit Linux

  • Windows

  • Mac OS X

This section describes installing clients on these operating systems, except for 64-bit Linux, which is described in the previous section.

Note: OpenGL Vizserver 3.x clients are not compatible with a server running OpenGL Vizserver 2.0.1 or earlier.

IRIX

The OpenGL Vizserver IRIX client module consists of the file subsystems shown in Table 1-3.

Table 1-3. File Subsystems for IRIX Clients

Subsystem

Description

vizserver_client.sw.client

The OpenGL Vizserver client GUI program.
It also contains authentication and compression libraries.

vizserver_client.books.Vizserver_UG

The OpenGL Vizserver User's Guide.

vizserver_client.man.relnotes

Release notes.

vizserver_client.man.vizserver

Man pages.

vizserver_dev.sw.base

The OpenGL Vizserver compression, authentication, and reservation APIs.

vizserver_dev.sw.examples

Code examples of compression, authentication, and reservation APIs.
Located in the /usr/share/vizserver/src directory.

vizserver_dev.man.vizserver

Man pages of APIs.
HTML pages are located in the /usr/share/vizserver/doc/developer directory.


Note: If you installed the OpenGL Vizserver IRIX client while installing OpenGL Vizserver server software at the same time, skip the rest of this section.

  1. Before installing the OpenGL Vizserver IRIX client, check if you have any previous versions of it in your system by entering one of the following commands:

    # versions vizserver_client

    or

    # showprods vizserver_client

  2. Log in as root and use inst or swmgr to install the OpenGL Vizserver client software. For more details on installation software on IRIX, see the IRIX Admin: Software Installation and Licensing manual.

  3. If you are installing from a CD, enter the following command:

    # inst -f /CDROM/dist

    or

    If you are installing over the network, enter a command similar to the following:

    # inst -f machine:distribution_directory

  4. Resolve conflicts, if any, and continue the installation process. Verify your installation by entering the following command:

    # versions vizserver\*

Solaris

The OpenGL Vizserver Solaris client module consists of the subsystems shown in Table 1-4.

Table 1-4. File Subsystems for Solaris Clients

Subsystem

Description

SGIvizsvr-solaris

The OpenGL Vizserver client GUI program.
It also contains authentication and compression libraries, man pages, release notes, a user's guide, etc.

SGIvizdev-solaris

The OpenGL Vizserver compression and authentication development toolkit. (Optional)


  1. To check if there is a previous version of the OpenGL Vizserver client on your system, enter the following command:

    # pkginfo | grep SGIviz

  2. For a clean installation, you may want to remove any previous installation. Enter the following command:

    # pkgrm SGIvizsvr

  3. Log in as root and install the client modules using the following commands. The product is installed in the /opt/SGIvizsvr directory by default.

    # pkgadd -d /CDROM/solaris/SGIvizsvr-solaris

  4. To verify the installation, enter the following command:

    # pkginfo -i SGIvizsvr

For the installation of the optional subsystem SGIvizdev-solaris follow similar procedures as those described above. For more details about installation and removal of software in a Solaris system, see the pkginfo(1), pkgrm(1m), and pkgadd(1m) man pages.

32-Bit Linux

The OpenGL Vizserver client module for 32-bit Linux consists of the subsystems shown in Table 1-5.

Table 1-5. File Subsystems for 32-Bit Linux Clients

Subsystem

Description

SGIvizsvr-linux.i386.rpm

The OpenGL Vizserver client GUI program.
It also contains authentication and compression libraries, man pages, release notes, a user's guide, etc.

SGIvizdev-linux.i386.rpm

The OpenGL Vizserver compression and authentication development toolkit. (Optional)

The following steps describe how you install OpenGL Vizserver.

  1. Check if there is a previous installation of the OpenGL Vizserver client software in your system by entering the following command:

    # rpm -qa | grep SGIviz

  2. Log in as root and enter the following command:

    # rpm -Uvh /CDROM/linux/SGIvizsvr-linux.i386.rpm

  3. To verify the installation, enter the following command:

    # rpm -qi SGIvizsvr

For the installation of the optional subsystem SGIvizdev-linux.i386.rpm follow similar procedures to those described above. For more details about installation and removal of software in a Linux system, see the rpm(8) man page.

Windows

The OpenGL Vizserver Windows client module is packaged in a self-extracting executable, SGIvizsvr-win32.exe. It contains the following optional components:

  • Documentation: SGI OpenGL Vizserver User's Guide

  • SDK: The OpenGL Vizserver compression and authentication development options

  • SDK Documentation: The OpenGL Vizserver compression and authentication modules man pages

  • SDK Example Code: The OpenGL Vizserver compression and authentication modules example codes

Double-clicking on the SGIvizsvr-win32.exe file leads you to the installation procedure. Just follow the instructions on your screen.

Mac OS X

The OpenGL Vizserver client module for Macintosh clients consists of the subsystems shown in Table 1-6.

Table 1-6. File Subsystems for Macintosh Clients

Subsystem

Description

SGIvizsvr-macintosh.tar.gz

The OpenGL Vizserver client GUI program.
It also contains authentication and compression libraries, man pages, release notes, a user's guide, etc.

SGIvizdev-macintosh.tar.gz

The OpenGL Vizserver compression and authentication development toolkit. (Optional)

 The following steps describe how you install OpenGL Vizserver:

  1. Double-click the installation .tar.gz file to expand it using StuffitExpander.

  2. Double-click the resulting .pkg file to install the package.

  3. Follow the installation instructions. The root password will be required.

    Note: X11 is required for OpenGL Vizserver installation. X11 for Macintosh can be downloaded from http://www.apple.com/macosx/features/x11/download/.

To uninstall the package, run the uninstall script included in the .tar.gz file from the terminal as root.

Prev Table of Contents Next
About This Guide  Chapter 2. Configuration