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

Comparaison des versions

Ancienne version 20

changes.mady.by.user Pascal Aubry

Sauvegardée le

comparé à

Nouvelle version Actuel

changes.mady.by.user Nadia Azib

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Sommaire

Toutes les procédures d'administration s'exécutent en lançant les tâches ant du fichier build.xml., par exemple :

Bloc de code

ant update-index

Les scripts d'administration sont néanmoins nécessaires pour l'appel des tâches asynchrones :

  • la mise à jour des index
  • l'expiration des tickets fermés mais non approuvés par les utilisateurs
  • l'archivage des tickets fermés
  • le rappel automatique des tickets reportés
  • l'alimentation automatique par courrier électronique

Principales tâches d'administration

Initialisation de la base de données

ant init-data

Mise à jour de la base de données

ant upgrade

Démarrage|arrêt|redémarrage de l'application

ant start|stop|restart

Mise à jour de l'index

ant update-index

Reconstruction de l'index

ant rebuild-index

Déverrouillage de l'index

ant unlock-index

Archivage des tickets clos

ant archive-tickets

Expiration des tickets non archivés

ant expire-tickets

Rappel des tickets reportés

ant recall-tickets

Alimentation automatique

ant feed

Calcul des statistiques

ant compute-statistics

Astuce

Les tâches peuvent également être appelées à l'aide des scripts d'administration montrés ci-dessous.

Mise en place des scripts d'administration

Cette partie montre comment mettre en place les scripts d'administration et lancer les tâches asynchrones pour un déploiement quick-start.

Astuce

Ces procédures doivent être légèrement adaptées pour les autres déploiements (portlet et servlet).

Sous Unix

Nous supposons ici que tous les prérequis sont remplis et que le répertoire de base du projet est /usr/local/helpdesk. 

Voir : Prérequis

Bloc de code

[root@server helpdesk]# ls -al
total 96
-rwxr-xr-x  1 root root    78 2008-06-16 12:37 env.sh             (version courante)
drwxr-xr-x  2 root root 69632 2008-05-21 12:22 files              (fichiers attachés)
-rwxr-xr-x  1 root root   567 2008-03-28 10:16 helpdesk-cron.sh   (script d'appel des tâches asynchrones)
-rwxr-xr-x  1 root root   292 2008-03-28 10:16 helpdesk.sh        (script d'appel des tâches synchrones)
drwxr-xr-x  2 root root  4096 2008-06-18 11:50 index              (indexation)
drwxr-xr-x  2 root root  4096 2008-06-17 06:08 log                (traces d'exécution)
drwxr-xr-x 19 root root  4096 2008-06-16 12:38 src                (sources des distributions)

Scripts d'administration 

Le fichier env.sh contient la version courante :

Bloc de code

#/bin/bash
. /etc/profile.d/java.sh
export ESUP_HELPDESK_VERSION=3.0.1

Le script helpdesk.sh sert à l'appel des tâches synchrones (start, stop, deploy, ...) :

Bloc de code

#!/bin/bash
. /usr/local/helpdesk/env.sh
echo Esup-Portail Helpdesk $ESUP_HELPDESK_VERSION, running ant task $1
pushd /usr/local/helpdesk/src/esup-helpdesk-quick-start-$ESUP_HELPDESK_VERSION > /dev/null
ant $1
popd > /dev/null

Le script helpdesk peut être installé dans le répertoire /etc/init.d pour le démarrage automatique de l'application au boot de la machine :

Bloc de code

#!/bin/bash
#
# helpdesk     Startup script for ESUP-Portail helpdesk
#
# chkconfig: - 99 01
# description: esup-helpdesk is the helpdesk application \
#               provided by consortium ESUP-Portail.

# Source function library.
. /etc/rc.d/init.d/functions

prog=/usr/local/helpdesk/helpdesk.sh

start() {
        echo -n $"Starting $prog: "
        $prog start &
}
stop() {
        echo -n $"Stopping $prog: "
        $prog stop
}
status() {
        echo `ps aux | grep java | grep -v grep | wc -l` Java processes found.
}

# See how we were called.
case "$1" in
  start)
        start
        ;;
  stop)
        stop
        ;;
  status)
        status
        ;;
  restart)
        stop
        start
        ;;
  *)
        echo $"Usage: $prog {start|stop|restart|status}"
        exit 1
esac

Le redémarrage de l'application pourra ainsi se faire en appelant :

Bloc de code

/etc/init.d/helpdesk restart
Astuce
titleDémarrage automatique de l'application au boot

Pour faire en sorte que l'application démarre automatiquement au boot du serveur, utiliser le programme chkconfig.

Tâches asynchrones 

L'appel de tâches asynchrones est nécessaire pour :

  • la mise à jour des index
  • l'expiration des tickets fermés mais non approuvés par les utilisateurs
  • l'archivage des tickets fermés
  • le rappel automatique des tickets reportés

Le script helpdesk-cron.sh sert à l'appel des tâches asynchrones (update-index, archive-tickets, recall-tickets, ...) :

Bloc de code

#!/bin/bash
. /usr/local/helpdesk/env.sh
[ -z "$1" ] && { exit 1; }
export LOG_FILE=/usr/local/helpdesk/log/$1.log
echo ----------------------------------------------- >> $LOG_FILE
date >> $LOG_FILE
echo Esup-Portail Helpdesk $ESUP_HELPDESK_VERSION, running ant task $1 >> $LOG_FILE
pushd /usr/local/helpdesk/src/esup-helpdesk-quick-start-$ESUP_HELPDESK_VERSION > /dev/null
ant $1 >> $LOG_FILE
popd > /dev/null

Les appels des tâches asynchrones sont réalisés grâce à l'insertion des lignes suivantes dans le fichier /etc/crontab :

Bloc de code

00,05,10,15,20,25,30,35,40,45,50,55 * * * * root /usr/local/helpdesk/helpdesk-cron.sh update-index
02 * * * * root /usr/local/helpdesk/helpdesk-cron.sh expire-tickets
03 * * * * root /usr/local/helpdesk/helpdesk-cron.sh archive-tickets
01 0 * * * root /usr/local/helpdesk/helpdesk-cron.sh recall-tickets
15 * * * * root /usr/local/helpdesk/helpdesk-cron.sh compute-statistics

Sous Windows

...