Comprendre les statuts de déploiement Medulla
Lors d'une télédistribution avec Medulla, chaque machine ciblée dispose d'un statut permettant de connaître l'état d'avancement du déploiement.
Ces statuts permettent notamment de distinguer :
- un déploiement terminé avec succès ;
- un déploiement toujours en cours ou en attente ;
- un déploiement interrompu ;
- un déploiement ayant rencontré une erreur.
Information :
Le statut affiché dans Medulla permet d'identifier rapidement l'étape atteinte par le déploiement. Lorsqu'un statut de type ABORT ou ERROR est affiché, le détail de l'audit du déploiement permet généralement d'obtenir des informations complémentaires sur l'origine du problème.
1. Les principales familles de statuts
Les statuts de déploiement peuvent être regroupés en plusieurs grandes catégories.
| Famille | Signification |
|---|---|
DEPLOYMENT SUCCESS |
Le déploiement s'est terminé avec succès. |
DEPLOYMENT START |
Le déploiement est en cours de traitement. |
DEPLOYMENT PENDING |
Le déploiement est temporairement en attente avant son exécution. |
WAITING ... |
Medulla attend une action ou un changement d'état de la machine, par exemple son redémarrage ou sa remise en ligne. |
DEPLOYMENT SPOOLED |
Le déploiement est placé dans une file d'attente. |
DEPLOYMENT ERROR |
Une erreur a empêché le déploiement de se terminer normalement. |
DEPLOYMENT ABORT / ABORT ... |
Le déploiement a été interrompu avant son terme. |
Conseil :
Un statut intermédiaire n'indique pas nécessairement un problème. Certains statuts correspondent simplement à une attente normale dans le cycle de déploiement.
2. DEPLOYMENT SUCCESS
Le statut :
DEPLOYMENT SUCCESS
indique que le déploiement s'est terminé avec succès sur la machine concernée.
Aucune action particulière n'est normalement nécessaire.
Succès :
Le package a terminé son cycle de déploiement sur la machine cible.
3. DEPLOYMENT START
Le statut :
DEPLOYMENT START
indique que le déploiement est en cours de traitement.
Lorsque la machine cible est éteinte, Medulla peut tenter de la réveiller à l'aide du Wake On LAN.
Le processus peut notamment passer par les étapes suivantes :
WOL 1
WOL 2
WOL 3
WAITING MACHINE ONLINE
Medulla effectue jusqu'à trois tentatives de Wake On LAN si celles-ci sont nécessaires.
Si la machine ne revient pas immédiatement en ligne, le déploiement peut rester en attente pendant la plage horaire autorisée.
Information :
Le statut DEPLOYMENT START ne signifie donc pas nécessairement que l'exécution du package a déjà commencé sur la machine. Medulla peut encore être en attente de la disponibilité du poste.
4. WAITING MACHINE ONLINE
Le statut :
WAITING MACHINE ONLINE
indique que Medulla attend que la machine cible soit disponible.
Ce statut peut notamment apparaître après plusieurs tentatives de Wake On LAN lorsque le poste reste éteint ou indisponible.
Le déploiement reste alors en attente tant que la plage horaire du déploiement le permet.
Attention :
Si la machine ne revient pas en ligne avant la fin de la plage de déploiement, le traitement peut finalement être interrompu avec un statut de type ABORT ON TIMEOUT.
5. DEPLOYMENT PENDING
Le statut DEPLOYMENT PENDING correspond à un état temporaire avant le lancement effectif de l'opération sur la machine.
Il peut notamment être affiché lorsqu'un déploiement doit attendre qu'une ressource ou qu'un emplacement d'exécution soit disponible.
Par exemple, plusieurs déploiements peuvent être en cours simultanément et occuper les emplacements de déploiement disponibles.
Information :
Un statut DEPLOYMENT PENDING ponctuel est donc normal. Il devient surtout intéressant à analyser lorsqu'il reste présent pendant une durée anormalement longue.
6. WAITING REBOOT
Le statut :
WAITING REBOOT
indique qu'un redémarrage de la machine est attendu dans le cadre du déploiement.
Cette demande de redémarrage provient du workflow du package lorsque celui-ci comporte une étape nécessitant un reboot de la machine cliente.
Le déploiement reprendra ensuite en fonction du comportement prévu par le package.
7. DEPLOYMENT SPOOLED
Le statut :
DEPLOYMENT SPOOLED
indique que le déploiement a été placé dans une file d'attente.
Il s'agit d'un statut dynamique qui peut apparaître pendant le traitement d'un déploiement lorsque celui-ci ne peut pas être exécuté immédiatement.
Un message similaire au suivant peut être associé à ce statut :
Spooling the deployment in queue
Information :
La présence temporaire de DEPLOYMENT SPOOLED n'indique pas à elle seule une erreur.
8. DEPLOYMENT DIFFERED et DEPLOYMENT DELAYED
Medulla peut également afficher les statuts :
DEPLOYMENT DIFFERED
DEPLOYMENT DELAYED
Ces statuts correspondent à des situations dans lesquelles l'exécution du déploiement est différée ou retardée.
Information :
Le document d'exploitation Medulla 5 utilisé comme référence identifie ces deux statuts mais ne fournit pas de description fonctionnelle plus détaillée de leur comportement. Leur interprétation doit donc être effectuée en tenant compte du contexte du déploiement et des informations disponibles dans son audit.
9. DEPLOYMENT ERROR
Le statut :
DEPLOYMENT ERROR
indique qu'une erreur a empêché le déploiement de se terminer normalement.
Le statut peut être accompagné d'un message plus précis permettant d'identifier la nature de l'erreur.
Parmi les messages rencontrés :
ERROR UNKNOWN ERROR
ERROR TRANSFER FAILED
Attention :
Lorsqu'un déploiement est en erreur, consultez en priorité l'audit du déploiement et le message d'erreur associé. Le statut DEPLOYMENT ERROR seul ne permet pas toujours d'identifier la cause exacte.
10. DEPLOYMENT ABORT et statuts ABORT
Un statut contenant ABORT signifie que le déploiement a été interrompu avant son terme.
La raison de l'interruption est généralement indiquée directement dans le statut.
Medulla peut notamment rencontrer les statuts suivants :
ABORT ON TIMEOUT
ABORT MISSING AGENT
ABORT RELAY DOWN
ABORT ALTERNATIVE RELAYS DOWN
ABORT INFO RELAY MISSING
ABORT PACKAGE IDENTIFIER MISSING
ABORT PACKAGE NAME MISSING
ABORT PACKAGE VERSION MISSING
ABORT PACKAGE WORKFLOW ERROR
ABORT DESCRIPTOR MISSING
ABORT MACHINE DISAPPEARED
ABORT DEPLOYMENT CANCELLED BY USER
ABORT PACKAGE EXECUTION ERROR
ABORT DUPLICATE MACHINE
ABORT TRANSFER FAILED
ABORT PACKAGE EXECUTION CANCELLED
ABORT MISSING DEPENDENCY
Ces statuts permettent de distinguer rapidement plusieurs grandes familles de problèmes :
| Type d'erreur | Exemples |
|---|---|
| Machine indisponible | ABORT ON TIMEOUT, ABORT MACHINE DISAPPEARED |
| Agent Medulla | ABORT MISSING AGENT |
| Serveur relais | ABORT RELAY DOWN, ABORT ALTERNATIVE RELAYS DOWN, ABORT INFO RELAY MISSING |
| Package incomplet ou incorrect | ABORT PACKAGE IDENTIFIER MISSING, ABORT PACKAGE NAME MISSING, ABORT PACKAGE VERSION MISSING, ABORT DESCRIPTOR MISSING |
| Workflow ou exécution | ABORT PACKAGE WORKFLOW ERROR, ABORT PACKAGE EXECUTION ERROR |
| Transfert | ABORT TRANSFER FAILED |
| Dépendance | ABORT MISSING DEPENDENCY |
| Machine dupliquée | ABORT DUPLICATE MACHINE |
| Annulation volontaire | ABORT DEPLOYMENT CANCELLED BY USER, ABORT PACKAGE EXECUTION CANCELLED |
Information :
Une FAQ spécifique peut être utilisée pour le diagnostic détaillé de ces erreurs et les actions correctives associées.
11. ABORT TRANSFER FAILED
Le statut :
ABORT TRANSFER FAILED
indique que le transfert des fichiers nécessaires au déploiement n'a pas pu être effectué.
Le message détaillé disponible dans l'audit du déploiement doit être consulté afin d'identifier l'origine exacte du problème.
Un message associé peut par exemple être :
Transfer error: curl download
Attention :
Ce statut indique un problème de transfert et non nécessairement un problème dans les commandes contenues dans le package.
12. ABORT PACKAGE EXECUTION CANCELLED
Le statut :
ABORT PACKAGE EXECUTION CANCELLED
indique que l'exécution du package a été annulée.
Ce comportement peut notamment apparaître dans le cadre d'un déploiement différé lorsque les conditions attendues pour poursuivre l'exécution ne sont pas remplies.
Un message associé peut être :
Package delayed execution cancelled
13. Lire le statut avec l'audit du déploiement
Le statut constitue une première indication sur l'état du déploiement, mais il doit être interprété avec les informations disponibles dans l'audit du déploiement.
En cas d'échec, l'audit peut notamment permettre d'identifier :
- la phase du déploiement concernée ;
- le message d'erreur retourné ;
- un problème de transfert ;
- une erreur d'exécution du package ;
- un problème de workflow ;
- une machine ou un relais indisponible.
Recommandation :
Lorsqu'un statut ABORT ou ERROR est rencontré, relevez le statut exact ainsi que le message disponible dans l'audit. Ces deux informations permettent de cibler beaucoup plus rapidement le diagnostic.
14. Tableau récapitulatif
| Statut | Signification | Action immédiate |
|---|---|---|
DEPLOYMENT SUCCESS |
Déploiement terminé avec succès | Aucune |
DEPLOYMENT START |
Déploiement en cours de traitement | Attendre |
WAITING MACHINE ONLINE |
Medulla attend que la machine soit disponible | Vérifier le poste si l'attente devient anormalement longue |
DEPLOYMENT PENDING |
Déploiement temporairement en attente | Attendre, puis analyser si le statut persiste |
WAITING REBOOT |
Le workflow attend un redémarrage | Vérifier le redémarrage si le statut persiste |
DEPLOYMENT SPOOLED |
Déploiement placé en file d'attente | Attendre, puis analyser si le statut persiste |
DEPLOYMENT DIFFERED |
Déploiement différé | Consulter le contexte et l'audit |
DEPLOYMENT DELAYED |
Déploiement retardé | Consulter le contexte et l'audit |
DEPLOYMENT ERROR |
Erreur pendant le déploiement | Consulter le message d'erreur et l'audit |
ABORT ... |
Déploiement interrompu | Identifier la raison indiquée après ABORT |
15. Résumé
Les statuts de déploiement Medulla permettent de suivre précisément le cycle de vie d'une télédistribution.
Ils permettent principalement de distinguer :
- les déploiements terminés avec succès ;
- les déploiements en cours ;
- les déploiements en attente ;
- les déploiements interrompus ;
- les déploiements en erreur.
Recommandation :
Pour analyser un problème de télédistribution, commencez toujours par relever le statut exact du déploiement. Pour les statuts ABORT ou ERROR, consultez ensuite le détail de l'audit afin d'identifier la cause et de poursuivre le diagnostic.