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.
Use un mensaje <LDM_interface> para registrarse para eventos. Consulte Etiqueta <LDM_interface>. La etiqueta <action> detalla el tipo de evento para el que desea registrarse o eliminar el registro y la sección <data se deja vacía.
Ejemplo 23-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>
El Logical Domains Manager responde con un mensaje de respuesta <LDM_interface> que indica si el registro o la eliminación de registro ha tenido un resultado satisfactorio.
Ejemplo 23-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 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 <action> del mensaje es la acción que se ha realizado para accionar el evento. La sección <data> del mensaje describe el objeto asociado con el evento; los detalles dependen del tipo de evento que se ha producido.
Ejemplo 23-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>
Puede suscribirse a los siguientes tipos de evento:
Eventos de dominio
Eventos de hardware
Eventos de progreso
Eventos de recursos
Todos los eventos corresponden a los subcomandos ldm.
Los eventos de dominio describen las acciones que pueden realizarse directamente en un dominio. A continuación, se muestran los eventos de 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 solo una etiqueta <Content> en la sección <data> de OVF que describe el dominio en el que se ha producido el evento. Para registrar para los eventos del dominio, envíe un mensaje <LDM_interface con la etiqueta <action configurada como reg-domain-events. Para eliminar el registro para estos eventos, envíe un mensaje <LDM_interface con la etiqueta <action configurada como unreg-domain-events.
Los eventos de hardware pertenecen al cambio del hardware del sistema físico. En el caso del software Oracle VM Server for SPARC, los únicos cambios de hardware que pueden realizarse son los del procesador de servicio (SP) cuando se agrega, se elimina o se establece 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 solo una etiqueta <Section en la sección <data> de OVF que describe qué configuración del SP para qué evento se está produciendo. Para registrarse para estos eventos, envíe un mensaje <LDM_interface con la etiqueta <action configurada como reg-hardware-events. Para eliminar el registro para estos eventos, envíe un mensaje <LDM_interface con la etiqueta <action configurada como unreg-hardware-events.
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, solo se indica el evento migration-process.
Los eventos de progreso siempre contienen solo una etiqueta <Section en la sección <data> de OVF que describe la configuración del SP que se ve afectada por el evento. Para registrarse para estos eventos, envíe un mensaje <LDM_interface> con la etiqueta <action> fijada en reg-hardware-events. Para eliminar el registro para estos eventos, envíe un mensaje <LDM_interface con la etiqueta <action configurada como 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
Los eventos de recursos se producen cuando los recursos se agregan, se eliminan, o cambian en cualquier dominio. La sección <data> para algunos de estos eventos contiene la etiqueta <Content con una etiqueta <Section que proporciona un nombre de servicio en la sección <data> de 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 solo la etiqueta <Content en la sección <data> de OVF que describe el dominio en el que 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 configurada como reg-resource-events. La eliminación de un registro para estos eventos requiere un mensaje <LDM_interface con la etiqueta <action configurada como unreg-resource-events.
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 configurada como reg-all-events. La eliminación de un registro para estos eventos requiere un mensaje <LDM_interface con la etiqueta <action configurada como unreg-all-events.