Installing the utilities

The following steps are necessary for a complete installation. You may need root access for these.

1. Install the utilities by invoking

   make install install-info
   

   These targets indicate:

   install

   Installs all programs into their configured locations (see section Where GNATS lives).

   install-info

   Installs `info' files into their configured locations (see section Where GNATS lives).

   After you have installed GNATS, you can remove the object files with

   make clean
   

2. Place the following lines in the file `default.el' in your Emacs lisp library, or instruct your local responsible parties to place the lines in their local editions of `.emacs':

   (autoload 'edit-pr "gnats" 
      "Command to edit a problem report." t)
   (autoload 'view-pr "gnats"
      "Command to view a problem report." t)
   (autoload 'unlock-pr "gnats"
      "Unlock a problem report." t)
   (autoload 'query-pr "gnats"
      "Command to query information about problem reports." t)
   (autoload 'send-pr-mode "send-pr"
      "Major mode for sending problem reports." t)
   (autoload 'send-pr "send-pr"
      "Command to create and send a problem report." t)
   

   Emacs lisp files are byte-compiled if make can find Emacs on your local system.
3. Create an account for a user named GNATS. This user must have an entry in the file `/etc/passwd'. The home directory for this account should be the same directory you specified for GNATS_ROOT in the file `Makefile.in'. Also, the default PATH for this user should contain `exec-prefix/bin' and `exec-prefix/lib/gnats'.
4. Allow the new user gnats access to cron and at. To do this, add the name gnats to the files `cron.allow' and `at.allow', which normally reside in the directory `/var/spool/cron'. If these files do not exist, make sure gnats does not appear in either of the files `cron.deny' and `at.deny' (in the same directory). For the following steps, log in as gnats.
   • Edit the files `categories', `resonsible', and `submitters' in the directory `GNATS_ROOT/gnats-adm' (see section Changing your local configuration) to reflect your local needs. Be sure to run mkcat after you update the `categories' file (see section Adding a problem category). Note: these templates are not installed if they already exist, i.e. if you are upgrading. See section Upgrading from older versions.
   • If you wish to install the GNATS user tools on other machines on your network, see section Installing the user tools.
5. Create a crontab entry that periodically runs the program queue-pr with the `--run' option. For example, to run `queue-pr --run' every ten minutes, create a file called `.mycron' in the home directory of the user gnats which contains the line:

   0,10,20,30,40,50 * * * * exec-prefix/lib/gnats/queue-pr --run
   

   (Specify the full path name for queue-pr.) Then run

   crontab -r .mycron
   

   See the man pages for cron and crontab for details on using cron.

Go to the first, previous, next, last section, table of contents.