イベントメッセージ

ポーリングの代わりに、特定の状態変化が発生した場合にイベント通知を受信するように登録できます。個々に、または一括して登録できるイベントのタイプは 3 つあります。詳細は、イベントタイプ を参照してください。

登録および登録解除

イベントを登録するには、<LDM_interface> メッセージを使用します。<LDM_interface> タグを参照してください。<action> タグには登録または登録解除するイベントのタイプを記述し、<data> セクションは空白のままにしておきます。

使用例 23-3  イベントの登録要求メッセージの例

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

Logical Domains Manager は、登録または登録解除が成功したかどうかを示す <LDM_interface> 応答メッセージで応答します。

使用例 23-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_interface> メッセージと同じですが、このメッセージの開始タグは <LDM_event> になる点が異なります。メッセージの <action> タグは、イベントをトリガーするために実行されたアクションです。メッセージの <data> セクションにはイベントに関連付けられたオブジェクトが記述されます。詳細は、発生したイベントのタイプによって異なります。

使用例 23-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 <data> セクションに、イベントが発生したドメインを記述する <Content> タグのみが含まれます。ドメインイベントを登録するには、<action> タグを reg-domain-events に設定した <LDM_interface> メッセージを送信します。これらのイベントを登録解除するには、<action> タグを unreg-domain-events に設定した <LDM_interface> メッセージを送信します。

ハードウェアイベント

ハードウェアイベントは、物理的なシステムハードウェアの変更に関係しています。Oracle VM Server for SPARC ソフトウェアの場合、ハードウェア変更は、サービスプロセッサ (SP) 構成の追加、削除、または設定を行う場合の SP への変更だけです。現在、このタイプのイベントは次の 3 つだけです。

• add-spconfig

• set-spconfig

• remove-spconfig

ハードウェアイベントでは、常に、OVF <data> セクションにイベントが発生している SP 構成を記述する <Section> タグのみが含まれます。これらのイベントを登録するには、<action> タグを reg-hardware-events に設定した <LDM_interface> メッセージを送信します。これらのイベントを登録解除するには、<action> タグを unreg-hardware-events に設定した <LDM_interface> メッセージを送信します。

進捗イベント

進捗イベントは、ドメインの移行など、長時間にわたって実行されるコマンドに対して発行されます。このイベントは、コマンド実行期間中のそれまでの進捗量を報告します。この時点では、migration-process イベントのみが報告されます。

進捗イベントでは、常に、OVF <data> セクションにイベントの影響を受ける SP 構成が記述された <Section> タグのみが含まれます。これらのイベントを登録するには、<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 – 進捗を報告しているマシン

リソースイベント

任意のドメインでリソースを追加、削除、または変更すると、リソースイベントが発生します。これらの一部のイベントの<data> セクションには、OVF <data> セクションにサービス名が示されている <Section> タグがある、<Content> タグが含まれています。

次のイベントを、<LDM_event> メッセージの <action> タグに指定することができます。

• add-vdiskserverdevice

• remove-vdiskserverdevice

• set-vdiskserverdevice

• remove-vdiskserver

• set-vconscon

• remove-vconscon

• set-vswitch

• remove-vswitch

• remove-vdpcs

次のリソースイベントでは、常に、OVF <data> セクションに、イベントの発生したドメインが記述された <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> メッセージが必要です。

すべてのイベント

各イベントを個別に登録しないで、3 つのタイプすべてのイベントを待機するように登録することもできます。3 タイプすべてのイベントを同時に登録するには、<action> タグを reg-all-events に設定した <LDM_interface> メッセージを送信します。これらのイベントの登録を解除するには、<action> タグを unreg-all-events に設定した <LDM_interface> メッセージが必要です。