Install Sun Ray Server software in Oracle Enterprise Linux

In this article I continue my installation of Oracle Enterprise Linux from an earlier blog post. The below instructions are based on an internal Wiki article written by a Sun colleague (thanks for the pre-work). 

Prepare Oracle Enterprise Linux for Sun Ray Server software 

I'm now ready to install the Sun Ray Sever software. After you logged in for the first time as the root user in your just installed Oracle Enterprise Linux server, you have to prepare the system for Sun Ray Server software installation: add additional packages and change some Linux configuration files.

In Oracle Enterprise Linux yum is used to install additional packages. Reconfigure yum to run from the DVD repository. This is done by adding the following contents to a new file (Note that the mediaid comes from the file /media/Enterprise Linux dvd 20090908/.discinfo):

    # vi /etc/yum.repos.d/dvd.repo
      name=DVD for RHEL5 

Oracle also hosts a yum-server for Oracle Enterprise Linux, this also should work but I have not tested this. 

You are now ready to install additional packages or groups of packages. The package list and versions which must be installed prior to Sun Ray Server installation are:

    # yum groupinstall "Development Tools"
    # yum install glib-1.2.10
    # yum install dhcp-3.0.5
    # yum install openldap-clients-2.3.43
    # yum install libXp-1.0.0
    # yum install openmotif22-2.2.3
Also the /etc/hosts file need some changes: the hostname must be removed from address and the host primary IP address and hostname must be added. The result must be something similar to:
    # vi /etc/hosts
      # Do not remove the following line, or various programs
      # that require network functionality will fail.       localhost.localdomain localhost
      ::1             localhost6.localdomain6 localhost6  host19.sunvdi.local host19

This finished the preparation on Oracle Enterprise Linux, we are now ready to install Sun Ray Server software.

Install Sun Ray Software

For download instructions for the Sun Ray Server software I refer to the Sun Ray Wiki website. After downloading the the Sun Ray Server software for Linux zip-files in my staging directory I start the installation:

    # cd /stage/sunray
    # unzip

Check Java version

Sun Ray Server software 4.2 requires a 32-bit implementation of a Java(TM) 2 Platform, Standard Edition JRE(TM) of at least 1.6. The latest Java release is available at To check what JRE version is installed on your system, use the following command:

    #  java -version

JRE version 1.6 is also bundled on the Sun Ray Server software zip-file in the Supplemental directory. For my test installation I used the provided JRE in the Supplemental Directory:

    # cd /stage/sunray/srss_4.2/Supplemental/Java_Runtime_Environment/Linux/
    # sh ./jre-6u13-linux-i586.bin 
      <enter yes when prompted>
    # mv jre1.6.0_13 /opt

Install Tomcat

The Sun Ray Administration Tool (Admin GUI) requires that a Web server be installed and running on each Sun Ray server. The Admin GUI is hosted in a Apache Tomcat 5.5 Web container. For my test installation I used the provided Apache Tomcat in the Supplemental Directory:

     # cd /stage/sunray/srss_4.2/Supplemental/Apache_Tomcat/
     # gunzip apache-tomcat-5.5.20.tar.gz 
     # gtar xvf apache-tomcat-5.5.20.tar 
     # mv apache-tomcat-5.5.20 /opt
     # ln -s /opt/apache-tomcat-5.5.20 /opt/apache-tomcat

Install Sun Ray Server software

Installing Sun Ray Server software is nothing more then an install CLI-command and a reboot of the server: 

    # cd /stage/sunray/srss_4.2
    # ./utinstall 
      - read and accept the license
      - answer Y or N when prompted for French, Japanese, Chinese Admin GUI.
      - enter Java v1.6 (or later) location: /opt/jre1.6.0_13
      - continue installation with the selected packages
    # reboot

Before you reboot make sure you have unmounted the OEL installation DVD, it might be used as the primary boot device during the reboot.

Configure Sun Ray Server software

Sun Ray Server software installed, time to configure the software. This is done by a CLI-command and works straight-forward. Most of the defaults are OK, but here is what I used for my test server:

    # /opt/SUNWut/sbin/utconfig
      - Continue ([y]/n)? Y
      - Enter Sun Ray admin password:
      - Configure Sun Ray Web Administration? ([y]/n)? 
      - 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]:

      - Be sure to enable "remote administration" (non-default)
        Enable remote server administration? (y/[n])? y
      - Be sure to configure "Kiosk Mode" (non default)
        Configure Sun Ray Kiosk Mode? (y/[n])? y

      - Enter user prefix [utku]:
      - Enter group [utkiosk]:
      - Enter userID range start [150000]:
      - Enter number of users [25]:
      - Configure this server for a failover group? (y/[n])?
        It lists a summary and if you happy with it choose yes to continue
        the configuration. 
      - Continue ([y]/n)? y

Configuration of Sun Ray Server Software has completed.

Turn on Sun Ray Server services

Sun Ray Server has multiple network configuration options to start the services. I used the easy one which turns on the services on all ethernet-interfaces on the server and does not configure DHCP services:

    # /opt/SUNWut/sbin/utadm -L on
    # /opt/SUNWut/sbin/utrestart -c

At this time, you are ready to connect a Sun Ray to this server.

 Linux Firewall

If you did forget to turn off the Linux Firewall during installation, you can do that afterwards via the following CLI commands as the root user:

    # service iptables save 
    # service iptables stop 
    # chkconfig iptables off 

If the Firewall keeps running on the server, the Sun Ray device will not connect to the servers and you will see a 26B OSD message on your Sun Ray device.

Install Sun Ray Windows Connector on OEL

Installation of the RDP connector is straightforward. I only had one minor issue with a missing library-filename on OEL during the installation, when I found the other version of that library it worked without problems. Here is what I used on my test system:

    # cd /stage/sunray
    # groupadd srwc
    # unzip
    # cd srwc_2.2
    # ./installer
       Accept (Y/N):
       Enter "srwc" as group name
    # /opt/SUNWuttsc/sbin/uttscadm -c
       Enter complete location for [/lib/] :
    # /opt/SUNWut/sbin/utrestart -c

OK, that's it !! 


Nice article but "disable firewall" is curious. Firewall is blocking many attacks to the server !

Properly configure firewall is:
# SUNRAY - webadmin
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 1660 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 1661 -j ACCEPT

-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 7007 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 7008 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 7009 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 7010 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m udp -p udp --dport 7009 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 7011 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 7012 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m udp -p udp --dport 7013 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 7015 -j ACCEPT

# SRWC proxy daemon
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 7014 -j ACCEPT

# SUNRAY - UDP ports for terminals
-A RH-Firewall-1-INPUT -m state --state NEW -m udp -p udp --dport 40000:42000 -j ACCEPT

# SUNRAY - firmware download
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 69 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m udp -p udp --dport 69 -j ACCEPT

But this configuration allow terminal to be connected... i got some problems between communicate between sun ray servers. Please allow full port in iptables between sun ray servers !

Posted by maciek on August 25, 2011 at 04:49 PM CEST #

Post a Comment:
  • HTML Syntax: NOT allowed

I post here hands-on examples which I have used in my Oracle VDI Desktop Virtualization projects at customers and partners.


« July 2016