====== Mise à jour de WIMS ======

Voici les étapes à suivre pour mettre à jour votre serveur WIMS sous Debian.

===== Avant tout =====
  * Prévenez les utilisateur du créneau de mise a jour, car pendant celle-ci le serveur sera inaccessible. (utilisez le "mot du jour" par exemple).
  * Assurez-vous d'avoir une sauvegarde récente du serveur (Si c'est une machine virtuelle, faites un snapshot).

===== 1. Prévenir les utilisateurs qu'une maintenance aura lieu =====
Nous vous conseillons de prévenir les utilisateurs avant d'effectuer des opérations de maintenance, mais vous êtes tout à fait libre de choisir comment vous souhaitez les informer.
Voici en tout cas 2 solutions inclues dans WIMS

==== Message sur la page d'accueil du site ====
C'est ce qu'on appelle aussi le "mot du jour".
Il vous suffit de créer un fichier **motd.phtml.LANG** dans le répertoire "log/" (remplacez LANG par la langue pour laquelle s'affichera le message (exemples : ''en'' pour anglais, ''fr'' pour français...)

==== Message pour les administrateurs de classes ====
Il vous suffit de créer un fichier **manager_msg.phtml.LANG** dans le répertoire "log/" (remplacez LANG par la langue pour laquelle s'affichera le message (exemples : ''en'' pour anglais, ''fr'' pour français...)

===== 2. Mise à jour des paquets tiers =====
<code bash>
  apt update
  apt upgrade
  apt autoremove
  apt autoclean
  apt install libfl-dev
</code>

  * Si vous aviez choisi l'installation automatique de WIMS (via "apt-get install wims"), c'est tout ce que vous avez à faire ! Profitez de votre WIMS mis à jour ;)
  * Si vous aviez choisi l'installation manuelle, continuez à l'étape 3 :


===== 3. Mise à jour manuelle =====

   * Rendez-vous dans le répertoire de wims, en tant qu’utilisateur wims <code bash>su - wims</code>

   * Se rendre sur le [[https://sourcesup.renater.fr/frs/?group_id=379 | projet WIMS sur sourcesup]], et chercher le lien de la dernière version, ainsi que de tous les éventuels scripts à appliquer depuis votre version actuelle (exemple : si vous avez la version 4.18 et que vous souhaitez mettre a jour en 4.20 ou plus, il vous faudra également le script ''upgrade-4.18_to_4.20.sh'')

   * Téléchargez la dernière version de WIMS
<code bash>
 wget https://sourcesup.renater.fr/frs/download.php/latestfile/531/upgrade-4.26_to_4.28.sh
 wget https://sourcesup.renater.fr/frs/download.php/latestfile/531/wims-4.28.tgz
</code>

   * Arrêtez le serveur pour laisser le temps aux jobs éventuels de se terminer 
     <code bash>bin/server-interrupt</code>

   * Éventuellement, lancer le script de mise a jour si besoin
<code bash>sh ./upgrade-4.26_to_4.28.sh</code>
Tapez "y" pour accepter de supprimer les anciens fichiers devenus obsolètes.

   * Décompressez l'archive
<code bash>tar -xzf wims-4.28.tgz</code>

   * Détruisez les éventuels "zombies"
<code bash>killall maxima pari gap octave 2>/dev/null</code>

   * Vérifiez dans la page d'installation du Wiki si des logiciels tiers ne sont pas devenus nécessaires depuis la dernière mise à jour (libgd par exemple)

   * Lancer la recompilation (avec mise a jour optionnelle de mathjax, jmol et geogebra)
<code bash>./compile --mathjax --jmol --geogebra</code>
**Attention** : si vous mettez à jour depuis une version antérieure à **wims4.23d**, ces options sont **fortement recommandées**. (les versions précédemment inclues de mathjax et geogebra ne sont pas compatibles avec les nouvelles)
(pour la version 4.18, la mise à jour de jmol est fortement conseillée).
   * Lancez ce script en tant que root (pour des raisons de sécurité)
<code bash>
 su
 ./bin/setwrapexec
</code>

   * Ouvrez votre navigateur Internet préféré, et vérifiez que tout fonctionne. Cliquez sur "à propos de WIMS" pour voir le nouveau numéro de version. (pensez également à vider votre cache)

   * Et voila ! profitez bien de la nouvelle version, et comme toujours n'hésitez-pas à nous signaler (via Sourcesup) tout bug rencontré !

Pour finir, si vous utilisez la distribution "chroot" de WIMS, lancez le script suivant (en tant que root) : 
<code bash>./bin/setchroot</code>

Pensez à vous rendre dans l'interface d'administration de WIMS afin de vérifier que tout fonctionne : Regardez bien tout ce qui se trouve dans l'onglet "Vérification de l'installation"

//La mise a jour ne touche absolument pas aux classes et aux espaces privés.//


===== 4. Retirer le message de maintenance =====

Si vous aviez annoncé la maintenance (ce que nous vous conseillons), il est temps de retirer vos annonces ;)

==== Annonces via la page d'accueil ====

Il vous suffit de soit :
  * Supprimer ou renommer le fichier "motd.phtml.LANG" que vous avez créé  dans le répertoire “log/”
  * Modifier le contenu de celui-ci, par exemple pour annoncer que la maintenance a bien eu lieu, et que les utilisateurs doivent vider le cache de leur navigateur pour en profiter pleinement.

==== Message pour les administrateurs de classes ====

Il vous suffit de :
  * soit supprimer ou renommer le fichier "manager_msg.phtml.LANG" dans le répertoire “log/”;
  * soit modifier le contenu de celui-ci, par exemple pour annoncer que la maintenance a bien eu lieu, et que les utilisateurs doivent vider le cache de leur navigateur pour en profiter pleinement.

Dans les 2 cas ci-dessus, remplacez LANG par la langue pour laquelle s'affichera le message (exemples : ''en'' pour anglais, ''fr'' pour français…)