C H A P T E R  2

Installing the Hardware and Software

This chapter provides Sun XVR-300 graphics accelerator hardware and software installation information.

Before Installation

Refer to the Solaris Handbook for Sun Peripherals that corresponds to your Solaris Operating System. The handbook describes how to shut down the system safely before installing any internal cards and how to reboot your system after installation.

Installing the Hardware

Refer to the hardware installation documentation provided with your Sun system for instructions on accessing your system and installing Sun PCI-Express graphics cards. Your system platform documentation also provides removal procedures.

To find the most recent information on supported systems for the Sun XVR-300 graphics accelerator, and additional specifications, go to:


Supported Systems and PCI-Express Slots

TABLE 2-1 lists the maximum number of Sun XVR-300 graphics accelerators for each Sun system supported.

For information on cabling DVI and HD15 (VGA) type monitor video ports, see Appendix A.

TABLE 2-1 Supported Systems and Maximum Number of Graphics Accelerators Per System


Maximum Number of Boards

Sun UltraTM 25 system


Sun Ultra 45 system


Sun FireTM V215 system


Sun Fire V245 system


Sun Fire V445 system


Note - If installing a Sun XVR-300 graphics accelerator in a Sun Fire V215, Sun Fire V245, or Sun Fire V445 system, refer to the system Release Notes for specific instructions and considerations.

procedure icon  To Replace the Full-Height Bracket With the Low-Profile Bracket

Your system might require replacing the Sun XVR-300 graphics accelerator full-height bracket with a low-profile bracket. The low-profile bracket is included in the installation kit.

1. Remove the two hexagon screws that secure the mounting bracket to the board assembly and set them aside (FIGURE 2-1).

Use a 1/8-inch hexagon socket screwdriver.

FIGURE 2-1 Replacing the I/O Bracket

Figure showing the two hexagon screw locations used when replacing the backplate.

2. Remove the full-height bracket by sliding the bracket off the board assembly DMS-59 video port connector.

3. Install the low-profile bracket by placing it on the board assembly in the same orientation.

4. Secure the bracket to the board assembly by replacing the two hexagon screws and tightening them.

Sun XVR-300 Graphics Accelerator Software

The Sun XVR-300 graphics accelerator software is bundled with the Solaris 9 9/05 HW and Solaris 10 11/06 Operating Systems. The minimum Solaris Operating System version required is Solaris 9 9/05 HW or Solaris 10 1/06 Operating Systems.

Install the Sun XVR-300 software from the CD-ROM provided with your Sun
XVR-300 graphics accelerator installation kit. TABLE 2-2 lists the Sun XVR-300 graphics accelerator CD-ROM directories:

TABLE 2-2 Sun XVR-300 Graphics Accelerator CD Directories

Directory Name



U.S. version of copyright


Sun XVR-300 graphics accelerator documentation


French version of copyright


Product installation script


Translated software licensing agreement


Listing of Sun XVR-300 graphics accelerator CD contents


Product removal script


Solaris 9 OS software packages


Solaris 10 OS software packages

Software Packages

Software Package Locations

The Sun XVR-300 software packages are located in the directories listed in TABLE 2-3.

TABLE 2-3 Location of Sun XVR-300 Software Packages

Software Packages

Directory Location

Solaris 9 OS software


Solaris 10 OS software


Software Package Names

TABLE 2-4 lists the Sun XVR-300 software package names and descriptions.

TABLE 2-4 Solaris 9 and 10 Software Package Names

Package name



Sun XVR-300 Graphics Configuration Software


Sun XVR-300 Graphics System Software Device Driver (64-bit)


Sun XVR-300 Graphics Window System Support


Sun XVR-300 Graphics Manual Pages

Note - Sun XVR-300 graphics accelerator drivers can be downloaded from the Sun Download Center.

Sun OpenGL for Solaris Software

The Sun OpenGL 1.5 for Solaris software supports the Sun XVR-300 graphics accelerator through software implementation.

If you require Sun OpenGL for Solaris to run certain applications, download the Sun OpenGL 1.3 for Solaris software from the following site:


TABLE 2-5 Sun OpenGL 1.5 for Solaris Software Patches

Patch Number


120812-12 or later

Sun OpenGL 1.5 for Solaris

Sun OpenGL 1.3 for Solaris Patches

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

TABLE 2-6 Sun OpenGL 1.3 for Solaris Software Patches

