C H A P T E R  2

Installing the Sun XVR-1200 Graphics Accelerator Software

This chapter provides Sun XVR-1200 graphics accelerator software installation information.


Software Requirements

The Solaris 8 10/01 and Solaris 9 Operating Systems, or a subsequent compatible version of the Solaris Operating System, is required on your system before installing the Sun XVR-1200 graphics accelerator software:



Note - If your system does not have the Solaris 8 10/01 Operating System installed, you must install it. Refer to the main Solaris installation manuals for this information.



Updated versions of Sun OpenGL for Solaris are available at:

http://www.sun.com/software/graphics/OpenGL/


Sun XVR-1200 Graphics Accelerator Software

Install the required software packages for your Solaris Operating System from the CD-ROM provided with your Sun XVR-1200 graphics accelerator installation kit. TABLE 2-1 lists the Sun XVR-1200 graphics accelerator CD directories:

TABLE 2-1 Sun XVR-1200 Graphics Accelerator CD-ROM Directories

Directory Name

Description

License

Binary Code License

XVR-1200/Solaris_8/Packages/

Solaris 8 graphics accelerator software packages

XVR-1200/Solaris_9/Packages/

Solaris 9 graphics accelerator software packages

XVR-1200/Solaris_8/Patches/

Solaris 8 graphics accelerator software patches

XVR-1200/Solaris_9/Patches/

Solaris 9 graphics accelerator software patches

Docs/

Sun XVR-1200 graphics accelerator documentation

Copyright

English version of copyright

FR_Copyright

French version of copyright

install

Product installation script

remove

Product removal script

OpenGL/(1.2.3 and 1.3)/Packages/

OpenGL packages


Software Package Locations

The Sun XVR-1200 graphics accelerator software packages are located in the directories listed in TABLE 2-2. If the CD is not already mounted, /cdrom/XVR-1200/ is the path.

TABLE 2-2 Location of Sun XVR-1200 Graphics Accelerator Software Packages

Software Packages

Directory Location

Solaris 8 software

/cdrom/cdrom0/XVR-1200/Solaris_8/Packages

Solaris 9 software

/cdrom/cdrom0/XVR-1200/Solaris_9/Packages


Software Packages

TABLE 2-3 lists the Sun XVR-1200 graphics accelerator software package names and descriptions.

TABLE 2-3 Sun XVR-1200 Graphics Accelerator Software Packages

Package Name

Description

SUNWjfbcf

Sun XVR-1200 Graphics Configuration Software

SUNWjfbmn

Sun XVR-1200 Graphics Manual Page

SUNWjfbr

Sun XVR-1200 Graphics System Software (Root)

SUNWjfbw

Sun XVR-1200 Graphics Window System Support

SUNWjfbx

Sun XVR-1200 Graphics System Software/Device Driver


Solaris Operating System Software Patches

TABLE 2-4 lists the patches required for the applicable Solaris Operating System.

TABLE 2-4 Patches for the Solaris Operating System

Patch

Location

114554-16

/cdrom/cdrom0/XVR-1200/Solaris_8/Patches

114555-16

/cdrom/cdrom0/XVR-1200/Solaris_9/Patches



Sun OpenGL for Solaris Software

The Sun XVR-1200 graphics accelerator is supported in Sun OpenGL Versions 1.2.3
and 1.3 and subsequent compatible Sun OpenGL versions, for Solaris Operating Systems.

Software Package Locations

TABLE 2-5 lists the directory locations of the Sun OpenGL for Solaris software packages.

TABLE 2-5 Location of Sun OpenGL for Solaris Software Packages

Sun OpenGL for Solaris Software Packages

Directory Location

Sun OpenGL 1.2.3 software

/cdrom/cdrom0/OpenGL/1.2.3/Packages/

Sun OpenGL 1.3 software

/cdrom/cdrom0/OpenGL/1.3/Packages/


Updated versions of Sun OpenGL for Solaris are available at:

http://www.sun.com/software/graphics/OpenGL/

Software Packages

