Sun Ray Server Software 5 (4.2) Solaris Installation

SunRay Server Software 5 (4.2) Solaris Installation

Abstract:

SUN, whose stock ticker was called "SUNW" had traditionally been a desktop company. In 1982, SUN started marketing "W"orkstations, which were full fledged UNIX systems on the desktop, where those desktops ran everything from desktop applications to mail servers. Sun gradually become more server oriented during the 1990's with the expansion of the Internet, moving toward thin clients with the original SunRay1 in 1998. When Sun's computers were moving to UltraSPARC processors, their desktop solution was sensibly called "Ultra-Thin" clients (hence, the commands start with "ut" mnemonic) because very little processing was required on the desktop and most processing occurred on the server. A SPARC server can support multiple "Utra-Thin", or now called "Sun Ray" clients, using a simple modern Solaris OS in conjunction with SRSS 5 or Sun Ray Server Software.

Prerequisites:

This document describes the use of Sun Ray Services under SPARC Solaris. Ensure the following has been done:

• The srss_4.2 software has been unzipped to /tmp
• The 64 bit upgrade to the 32 bit version of jdk1.6 is installed.
• Apache Tomcat has been un-gtar-ed into /opt

PreInstallation:

Verify the version of Java on the platform is sufficient and upgrade if not.

V100/root$ java -version
java version "1.5.0_20"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_20-b02)
Java HotSpot(TM) Client VM (build 1.5.0_20-b02, mixed mode, sharing)

V100/root$ cd /usr/jdk
V100/root$ sh /var/spool/pkg/jdk-6u18-ea-bin-b04-solaris-sparc-28_oct_2009.sh
...
Do you agree to the above license terms? [yes or no]
yes
Unpacking...
Checksumming...
Extracting...
Archive:
...
Press Enter to continue.....
Done.

V100/root$ cd /usr/jdk
V100/root$ sh /var/spool/pkg/jdk-6u18-ea-bin-b04-solaris-sparcv9-28_oct_2009.sh
Do you agree to the above license terms? [yes or no]
yes
Unpacking...
Checksumming...
Extracting...
Archive:
...
Press Enter to continue.....
Done.

V100/root$ /usr/jdk/jdk1.6.0_18/bin/java -version
java version "1.6.0_18-ea"
Java(TM) SE Runtime Environment (build 1.6.0_18-ea-b04)
Java HotSpot(TM) Client VM (build 16.0-b11, mixed mode, sharing)

Unzip the Sun Ray Server Software in preparation for installation.

V100/root$ cd /tmp
V100/root$ ls -al srss_4.2_solaris.zip
-rw-r--r-- 1 root root 148595750 Jun 3 09:13 srss_4.2_solaris.zip
V100/root$ unzip srss_4.2_solaris.zip
creating...
...
inflating: srss_4.2/.install/admin_default

Add the appropriate services to the /etc/services file.

V100/root$ cd /tmp
V100/root$ ls -al srss_4.2_solaris.zip
-rw-r--r-- 1 root root 148595750 Jun 3 09:13 srss_4.2_solaris.zip
V100/root$ unzip srss_4.2_solaris.zip
creating...
...
inflating: srss_4.2/.install/admin_default

Decompress & burst the tomcat archive using GNU tar to help the administrator manage the Sun Ray Server Software via a GUI configuration tool.

V100/root$ cd /tmp/srss_4.2/Supplemental/Apache_Tomcat
V100/root$ gunzip apache-tomcat-5.5.20.tar.gz
V100/root$ cd /opt
V100/root$ /usr/sfw/bin/gtar -xf /var/spool/pkg/srss_4_2/Supplemental/Apache_Tomcat/apache-tomcat-5.5.20.tar
V100/root$ ln -s apache-tomcat-5.5.20 apache-tomcat

Installation:

Perform the Sun Ray Server Software installation.

