====== Installation manuelle ======


==== Pré-requis : ====

  * Disposer d'un ordinateur muni de Debian, ainsi que d'une connexion Internet. [[https://www.debian.org/releases/stable/i386/index.html.fr|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 [[https://wiki.wimsedu.info/doku.php?id=installation:debian:exim|Envoi d'email]] pour configurer l'envoi d'email) 

Si vous n'avez pas l'habitude du terminal, nous vous recommandons l'[[installation:debian:auto|]]. 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 :
<code bash>
  apt-get update
  apt-get upgrade --show-upgraded
</code>

===Installer un Serveur Web ===
Par défaut, WIMS fonctionne avec Apache, ( et contient un script de configuration automatique de ce dernier.)
   * Installer Apache2 :
<code bash>apt-get install apache2</code>

  * 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 : 
<code bash>/etc/init.d/apache2 restart</code>

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


=== Installer les logiciels tiers indispensables : ===
<code bash>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</code>
  
=== Librairie "GD" ===
Depuis WIMS v4.07b, la librairie [[http://libgd.bitbucket.org|"GD"]] est nécessaire à la compilation de flydraw, programme inclus à WIMS.

  * commande pour installer cette librairie sous Debian :
<code bash>apt-get install libgd-dev</code>


=== Mode "developpeur" ===
Si vous installez la version SVN, vous aurez également besoin des paquets suivants :
<code bash>apt-get install subversion
apt-get install autoconf ant
apt-get install enscript
apt-get install gcov lcov
apt install openjdk-15-jre</code>


==== 2. Installer les logiciels tiers recommandés ====
(seuls certains modules/ fonctionnalités ne seront pas utilisables sans ces paquets)

Tout installer : 
<code bash>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</code>

Ou si vous désirez les installer un par un :
<code bash>
  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)
</code>

=== Octave ===
Pour qu'octave charge la librairie "statistics", il faut ajouter au fichier ''/etc/octaverc'' la ligne suivante :
<code bash>pkg load statistics</code>
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
<code bash>echo -Xss128k > java.opts</code>


=== 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''
<code apt_sources>deb http://ftp.fr.debian.org/debian/ oldstable main non-free contrib</code>

  *Puis vous pourrez l'installer :
<code bash>
  apt-get update
  apt-get install povray
</code>

  * 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'' :
<code autoconf>
  [Permitted Paths]
  [...]
  read+write* = /home/wims/tmp/sessions
</code>

=== Gap ===

See: https://wimsedu.info/forums/topic/debian-12-gap-et-m2/#post-7932

Il semble que le problème vienne de la colorisation dans les nouvelles versions de gap. gap envoie des codes de changement de couleur avant d’envoyer la réponse, et ces codes ne sont pas attendus par wims.

Sur un serveur pour lequel gap ne sert qu’à wims, on peut enlever cette colorisation en créant un fichier gap.ini  contenant l’unique ligne suivante :

SetUserPreference( « UseColorPrompt », false );

Ce fichier est à mettre dans le répertoire racine de gap, qu’on peut connaître en tapant sous gap la commande

GAPInfo.RootPaths;

Il renvoie parfois plusieurs répertoires, chez moi seul /usr/lib/gap/ convient (dommage car il serait plus propre d’utiliser un répertoire racine de gap dans le répertoire de l’utilisateur wims pour ne pas perturber la colorisation chez les autres utilisateurs de gap).

=== Autres logiciels tiers : ===
      * Pour installer Macaulay 2, il vous faudra suivre sa doc d'install
      * mais auparavant, je vous recommande d'installer ceci : <code bash>apt-get install apt-transport-https</code>
      * http://faculty.math.illinois.edu/Macaulay2/Downloads/GNU-Linux/Debian/index.html
        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) : <code bash>apt-get install perl</code>
        * sous l'utilisateur wims : <code bash>perl -MCPAN -e 'install WebService::Validator::HTML::W3C'</code>
==== 3. Installation de WIMS ====

   * Créer un utilisateur "wims" :
<code bash>adduser wims</code>

//(ceci crée automatiquement le dossier /home/wims)//
  * Se connecter en tant qu'utilisateur "wims"
<code bash>su - wims</code>

     * se rendre dans le dossier /home/wims
<code bash>cd /home/wims</code>


=== 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 : 
<code bash>svn checkout https://subversion.renater.fr/anonscm/svn/wimsdev/trunk/wims . </code>
(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)
<code bash>wget --no-check-certificate https://sourcesup.renater.fr/frs/download.php/531/wims-4.XXX.tgz</code>

   * Décompresser l'archive : 
<code bash>tar xzf wims-4.xx.tgz</code>

   * Supprimez l'archive : 
<code bash>rm wims-4.xx.tgz</code>

==== 4. Compilation des sources de WIMS ==== 

   * lancer la compilation :
      *  lors d'une première installation (long) :<code bash>./compile --mathjax --jmol --modules --geogebra --shtooka</code>
( 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) : <code bash>./compile --mathjax --jmol --geogebra</code>
(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)
<code bash>su root</code>

  * lancer les commandes permettant de définir les droits corrects sur certains fichiers sensibles
<code bash>
  ./bin/setwrapexec
  ./bin/setwimsd 
</code>

==== 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 : [[installation:WIMS et NGINX]])
<code bash>./bin/apache-config</code>


         * 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 :
<code bash>a2enmod cgi</code>


      * Relancer le serveur web :
<code bash>systemctl restart apache2</code>

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 : [[installation:first_config| 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)