
Overview of gstat/gpresd
------------------------

This package is distributed under the GNU General Public License.  See
COPYING for details.

The gpresd is a presence server for Gale.  It keeps track of user presence
messages for one or more domains, and allows users to query the current
status of one or more Gale users via gstat.

For more information on gstat/gpres, see http://www.litech.org/gstat/.

For more information on Gale, see http://www.gale.org/.

Installing gstat/gpres
----------------------

gstat is the client, and should be installed on all machines with Gale
installed.  gpresd is the server, and only needs to run on servers with
their own domains.  Each domain should be serviced by exactly one instance
of gpresd.  gpresd can service additional domains besides the default by
listing them as arguments on the command line; however, it will need to
have access to one key per domain, as described below.

*** MAKE SURE YOU ARE RUNNING AT LEAST GALE 0.99 ***

Earlier versions of Gale had bugs that prevented the correct operation
of gstat/gpresd.

First, compile and install the package.  Use:

./configure
make
make install

If you're installing on a client machine, use:

./configure --disable-gpresd
make
make install

This will prevent gpresd from being built and installed on machines that
don't need to have it.

Now you need to have a key named "domain@<domain>", e.g. "domain@litech.org".
Create it by doing the following with an account that has access to the
private key for the domain (probably root):

gkgen -r /usr/local/etc/gale/auth/private/domain@<domain>
  -u /usr/local/etc/gale/auth/local/domain@<domain> domain 'Domain server'
chmod gale.gale /usr/local/etc/gale/auth/local/domain@<domain>
chmod gale.gale /usr/local/etc/gale/auth/private/domain@<domain>

Now you may run gpresd.  It should be run as the special Gale user you created
when installing Gale the first time.  For example:

su -c '/usr/local/sbin/gpresd' gale

That should be it.  Now gpresd will collect information on users in your domain
and store it for query.  Note that gpresd will not know about client instances
that were started before it was until the client changes its presence.

To test, start a new gsub and try querying yourself with gstat.  It should
look something like this:

-------------------------
	tiamat:~$ gsub
	tiamat:~$ ! 2000-05-19 20:02:36 gsub notice: connected to tiamat.litech.org
(24.95.169.15:11512)

	tiamat:~$ gstat lutchann

	== lutchann@litech.org ==
	Full name: Nathan Lutchansky
	Client: gsub/0.91b
	Logged in at 2000-05-19 20:02:36 on tiamat as lutchann on tty 12
	Status: in/present
	tiamat:~$
-------------------------

If you have any problems, please email me at <lutchann@litech.org> or contact
me via Gale.
