FAQ OF SUNRAY TROUBLESHOOTING

Q. How do I set up the network interconnect (the network that only has
Sun Ray appliances on it)?
A. utadm -r
utadm -c
utadm -a hme0 # in this example hme0 is the interface name
At this point the Sun Ray appliance should start up.
Do some checking:
# utadm -p
Interface Host Network Netmask Connections
hme0 shiznits-xxx xxx.xxx.xxx.0 255.255.255.0 2
# ifconfig -a
lo0: flags=849<UP,LOOPBACK,RUNNING,MULTICAST> mtu 8232
inet 127.0.0.1 netmask ff000000
hme0: flags=863<UP,BROADCAST,NOTRAILERS,RUNNING,MULTICAST> mtu 1500
inet xxx.xxx.xxx.1 netmask ffffff00 broadcast xxx.xxx.xxx.255
ether 8:0:20:7e:94:70
le0: flags=863<UP,BROADCAST,NOTRAILERS,RUNNING,MULTICAST> mtu 1500
inet xxx.xxx.xxx.117 netmask ffffff00 broadcast xxx.xxx.xxx.255
ether 8:0:20:7e:94:70
#

--
Q. How do I set up the authentication server?
A.
/opt/SUNWut/sbin/utconfig -u ## this is very important, otherwise
## utconfig will not work properly
/opt/SUNWut/sbin/utconfig
respond with defaults to all questions.
/opt/SUNWut/sbin/utpolicy -i clear

start up netscape as root, go to URL: http://localhost:1660

login: admin
^^^^^
password: <the-password-you-set-in-utconfig>
you should be able to log in
and
# utuser -l

Token ID User Name Other Info

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

0 tokens total.
#

should list the above. It is *critical* that you get the above output if
you want to proceed. If you get:
# utuser -l
Error: could not connect to admin server

you should run utconfig -u; utconfig

then /opt/SUNWut/sbin/utpolicy -i clear
and try again. If all else fails, remove and read all Sun DS,
Sun WebServer and Sun Ray packages using utinstall -u,
see above.

--
Q. I can see login screens on the Sun Ray appliances.
How do I find out what appliances I have available?

A.
# utdesktop -l

Desktop ID Location Other Info

--------------- ------------------------- -----------------------------------
080020b054b7
080020b056af
should tell you.

# utdesktop -o
080020b054b7,,
080020b056af,,
# utdesktop -e "080020b056af,Office location,Other user information"
1 Desktop Modified.
# utdesktop -o
080020b054b7,Front of the wall, outside Rhonda's office,
080020b056af,Office location,Other user information

--

Q. How can I find out/ add a smartcard to the authentication database?

A. Plug in the card into the appliance, then on the server just type:
# utdesktop -Lc

Desktop ID Location Other Info Current User

------------ -------------------- -------------------- ----------------------
-----------------------
080020b054b7 Front of the wall, outside Rhonda's office
MicroPayflex.00004da165000100
080020b056af Office location Other user information

2 desktops currently connected.

#
Note that the above command show the user with a smartcard.

--
Q. What monitors are supported by the Sun Ray appliance?
A. The following Sun monitors are supported:

365-1343
365-1354
365-1396
365-1397
365-1394
365-1395
365-1380
365-1381
365-1324
365-1335
365-1383
 365-1384
365-1385
365-1386

--
Q. What scan rates (resolutions) are supported?
A. The following resolutions are the only supported ones:
(HorizontalxVerticalxVertical Frequency)

640x480x60
640x480x85
800x600x60
800x600x85
1024x768x60
1024x768x75
1024x768x85
1152x900x66 (composite sync)
1152x900x76 (composite sync)
1280x1024x66
1280x1024x75
1280x1024x76
1280x1024x85

DDC-2B support (ask what monitor can do, then do a best guess)
no support for sense pins

--
Q. What smartcards are supported?
A. Supported smartcards are:

Schlumberger MicroPayflex (serialized at factory models only)

Check out http://cardstore.slb.com

--
Q. How do I debug a Sun Ray session setup?
A. Check files /var/opt/SUNWut/log/messages* Sun Ray uses syslog.

--
Q. Does the appliance have an USB port hub?
A. Yes. 2A power shared for all 4 ports (500mA each), the hub driver is in
the firmware, it supports most hubs. The mouse and keyboard USB drivers are
also in the firmware of the appliance.
Check out http://www.usb.org and http://www.usbstuff.com

--
Q. My interconnect fabric is not functioning appropriately. Apart from
checking
for the obvious reasons (Cat-5 cabling) what should I keep in mind when
setting up my interconnect?

*DON'T*
mix public/company network to connect appliances to Sun Ray
server
use Sun Ray server as internet/intranet router
 use switches that non-negotiate, unbuffered, strict
cutthrough,
half-duplex

