Installation on UNIX

Download aGNeS

Identify your operating system. Connect to your server using a telnet or an ssh session. Login as usual as a normal user. It is not necessary to have, and is not advised to use, a root access to install aGNeS. You can run the uname -a command which will produce something like: 
server:~/$ uname -a
Linux ns 2.0.36 #2 Thu Nov 19 13:41:52 MET 1998 i686 unknown
This above operating system is obviously Linux, running on a Pentium class processor (i686).

Download an aGNeS release for your platform. Navigate to http://agnes.vestris.com/download/ and choose a binary distribution. You are also free to choose an aGNeS beta version, which always has the latest improvements from the live source tree.

Although we do our best to make sure that beta versions are stable and tested, they might contain debug code, produce unexpected results or behavior specific for the beta release.

Install and Test Binary

Set-up a cgi-bin directory if you don't have one. Please refer to your web-server administration guide for that purpose. (The name of the directory is of no importance as long as it is marked to be able to execute files in your web server configuration). 
server:~/cgi-bin$ pwd
/home/www/cgi-bin/

Gunzip and untar the downloaded distribution. Use gunzip , then tar vfx . 
server:~/cgi-bin$ gunzip /tmp/agnes.4.2.Linux-x86.tar.gz 
server:~/cgi-bin$ tar vfx /tmp/agnes.4.2.Linux-x86.tar
agnes.4.2/CONTRIBUTIONS
agnes.4.2/COPYRIGHT
agnes.4.2/README
agnes.4.2/agnes.Linux
server:~/cgi-bin$
server:~/cgi-bin$ ls -la
total 3
drwxr-xr-x   3 www   users 1024 Jun  5 08:16 ./
drwx---r-x  17 www   users 1024 Jun  5 08:14 ../
drwxr-xr-x   2 www   users 1024 Jun  5 08:16 agnes.4.2/
server:~/cgi-bin$

Move agnes.4.2/agnes.OS to agnes (or to agnes.cgi, if your web server requires a .cgi extension for executable CGI files). 
server:~/Agnes$ mv agnes.4.2/agnes.Linux agnes
server:~/Agnes$ ls -la
total 3
drwxr-xr-x   3 www   users 1024 Jun  5 08:20 ./
drwx---r-x  17 www   users 1024 Jun  5 08:14 ../
-rwxr-xr-x   1 www   users   25 Jun  5 08:20 agnes*
drwxr-xr-x   2 www   users 1024 Jun  5 08:16 agnes.4.2/
server:~/Agnes$

Suid the binary, run chmod 4755 agnes . This will set aGNeS to run with your rights when an anonymous user requests a page from a web browser. Thus, it will be able to read and write article files. 
server:~/Agnes$ chmod 4755 agnes
server:~/Agnes$ ls -la
total 3
drwxr-xr-x   3 www   users 1024 Jun  5 08:20 ./
drwx---r-x  17 www   users 1024 Jun  5 08:14 ../
-rwsr-xr-x   1 www   users   25 Jun  5 08:20 agnes*
drwxr-xr-x   2 www   users 1024 Jun  5 08:16 agnes.4.2/
server:~/Agnes$
Notice, that the permissions for agnes have changed to -rwsr-xr-x, if this is not the case, suid is not allowed on your system and you will not be able to run aGNeS.

Test the binary, run ./agnes. On Linux, aGNeS is statically linked, so you do not need any of the pthread shared libraries. On other UNIX flavors, aGNeS might complain about missing a library. See the troubleshooting section for more details.

HTML code will be printed on your screen. Check whether a data and an equiv subdirectories were created at this time. 
server:~/Agnes$ ./agnes
... stripped html code ...
server:~/Agnes$ ls -la
total 3
drwxr-xr-x   3 www   users 1024 Jun 5 08:20 ./
drwx---r-x  17 www   users 1024 Jun 5 08:14 ../
-rwsr-xr-x   1 www   users   25 Jun 5 08:20 agnes*
drwxr-xr-x   2 www   users 1024 Jun 5 08:16 agnes.4.2/
drwx------   3 www   users 1024 Jun 5 08:27 data/
drwx------   2 www   users 1024 Jun 5 08:37 equiv/
server:~/Agnes$

Navigate to your cgi-bin directory using a browser. For example, http://www.server.com/cgi-bin/agnes . Follow the instructions from the the section called First-time Configuration .