The esup-helpdesk is highly configurable and customizable thanks to Spring, layout programming and systematical usage of Java interfaces.

The issue is not the customization itself but keeping the customizations when upgrading the application.

esup-helpdesk offers a very flexible mechanism to recover the customizations:

• the main configuration files of the application (/build.properties, /

Mises à jour 

La procédure de mise à jour est la suivante :

1. récupération des sources de la nouvelle version

2. Balise Wiki
   décompression des sources au même endroit que la version déjà installée (par exemple, décompression de *esup-helpdesk\[-quick-start\]-x.y.z-t.zip* dans le répertoire */usr/local/helpdesk/src*, ce qui crée le répertoire */usr/local/helpdesk/src/esup-helpdesk\[-quick-start\]-x.y.z*.

3. arrêt de la version en cours : ant stop (dans le répertoire de la version précédente)
4. récupération des personnalisations de la version précédente : ant recover-config
5. déploiement de la nouvelle version : ant deploy
6. mise à jour de la base de données : ant upgrade (seulement pour les changements de n° mineur de version)
7. redémarrage de l'application : ant start

   Remarque
   title Répertoire d'installation de l'application
   Lors de mise à jour de l'application avec une version plus récente, il est impératif d'installer toutes les versions au même endroit sur le serveur, par exemple /usr/local/helpdesk/src, pour assurer la récupération des personnalisations.

Conservation des personnalisations 

L'application esup-helpdesk est très configurable, grâce à l'utilisation de Spring, la programmation en couches et l'utilisation systématique d'interfaces Java.

Le problème n'est donc pas tant la personnalisation elle-même, mais plutôt la conservation des personnalisations lors des mises à jour de l'application.

esup-helpdesk offre pour cela un mécanisme très souple de récupération :

• des fichiers de configurations principaux de l'application (build.properties, properties/config.properties)
• des fichiers de configuration modifiés localement par les exploitants configuration files changed locally by the deployers (/properties/*)
• plus généralement de tous les fichiers ajoutés ou modifiéslocalement more generally all the files changed or added locally (sources, feuilles de stylestylesheets, ...)

Pour faire en sorte que les personnalisations soient conservées, il faut éditer le fichier /build.properties et modifier la propriété In order to ease the recovering of the customizations, edit the property custom.recover.files.

Supposons par exemple que l'exploitant :

in /build.properties. For instance, we assume here that the deployer has:

• added a customization class to link to an external inventory application

...

• (edu.domain.helpdesk.computerUrl.InventoryComputerUrlBuilderImpl)

...

• edited the configuration file /properties/domain/computerUrl.xml to add a bean of this class

He(she) will have to change the property this way pour ajouter un bean de cette classeIl devra alors modifier la propriété de la sorte :

custom.recover.files=   \
src/edu/domain/helpdesk/computerUrl/InventoryComputerUrlBuilderImpl.java \
properties/domain/computerUrl.xml

Calling the ant task recover-config will automatically recover those files from the folder of the previous release.