Mensajes de eventos

En lugar de esperar respuesta, puede suscribirse para recibir notificaciones de eventos de determinados cambios de estado que suceden. Hay tres tipos de eventos a los que puede suscribirse, individual o colectivamente. Consulte Tipos de eventos para conocer todos los detalles.

Registro y anulación de registro

Use un mensaje <LDM_interface> para registrarse para eventos. Consulte la etiqueta La etiqueta<LDM_interface>. La etiqueta de acción detalla el tipo de evento para el que desea registrarse o eliminar del registro y la sección <data> se deja vacía.

Ejemplo 17-3 Ejemplo de mensaje de solicitud de registro de evento

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

Los Logical Domains Manager responden con un mensaje de respuesta <LDM_interface> que indica si el registro o la eliminación de registro ha tenido un resultado satisfactorio.

Ejemplo 17-4 Ejemplo de mensaje de respuesta de registro de evento

<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 cadena de acción para cada tipo de evento se enumera en la subsección de eventos.

Los mensajes <LDM_event>

Los mensajes de evento tienen el mismo formato que un mensaje entrante <LDM_interface> con la excepción que la etiqueta de inicio para el mensaje es <LDM_event>. La etiqueta de acción del mensaje es la acción que ha sido realizada para accionar el evento. La sección de datos del mensaje describe el objeto asociado con el evento; los detalles dependen del tipo de evento que se ha producido.

Ejemplo 17-5 Ejemplo, notificación <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>

Tipos de eventos

A continuación se incluyen los tipos de eventos a los que se puede suscribir:

• Eventos de dominio

• Eventos de hardware

• Eventos de progreso

• Eventos de recursos

Todos los eventos corresponden a los subcomandos ldm.

Eventos de dominio

Los eventos de dominio describen qué acciones pueden ser realizadas directamente en un dominio. A continuación, se muestran los eventos del dominio que se pueden especificar en la etiqueta <action> del mensaje <LDM_event>:

• add-domain

• bind-domain

• domain-reset

• migrate-domain

• panic-domain

• remove-domain

• start-domain

• stop-domain

• unbind-domain

Estos eventos siempre contienen sólo una etiqueta <Content> en la sección de datos OVF que describe en qué dominio se ha producido el evento. Para registrar para los eventos del dominio, envíe un mensaje <LDM_interface> con la etiqueta <action> fijada en reg-domain-events. La eliminación del registro para estos eventos requiere un mensaje <LDM_interface> con la etiqueta de acción fijada en unreg-domain-events.

Eventos de hardware

Los eventos de hardware pertenecen al cambio del hardware del sistema físico. En el caso de software de Oracle VM Server for SPARC, los únicos cambios de hardware que pueden realizarse son los del procesador de servicio (SP) cuando un usuario agrega, elimina o fija la configuración de un SP. Actualmente, los únicos tres eventos para este tipo son:

• add-spconfig

• set-spconfig

• remove-spconfig

Los eventos de hardware contienen sólo una etiqueta <Section> en la sección de datos OVF que describe qué configuración SP a qué evento está sucediendo. Para registrarse para estos eventos, envíe un mensaje <LDM_interface> con la etiqueta <action> fijada en reg-hardware-events. La eliminación de un registro para estos eventos requiere un mensaje <LDM_interface> con la etiqueta <action> fijada en unreg-hardware-events.

Eventos de progreso

Los eventos de progreso se expiden para comandos de ejecución larga, como una migración de dominio. Estos eventos indican la cantidad de progreso que se ha realizado durante la vida del comando. En este momento, sólo se indica el evento migration-process.

Los eventos de progreso siempre contienen sólo una etiqueta <Section> en la sección de datos OVF que describe la configuración SP afectada por el evento. Para registrarse para estos eventos, envíe un mensaje <LDM_interface> con la etiqueta <action> fijada en reg-hardware-events. La eliminación de un registro para estos eventos requiere un mensaje <LDM_interface> con la etiqueta <action> fijada en unreg-hardware-events.

La sección <data> de un evento de progreso consiste en una sección <content> que describe el dominio afectado. Esta sección <content> usa una etiqueta ldom_info <Section> para actualizar el progreso. Las siguientes propiedades genéricas se muestran en la sección ldom_info:

• --progress – Porcentaje del progreso realizado por el comando

• --status – Estado del comando, que puede ser continuo, error o realizado

• --source – Equipo que está informando del progreso

Eventos de recursos

Los eventos de recursos se producen cuando los recursos se agregan, se eliminan, o cambian en cualquier dominio. La sección de datos para algunos de estos eventos contiene la etiqueta <Content> con una etiqueta <Section> que da el nombre del servicio en la sección de datos OVF.

A continuación, se muestran los eventos que se pueden especificar en la etiqueta <action> del mensaje <LDM_event>:

• add-vdiskserverdevice

• remove-vdiskserverdevice

• set-vdiskserverdevice

• remove-vdiskserver

• set-vconscon

• remove-vconscon

• set-vswitch

• remove-vswitch

• remove-vdpcs

Los siguientes eventos de recursos siempre contienen sólo la etiqueta <Content> en la sección de datos OVF que describe en qué dominio se ha producido el evento:

• 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

Para registrarse para los eventos de recursos, envíe un mensaje <LDM_interface> con la etiqueta <action> fijada en reg-resource-events. La eliminación de un registro para estos eventos requiere un mensaje <LDM_interface> con la etiqueta <action> fijada en unreg-resource-events.

Todos los eventos

También se puede registrar para los tres tipos de eventos sin tener que registrarse para cada uno individualmente. Para registrarse para los tres tipos de eventos simultáneamente, envíe un mensaje <LDM_interface> con la etiqueta <action> fijada en reg-all-events. La eliminación de un registro para estos eventos requiere un mensaje <LDM_interface> con la etiqueta <action> fijada en unreg-all-events.