6.108. 호스트

예를 들어 가상 시스템을 실행하도록 호스트를 활성화합니다.

가상화 환경에서 사용할 사전 설치된 Hypervisor 호스트를 승인합니다.

이 작업은 선택적 클러스터 요소도 허용하여 이 호스트의 대상 클러스터를 정의합니다.

네트워크 구성을 적절하게 표시하고 호스트 내부에 유지합니다.

API 사용자는 네트워크 구성을 커밋하여 호스트 네트워크 인터페이스 연결 또는 분리를 지속하거나 결합된 인터페이스의 생성 및 삭제를 지속합니다.

예를 들어 ID 123 을 사용하여 host의 네트워크 구성을 커밋하려면 다음과 같은 요청을 보냅니다.

POST /ovirt-engine/api/hosts/123/commitnetconfig

다음과 같이 요청 본문이 있는 경우:

<action/>

지정된 호스트의 네트워크 구성을 현재 호스트에 복사합니다.

다른 호스트에서 네트워크를 복사하려면 다음과 같은 요청을 보냅니다.

POST /ovirt-engine/api/hosts/123/copyhostnetworks

다음과 같이 요청 본문이 있는 경우:

<action>
   <source_host id="456"/>
</action>

유지 관리 작업을 수행하기 위해 호스트를 비활성화합니다.

이니시에이터 세부 정보를 사용하여 호스트에서 iSCSI 대상을 검색합니다. 검색된 데이터가 포함된 IscsiDetails 오브젝트 목록을 반환합니다.

예를 들어 호스트 123 에서 myiscsi.example.com 에서 사용 가능한 iSCSI 대상을 검색하려면 다음과 같은 요청을 보냅니다.

POST /ovirt-engine/api/hosts/123/discoveriscsi

다음과 같이 요청 본문이 있는 경우:

<action>
  <iscsi>
    <address>myiscsi.example.com</address>
  </iscsi>
</action>

결과는 다음과 같습니다.

<discovered_targets>
  <iscsi_details>
    <address>10.35.1.72</address>
    <port>3260</port>
    <portal>10.35.1.72:3260,1</portal>
    <target>iqn.2015-08.com.tgt:444</target>
  </iscsi_details>
</discovered_targets>

호스트의 인증서를 등록합니다. 만료되거나 이미 만료되었다는 경고가 발생하는 경우 유용합니다.

호스트의 전원 관리 장치를 제어합니다.

예를 들어 호스트를 시작하려면 다음을 수행합니다. 이 작업은 다음을 통해 수행할 수 있습니다.

#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Version: 4" \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<action>
  <fence_type>start</fence_type>
</action>
' \
"${url}/hosts/123/fence"

호스트를 수동으로 스토리지 풀 관리자(SPM)로 설정하려면.

POST /ovirt-engine/api/hosts/123/forceselectspm

다음과 같이 요청 본문이 있는 경우:

<action/>

호스트 세부 정보를 가져옵니다.

GET /ovirt-engine/api/hosts/123

GET /ovirt-engine/api/hosts/123?all_content=true

호스트에 VDSM의 최신 버전 및 관련 소프트웨어를 설치합니다.

또한 이 작업은 호스트에 호스트를 추가하는 동안 수행되는 호스트의 모든 설정 단계(예: kdump 구성, 호스팅 엔진 배포, 커널 옵션 변경 등)를 수행합니다.

호스트 유형은 작업에 대한 추가 매개 변수를 정의합니다.

curl 및 JSON을 사용하여 호스트 설치 예:

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--request PUT \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Version: 4" \
--user "admin@internal:..." \
--data '
{
  "root_password": "myrootpassword"
}
' \
"https://engine.example.com/ovirt-engine/api/hosts/123"

curl 및 호스팅 엔진 구성 요소가 있는 JSON을 사용하여 호스트 설치 예:

curl \
curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--request PUT \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Version: 4" \
--user "admin@internal:..." \
--data '
{
  "root_password": "myrootpassword"
"deploy_hosted_engine" : "true"
}
' \
"https://engine.example.com/ovirt-engine/api/hosts/123"

이 방법은 엔진 버전 4.4.6부터 사용되지 않습니다. 대신 DiscoverIscsi를 사용해야 합니다.

이니시에이터 세부 정보를 사용하여 호스트에서 iSCSI 대상을 검색합니다. 검색된 데이터가 포함된 문자열 배열을 반환합니다.

예를 들어 호스트 123 에서 myiscsi.example.com 에서 사용 가능한 iSCSI 대상을 검색하려면 다음과 같은 요청을 보냅니다.

POST /ovirt-engine/api/hosts/123/iscsidiscover

다음과 같이 요청 본문이 있는 경우:

<action>
  <iscsi>
    <address>myiscsi.example.com</address>
  </iscsi>
</action>

대상 세부 정보를 사용하여 호스트의 iSCSI 대상에 로그인합니다.

호스트 장치 및 기능을 새로 고칩니다.

시스템에서 호스트를 제거합니다.

