Accueil Communauté Projets Documentation ESUP-Days Communication Aide Intranet

Migrating from version 2 to version 3

The esup-helpdesk project (code and documentation) is a collaborative work. Leave comments!
(editing the esup-helpdesk documentation itself is reserved to the esup-helpdesk deployers; to become a member of this group, please contact paubry)

Table of contents

Home

Redactors

Group: proj-helpdesk (offline)
Alexandre Boisseau (boisseau@univ-brest.fr)
boisseau at univ-brest dot fr
Brigitte Wallaert (wallaert@univ-lille1.fr)
brigitte dot wallaert at univ-lille1 dot fr
Doriane Dusart (ddusart@univ-valenciennes.fr)
doriane dot dusart at univ-valenciennes dot fr
Fabrice Jammes (fjammes@univ-paris1.fr)
fabrice dot jammes at univ-paris1 dot fr
Gilian GAMBINI (ggambini@univ-nancy2.fr)
gilian dot gambini at univ-nancy2 dot fr
Harold Moyse (1986138@sac.cru.fr)
harold dot moyse at uvsq dot fr
Julien Pedrono (1986401@sac.cru.fr)
julien dot pedrono at insa-rennes dot fr
Odile Germes (germes@univ-rennes1.fr)
odile dot germes at univ-rennes1 dot fr
Pascal Aubry (paubry@univ-rennes1.fr)
pascal dot aubry at univ-rennes1 dot fr
Philippe Lecler (2324998@sac.cru.fr)
philippe dot lecler at irisa dot fr
Vincent Repain (vrepain@univ-rennes1.fr)
vincent dot repain at univ-rennes1 dot fr
Yves Deschamps (ydeschamps)
yves dot deschamps at univ-lille1 dot fr
As all the deployers of version 2 are French-speaking people, this page has not been translated.


Voir également : Notes spécifiques de migration pour PostgreSQL

Arrêt du helpdesk v2 

Prévoir si possible cette phase en un moment de gêne minimale.

Il est prudent de tester la procédure complète de migration avant d'effectuer le basculement final.

Transfert de la base de données

Faire un dump de la base v2 (par exemple helpdesk-v2) en SQL (créer par exemple helpdesk-v2.sql)

S'assurer que toutes les tables et les champs des tables sont en classement* utf8. Au besoin :

  • Remplacer toutes les occurrences de character set latin1 par character set utf8
  • Remplacer toutes les occurrences de CHARSET=latin1 par CHARSET=utf8

Créer une base vide helpdesk-v3, classement utf8_general_ci.

Importer le dump modifié (helpdesk-v2.sql) dans la base helpdesk-v3

Transfert des fichiers téléchargés

Copier tous fichiers du répertoire de téléchargement (cf tag /config/upload/storage-path dans /properties/CHelpdeskConfig.xml dans l'instance v2) dans un nouveau répertoire (par exemple /usr/local/helpdesk/v2Files, cf*${uploadedFiles.v2Path* dans /properties/config.properties ).

Installation de la version 3.0

Télécharger le zip esup-helpdesk-[quick-start-]3.0.z-t.zip, par exemple dans /usr/local/src/helpdesk.

Décompresser le zip, cela crée le répertoire /usr/local/src/helpdesk/esup-helpdesk-3.0.z.

Créer les répertoires :

  • /usr/local/helpdesk/index (pour les fichiers d'indexation)
  • /usr/local/helpdesk/files (pour les fichiers téléchargés)

Voir le manuel de l'administrateur :00 Installation

Configuration version 3.0

Voir le manuel de l'administrateur : 00 Installation

Migration des données

Exécuter la tâche de mise à jour :

ant upgrade
La procédure de migration des données peut être longue, c'est normal
Cette migration peut-être assez longue, notamment pour la première phase pendant laquelle Hibernate reconstruit tous les index, et n'affiche rien pendant ce temps (plus d'une heure d'inactivité apparente n'est pas anormal, surtout ne pas interrompre sous peine de tout refaire !).

Test de l'installation 3.0

Lancer le serveur :

/etc/init.d/helpdesk start

Accéder l'URL de l'application (par défaut http://localhost:8080, cf build.properties) et tester.

Archivage et expiration des tickets, mise à jour de l'index

Lancer la tâche d'archivage des anciens tickets :

ant archive-tickets
L'archivage peut durer plusieurs heures, mais n'empêche pas de commencer à travailler avec le helpdesk.

Lancer la tâche d'expiration des tickets non approuvés :

ant expire-tickets

Lancer la tâche de mise à jour de l'index :

ant update-index

Etiquettes:

Saisissez les étiquettes à ajouter à cette page:
Wait Image 
Vous recherchez une étiquette ? Commencez à taper.