Installing the SunRay Server Software 3.0 on Debian GNU/Linux (Sarge)

Procedure

• Get SunRay Server Software 3.0 (srss_3.zip) from SUN
• Extract it to a temporary working directory with unzip srss_3.zip
• Execute the following snippet in a bash-shell:

  for i in srss_3.0/Sun_Ray_Core_Services_3.0/Linux/Packages/* srss_3.0/Sun_Ray_Data_Store_2.0/Linux/Packages/* srss_3.0/GDM_2.4.4.7.1/Linux/Packages/* srss_3.0/Docs/Linux/Packages/*; do
          alien -d "$i"
  done
  

• Install all resulting sunw*deb-packages: dpkg -i sunw*deb
• Download and apply the following Patch: cd / && patch -p0 </path/to/sray-debian.patch
• Put the init-script into /etc/init.d, and run chmod 755 /etc/init.d/zsunray-init && update-rc.d zsunray-init defaults 99 20
• apt-get install ldap-utils dhcp3-server nscd gawk iputils-ping pdksh unzip alien libdb3-util libx11-6 xlibs
• Now you need a current java in /etc/opt/SUNWut/jre. Simply run /path/to/srss_3.0/Supplemental/Java_Runtime_Environment/Linux/j2re-1_4_2_03-linux-i586.bin in /etc/opt/SUNWut/ and mv j2re* jre
• The libgdbm.so.2 included with Debian Sarge is to old, but SRSS works fine with libgdbm.so.3 linked to libgdbm.so.2:

  apt-get remove libgdbmg1
  apt-get install libgdbm3
  ln -s libgdbm.so.3 /usr/lib/libgdbm.so.2
  rm -f /var/opt/SUNWut/ndbm/*
  

• You can now configure the server with /opt/SUNWut/sbin/utconfig and /opt/SUNWut/sbin/utadm and finally start it with /etc/init.d/zsunray-init start
• For dhcp to work you need to include the SunRay dhcp-config in your /etc/dhcp3/dhcpd.conf. Example:

  include "/etc/opt/SUNWut/net/dhcp/SunRay-interface-eth2";
  

  If this does not work, try a fully-fledged /etc/dhcp3/dhcpd.conf instead: Example dhcpd.conf
• You also need to manually assign the IP-addresses in /etc/network/interfaces (If you don't want to use only LAN-mode). Example (only sunray-interconnect):

  auto eth2
  iface eth2 inet static
          address 192.168.30.6
          netmask 255.255.255.128
          network 192.168.30.0
          broadcast 192.168.30.127
  

• For firmware-download to work, you need a tftp-server: apt-get install atftpd
• If you have no /etc/X11/XF86Config, but a XF86Config-4, simply do

  ln -s XF86Config-4 /etc/X11/XF86Config

• To get the SunRAY variables (for example $SUN_SUNRAY_TOKEN) set upon login, put 10SUNWut into /etc/X11/Xsession.d/
• We use wdm to manage our logins, if you wish to do the same, get xmgr-wdm.tar, extract it to /opt/SUNWut/lib/xmgr and do the following:

  wget http://ftp.de.debian.org/debian/pool/main/w/wdm/wdm_1.28-1_i386.deb
  dpkg -i wdm_1.28-1_i386.deb
  cd /etc/opt/SUNWut
  rm xmgr
  ln -s /opt/SUNWut/lib/xmgr/wdm xmgr
  

  The wdm included in debian sarge (wdm < 1.28-1) is currently broken with regard to use on a sunray server, so you should install the version currently in unstable (see the wget above). If this has migrated to testing you can simply install it with apt-get install wdm.
• Now finally copy wdm-config to /etc/X11/wdm and restart wdm.

Additional things/problems you may encounter:

• Audio

  • To compile and install the audio- and io-modules on Linux 2.4, run: make -C /usr/src/SUNWut/utadem clean all install; make -C /usr/src/SUNWut/utio clean all install
  • Updated patch, sound seems to work now on 2.6! To compile the SUNWut-modules on a Linux 2.6, put the makefiles-2.6.tar.gz into /usr/src/SUNWut, tar xfz makefiles-2.6.tar.gz there, put SUNWut-modules-2.6.patch there and run patch -p0 <SUNWut-modules-2.6.patch.
    Then run make -C /usr/src/SUNWut/utadem all; make -C /usr/src/SUNWut/utio all; mkdir -p /lib/modules/`uname -r`/misc; cp /usr/src/SUNWut/ut{adem,io}/*.ko /lib/modules/`uname -r`/misc/; depmod -a
  • On Linux 2.6 you also need to run the following command once: sed -i -e 's|utadem\.o|utadem.ko|' -e 's|utio\.o|utio.ko|' /etc/init.d/utsyscfg

• SunRays no longer enter power-saving mode

  • Put the following in a new file called /etc/X11/gdm/SunRayInit/helpers/xset and make it executable:

    #!/bin/sh
    
    /usr/bin/X11/xset s 600 0
    

• Internal System error

  • If you get an "Internal System error" with utresdef and other programs, look at the libgdbm discussion above

• SunRay hangs on 26D waiting for the Xserver (probably fixed in FCS...)

  • This happens on newer SuSE-versions: If you have an ipv6 localhost-line in your /etc/hosts (::1 ... localhost ...), you need to comment it out, else authd is not able to establish a connection to the device manager