This chapter describes how to install the Triple Keyboard Option (TKO) in an InfiniteReality (IR) chassis. The installation procedure is divided into the following steps:
Preparing the chassis
Attaching the IO4 daughtercards
Installing the TKO filter panels on the cardcage 2 I/O door
Attaching the ribbon cables
Cabling the keyboards
Cabling the serial ports
Restarting the system
Configuring the TKO
Testing the new installation
Other Silicon Graphics manuals contain instructions for exchanging circuit boards. Make sure you have the appropriate one(s):
CHALLENGE™/Onyx Rackmount Installation Instructions (108-7042-xxx)
CHALLENGE and Onyx Retrofit Instructions (domestic version: 802-0107-002; international version: 802-0106-002)
Challenge/Onyx Rackmount Third Cardcage (CC3) Upgrade Instructions (release note, 802-0105-xxx)
Make sure you have other pertinent release notes and Field Information Bulletins as well.
You need a flat-blade screwdriver and a Phillips screwdriver to install TKO.
 | Caution: Board components are extremely sensitive to electrostatic discharge. Use proper antistatic procedures while handling the board. |
Before you install the option, follow these steps:
Make sure all users are off the target system. Gracefully shut down the system and open the chassis to expose the slots.
In order for the kernel to recognize the TKO option, the three IO4 boards must be in slots 11, 9, and 7 of cardcage 2. While the base IO4 board (board #0) will always be in slot 11, it is possible that the additional boards (board #1 and board #2) will need to be moved.
A processor board, existing options, or both might have to be moved to allow the additional IO4 boards to be placed in slots 9 and 7. For example, one of the processor boards or a memory board can be moved to cardcage 1 if it has an appropriate vacant slot.The TKO's two panels are installed on the cardcage 2 I/O door; plan where to install them. To avoid interfering with removal of boards, they should not be installed in the bottom row of slots. Figure 2-1 diagrams this placement.
Figure 2-2 diagrams a complete example installation.
The TKO includes two daughtercards, one for each additional IO4 board in the system. To attach the daughtercards, follow these steps:
Remove the "second" IO4 board (board #1) from slot 9 in cardcage 2.
Attach one of the daughtercards to the small edge connector on the "second" IO4 board (the only edge connector that fits the daughtercard). The connector is located on the side farthest from the LEDs. See Figure 2-3.
Reinsert the IO4 you removed from the chassis into slot 9 in cardcage 2.
Remove the "third" IO4 board (board #2) from slot 7 in cardcage 2.
Attach the remaining daughtercard to the small edge connector on the "third" IO4 board as shown in Figure 2-3.
Reinsert the IO4 you removed from the chassis into slot 7 in cardcage 2.
TKO I/O for the additional keyboards is handled on two filter panels installed on the cardcage 2 I/O door.
The filter panel assemblies themselves are identical, but must be differentiated by means of labels, because each filter panel is cabled to a specific IO4 and a specific graphics pipe, as outlined in Table 2-1. If necessary, refer to the layout diagrammed in Figure 2-2.
Table 2-1. Filter Panel Cabling
Filter Panel Label | To Be Cabled to IO4 (Ribbon Cable) | Associated with | Suggested Placement |
|---|---|---|---|
AUX KBD 1 | #1 ("second") | 1 (cardcage 3) | L eft or bottom
|
AUX KBD 2 | #2 ("third") | 2 (cardcage 3) | Right or top |
Follow these steps:
Attach a label to each filter panel. Figure 2-4 shows the position on the panel where the label should be applied.
On the cardcage 2 I/O door, remove the slot covers for the slots you have selected for the TKO I/O panels. Retain the screws.
Note: Do not use the bottom row of slots. Panels installed there make it difficult to remove boards. Position the filter panel labeled AUX KBD 1 on the bottom or left slot (as viewed with the I/O door closed); use the retained screws to mount it.
Position the filter panel labeled AUX KBD 2 on the top or the right slot (as viewed with the I/O door closed) whose cover you have removed; use the retained screws to mount it. Figure 2-5 shows the filter panels installed.
Ribbon cables connect the daughtercards on the "second" and "third" IO4 boards to the TKO filter panels. (Of course, the primary IO4 board's ribbon cable is already attached to the I/O panel below cardcage 2.) Follow these steps:
Attach one end of a ribbon cable to the connector on the daughtercard on the "second" IO4. The connectors on the ribbon cables are keyed. Attach the other end to the bottom or leftmost filter panel on the cardcage 2 I/O door, as viewed with the I/O door closed. This should be the filter panel labeled AUX KBD 1.
Attach one end of the second ribbon cable to the connector on the daughtercard on the "third" IO4. Attach the other end to the top or rightmost filter panel on the cardcage 2 I/O door (as viewed with the I/O door closed). This should be the filter panel labeled AUX KBD 2. Figure 2-6 shows the ribbon cables installed.
Determine where the customer wants the additional monitors, keyboards, and mice, and place them there. Make sure there is agreement on the numbering of the monitor and keyboard combinations.
The standard (suggested) configuration is summarized in Table 2-2.
Table 2-2. Cabling Keyboards for TKO
Keyboard | Cabling |
|---|---|
0 (Original) | Leave cabled as is to the original I/O panel, which is internally cabled to graphics head 0 |
1 | Keyboard connector on the bottom or leftmost filter panel (AUX KBD 1) on the cardcage 2 I/O door, which is internally cabled to second IO4 and graphics head 1 |
2 | Keyboard connector on the top or rightmost filter panel (AUX KBD 2) on the cardcage 2 I/O door, which is internally cabled to optional third IO4 and graphics head 2 |
Attach keyboard and monitor extension cables to the appropriate connectors on the I/O panels. Figure 2-7 diagrams attachment of the external keyboard and monitor cables.
The main I/O panel on the Onyx rackmount provides two types of ports for RS-232 peripherals—a 9-pin sub-D and a round 8-pin DIN connector. On the main I/O panel, these connectors are arranged one above the other; a bracket on the silkscreen links the two types of ports to indicate that only one should be used and not both.
However, the TKO filter panels have only the round 8-pin DIN connectors for powered peripherals (TTY 46 and TTY 47 on the TKO filter panel with AUX KBD 1, and TTY 50 and TTY 51 on the TKO filter panel with AUX KBD 2). The corresponding 9-pin sub-D connectors are on the standard I/O panels for the second and third IO4s. Although for the second and third IO4s the two types of serial ports are on separate panels, still only one or the other type of port can be used at one time, not both, just as in the case of the main I/O panel.
Table 2-3 summarizes serial port correspondences.
Table 2-3. Serial Port Correspondences
Round 8-pin DIN Connector Label | Corresponds to: | Sub-D Connector Label |
|---|---|---|
AUX KBD 1 panel: TTY_46 |
| I/O panel for "second" IO4: TTY_46 |
AUX KBD 1 panel: TTY_47 |
| I/O panel for "second" IO4: TTY_47 |
AUX KBD 2 panel: TTY_50 |
| I/O panel for "third" IO4: TTY_50 |
AUX KBD 2 panel: TTY_51 |
| I/O panel for "third" IO4: TTY_51 |
| Note: Use the serial port listed in one column or the other, not both. For example, if you use the round 8-pin DIN connector for TTY 46 on the AUX KBD 1 panel, do not also use the 9-pin sub-D for TTY 46 on the I/O panel connected to the "second" IO4. |
Figure 2-8 shows serial port usage.
Some systems may not have the input device files preconfigured. To check for this, type:
ls -l /dev/input1 |
You should see both a keyboard and a mouse device listed. If instead you see something like:
Cannot access /dev/input1: No such file or directory |
then you will need to create the device files. To do this, become root and type:
cd /dev ./MAKEDEV ttys |
This will create /dev/input1 and /dev/input2.
The base version of IRIX 6.2 supports the triple keyboard option. There is thus no OS upgrade required as part of the TKO for IR installation.
IRIX 6.2 includes an example version of the xdm Xservers configuration file. This example file is located in the /var/X11/xdm directory, and is called Xservers.3key. The standard three-keyboard operation described in this chapter is mapped as follows:
graphics pipe 0 and main keyboard operating as X server :0
graphics pipe 1 and auxilliary keyboard 1 operating as X server :1
graphics pipe 2 and auxilliary keyboard 2 operating as X server :2
To set up IRIX for this operation, follow these steps:
Move /var/X11/xdm/Xservers to /var/X11/xdm/Xservers.1key:
mv /var/X11/xdm/Xservers /var/X11/xdm/Xservers.1key
Copy /var/X11/xdm/Xservers.3key to /var/X11/xdm/Xservers:
cp /var/X11/xdm/Xservers.3key /var/X11/xdm/Xservers
To enable the new xdm configuration file, rlogin, or log in through a serial port, and type as root:
/usr/gfx/stopgfx /etc/killall xdm /usr/gfx/startgfx
To set up the software for a different configuration, edit /var/X11/xdm/Xservers, as explained in Section 2.9.
IRIX includes both a single-keyboard default file, /var/X11/xdm/Xservers, and a triple-keyboard example file, /var/X11/xdm/Xservers.3key. The Xservers.3key file shows a three-keyboard graphics-pipe/keyboard/X server configuration.
You can copy the Xservers.3key file to /var/X11/xdm/Xservers (as described in Section 2.8), or edit the Xservers file to include the configuration you want.
| Note: The /var/X11/xdm/Xservers file contains the only copy of the standard single-keyboard mapping. It is therefore recommended that you copy it to Xservers.1key before overwriting it with the contents of the Xservers.3key file. |
The Xservers and Xservers.3key files differ in the line(s) specifying X server configuration. The standard /var/X11/xdm/Xservers file has one line defining the X server configuration:
:0 secure /usr/bin/X11/X -bs [...] |
The /var/X11/xdm/Xservers.3key file has three lines defining the X server configuration:
:0 secure /usr/bin/X11/X :0 -boards 0 -devdir /dev/input -bs [...] :1 secure /usr/bin/X11/X :1 -boards 1 -devdir /dev/input1 -bs [...] :2 secure /usr/bin/X11/X :2 -boards 2 -devdir /dev/input2 -bs [...] |
These lines start three X servers, one for each keyboard/graphics-pipe pair in the system. The -boards n parameter specifies the graphics pipe(s) to be used by the respective X server.
The configuration in Xservers.3key matches the standard hardware configuration described in Section 2.8. The main keyboard and graphics pipe 0 are associated with the X server at :0. Auxilliary keyboard 1 and graphics pipe 1 are associated with the X server at :1. Auxilliary keyboard 2 and graphics pipe 2 are associated with the X server at :2.
If the customer wants a different configuration, edit the /var/X11/Xdm/Xservers file. For example, the following lines associate the main keyboard and graphics pipe 0 with the X server at :0, and associate auxiliary keyboard 1 and graphics pipes 1 and 2 with the X server at :1.
:0 secure /usr/bin/X11/X :0 -boards 0 -devdir /dev/input -bs [...] :1 secure /usr/bin/X11/X :1 -boards 1,2 -devdir /dev/input1 -bs [...] |
| Note: For more information on -boards and -devdir, see the Xsgi(1) IRIX man page. For more information on graphics pipe numbers, run /usr/gfx/gfxinfo. |