Tech Source RAPTOR DL-LITE - X11R6.1 FOR AIX... Installation and operating manual

Raptor DL-Lite X11R6.1 for AIX
Installation and Reference
Manual
Copyright 2005 Tech Source Inc.
442 S. North Lake Blvd.
Altamonte Springs, FL 32701
[phone]
Publication #65-0261-03 Rev A February 22, 2005

Addendum Information
Date Released February 22, 2005
Changes made to:
REVISION
NUMBER
CHANGES DATE
A Initial Release 02-22-05
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.

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 DL-Lite
card. 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
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
INVOKING X11R6.1 4-1
4.1 Overview 4-1
4.2 xinit 4-1
4.3 Setting Bit-Depth and Resolution 4-3
4.3.1. Setting Bit-Depth 4-3
4.3.1.1 STARSMODE Variable 4-4
4.3.1.2 Config File 4-4
4.3.2 Setting the Resolution 4-5
4.4 Enabling MOX Extension During X11R6.1 Server Startup 4-5
4.5 xdm 4-5
4.5.1 MOX Mode Using xdm 4-6
4.6 Common Desktop Environment (CDE) 4-7
4.6.1 MOX Mode Using CDE 4-7

TABLE OF CONTENTS
UNINSTALLING RAPTOR DL-Lite 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 - CARD SPECIFICATIONS A-1
A.1 Raptor DL-Lite Specifications A-1

1-1
Chapter 1
INTRODUCTION
1.1 Overview
This manual describes the installation for Raptor DL-Lite X11R6.1
for AIX. This software supports the following cards:
•Raptor DL-Lite
In this manual, the Raptor DL-Lite card will be referred to as the
“Raptor” card. 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 DL-Lite 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

Raptor DL-Lite X11R6.1 for AIX Installation Manual
1-2
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
DL-Lite 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

2-1
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 cards are:
•43P
•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.

Raptor DL-Lite X11R6.1 for AIX Installation Manual
2-2
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.
Step 4: Connect the Dual Link DVI cable from the Apple
HD panel to the Raptor DL-Lite card.
The Raptor card is now installed and the system is ready for
software installation. Refer to Chapter 3 for installing the Raptor
DL-Lite X11R6.1 for AIX software.

3-1
Chapter 3
SOFTWARE INSTALLATION
3.1 Requirements
The following are prerequisites for installing Raptor DL-Lite
X11R6.1 for AIX Software:
•The system is running AIX 4.3.3, AIX 5.1, AIX 5.2
•Any previous version of TSI software has already been
uninstalled. (Please refer to the manual that accompanied that
software for the appropriate uninstall procedure).
•41MB of disk space is available in /usr.
One or more of the cards listed in Section 1.1 is presently installed
in the workstation.
3.2 CD-ROM Installation
Installation of Raptor software can be done through SMIT. The
following are the step-by-step instructions for installing Raptor DL-
Lite X11R6.1 for AIX software from CD-ROM:
1. Install a Raptor card in the computer as described in
Chapter 2.
2. Login as root on the target install machine.
3. Uninstall any previous version of TSI software in
accordance with the instructions supplied with that
software.
The installation may fail if previous TSI software already
exists on the system.

Raptor DL-Lite X11R6.1 for AIX Installation Manual
3-2
4. Insert the CD-ROM labeled “Raptor DL-Lite X11R6.1 for
AIX" into the CD-ROM drive.
5. Mount the CD-ROM drive. To do this using SMIT, perform
the following steps:
•Select System Storage Management | File
Systems | Mount a File System
•In the File System Name box, select /dev/cd0
(or the location of your CD-ROM device)
•In the Directory to Mount box, select /cdrom
•In the Type of File System box, select cdrfs
•In the Mount as READ-ONLY file system box,
select yes.
6. Install the software. To do this using SMIT, perform the
following steps:
•Select Software Installation and Maintenance |
Install and Update Software
•Install Software
•In the Input Device/Directory for Software box,
select the appropriate directory below based on
the type of the system you use:
For 43P and 44P machines:
•/cdrom/power3
For IntelliStation Power 275:
•/cdrom/power4
•In the Software to Install box, make sure it says
“_all_latest”.

