Recovering previous configuration and customizations when upgrading

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 Pascal Aubry)

Redactors

Group: proj-helpdesk

Alexandre Boisseau (boisseau@univ-brest.fr)
boisseau at univ-brest dot fr

Benjamin SECLIER (bseclier@univ-nancy2.fr)
benjamin dot seclier at univ-nancy2 dot fr

Brice Quillerie (bquiller@univ-montp1.fr)
brice dot quillerie at univ-montp1 dot fr

Doriane Dusart (ddusart@univ-valenciennes.fr)
doriane dot dusart at univ-valenciennes dot fr

Fabien Wald (wald_f@uhb.fr)
fabien dot wald at uhb dot fr

Fabrice Jammes (fjammes@univ-paris1.fr)
fabrice dot jammes at univ-paris1 dot fr

Harold Moyse (1986138@sac.cru.fr)
harold dot moyse at uvsq dot fr

Jean Philippe FLORET (a04a3347@univ-cezanne.fr)
jp dot floret at univ-cezanne dot fr

Julien MARCHAL (jmarchal@univ-nancy2.fr)
julien dot marchal at univ-nancy2 dot fr

Julien Pedrono (1986401@sac.cru.fr)
julien dot pedrono at insa-rennes dot fr

Mathieu MOLINERIS (molineris@univmed.fr)
mathieu dot molineris at univmed dot fr

Miniussi Alain (2276872@sac.cru.fr)
alain dot miniussi at oca dot eu

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

wallaert (wallaert@univ-lille1.fr)
brigitte dot wallaert at univ-lille1 dot fr

ydescham (ydescham@univ-lille1.fr)
yves dot deschamps at univ-lille1 dot fr

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, /properties/config.properties)
configuration files changed locally by the deployers (/properties/*)
more generally all the files changed or added locally (sources, stylesheets, ...)

In order to ease the recovering of the customizations, edit the property custom.recover.files 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:

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.

Recovering previous configuration and customizations when upgrading

Table of contents

Redactors

Etiquettes: