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: http://www.apache.org/
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.
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:
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.
Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
Allow from all
3. Refer to your web server documentation to activate the script folder /cgi-bin.
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:
mysql> create database izi_db;
shell> mysql izi_db < /var/www/izi.sql
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';
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
and edit the following variables to match the settings on your server:
$user="your administrator name";
This is the key for encryption password in database
This is the URL to access IZI (e.g. http://izi.example.com or http://192.168.1.2 )
$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.
Delete the database file "izi.sql":
shell> rm /var/www/izi.sql
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 ( http://www.apache.org/ ).
Note: if you cannot access the shell, use your control panel to protect the /admin
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
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