Chapter 3 – Software Installation
3-3
After installing the drivers, reboot the machine. Turn on the
machine and the AIX should now recognize the Raptor correctly.
You can verify this by entering the following command:
prompt% lsdisp
If a Raptor DL-Lite card is present in the system, this command
should return an entry like:
Note: The Raptor cards are identified by the operating system as
follows:
Raptor DL-Lite rapdlt#
Where # is an instance number assigned by the operating system.
3.3 Configuring the Raptor as LFT Display
In order to use the Raptor card as the LFT display, use the chdisp
command to change the current display device to the Raptor
device.
For Raptor DL-Lite, type the following:
prompt% chdisp [-d|-p] rapdlt0
DEV_NAME SLOT BUS ADPT_NAME DESCRIPTION
======== ==== === ========= ===========
rapdlt0 02 pci Raptor DL-Lite
Graphics
Adapter

Raptor DL-Lite X11R6.1 for AIX Installation Manual
3-4
Note: Use “-d” for temporary change of display until the next
reboot, or “-p” to make a permanent change of display
If the Raptor card is the only graphics device in the system, it will
automatically be configured as the default LFT (console) device.
3.4 Supported Resolutions
The resolution for Raptor DL-Lite is fixed at 2560x1600, for the
Apple LCD panel.

4-1
Chapter 4
INVOKING X11R6.1
4.1 Overview
There are several ways to invoke X11R6.1 on your system:
•xinit
•xdm
•Common desktop Environment (CDE)
•All of the above with MOX extension enabled
Important: For all these methods, there are some environment
variables that must be set. These can be set in your .cshrc file.
prompt% setenv X11R6HOME /usr/X11R6.1
prompt% setenv LD_LIBRARY_PATH \
$X11R6HOME/lib
prompt% set path=($X11R6HOME/bin $path)
The Xtsi server is provided in the $X11R6HOME/bin directory.
The examples used in this chapter refer to the device rapdlt0.
Your actual device name will vary according to the Raptor card type
and the instance number.
4.2 xinit
The xinit program can be directly used to start the X Window
System server. The xinit format is as follows:
xinit [[client] options] [ -- [server]
[display] options ]

Raptor DL-Lite X11R6.1 for AIX Installation Manual
4-2
If no specific client program is given on the command line, xinit
will look for a file in the user's home directory called .xinitrc to
run as a shell script to start up client programs. If no such file
exists, xinit will use the following as a default:
xterm -geometry +1+1 -n login -display :0
If no specific server program is given on the command line, xinit
will look for a file in the user's home directory called .xserverrc
to run as a shell script to start up the server. If no such file exists,
xinit will use the following as a default:
X :0
Note that this assumes that there is a program named Xin the
current search path. The X11R6.1 server in this software is called
Xtsi and is in the directory $X11R6HOME/bin. A symbolic link
has been made from Xto Xtsi.
To startup the server using xinit, type:
prompt% xinit -- $X11R6HOME/bin/Xtsi -P11 rapdlt0
You may add any other command line arguments to the end of the
line. For additional information on xinit, refer to the xinit man
page.
The X server can run in multi-screen mode. The example below
shows how to start on two Raptor DL-Lite cards:
prompt% xinit -- $X11R6HOME/bin/Xtsi –P11 rapdlt0
–P12 rapdlt1

Chapter 4 - Invoking X11R6.1
4-3
4.3 Setting Bit-Depth and Resolution
4.3.1 Setting Bit-Depth
Raptor cards support various bit-depths and overlay configurations.
This section describes the required settings for these
configurations. The default bit-depth for all Raptor cards is 8-bit.
The bit-depth of the Raptor DL-Lite can be set to 8-bit only, 8+24-
bit, 24-bit, mox16, mox24 or mox32 (see Table 2.)
Mode/Bit-Depth Description of Mode
8-bit 8-bit PseudoColor visual
8+24 mode One 8-bit visual + One 24-bit visual
(simultaneous)
24-bit 24-bit TrueColor visual only
mox16 mox mode w/16 planes
mox24 mox mode w/24 planes
mox32 mox mode w/32 planes
Table 2
An explanation of different MOX modes can be found in Section
4.4.
There are two ways to set bit-depth on the Raptor DL-Lite:
•By setting the environment variable STARSMODE
•By editing the config file /etc/X11/TSIScreenConfig

