The following list of Questions are answered in this document.
Q. How do I get started?
Q. How do I set up the network interconnect (the network that only has
Sun Ray appliances on it)?
Q. How do I set up the authentication server?
Q. I can see login screens on the Sun Ray appliances.
How do I find out what appliances I have available?
Q. How can I find out/add a smartcard to the authentication database?
Q. What monitors are supported by the Sun Ray appliance?
Q. What scan rates (resolutions) are supported?
Q. What smartcards are supported?
Q. How do I debug a Sun Ray session setup?
Q. Does the appliance have an USB port hub?
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?
Q. How much memory should I deploy on the server per active user?
Q. How much swapspace should I deploy on the server per appliance?
Q. How do I set the resolution of the appliance?
Q. Are 8-bit PseudoColor visuals allowed on appliances?
Q. Is there a command line login option on the Sun Ray appliance?
Q. What files are most useful for debugging?
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?
Q. My sessions are lost for some reason. How do I fix it without rebooting
the server?
Q. I have installed Solaris[TM] Desktop Extensions 1.0 on Solaris[TM] 2.6 after
installing the Sun Ray 1 Server software. Now the appliances do not work.
Q. What ports does Sun Ray use?
Q. I am using OpenGL 1.1.2 on the server, but my OpenGL applications
do not display to the appliance. How come?
Q. I am trying to run utload on the server, it does not work.
Q. A disabled smart card can still login to an appliance if it was used once
before being disabled.
Q. What do the dashes mean under the hourglass?
Q. My dtlogin is very slow, the screen refreshes line by line on the appliances
Q. I only see a green newt on the Sun Ray appliance. What does this indicate?
Q. My appliance is hung at the greeting screen after logging in on dtlogin.
Why is this?
Q. Is VLAN supported?
Q. How do I get started?
A. Make sure you have at least Solaris 2.6 5/98 or Solaris 7 5/99 with current
patches installed in *Entire Distribution* metacluster option.
Required Solaris 2.6 patches:
105633-21 or higher
105703-10 or higher
107381-01 or higher
107272-01 or higher
106621-04 or higher
108303-02 or higher
Required Solaris 7 patches (bundled with HW 5/99):
108376-03 or higher
107180-06 or higher
107250-02 or higher
107248-01 or higher
108303-02 or higher
** Make sure you consult the documentation:
/cdrom/cdrom0/Docs/Solaris_2.6+/en/*.ps
**
[Optional: make sure you don't have the Sun Ray software installed.
type: /opt/SUNWut/sbin/utinstall -u, this will remove everything.
rm -fr /etc/opt/SUNWconn/ldap /etc/opt/SUNWut /opt/SUNWut /etc/http/* ]
Reboot with
reboot -- -rv
Pop in the Sun Ray CDROM.
Become root.
cd /cdrom/cdrom0
./utinstall
[Hit return on all questions, unless you have SWS (Sun WebServer[TM]) installed.]
[utinstall will install Sun Directory Services 3.1, ]
make sure that /etc/system has these two lines:
set maxuprc=50
set pt_cnt=999
cd /cdrom/cdrom0/Sun_Directory_Services_3.1/Solaris_2.6+/Tools
cp sunds.lic /opt/SUNWconn/license_dir/sunds.lic,1
reboot -- -rv
make sure that utsessiond is running
Check the installation:
shiznits$ pkginfo | grep SUNWut
system SUNWuta Sun Ray enterprise server Administration Software
system SUNWutj Sun Ray enterprise server Java (JRE) Software
system SUNWutk Sun Ray enterprise server Drivers
system SUNWutkx Sun Ray enterprise server Drivers, (64-bit)
system SUNWutm Sun Ray enterprise server Manual Pages
system SUNWuto Sun Ray enterprise server Core Software
system SUNWutr Sun Ray enterprise server Configuration, (root)
system SUNWutu Sun Ray enterprise server Configuration, (usr)
system SUNWutux Sun Ray enterprise server Configuration, (usr) (64-bit)
shiznits$
by running pkgchk on the above packages.
--
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.