SRSS 4.2 on Ubuntu 9.10 (i386, amd64)
From Sun Ray User Group Wiki
SRSS on Ubuntu/Linux
The following instructions are a quick HOWTO which explains how to install the SunRay Server Software (SRSS) on an Ubuntu 9.10 i386 and amd64 machine. It is largely based on the 8.10 and 9.04 guides.
Requirements
This HOWTO is based on the following requirements:
Installation of SRSS (SunRay Server Software)
(1) Install of required packages
sudo apt-get install libldap-2.4-2 libmotif3 module-assistant tk8.4 sun-java6-jre \
ldap-utils dhcp3-server nscd gawk iputils-ping pdksh unzip libgdbm3 \
libx11-6 libfreetype6 libsasl2-2 libxt6 zlib1g devscripts \
xfonts-base atftpd xfonts-100dpi xfonts-75dpi xfonts-cyrillic wget ed \
x11-xserver-utils tcsh alien
NOTE: It might happen that your system asks you to confirm the removal of the gdm-2.28 package in case you already have GNOME installed. This is required because gdm-2.28 doesn't have the old "gdmdynamic" functionality which the SRSS requires. When prompted to select the default display manager, select "gdm-2.20". By default the gdm-2.20 no work correctly on lastest system, may be needed run this:
sudo /etc/init.d/gdm stop sudo apt-get install gdm-2.20 sudo cd /etc/gdm sudo sed 's|X11R6/||' gdm.conf >/tmp/gdm.conf sudo mv /tmp/gdm.conf . sudo /etc/init.d/gdm start
- Install your favourite window manager
The SRSS requires an approriate window manager installed. So in case you haven't installed any you can do that now. E.g. to install GNOME (which is the Ubuntu default) make sure to also run the following command:
sudo apt-get install gnome-core
If you installed Ubuntu from the Desktop CD with the default gdm-2.28 package, you will need to create the following symbolic link to get the window manager to start (another option is to change all /usr/X11R6/bin/X entries to /usr/bin/X in /etc/gdm/gdm.conf):
sudo mkdir /usr/X11R6 sudo mkdir /usr/X11R6/bin sudo ln -s /usr/bin/X /usr/X11R6/bin/X
NOTE: If the window manager will not start consistently on the console, you may need to change "0=Standard device=/dev/console" to "1=Standard device=/dev/console" in /etc/gdm/gdm.conf.
(2) Download and unzip SRS packages
cd /tmp .... (download of SRSS 4.2 packages from sun.com -- see [3]) unzip srss_4.2_linux.zip
(3) Convert all .rpm packages to .deb packages
NOTE: ignore any error or warning caused during the following package conversion process. Especially the 'alien' conversion will throw out some errors which you can ignore as long as the conversion doesn't stop.
on amd64 (64bit):
sudo find srss_4.2 -name "SUNW*.rpm" -exec alien -d -g {} \;
sudo find SUNW*-* -name control -exec sed -i "s/i386/amd64/g" {} \;
sudo find SUNW*-*/ -maxdepth 0 -name "SUNW*-?.?" -exec sh -c "cd {} ; debian/rules binary-arch" \;
on i386 (32bit):
sudo find srss_4.2 -name "SUNW*i386.rpm" -exec alien -d {} \;
(4) install of generated .deb packages
sudo find . -name "sunw*deb" -exec dpkg -i {} \;
(5) apply patches to installation
wget -O /tmp/Patch-SRSS42-Ubuntu910.txt http://wiki.sun-rays.org/images/3/3d/Patch-SRSS42-Ubuntu910.txt cd / sudo patch -p0 </tmp/Patch-SRSS42-Ubuntu910.txt
(6) init.d startup-script installation
sudo chmod 755 /etc/init.d/zsunray-init sudo update-rc.d zsunray-init defaults 99 01
(7) more preparations on installation
sudo ln -s /usr/lib/jvm/java-6-sun/jre /etc/opt/SUNWut sudo mkdir -p /var/dt sudo rm -f /etc/opt/SUNWut/gmSignature sudo touch /etc/opt/SUNWut/gmSignature sudo chmod 600 /etc/opt/SUNWut/gmSignature
(8) link the global xkb settings into SRSS
We use the XKB data provided by SRSS in /opt/SUNWut/lib/xkb/, add all files from /usr/share/X11/xkb/ which are missing (but don't overwrite files already existing in /opt/SUNWut/lib/xkb/) and provide this mixture of files both as /opt/SUNWut/lib/xkb and as /usr/share/X11/xkb.
sudo cp -a /opt/SUNWut/lib/xkb /opt/SUNWut/lib/xkb.bak sudo mv /usr/share/X11/xkb /usr/share/X11/xkb.bak sudo cp -an /usr/share/X11/xkb.bak/* /opt/SUNWut/lib/xkb/ sudo rm -rf /opt/SUNWut/lib/xkb/compiled sudo ln -s /var/lib/xkb /opt/SUNWut/lib/xkb/compiled sudo ln -s /usr/bin/xkbcomp /opt/SUNWut/lib/xkb/xkbcomp sudo ln -s /opt/SUNWut/lib/xkb /usr/share/X11/
(9) patch and build the required kernel modules
- make sure to prepare for kernel module buiding:
sudo m-a -t prepare
- then download and apply the patches
wget -O /tmp/utadem.patch http://wiki.sun-rays.org/images/e/e8/Utadem.MR20090816.patch.txt wget -O /tmp/utio.patch http://wiki.sun-rays.org/images/1/11/Utio.MR20090816.patch.txt wget -O /tmp/utdisk.patch http://wiki.sun-rays.org/images/4/43/Utdisk-4.2-ubuntu910.txt cd /usr/src/SUNWut sudo patch -p0 </tmp/utadem.patch sudo patch -p0 </tmp/utio.patch sudo patch -p0 </tmp/utdisk.patch
- then compile the kernel modules (you need to have the linux-headers for your kernel installed, which should have been done with the "sudo m-a -t prepare" command above)
sudo make -C /usr/src/SUNWut/utadem clean default install sudo make -C /usr/src/SUNWut/utio clean default install sudo make -C /usr/src/SUNWut/utdisk clean default install sudo depmod -a
(10) start utsyscfg to let it create some links for you
sudo /etc/init.d/utsyscfg start sudo /etc/init.d/utsyscfg stop
NOTE: the message "utprodinfo: package SUNWuto not installed" can be displayed because some scripts are using ".../utprodinfo -r SUNWut?" test that have rpm commands included for find the installation path
(11) Finalize gdm setup
- comment out all pam entries in /etc/pam.d/gdm-2.20 referring to "pam_sunray_hotdesk.so" as hotdesking seems to be currently broken
- make sure that your /etc/gdm/gdm.conf contains the following things in [daemon]:
VTAllocation=false DynamicXServers=true Greeter=/usr/lib/gdm/gdmlogin RebootCommand= HaltCommand= SuspendCommand= HibernateCommand= XKeepsCrashing=/etc/opt/SUNWut/gdm/XKeepsCrashing.sunray
- if unsure you can try to use this version instead:
sudo wget -O /etc/gdm/gdm.conf http://wiki.sun-rays.org/images/0/05/Gdm41.txt
- link /etc/gdm/custom.conf:
sudo ln -sf /etc/gdm/gdm.conf /etc/gdm/custom.conf
(12) link libutdev.so.1 into /usr/lib to have USB mounting working properly
sudo ln -s /opt/SUNWut/lib/libutdev.so.1 /usr/lib/ sudo ldconfig
(13) on amd64 systems you have to perform some manual modifications
- install the i32-libs to get the 32bit SRSS binaries running:
sudo apt-get install ia32-libs sudo apt-get install ia32-sun-java6-bin sudo ln -sf /usr/lib/jvm/ia32-java-6-sun/jre /etc/opt/SUNWut
- as not all required 32bit libraries exist as ia32 packages we go and extract them from ubuntu 8.10 (i386) deb packages:
cd /tmp sudo wget http://www.ftp.uni-erlangen.de/pub/mirrors/ubuntu/pool/multiverse/o/openmotif/libmotif3_2.2.3-2_i386.deb sudo wget http://www.ftp.uni-erlangen.de/pub/mirrors/ubuntu/pool/main/libx/libxfont/libxfont1_1.3.3-1ubuntu1_i386.deb sudo wget http://www.ftp.uni-erlangen.de/pub/mirrors/ubuntu/pool/main/libf/libfontenc/libfontenc1_1.0.4-3_i386.deb sudo wget http://www.ftp.uni-erlangen.de/pub/mirrors/ubuntu/pool/universe/g/glib1.2/libglib1.2ldbl_1.2.10-19build1_i386.deb sudo alien --to-tgz lib*.deb sudo find . -name "lib*.tgz" -exec tar xzf {} \; sudo cp -a usr/lib/libXm.so.3* /opt/SUNWut/lib/ sudo cp -a usr/lib/libXfont.so.1* /opt/SUNWut/lib/ sudo cp -a usr/lib/libfontenc.so.1* /opt/SUNWut/lib/ sudo cp -a usr/lib/libglib-1.2.so.0* /opt/SUNWut/lib/ cd /usr/lib32 sudo ln -s /opt/SUNWut/lib/libXm.so.3 sudo ldconfig
(14) generate the compatlinks of SRSS
sudo /opt/SUNWut/lib/utctl.d/features/utcompatlinksctl enable sudo ldconfig
NOTE: if this command fails or outputs an error that some libraries are not found you have to make sure that you have the required libgdbm.so, libldap-2.4.so and liblber-2.4.so installed (also as ia32 compat libraries as explained in another section of this guide)
(15) restore the write permission of /tmp
as the debian package conversion process modified the permission of /tmp, we need to restore them via:
sudo chmod 1777 /tmp
(16) install the supplied version of tomcat 5
As the tomcat version in ubuntu 9.10 is already at version 6 but the SRSS 4.2 does not seem to work with that version, you have to install the version supplied with the SRSS instead. So do the following:
cd /opt sudo tar -xvzf /tmp/srss_4.2/Supplemental/Apache_Tomcat/apache-tomcat-5.5.20.tar.gz sudo ln -s /opt/apache-tomcat-5.5.20 /opt/apache-tomcat
(17) if doing a clean new install, go and configure SRSS
- Now you can configure SRSS.
sudo /opt/SUNWut/sbin/utadm -A <subnet> sudo /opt/SUNWut/sbin/utadm -L on sudo /opt/SUNWut/sbin/utconfig
- if asked during utconfig make sure to answer /opt/apache-tomcat for the tomcat path (if you followed the instructions above). Or to use the built-in version of Tomcat, answer /usr/share/tomcat6.
Configure Sun Ray Web Administration? ([y]/n)? y Enter Apache Tomcat installation directory [/opt/apache-tomcat]: /opt/apache-tomcat Enter HTTP port number [1660]: 1660 Enable secure connections? ([y]/n)? y Enter HTTPS port number [1661]: 1661 Enter Tomcat process username [utwww]: utwww Enable remote server administration? (y/[n])? y Configure Sun Ray Kiosk Mode? (y/[n])? n Configure this server for a failover group? (y/[n])? n
(18) check dhcpd.conf (if you want DHCP)
- make sure that /etc/dhcp3/dhcpd.conf contains the include statements for your added subnet/interface
- The default installation of Ubuntu includes appamor. The dhcp-server needs the permission to read the configuration files from /etc/opt/SUNWut/net/dhcp/. So add the following statements between the brackets in /etc/apparmor.d/usr.sbin.dhcpd3:
/etc/opt/SUNWut/net/dhcp/ r, /etc/opt/SUNWut/net/dhcp/** r,
(19) add an Xsession.d job for SRSS setup on Xnewt start
sudo wget -O /etc/X11/Xsession.d/10SUNWut http://wiki.sun-rays.org/images/d/d5/10SUNWut.41b.sh
(20) install and setup pulseaudio for audio support
- install of required packages
sudo apt-get install pavucontrol pavumeter paman padevchooser paprefs pulseaudio \
pulseaudio-utils pulseaudio-module-gconf pulseaudio-module-udev \
pulseaudio-module-x11 libasound2-plugins gstreamer0.10-pulseaudio \
ubuntu-sounds pulseaudio-esound-compat alsaplayer-alsa
- create a global 'utpulse.pa' file in /opt/SUNWut/lib with the following content
load-module module-oss device=UTAUDIODEV playback=1 record=0 fragment_size=8192 load-module module-native-protocol-unix
- create a pulseaudio setup script '66SUNW-pulseaudio' in /etc/X11/Xsession.d with the following content:
set +e
pkill -U $USER esd
pkill -U $USER pulseaudio
set -e
unset LD_PRELOAD
if [ "${UTAUDIODEV}" != "" ] ; then
if [ ! -d ${HOME}/.pulse ] ; then
mkdir ${HOME}/.pulse
fi
# create pulseaudio configuration for utaudio
PULSECONF=${HOME}/.pulse/default.pa
sed "s|UTAUDIODEV|$UTAUDIODEV|g" /opt/SUNWut/lib/utpulse.pa > ${PULSECONF}
# create asoundrc for pulseaudio redirection
ASOUNDRC=${HOME}/.asoundrc
echo -n > ${ASOUNDRC}
echo "pcm.!default { " >> ${ASOUNDRC}
echo " type pulse" >> ${ASOUNDRC}
echo "}" >> ${ASOUNDRC}
echo "ctl.!default { " >> ${ASOUNDRC}
echo " type pulse" >> ${ASOUNDRC}
echo "}" >> ${ASOUNDRC}
else
if [ -d ${HOME}/.pulse ] ; then
rm -f ${HOME}/.pulse/default.pa
fi
fi
(21) add 'drm' module to /etc/modules to get direct rendering applications running (e.g. glxgears)
To get direct rendering applications running it might be required to add the 'drm' module to /etc/modules so that it is loaded upon start of your server. So please check via 'lsmod' if the drm module is present after reboot and if not add it to /etc/modules.
(22) finally you can start the SRSS by issuing the following commands
sudo /etc/init.d/gdm restart sudo /etc/init.d/zsunray-init stop sudo /etc/init.d/zsunray-init start
in case this doesn't work, make sure to reboot your system.
Installation SRWC (Windows Connector)
The SRSS comes with a SunRay Windows connector package (srwc_X.X) which allows to connect to windows machines via RDP. This short explaination should show how to install it under Ubuntu as well.
(1) Download and Unzip SRWC package
cd /tmp .... (download the SRWC from the same URL than the SRSS package) unzip srwc_2.2_linux.zip
(2) Convert all .rpm packages to .deb packages
NOTE: ignore any error or warning caused during the following package conversion process. Especially the 'alien' conversion will throw out some errors which you can ignore as long as the conversion doesn't stop.
- on amd64:
sudo find srwc_2.2 -name "SUNW*.rpm" -exec alien -d -g {} \;
sudo find SUNW*-* -name control -exec sed -i "s/i386/amd64/g" {} \;
sudo find SUNW*-*/ -maxdepth 0 -name "SUNW*-?.?" -exec sh -c "cd {} ; debian/rules binary-arch" \;
- on i386:
sudo find srwc_2.2 -name "SUNW*i386.rpm" -exec alien -d {} \;
(3) install of generated .deb packages
sudo find . -name "sunwuttsc*deb" -exec dpkg -i {} \;
(4) retrieve/install required libraries
As uttsc 2.2 requires an older version of libcrypto (0.9.7) and libstdc++ (5) we have to retrieve these versions and install them in /opt/SUNWuttsc/lib:
cd /tmp wget http://www.ftp.uni-erlangen.de/pub/mirrors/ubuntu/pool/universe/o/openssl097/libssl0.9.7_0.9.7g-5ubuntu1.1_i386.deb sudo alien --to-tgz libssl0.9.7_0.9.7g-5ubuntu1.1_i386.deb tar xzf libssl0.9.7-0.9.7g.tgz sudo cp -a usr/lib/libcrypto.so.0.9.7 /opt/SUNWuttsc/lib/ wget http://de.archive.ubuntu.com/ubuntu/pool/universe/g/gcc-3.3/libstdc++5_3.3.6-17ubuntu1_i386.deb sudo alien --to-tgz libstdc++5_3.3.6-17ubuntu1_i386.deb sudo tar xzf libstdc++5-3.3.6.tgz sudo cp -a usr/lib/libstdc++.so.5* /opt/SUNWuttsc/lib/
(5) restore the write permission of /tmp
as the debian package conversion process modified the permission of /tmp, we need to restore them via:
sudo chmod 1777 /tmp
(6) execute uttscadm to configure the installation
sudo /opt/SUNWuttsc/sbin/uttscadm -c
NOTE: if you are asked for the libcrypto.so location enter /opt/SUNWuttsc/lib/libcrypto.so.0.9.7
Update Installation
As SUN is releasing updates to the SRSS packages via their own update process we have to manually install certain updates. The process of bringing the SRSS 4.2 suite to the very latest version ought to be listed here.
Update 140995-01
- retrieve/unpack the patch updates:
cd /tmp .... (download the patch update for the core package from [http://sunsolve.sun.com/pdownload.do?target=140995-01&method=h) unzip 140995-01.zip
- convert the .rpm to .deb packages
on amd64 (64bit):
sudo find 140995-01 -name "SUNW*.rpm" -exec alien -d -g {} \;
sudo find SUNW*-* -name control -exec sed -i "s/i386/amd64/g" {} \;
sudo find SUNW*-*/ -maxdepth 0 -name "SUNW*-?.?" -exec sh -c "cd {} ; debian/rules binary-arch" \;
on i386 (32bit):
sudo find 140995-01 -name "SUNW*i386.rpm" -exec alien -d {} \;
- install the update
sudo find . -name "sunw*deb" -exec dpkg -i {} \;
- apply patches to finalize the update
wget -O /tmp/Patch-patch.txt http://wiki.sun-rays.org/images/5/51/Patch-patch.txt wget -O /tmp/Patch-SUNWutref.txt http://wiki.sun-rays.org/images/1/15/Patch-SUNWutref.txt cd /opt/ sudo patch -p0 </tmp/Patch-SUNWutref.txt sudo patch -p0 </tmp/Patch-patch.txt
- if you are on a 64bit system make sure to reapply the above mentioned patch (see (16)) to /opt/SUNWut/lib/utctl.d/features/utcompatlinksctl again then run "/opt/SUNWut/lib/utctl.d/features/utcompatlinksctl enable" again
- make sure the patch in (25) and (26) are reapplied as the update might have overwritten it again.
- restart the SRSS with
sudo /etc/init.d/zsunray-init stop sudo /etc/init.d/zsunray-init start
- update the firmware in /tftpboot
sudo /opt/SUNWut/sbin/utfwadm -A -a -N all
or for GUI firmware:
sudo /opt/SUNWut/sbin/utfwadm -A -a -N all -f /opt/SUNWut/lib/firmware_gui
Update 143216-02
This update provides an updated uttsc (terminal server client) in version 2.2 für the SRSS 4.2 line:
- retrieve/unpack the patch updates:
cd /tmp .... (download the patch update for the core package from [http://sunsolve.sun.com/pdownload.do?target=143216-02&method=h) unzip 143216-02.zip
- convert the .rpm to .deb packages
on amd64 (64bit):
sudo find 143216-02 -name "SUNW*.rpm" -exec alien -d -g {} \;
sudo find SUNW*-* -name control -exec sed -i "s/i386/amd64/g" {} \;
sudo find SUNW*-*/ -maxdepth 0 -name "SUNW*-?.?" -exec sh -c "cd {} ; debian/rules binary-arch" \;
on i386 (32bit):
sudo find 143216-02 -name "SUNW*i386.rpm" -exec alien -d {} \;
- install the update
sudo find . -name "sunwuttsc*deb" -exec dpkg -i {} \;
- reconfigure uttscadm
sudo /opt/SUNWuttsc/sbin/uttscadm -c
NOTE: if you are asked for the libcrypto.so location enter /opt/SUNWuttsc/lib/libcrypto.so.0.9.7
Tips and Tricks
For general tips and tricks on running a SRSS on Ubuntu have a look at the SRSS on Ubuntu - Tips and Tricks section in this wiki.
