Migration 3.29 vers 4.2 (branche AMU ou

master)

Validé avec java 1.8 (openjdk) et tomcat 8.

Pour migrer d'une version antérieure à 3.30 vers la nouvelle 4.2.0 (version AMU ou

master avec refonte graphique), veuillez suivre la procédure suivante :

[test-helpdesk@helpdesk src]$ git clone https://github.com/EsupPortail/esup-helpdesk.git
[test-helpdesk@helpdesk src]$ cd esup-helpdesk/
[test-helpdesk@helpdesk esup-helpdesk]$ git checkout AMU  # OR
[test-helpdesk@helpdesk esup-helpdesk]$ git checkout 

master 
[test-helpdesk@helpdesk esup-helpdesk]$ git branch -d master # Suppression de la branche master locale

Modifiez ensuite le fichier config.properties pour l'adapter à votre environnement puis copiez les fichiers suivants :

[test-helpdesk@helpdesk esup-helpdesk]$ cp src/main/resources/properties/config.properties.sample src/main/resources/properties/config.properties


OU

# Récupération du fichier config.properties de l'ancien helpdesk
# Déplacement dans src/main/resources/properties/config.properties
# Ajout des éléments suivants 
 
######
# AMU
######
#Il faut que le champ défini dans ldap.filterDate soit un attribut valide car la requête générée (lors d'une recherche LDAP) est : 
#[((&(|(cn=*dupond*)(uid=*dupond*))(sn=*)(|(eduPersonAffiliation=*employee*)(eduPersonAffiliation=*researcher*)(eduPersonAffiliation=*student*)(eduPersonAffiliation=*faculty*))))]
ldap.filterDate=sn
ldap.filterEdupersonaffiliation=eduPersonAffiliation
ldap.filterEdupersonaffiliationValues=employee,researcher,student,faculty
#ldap.filterEdupersonaffiliationValues=member

ticketCommentModification=false
conf.inviteManagerMoveTicket=true

# Pour activer ou non le contrôle la visibilité de la catégorie redirigée (false : pour conserver le fonctionnement de la v3.x, true : pour appliquer le correctif)
check.visi.cat.virtual=false

# Conversion automatique des invitations mails en compte SI

auth.tryConvertMaillToCasUser=false
auth.mailToConvertPattern= 

Éditez ensuite les fichiers build.properties,

log4j.properties

et

src/main/resources/properties/i18n/bundles/Custom_fr.properties

si

nécessaire.

Récupérez les fichiers css de l'ancienne

version

du

helpdesk

(src/esup-helpdesk/webapp/media/)

:

commons.css,

custom.css,

helpdesk.css,

portlet.css.

Pour mettre à jour la base de données, il faut lancer la tâche ant d'upgrade ainsi que quelques requêtes SQL fournies dans les sources :

[test-helpdesk@helpdesk esup-helpdesk]$ ant upgrade
[test-helpdesk@helpdesk esup-helpdesk]$ mysql -u helpdesk_db_user -p helpdesk_db < src/main/resources/properties/dao/hibernate/updateBase-v3tov4.sql

Vous pouvez alors déployer cette nouvelle version

[test-helpdesk@helpdesk esup-helpdesk]$ ant deploy

Migration 4.2 branche AMU vers 4.2 branche master

On part de la dernière version AMU que l'on suppose se trouver dans le dossier src/esup-helpdesk

[test-helpdesk@helpdesk:/home/test-helpdesk/src/]$ mkdir old
[test-helpdesk@helpdesk:/home/test-helpdesk/src/]$ cp esup-helpdesk old/esup-helpdesk-AMU
[test-helpdesk@helpdesk:/home/test-helpdesk/src/esup-helpdesk/]$ git checkout -b master origin/master
[test-helpdesk@helpdesk:/home/test-helpdesk/src/esup-helpdesk/]$ cp ../old/esup-helpdesk-AMU/build-commons.xml ../old/esup-helpdesk-AMU/build.properties .
[test-helpdesk@helpdesk:/home/test-helpdesk/src/esup-helpdesk/]$ cp -pr  ../old/esup-helpdesk-AMU/src/main/resources/properties/logging/ src/main/resources/properties/
[test-helpdesk@helpdesk:/home/test-helpdesk/src/esup-helpdesk/]$ cp -r webapp/media.sample/ webapp/media

On a ajouté les éléments ci-dessous dans le fichier config.properties:

# envoi d'email uniquement au manager du ticket lors d'une assignation automatique
send.email.manager.only.automatic.assign=false
# Lien sur l'ENT de l'université, présent en entête de l'application
ent.url=https://ent.univ.fr

# Données de l'univeristé affichées dans divers endroits de l'application
institution.name=Universit\u00E9 …
footer.title=Universit\u00E9 …

# si renseignée, affichage dans l'onglet AIDE de liens vers une doc utilisateur et gestionnaire
help.user.url=https://univ.fr/aide-utilisateur
help.manager.url=https://univ.fr/aide-gestionnaire

Ceci étant fait, il ne reste plus qu'à faire un deploy

et un restart.

Par la suite, vous pouvez vous appropriez l'interface en faisant des modifications dans les dossiers webapp/stylesheets et webapp/media

Divers

Activer au démarrage

Voici notre fichier systemd ".service" utilisé pour gérer le démarrage de helpdesk via systemctl.

Bloc de code
[root@helpdesk:~]$ cat /usr/lib/systemd/system/test-helpdesk.service [Unit] Description=Test Helpdesk After=syslog.target network.target mariadb.service [Service] Type=forking User=test-helpdesk PIDFile=/home/test-helpdesk/tomcat-test-helpdesk.pid ExecStart=/home/test-helpdesk/start.sh ExecStop=/home/test-helpdesk/stop.sh [Install] WantedBy=multi-user.target

Problèmes rencontrés

Doublon de la librairie lucene-core

Il est possible qu'un jar soit en doublon, il génère l'erreur ci-dessous :

Image Added

Pour corriger cela, il faut supprimer le fichier webapp/WEB-INF/lib/lucene-core-4.9.1.jar.