
		    RT-Xstation installation information

============================================================================
                         Configuring the RT
============================================================================

-) HARDWARE requirments:
    -) 1 hard disk,  miminum of 70meg.
	-) NOTE: this installation takes over/over-writes what you 
	    had on that drive.  This does NOT run co-resident with
	    AIX.
    -) 125 (or 135) processor.
	-) NOTE: if you use a 135 processor, you MUST have the
	    floating point card for that processor, else graphics
	    drawing will be painfully slow.
    -) minimum of 8 meg of memory (can be 2 4 meg cards).
    -) display type 6155 OR Megapel

	-) NOTE: Multiple console displays are NOT SUPPORTED.
		If you have multiple console displays (ie, a
		6153 and a 6155 display attached to your RT),
		you MUST REMOVE the additional display CARDS
		(leaving JUST the 6155 OR Megapel card) 
		BEFORE attempting the install.

	-) MEGAPEL NOTE:
		Check the switch bank on the megapel card.
		The switches should be set to:

		     1  2  3  4
		ON      X     X  
		OFF  X     X      

		Where switches 1 and 4 are unused, but the
		hardware documentation states they should 
		switched as above.  Switch 2 enables the
		printer port (printer software will be available
		soon for the Xstation).  Switch 3 enables
		PC Graphics EMULATION if set to on, ie, it 
		emulates an EGA card, which is not supported.  

-) software requirements:
    -) this is installed via NETWORK-INSTALL.  But you need
	2 floppy disks to get started.  You can get the floppy
	disks from me (see address/phone number at bottom of
	of this NOTE)

-) **********************  Using the SAUTIL disk.  *************************

-) boot the RT with the SAUTIL disk

    -) set up disk partions 

	-) choose the minidisk option (number 10).
	-) choose a disk, type: 'hd(0,2)'

	    (this means hard-drive #0, partition 2, where partition
	     2 implies the entire drive).

	-) type: 'i' (initialize)
	    -) it will ask: confirm (all data will be lost):
		-) type: 'y'
	-) type: 'standard xterminal'

	-) just hit 'return' to exit out of minidisk,
	    then 'return' a second time to go back to 
	    the main menu.

	-) take out the disk, and put in the MINIROOT disk.
	-) NOW boot from the miniroot disk: 
	    -) select the floppy boot option (number 2)
	    -) hit enter to continue at the ":" prompt.


-) *********************  Using the MINIROOT disk.  ************************

-) Using MINIROOT to install the operating system on the RT:

    NOTE: when chosing OPTIONS from the INSTALL menu, the 
	install program acts on single character input, 
	without waiting for 'return'.  So go slow through
	the menu(s) until you are used to how the program
	behaves.

    -) select choice (2) for "continue with installation".
    -) choose (1) TAPE or (2) NETWORK install
	-) TAPE install:
	    -) follow the instructions to do the install

	-) NETWORK install:

	    NOTE: choice (4) and (5) are absolutely required.

	    -) choice (4), the 'source host', should be the
		network install server for your site.

		For Austin, type: 9.3.21.91

		NOTE: 9.3.21.91 is (c4cbd.austin.ibm.com)

	    -) choice (5), 'target host' is the ip-address of YOUR RT.
	    -) choice (6), 'netmask', is the netmask for YOUR network.
	    -) choice (7), 'default router' is YOUR default gateway.

	-) NOTE: 'terse' install will install faster than verbose.  
	    About 10 minutes to do a terse install over the network, 
	    15-20 minutes by tape.
    -) at the end of the install, it will ask you some questions
	about configuring the Xterminal.  Answer the questions,
	configuring the Xterminal for YOUR RT IP-address, default route, 
	nameserver, and point the Xterminal at YOUR RISC Systems/6000 
	running X11R5.
    -) select choice 3 (Halt the system).

-) reboot, and you are on your way.


============================================================================
                  Configuring the RISC System/6000
============================================================================

-) pre-req:  X11R5 MUST be loaded.
-) pre-req:  for AIX3.2.3ext users, insure that you have the
    fix for apar ix34852 installed, else xdm wont set your 
    ulimit correctly when you login.



-) ************************  configure XDM:  *******************************

    -) cd /usr/lib/X11/xdm
    -) NOTE 1: when you start xdm, IF you have a graphics display on
	the RISC System/6000, xdm will start X11 on THAT display also.
	To disable this feature, edit Xservers.  At the bottom of
	the file, you will see a line that looks like:

:0 local /usr/bin/X11/X -T -force

	Put a '#' at the start of the line to comment it out.

    -) NOTE 2: when you start xdm, any RT that points to this machine
	for XDM service will be presented with a Host Choice menu
	(chooser menu) which will include all hosts on the SAME network
	that are running XDM.   You may override this feature and
	'hard-wire' the RT to a specific RISC System/6000 by editing
	Xaccess.  To do this, look for the line that looks like:

#terminal-a     host-a
	
	And ADD immediately BELOW it:

*       localhost

	NOTE: if your RISC System/6000 cannot resolve 'localhost'
	    (type: 'host localhost' and see if it returns 127.0.0.1)
	    THEN you MUST put the hostname of the RISC System/6000
	    in place of 'localhost'.

    -) edit Xsession

    -) Add the line(s) marked with '>>' in the following section of Xsession:
    -) Change the line(s) marked with '!!' in the following section of Xsession:

exec > $HOME/.xsession-errors 2>&1

