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


Installation

Unfortunately, there is currently no configure installation process. However, the installation should be straightforward anyway. The best way to install gnats2w is to install them on Debian systems. If your target machine doesn't run Debian, you have to perform the steps described below.

Required software

The most difficult thing about it is probably getting all the software needed installed. You need to have installed and configured properly the following software components:

All the software is available in Debian.

If you want to use gnats2w with FastCGI, you must have installed the `fcgi' Python module too, See section FastCGI.

Installation steps

The recommended way of installing gnats2w is from its Debian package. The Debian GNU distribution makes the installation one-command process and ensures all the needed software is installed. If you choose this way of installation, you can skip the rest of this section. If you do not choose to install gnats2w from Debian package for whatever reason, follow the steps described below.

After you have all the required software installed and working, See section Required software, you can perform the following steps to install gnats2w:

  1. Edit configuration variables in `Makefile'. Usually, you should only set the prefix variable to the main installation directory and the CGI_DIR and FCGI_DIR variables to locations, where you want to have placed the CGI and FastCGI links. It can also be a good idea to set TMP_DIR to some secure location.
  2. Run make. This should be totally straightforward.
  3. Log in as the gnats user and run make install. If you have no gnats user on your system, create one. No special UID number is required, on Debian systems it is 41.
  4. Create the file `config' in the directories with (Fast)CGI scripts. You can change global `config.py' options there. In this way you can have different configurations for different GNATS databases or to set different access rights for different URLs.

After succesfull installation and configuration, you can enter gnats2w at the URL of the `index.cgi' script, See section Usage.


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