Tech Source Raptor X11R6.1 User Manual

Raptor X11R6.1 for AIX

Installation Manual

Publication #65-0205-01 Rev F September 23, 2004

Copyright  2004 Tech Source Inc.

442 S. North Lake Blvd.

Altamonte Springs, FL 32701

[phone]

Addendum Information

Date Released September 23, 2004

Changes made to:

REVISION
NUMBER

A

B

C

D

E

F

The Tech Source logo, Tech Source and Tech Source Raptor are
trademarks of Tech Source, Inc. X Window System is a trademark
and product of X.org.

All other products or services mentioned in this document are
identified by the trademarks or service marks of their respective
companies or organizations. Tech Source, Inc. disclaims any
responsibility for any references to those trademarks herein.

CHANGES

Initial Release

Adding Stars Support

Minor updates

Name of card changed from STARS
2K to Raptor 2000. Deleted the DB
chapter (not required anymore).
Other minor enhancements including
MOX info.

Support for Raptor 2000-AIX Cards

Support for T-Class Cards & AIX 5

DATE

10-23-96

07-01-98

07-10-98

03-28-00

07-18-02

09-23-04

All rights reserved. No part of this work may be reproduced in any
form or by any means without prior written permission of the
copyright owner.

RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by
the U.S. Government is subject to restrictions of FAR 52.227­14(g)(2)(6/87) and FAR 52.227-19 (6/87); or DFAR 252.227­7015(b)(6/95) and DFAR 227.7202-3(a).

The product described in this manual may be protected by one or
more U.S. patents, foreign patents, and/or pending patent
applications.

PREFACE

This publication documents the Tech Source Raptor X11R6.1 for
AIX Installation for use with the Tech Source, Inc. Raptor 2000 and
2100T cards. This manual is intended for users who incorporate
the Tech Source Raptor cards into IBM RS/6000 workstations
running AIX operating systems.

This is a guide to the installation of the Raptor software. All
systems vary to a degree. Knowledge of the features of your
system and an understanding of UNIX shell scripts are helpful
during the installation process.

WARRANTY

The Raptor cards are warranted for one (1) year from date of
shipment. During the warranty period, Tech Source, Inc. will, at its
discretion, repair or replace a defective component at its expense.

Freight charges associated with the repair or replacement of
components under warranty are to be shared by Tech Source, Inc.
and the customer. All customers, domestic and international, shall
bear the freight charges for the product return. Tech Source, Inc.
shall bear the outbound freight charges up to $13.00 (USD) per
returned product, whether domestic or international. Any additional
freight charge shall be the responsibility of the customer. We
suggest that you contact your dealer first with any questions you
may have about the product. Unlimited technical support (via
telephone/facsimile/email) is provided for one (1) year from date of
shipment. The installation of any Tech Source, Inc.
hardware/software product is the sole responsibility of the customer.

Tech Source, Inc. offers a continuing hardware/software support
program that provides telephone consultation and any required
hardware repair after the expiration of the warranty period. This is a
billable annual maintenance contract. Contact Tech Source, Inc. for
the available maintenance plans.

Customers will be charged an hourly rate plus materials ($300.00
USD minimum) for repairs and/or maintenance performed by Tech
Source, Inc. that are not covered by a Tech Source, Inc. warranty or
maintenance contract.

DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESSED
OR IMPLIED CONDITIONS, REPRESENTATIONS AND
WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE
EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE
LEGALLY INVALID.

TABLE OF CONTENTS

INTRODUCTION 1-1

1.1 Overview 1-1

1.2 MOX Extension Support 1-2

1.3 Conventions 1-2

HARDWARE INSTALLATION 2-1

2.1 Hardware Configurations Supported 2-1

2.2 Installation Instructions 2-1

2.3 Installation of the Raptor 2500 FPS 2-2

2.4 Installation of the Raptor 2100 FPS 2-4

SOFTWARE INSTALLATION 3-1

3.1 Requirements 3-1

3.2 CD-ROM Installation 3-1

3.3 Configuring the Raptor as LFT Display 3-3

3.4 Supported Resolutions 3-4

3.4.1

3.4.2 Raptor 1100T 3-4

3.4.3 Raptor 2500T 3-4

INVOKING X11R6.1 4-1

4.1 Overview 4-1

4.2 xinit 4-1

4.3 Setting Bit-Depth and Resolution 4-3

Raptor 2000-24M, Raptor 2000-24M AIX, Raptor 2100T 3-4

4.3.1. Setting Bit-Depth 4-3

4.3.1.1 Setting Bit-Depth on Raptor 2000 4-3

4.3.1.2 Setting Bit-Depth on T-Class Cards 4.4

4.3.1.2.1 STARSMODE Variable 4.4

4.3.1.2.2 Config File 4.5

4.3.2 Setting the Resolution 4-6

4.4 Enabling MOX Extension During X11R6.1 Server Startup 4-7

TABLE OF CONTENTS

4.5 xdm 4-7

4.5.1 MOX Mode Using xdm 4-8

4.6 Common Desktop Environment (CDE) 4-9

4.6.1 MOX Mode Using CDE 4-9

UNINSTALLING RAPTOR X11R6.1 FOR AIX 5-1

5.1 Uninstall Using SMIT 5-1

TECHNICAL ASSISTANCE 6-1

6.1 Who to Call For Help 6-1

6.2 Email Address 6-1

6.3 Website 6-2

APPENDIX A A-1

A.1 Raptor 2100T Specifications A-1
A.2 Raptor 2500T Specifications A-2
A.3 Raptor 2000-12M Specifications A-3
A.4 Raptor 2000-24M Specifications A-4
A.5 Raptor 2000-24M AIX Specifications A-5
A.6 Raptor 1100T Specifications A-6

Chapter 1

