Historique de la page
Migration 3.29 vers 4.2 (branche AMU ou
AMU_IHMmaster)
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 AMU_IHM 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 AMU_IHMmaster [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/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
AMU_IHMmaster
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 AMU_IHMmaster origin/AMU_IHMmaster [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
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 |