InfoDoc ID   Synopsis   Date
21168   SunRay1 FAQ   27 Mar 2000

Status Issued

Description
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
   SunRay appliances on it)?
Q. How do I set up the authentication server?
Q. I can see login screens on the SunRay 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 SunRay appliance?
Q. What scan rates (resolutions) are supported?
Q. What smartcards are supported?
Q. How do I debug a SunRay 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 SunRay appliance?
Q. What files are most useful for debugging?
Q. If I use a SunRay 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 Desktop Extensions 1.0 on Solaris 2.6 after
   installing the SunRay 1 Server software. Now the appliances do not work.
Q. What ports does SunRay 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 SunRay 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 SunRay 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 SunRay CDROM. 
   Become root.
   cd /cdrom/cdrom0
   ./utinstall
   [Hit return on all questions, unless you have SWS 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
   SunRay appliances on it)?
A. utadm -r
   utadm -c
   utadm -a hme0 # in this example hme0 is the interface name
   At this point the SunRay 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 SunRay packages using utinstall -u,
see above.

--
Q. I can see login screens on the SunRay 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 SunRay 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 SunRay session setup?
A. Check files /var/opt/SUNWut/log/messages* SunRay 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 SunRay server
		use SunRay 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 swapspace 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 SunRay 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 SunRay 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 SunRay 1 Server software. Now the appliances do not work.
A. Please install Solaris Desktop Extensions 1.0 first, then SunRay 1 Server.

Q. What ports does SunRay 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 SunRay.

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 logical token 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 SunRay 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.
INTERNAL SUMMARY:
SunRay's internal codename is corona, so is the bug category for it.
http://ncs.eng is the internal website.
SUBMITTER: Andras Cser APPLIES TO: Hardware, Operating Systems/Solaris/Solaris 2.6 ATTACHMENTS:


Copyright (c) 1997-2003 Sun Microsystems, Inc.