跳过导航链接
退出打印视图
| Oracle VM Server for SPARC 2.0 管理指南

搜索范围:

- 本文档
- 整个文档库

### 事件消息

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

#### 注册和注销

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

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

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

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

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

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

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

#### `<LDM_event>` 消息

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

示例 D-5 `<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>

#### 事件类型

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

- 域事件

- 硬件事件

- 进度事件

- 资源事件

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

##### 域事件

域事件描述可对域直接执行的操作。下表显示可在 `<LDM_event>` 消息中的 `<action>` 标记中列出的域事件。

域事件 | 域事件 | 域事件
--- | --- | ---
`add-domain` | `remove-domain` | `bind-domain`
`unbind-domain` | `start-domain` | `stop-domain`
`domain-reset` | `panic-domain` | `migrate-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>` 消息。

版权所有 © 2007, 2010, Oracle 和/或其附属公司。 保留所有权利。 法律声明 |