INTRODUCTION

1.1 Overview

This manual describes the installation for Raptor X11R6.1 for AIX.
This software supports the following cards:

• Raptor 2000-24M

• Raptor 2000-12M

• Raptor 2000-24M AIX

• Raptor 1100T

• Raptor 2100T

• Raptor 2500T

In this manual, the cards will be collectively referred to as “Raptor”.
The Raptor 2000-12M, 2000-24M and Raptor 2000-24M AIX will be
referred to as Raptor 2000. The Raptor 1100T, Raptor 2100T and
Raptor 2500T will be referred to as Raptor T-Class. Knowledge of
the AIX operating system and the SMIT installation tool will be
useful during this installation. The AIX versions currently supported
are AIX 4.3.3, AIX 5.1 and AIX 5.2.

From this point forward, Tech Source, Inc. will be referred to as
Tech Source or TSI.

The software is provided on a CD-ROM and consists of the
following:

• Tech Source Raptor device-drivers for AIX

• X11R6.1 binary distribution (clients, libraries, fonts, etc.)

• X11R6.1 server for Tech Source Raptor cards

• MOX (Multiple Overlay eXtension) Client libraries, include files

and examples

1-1

Raptor X11R6.1 for AIX Installation Manual

Note: Before installing this software, you must uninstall any
previous versions of the software.

1.2 MOX Extension Support

Tech Source supports an X-server extension called MOX (Multiple
Overlay eXtension) on the Raptor graphics cards. The underlying
software (available as a server extension and a client library)
needed for MOX support has been included as a part of this Raptor
X11R6.1 for AIX software product. Enabling of this extension
during the X-server startup is described in Section 4.4.

1.3 Conventions

This manual will follow certain conventions throughout.

Whenever a variable name, command name, directory, or filename
is used in a paragraph they will appear in a mono-spaced font.

At times the reader will be instructed to enter commands at a
prompt. In this case a transcript of a sample session will be
provided where a prompt similar to one the reader might see will be
followed by the commands the reader is to enter. The entire
transcript will be in a mono-spaced font with the prompt in a
normal weight and the user's entries in bold.

The prompt used in a transcript varies depending on the
circumstances. The following are some common prompts and
when they are used:

prompt# used when the user is required to have root

privileges

prompt% used when the user is not required to have root

privileges

ok prompt displayed when the user is in Boot PROM

mode

1-2

Chapter 2

HARDWARE INSTALLATION

2.1 Hardware Configurations Supported

The software has been tested on and currently supports IBM
RS/6000 systems (with PCI slots), running in single and multi­screen configurations. The RS/6000 systems currently tested on
Raptor 2000 cards are:

• 43P

• 44P

• IntelliStation Power 275

The RS/6000 systems currently tested on Raptor T-Class cards are:

• 44P

• IntelliStation Power 275

This chapter discusses the installation of Raptor cards in one of
these machines. Please contact Tech Source if you have
installation issues on a different machine.

2.2 Installation Instructions

The Raptor card installation is simple and consists of a few easy
steps. These installation instructions presume that you are familiar
with the AIX operating system.

2-1

Raptor X11R6.1 for AIX Installation Manual

NOTE: Remember which cables go to which connectors. You may
want to label the cables and connectors before disconnecting them.

Step 1: Shutdown the system and turn the power OFF,

remove the system’s cover, find an available PCI
Local Bus slot, and remove the bracket and screw.

Ground yourself by touching the metal part on the
case.

Step 2: Install the Raptor card firmly into the PCI Local

Bus slot. Take care to press it evenly and snugly
into the slot. Once you are certain the card is
installed properly in the slot, secure it with the
bracket screw.

Step 3: Secure the system’s cover, attach any previously

removed cables, and connect the video cable to
your monitor.

The Raptor card is now installed and the system is ready for
software installation. Refer to Chapter 3 for installing the Raptor
X11R6.1 for AIX software. Sections 2.3 and 2.4 describe the cable
connections for the Raptor FPS configurations.

2.3 Installation of the Raptor 2500 FPS

The Raptor 2500 FPS Digital Flat Panel subsystem is comprised of
the Raptor 2500T graphics card (configured for 2560x2048
resolution), the Tech Source 2500 FPS digital flat panel, along with
associated cables and software. The Raptor 2500T graphics card
is connected to the Tech Source 2500 FPS digital flat panel using a
cable as shown in Figure 2-1.

2-2

Raptor X11R6.1 for Solaris Installation Manual

The Raptor 2500T card has one connector on the front bracket.
One side of the provided cable has the LFH60 connector that
connects to the graphics card. The cable splits into two with
MDR26 connectors on the opposite end. These two connectors
marked A & B get connected to the appropriately marked
connectors on the back of the digital flat panel. They are shown in

Figure 2-1.

Figure 2-1 – 2500 FPS Digital Flat Panel Subsystem

2-3

Raptor X11R6.1 for AIX Installation Manual

2.4 Installation of the Raptor 2100 FPS

The Raptor 2100 FPS is comprised of the Raptor 2500T graphics
card (configured for 2048x2048 resolution) and the Tech Source
2100 FPS digital flat panel, along with associated cables and
software. The subsystem is connected together as shown in Figure
2-2.

A B

Figure 2-2 – 2100 FPS Digital Flat Panel Subsystem

The Raptor 2500T card has one connector on the front bracket.
One side of the provided cable has the LFH60 connector that
connects to the graphics card. The cable splits into two with
MDR26 connectors on the opposite end. These two connectors
marked A & B get connected to the appropriately marked
connectors on the back of the digital flat panel. They are shown in
Figure 2-2. On some models of the digital flat panel, the
connectors may be recessed. In this instance, please remove the
back panel, plug the cables into the two marked connectors and
restore the back panel.

2-4