Toutes les procédures d'administration s'exécutent en lançant les tâches ant du fichier All the administration procedures are executed by launching ant tasks declared in the ant file build.xml., par exemple for instance:

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

Administration scripts are however needed to call asynchrnous tasks:

• upgrading the index
• expiring and archiving tickets
• recalling postponed tickets
• feeding the helpdesk from misc sources

Main administration tasks

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.

Setting up administration scripts

...

On a Unix

...

system

We presume here that the project base is Nous supposons ici que tous les prérequis sont remplis et que le répertoire de base du projet est /usr/local/helpdesk. 

Voir : 00 Requirements

[root@server helpdesk]# ls -al
total 96
-rwxr-xr-x  1 root root    78 2008-06-16 12:37 env.sh             (current version courante)
drwxr-xr-x  2 root root 69632 2008-05-21 12:22 files              (fichiersattached attachésfiles)
-rwxr-xr-x  1 root root   567 2008-03-28 10:16 helpdesk-cron.sh   (scriptasynchrnous d'appel des tâches asynchronestasks script)
-rwxr-xr-x  1 root root   292 2008-03-28 10:16 helpdesk.sh        (scriptsynchrnous d'appel des tâches synchronestasks script)
drwxr-xr-x  2 root root  4096 2008-06-18 11:50 index              (indexationindex data)
drwxr-xr-x  2 root root  4096 2008-06-17 06:08 log                (traces d'exécutionlogs)
drwxr-xr-x 19 root root  4096 2008-06-16 12:38 src                (sourcesdistribution des distributionsfiles)

Scripts d'administration 

Administration scripts

The file Le fichier env.sh contient la contains the current version courante :

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

Le The script helpdesk.sh sert à l'appel des tâches synchrones is used to run synchrnous tasks (start, stop, deploy, ...):

#!/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 The script helpdesk peut être installé dans le répertoire can be installed in the folder /etc/init.d pour le démarrage automatique de l'application au boot de la machine for the application to automatically start when the server boots:

#!/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

...

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

Asynchronous tasks

Calling asynchronous tasks is needed for:

• updating the index
• expiring and archiving tickets
• recalling tickets
• sending daily reports

The Le script helpdesk-cron.sh sert à l'appel des tâches asynchrones is used to call asynchronous tasks (update-index, archive-tickets, recall-tickets, ...):

#!/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 Asynchrnous tasks are called periodically thanks to the following lines in the file /etc/crontab:

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

...

On a Windows system