Raptor DL-Lite X11R6.1 for AIX Installation Manual
4-4
4.3.1.1 STARSMODE Variable
The bit-depth of the Raptor DL-Lite card can be set using the
STARSMODE environment variable. This variable should be set
before starting up the X server.
For example, set the bit-depth of the Raptor DL-Lite card to 8+24
prompt% setenv STARSMODE +8+24
To set the bit-depth of the Raptor DL-Lite card to mox16
prompt% setenv STARSMODE +mox16
Other bit-depths can be selected in a similar manner.
NOTE: In the case when both methods to set bit-depth are used,
the STARSMODE variable takes precedence over the settings in the
TSIScreenConfig file.
4.3.1.2 Config File
The depth of the Raptor DL-Lite card can be set using the
/usr/X11R6.1/etc/TSIScreenConfig file. Each row in the
file corresponds to a specific Raptor DL-Lite card that is identified
by its device name. The fields in each row are separated by
spaces. In the sample config file shown below the bit-depth of the
Raptor DL-Lite (rapdlt0) card is set to 8+24. The cached pixmap
field is used for debugging purposes only and should always be set
to 1. The other fields are discussed in 4.3.2.
# device Depth Resolution Sync Cached Resfile
pixmap
rapdlt0 8+24 DEFAULT 1 1 trzresinfo
The default visual in 8+24-bit mode is PseudoColor. In order to set
the default visual in the 8+24-bit mode to TrueColor, the X Server
should be started with command line option cc set to 4. The
example below shows how to set the default visual to TrueColor for
the card rapdlt0.

Chapter 4 - Invoking X11R6.1
4-5
#xinit -- $X11R6HOME/bin/Xtsi –Pll rapdlt0 –cc 4
NOTE: This method of setting the default visual has an effect only
in the 8+24-bit mode.
4.3.2 Setting the Resolution
The resolution of the Raptor DL-Lite cards is fixed at 2560x1600.
4.4 Enabling MOX Extension During
X11R6.1 Server Startup
By default, the X11R6.1 server starts in an 8-bit mode. However,
on Raptor DL-Lite cards you may start the X11R6.1 server with
MOX extension enabled. (Details of the MOX Extension to X
Server are in separate technical white paper documentation.)
These MOX modes are available on Raptor DL-Lite cards:
mox16 MOX, 8-bit Normal, 13-bit Group, 5-bit Absolute
mox24 MOX, 8-bit Normal, 21-bit Group, 13-bit Absolute
mox32 MOX, 8-bit Normal, 29-bit Group, 21-bit Absolute
To enable MOX on a Raptor card, set the bit-depth to one of the
MOX modes. Please refer to Section 4.3.1 for details.
4.5 xdm
The X Display Manager (xdm) program is used for running multiple
users on the same host machine. xdm provides services similar to
those provided by init, getty and login on character terminals
prompting for login name and password, authenticating the user,
and running a session. It provides a login window for each user or
selected users.
Several files that are required to start xdm are provided in the

Raptor DL-Lite X11R6.1 for AIX Installation Manual
4-6
directory $X11R6HOME/lib/X11/xdm. The configuration file
xdm-config contains references to the other files and is used to
specify other configuration parameters of xdm. The Xservers file
specifies the users (displays) that must get a login window.
The Xservers file will have individual lines to represent the X-
server startup on each of the display device on which an xdm login
screen is desired. Each startup line in Xservers file should be
modified to look like the following to enable the Raptor device
based xdm login screen:
:0 Local local-uid@console root \
/usr/X11R6.1/bin/Xtsi :0 –P11 rapdlt0
You may also add any other command line arguments to the end of
the line. For more information on xdm refer to the xdm man pages.
4.5.1 MOX Mode Using xdm
In order to enable MOX under xdm you must make use of the
StartWin script installed in /usr/X11R6.1/etc. The
Xservers file should be modified as follows:
:0 local /usr/X11R6.1/bin/StartWin:0
Additional command line options can be appended at the end of
this line. The following example StartWin script will start up the
X Server in mox24 mode.
#!/bin/sh
STARSMODE=+mox24
export STARSMODE
pass=“/usr/X11R6.1/bin/Xtsi”$*
exec $pass
NOTE: By default, the StartWin script starts up the X Server in
mox24 mode. It can be edited in order to support other MOX
modes.