Messages d’événements

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. Voir la section Types d'événements pour obtenir des détails complets.

Enregistrement et annulation de l'enregistrement

Utilisez un message <LDM_interface> pour enregistrer les événements. Voir Balise <LDM_interface>. Les détails de la balise d'action définissent le type d'événement pour lequel s'enregistrer ou annuler l'enregistrement et la section <data> est laissée vide.

Exemple 17-3 Exemple de message de demande d'enregistrement d'événement

<LDM_interface version="1.0">
  <cmd>
    <action>reg-domain-events</action>
    <data version="3.0"/>
  </cmd>
</LDM_interface>

Le gestionnaire de domaines logiques répond avec un message de réponse <LDM_interface> indiquant si l'enregistrement ou l'annulation de l'enregistrement a abouti.

Exemple 17-4 Exemple de message de réponse d'enregistrement d'événement

<LDM_interface version="1.0">
  <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.

Messages <LDM_event>

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 d'action du message est l'action qui a été effectuée pour déclencher l'événement. La section de données du message décrit l'objet associé à l'événement : les détails dépendent du type d'événement survenu.

Exemple 17-5 Exemple de notification <LDM_event>

<LDM_event version='1.0'>
  <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>

Types d'événements

Ci-dessous se trouvent les types d'événements auxquels vous pouvez vous abonner :

• Événements du domaine

• Événements matériels

• Événements de progression

• Événements de ressource

Tous les événements correspondent aux sous-commandes ldm.

Événements du domaine

Les événements du domaine décrivent quelles actions peuvent être effectuées directement sur un domaine. Le tableau suivant présente les événements de domaine qui peuvent être répertoriés dans la balise <action> du message <LDM_event>.

Ces événements contiennent toujours uniquement une balise <Content> dans la section des données OVF qui décrit sur quel domaine l'événement est survenu. Pour vous abonner aux événements de domaine, envoyez un message <LDM_interface> avec la balise <action> définie sur reg-domain-events. Le désabonnement à ces événements nécessite un message <LDM_interface> avec la balise d'action définie sur unreg-domain-events.

Événements matériels

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 de 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 des données 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. Le désabonnement à ces événements nécessite un message <LDM_interface> avec la balise <action> définie sur unreg-hardware-events.

Événements de progression

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 des données 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. Le désabonnement à ces événements nécessite 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 – État de la commande qui peut être ongoing, failed ou done

• --source – Machine qui signale la progression

Événements de ressource

Les événements de ressource surviennent lorsque les ressources sont ajoutées, supprimées ou modifiées dans un domaine. La section de données de certains de ces événements contient la balise <Content> avec une balise <Section> donnant un nom de service dans la section des données OVF. Le tableau suivant présente les événements qui peuvent être répertoriés dans la balise <action> du message <LDM_event>.

Les événements de ressource restants contiennent toujours uniquement une balise <Content> dans la section des données OVF qui décrit sur quel domaine l'événement est survenu.

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.

Tous les événements

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.