As all the deployers of version 2 are French-speaking people, this page has not been translated.

Voir également : Migrating from 2.x to 3.x (Postgresql tips)

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 :Installation prior 3.30

Configuration version 3.0

Voir le manuel de l'administrateur : Installation prior 3.30

Migration des données

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

ant upgrade

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