V100/root$ cd /tmp/srss_4.2
V100/root$ ./utinstall
Sun Microsystems, Inc. ("Sun")
SOFTWARE LICENSE AGREEMENT
...
Accept (Y/N): Y
...
Installation of  was successful.
# utinstall   Version: 4.2     Thu Jun  3 10:51:17 EDT 2010
Sun Ray Server Software 4.2              not installed
Sun Ray Data Store 3.2                   not installed
Do you want to install Sun Ray Server Software 4.2 French Admin GUI (Y/[N]): N
Do you want to install Sun Ray Server Software 4.2 Japanese Admin GUI (Y/[N]): N
Do you want to install Sun Ray Server Software 4.2 Simplified Chinese Admin GUI (Y/[N]): N
Kiosk Mode 4.2                           not installed

Enter Java v1.6 (or later) location [/usr/java]: /usr/jdk/jdk1.6.0_18

About to carry out the following operations:
Install  [ Sun Ray Server Software 4.2 ]
Install  [ Sun Ray Data Store 3.2 ]
Install  [ Sun Ray Server Software 4.2  ]
Install  [ Kiosk Mode 4.2 ]
Install  [ Kiosk Mode 4.2 localized files ]
Install  [ data for utslaunch ]
Install  [ Sun Ray Server Software 4.2 modules for utsunmc ]
Install  [ Service Tags 1.1 ]

Continue? ([Y]/N): Y

Installing Sun Ray Server Software version 4.2 ...
...
+++ Done.

Post-Installation:

Prepare environment and Reboot server in order to enable the Sun Ray Server Software.

V100/root$ cat >>/etc/profile \
PATH=$PATH:/opt/SUNWut/sbin
MANPATH=$MANPATH:/opt/SUNWut/man
export PATH MANPATH
!
V100/root$ cd / ; sync ; sync ; init 6

Configuring a Shared LAN

Configuring SunRay Services on a shared LAN allow for Ultra-Thin clients to be used on a non-dedicated interconnect. This is helpful in a DHCP environment where the server hosting the Sun Ray Server Software is receiving its configuration through DHCP.

To enable shared LAN connections:

# utadm -L on

Restart server:
# utrestart

The Sun Ray terminals, configured to use DHCP by default, should automatically receive a prompt. The Sun Ray Ultra Thin terminals will locate the Sun Ray Server via multicast. If any terminals are not receiving a prompt, they can be reset via a CNTRL-A.

Configuring a Private Interconnect

A private interconnect is preferred to ensure that the Ultra Thin terminals are receiving the proper quality of service over the network. For systems with a large number of terminals, this (more complex) configuration is preferable.

If the server will have a dedicated interconnect, select a network such as "192.168.2.0/24", and a new physical port to serve DHCP such as "hme1".

# utadm -a hme1

Selected values for interface "hme1"

host address: 192.168.2.252
net mask: 255.255.255.0
net address: 192.168.2.0
host name: Ultra2-hme1
net name: SunRay-hme1
first unit address: 192.168.2.50
last unit address: 192.168.2.99
auth server list: 192.168.2.252
firmware server: 192.168.2.252
router: 192.168.2.252

DHCP running on HME1? (Y)

Configuring the Sunray Server GUI Admin Software

V100/root# utconfig
...
Continue ([y]/n)? y
Enter Sun Ray admin password:
Re-enter Sun Ray admin password:
Enter Apache Tomcat installation directory [/opt/apache-tomcat]:
Enter HTTP port number [1660]:
Enable secure connections? ([y]/n)?
Enter HTTPS port number [1661]:
Enter Tomcat process username [utwww]:
Enable remote server administration? (y/[n])? y
Configure Sun Ray Kiosk Mode? (y/[n])?
Configure this server for a failover group? (y/[n])?

About to configure the following software products:

Sun Ray Data Store 3.2
Hostname: V100
Sun Ray root entry: o=utdata
Sun Ray root name: utdata
Sun Ray utdata admin password: (not shown)
SRDS 'rootdn': cn=admin,o=utdata

Sun Ray Web Administration hosted at Apache Tomcat/5.5.20
Apache Tomcat installation directory: /opt/apache-tomcat
HTTP port number: 1660
HTTPS port number: 1661
Tomcat process username: utwww
Remote server administration: Enabled

Sun Ray Server Software 4.2
Failover group: no
Sun Ray Kiosk Mode: no

Continue ([y]/n)? y

Updating Sun Ray Data Store schema ...
Updating Sun Ray Data Store ACL's ...
Creating Sun Ray Data Store ...

