Le wiki de WIMS EDU

L'association WIMS EDU a ouvert ce wiki afin de favoriser les collaborations entre utilisateurs de WIMS.

Outils pour utilisateurs

Outils du site


installation:debian:manual

Installation manuelle

Pré-requis :

  • Disposer d'un ordinateur muni de Debian, ainsi que d'une connexion Internet. Doc d'installation de Debian
  • Connaître les commandes de base d'un terminal unix/linux
  • S'assurer que le serveur permet l'envoi d'email (voir Envoi d'email pour configurer l'envoi d'email)

Si vous n'avez pas l'habitude du terminal, nous vous recommandons l'Installation automatique. Ou tout simplement d'utiliser un des serveurs WIMS publics ;)

1. Installer les pré-requis

Toute cette première partie devra être effectuée par un utilisateur administrateur (su root, ou sudo )

  • Mettre à jour apt-get et les packages existants :
  apt-get update
  apt-get upgrade --show-upgraded

Installer un Serveur Web

Par défaut, WIMS fonctionne avec Apache, ( et contient un script de configuration automatique de ce dernier.)

  • Installer Apache2 :
apt-get install apache2
  • vérifier que le serveur fonctionne. Entrer http://127.0.0.1 dans la barre d'adresse de votre navigateur. Il doit afficher “It works! […]”
    • au cas où, voici la commande pour relancer Apache2 :
/etc/init.d/apache2 restart

Mais vous pouvez choisir de travailler avec NGINX. Plus d'infos ici : WIMS et NGINX

Installer les logiciels tiers indispensables :

apt-get install make g++ texlive-base texlive-latex-base gnuplot pari-gp units-filter flex bison perl liburi-perl imagemagick libgd-dev libfl-dev wget curl

Librairie "GD"

Depuis WIMS v4.07b, la librairie "GD" est nécessaire à la compilation de flydraw, programme inclus à WIMS.

  • commande pour installer cette librairie sous Debian :
apt-get install libgd-dev

Mode "developpeur"

Si vous installez la version SVN, vous aurez également besoin des paquets suivants :

apt-get install subversion
apt-get install autoconf ant
apt-get install enscript
apt-get install gcov lcov
apt install openjdk-15-jre

2. Installer les logiciels tiers recommandés

(seuls certains modules/ fonctionnalités ne seront pas utilisables sans ces paquets)

Tout installer :

apt-get install yacas gap maxima octave octave-statistics graphviz ldap-utils scilab-cli libwebservice-validator-html-w3c-perl qrencode fortune unzip zip libgmp-dev openbabel

Ou si vous désirez les installer un par un :

  apt-get install yacas
  apt-get install gap
  apt-get install maxima
  apt-get install octave octave-statistics
  apt-get install graphviz
  apt-get install ldap-utils
  apt-get install scilab-cli
  apt-get install libwebservice-validator-html-w3c-perl
  apt-get install qrencode
  apt-get install fortune (utilisé par le module "H6/algebra/decrypt")
  apt-get install zip (pour les sauvegardes de classes)
  apt-get install unzip (utilisé pour décompresser mathjax)
  apt-get install libgmp-dev  (Pour pouvoir compiler "units-filter" et "chemeq")
  apt-get install openbabel (outil chemtool)

Octave

Pour qu'octave charge la librairie “statistics”, il faut ajouter au fichier /etc/octaverc la ligne suivante :

pkg load statistics

Dans /usr/share/octave/6.4.0/m/java/ (en remplaçant 6.4.0 par le numéro de la version), executer la commande

echo -Xss128k > java.opts

Maxima

Vérifier que le package share de Maxima a bien été installé, sinon l'installer séparément. Il fournit de nombreuses commandes utilisées dans les exercices wims (exemple trigsimp)

Povray

Si vous souhaitez utiliser les modules d'exercices générant des images 3D,vous aurez besoin de Povray.

  • Povray fait partie des logiciels tiers de la catégorie “non-free” des paquets debian : Pour ces paquets, votre configuration d'apt-get devra piocher également dans la catégorie “non-free”. (nb : si vous êtes sur Ubuntu, vous n'avez rien à faire)

Ajoutez la ligne suivante au fichier /etc/apt/sources.list

deb http://ftp.fr.debian.org/debian/ oldstable main non-free contrib
  • Puis vous pourrez l'installer :
  apt-get update
  apt-get install povray
  • ajouter ensuite cette ligne à la catégorie “[Permitted Paths]” du fichier de configuration de povray (remplacez X par votre version) /etc/povray/3.X/povray.conf :
  [Permitted Paths]
  [...]
  read+write* = /home/wims/tmp/sessions

