事件消息

您可以订阅以接收发生的某些状态更改的事件通知，而不使用轮询。有三种可单独或集体订阅的事件类型。有关完整的详细信息，请参见事件类型。

注册和注销

使用 <LDM_interface> 消息可注册事件。请参见 <LDM_interface> 标记。操作标记详述了要注册或注销的事件的类型，<data> 段保留为空。

示例 18-3 事件注册请求消息示例

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

Logical Domains Manager 通过表示注册或注销是否成功的 <LDM_interface> 响应消息进行响应。

示例 18-4 事件注册响应消息示例

<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>

在事件子段中会列出每个类型的事件的操作字符串。

<LDM_event> 消息

事件消息除其开始标记是 <LDM_event> 之外，其格式与传入 <LDM_interface> 消息相同。消息的操作标记是为触发事件而执行的操作。消息的数据段描述与事件关联的对象，其详细信息取决于发生的事件的类型。

示例 18-5 <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>

事件类型

下面是可订阅的事件类型：

• 域事件

• 硬件事件

• 进度事件

• 资源事件

所有事件都与 ldm 子命令相对应。

域事件

域事件描述可对域直接执行的操作。下面列出了可在 <LDM_event> 消息中的 <action> 标记中指定的域事件：

• add-domain

• bind-domain

• domain-reset

• migrate-domain

• panic-domain

• remove-domain

• start-domain

• stop-domain

• unbind-domain

这些事件在 OVF 数据段中始终仅包含一个 <Content> 标记，用于描述发生事件的域。要注册域事件，需要发送 <action> 标记设置为 reg-domain-events 的 <LDM_interface> 消息。要注销这些事件，需要使用操作标记设置为 unreg-domain-events 的 <LDM_interface> 消息。

硬件事件

硬件事件与更改物理系统硬件相关。对于 Oracle VM Server for SPARC 软件，唯一可执行的硬件更改是用户添加、删除或设置服务处理器 (service processor, SP) 配置时对其进行的更改。当前，适用于此情况的仅有三种事件：

• add-spconfig

• set-spconfig

• remove-spconfig

硬件事件在 OVF 数据段中始终仅包含一个 <Section> 标记，用于描述发生此事件的 SP 配置。要注册这些事件，需要发送 <action> 标记设置为 reg-hardware-events 的 <LDM_interface> 消息。要注销这些事件，需要使用 <action> 标记设置为 unreg-hardware-events 的 <LDM_interface> 消息。

进度事件

进度事件是针对长时间运行的命令（例如，域迁移）发布的。这些事件可报告在运行命令期间完成的进展程度。目前，仅报告 migration-process 事件。

进度事件在 OVF 数据段中始终仅包含一个 <Section> 标记，用于描述受此事件影响的 SP 配置。要注册这些事件，需要发送 <action> 标记设置为 reg-hardware-events 的 <LDM_interface> 消息。要注销这些事件，需要使用 <action> 标记设置为 unreg-hardware-events 的 <LDM_interface> 消息。

进度事件的 <data> 段包含一个 <content> 段，用于描述受影响的域。此 <content> 段使用 ldom_info <Section> 标记来更新进度。下列常规属性显示于 ldom_info 段中：

• --progress－命令执行的进度百分比

• --status－命令状态，可以是 ongoing、failed 或 done 中的一种。

• --source－报告进度的计算机

资源事件

在任意域中添加、删除或更改资源时，会发生资源事件。其中一些事件的数据段在 OVF 数据段中包含带有 <Section> 标记（可提供服务名称）的 <Content> 标记。

下面列出了可在 <LDM_event> 消息中的 <action> 标记中指定的事件。

• add-vdiskserverdevice

• remove-vdiskserverdevice

• set-vdiskserverdevice

• remove-vdiskserver

• set-vconscon

• remove-vconscon

• set-vswitch

• remove-vswitch

• remove-vdpcs

以下资源事件在 OVF 数据段中始终仅包含 <Content> 标记，用于描述发生事件的域。

• 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

要注册资源事件，需要发送 <action> 标记设置为 reg-resource-events 的 <LDM_interface> 消息。要注销这些事件，需要使用 <action> 标记设置为 unreg-resource-events 的 <LDM_interface> 消息。

所有事件

您还可以注册以侦听所有三种类型的事件，而无需单独注册每个事件。要同时注册所有三种类型的事件，需要发送 <action> 标记设置为 reg-all-events 的 <LDM_interface> 消息。要注销这些事件，需要使用 <action> 标记设置为 unreg-all-events 的 <LDM_interface> 消息。