University of California at Berkeley
           Department of Electrical Engineering & Computer Sciences
                         Instructional Support Group

/share/b/pub/sunray.help

*****************************************************************************
  THIS DOCUMENT IS OUT OF DATE AND IS HERE FOR HISTORICAL REFERENCE ONLY
  We retired the last of our SunRays in 2014.
*****************************************************************************


								Oct 18, 2010

CONTENTS:
	What's a SunRay?
	SunRay UNIX and PC keyboards
	SunRay special keystokes
	SunRay USB ports
	SunRay troubleshooting
	SunRay screen resolution
	Killing and restarting the SunRay servers (for sys admins)
	SunRay server administrative commands (for sys admins)


What's a SunRay?
---------------
  A SunRay is a diskless network appliance that logs into a central server.
  EECS Instruction received a grant of 66 SunRays from Sun Microsystems in
  January 2000 and purchased 50 SunRays and 4 Sun 280 servers using a 
  Matching Grant from Sun in May 2002.  The SunRays are located in 6 labs: 

	271 Soda (35 SunRays)	server: nova.cs.berkeley.edu
	273 Soda (31 SunRays)	server: star.cs.berkeley.edu
	277 Soda (18 SunRays)	server: solar.cs.berkeley.edu)
	199 Cory ( 4 SunRays)	server: c199.eecs.berkeley.edu


  Additional reference: http://www.sun.com/sunray1/
  photos and comments: http://inst.EECS.Berkeley.EDU/~kevinm/sunrays/


SunRay UNIX and PC keyboards
----------------------------

  Our earlier shipments of SunRays included SUN UNIX-style keyboards, while
  later shipments included PC-AT style keyboards.  The difference is the
  locations of the Control, CapsLock and Esc keys.

  All of our SunRay labs now have PC-style keyboards.

  UNIX-style keyboards are "Type 6 Country Kits for US Unix/Unix Universal/
  European Unix with USB interface", Sun  part number X3538A.

  PC-style keyboards are "type 6 Country Kits for U.S./Universal/Canada 
  with USB interface", Sun  part number X3531A.


SunRay special keystokes
------------------------

  Restart (new login banner):   [CNTL][ALT] + hit [BACKSPACE] twice
  Power reset keys:             [CNTL][CRESCENT]
  Audio and video settings:	[SHIFT][PROP]
  Ethernet ID (last 6 chars):   3 audio keys at once

  To reset video resolution on a SunRay:

  - Login at the SunRay (you do not have to be 'root')
  - Run /opt/SUNWut/bin/utsettings
  - select "display" from the pull-down menu
  - select desired resolution  for the display device you are using


SunRay USB ports
----------------

   For information about accessing USB memory slicks on a SunRay, please see
   http://inst.eecs.berkeley.edu/cgi-bin/pub.cgi?file=multimedia.help#1.


SunRay troubleshooting
----------------------

  If the keyboard or mouse on a SunRay is unresponsive, you may be able to 
  correct the problem by unplugging the electrical cord from the back of 
  the SunRay, then plug it back in so that the SunRay reboots.  Just 
  unplugging the SunRay will not log you out.

  If your login session on a SunRay freezes up (and it is not happening
  to everyone else in the room), you may need to login a second time to 
  kill the processes from your first login.
  
  When the desktop crashes, you should save all your work and kill the
  session with <CTRL><ALT><BACKSPACE>.  You'll need to press the
  sequence once on the Solaris X86 boxes in 275 Soda and twice in the
  Sunray labs.

  The SunRays are just graphical displays (xterminals, basically). All the 
  processes are running on the server.  So unplugging and restarting the 
  SunRay does not affect the processes that are generating the display, and
  you usually just get the same display again.  If you were logged in when 
  the Sunray looses power, you will be logged in when the power is restored.

  First, try power-cycling the SunRay by pressing [CTRL][DIAMOND][CRESENT] 
  at the same time.  That will power-cycle the sunray, but not log you out.  
  
  If that doesn't work, log in again to the same SunRay server and try to 
  kill all of your processes on the server (forcibly) with the command 
  'pkill -u aredfern'.  You should immediately see all your sessions 
  (including the one you are now using) return to login-prompts.  To avoid 
  killing your current session, you can use "ps -aef | grep $user" to list 
  all of processes you own.  The command "tty" will list the current 
  terminal session that you are using, and by elimination you can usually 
  figure out which processes are from the first (stalled) login.   You can 
  kill a process using "kill -9 PID" where PID is the process ID taken from 
  the 'ps' output.



SunRay screen resolution
------------------------

  Q: Is there any way to use the LCD monitors on SunRays in the labs at 
     their native resolutions (i.e. 1680x1050x75Hz at 271 Soda)? 
  
  A: No. The SunRays (circa 2000) can not generate a 1680x1050 resolution
    signal.  Unfortunately, 1280x1024 is the largest resolution available.


Killing and restarting the SunRay servers (for sys admins)
----------------------------------------------------------

  On the server: (you don't have to do this at the console, but you *do* 
  have to leave open the window if you do this from your workstation)

	/etc/init.d/utsvc stop
	/etc/init.d/dhcp stop

	/etc/init.d/dhcp start
	/etc/init.d/utsvc start
  
  Don't do these if you don't have to, they'll log everyone off the SunRays:

	/opt/SUNWut/sbin/utrestart
	/etc/init.d/dtlogin stop
	/etc/init.d/dtlogin start


SunRay server administrative commands (for sys admins)
------------------------------------------------------

  Reference: http://docs.sun.com/source/820-3768/

  To list desktop ids by ethernet number: 
  
	/opt/SUNWut/sbin/utdesktop -l

  To display current NRAM of a SunRay:

	/opt/SUNWut/sbin/utdesktop -p <ethernet>

  To view SunRay logs:

	tail -f /var/opt/SUNWut/log/messages

  To reset a SunRay that is in blank screen mode:

  	1) Get MAC address of SunRay: hold down all 3 audio keys at once.
  	2) Run "/share/b/adm/bin/fixblank $MAC"

  To reset a SunRay that is in geeko mode:

  	1) Get MAC address of SunRay: hold down all 3 audio keys at once.
  	2) Run "/share/b/adm/bin/fixgecko $MAC"
	   Here is a summary of that script:

	   #!/usr/sww/bin/perl
	   #
	   if ( $#ARGV < 0 ) {die "usage: $0 MAC_address\n";}
	   ($mac = $ARGV[0]) =~ y/A-Z/a-z/;
	   $tok = `awk -F= '/'$mac'/ {print \$2}' /var/opt/SUNWut/displays/*`;
	   system ("/opt/SUNWut/lib/utdtsession -t $tok delete");

  	3) Reboot the SunRay. [CNTL][CRESCENT]
  	4) Wait; server will reset it in 1-2 minutes.
 
  To enable pseudocolor_visual:

	1) Set it up with:
	   /opt/SUNWut/bin/utxconfig -a -l 
	   /opt/SUNWut/bin/utxconfig -a -p default 
	   /opt/SUNWut/bin/utxconfig -a -l
	2) To take effect:
	   /opt/SUNWut/sbin/utrestart

  To determine who was logged in at a SunRay:

	1) set MAC = the MAC address of the SunRay (such as "080020fdb3a0")
	2) Find the display number.  The display number is the name of the 
	   file that contains the MAC address:
	   grep $MAC /tmp/SUNWut/config/displays/*
	3) Look for the owner of processes associated with this display.
	   If the display number is "7", type:  
	   last |grep " :7 "
 
					EECS Instructional Support Group
					386 & 378 Cory, 333 Soda
					inst@eecs.berkeley.edu