Le wiki de WIMS EDU

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Mise a 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-get update
  apt-get upgrade
  apt-get autoremove
  apt-get 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.22_to_4.24.sh
 wget https://sourcesup.renater.fr/frs/download.php/latestfile/531/wims-4.24.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.22_to_4.24.sh</code>
Tapez "y" pour accepter de supprimer les anciens fichiers devenus obsolètes.

   * Décompressez l'archive
<code bash>tar -xzf wims-4.24.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…)