>> XSTATION=${DISPLAY}
>> XDMSTATION=${DISPLAY}
>> ENV=${HOME}/.kshrc
LOGNAME=$USER
. /etc/environment

!! export TZ LOGNAME LOCPATH ODMDIR NLSPATH LANG HOME ENV XSTATION XDMSTATION

case $# in
1)
        case $1 in
        failsafe)
                if [ -f "/usr/lib/X11/$LANG/xinitrc" ]; then
                        /bin/ksh /usr/lib/X11/$LANG/xinitrc
                elif [ -f "/usr/lpp/X11/defaults/$LANG/xinitrc" ]; then
                        /bin/ksh /usr/lpp/X11/defaults/$LANG/xinitrc
                elif [ -f "/usr/lpp/X11/defaults/xinitrc" ]; then
                        /bin/ksh /usr/lpp/X11/defaults/xinitrc
                else
                        (mwm &)
                        exec aixterm -geometry 80x35+0-0 -ls
                fi
>>              exit 0
                ;;
        esac
esac

>> # First enable xhost authorization
>> xhost -
>> # Then authorize the machine
>> xhost +`hostname`

startup=$HOME/.xsession




-) ************************  configure FS:  *****************************

-) cd /usr/lib/X11/fs
-) edit config
    -) to the 'catalogue' line, add the following to the end of
	the line:

,/usr/lpp/info/X11fonts/

    -) the result should look like:

catalogue = /usr/lib/X11/fonts/,/usr/lib/X11/fonts/misc/,/usr/lib/X11/fonts/JP/,/usr/lib/X11/fonts/75dpi/,/usr/lib/X11/fonts/100dpi/,/usr/lib/X11/fonts/Type1/,/usr/lib/X11/fonts/Speedo/,/usr/lib/X11/fonts/i18n/,/usr/lib/X11/fonts/oldx11/,/usr/lib/X11/fonts/oldx10/,/usr/lib/X11/fonts/bmug/,/usr/lib/X11/fonts/info-mac/,/usr/lpp/info/X11fonts/




-) *********************  configure MWM defaults:  **********************

-) NOTE: this change allows 6155 displays to display Motif menus correctly
-) cd /usr/lib/X11/app-defaults
-) edit Mwm
    -) comment out all the color defaults, like:

! Mwm*iconImageBackground:      AntiqueWhite1
! Mwm*activeForeground:         AntiqueWhite1
! Mwm*activeBackground:         grey60
! Mwm*menu*foreground:          AntiqueWhite1
! Mwm*menu*background:          grey60
! Mwm*foreground:                       AntiqueWhite1
! Mwm*background:                       grey40



-) *********************  BOOT-time configuration: ***********************

-) create /etc/rc.X11 (as an executable shell script)
    -) NOTE: Dont forget to start these daemons the first time after 
	    the configuration has been completed on the RISC System/6000.
    -) It should contain:

#!/bin/sh
/usr/bin/X11/fs &
/usr/bin/X11/xdm

-) edit /etc/inittab
    -) at the bottom, add:

rcx11:2:wait:/etc/rc.X11 > /dev/console 2>&1 # Start X11 Daemons



-) ***********************  configure Xlock  ****************************

-) NOTE: normal 'xlock' (with no parameters) will NOT lock an Xstation.
    For conveinence, you should edit /usr/lib/X11/system.mwmrc.

-) Add the line(s) marked with '>>' in the following section of system.mwmrc:

# Clients Menu
menu "clients"
{
        "Demos"                 f.exec "/usr/lpp/X11/Xamples/bin/demodr"
        "oclock"                f.exec "oclock"
        "msmit"                 f.exec "msmit"
        "xdt"                   f.exec "xdt3"
        "xlock"                 f.exec "xlock"
>>      "xlock -remote"         f.exec "xlock -remote -nice 30 -delay 200000 -mo
de hop & "
}

-) NOTE: the 'nice' and 'delay' options simply reduce the load on BOTH
    the RISC System/6000 AND the network.  The '-remote' flag is all that
    is really needed to lock an Xstation.



-) ********************** PERSONAL CONFIGURATION ************************

-) NOTE: this is taylored for KSH users.  
-) XDM does NOT run your .profile when you 'login'.  It will run
    your .kshrc, due to the ENV line we added above in Xsession.
    To get your .profile to run, add the following to the top of
    your .kshrc:

if [ -n "$XDMSTATION" ] ; then
        . ${HOME}/.profile
fi

-) INSURE your .profile or .kshrc dont make any assumptions and try
    to start X11, open virtual windows, etc.  This is for users who
    are migrating from a full operating system to an Xstation.

-) SCROLLING PERFORMANCE:
    -) for aixterm, if you have the following line in your
	.Xdefaults, change it to 'true'

aixterm.jumpScroll: false

    -) setting 'jumpScroll' to false will cause the window to scroll
	on a per-pixel basis, instead of per-line.  When running over
	the network, this causes scrolling to be very slow.

----------------------------------------------------------------------------

Good Luck!

=============================================================================
Roger Florkowski                             IBM Personal Systems Programming
             AIX RISC System/6000 Network Communications Support
11400 Burnet Road                 Internet Mail: roger@wizards.austin.ibm.com
Austin, TX 78758                          email: roger@rogerf.austin.ibm.com
Phone: (512) 838-3489	                   home: cs.utexas.edu!taliesin!roger
=============================================================================
