From ce515da4227350ea2ceb51bbec536fad1cd301a1 Mon Sep 17 00:00:00 2001 From: fredrik Date: Wed, 2 May 2007 14:00:38 +0000 Subject: [PATCH] Added INSTALL.{gaim,applet}. git-svn-id: svn+ssh://svn.dolda2000.com/srv/svn/repos/src/doldaconnect@996 959494ce-11ee-0310-bf91-de5d638817bd --- doc/INSTALL | 11 +++++--- doc/INSTALL.applet | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ doc/INSTALL.gaim | 33 ++++++++++++++++++++++++ 3 files changed, 117 insertions(+), 3 deletions(-) create mode 100644 doc/INSTALL.applet create mode 100644 doc/INSTALL.gaim diff --git a/doc/INSTALL b/doc/INSTALL index fa72c7d..f24afdc 100644 --- a/doc/INSTALL +++ b/doc/INSTALL @@ -69,6 +69,11 @@ configuration file. On most Linux distributions, the file pam.d-doldacond in the contrib directory can be installed as /etc/pam.d/doldacond and work perfectly. +The GNOME applet and GAIM plugin are marked as experimental not so +much because there is anything wrong with them, but because it is +tricky to install them. Please see the seperate `INSTALL.applet' and +`INSTALL.gaim' files for instructions. + Customizing the configuration file When installing Dolda Connect, the configuration file is normally @@ -146,8 +151,8 @@ really should make sure to set up some firewalling rules. Note that doldacond does *not* support tcp-wrappers, but it does support very simple internal firewalling in the form of the -"ui.onlylocal" options. When "ui.onlylocal" is set to true, the -daemon will only accept UI connections over a loopback interface. That +"ui.onlylocal" options. When "ui.onlylocal" is set to true, the daemon +will only accept UI connections over a loopback interface. That includes 127.0.0.1, ::ffff:127.0.0.1, ::1 and Unix sockets. Starting the daemon @@ -175,5 +180,5 @@ allow you in if not all TTH hashes are calculated. -This documented was last updated 2007-04-11, reflecting release 0.3 of +This document was last updated 2007-04-11, reflecting release 0.3 of Dolda Connect. diff --git a/doc/INSTALL.applet b/doc/INSTALL.applet new file mode 100644 index 0000000..7d17c34 --- /dev/null +++ b/doc/INSTALL.applet @@ -0,0 +1,76 @@ + GNOME Applet Installation + +Because of how GNOME works, special care is required when installing +the transfer monitor applet. The problem lies in the fact that GNOME +only looks for applets in certain directories, which usually does not +/usr/local, whither Dolda Connect installs by default. + +A GNOME applet is a CORBA server, which must be found by GNOME's +Bonobo activation daemon. By default, the Bonobo activation daemon +looks in lib/bonobo/servers inside its own installation prefix. Since +GNOME is usually installed in /usr, that would become +/usr/lib/bonobo/servers on most systems, but it needs not necessarily +be, and some systems have GNOME installed in /opt. + +Since the default prefix for autoconf programs such as Dolda Connect +is /usr/local, the server description file installed by Dolda Connect +will not be found by the Bonobo activation daemon. There are a number +of ways to fix this: + +1. Install Dolda Connect in /usr. This is ugly and not recommended, +since /usr is normally reserved for programs shipped by the system +maintainers. It does work, though, and it is easy. To do that, run +./configure with a `--prefix=/usr' argument. + +2. Move the applet files only to /usr after normal installation in +/usr/local. This, too, is ugly and not recommended, but it might be +considered slightly less ugly than #1, since the bulk of Dolda Connect +still resides in /usr/local. To do that, move +/usr/local/libexec/dolcon-trans-applet to /usr/libexec, and +/usr/local/lib/bonobo/servers/Dolcon_Transferapplet_Factory.server to +/usr/lib/bonobo/servers. Then, edit the latter file and replace every +instance of /usr/local with /usr. + +3. Add /usr/local to your system's GNOME prefixes. Doing so involves +setting the environment variable GNOME2_PATH to include +/usr/local. How to do that differs from system to system, and it is +not possible for this document to contain information on how to do +that on any given system. It is probably by far the best solution, +however. + +4. Add /usr/local to your user profile's GNOME prefixes. As above, +this involves setting GNOME2_PATH to include /usr/local, but it is +quite easy to do so in your own ~/.profile or ~/.bash_profile instead +of editing the system-wide configuration. It is also the best idea if +you have installed Dolda Connect in your own home directory rather +than in /usr/local. Again, though, the exact steps to do this differs +from system to system and also depend on what shell you use. It is +extra noteworthy, however, that Ubuntu users may have rather severe +problems with this [1]. + +Remember, always after changing the system of user profile with +regards to environment variables, you would need to log out and back +in again to get the changes in all processes. It is of note, however, +that the Bonobo activation daemon sometimes linger, and therefore does +not get restarted when logging back in again. If this happens, just +kill it (with `killall bonobo-activation-server'), and it will be +restarted from a process having the correct environment. + + Additional applet notes + +The applet is mostly working, but it still does have a few things that +remain to be implemented. First of all, it only handles password-less +authentication, so a setup using PAM will not work. Unix socket +authentication, `authless' authentication and Kerberos V +authentication all work, however. Last, there is no preference dialog +to set which Dolda Connect server to connect to. If you run a local +server using Unix sockets, it will not be a problem. Otherwise, you +need to use the DCSERVER environment variable to specify which server +to connect to. + +[1] See for details. + + + +This document was last updated 2007-05-02, reflecting release 0.4 of +Dolda Connect. diff --git a/doc/INSTALL.gaim b/doc/INSTALL.gaim new file mode 100644 index 0000000..9e52b7c --- /dev/null +++ b/doc/INSTALL.gaim @@ -0,0 +1,33 @@ + Gaim Plugin Installation + +Because of how Gaim works, special care is required when installing +the Dolda Connect chat plugin for Gaim. The basic problem is the same +as with the GNOME applet, in that the set of directories that Gaim +searches for plugins usually does not include the directories into +which Dolda Connect is installed. + +However, the Gaim situation is even worse than that with GNOME, since +Gaim cannot be configured to search additional directories. Therefore, +the plugin file must be installed into one of the directories that +Gaim does look in. + +As of version 2.0.0-beta6 of Gaim, Gaim searches only two directories: +The `lib/gaim' directory in its installation prefix (usually +`/usr/lib/gaim'), and the $HOME/.gaim/plugins directory. + +Therefore, there are only two things which can be done: + +1. Install Dolda Connect in /usr. As mentioned in INSTALL.applet, this +is ugly and not recommended, but it does work and is easy. + +2. You must either copy, move, link or symlink the file +libdolcon-gaim.so which Dolda Connect typically installs into +/usr/local/lib/gaim into either ${gaim-prefix}/lib/gaim or +$HOME/.gaim/plugins. For example, you can run the following command, +which will work for most cases: +ln -s /usr/local/lib/gaim/libdolcon-gaim.so $HOME/.gaim/plugins + + + +This document was last updated 2007-05-02, reflecting release 0.4 of +Dolda Connect. -- 2.11.0