INSTALLATION NOTES FOR GWARE (K) - GNOME 2.24.3 for Slackware 12.2


INTRODUCTION
---------------------------------------
These are instructions for installing GWARE GNOME 2.24.3 on Slackware 12.2
systems. If you have installed any GNOME packages other than those provided
by Slackware, please see the respective documentation on how to restore your
system to normal. We do not support upgrading from any other GNOME
installations.

1. Prerequisites
   Slackware 12.2 with latest patches as of 3/31/2009.

2. Package Conflicts
   First and foremost you need to be aware that GWARE will upgrade some stock
   Slackware packages. The following is a list of each package. You do not
   need to have these installed, but there's a good chance you already do.

    l/cairo-1.6.4-i486-1
    l/enchant-1.4.2-i486-1
    l/glib2-2.16.6-i486-2_slack12.2
    l/gmime-2.2.23-i486-1
    l/gst-plugins-base-0.10.21-i486-1
    l/gstreamer-0.10.21-i486-1
    l/gtk+2-2.12.12-i486-1
    l/hal-0.5.11-i486-3
    l/icon-naming-utils-0.8.7-i486-1
    l/libwnck-2.18.3-i486-1
    l/pango-1.20.5-i486-1
    l/pygtk-2.12.1-i486-2
    l/tango-icon-theme-0.8.1-noarch-1
    l/vte-0.16.12-i486-1
    xap/gucharmap-1.10.0-i486-1

3. Upgrading
   The following packages have been removed from GWARE, or renamed. If you 
   have a previous installation, then please removepkg them before installing.

    gconf (renamed to GConf)
    gettext (renamed to perl-locale-gettext)
    gnome-system-tools (removed)
    system-tools-backends (removed)
    xml-simple (included with perl now)
    xml-twig (renamed to perl-xml-twig)   

   Also any other packages from previous releases:

	ls -1 /var/log/packages/*gw? | grep -v gwK

   You will need to remove fam from inetd.conf and rpc.

4. System Services and Files
   GNOME 2.24.3 utilizes several system services (dbus, hal, avahi) for added
   functionality. Slackware 12.2 includes dbus and hal. Avahi is installed with
   GWARE.  GNOME 2.24.3 now makes use of PolicyKit/ConsoleKit.  A recompiled
   version of hal with support for PolicyKit/ConsoleKit is included with GWARE.
   The GWARE packages install these services so that they will not be started 
   when the system boots. We wanted to be as unintrusive as possible. (You 
   have to add them to rc.local[_shutdown], see /usr/doc/gware-1.0/README). 
   The following is a list of each service and the files GWARE installs.

   Avahi:
	/etc/rc.d/rc.avahidaemon
	/etc/rc.d/rc.avahidnsconfd

INSTALLING GWARE
---------------------------------------
1. Download GWARE
   Create a directory where you want the packages to be stored, cd to
   it, and download the GWARE GNOME package set to the current directory.

	mkdir gware 
	cd gware
	wget ftp://ftp.gware.org/12.2/2.24.3/get-gware-K.sh
	sh get-gware-K.sh

   This is optional, but you should do it.

	wget ftp://ftp.gware.org/12.2/2.24.3/packages/CHECKSUMS.md5
	md5sum -c CHECKSUMS.md5

2. Prepare to Install
   If you are running any X sessions, be it GNOME or any other environment,
   close them. It is also recommended to shutdown gconf.

	gconftool-2 --shutdown

3. Add user and groups (if they are not already on your machine)

	groupadd -g 87 polkituser
	useradd -u 87 -g 87 -s /bin/false -d /var/run/PolicyKit polkituser
	groupadd -g 214 avahi
	useradd -u 214 -g 214 -c "Avahi" -d /dev/null -s /bin/false avahi

4. Install GWARE Packages (NB: You need to be root)
	
	upgradepkg --install-new glib2* ORBit* GConf*
	upgradepkg --install-new *.tgz

5. Start System Services
   Rebooting should ensure that they are started properly, but you can start
   them manually if you wish.

	sh /etc/rc.d/rc.messagebus restart <- Only necessary if you did not reboot.
	sh /etc/rc.d/rc.avahidaemon start
	sh /etc/rc.d/rc.avahidnsconfd start

6. Optional /etc/rc.d modifications
    GWARE does not modify any of the stock Slackware init scripts.  If you would
    like to have avahi started automatically, then make the following 
    modifications to rc.local and rc.local_shutdown.  Create and +x rc.local and
    rc.local_shutdown if necessary.  For gdm users (graphical login) a small 
    modification needs to made to rc.4.

	Add to rc.local
	
	if [ -x /etc/rc.d/rc.avahidaemon ]; then
	  if [ -w /var/run/avahi-daemon/pid ]; then rm /var/run/avahi-daemon/pid ; fi
	  sh /etc/rc.d/rc.avahidaemon start
	fi
	if [ -x /etc/rc.d/rc.avahidnsconfd ]; then
	  if [ -w /var/run/avahi-dnsconfd.pid ]; then rm /var/run/avahi-dnsconfd.pid ; fi
	  sh /etc/rc.d/rc.avahidnsconfd start
	fi
	
	Add to rc.local_shutdown
	
	if [ -x /etc/rc.d/rc.avahidaemon ]; then
	  sh /etc/rc.d/rc.avahidaemon stop
	  rm -f /var/run/avahi-daemon/pid
	fi
	
	if [ -x /etc/rc.d/rc.avahidnsconfd ]; then
	  sh /etc/rc.d/rc.avahidnsconfd stop
	  rm -f /var/run/avahi-dnsconfd.pid
	fi
	
	Modify rc.4
	
	GDM is likely to crash if it recieves a SIGKILL (i.e. telinit 3).  The only known 
	fix at this time is to prepend G_SLICE=always-malloc to the exec line in /etc/rc.d/rc.4.  
	
	Either manually change the line in /etc/rc.d/rc.4:
	OLD:
	exec /usr/sbin/gdm -nodaemon
	NEW:
	G_SLICE=always-malloc exec /usr/sbin/gdm -nodaemon
	
	Or you can run the following commands in a root terminal:
	cp /etc/rc.d/rc.4 /etc/rc.d/rc.4.gware
	sed -ie '/^\s*exec / s:exec /usr/[s]*bin/gdm -nodaemon:G_SLICE=always-malloc &:' /etc/rc.d/rc.4
	
	Remove any old rc.gware and *.gware files remaining if you upgraded. Also check
        /etc for any *.new files that may need to be moved in to place.