Oracle® VM Server for SPARC 3.2 Administration Guide

Exit Print View

Updated: May 2015
 
 

Event Types

    You can subscribe to the following event types:

  • Domain events

  • Hardware events

  • Progress events

  • Resource events

All the events correspond to ldm subcommands.

Domain Events

    Domain events describe which actions can be performed directly to a domain. The following domain events can be specified in the <action> tag in the <LDM_event> message:

  • add-domain

  • bind-domain

  • domain-reset

  • migrate-domain

  • panic-domain

  • remove-domain

  • start-domain

  • stop-domain

  • unbind-domain

These events always contain only a <Content> tag in the OVF <data> section that describes the domain to which the event happened. To register for the domain events, send an <LDM_interface> message with the <action> tag set to reg-domain-events. To unregister for these events, send an <LDM_interface> message with the <action> tag set to unreg-domain-events.

Hardware Events

    Hardware events pertain to changing the physical system hardware. In the case of Oracle VM Server for SPARC software, the only hardware changes are those to the service processor (SP) when you add, remove, or set an SP configuration. Currently, the only three events of this type are:

  • add-spconfig

  • set-spconfig

  • remove-spconfig

The hardware events always contain only a <Section> tag in the OVF <data> section which describes which SP configuration to which the event is happening. To register for these events, send an <LDM_interface> message with the <action> tag set to reg-hardware-events. To unregister for these events, send an <LDM_interface> message with the <action> tag set to unreg-hardware-events.

Progress Events

Progress events are issued for long-running commands, such as a domain migration. These events report the amount of progress that has been made during the life of the command. At this time, only the migration-process event is reported.

Progress events always contain only a <Section> tag in the OVF <data> section that describes the SP configuration affected by the event. To register for these events, send an <LDM_interface> message with the <action> tag set to reg-hardware-events. To unregister for these events, send an <LDM_interface> message with the <action> tag set to unreg-hardware-events.

    The <data> section of a progress event consists of a <content> section that describes the affected domain. This <content> section uses an ldom_info <Section> tag to update progress. The following generic properties are shown in the ldom_info section:

  • --progress Percentage of the progress made by the command

  • --status Command status, which can be one of ongoing, failed, or done

  • --source Machine that is reporting the progress

Resource Events

Resource events occur when resources are added, removed, or changed in any domain. The <data> section for some of these events contains the <Content> tag with a <Section> tag providing a service name in the OVF <data> section.

    The following events can be specified in the <action> tag in the <LDM_event> message:

  • add-vdiskserverdevice

  • remove-vdiskserverdevice

  • set-vdiskserverdevice

  • remove-vdiskserver

  • set-vconscon

  • remove-vconscon

  • set-vswitch

  • remove-vswitch

  • remove-vdpcs

    The following resource events always contain only the <Content> tag in the OVF <data> section that describes the domain to which the event happened:

  • 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

To register for the resource events, send an <LDM_interface> message with the <action> tag set to reg-resource-events. Unregistering for these events requires an <LDM_interface> message with the <action> tag set to unreg-resource-events.

All Events

You can also register to listen for all three type of events without having to register for each one individually. To register for all three types of events simultaneously, send an <LDM_interface> message with the <action> tag set to reg-all-events. Unregistering for these events require an <LDM_interface> message with the <action> tag set to unreg-all-events.