esup-helpdesk




La liste d'utilisateurs n'est pas rendue car vous ne possédez pas les droits d'accès nécessaires pour afficher les profils utilisateur.

Arborescence des pages

Introduction

Il y a désormais une nouvelle version de ESUP-Helpdesk (4.2) qui peut être récupérée sur le dépôt github. Cette version est divisée en deux branches :

  1. Une branche sans changement de l'interface web (AMU)
  2. Une branche avec la nouvelle interface web (master)

La branche master est la version 3.30, ancienne version mavenisée.


Sommaire

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 :

Récupération des sources avec git
[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

/home/test-helpdesk/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:

src/main/resources/properties/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.

[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.

  • Aucune étiquette