INSTALLATION NOTES FOR GWARE (G) - GNOME 2.12.3 for Slackware 10.2 INTRODUCTION --------------------------------------- These are instructions for installing GWARE GNOME 2.12.3 on Slackware 10.2 systems. If you have installed any GNOME packages other than those provided by Slackware, such as Dropline, GSB, Linuce or others, please see the respective documentation on how to restore your system to normal. We do not support upgrading from any other GNOME installations than the stock 2.6 packages. INSTALLING GWARE --------------------------------------- 1. Prerequisites You need the latest versions of these from Slackware+patches slackware/ap/cdparanoia slackware/ap/sgml-tools slackware/d/pkgconfig slackware/d/python slackware/l/audiofile slackware/l/esound slackware/l/libart_lgpl slackware/l/libexif slackware/l/libgsf slackware/l/libjpeg slackware/l/libpng slackware/l/libtiff slackware/l/libxslt slackware/l/shared-mime-info slackware/l/startup-notification slackware/n/cyrus-sasl slackware/xap/mozilla slackware/xap/xine-lib Patches: GWARE requires the patches/ available on any Slackware mirror. 2. Package Conflicts First and foremost you need to be aware that GWARE will upgrade some stock packages outside of the gnome/ package set. Following is a list of each package. (You do not need these installed) slackware/a/udev-064-i486-2.tgz slackware/l/atk-1.9.1-i486-1.tgz slackware/l/glib2-2.6.4-i486-1.tgz slackware/l/gtk+2-2.6.7-i486-1.tgz slackware/l/libglade-2.4.0-i486-1.tgz slackware/l/libgsf-1.12.1-i486-1.tgz slackware/l/libxml2-2.6.22-i486-1 slackware/l/pango-1.8.1-i486-1.tgz These are the packages included in a stock Slackware installation. If you applied official patches or installed different versions yourself, adjust the version/build number accordingly. Please note that it is YOUR responsibility to know the packages on your system. 3. System Services and Files GNOME 2.12.3 utilizes several system services (fam, hal, etc) for advanced functionality. The GWARE packages install these services so that they will be started when the system boots, which requires editing some files. Following is a list of each service and the files it installs or edits. fam Modifies /etc/inetd.conf and /etc/rpc. For details see the INSTALL file in the doc directory. Note that these files are backed up to /etc/.before.gware prior to modification. howl Installs the init script /etc/rc.d/rc.howl, and adds a call to it in /etc/rc.d/rc.local. dbus Installs the init script /etc/rc.d/rc.messagebus, and adds a call to it in /etc/rc.d/rc.local. hal Installs the init script /etc/rc.d/rc.hald, and adds a call to it in /etc/rc.d/rc.local. udev Replaces the stock udev-064. Works identical to the stock package. Adds /etc/rc.d/rc.udev.new. Read below for more info. 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/10.2/2.12.3/get-gware-G.sh chmod +x get-gware-G.sh ./get-gware-G.sh This is optional, but you should do it. wget ftp://ftp.gware.org/10.2/2.12.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. If you have gconf (say, from the stock Slackware GNOME 2.6 packages) you need to shut it down before installing. gconftool-2 --shutdown 3. Install GWARE Packages (NB: You need to be root) upgradepkg --install-new *tgz 4. Start System Services GNOME 2.12.3 utilizes several system services (fam, hal, etc) for advanced functionality. The GWARE packages install these services so that they will be started when the system boots. Rebooting should ensure that they are started properly, but you can start them manually if you wish. sh /etc/rc.d/rc.howl start sh /etc/rc.d/rc.messagebus start # only if using kernel 2.6.x sh /etc/rc.d/rc.hald start # only if using kernel 2.6.x The fam daemon is started via inetd. When the fam package installs it it restarts inetd to ensure famd is started. - New in this release: udev. It is recommended that you enable udev, it will allow automounting of inserted media, usb thumb drives, cameras, etc. It is not necessary but we highly recommend you use it. If you have not enabled udev before, you can do the following: mv /etc/rc.d/rc.udev.new /etc/rc.d/rc.udev chmod +x /etc/rc.d/rc.udev # It's a good idea to reboot now, but you could also do: sh /etc/rc.d/rc.udev start - Note for kernel 2.4.x users - hal requires kernel 2.6.x, if you allow the hald/messagebus scripts to run at startup, you will likely have problems with your desktop. Please do the following to make sure they do not start: chmod -x /etc/rc.d/rc.messagebus chmod -x /etc/rc.d/rc.hald 5. Enjoy! UNINSTALLING GWARE --------------------------------------- 1. Gather Original Packages Before removing the GWARE packages be sure to have the originals on hand. For stock packages use your Slackware CD or a local mirror. For any others, you're on your own ;). 2. Restore Original Packages All you need to do is dump the GWARE packages and restore the original ones. removepkg *gwG installpkg /path/to/originals/*tgz 3. Cleanup System Files. If you're lazy it's probably safe to skip these steps, but we don't encourage that. As mentioned above, several system files are modified. Here is how to clean them manually: /etc/rpc Find the line containing 'famd' and remove it. /etc/inetd.conf Find the line containing 'famd' and remove it. /etc/rc.d/rc.local Locate all the lines referencing 'rc.messagebus', 'rc.hald', 'rc.howl', and remove them. Make sure you remove from 'if' to 'fi'. Alternatively if you have not modified /etc/rpc or /etc/inetd.conf since GWARE was installed, then you can restore the backups created by GWARE. mv /etc/rpc.before.gware /etc/rpc mv /etc/inetd.conf.before.gware /etc/inetd.conf Once you've done this delete the files /etc/rc.d/rc.howl /etc/rc.d/rc.messagebus /etc/rc.d/rc.hald