Au lieu d'interroger, vous pouvez vous abonner pour recevoir des notifications sur les événements lorsque certains changements d'état surviennent. Il y a trois types d'événements auxquels vous pouvez vous abonner, individuellement ou collectivement. Reportez-vous à la section Types d'événements pour obtenir des détails complets.
Utilisez un message <LDM_interface> pour enregistrer les événements. Voir la section Balise <LDM_interface>. La balise <action> détaille le type d'événement pour lequel s'enregistrer ou annuler l'enregistrement et la section <data> reste vide.
Exemple 23-3 Exemple de message de demande d'enregistrement d'événement<LDM_interface version="1.3"> <cmd> <action>reg-domain-events</action> <data version="3.0"/> </cmd> </LDM_interface>
Logical Domains Manager répond avec un message de réponse <LDM_interface> indiquant si l'enregistrement ou l'annulation de l'enregistrement a abouti.
Exemple 23-4 Exemple de message de réponse d'enregistrement d'événement<LDM_interface version="1.3"> <cmd> <action>reg-domain-events</action> <data version="3.0"/> <response> <status>success</status> </response> </data> <response> <status>success</status> </response> </cmd> <response> <status>success</status> </response> </LDM_interface>
La chaîne d'action pour chaque type d'événement est répertoriée dans la sous-section des événements.
Les messages d'événements ont le même format qu'un message <LDM_interface> entrant à l'exception que la balise de début pour le message est <LDM_event>. La balise <action> du message est l'action qui a été effectuée pour déclencher l'événement. La section <data> du message décrit l'objet associé à l'événement ; les détails dépendent du type d'événement survenu.
Exemple 23-5 Exemple de notification <LDM_event><LDM_event version='1.1'> <cmd> <action>Event command here</action> <data version='3.0'> <Envelope <References/> <Content xsi:type='ovf:VirtualSystem_Type' ovf:id='ldg1'/> <Section xsi:type="ovf:ResourceAllocationSection_type"> <Item> <rasd:OtherResourceType>LDom Resource Type</rasd:OtherResourceType> <gprop:GenericProperty key="Property name">Property Value</gprop:GenericProperty> </Item> </Section> </Envelope> </data> </cmd> </LDM_event>
Vous pouvez vous abonner aux types d'événement suivants :
Evénements du domaine
Evénements matériels
Evénements de progression
Evénements de ressource
Tous les événements correspondent aux sous-commandes ldm.
Les événements du domaine décrivent les actions pouvant être directement effectuées sur un domaine. Les événements du domaine peuvent être spécifiés dans la balise <action> du message <LDM_event> :
add-domain
bind-domain
domain-reset
migrate-domain
panic-domain
remove-domain
start-domain
stop-domain
unbind-domain
Ces événements contiennent toujours uniquement une balise <Content> dans la section <data> OVF qui décrit sur quel domaine l'événement est survenu. Pour vous abonner aux événements du domaine, envoyez un message <LDM_interface> avec la balise <action> définie sur reg-domain-events. Pour annuler votre abonnement à ces événements, envoyez un message <LDM_interface> avec la balise <action> définie sur unreg-domain-events.
Les événements matériels concernent les modifications du matériel du système physique. Dans le cas du logiciel Oracle VM Server for SPARC, les seules modifications matérielles pouvant être effectuées sont celles sur le processeur de service (SP) lorsqu'un utilisateur ajoute, supprime ou définit une configuration SP. Actuellement, les trois seuls événements de ce type sont :
add-spconfig
set-spconfig
remove-spconfig
Les événements matériels contiennent toujours uniquement une balise <Section> dans la section <data> OVF qui décrit la configuration SP sur laquelle l'événement se produit. Pour vous abonner à ces événements, envoyez un message <LDM_interface> avec la balise <action> définie sur reg-hardware-events. Pour annuler votre abonnement à ces événements, envoyez un message <LDM_interface> avec la balise <action> définie sur unreg-hardware-events.
Les événements de progression sont émis pour les commandes à exécution longue, notamment la migration de domaine. Ces événements signalent la quantité de progression ayant été effectuée au cours du cycle de vie de la commande. Actuellement, seul l'événement migration-process est signalé.
Les événements de progression contiennent toujours uniquement une balise <Section> dans la section <data> OVF qui décrit la configuration SP affectée par l'événement. Pour vous abonner à ces événements, envoyez un message <LDM_interface> avec la balise <action> définie sur reg-hardware-events. Pour annuler votre abonnement à ces événements, envoyez un message <LDM_interface> avec la balise <action> définie sur unreg-hardware-events.
La section <data> d'un événement de progression est composée d'une section <content> qui décrit le domaine concerné. Cette section <content> utilise une balise ldom_info <Section> pour mettre à jour la progression. Les propriétés génériques suivantes sont affichées dans la section ldom_info :
--progress - Pourcentage de progression effectué par la commande
--status – Etat de la commande qui peut être ongoing, failed ou done
--source – Machine qui signale la progression
Les événements de ressource surviennent lorsque les ressources sont ajoutées, supprimées ou modifiées dans un domaine. La section <data> de certains de ces événements contient la balise <Content> avec une balise <Section> indiquant un nom de service dans la section <data> OVF.
Les événements suivants peuvent être spécifiés dans la balise <action> du message <LDM_event> :
add-vdiskserverdevice
remove-vdiskserverdevice
set-vdiskserverdevice
remove-vdiskserver
set-vconscon
remove-vconscon
set-vswitch
remove-vswitch
remove-vdpcs
Les événements de ressource suivants contiennent toujours uniquement la balise <Content> dans la section <data> OVF qui indique sur quel domaine l'événement est survenu :
add-vcpu
add-crypto
add-memory
add-io
add-variable
add-vconscon
add-vdisk
add-vdiskserver
add-vnet
add-vswitch
add-vdpcs
add-vdpcc
set-vcpu
set-crypto
set-memory
set-variable
set-vnet
set-vconsole
set-vdisk
remove-vcpu
remove-crypto
remove-memory
remove-io
remove-variable
remove-vdisk
remove-vnet
remove-vdpcc
Pour vous abonner aux événements de ressource, envoyez un message <LDM_interface> avec la balise <action> définie sur reg-resource-events. Le désabonnement à ces événements nécessite un message <LDM_interface> avec la balise <action> définie sur unreg-resource-events.
Vous pouvez également vous abonner pour écouter ces trois types d'événements sans vous abonner à chacun individuellement. Pour vous abonner à ces trois types d'événements en même temps, envoyez un message <LDM_interface> avec la balise <action> définie sur reg-all-events. Le désabonnement à ces événements nécessite un message <LDM_interface> avec la balise <action> définie sur unreg-all-events.