Document ID:71443
Title:How to check whether a Sun Ray[TM] server is "offline".
Synopsis:How to check whether a Sun Ray[TM] server is "offline".
Update Date:Wed Feb 25 00:00:00 MST 2004

Keyword(s):sunray, Sun Ray, failover, utgstatus, utselect, offline, online, gstatus, utadm

Using "/opt/SUNWut/sbin/utadm -f", a Sun Ray[TM] server can be configured 
not to participate in loadbalancing. A Sun Ray[TM] server which is
"offline" is still available, but it will be ignored during loadbalancing 
decisions, and it cannot be accessed from the "utselect" GUI.

A Sun Ray[TM] server being "offline" unintentionally is a frequent root 
cause for poor loadbalancing. This document details how to identify 
Sun Ray[TM] servers which are "offline".
Several methods exist to check whether a Sun Ray[TM] server is "offline".


1.) Check whether a file /var/opt/SUNWut/offline exists.


2.) A server which is "offline" is marked with an "N" in the first
   "flags" column in SRSS 2.0 utgstatus output (but not in 1.x).

   Example:
   --------
   In the example output, labhost1 is trusted, but "offline", while
   labhost2 is "online", but not trusted.
   
   % /opt/SUNWut/sbin/utgstatus
   host        flags    interface     flags    
                        192.168.128.0/24       
   -----------------    -------------------
   labhost1       T-    192.168.128.1   UAM                       
   labhost2       -N    192.168.128.2   UAM


3.) A server which is "offline" will be reported "offline"
   in the SRSS 2.0 utselect GUI (but not in 1.x).



Notes:
------
- a Sun Ray[TM] server which is "offline", but up and running, 
  is still available. Hot desking to this server should 
  still work fine. The server will accept new sessions if no 
  other reachable server in the same failover group is "online".
  The server will also provide the Non Smartcard Login GUI - but
  will redirect sessions to "online" servers if users log in.
- Use "/opt/SUNWut/sbin/utadm -n" to restore normal operation of the 
  server.


Abbreviations:
--------------
SRSS: Sun Ray[TM] Server Software