====== 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>

=== 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)