This chapter provides Sun PGX64 hardware and software installation information.

---

Before Installation

Refer to the Solaris Handbook for Sun Peripherals that corresponds to your operating environment. 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 graphics cards.

System PCI Slots

Up to four PGX64 graphics cards are supported on Sun systems that support four or more PCI slots. TABLE 2-1 lists the maximum number of PGX64 graphics cards supported on Sun systems, including the maximum number of UPA bus graphics cards allowed in systems using the PGX64 card.

Video Adapter Cable

The PGX64 graphics card installation kit provides a Sun HD15-to-13W3 video adapter cable. This cable is used to connect the HD15 video output connector of the PGX64 graphics card to Sun monitor displays with a 13W3 captive cable or 13W3 video input connector.

---

Installing the PGX64 Software

The following Solaris platforms support the Sun PGX64 graphics card:

• Solaris 2.5.1 operating environment
• Solaris 2.6 operating environment
• Solaris 7 operating environment
• Solaris 8 operating environment

You must install the required software packages or software patches for your system Solaris operating environment. Install the Sun PGX64 software from the CD-ROM provided with your Sun PGX64 installation kit. TABLE 2-2 lists the PGX64 CD-ROM directories:

Sun PGX64 Software Packages

Software Package Locations

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

Software Package Names

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

Sun PGX64 Software Patches

TABLE 2-5 lists the Sun PGX64 software patches required for Solaris 2.5.1, Solaris 2.6, Solaris 7 and Solaris 8 operating environments.

Installing the Software

1. After installing a Sun PGX64 card into your system, boot your system at the ok prompt:

ok boot -r

2. Log in as superuser.

3. Insert the PGX64 CD-ROM into the drive.

• If the drive is already mounted, type the following, and go to Step 4:

# cd /cdrom/cdrom0

• If the CD-ROM is not already mounted, type:

# mount -F hsfs -O -o ro /dev/dsk/c0t6d0s0 /cdrom # cd /cdrom

4. Install the PGX64 software.

a. Determine the installation method for installing the software.

Check to see if PGX64 software already exists on your system. Type:

# /usr/bin/pkginfo | grep m64

If previously installed, the following list of software packages is displayed.

SUNWm64   M64 System Software (Device Driver)

SUNWm64cf M64 Graphics Configuration Software

SUNWm64w  M64 Window System Support

SUNWm64x  M64 Graphics System Software/Device Driver (64-bit)

SUNWm64xr M64XR System Software (Device Driver Config.)

b. If there are no previous versions of PGX64 installed, go to the software package location and run the pkgadd program:

# cd /cdrom/cdrom0/Solaris_X
/Packages

# pkgadd -d . *

where Solaris_X is the Solaris operating environment on your system. Follow the prompts of the pkgadd program. This procedure is the same when adding a second PGX64 card to your system.

c. If a previous version of PGX64 software is installed on systems running the Solaris 2.5.1 operating environment, go to the software patch location and run the installpatch program:

# cd /cdrom/cdrom0/Solaris_2.5.1/Patches/103792-29

# ./installpatch `pwd`

d. If a previous version of PGX64 software is installed on systems running
Solaris 2.6, Solaris 7, Solaris 8 (but not Solaris 8 Update 4 or later releases) operating environments, go to the software patch location and run the patchadd program.

# cd /cdrom/cdrom0/Solaris_X
/Patches/patch_number

# /usr/sbin/patchadd `pwd`

where Solaris_X is the Solaris operating environment on your system, and patch_number is the patch (TABLE 2-5) for your Solaris operating environment.

5. Reboot the system to complete the installation:

ok boot -r

Patching Network Installation Image

These instructions describe how to apply PGX64 patches to network images for Solaris 2.5.1, Solaris 2.6, Solaris 7, and Solaris 8 operating environments.

1. After installing the Sun PGX64 card into your system, boot your system at the ok prompt:

ok boot -r

2. Log in as superuser.

3. Insert the PGX64 CD-ROM into the drive.

4. Choose the correct Solaris operating environment where you will apply the patch to network install image.

5. To apply the PGX64 software patches for the network install image, go to the PGX64 Tools directory location and set the path to the network image directory:

# cd /cdrom/cdrom0/Tools

# ./pgx64_patch_netimage -r x.x
 -d path to net image directory

where x.x is the Solaris operating environment on your system by revision number only (for example, type "2.6" and not "Solaris 2.6"), and path to net image directory is the directory to the network image directory.

6. Continue to perform the standard network installation procedure.

---

Removing Sun PGX64 Software

1. To remove Sun PGX64 software, become superuser and type:

# /usr/bin/pkginfo | grep m64

The following list of software packages is displayed.

system      SUNWm64   M64 System Software (Device Driver)

application SUNWm64cf M64 Graphics Configuration Software

application SUNWm64w  M64 Window System Support

system      SUNWm64x  M64 Graphics System Software/Device Driver (64-bit)

system      SUNWm64xr M64XR System Software (Device Driver Config.)

2. Use pkgrm to remove the software packages listed. Type:

# /usr/sbin/pkgrm SUNWm64 SUNWm64cf SUNWm64w SUNWm64x SUNWm64xr

For Solaris 2.5.1 operating environments, include the SUNWm64mn package and exclude the SUNWm64x package. Type:

# /usr/sbin/pkgrm SUNWm64 SUNWm64cf SUNWm64w SUNWm64mn SUNWm64xr

---

Sun PGX64 Default Console Display

To set the Sun PGX64 graphics card 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,0/pci@5/TSI,gfxp@2

b) /pci@1f,0/pci@5/SUNW,m64B@1

c) /pci@1f,0/pci@5/SUNW,Expert3D-Lite@0

q) NO SELECTION 

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

In this example, you would select b for the Sun PGX64 card.

Enter Selection, q to quit: b

/pci@1f,0/pci@5/SUNW,m64B@1 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 /pci@1f,0/pci@5/SUNW,m64B@1

3. Create an alias name for the Sun PGX64 device.

This example shows mydev as the alias device name.

ok nvalias mydev <Control-Y> <ENTER>

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

7. Connect your monitor cable to the Sun PGX64 card on your system back panel.

---

Accessing the English and Localized Documentation

The PGX64 CD-ROM contains the Sun PGX64 Graphics Card Installation Guide in the following languages:

• English
• French
• German
• Spanish
• Italian
• Swedish
• Japanese
• Korean
• Simplified Chinese
• Traditional Chinese

All localized documentation is contained in the following directory: /cdrom/cdrom0/Docs/ language . For example, the localized Italian installation guide is located at: /cdrom/cdrom0/Docs/it/