이벤트 메시지

폴링 대신 특정 상태가 변경될 경우 이벤트 알림을 수신하도록 가입할 수 있습니다. 개별적으로 또는 일괄적으로 가입할 수 있는 이벤트 유형에는 세 가지가 있습니다. 자세한 내용은 이벤트 유형을 참조하십시오.

등록 및 등록 해제

<LDM_interface> 메시지를 사용하여 이벤트에 대해 등록할 수 있습니다. <LDM_interface> 태그를 참조하십시오. action 태그는 등록 또는 등록 해제할 이벤트의 유형을 자세히 설명하며 <data> 섹션은 비어 있습니다.

예 17-3 이벤트 등록 요청 메시지 예

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

Logical Domains Manager는 등록 또는 등록 해제가 성공적인지 여부를 나타내는 <LDM_interface> 응답 메시지로 응답합니다.

예 17-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 태그는 이벤트 트리거를 위해 수행된 작업입니다. 메시지의 데이터 섹션은 이벤트와 연관된 객체에 대해 설명하는데, 세부 사항은 발생한 이벤트의 유형에 따라 다릅니다.

예 17-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> 메시지를 전송하십시오. 이 이벤트에 대한 등록을 해제하려면 action 태그가 unreg-domain-events로 설정된 <LDM_interface> 메시지가 필요합니다.

하드웨어 이벤트

하드웨어 이벤트는 물리적 시스템 하드웨어 변경과 관련됩니다. Oracle VM Server for SPARC 소프트웨어의 경우, 사용자가 SP(서비스 프로세서) 구성을 변경할 때 SP에 대해 수행되는 변경이 유일하게 가능한 하드웨어 변경입니다. 현재 이 유형의 이벤트는 세 가지입니다.

• add-spconfig

• set-spconfig

• remove-spconfig

하드웨어 이벤트는 항상 OVF 데이터 섹션에 이벤트가 발생한 SP 구성을 설명하는 <Section> 태그만 포함합니다. 이 이벤트에 대해 등록하려면 <action> 태그를 reg-hardware-events로 설정하여 <LDM_interface> 메시지를 전송하십시오. 이 이벤트에 대한 등록을 해제하려면 <action> 태그가 unreg-hardware-events로 설정된 <LDM_interface> 메시지가 필요합니다.

진행률 이벤트

진행률 이벤트는 도메인 마이그레이션과 같이 장기 실행 중인 명령에 대해 발행됩니다. 이 이벤트는 명령 수명 기간 동안 진행된 정도를 보고합니다. 이때 migration-process 이벤트만 보고됩니다.

진행률 이벤트는 항상 OVF 데이터 섹션에 이벤트의 영향을 받는 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 – 진행률을 보고하는 시스템입니다.

리소스 이벤트

리소스 이벤트는 도메인에서 리소스가 추가, 제거 또는 변경될 경우에 발생합니다. 이 이벤트 중 일부에 대한 데이터 섹션에는 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> 메시지가 필요합니다.