#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request DELETE \
--header "Version: 4" \
"${url}/hosts/1ff7a191-2f3b-4eff-812b-9f91a30c3acc"

이 방법은 호스트의 네트워크 인터페이스 구성을 변경하는 데 사용됩니다.

예를 들어 네트워크 인터페이스 eth0,eth1 및 eth2 가 있는 호스트가 있고 eth0 및 eth1 을 사용하여 새 본딩을 구성하고 해당 호스트 위에 VLAN을 배치하려는 경우 다음을 수행합니다. 다음과 같이 수행할 수 있는 간단한 쉘 스크립트 및 curl 명령행 HTTP 클라이언트를 사용합니다.

#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Version: 4" \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<action>
  <modified_bonds>
    <host_nic>
      <name>bond0</name>
      <bonding>
        <options>
          <option>
            <name>mode</name>
            <value>4</value>
          </option>
          <option>
            <name>miimon</name>
            <value>100</value>
          </option>
        </options>
        <slaves>
          <host_nic>
            <name>eth1</name>
          </host_nic>
          <host_nic>
            <name>eth2</name>
          </host_nic>
        </slaves>
      </bonding>
    </host_nic>
  </modified_bonds>
  <modified_network_attachments>
    <network_attachment>
      <network>
        <name>myvlan</name>
      </network>
      <host_nic>
        <name>bond0</name>
      </host_nic>
      <ip_address_assignments>
        <ip_address_assignment>
          <assignment_method>static</assignment_method>
          <ip>
            <address>192.168.122.10</address>
            <netmask>255.255.255.0</netmask>
          </ip>
        </ip_address_assignment>
      </ip_address_assignments>
      <dns_resolver_configuration>
        <name_servers>
          <name_server>1.1.1.1</name_server>
          <name_server>2.2.2.2</name_server>
        </name_servers>
      </dns_resolver_configuration>
    </network_attachment>
  </modified_network_attachments>
 </action>
' \
"${url}/hosts/1ff7a191-2f3b-4eff-812b-9f91a30c3acc/setupnetworks"

<options name="mode" value="4"/>
<options name="miimon" value="100"/>
<ip address="192.168.122.10" netmask="255.255.255.0"/>

다음 코드와 함께 Python SDK를 사용하여 동일한 작업을 수행할 수 있습니다.

# Find the service that manages the collection of hosts:
hosts_service = connection.system_service().hosts_service()

# Find the host:
host = hosts_service.list(search='name=myhost')[0]

# Find the service that manages the host:
host_service = hosts_service.host_service(host.id)

# Configure the network adding a bond with two slaves and attaching it to a
# network with an static IP address:
host_service.setup_networks(
    modified_bonds=[
        types.HostNic(
            name='bond0',
            bonding=types.Bonding(
                options=[
                    types.Option(
                        name='mode',
                        value='4',
                    ),
                    types.Option(
                        name='miimon',
                        value='100',
                    ),
                ],
                slaves=[
                    types.HostNic(
                        name='eth1',
                    ),
                    types.HostNic(
                        name='eth2',
                    ),
                ],
            ),
        ),
    ],
    modified_network_attachments=[
        types.NetworkAttachment(
            network=types.Network(
                name='myvlan',
            ),
            host_nic=types.HostNic(
                name='bond0',
            ),
            ip_address_assignments=[
                types.IpAddressAssignment(
                    assignment_method=types.BootProtocol.STATIC,
                    ip=types.Ip(
                        address='192.168.122.10',
                        netmask='255.255.255.0',
                    ),
                ),
            ],
            dns_resolver_configuration=types.DnsResolverConfiguration(
                name_servers=[
                    '1.1.1.1',
                    '2.2.2.2',
                ],
            ),
        ),
    ],
)

# After modifying the network configuration it is very important to make it
# persistent:
host_service.commit_net_config()

호스트의 모든 네트워크를 동기화하려면 다음과 같은 요청을 보냅니다.

POST /ovirt-engine/api/hosts/123/syncallnetworks

다음과 같이 요청 본문이 있는 경우:

<action/>

설정으로 가져올 후보인 블록 스토리지 도메인을 검색합니다. FCP의 경우 인수가 필요하지 않습니다.

호스트 속성을 업데이트합니다.

예를 들어 호스트의 커널 명령줄을 업데이트하려면 다음과 같은 요청을 보냅니다.

PUT /ovirt-engine/api/hosts/123

다음과 같이 요청 본문이 있는 경우:

<host>
  <os>
    <custom_kernel_cmdline>vfio_iommu_type1.allow_unsafe_interrupts=1</custom_kernel_cmdline>
  </os>
</host>

호스트에서 VDSM 및 선택한 소프트웨어를 업그레이드합니다.

호스트에서 사용 가능한 업그레이드가 있는지 확인합니다. 사용 가능한 업그레이드가 있는 경우 관리 포털에서 호스트 상태 아이콘 옆에 아이콘이 표시됩니다. 감사 로그 메시지가 추가되어 업그레이드 가용성을 나타냅니다. 업그레이드는 webadmin 또는 업그레이드 호스트 작업을 사용하여 시작할 수 있습니다.