Installation on UNIX

Download Irma

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 Irma. 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 Irma release for your platform. Navigate to http://irma.vestris.com/download/ and choose a binary distribution. You are also free to choose an Irma beta version, which always has the latest improvements from the live source tree.

Warning

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/irma.4.0.Linux-x86.tar.gz server:~/cgi-bin$ tar vfx /tmp/irma.4.0.Linux-x86.tar irma.4.0/CONTRIBUTIONS irma.4.0/COPYRIGHT irma.4.0/README irma.4.0/irma.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 irma.4.0/ server:~/cgi-bin$

Move irma.4.0/irma.OS to irma (or to irma.cgi, if your web server requires a .cgi extension for executable CGI files).
server:~/Irma$ mv irma.4.0/irma.Linux irma server:~/Irma$ 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 irma* drwxr-xr-x 2 www users 1024 Jun 5 08:16 irma.4.0/ server:~/Irma$

If you wish to use the advanced data features and you thus require Irma to be able to write data files on the server, suid the binary, run chmod 4755 irma . This will set Irma to run with your rights when an anonymous user requests a page from a web browser.
server:~/Irma$ chmod 4755 irma server:~/Irma$ 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 irma* drwxr-xr-x 2 www users 1024 Jun 5 08:16 irma.4.0/ server:~/Irma$

Notice, that the permissions for irma 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 use Irma advanced features.

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

HTML code will be printed on your screen, this is expected behavior.

Navigate to your cgi-bin directory using a browser. For example, http://www.server.com/cgi-bin/irma . You should see a message, such as This must be submitted from a post method. Follow the instructions from the Chapter 2: Irma Quickstart Guide .