INSTALLATION NOTES FOR GWARE (I) - GNOME 2.22.0 for Slackware 12.1 INTRODUCTION --------------------------------------- These are instructions for installing GWARE GNOME 2.22.0 on Slackware 12.1 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.1. 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/glib2-2.14.6-i486-3.tgz l/desktop-file-utils-0.14-i486-1.tgz l/libwnck-2.18.3-i486-1.tgz xap/gucharmap-1.10.0-i486-1.tgz The following packages have been removed from GWARE. If you have a previous installation, then please removepkg them before installing. Packages from H: scrollkeeper (replaced by rarian) xml-simple (included with perl now) xulrunner-1.8.0.4-source (replaced by xulrunner-1.8.1.13) Also any other packages from previous releases: ls -1 /var/log/packages/*gw? | grep -v gwI You will need to remove fam from inetd.conf and rpc. 3. System Services and Files GNOME 2.22.0 utilizes several system services (dbus, hal, avahi, system- tools-backends) for added functionality. Slackware 12.1 includes dbus and hal. Avahi and system-tools-backends are installed 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 GNOME System Tools Backend: /etc/rc.d/rc.system-tools-backends 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.1/2.22.0/get-gware-I.sh sh get-gware-I.sh This is optional, but you should do it. wget ftp://ftp.gware.org/12.1/2.22.0/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. Install GWARE Packages (NB: You need to be root) upgradepkg --install-new orbit* gconf-2* upgradepkg --install-new *.tgz 4. Add user and groups (if they are not already on your machine) groupadd avahi useradd avahi -g avahi 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 sh /etc/rc.d/rc.system-tools-backends 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 and system-tools-backends 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 if [ -x /etc/rc.d/rc.system-tools-backends ]; then if [ -w /var/run/system-tools-backends.pid ]; then rm /var/run/system-tools-backends.pid ; fi sh /etc/rc.d/rc.system-tools-backends 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 if [ -x /etc/rc.d/rc.system-tools-backends ]; then sh /etc/rc.d/rc.system-tools-backends stop rm -f /var/run/system-tools-backends.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. 7. Optional package installation A patched shared-mime-info is available that will take care of some warning messages on boot up caused by newer "unoffical" MIME types registered by nautilus. This package is not required and no functionality is gained by installing it. It only suppresses warnings. ftp://ftp.gware.org/12.1/2.22.0/extra/shared-mime-info-0.23-i486-1gwI.tgz upgradepkg --install-new shared-mime-info-0.23-i486-1gwI.tgz 8. 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. Shut down the included system services. sh /etc/rc.d/rc.avahidaemon stop sh /etc/rc.d/rc.avahidnsconfd stop sh /etc/rc.d/rc.system-tools-backends stop 3. Restore Original Packages All you need to do is remove the GWARE packages and restore the original ones. cd /var/log/packages removepkg *gwH installpkg /path/to/originals/*.tgz 4. Cleanup System Files. No system files are modified by GWARE. You can safely delete these files: /etc/rc.d/rc.avahidaemon /etc/rc.d/rc.avahidnsconfd /etc/rc.d/rc.system-tools-backends /etc/rc.d/rc.gware If you were using gdm, be sure to remove any modifications to /etc/rc.d/rc.4. 5. That's it!