File: finger.info,  Node: Basic Installation,  Next: Site Specific Functions,  Up: Installation

Basic Installation
==================

Here are the steps that you will need to take in order to install
GNU Finger:

  1. Change your working directory to be the top of the GNU Finger
     sources.  If you have placed the source in `/src/gnu/finger'
     you would type `cd /src/gnu/finger'.

  2. Edit the file `./config.h'.  This file contains the basic
     configuration information for GNU Finger.  You need to specify
     the correct values for `EtcDir', `BinDir', `FingerDir', and
     `MugShotPath'.  You should also choose one of the face formats
     present at the end of the file.

  3. Type ```make''' in the toplevel directory.  This builds
     `./lib/libfinger.a' and the main programs in `./src':
     `finger', `fingerd', `in.fingerd', and `in.cfingerd'.

  4. Pick a machine which will be the local Finger server for your
     site.  On that machine, as the superuser, do `make server' in
     the ./src directory.  If the install-finger script didn't
     already do so, create the `clients' file, and install it in
     /usr/spool/fingerdir or whatever you specified as FingerDir.

  5. For each Finger client, login to that client, change
     directories to the ./src directory, and as
     the superuser type `make client'.

     Each of the Finger clients must be able to run the client
     finger daemon and the GNU Finger reply daemon.  In order to do
     this, each Finger client must have:

       1. the client finger daemon installed in
          ``EtcDir'/in.cfingerd',

       2. the reply daemon installed in ``EtcDir'/in.fingerd',

       3. an `/etc/inetd.conf' file which contains references to
          these programs,

       4. an `/etc/services' file which mentions the correct TCP
          port for `in.cfingerd',

       5. a `/usr/spool/fingerdir/serverhost' file which
          contains the name of the Finger server host,

       6. the inetd daemon restarted, so that server requests can
          be answered.

     The easiest way to insure that all of this is done correctly
     is to login to each client, and then as the superuser do `make
     client'.

     [NOTE. The `server' and `client' targets change system configuration
     files. If you are uncomfortable with this do `make install' and 
     `make cinstall' instead.  These will just install binaries and
     manual pages and leave it up to you to make the necessary entries
     in /etc/inetd.conf, /etc/services, and FingerDir/serverhost.
     I haven't tested `make server' and `make client', and the scripts
     that do the messy work are unchanged from the original GNU finger
     release.				-- A. Stolcke, 7/1/92 ]

  6. As the superuser, start the server daemon (`fingerd'). 
     Depending on the number of clients, the server should be
     storing information about all the client machines in about 30
     seconds to 2 minutes, at which time `finger' will be able to
     report it.

  7. If you elected to support the face option, now might be a good
     time to install the mugshots.  But first, try getting a face
     from another site running GNU Finger!  For example, you might
     try

          `finger -face bart@icsi.berkeley.edu'


