Aller au contenu principal

Solutions < AutoDiag

Diagnostic Autosys

Autosys propose différents outils en ligne pour interagir avec le gestionnaire d’évènements mais quelle commande doit on effectuer pour obtenir la bonne information ? autodiag est un script Perl qui exécute des séries de commandes pour afficher une information pertinente en fonction du contexte.

Attention ! Ce script ne fonctionne qu’à partir de la 11.3

E. Angenault

26 août 2011

 POPULARITE : 587 visites

Le script Autodiag fournit les informations nécessaires à la compréhension du statut d’un traitement. Il utilise les différentes commandes Autosys en fonction de l’état du traitement et éventuellement des réponses des commandes précédentes.

Il utilise les couleurs du terminal pour mettre en relief les informations pertinentes. Ce mode fonctionne aussi bien sur Unix que sur Windows mais il est nécessaire d’indiquer le mode ANSI sur Windows.

Les informations obtenues sont volontairement édulcorées pour rendre le résultat plus lisible. Pour des informations plus détaillées, il sera nécessaire de jouer les commandes Autosys.

Commandes utilisées par le script

autoflags -x Version du produit
autorep -J $job -w -d -l0 Evènements détaillés du traitement
autorep -J $job -q -l0 Définition du traitement
autorep -J $job -o0 -l0 "Override" du traitement
autorep -J $job -w Evènements du traitements et des sous-traitements
autorep -V $r Définition des ressources
autostatus -G $j Contenu d’une variable globale
autostatus -J $j Statut d’un traitement
job_depends -J $job -c Dépendances d’un traitement
autorep -m $mac Etat d’une machine
autosyslog -J $job -t O Sortie standard du traitement
autosyslog -J $job -t E Sortie d’erreur du traitement
autosyslog -J $job -t A Journal de l’agent
autosyslog -J $job -t P Journal du profil (désactivé)
autotrack -J $job -v Audit des actions sur le traitement
autosyslog -e -l 20 Journal du gestionnaire d’évènements
autocal_asc -s $calendar -E autodiag.tmp Extraction des calendriers

Utilisation

Pour être utilisé, il faut :
- un interpréteur Perl
- l’environnement Autosys

Testez au moins une commande Autosys pour être sur d’être dans le bon environnement de travail, si ce n’est pas le cas, il faut vous connecter avec un utilisateur autosys disposant des droits superexec et superedit sur l’instance concernée.

Pour vérifier que vous disposez bien de perl, vous pouvez lancer la commande :

perl -v

Aucune bibliothèque Perl n’est nécessaire, le script ne fait qu’exécuter les commandes et traiter le résultat avec des commandes basiques.

Le diagnostic est obtenu en précisant le nom du traitement :

perl autodiag.pl -job=<job_name>

Si vous souhaitez connaître les commandes passées par le script, il faut préciser le mode verbeux.

perl autodiag.pl -job=<job_name> -verbose=y

Ce mode permet aux débutants sur Autosys de se familiariser avec les diverses commandes.

PNG - 2.9 ko
Override
l’heure de départ, habituellement à 11:15, a été décalé à 13:00.

Définition

Le script commence par récupérer la définition du traitement et éventuellement la définition temporaire, celle ci est mise en place par une mécanisme nommé "override" qui consiste à modifier certains champs qui ne seront pris en compte qu’à la prochaine exécution.

Cet élément est important dans la mesure ou le comportement du traitement sera différent de celui habituellement attendu, or Autosys n’indique jamais qu’un traitement est en mode override ou non, il est absolument nécessaire de le vérifier systématiquement.

PNG - 18.4 ko
Audit
L’audit permet de connaître l’ensemble des actions réalisées sur le traitement.

Audit

Dans la plupart des cas, l’audit est un élément indispensable car il permet d’identifier les problèmes dus aux interventions humaines.

PNG - 24.3 ko
Journal du manager
Les dernières lignes du gestionnaire d’évènements permettent de vérifier que l’ordonnanceur tourne correctement.

Journal du gestionnaire

Dans tous les cas, le journal du gestionnaire est affiché afin de comparer l’heure de traitement des derniers évènements avec l’heure courante.

Statut SUCCESS

Lorsque un traitement est en SUCCESS, il n’y a généralement aucun diagnostic à réaliser.

PNG - 13.5 ko
Problème de calendrier
Aucune date de planification n’est calculée, après vérification il s’avère que le calendrier ne contient plus de date valide.

Le point principal a vérifier est que la prochaine planification est correctement calculé.

Statut RUNNING

Lorsque le traitement est en cours, le script fournit différentes informations en fonction du type de traitement.

PNG - 17.5 ko
Boite en exécution
La boite est en exécution tant qu’il reste des traitements en exécution à l’intérieur.

Si le traitement est une boite, le script indique l’ensemble des traitements de la boite ainsi que leur statut, la boite est en statut RUNNING tant que ces traitements sont état RUNNING ou ACTIVATED.