TABLE 2-6 lists the Sun OpenGL 1.3 for Solaris software package names and descriptions.

TABLE 2-6 Sun OpenGL Version 1.3 Packages

Package Name

Description

SUNWgldoc

Sun OpenGL for Solaris Documentation and Man Pages

SUNWgldp

Sun OpenGL for Solaris Device Pipeline Support

SUNWgldpx

Sun OpenGL for Solaris 64-bit Device Pipeline Support

SUNWglh

Sun OpenGL for Solaris Header Files

SUNWglrt

Sun OpenGL for Solaris Runtime Libraries

SUNWglrtu

Sun OpenGL for Solaris Platform Specific Runtime Libraries

SUNWglrtx

Sun OpenGL for Solaris 64-bit Runtime Libraries

SUNWglsr

Sun OpenGL for Solaris Runtime Generic Software

SUNWglsrx

Sun OpenGL for Solaris 64-bit Optimized SW Rasterizer

SUNWglsrz

Sun OpenGL for Solaris Optimized SW Rasterizer


TABLE 2-7 lists the Sun OpenGL 1.2.3 for Solaris software package names and descriptions.

TABLE 2-7 Sun OpenGL Version 1.2.3 Packages

Package Name

Description

SUNWafbgl

Sun OpenGL for Solaris Elite3D support

SUNWafbgx

Sun OpenGL for Solaris 64-bit Elite3D support

SUNWffbgl

Sun OpenGL for Solaris Creator Graphics (FFB) Support

SUNWffbgx

Sun OpenGL for Solaris 64-bit Creator Graphics (FFB) Support

SUNWgfbgl

Sun OpenGL for Solaris Gfb Support

SUNWgfbgx

Sun OpenGL for Solaris 64-bit Gfb Support

SUNWgldoc

Sun OpenGL for Solaris Documentation and Man Pages

SUNWglh

Sun OpenGL for Solaris Header Files

SUNWglrt

Sun OpenGL for Solaris Runtime Libraries

SUNWglrtu

Sun OpenGL for Solaris Platform Specific Runtime Libraries

SUNWglrtx

Sun OpenGL for Solaris 64-bit Runtime Libraries

SUNWglsr

Sun OpenGL for Solaris Runtime Generic Software

SUNWglsrx

Sun OpenGL for Solaris 64-bit Optimized SW Rasterizer

SUNWglsrz

Sun OpenGL for Solaris Optimized SW Rasterizer

SUNWifbgl

Sun OpenGL for Solaris Expert3D/Expert3D-Lite/XVR-500 Graphics Support

SUNWifbgx

Sun OpenGL for Solaris 64-bit Expert3D/Expert3D-Lite/XVR-500 Graphics Support

SUNWjfbgl

Sun OpenGL for Solaris XVR-1200 Graphics Support

SUNWjfbgx

Sun OpenGL for Solaris 64-bit XVR-1200 Graphics Support


Sun OpenGL for Solaris Software Patches

TABLE 2-9 lists the patches required for Sun OpenGL 1.3 for Solaris.

TABLE 2-8 Patches for Sun OpenGL 1.3 for Solaris

Patch

Location

113886-21 (32-bit) or later

/cdrom/cdrom0/OpenGL/1.3/Patches

113887-21 (64-bit) or later

/cdrom/cdrom0/OpenGL/1.3/Patches


TABLE 2-9 lists the patches required for Sun OpenGL 1.2.3 for Solaris.

TABLE 2-9 Patches for Sun OpenGL 1.2.3 for Solaris

Patch

Location

112628-27 (32-bit) or later

/cdrom/cdrom0/OpenGL/1.2.3/Patches

112629-27 (64-bit) or later

/cdrom/cdrom0/OpenGL/1.2.3/Patches




Note - If your currently installed version of Sun OpenGL for Solaris does not include the -27 patch level, the Sun XVR-1200 graphics accelerator software installation script upgrades to the proper -27 patch level.





Note - Always check for the latest software patches at: http://sunsolve.sun.com/




Installing the Software