Autres logiciels tiers :

n.b. Depuis Debian 11, Macaulay 2 peut être installé avec sudo apt install macaulay2

  • Pour que les développeurs d'exercices aient accès à l'outil de validation html dans leur compte de Modtool, vous devez installer le paquet perl webservice:validator:html:w3c :
    • sous l'utilisateur root (ou via sudo) :
      apt-get install perl
    • sous l'utilisateur wims :
      perl -MCPAN -e 'install WebService::Validator::HTML::W3C'

3. Installation de WIMS

  • Créer un utilisateur “wims” :
adduser wims

(ceci crée automatiquement le dossier /home/wims)

  • Se connecter en tant qu'utilisateur “wims”
su - wims
  • se rendre dans le dossier /home/wims
cd /home/wims

Mode "développeur"

Au lieu de de télécharger la dernière archive WIMS disponible comme indiqué ci-après, récupérez les sources SVN dans le répertoire wims en tapant la commande :

svn checkout https://subversion.renater.fr/anonscm/svn/wimsdev/trunk/wims . 

(le '.' à la fin de la commande indique que les sources doivent être mises dans le répertoire où on se trouve) puis passez à la partie 4. Compilation des sources de WIMS

Mode "normal"

  • Rendez-vous sur le site Sourcesup pour obtenir l'URL de la dernière version de Wims : http://sourcesup.renater.fr/frs/?group_id=379
  • Puis téléchargez-le sur le serveur via cette ligne de commande (en remplacant l'URL par celle que vous venez d'obtenir)
wget --no-check-certificate https://sourcesup.renater.fr/frs/download.php/531/wims-4.XXX.tgz
  • Décompresser l'archive :
tar xzf wims-4.xx.tgz
  • Supprimez l'archive :
rm wims-4.xx.tgz

4. Compilation des sources de WIMS

  • lancer la compilation :
    • lors d'une première installation (long) :
      ./compile --mathjax --jmol --modules --geogebra --shtooka

( l'option –modules installe tous les modules pédagogiques. Ne le faire qu'à la première installation, la mise à jour se fera ensuite automatiquement à l'heure que vous indiquerez dans les pages de configuration)

  • lors des mises à jour (plus rapide) :
    ./compile --mathjax --jmol --geogebra

(l'option –mathjax permet d'installer la librairie “MathJax”, offrant un bonne compatibilité avec Chrome. L'option –jmol permet l'installation de la librairie javascript Jsmol, et l'option –geogebra installe les libraires javascript utiles pour utiliser geogebra.

  • lorsque WIMS vous demande l'IP de l'administrateur, donnez lui la seule IP qui aura la permission d'accéder à l'interface d'administration de WIMS
  • donnez ensuite l'adresse email et un mot de passe pour cet administrateur
  • Se connecter en tant qu'utilisateur “root” (ou lancer les commandes suivantes avec sudo)
su root
  • lancer les commandes permettant de définir les droits corrects sur certains fichiers sensibles
  ./bin/setwrapexec
  ./bin/setwimsd 

5. Configuration du serveur apache

  • lancer la commande pour configurer automatiquement apache (si vous avez choisi Apache comme serveur Web. Sinon, c'est que vous avez déja du configurer ici : WIMS et NGINX)
./bin/apache-config
  • la mention “commande introuvable” peut survenir. Ne vous en inquiétez pas : WIMS recherche la version adéquate d'apache.
  • Charger le module cgi d'apache :
a2enmod cgi
  • Relancer le serveur web :
systemctl restart apache2

Bravo ! Si tout s'est bien passé, il vous suffit maintenant d'ouvrir un navigateur internet et de vous rendre à l'adresse de votre serveur pour voir WIMS s'afficher.

http://ICI.VOTRE.SERVEUR/wims/

6. Configuration de WIMS

Vous venez d'installer votre premier serveur WIMS. Un peu de configuration est maintenant nécessaire ! Suivez la page suivante : Configuration de WIMS

Dernières versions testées :

  • Ubuntu 20.04.2 LTS / WIMS 4.01 (juin 2021)
  • Jessie (Debian 8.5) / WIMS 4.11c (juillet 2016)
  • Wheezy (Debian 7) / WIMS 4.09 (mars 2015)
  • Squeeze (Debian 6) / WIMS 4.03a (mars 2012)
  • Ubuntu 16.04 LTS / WIMS 4.11c (Juin 2016)
  • Ubuntu 14.04 LTS (Juin 2015)
Vous pourriez laisser un commentaire si vous étiez connecté.
installation/debian/manual.txt · Dernière modification : 11/03/2024 22:56 de lmarquez