About IZI  |  Student manual  |  Teacher manual  |  Administrator manual  |   Installation guide  
Table of Content

Installation guide

IZI uses advanced Javascripts that are not well supported by all browsers. The application will perfectly run with Firefox from version 1.0.7 so we recommend you to install the latest version. Firefox is an open source software under the Mozilla Public License. This means that the software is available for download free of charge.
Firefox is available for Microsoft Windows, Apple Mac OS X and Linux. It has also been localised in numerous languages.

    • The basic requirements for setting up IZI is a system running a web server (we recommend Apache Web Server software), Perl, and MySQL (minimum version 4.1.16).
      We assume that your system already has all these installed and working properly.

    • Check that they are installed with the following command:
        shell> apache -help
        shell> perl --help
        shell> mysql --help

      You can get more information on each of these components at the following addresses:
      -Apache Webserver:
      -Perl: http://www.perl.org/
      -MySQL: http://www.mysql.com/.

    Download and copy files into place
    • Download IZI_1.0.tar.gz
    • Unpack the archive
        shell> tar -xvf IZI_1.0.tar.gz
    • Copy the content of the archive in your web server documents directory

      -If you can access the shell on the server, follow these steps:
        shell> cd IZI_1.0
        shell> cp -R * /var/www/
      Note: "/var/www/" may be different depending on your web server's setup.

      -If you use FTP to access the server, upload the content of the archive in the web server documents directory.

    Site structure

    Test the cgi-bin folder
    • Go to the following URL:
      http://[your domain, IP address or localhost]/cgi-bin/color.pl

    • If you can't see a box with a random color, then check the following:

      1. Check the permissions of the .pl files in /cgi-bin, it should be 0755.

      2. Check your httpd.conf (if you are using Apache):
      Uncomment the line: AddHandler cgi-script .cgi .sh .pl
      Make sure the paths are correct (
      /var/www/cgi-bin/) in the following section:

      <IfModule mod_alias.c>
        ScriptAlias /cgi-bin/ /var/www/cgi-bin/
        # "/usr/lib/cgi-bin" could be changed to whatever your ScriptAliased
        # CGI directory exists, if you have that configured.
        <Directory /var/www/cgi-bin/>
          AllowOverride None
          Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
          Order allow,deny
          Allow from all

      3. Refer to your web server documentation to activate the script folder /cgi-bin.

    Creating the database
    • Use the file izi.sql which contains the queries to create all the tables you need for IZI.

      If you can access the shell on your server:

      1. Type the following commands:
        shell> mysql
        mysql> create database izi_db;
        mysql> exit
        shell> mysql izi_db < /var/www/izi.sql
        shell> mysql
        mysql> use izi_db;
        mysql> show tables;

        -Now you should have the following tables:
        | Tables_in_izi_db |
        | assignment       |
        | comment          |
        | course           |
        | errorType        |
        | human            |
        | language         |
        | list_assignments |
        | temp             |
        | temp_assignment  |
        9 rows in set (0.00 sec)

      2. Setup a new user and password to access the database:
        mysql> grant all on izi_db.* to 'your administrator name'@'your host' identified by 'your password';
        mysql> exit

      If you cannot access the shell:

      Use the control panel on your server to create the database, set up the database user and password and run the MySQL queries from the file izi.sql.

    Edit configuration file
    • Open /cgi-bin/passLib.pl and edit the following variables to match the settings on your server:
        $host="your host";
        $user="your administrator name";
        $password="your password";

      This is the key for encryption password in database
        $key="your key";

      This is the URL to access IZI
      http://izi.example.com or
        $urlLoginPage="http://[your domain, IP address or localhost]";

      This is the default language at the start of the system (en|fr|de|sp) to add other languages, see the administrator manual.

    Clean up
    • Delete the database file "izi.sql":
        shell> rm /var/www/izi.sql

    Protect the admin page
    • Edit these lines in the file /admin/.htaccess:
        AuthUserFile [Path to your passwords file] (e.g. /etc/apache/password/passwords)
        Require user [your administrator name]

    • Setup the administrator user and password:
        shell> mkdir [Path to your passwords file]/password
        shell> htpasswd -c [Path to your passwords file]/password/passwords [your administrator name]
        shell> New password: [your administrator password]
        shell> Re-type new password: [your administrator password]

      Note: Your Apache configuration file must be setup to use .htaccess file (AllowOverride AuthConfig). For more information, please refer to the Apache documentation (

      Note: if you cannot access the shell, use your control panel to protect the
      /admin folder.

    Go to the admin page
    • Use Firefox to access the admin pages:
        http://[your domain, IP address or localhost]/admin
      Refer to the administrator manual to add new users and courses.

    • Images are not displayed:
      Comment these 2 lines in your httpd.conf:
        # Alias /icons/ /usr/share/apache/icons/
        # Alias /images/ /usr/share/images/

    • Perl scripts are not interpreted:
      Check the privileges of these files or the cgi-bin section in your httpd.conf file.

    • The "send mail" function is not working
      Check that you have sendmail installed:
        shell> sendmail -t
        shell> to: email@example.com
        shell> subject: test
        shell> body: testing
        shell> .
        press Return
      For more information, check http://www.sendmail.org/faq.

    • IZI logs the user out after the first action:
      Make sure your MySQL version is at least 4.1.16, IZI needs the subquerie function that is not supported in previous MySQL versions.

    • A white window is loaded after accessing IZI:
      Make sure your Firefox version is at least 1.0.7. Previous versions have problems interpreting the <meta http-equiv="Refresh"> tag.

    • Text does not appear on some pages:
      Make sure that your browser is set up to accept the cookies.

Copyright @ 2006 onwards, Sylvie Thouësny, all rights reserved