Queste note spiegano come creare un server WIMS basato sul sistema operativo Debian. Con poche varianti, queste istruzioni dovrebbero funzionare ugualmente per l’installazione di WIMS su Ubuntu (alcune note a sono aggiunte dove sono richieste delle variazioni).

Important

Attenzione: Queste note sono state scritte in maniera distratta e caotica per uso puramente personale e sono quindi certamente inesatte, incomplete e potenzialmente pericolose.

Ultimo aggiornamento: 2009-09-30 (Debian 5.0 "Lenny", WIMS 3.65f).

Prima si cominciare

Oltre ad aver una installazione funzionante di Debian, assicurarsi che il sistema di posta elettronica sia configurato correttamente (almeno localmente) dato che alcune funzionalità di base di WIMS lo richiedono.

Installazione dei pacchetti necessari

Dopo l’installazione del sistema è necessario aggiungere alcuni pacchetti prima di cominciare l’installazione di wims vera e propria.

# aptitude install build-essential apache2 mailx mutt texlive
# aptitude install chemeq fortunes graphviz imagemagick units-filter

Creare un utente "wims"

Note

Il carattere # all’inizio di una riga indica che il comando deve essere eseguito come utente root.

# adduser wims
Password:
Adding user `wims'...
Adding new group `wims' (1001).
Adding new user `wims' (1001) with group `wims'.
Creating home directory `/home/wims'.
Copying files from `/etc/skel'
Enter new UNIX password:
Retype new UNIX password:
passwd: password updated successfully
Changing the user information for wims
Enter the new value, or press ENTER for the default
        Full Name []: Wims server user
        Room Number []:
        Work Phone []:
        Home Phone []:
        Other []:
Is the information correct? [y/N] y

Per semplicità, è meglio, almeno durante la fase di installazione, aggiungere l’utente wims al gruppo admin, per permettere l’uso di sudo:

# adduser wims sudoers

Se si esegue l’installazione su Ubuntu si deve invece dare il comando

# adduser wims admin

Scaricare i sorgenti WIMS

Aprire un nuovo terminale e collegarsi come utente wims:

# su - wims

Scaricare e scompattare i sorgenti del server e dei moduli dal sito http://wims.unice.fr/download/wims/ (per le versioni stabili di wims) oppure da http://wimsedu.info/ (per le versioni instabili).

Note

Il carattere $ all’inizio di una riga indica che il comando deve essere eseguito come utente wims.

$ wget http://sourcesup.cru.fr/frs/download.php/2614/wims-3.65f.tgz
$ tar xzf wims-3.65f.tgz
$ http://wims.unice.fr/download/wims/wims-chroot-i386-3.52.tgz
$ tar xzf wims-chroot-i386-3.52.tgz

Compilare i sorgenti:

$ ./compile

Dovrebbe terminare con:

Please give the root password to setup WIMS.
Password:

A questo punto inserire la passwd (se l’utente root ha una password). Altrimenti (nella configurazione di default di Ubuntu l’utente root non ha una password) dare semplicemente enter e poi collegarsi come root e invocare il programma bin/wrapuid

# bash /home/wims/bin/wrapuid

Nota: attenzione all’ultima riga, invocare bin/wrapuid in una nuova istanza di bash, altrimenti il comando fallisce nelle recenti versioni di Debian (FIXME: perché?).

Configurazione di Apache

Editare il file /etc/apache2/apache2.conf

Aggiungere o scommentare la riga:

AddHandler cgi-script .cgi

e aggiungere anche

###################################################################
# Configurazione di WIMS

ScriptAliasMatch ^/~wims/wims\.(.*) /home/wims/public_html/wims.cgi
ScriptAliasMatch ^/wims/wims\.(.*) /home/wims/public_html/wims.cgi
ScriptAliasMatch ^/~wims/index\.(.*) /home/wims/public_html/wims.cgi
ScriptAliasMatch ^/wims/index\.(.*) /home/wims/public_html/wims.cgi
ScriptAliasMatch ^/~wims/.._(.*).html /home/wims/public_html/wims.cgi
ScriptAliasMatch ^/wims/.._(.*).html /home/wims/public_html/wims.cgi
ScriptAliasMatch ^/~wims/getfile/(.*) /home/wims/public_html/wims.cgi
ScriptAliasMatch ^/wims/getfile/(.*) /home/wims/public_html/wims.cgi
ScriptAlias /wims/....\.cgi /home/wims/public_html/wims.cgi

Alias /wims /home/wims/public_html
Alias /~wims /home/wims/public_html

<Directory /home/wims/public_html>
Options FollowSymLinks ExecCGI -Indexes
AllowOverride All
allow from all
</Directory>
<Directory /home/wims/public_html/modules>
Options FollowSymLinks
AllowOverride Limit
</Directory>

Una volta modificati i file di configurazione è necessario far ripartire apache:

/etc/init.d/apache2 restart

Provare il funzionamento e configurare

A questo punto il server è accessibile dal link:

http://localhost/wims/wims.cgi

Nota: Il link http://localhost/wims/ non è accessibile.

Per rifinire l’installazione seguire il link "WIMS site maintenance". In particolare, ricordarsi di configurare

WIMS site maintenance ->
  Configuration of appearances ->
    Your email address

FIXME: selezionare la lingua. FIXME: modupdate.