Use the install utility on the CD-ROM to install the Sun XVR-1200 graphics accelerator software. This utility installs necessary driver software and patches.

1. Log in as superuser.

2. Insert the Sun XVR-1200 graphics accelerator CD into the drive.



Note - The CD-ROM device might be different on your system. For example,
/dev/dsk/c0t2d0s2.



3. To install the Sun XVR-1200 graphics accelerator software, type:

# ./install

The following is displayed:

*** Checking if Sun XVR-1200 Graphics Accelerator support is already
    installed...
*** Checking for required OS patch(es) ...
*** Checking if Sun OpenGL is installed...
 
Select one of the following Sun OpenGL installation options:
1) Install Sun OpenGL 1.3
2) Install Sun OpenGL 1.2.3
3) Do not install Sun OpenGL
Select an option: 

The installation program checks if Sun XVR-1200 graphics accelerator software is already installed. If already installed, the following is displayed:

All required software for the Sun XVR-1200 Graphics Accelerator and
Sun OpenGL support is already installed.  No software will be 
installed at this time.

4. Select the Sun OpenGL for Solaris version and press Return.

The following is displayed. (Option 1, Sun OpenGL 1.3 for Solaris, is selected for this example on a Solaris 8 Operating System.)

*** Checking for required Sun OpenGL patch(es) ...
 
About to take the following actions:
- Install Sun XVR-1200 Graphics Accelerator support for Solaris 8
- Install Sun OpenGL 1.3
 
To cancel installation of this software, press 'q'.
Press any other key to begin installation: 

5. Press Return to begin installation.

When complete, the following is displayed:



Note - Depending on your system configuration, the actual output from the installation process may differ from what is shown below.



*** Installing Sun XVR-1200 Graphics Accelerator support for Solaris 8...
*** Installing Sun OpenGL 1.3...
*** Installation complete.

6. Shut down the system after the Sun XVR-1200 graphics accelerator software is installed:

# shutdown

See the shutdown(1M) and boot(1M) man pages for more details.

7. Go to Chapter 3 for information on installing the Sun XVR-1200 graphics accelerator hardware.

8. Boot your system at the ok prompt:

Halt (Stop-A) your system for the ok prompt.

ok boot -r



Note - After you complete the basic installation and configuration of your system, you can use the Sun Install Check Tool to check proper patches, software levels, and so on. Download tool at: http://www.sun.com/software/installcheck/index.html




Removing the Software

1. Log in as superuser.

2. Insert the Sun XVR-1200 graphics accelerator CD into the drive.

3. To remove the Sun XVR-1200 graphics accelerator software, become superuser and type:

# ./remove

The following list of options is displayed:

1) Remove Sun XVR-1200 Graphics Accelerator support
2) Remove Sun OpenGL
3) Remove All (Sun XVR-1200 Graphics Accelerator and Sun OpenGL)
4) Quit
Select an option: 

4. Select Option 3 to remove all listed software packages.

The following text is displayed:

About to take the following actions:
- Remove Sun XVR-1200 Graphics Accelerator support
- Remove Sun OpenGL
Press 'q' to quit, or press any other key to continue:

5. Press Return to start the removal process.

Once complete, the following is displayed and the program provides the location of a removal log:

*** Removing packages...
*** Done.  A log of this removal can be found at:
        /var/tmp/jfb.remove.2002.08.22


Man Pages

The Sun XVR-1200 graphics accelerator man pages describe how you can query and set frame buffer attributes such as screen resolutions and visual configurations.

Use the fbconfig(1M) man page for configuring all Sun graphics accelerators.
SUNWjfb_config(1M) contains Sun XVR-1200 device-specific configuration information. To get a list of all graphics devices on your system, type:

host% fbconfig -list

Use the fbconfig -help option to display the attributes and parameters information of the man page.

host% fbconfig -dev jfb0 -help

single-step bulletTo access the fbconfig man page, type:

host% man fbconfig

single-step bulletTo access the Sun XVR-1200 graphics accelerator man page, type:

host% man SUNWjfb_config