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

Procedure

• apt-get install ldap-utils dhcp3-server nscd gawk iputils-ping pdksh unzip alien libdb3-util libx11-6 xlibs
• Get SunRay Server Software 3.1 (srss_3.1.zip) from SUN
• Extract it to a temporary working directory with unzip srss_3.1.zip
• Execute the following snippet in a bash-shell:

  for i in srss_3.1/Sun_Ray_Core_Services_3.1/Linux/Packages/* srss_3.1/Sun_Ray_Data_Store_2.1/Linux/Packages/* srss_3.1/GDM_2.4.4.7.1/Linux/Packages/* srss_3.1/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/sray31fcs-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
• Now you need a current java in /etc/opt/SUNWut/jre. Simply run /path/to/srss_3.1/Supplemental/Java_Runtime_Environment/Linux/j2re-1_4_2_07-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/*
  

• SRSS 3.1 needs an exported hmac_md5-function, which is only available from in the old sasl1-library. You can get this by manually installing libsasl7_1.5.28-6.4_i386.deb: dpkg -i libsasl7_1.5.28-6.4_i386.deb
• Download xkbinstall and execute it: /bin/sh xkbinstall
• 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
• On Debian Sarge: If you have no /etc/X11/XF86Config, but a XF86Config-4, simply do ln -s XF86Config-4 /etc/X11/XF86Config
• On Debian Etch (aka testing) you need to do the following: ln -s xorg.conf /etc/X11/XF86Config; ln -s /etc/X11/rgb.txt /usr/X11R6/lib/X11/; ln -s /usr/share/X11/XKeysymDB /usr/X11R6/lib/X11/XKeysymDB
• 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.

Installing patches:

• In the directory, where you have extracted the srss_3.1.zip file, run:

  mkdir patch
  cd patch
  for i in ../srss_3.1/Patches/Sun_Ray_Core_Services_3.1/Linux/120881*/*rpm; do
  	alien -d "$i"
  done
  

• Stop the currently running sunray-services: /etc/init.d/zsunray-init stop
• Save the old configuration files: tar cf sunray-config.tar /etc/opt/SUNWut /var/opt/SUNWut
• Install the new packages: dpkg -i *deb
• Apply the (updated) debian patch: cd / && patch -p0 </path/to/sray31patch-debian.patch
• Update the sunray firmware symlinks (for example with /opt/SUNWut/sbin/utfwadm -A -a -N 192.168.111.0) and update the firmware in your dhcpd.conf to 3.1_120879-03_2006.04.03.16.51
• Restore the auth.props file: cd / && tar xf /path/to/sunray-config.tar etc/opt/SUNWut/auth.props
• Rebuild the audio module, you probably need to apply the updated 2.6 patch and extract the 2.6 makefiles again
• If you are using wdm, restore the xmgr symlink: cd /etc/opt/SUNWut && rm xmgr && ln -s /opt/SUNWut/lib/xmgr/wdm xmgr
• Restart the sunray services: /etc/init.d/zsunray-init start

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
  • If you are running Linux >= 2.6.17 you should use sunray-modules-2.6.17.tar.bz2 instead of patching the files. Download it somewhere, extract it and run: cd SUNWut; make clean all install. These modules should load on 64bit kernels and audio was tested successfully on one. Serial/parallel port redirection (utio) with a 64bit kernel has not been tested, but might just work.
  • 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