PNG - 11 ko
File Watcher
Le fichier File_Trigger_00.txt est en attente de création.

Si le traitement est une attente de fichier, on indique le fichier attendu.

Différentes actions sont proposées pour débloquer cette situation.

PNG - 14.6 ko
Traitement en erreur
L’historique permet d’obtenir des informations sur l’origine de l’erreur, d’autant plus lorsque l’exit code est négatif.

Statut FAILURE

Si le traitement est en erreur, il peut s’agir d’une erreur de définition ou d’une erreur applicative.

La première information à vérifier est l’exit code, si celui-ci est négatif, le problème vient certainement d’une erreur de configuration Autosys. L’historique des évènements doit fournir une information pertinente.

PNG - 16.5 ko
Sortie d’erreur
Le traitement a indiqué un problème de permission sur la sortie d’erreur.

Dans le cas contraire, l’information est dans le journal du traitement, il est donc fortement conseillé d’ordonnancer des traitements qui écrivent sur la sortie standard et/ou la sortie d’erreur.

Statut TERMINATED

PNG - 4.7 ko
Ressources
La ressource attendue ne dispose plus de jetons.

Statut RESWAIT

Le statut RESWAIT indique une attente de ressource. Le script compare les ressources attendues avec les valeurs effectives.

PNG - 4.4 ko
Conditions
Le traitement attend le succès du traitement GLOBAL_CHECK_Sleep_180 or celui ci est actuellement en exécution.

Statut ACTIVATED

Le statut ACTIVATED signifie que le traitement est prêt à être lancé mais qu’il reste des contraintes. Ces contraintes sont généralement indiquées dans le champ condition.

Dans ce contexte, le contenu du champ condition est affiché et l’ensemble des conditions est évalué.

PNG - 5.6 ko
Machine offline
Le traitement est en attente de ressource car l’agent est en statut offline.

Statut PENDING

Un traitement est généralement PENDING lorsque la machine est en maintenance, le script indique la machine cible et vérifie son état.

PNG - 3 ko
Traitement gelé
Le traitement n’a pas de successeurs, le gel est donc sans impact.

Statut ON_ICE

Un traitement gelé est directement supprimé du plan de production ce qui signifie que les successeurs n’ont plus de contraintes et peuvent démarrer automatiquement.

PNG - 3 ko
Traitement bloqué
Aucun successeur n’est bloqué.

Statut ON_HOLD

Un traitement bloqué entraine le blocage de ses successeurs.


Audit

L’audit permet de connaître l’ensemble des actions réalisées sur le traitement.


Boite en exécution

La boite est en exécution tant qu’il reste des traitements en exécution à l’intérieur.


Conditions

Le traitement attend le succès du traitement GLOBAL_CHECK_Sleep_180 or celui ci est actuellement en exécution.


Erreur de ressource

Lorsqu’une ressource est manquante, on retrouve l’information dans le journal du gestionnaire.


File Watcher

Le fichier File_Trigger_00.txt est en attente de création.


Journal du manager

Les dernières lignes du gestionnaire d’évènements permettent de vérifier que l’ordonnanceur tourne correctement.


Machine offline

Le traitement est en attente de ressource car l’agent est en statut offline.


Override

l’heure de départ, habituellement à 11:15, a été décalé à 13:00.


Problème de calendrier

Aucune date de planification n’est calculée, après vérification il s’avère que le calendrier ne contient plus de date valide.


Ressources

La ressource attendue ne dispose plus de jetons.


Sortie d’erreur

Le traitement a indiqué un problème de permission sur la sortie d’erreur.


Traitement bloqué

Aucun successeur n’est bloqué.


Traitement en erreur

L’historique permet d’obtenir des informations sur l’origine de l’erreur, d’autant plus lorsque l’exit code est négatif.


Traitement gelé

Le traitement n’a pas de successeurs, le gel est donc sans impact.


autodiag.pl (PERL)

Première version du script de diagnostic automatique pour Autosys 11.3.

Télécharger PERL  (25023 octets)

autodiag.pl (Zip)

Première version du script de diagnostic automatique pour Autosys 11.3.

Télécharger Zip (6960 octets)


Doc
A la une

Article d’actualité publié en première page du site.

Voir aussi...
autotrad, Cas pratique, Communiqué de Presse, Documentation, Eyrolles, FAQ, Fiche technique, Forum utilisateur, graphique, news, Procédure d’installation, Scripts

Le document issu de http://Ordonnancement.org est mis à disposition sous les termes de la licence Creative Commons, vous pouvez l'utilisez dans vos documents à condition de citer l'auteur E. Angenault, vous êtes aussi libre de le modifier. Par contre, vous devez le redistribuer dans les mêmes conditions et la commercialisation ne peut se faire qu'avec l'accord de l'auteur.