Restarting Sun Ray Data Store ...
Starting Sun Ray Data Store daemon .Jun 3 13:52:54 V100 utdsd[3537]: utdsd starting

Thu Jun 3 13:52 : utdsd starting

Loading Sun Ray Data Store ...

Executing '/usr/bin/ldapadd -p 7012 -D cn=admin,o=utdata' ...
adding new entry o=utdata
adding new entry o=v1,o=utdata
adding new entry utname=V100,o=v1,o=utdata
adding new entry utname=desktops,utname=V100,o=v1,o=utdata
adding new entry utname=users,utname=V100,o=v1,o=utdata
adding new entry utname=logicalTokens,utname=V100,o=v1,o=utdata
adding new entry utname=rawTokens,utname=V100,o=v1,o=utdata
adding new entry utname=multihead,utname=V100,o=v1,o=utdata
adding new entry utname=container,utname=V100,o=v1,o=utdata
adding new entry utname=properties,utname=V100,o=v1,o=utdata
adding new entry cn=utadmin,utname=V100,o=v1,o=utdata
adding new entry utname=smartCards,utname=V100,o=v1,o=utdata
adding new entry utordername=probeorder,utname=smartCards,utname=V100,o=v1,o=utdata
adding new entry utname=policy,utname=V100,o=v1,o=utdata
adding new entry utname=resDefs,utname=V100,o=v1,o=utdata
adding new entry utname=prefs,utname=V100,o=v1,o=utdata
adding new entry utPrefType=resolution,utname=prefs,utname=V100,o=v1,o=utdata
adding new entry utPrefClass=advisory,utPrefType=resolution,utname=prefs,utname=V100,o=v1,o=utdata

Added 18 new LDAP entries.

Creating Sun Ray Server Software Configuration ...
Adding user account for 'utwww' (ut admin web server user) ...done
Adding user account for 'utwww' (ut admin web server user) ...done
Starting Sun Ray Web Administration...
See /var/opt/SUNWut/log/utwebadmin.log for server logging information.

Unique "/etc/opt/SUNWut/gmSignature" has been generated.

Restarting Sun Ray Data Store ...
Stopping Sun Ray Data Store daemon
Jun 3 13:53:20 V100 utdsd[3537]: utdsd got shutdown signal
Sun Ray Data Store daemon stopped
Starting Sun Ray Data Store daemon .Jun 3 13:53:23 V100 utdsd[4144]: utdsd starting

Thu Jun 3 13:53 : utdsd starting
Adding user admin ...
User(s) added successfully!

***********************************************************
The current policy has been modified. You must restart the
authentication manager to activate the changes.
***********************************************************

Configuration of Sun Ray Server Software has completed. Please check
the log file, /var/adm/log/utconfig.2010_06_03_13:48:03.log, for errors.

SunRay Firmware Upgrade

To use a SunRay Ultra-Thin client on the WAN, follow these instructions to update to WAN firmware on an individual sunray.

To upgrade the firmware on individual units to the most recent LAN firmware:

# utfwadm -A -f /opt/SUNWut/lib/firmware_gui -e {unit MAC address}
# utquery -d {unit IP address}

Troubleshooting X Windows Configuration

If odd X Windows issues are observed, there are some checks to ensure installed files weren't corrupted:

# diff /usr/dt/config/Xconfig /etc/dt/config/Xconfig
47d46

this is outside of the limits given in the installation guide and will require re-installation

# diff /usr/dt/config/Xservers /etc/dt/config/Xservers
111a112,114

the results for the Xservers test is within acceptable limits, re-installation is only necessary for Xconfig

shutting down all Sunray units
# /etc/init.d/utsvc stop

reinstalling Xconfig
# /bin/cp -p /usr/dt/config/Xconfig /etc/dt/config/Xconfig

reinitializing Sunray units
# /opt/SUNWut/sbin/utrestart -c

Other Steps

Test your access to the SunRay Administration GUI. Enable SDAC access, if the soft-client is planned to be used.

Access Sunray administration GUI

• enable SDAC access
• warm reboot server (through GUI)

Conclusion:

The process for installation of the Sun Ray Server Software is fairly simple, many of the steps are not needed if a DHCP server and command line administration are sufficient.

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

UPDATED - 2010-06-16

Added more detail to the installation instructions and abstract.