Propriété d'un task

Options générales

**Figure 6:** Propriété d'un task
$\includegraphics{inc/cmd_prop1.eps}$

Propriété Informations Exemple

Use Identifiant du modèle pour le task. Ce modèle (template) permet de positionner des options par défaut. identifiant

Id Représente l'identifiant de la tâche (task). Il est utilisé dans tout le système pour identifier de manière unique la tâche. identifiant

Command Commande à exécuter pour cette tâche tar cfvz /bkp.tgz /etc

Host Ce champs permet spécifier sur quel serveur sera exécuté la commande. serveur1

Comment Commentaire comment

Condition Script de condition qui est exécuté avant l'exécution de la commande. Le script doit retourner une valeur vraie pour autoriser l'exécution de la commande. (voir Section 6.1). ok('avant-sleep')

Propriété	Informations	Exemple
Use	Identifiant du modèle pour le task. Ce modèle (template) permet de positionner des options par défaut.	`identifiant`
Id	Représente l'identifiant de la tâche (task). Il est utilisé dans tout le système pour identifier de manière unique la tâche.	`identifiant`
Command	Commande à exécuter pour cette tâche	`tar cfvz /bkp.tgz /etc`
Host	Ce champs permet spécifier sur quel serveur sera exécuté la commande.	`serveur1`
Comment	Commentaire	`comment`
Condition	Script de condition qui est exécuté avant l'exécution de la commande. Le script doit retourner une valeur vraie pour autoriser l'exécution de la commande. (voir Section 6.1).	`ok('avant-sleep')`

Options entrée/sortie

**Figure 7:** Propriété d'un task (I/O)
$\includegraphics{inc/cmd_prop2.eps}$

Propriété Informations Exemple

stdin Entrée standard de la commande /etc/passwd

stdout Sortie standard de la commande (par défaut ${ID}.stdout) Attention les fichiers en dehors du workdir ne seront pas initialisés avec les droits requis par user/group fichier.out

stderr Sortie d'erreur de la commande (par défaut ${ID}.stderr) Attention les fichiers en dehors du workdir ne seront pas initialisés avec les droits requis par user/group fichier.err

Propriété	Informations	Exemple
stdin	Entrée standard de la commande	`/etc/passwd`
stdout	Sortie standard de la commande (par défaut `${ID}.stdout`) Attention les fichiers en dehors du workdir ne seront pas initialisés avec les droits requis par user/group	`fichier.out`
stderr	Sortie d'erreur de la commande (par défaut `${ID}.stderr`) Attention les fichiers en dehors du workdir ne seront pas initialisés avec les droits requis par user/group	`fichier.err`

Visualisation via sched_view

Pour pourvoir visualiser les fichiers de log depuis sched_view il faut que ces fichiers soit dans le répertoire courant (ne pas préciser de path dans leur définition).

Autres options

**Figure 8:** Propriété d'un task (Autres options)
$\includegraphics{inc/cmd_prop3.eps}$

Propriété Informations Exemple

After Exec Script exécuté après l'exécution de la commande. Ce script peut être utilisé pour envoyer un mail ou une alerte par exemple (voir 6.1 ) ok('sleep') or job_end(1)

Max exec time Temps maximum d'exécution de la commande (en seconde). A la fin de ce temps réglementaire la commande reçoit un SIGTERM, le statut passe alors à l'état kill puis un SIGKILL (état cancel) 60

User Utilisateur utilisé pour la commande. Attention, les fichiers profile des utilisateurs ne sont pas parsés. root

Group Groupe utilisé pour la commande. root

Env Variable d'environnement. Les variables placées ici seront exportées avant l'exécution de la commande. HOME=/root

Propriété	Informations	Exemple
After Exec	Script exécuté après l'exécution de la commande. Ce script peut être utilisé pour envoyer un mail ou une alerte par exemple (voir 6.1 )	`ok('sleep') or job_end(1)`
Max exec time	Temps maximum d'exécution de la commande (en seconde). A la fin de ce temps réglementaire la commande reçoit un SIGTERM, le statut passe alors à l'état `kill` puis un SIGKILL (état `cancel`)	`60`
User	Utilisateur utilisé pour la commande. Attention, les fichiers profile des utilisateurs ne sont pas parsés.	`root`
Group	Groupe utilisé pour la commande.	`root`
Env	Variable d'environnement. Les variables placées ici seront exportées avant l'exécution de la commande.	`HOME=/root`

Variables

Domaine

Les variables sont valables sur les entrées suivantes :

ligne de commande (cmdline)
sortie d'erreur (stderr)
sortie standard (stdout)
entrée standard (stdin)
utilisateur (user)
group (group)
machine cible (host)
script de condition (cond)
script de fin de tâche (after_cmd)

Format

Les variables sont de la forme :

[a-zA-Z0-9_-]+

Substitution

La variable s'utilise alors comme en shell (${VAR}). Les variables ne sont pas ajoutées dans l'environnement d'exécution des programmes. Les variables sont substituées au chargement d'une commande. (première tentative d'exécution).

Il est possible d'utiliser le format de strftime(3) dans les chaînes. Attention, l'exécution d'une commande peut être décalée. (attente d'une condition par exemple) Il peut y avoir des soucis dans l'utilisation d'un horodatage précis.

Variables systèmes

ID: : id de la tache courante
SERIAL: : identifiant du job en cours
HOSTNAME: : nom du serveur courant

Exemple

Variable :

DATE = date-%Y%M%D

Sur une commande par exemple (cmdline) :

tar tfz backup_${DATE}.tgz => tar tfz backup_date-20050210.tgz

Variables d'environnement

Il est possible de positionner des variables d'environnement au niveau du job (valable pour toutes les task) et au niveau de chaque task (champ env). Ces variables sont utilisables même si la tâche est exécuté sur un autre serveur.

Format

Il faut une variable par ligne et pas de variable vide.

    VAR1=/home
    VAR2="/home"
    VAR3=/home /home2 home4
    VAR5='/home1 /home2'

Restriction

Il n'y a pas de substitution possible. Par exemple :

    VAR1=mavariable
    VAR2=${VAR1}2

ne fonctionnera pas.

Eric 2005-12-17