Patch Number


113886-38 or later

Sun OpenGL 1.3 for Solaris, 32-bit

113887-38 or later

Sun OpenGL 1.3 for Solaris, 64-bit

Download these patches from the following site:


Updated versions of Sun OpenGL for Solaris are located at:


Installing the Software

procedure icon  To Install the Software

1. After installing a Sun XVR-300 graphics accelerator into your system, boot your system at the ok prompt:

ok boot

2. Log in as superuser.

3. Insert the Sun XVR-300 graphics accelerator CD-ROM into the drive.

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

4. Run the installation script. Type:

# ./install

The following Sun Entitlement information is displayed:

Sun Microsystems, Inc. ("Sun") ENTITLEMENT for SOFTWARE
Licensee/Company: Entity receiving Software
Effective Date:  Date Sun delivers the Software to You.
Software: "Software" means all software provided to You to be used with
the Host.
Host: The hardware product described in the Software's documentation
with which the Software is intended to be used.
Do you accept the license agreement? [y/n]: y

At the end of the licensing agreement information, you are asked to accept it.

5. Type y and Return, to accept the license agreement.

The following is displayed.

In this example, using the Solaris 10 Operating System, the following is displayed:

Installing SUNWnfb SUNWnfbcf SUNWnfbw SUNWnfbmn for Solaris 10 ...
*** Installation of drivers is complete.
To uninstall this software, use the 'uninstall' script on this CDROM, or
the following script:
A log of this installation can be found at:
To configure a Sun XVR-300 accelerator, use the fbconfig
utility.  See the fbconfig(1m) and SUNWnfb_config(1m) manual
pages for more details.
This system must be rebooted for the new software to take effect.
Reboot this system as soon as possible using the shutdown command and the
'boot -r' PROM command (see the shutdown(1M) and boot(1M) manual
pages for more details).

You can use the following command to check if the Sun XVR-300 graphics accelerator is already on your system. Type:

# /usr/bin/pkginfo | grep SUNWnfb

6. Do a reconfiguration reboot of your system at the ok prompt to complete the installation:

ok boot -r

procedure icon  To Remove the Software

1. Log in as superuser.

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

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

3. To remove Sun XVR-300 software, type:

# ./uninstall

In this example, the following is displayed.

Removal of Sun XVR-300 Graphics Accelerator software is complete.
A log of this removal is at:

Default Console Display

Note - The DMS-59 - 2xDVI-I adapter splitter cable for the Sun XVR-300 graphics accelerator has two DVI-I video ports, but only the monitor DVI-I number "1" video port can be console.

procedure icon  To Set the Sun XVR-300 Graphics Accelerator as the Default Monitor Console Display

1. At the ok prompt, type:

ok show-displays

The following shows how to set the console device:

a) /pci@1f,700000/SUNW,XVR-300@0
b) /pci@1e,600000/pci@0/pci@8/SUNW,XVR-300@0
Enter Selection, q to quit:

2. Select the graphics accelerator you want to be the default console display.

In this example, you would select b for the Sun XVR-300 graphics accelerator.

Enter Selection, q to quit: b
/pci@1e,600000/pci@0/pci@8/SUNW,XVR-300@0 has been selected.
Type ^Y ( Control-Y ) to insert it in the command line.
e.g. ok nvalias mydev ^Y
	 for creating devalias mydev for 

3. Create an alias name for the Sun XVR-300 graphics accelerator device.

This example shows mydev as the alias device name.

ok nvalias mydev

Press Control-Y, then Return.

4. Set the device you selected to be the console device.

ok setenv output-device mydev

5. Store the alias name that you have created.

ok setenv use-nvramrc? true

6. Reset the output-device environment:

ok reset-all

7. Connect your monitor cable to the Sun XVR-300 graphics accelerator on your system back panel.

Man Pages

The Sun XVR-300 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.
SUNWnfb_config(1M) contains Sun XVR-300 device-specific configuration information. To get a list of all graphics devices on your system, type:

host% fbconfig -list

This example shows a list of graphics devices displayed:

  Device-Filename              Specific Config Program
  ---------------              -----------------------
  /dev/fbs/nfb0                SUNWnfb_config

procedure icon  To Display Man Pages

single-step bulletUse the fbconfig -help option to display the attributes and parameters information of the man page.

host% fbconfig -dev nfb0 -help

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

host% man fbconfig

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

host% man SUNWnfb_config