Historique de la page
...
...
- One branch without any change in the UI (called AMU)
- One branch with a massive UI change (called AMU_IHM)
3.29 to 4.2 AMU
Here is the documentation which allows you to migrate from the old 3.29 version to the new 4.2 version (the AMU branch, with the same UI) :
...
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 :
| Bloc de code | ||
|---|---|---|
| ||
[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
...
:
| Bloc de code |
|---|
[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/ |
...
Then, we can make the DB upgrade and add couple of additionnal queries :
...
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 :
| Bloc de code |
|---|
[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
| Bloc de code |
|---|
[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
| Bloc de code | ||||||
|---|---|---|---|---|---|---|
| ||||||
[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:
| Bloc de code | ||||||
|---|---|---|---|---|---|---|
| ||||||
# 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
Misc
...
.
| 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 :
Pour corriger cela, il faut supprimer le fichier webapp/WEB-INF/lib/lucene-core-4.9.1.jar.