use shared 10Mbps Ethernet (unsupported)

*DO'S*
assume moderate amounts of statistical traffic multiplexing
(10:1 is a safe ratio)
use _certified_ Cat-5 cabling and installation
use 100 Mbps full duplex networks whenever possible

3Com, Extreme Networks, Foundry switches are recommended.

--
Q. How much memory should I deploy on the server per active user?
A. 25 users per 1 GB of main memory, 25 users per 2GB of swap memory
This may change if users use large applications with high memory
consumption.

--
Q. How much swap space should I deploy on the server per appliance?
A. 1000MB for the server, 1000MB for the first 4 SunRay1 appliances, 200M
for each additional appliance.

--
Q. How do I set the resolution of the appliance?
A. On the server, type:
/opt/SUNWut/lib/utxconfig -a -r "1152x900"
The double quotes are important with all values.

Q. Are 8-bit PseudoColor visuals allowed on appliances?

A. Not by default. You can enable them by typing as root

utxconfig -a -p "on" # 24 bit TrueColor remains the default

utxconfig -a -p "default" # 8 bit PseudoColor becomes the default
utxconfig -a -l # to check your settings.

as root:
utxconfig -d `uname -n`:9.0 -p "on" # on display number 9
utxconfig -d `uname -n`:9.0 -l # to check your settings.

The double quotes are important with all values.

Q. Is there a command line login option on the Sun Ray appliance?

A. No.

Q. What files are most useful for debugging?

A. cat /var/opt/SUNWut/log/*
utpolicy
utuser -Lc
utuser -l
utdesktop -l
utadm -p
utxconfig -l
 ifconfig -a

Q. If I use a Sun Ray appliance as a token reader, why can I not use
it as a smartcard reader, i.e. it will not switch sessions when the smartcard
is inserted?
A. This is a design decision.

Q. My sessions are lost for some reason. How do I fix it without rebooting
the server?
A. utpolicy -i clear

Q. I have installed Solaris Desktop Extensions 1.0 on Solaris 2.6 after

installing the Sun Ray 1 Server software. Now the appliances do not work.
A. Please install Solaris Desktop Extensions 1.0 first, then Sun Ray 1
Server.

Q. What ports does Sun Ray use?

A. In addition to the standard X, dtlogin, etc. ports it (utsessiond) is
using
7007, 7009, 7010. The administration webserver is running on 1660.

Q. I am using OpenGL 1.1.2 on the server, but my OpenGL applications

do not display to the appliance. How come?
A. Please upgrade to OpenGL 1.2 which is the only supported version of
OpenGL supported by Sun Ray.

Q. I am trying to run utload on the server, it does not work.

A. utload is meant to be used on appliances only.

Q. A disabled smart card can still login to an appliance if it was used once
before being disabled.
A. Disable the card by the utuser -di token_id command.
examine /etc/opt/SUNWut/utadmin.conf, locate admin.subtree value.
export BASE <admin.subtree value>
export RAWTOKEN <card ID you want to acquire a logicaltoken for>
ldapsearch -b "$BASE" "utRawTokenIDS=$RAWTOKEN"
ldapsearch -b "utname=corona51,o=v1,o=utdata" \
"utRawTokenIDS=MicroPayflex.000051fe65000100"
/opt/SUNWut/lib/utdtsession -t user.927844461-7650 delete < /dev/null

Q. What do the dashes mean under the hourglass after the appliance is
power-cycled?
A.
One dash: waiting for interconnect
Two dashes: DHCP pending
Three dashes: Waiting to connect to Authentication Manager

Q. My dtlogin is very slow, the screen refreshes line by line on the

appliances.
A. ifconfig -a reveals that MTU is not set to 1500. Make sure it is set to
MTU=1500 , make sure that /etc/init.d/rootusr is not customized.

Q. I only see a green newt on the Sun Ray appliance. What does this indicate?
A. This indicates a problem with utsessiond. Make sure port indicated in
file /etc/opt/SUNWut/auth.permit is not used before starting utsessiond.
To work around this problem try rebooting.
If you cannot reboot, try
utpolicy -i clear
or
cd /etc/init.d
utsvc stop
utsvc start

Also, refer to Infodoc 21962 for more information.

Q. My appliance is hung at the greeting screen after logging in on dtlogin.

Why is this?
A. make sure that you see the following processes: (there should
be one utaction process per appliance)
# ps -ef|grep utaction
root 2728 1 0 13:38:47 ?
0:00 /opt/SUNWut/lib/utaction -i -t 900 -d /opt/SUNWut/lib/Xcleanup
root 2710 1 0 13:38:47 ?
0:00 /opt/SUNWut/lib/utaction -i -t 900 -d /opt/SUNWut/lib/Xcleanup

Q. Is VLAN supported?
A. Not at this time.