명령줄 인터페이스

xe CLI를 사용하면 시스템 관리 작업을 스크립팅하고 자동화할 수 있습니다. CLI를 사용하여 Citrix Hypervisor를 기존 IT 인프라에 통합합니다.

xe CLI로 시작하기

xe 명령줄 인터페이스는 기본적으로 모든 Citrix Hypervisor 서버에 설치됩니다. 원격 Windows 버전은 XenCenter에 포함되어 있습니다. 독립 실행형 원격 CLI도 Linux에서 사용할 수 있습니다.

Citrix Hypervisor 서버

xe 명령줄 인터페이스는 기본적으로 서버에 설치됩니다. dom0 콘솔에서 xe CLI 명령을 실행할 수 있습니다. 다음 방법 중 하나로 dom0 콘솔에 액세스합니다.

• XenCenter에서 명령을 실행하려는 서버의 콘솔 탭으로 이동합니다.
• 명령을 실행하려는 서버에 SSH로 연결합니다.

Windows에서

Windows에서는 xe.exe 명령이 XenCenter 센터와 함께 설치됩니다.

xe.exe 명령을 사용하려면 Windows 명령 프롬프트를 열고 디렉터리를 xe.exe 파일이 있는 디렉터리(일반적으로 C:\Program Files (x86)\Citrix\XenCenter)로 변경합니다. 시스템 경로에 xe.exe 설치 위치를 추가하면 디렉토리를 변경하지 않고도 명령을 사용할 수 있습니다.

Linux에서

RPM 기반 배포(예: Red Hat)에서는 기본 Citrix Hypervisor 설치 ISO에 client_install/xapi-xe-BUILD.x86_64.rpm 이름이 지정된 RPM에서 독립 실행형 xe 명령을 설치할 수 있습니다.

RPM에서 설치하려면 다음 명령을 사용합니다.

rpm -ivh xapi-xe-BUILD.x86_64.rpm
<!--NeedCopy-->

명령줄에서 매개 변수를 사용하여 xe 명령을 실행할 때 사용할 Citrix Hypervisor 서버, 사용자 이름 및 암호를 정의할 수 있습니다. 그러나 이 정보를 환경 변수로 설정하는 옵션도 있습니다. 예:

export XE_EXTRA_ARGS="server=<host name>,username=<user name>,password=<password>"
<!--NeedCopy-->

참고:

보안 연결을 통해 명령을 실행하려고 하면 Linux의 원격 xe CLI가 중지될 수 있으며 이러한 명령에는 파일 전송이 포함됩니다. 이 경우 --no-ssl 매개 변수를 사용하여 Citrix Hypervisor 서버에 대한 안전하지 않은 연결을 통해 명령을 실행할 수 있습니다.

xe 명령에 대한 지원 받기

온 호스트로 다음을 입력하여 CLI 명령에 대한 기본 도움말을 볼 수 있습니다.

xe help command
<!--NeedCopy-->

다음을 입력하면 가장 일반적으로 사용되는 xe 명령 목록이 표시됩니다.

xe help
<!--NeedCopy-->

또는 다음을 입력하면 모든 xe 명령 목록이 표시됩니다.

xe help --all
<!--NeedCopy-->

기본 xe 구문

모든 Citrix Hypervisor xe CLI 명령의 기본 구문은 다음과 같습니다.

xe command-name argument=value argument=value
<!--NeedCopy-->

각 특정 명령에는 해당 형식 argument=value의 고유한 인수 집합이 포함되어 있습니다. 일부 명령에는 필수 인수가 있으며 대부분의 명령에 선택적 인수 집합이 있습니다. 일반적으로 명령은 선택적 인수 없이 호출될 때 일부 선택적 인수에 대한 기본값을 가정합니다.

xe 명령이 원격으로 실행되는 경우 연결 및 인증에 추가 인수가 사용됩니다. 이 주장은 또한 argument=argument_value 형식을 취합니다.

server 인수는 호스트 이름 또는 IP 주소를 지정하는 데 사용됩니다. username 및 password 인수는 자격 증명을 지정하는 데 사용됩니다.

암호 대신 password-file 인수를 직접 지정할 수 있습니다. 이 경우 xe 명령은 지정된 파일에서 암호를 읽으려고 시도하고 해당 암호를 사용하여 연결합니다. (파일 끝에 있는 모든 후행 CR과 LF는 제거됩니다.) 이 방법은 명령줄에서 직접 암호를 지정하는 것보다 안전합니다.

선택적 port 인수를 사용하여 원격 Citrix Hypervisor 서버의 에이전트 포트를 지정할 수 있습니다(기본값 443).

예: 로컬 Citrix Hypervisor 서버에서 다음을 수행합니다.

xe vm-list
<!--NeedCopy-->

예: 원격 Citrix Hypervisor 서버에서 다음을 수행합니다.

xe vm-list username=username password=password server=hostname
<!--NeedCopy-->

원격 연결 인수에는 단축형 구문도 사용할 수 있습니다.

• -u 사용자 이름
• -pw 암호
• -pwf 암호 파일
• -p 포트
• -s 서버

예: 원격 Citrix Hypervisor 서버에서 다음을 수행합니다.

xe vm-list -u myuser -pw mypassword -s hostname
<!--NeedCopy-->

인수는 쉼표로 구분된 키/값 쌍의 형태로 환경 변수 XE_EXTRA_ARGS에서도 가져옵니다. 예를 들어 원격 Citrix Hypervisor 서버에서 실행할 명령을 입력하려면 먼저 다음 명령을 실행합니다.

export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"
<!--NeedCopy-->

이 명령을 실행한 후에는 실행하는 각 xe 명령에서 원격 Citrix Hypervisor 서버 매개 변수를 더 이상 지정할 필요가 없습니다.

XE_EXTRA_ARGS 환경 변수를 사용하면 원격 Citrix Hypervisor 서버에 대해 실행될 때 xe 명령의 탭 완성을 활성화할 수도 있습니다. 이 서버는 기본적으로 비활성화되어 있습니다.

특수 문자 및 구문

xe 명령줄에서 인수/값 쌍을 지정하려면 다음과 같이 작성합니다. argument=value

값에 공백이 포함되어 있지 않으면 따옴표를 사용하지 않습니다. 인수 이름, 등호(=) 및 값 사이에 공백을 포함하지 마십시오. 이 형식을 따르지 않는 인수는 무시됩니다.

공백이 포함된 값의 경우 다음과 같이 작성합니다. argument="value with spaces"

Citrix Hypervisor 서버에서 CLI를 사용하는 경우 명령에 표준 Linux bash 셸의 기능과 유사한 탭 완성 기능이 제공됩니다. 예를 들어 xe vm-l을(를) 입력한 다음 TAB 키를 누르면 나머지 명령이 표시됩니다. 두 개 이상의 명령이 vm-l(으)로 시작되는 경우 TAB 키를 두 번째로 누르면 가능한 명령이 나열됩니다. 이 기능은 명령에서 오브젝트 UUID를 지정할 때 유용합니다.

참고:

보통 원격 Citrix Hypervisor 서버에서 명령을 실행할 때는 탭 완성이 작동하지 않습니다. 그러나 명령을 입력하는 시스템에서 XE_EXTRA_ARGS 변수를 설정하면 탭 완성이 활성화됩니다. 자세한 내용은 기본 xe 구문을 참조하십시오.

명령 유형

CLI 명령은 두 부분으로 나눌 수 있습니다. 하위 수준 명령은 API 객체의 나열 및 매개 변수 조작과 관련이 있습니다. 상위 수준 명령은 보다 추상적인 수준에서 VM 또는 호스트와 상호 작용하는 데 사용됩니다.

하위 수준 명령은 다음과 같습니다.

• class-list

• class-param-get

• class-param-set

• class-param-list

• class-param-add

• class-param-remove

• class-param-clear

여기에서 class는 다음 중 하나입니다.

• bond

• console

• host

• host-crashdump

• host-cpu

• network

• patch

• pbd

• pif

• pool

• sm

• sr

• task

• template

• vbd

• vdi

• vif

• vlan

• vm

class의 모든 값에 전체 class-param-action 명령 집합이 있는 것은 아닙니다. class의 일부 값에는 더 작은 명령 집합이 있습니다.

매개 변수 유형

xe 명령으로 지정되는 개체는 개체 자신을 식별하고 해당 상태를 정의하는 매개 변수 집합을 가집니다.

대부분의 매개 변수에는 하나의 값이 사용됩니다. 예를 들어 VM의 name-label 매개 변수에는 단일 문자열 값이 포함되어 있습니다. xe vm-param-list 같은 매개 변수 목록 명령의 출력에서 괄호 안의 값은 매개 변수가 RW(읽기-쓰기)인지 또는 읽기 전용(RO)인지를 나타냅니다. 지정된 VM에서 xe vm-param-list의 출력에는 다음 행이 포함될 수 있습니다.

user-version ( RW): 1
 is-control-domain ( RO): false

첫 번째 매개 변수(user-version)는 쓰기 가능하며 값은 1입니다. 두 번째(is-control-domain)는 읽기 전용이며 값은 false입니다.

다른 두 가지 매개 변수 유형은 다중 값 유형입니다. set 매개 변수에는 값 목록이 포함됩니다. map 매개 변수는 키/값 쌍의 집합입니다. 예를 들어, 지정된 VM에서 xe vm-param-list의 다음 샘플 출력을 살펴보십시오.

platform (MRW): acpi: true; apic: true; pae: true; nx: false
allowed-operations (SRO): pause; clean_shutdown; clean_reboot; \
hard_shutdown; hard_reboot; suspend

platform 매개 변수에는 키/값 쌍을 나타내는 항목 목록이 있습니다. 키 이름 뒤에는 콜론 문자(:)가 나옵니다. 각 키/값 쌍은 세미콜론 문자(;)로 구분됩니다. RW 앞에 있는 M은 이 매개 변수가 map 매개 변수이며 읽기 및 쓰기 가능함을 나타냅니다. allowed-operations 매개 변수에는 항목 집합을 구성하는 목록이 있습니다. RO 앞의 S는 이것이 집합 매개 변수이며 읽기는 가능하지만 쓰기는 불가능함을 나타냅니다.

map 매개 변수를 필터링하거나 map 매개 변수를 설정하려면 콜론(:)을 사용하여 map 매개 변수 이름과 키/값 쌍을 구분합니다. 예를 들어 VM other-config 매개 변수의 foo 키 값을 baa(으)로 설정하려면 명령은 다음과 같습니다.

xe vm-param-set uuid=VM uuid other-config:foo=baa
<!--NeedCopy-->

하위 수준 매개 변수 명령

class-param-get, class-param-set, class-param-add, class-param-remove, class-param-clear, class-param-list 개체의 매개 변수에 대한 작업에 맞는 몇 가지 명령이 있습니다. 이러한 각 명령은 uuid 매개 변수를 사용하여 특정 개체를 지정합니다. 이러한 명령은 하위 수준 명령으로 간주되므로 VM 이름 레이블이 아닌 UUID를 사용해야 합니다.

• xe class-param-list uuid=uuid

  모든 매개 변수 및 연관된 값을 나열합니다. class-list 명령과 달리 이 명령은 “복잡한” 필드의 값을 나열합니다.

• xe class-param-get uuid=uuid param-name=parameter param-key=key

  특정 매개 변수의 값을 반환합니다. map 매개 변수의 경우 param-key를 지정하면 맵에서 해당 키와 연결된 값을 가져옵니다. param-key가 지정되지 않았거나 매개 변수가 집합인 경우 이 명령은 집합 또는 맵의 문자열 표현을 반환합니다.

• xe class-param-set uuid=uuid param=value

  하나 이상의 매개 변수에 대해 값을 설정합니다.

• xe class-param-add uuid=uuid param-name=parameter key=value param-key=key

  맵 또는 집합 매개 변수에 추가합니다. map 매개 변수의 경우 key=value 구문을 사용하여 키/값 쌍을 추가합니다. 매개 변수가 집합인 경우 param-key=key 구문을 사용하여 키를 추가합니다.

• xe class-param-remove uuid=uuid param-name=parameter param-key=key

  맵에서 키/값 쌍을 제거하거나 집합에서 키를 제거합니다.

• xe class-param-clear uuid=uuid param-name=parameter

  세트 또는 맵을 완전히 지웁니다.

하위 수준 목록 명령

class-list 명령은 class유형의 객체를 나열합니다. 기본적으로 이 명령 유형은 모든 개체를 나열하고 매개 변수의 하위 집합을 출력합니다. 이 동작은 다음과 같은 방법으로 수정할 수 있습니다.

• 하위 집합만 출력하도록 객체를 필터링할 수 있습니다.
• 인쇄되는 매개 변수를 수정할 수 있습니다.

인쇄되는 매개 변수를 변경하려면 인수 params을 쉼표로 구분된 필수 매개 변수 목록으로 지정하십시오. 예:

xe vm-list params=name-label,other-config
<!--NeedCopy-->

이와 달리 모든 매개 변수를 나열하려면 다음 구문을 사용합니다.

xe vm-list params=all
<!--NeedCopy-->

list 명령은 계산이 복잡한 일부 매개 변수를 표시하지 않습니다. 이러한 매개 변수는 다음과 같이 표시됩니다.

allowed-VBD-devices (SRO): <expensive field>
<!--NeedCopy-->

이러한 필드를 가져오려면 class-param-list 또는 class-param-get 명령을 사용하십시오.

목록을 필터링하려면 CLI는 매개 변수 값을 명령줄에 지정된 값과 일치시키고 지정된 모든 제약 조건과 일치하는 개체만 출력합니다. 예:

xe vm-list HVM-boot-policy="BIOS order" power-state=halted
<!--NeedCopy-->

이 명령은 두 필드 power-state의 값이 모두 중지되고 HVM-boot-policy 필드의 값이 BIOS 순서인VM만 나열합니다.

맵의 키 값이나 집합의 값 존재에 따라 목록을 필터링할 수도 있습니다. 맵의 키를 기준으로 필터링하는 구문은 map-name:key=value입니다. 집합에 있는 값을 기준으로 필터링하는 구문은 set-name:contains=value입니다 .

스크립팅할 때 유용한 기술은 명령줄에서 --minimal을(를) 전달하여 xe에서 쉼표로 구분된 목록의 첫 번째 필드만 인쇄하도록 하는 것입니다. 예를 들어 VM이 3개 설치된 호스트의 xe vm-list --minimal 명령은 3개의 VM UUID를 제공합니다.

    a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
    42c044de-df69-4b30-89d9-2c199564581d
<!--NeedCopy-->

보안

Citrix Hypervisor는 암호가 명령줄 기록이나 API 개체에 일반 텍스트로 저장되는 것을 방지하는 보안 메커니즘을 제공합니다. XenCenter는 이 기능을 자동으로 사용하며 xe CLI의 암호가 필요한 모든 명령에서도 이 기능을 사용할 수 있습니다.

참고:

암호 보안은 xe CLI의 원격 인스턴스에서 Citrix Hypervisor 호스트를 인증하는 데 사용할 수 없습니다.

보안 개체를 만들려면 Citrix Hypervisor 호스트에서 다음 명령을 실행합니다.

xe secret-create value=my-password
<!--NeedCopy-->

암호가 생성되어 Citrix Hypervisor 호스트에 저장됩니다. 이 명령은 보안 개체의 UUID를 출력합니다. 예를 들어, 99945d96-5890-de2a-3899-8c04ef2521db입니다. 암호가 필요한 명령에 이 UUID를 전달하려면 _secret을(를) 암호 인수의 이름에 추가합니다.

예: 암호를 만든 Citrix Hypervisor 호스트에서 다음 명령을 실행할 수 있습니다.

    xe sr-create device-config:location=sr_address device-config:type=cifs device-config:username=cifs_username  \
    device-config:cifspassword_secret=secret_uuid name-label="CIFS ISO SR" type="iso" content-type="iso" shared="true"
<!--NeedCopy-->

명령 내역

일부 xe 명령(예: xe vm-migrate 또는 xe pool-enable-external-auth)은 암호와 같은 비밀을 매개 변수로 사용합니다. 이러한 명령은 셸 기록에서 끝날 수 있으며 명령 실행 중에 프로세스 테이블에 표시됩니다. 따라서 이러한 명령은 신뢰할 수 있는 환경에서만 실행하는 것이 중요합니다.

bash 셸의 경우 HISTCONTROL 변수를 사용하여 셸 내역에 저장되는 명령을 제어할 수 있습니다.

xe 명령 참조

이 섹션에서는 명령이 처리하는 개체별로 명령을 그룹화합니다. 이러한 개체는 알파벳순으로 나열됩니다.

장비 명령

VM 장비(vApp이라고도 함)를 만들고 수정하기 위한 명령입니다. 자세한 내용은 vApp을 참조하십시오.

장비 매개 변수

장비 명령에는 다음과 같은 매개 변수가 있습니다.

appliance-assert-can-be-recovered

xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

이 VM 장비/vApp을 복구하는 데 스토리지를 사용할 수 있는지 테스트합니다.

appliance-create

xe appliance-create name-label=name-label [name-description=name-description]
<!--NeedCopy-->

장비/vApp을 생성합니다. 예:

xe appliance-create name-label=my_appliance
<!--NeedCopy-->

VM을 장비에 추가합니다.

xe vm-param-set uuid=VM-UUID appliance=appliance-uuid
<!--NeedCopy-->

appliance-destroy

xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->

장비/vApp을 삭제합니다. 예:

xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]
<!--NeedCopy-->

제공된 VDI에 포함된 데이터베이스에서 VM 장비/vApp을 복구합니다.

appliance-shutdown

xe appliance-shutdown uuid=appliance-uuid [force=true|false]
<!--NeedCopy-->

장비/vApp의 모든 VM을 종료합니다. 예:

xe appliance-shutdown uuid=appliance-uuid
<!--NeedCopy-->

appliance-start

xe appliance-start uuid=appliance-uuid [paused=true|false]
<!--NeedCopy-->

장비/vApp을 시작합니다. 예:

xe appliance-start uuid=appliance-uuid
<!--NeedCopy-->

감사 명령

감사 명령은 풀에 있는 RBAC 감사 파일의 사용 가능한 모든 레코드를 다운로드합니다. 선택적 매개 변수 since이(가) 있는 경우 특정 시점의 레코드만 다운로드합니다.

audit-log-get 매개 변수

audit-log-get에 다음과 같은 매개 변수가 있습니다.

audit-log-get

xe audit-log-get [since=timestamp] filename=filename
<!--NeedCopy-->

예를 들어 정확한 밀리초 타임스탬프 이후 풀의 감사 레코드를 가져오려면 다음 명령을 실행합니다.

다음 명령을 실행합니다.

xe audit-log-get since=2009-09-24T17:56:20.530Z filename=/tmp/auditlog-pool-actions.out
<!--NeedCopy-->

본딩 명령

물리적 인터페이스 장애 조치(failover)를 이용한 복구를 위해 네트워크 본드를 사용하는 명령입니다. 자세한 내용은 네트워킹을 참조하십시오.

본드 개체는 마스터 및 멤버 PIF를 함께 연결하는 참조 개체입니다. 마스터 PIF는 본드를 참조하기 위해 전체 PIF로 사용되어야 하는 본드 인터페이스입니다. 멤버 PIF는 상위 레벨 본딩 인터페이스로 결합된 두 개 이상의 물리적 인터페이스 세트입니다.

본드 매개 변수

본드에는 다음과 같은 매개 변수가 있습니다.

bond-create

xe bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...
<!--NeedCopy-->

지정된 네트워크에서 기존 PIF 개체의 목록으로 본드된 네트워크 인터페이스를 만듭니다. 다음과 같은 경우 명령이 실패합니다.

• PIF가 이미 다른 본드에 있는 경우
• 구성원에게 VLAN 태그 집합이 있는 경우
• 참조된 PIF가 동일한 Citrix Hypervisor 서버에 있지 않은 경우
• 제공된 PIF 수가 2개 미만인 경우

bond-destroy

xe bond-destroy uuid=bond_uuid
<!--NeedCopy-->

호스트에서 UUID로 지정된 본드 인터페이스를 삭제합니다.

bond-set-mode

xe bond-set-mode uuid=bond_uuid mode=bond_mode
<!--NeedCopy-->

본드 모드를 변경합니다.

CD 명령

Citrix Hypervisor 서버에서 실제 CD/DVD 드라이브로 작업하기 위한 명령입니다.

CD 매개 변수

CD에는 다음과 같은 매개 변수가 있습니다.

cd-list

xe cd-list [params=param1,param2,...] [parameter=parameter_value]
<!--NeedCopy-->

선택적 인수 params을(를) 기준으로 필터링하여 Citrix Hypervisor 서버 또는 풀에 있는 CD 및 ISO를 나열합니다.

선택적 인수 params을(를) 사용하는 경우 params 값은 표시하려는 이 객체의 매개 변수 목록이 포함된 문자열입니다. 또는 all 키워드를 사용하여 모든 매개 변수를 표시할 수 있습니다. params을(를) 사용하지 않으면 반환된 목록에 사용 가능한 모든 매개 변수의 기본 하위 집합이 표시됩니다.

선택적 인수는 이 섹션의 시작 부분에 나열된 CD 매개 변수의 개수에 관계없이 사용할 수 있습니다.

클러스터 명령

클러스터된 풀 작업을 위한 명령입니다.

클러스터된 풀은 클러스터링 기능이 활성화된 리소스 풀입니다. GFS2 SR과 함께 이 풀을 사용하십시오. 자세한 내용은 클러스터된 풀을 참조하십시오.

클러스터 및 클러스터 호스트 개체는 명령(xe cluster-list 및 xe cluster-host-list)을 나열하는 표준 개체와 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오. 클러스터된 풀 작업을 위한 명령입니다.

클러스터링된 매개 변수

클러스터에는 다음과 같은 매개 변수가 있습니다.

cluster-host-destroy

xe cluster-host-destroy uuid=host_uuid
<!--NeedCopy-->

클러스터 호스트를 삭제하여 클러스터를 실질적으로 종료합니다.

cluster-host-disable

xe cluster-host-disable uuid=cluster_uuid
<!--NeedCopy-->

활성화된 클러스터 호스트에 대한 클러스터 구성원 자격을 비활성화합니다.

cluster-host-enable

xe cluster-host-enable uuid=cluster_uuid
<!--NeedCopy-->

비활성화된 클러스터 호스트에 대한 클러스터 구성원 자격을 활성화합니다.

cluster-host-force-destroy

xe cluster-host-force-destroy uuid=cluster_host
<!--NeedCopy-->

클러스터 호스트 객체를 강제로 제거하여 클러스터를 실질적으로 종료합니다.

cluster-pool-create

xe cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]
<!--NeedCopy-->

풀 전체 클러스터를 생성합니다.

cluster-pool-destroy

xe cluster-pool-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->

풀 전체 클러스터를 삭제합니다. 풀은 계속 존재하지만 클러스터링되지 않아 GFS2 SR을 더 이상 사용할 수 없습니다.

cluster-pool-force-destroy

xe cluster-pool-force-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->

풀 전체 클러스터를 강제 삭제합니다.

cluster-pool-resync

xe cluster-pool-resync cluster-uuid=cluster_uuid
<!--NeedCopy-->

풀에서 클러스터를 다시 동기화합니다.

콘솔 명령

콘솔로 작업하기 위한 명령입니다.

콘솔 개체는 표준 개체 나열 명령(xe console-list)으로 나열할 수 있으며 매개 변수는 표준 매개 변수 명령으로 조작합니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

콘솔 매개 변수

콘솔에는 다음과 같은 매개 변수가 있습니다.

console

xe console
<!--NeedCopy-->

특정 콘솔에 연결합니다.

진단 명령

Citrix Hypervisor에서 진단 정보를 수집하기 위한 명령입니다.

diagnostic-compact

xe diagnostic-compact
<!--NeedCopy-->

주요 GC 수집 및 힙 압축을 수행합니다.

더 이상 사용되지 않음: diagnostic-db-log

xe diagnostic-db-log
<!--NeedCopy-->

데이터베이스 작업 로깅을 시작합니다. 경고: 일단 시작되면 중지할 수 없습니다.

diagnostic-db-stats

xe diagnostic-db-stats
<!--NeedCopy-->

데이터베이스 통계를 인쇄합니다.

diagnostic-gc-stats

xe diagnostic-gc-stats
<!--NeedCopy-->

GC 통계를 인쇄합니다.

diagnostic-license-status

xe diagnostic-license-status
<!--NeedCopy-->

풀 전체의 라이선스 문제를 진단하는 데 도움이 됩니다.

diagnostic-net-stats

xe diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]
<!--NeedCopy-->

네트워크 통계를 인쇄합니다.

diagnostic-timing-stats

xe diagnostic-timing-stats
<!--NeedCopy-->

타이밍 통계를 인쇄합니다.

diagnostic-vdi-status

xe diagnostic-vdi-status uuid=vdi_uuid
<!--NeedCopy-->

VDI의 잠금 및 공유 상태를 쿼리합니다.

diagnostic-vm-status

xe diagnostic-vm-status uuid=vm_uuid
<!--NeedCopy-->

VM이 부팅할 수 있는 호스트를 쿼리하고 모든 VBD의 공유/잠금 상태를 확인합니다.

재해 복구 명령

재해 발생 후 VM을 복구하기 위한 명령

drtask-create

xe drtask-create type=type sr-whitelist=sr-white-list device-config=device-config
<!--NeedCopy-->

재해 복구 작업을 만듭니다. 예를 들어 재해 복구를 준비하기 위해 iSCSI SR에 연결하려면 다음을 실행합니다.

xe drtask-create type=lvmoiscsi device-config:target=target-ip-address \
    device-config:targetIQN=targetIQN device-config:SCSIid=SCSIid \
    sr-whitelist=sr-uuid-list
<!--NeedCopy-->

참고:

이 명령 sr-whitelist은(는) 허용되는 SR UUID를 나열합니다. 이 drtask-create 명령은 허용되는 UUID 중 하나가 있는 SR만 소개하고 연결합니다.

drtask-destroy

xe drtask-destroy uuid=dr-task-uuid
<!--NeedCopy-->

재해 복구 작업을 삭제하고 가져온 SR을 무시합니다.

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

이 VM을 복구하는 데 스토리지를 사용할 수 있는지 테스트합니다.

appliance-assert-can-be-recovered

xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

스토리지(장비/vApp 디스크 포함)가 표시되는지 확인합니다.

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->

제공된 VDI에 포함된 데이터베이스에서 장비/vApp을 복구합니다.

vm-recover

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->

제공된 VDI에 포함된 데이터베이스에서 VM을 복구합니다.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->

지정된(공유된) SR에 대한 XAPI 데이터베이스 복제를 활성화합니다.

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->

지정된 SR에 대한 XAPI 데이터베이스 복제를 비활성화합니다.

사용 예시

아래 예에서는 컨텍스트에 따른 DR CLI 명령을 보여 줍니다.

기본 사이트에서 데이터베이스 복제를 사용하도록 설정합니다.

xe sr-database-replication uuid=sr=uuid
<!--NeedCopy-->

재해가 발생한 후 보조 사이트에서 SR에 연결합니다. device-config 명령에는 sr-probe와(과) 동일한 필드가 있습니다.

xe drtask-create type=lvmoiscsi \
    device-config:target=target ip address \
    device-config:targetIQN=target-iqn \
    device-config:SCSIid=scsi-id \
    sr-whitelist=sr-uuid
<!--NeedCopy-->

SR에서 데이터베이스 VDI를 찾습니다.

xe vdi-list sr-uuid=sr-uuid type=Metadata
<!--NeedCopy-->

데이터베이스 VDI에서 VM을 쿼리합니다.

xe vm-list database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

VM을 복구합니다.

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

DR 작업을 삭제합니다. DR 작업에서 가져온 것 중 VM에 필요하지 않은 모든 SR을 삭제합니다.

xe drtask-destroy uuid=drtask-uuid
<!--NeedCopy-->

이벤트 명령

이벤트를 처리하기 위한 명령입니다.

이벤트 클래스

이벤트 클래스는 다음 표에 나열되어 있습니다.

event-wait

xe event-wait class=class_name [param-name=param_value] [param-name=/=param_value]
<!--NeedCopy-->

명령행에 지정된 조건을 만족하는 개체가 존재할 때까지 다른 명령이 실행되지 않도록 차단합니다. x=y 인수는 “필드 x가 값 y를 취할 때까지 기다리십시오”를 의미하고 x=/=y은(는) “x 필드가 y 이외의 값을 취할 때까지 기다리십시오”를 의미합니다.

예: 특정 VM이 실행될 때까지 기다립니다.

xe event-wait class=vm name-label=myvm power-state=running
<!--NeedCopy-->

myvm라는 VM이 power-state “실행 중”이 될 때까지 다른 명령을 차단합니다.

예: 특정 VM이 재부팅될 때까지 기다립니다.

xe event-wait class=vm uuid=$VM start-time=/=$(xe vm-list uuid=$VM params=start-time --minimal)
<!--NeedCopy-->

UUID $VM이 있는 VM이 재부팅될 때까지 다른 명령을 차단합니다. 이 명령은 start-time의 값을 사용하여 VM이 재부팅되는 시기를 결정합니다.

클래스 이름은 이 섹션의 시작 부분에 나열된 이벤트 클래스 중 하나일 수 있습니다. 매개 변수는 CLI 명령 class-param-list에 나열된 매개 변수 중 하나일 수 있습니다.

GPU 명령어

물리적 GPU, GPU 그룹 및 가상 GPU로 작업하기 위한 명령입니다.

GPU 객체는 명령을 나열하는 표준 개체를 사용하여 나열할 수 있습니다. xe pgpu-list, xe gpu-group-list, 및 xe vgpu-list 매개 변수는 표준 매개 변수 명령으로 조작할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

물리적 GPU 매개 변수

물리적 GPU(pGPU)에는 다음과 같은 매개 변수가 있습니다.

pgpu-disable-dom0-access

xe pgpu-disable-dom0-access uuid=uuid
<!--NeedCopy-->

dom0에 대한 PGPU 액세스를 비활성화합니다.

pgpu-enable-dom0-access

xe pgpu-enable-dom0-access uuid=uuid
<!--NeedCopy-->

dom0에 대한 PGPU 액세스를 활성화합니다.

GPU 그룹 매개 변수

GPU 그룹에는 다음과 같은 매개 변수가 사용됩니다.

GPU 그룹 운영

GPU 그룹 작업에 사용되는 명령

gpu-group-create

xe gpu-group-create name-label=name_for_group [name-description=description]
<!--NeedCopy-->

pGPU를 이동할 수 있는 새로운(빈) GPU 그룹을 생성합니다.

gpu-group-destroy

xe gpu-group-destroy uuid=uuid_of_group
<!--NeedCopy-->

GPU 그룹을 삭제합니다. 이 명령은 빈 그룹에만 사용할 수 있습니다.

gpu-group-get-remaining-capacity

xe gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type
<!--NeedCopy-->

이 GPU 그룹에서 시작할 수 있도록 지정된 유형의 가상 GPU 개수를 반환합니다.

gpu-group-param-set

xe gpu-group-param-set uuid=uuid_of_group allocation-algorithm=breadth-first|depth-first
<!--NeedCopy-->

GPU 그룹이 가상 GPU를 pGPU에 할당하는 데 사용하는 알고리즘을 변경합니다.

gpu-group-param-get-uuid

xe gpu-group-param-get-uuid uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types
<!--NeedCopy-->

이 GPU 그룹에 지원되거나 사용하도록 설정된 유형을 반환합니다.

가상 GPU 매개 변수

가상 GPU에는 다음과 같은 매개 변수가 사용됩니다.

가상 GPU 유형 매개 변수

참고:

GPU 패스스루 및 가상 GPU는 GPU 공급업체의 지원되는 소프트웨어 및 그래픽 카드가 없는 경우 라이브 마이그레이션, 스토리지 라이브 마이그레이션 또는 VM 일시 중단과 호환되지 않습니다. 이러한 지원이 없는 VM은 다운타임을 방지하기 위해 마이그레이션할 수 없습니다. 라이브 마이그레이션, 스토리지 라이브 마이그레이션 및 VM 일시 중지와 NVIDIA vGPU 호환성에 대한 자세한 내용은 그래픽을 참조하십시오.

가상 GPU 유형에는 다음과 같은 매개 변수가 사용됩니다.

가상 GPU 작업

vgpu-create

xe vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]
<!--NeedCopy-->

가상 GPU를 생성합니다. 이 명령은 지정한 GPU 그룹에 VM을 연결하고 가상 GPU 유형을 지정합니다(선택 사항). 가상 GPU 유형을 지정하지 않으면 ‘패스스루’ 유형이 사용됩니다.

vgpu-destroy

xe vgpu-destroy uuid=uuid_of_vgpu
<!--NeedCopy-->

지정된 가상 GPU를 파괴합니다.

가상 GPU가 있는 VM에 대해 VNC 비활성화

xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false
<!--NeedCopy-->

false을(를) 사용하면 disablevnc=1을(를) 디스플레이 에뮬레이터로 패스스루할 때 VM에 대한 VNC 콘솔이 비활성화됩니다. 기본적으로 VNC는 활성화되어 있습니다.

호스트 명령

Citrix Hypervisor 서버와 상호 작용하기 위한 명령입니다.

Citrix Hypervisor 서버는 Citrix Hypervisor 소프트웨어를 실행하는 물리적 서버입니다. 이러한 서버에서는 제어 도메인 또는 도메인 0이라고 하는 특별 권한이 있는 가상 컴퓨터의 제어를 받으며 VM이 실행됩니다.

Citrix Hypervisor 서버 개체는 명령(xe host-list, xe host-cpu-list, 및 xe host-crashdump-list)을 나열하는 표준 개체와 함께 나열될 수 있습니다. 매개 변수는 표준 매개 변수 명령으로 조작할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

호스트 선택기

여기에 나열된 몇 가지 명령에는 작업을 수행할 하나 이상의 Citrix Hypervisor 서버를 선택하는 일반적인 메커니즘이 있습니다. 가장 간단한 방법은 host=uuid_or_name_label 인수을 제공하는 것입니다. 필드 값에 대한 전체 호스트 목록을 필터링하여 Citrix Hypervisor를 지정할 수도 있습니다. 예를 들어 enabled=true을(를) 지정하면 enabled 필드가 true인 모든 Citrix Hypervisor 서버가 선택됩니다. 여러 Citrix Hypervisor 서버가 일치하고 여러 Citrix Hypervisor 서버에서 작업을 수행할 수 있는 경우 작업을 수행하도록 --multiple을(를) 지정해야 합니다. 일치할 수 있는 전체 매개 변수 목록은 이 섹션의 시작 부분에 설명되어 있습니다. xe host-list params=all 명령을 실행하여 이 명령 목록을 얻을 수 있습니다. Citrix Hypervisor 서버를 선택하는 데 필요한 매개 변수가 주어지지 않은 경우 모든 Citrix Hypervisor 서버에서 작업이 수행됩니다.

호스트 매개 변수

Citrix Hypervisor 서버에는 다음과 같은 매개 변수가 있습니다.

Citrix Hypervisor 서버에는 매개 변수 목록도 사용하고 있는 일부 기타 개체가 포함됩니다.

Citrix Hypervisor 서버의 CPU에는 다음과 같은 매개 변수가 있습니다.

Citrix Hypervisor 서버의 크래시 덤프에는 다음과 같은 매개 변수가 있습니다.

host-all-editions

xe host-all-editions
<!--NeedCopy-->

사용 가능한 모든 에디션 목록 보기

host-apply-edition

xe host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]
<!--NeedCopy-->

호스트 서버에 Citrix Hypervisor 라이센스를 할당합니다. 라이센스를 할당하면 Citrix Hypervisor가 라이센스 서버에 접속하여 지정된 유형의 라이센스를 요청합니다. 라이센스를 사용할 수 있으면 라이센스가 라이센스 서버에서 체크 아웃됩니다.

Citrix Virtual Desktops 및 DaaS용 Citrix Hypervisor 에디션의 경우 "xendesktop"을(를) 사용하십시오.

초기 라이선스 구성에 대해서는 license-server-address 및 license-server-port을(를) 참조하십시오.

host-backup

xe host-backup file-name=backup_filename host=host_name
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버의 제어 도메인 백업을 명령이 호출된 컴퓨터로 다운로드합니다. 이름이 file-name인 파일로 저장합니다.

중요:

xe host-backup 명령을 로컬 호스트에서 실행할 경우(즉, 특정 호스트 이름을 지정하지 않은 경우) 작동하지만 이 방법으로는 사용하지 마십시오. 사용할 경우 제어 도메인 파티션이 백업 파일로 채워집니다. 백업 파일을 보관할 공간이 있는 원격 오프호스트 시스템에서만 명령을 사용합니다.

host-bugreport-upload

xe host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]
<!--NeedCopy-->

새 버그 리포트를 생성하고(xen-bugtool 사용, 모든 옵션 파일 포함) 지원 FTP 사이트 또는 다른 위치에 업로드합니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

선택적 매개 변수는 http-proxy: 지정된 HTTP 프록시 사용 및 url: 대상 URL에 업로드입니다. 선택적 매개 변수를 사용하지 않으면 프록시 서버가 식별되지 않고 대상이 기본 지원 FTP 사이트가 됩니다.

host-call-plugin

xe host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]
<!--NeedCopy-->

선택적 인수를 사용하여 지정된 호스트의 플러그인 내에서 함수를 호출합니다.

host-compute-free-memory

xe host-compute-free-memory
<!--NeedCopy-->

호스트의 사용 가능한 메모리 양을 계산합니다.

host-compute-memory-overhead

xe host-compute-memory-overhead
<!--NeedCopy-->

호스트의 가상화 메모리 오버헤드를 계산합니다.

host-cpu-info

xe host-cpu-info [uuid=uuid]
<!--NeedCopy-->

호스트의 물리적 CPU에 대한 정보를 나열합니다.

host-crashdump-destroy

xe host-crashdump-destroy uuid=crashdump_uuid
<!--NeedCopy-->

Citrix Hypervisor 서버에서 해당 UUID로 지정된 호스트 크래시 덤프를 삭제합니다.

host-crashdump-upload

xe host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]
<!--NeedCopy-->

크래시 덤프를 지원 FTP 사이트 또는 다른 위치에 업로드합니다. 선택적 매개 변수를 사용하지 않으면 프록시 서버가 식별되지 않고 대상이 기본 지원 FTP 사이트가 됩니다. 선택적 매개 변수는 http-proxy: 지정된 HTTP 프록시 사용 및 url: 대상 URL에 업로드입니다.

host-declare-dead

xe host-declare-dead uuid=host_uuid
<!--NeedCopy-->

명시적으로 연결하지 않고 호스트가 작동하지 않았다고 선언합니다.

경고:

이 호출은 위험하며 호스트가 실제로 작동하는 경우 데이터가 손실될 수 있습니다.

host-disable

xe host-disable [host-selector=host_selector_value...]
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버를 비활성화합니다. 그러면 새 VM이 서버에서 시작되지 않습니다. 이 작업을 수행하면 Citrix Hypervisor 서버가 종료 또는 재부팅됩니다. 호스트가 재부팅된 후 모든 설정 조건(예: 스토리지 사용 가능)이 충족되면 호스트가 자동으로 다시 활성화됩니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

host-disable-display

xe host-disable-display uuid=host_uuid
<!--NeedCopy-->

호스트에 대한 표시를 비활성화합니다.

host-disable-local-storage-caching

xe host-disable-local-storage-caching
<!--NeedCopy-->

지정된 호스트에서 로컬 스토리지 캐싱을 비활성화합니다.

host-dmesg

xe host-dmesg [host-selector=host_selector_value...]
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버에서 Xen dmesg(커널 링 버퍼의 출력)을 가져옵니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

host-emergency-ha-disable

xe host-emergency-ha-disable  [--force]
<!--NeedCopy-->

로컬 호스트에서 HA를 비활성화합니다. HA 설정이 손상된 풀을 복구하는 데만 사용합니다.

host-emergency-management-reconfigure

xe host-emergency-management-reconfigure interface=uuid_of_management_interface_pif
<!--NeedCopy-->

이 Citrix Hypervisor 서버의 관리 인터페이스를 다시 구성합니다. Citrix Hypervisor 서버가 비상 모드인 경우에만 이 명령을 사용합니다. 비상 모드란 호스트가 네트워크에서 마스터가 사라지고 여러 번 다시 시도한 후에도 연결할 수 없는 리소스 풀의 구성원임을 의미합니다.

host-emergency-reset-server-certificate

xe host-emergency-reset-server-certificate
<!--NeedCopy-->

명령이 실행되는 Citrix Hypervisor 서버에 자체 서명된 인증서를 설치합니다.

host-enable

xe host-enable [host-selector=host_selector_value...]
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버를 활성화합니다. 그러면 서버에서 새 VM을 시작할 수 있습니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

host-enable-display

xe host-enable-display uuid=host_uuid
<!--NeedCopy-->

호스트에 대해 디스플레이를 활성화합니다.

host-enable-local-storage-caching

xe host-enable-local-storage-caching  sr-uuid=sr_uuid
<!--NeedCopy-->

지정된 호스트에서 로컬 스토리지 캐싱을 활성화합니다.

host-evacuate

xe host-evacuate [host-selector=host_selector_value...]
<!--NeedCopy-->

실행 중인 모든 VM을 풀의 적합한 다른 호스트로 라이브 마이그레이션합니다. 먼저 host-disable 명령을 사용하여 호스트를 비활성화합니다.

비워진 호스트가 풀 마스터이면 다른 호스트를 풀 마스터로 선택해야 합니다. HA가 비활성화된 상태에서 풀 마스터를 변경하려면 pool-designate-new-master 명령을 사용합니다. 자세한 내용은 pool-designate-new-master를 참조하십시오.

HA를 사용하도록 설정한 상태에서는 HA에서 임의로 새 마스터를 선택할 수 있도록 서버를 종료하는 방법 밖에 없습니다. 자세한 내용은 host-shutdown을 참조하십시오.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

host-forget

xe host-forget uuid=host_uuid
<!--NeedCopy-->

XAPI 에이전트가 지정된 Citrix Hypervisor 서버에 명시적으로 연결하지 않고 이를 무시합니다.

이 작업을 실제로 수행할 것인지 묻는 메시지가 표시되지 않도록 하려면 --force 매개 변수를 사용하십시오.

경고:

풀에 HA가 사용하도록 설정되어 있으면 이 명령을 사용하지 마십시오. 먼저 HA를 사용하지 않도록 설정하고 호스트를 무시한 후 다시 사용하도록 설정하십시오.

이 명령은 “무시”할 Citrix Hypervisor 서버가 작동하지 않는 경우에 유용합니다. 그러나 Citrix Hypervisor 서버가 라이브 서버이고 풀의 일부인 경우에는 대신 xe pool-eject을(를) 사용하십시오.

host-get-server-certificate

xe host-get-server-certificate
<!--NeedCopy-->

설치된 서버 TLS 인증서를 가져옵니다.

host-get-sm-diagnostics

xe host-get-sm-diagnostics uuid=uuid
<!--NeedCopy-->

호스트별 SM 진단 정보를 표시합니다.

host-get-system-status

xe host-get-system-status filename=name_for_status_file [entries=comma_separated_list] [output=tar.bz2|zip] [host-selector=host_selector_value...]
<!--NeedCopy-->

시스템 상태 정보를 지정된 파일에 다운로드합니다. 선택적 매개 변수 entries은(는) host-get-system-status-capabilities 명령에서 반환된 기능 XML 조각에서 가져온 시스템 상태 항목의 쉼표로 구분된 목록입니다. 자세한 내용은 host-get-system-status-capabilities를 참조하십시오. 지정하지 않으면 모든 시스템 상태 정보가 파일에 저장됩니다. output 매개 변수는 tar.bz2(기본값) 또는 zip일 수 있습니다. 이 매개 변수를 지정하지 않으면 파일이 tar.bz2 형식으로 저장됩니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조).

host-get-system-status-capabilities

xe host-get-system-status-capabilities [host-selector=host_selector_value...]
<!--NeedCopy-->

지정된 호스트의 시스템 상태 기능을 가져옵니다. 이 기능은 다음 예제와 유사한 XML 프래그먼트로 반환됩니다.

<?xml version="1.0" ?>
<system-status-capabilities>
    <capability content-type="text/plain" default-checked="yes" key="xenserver-logs"  \
        max-size="150425200" max-time="-1" min-size="150425200" min-time="-1" \
        pii="maybe"/>
    <capability content-type="text/plain" default-checked="yes" \
        key="xenserver-install" max-size="51200" max-time="-1" min-size="10240" \
        min-time="-1" pii="maybe"/>
    ...
</system-status-capabilities>
<!--NeedCopy-->

각 기능 엔터티는 다음과 같은 특성을 가질 수 있습니다.

• key 기능에 대한 고유 식별자입니다.
• content-type text/plain 또는 application/data일 수 있습니다. UI에서 사용자가 사용할 수 있도록 항목을 렌더링할 수 있는지 여부를 나타냅니다.
• default-checked yes 또는 no일 수 있습니다. UI에서 기본적으로 이 항목을 선택해야 하는지 여부를 나타냅니다.
• min-size, max-size 이 항목의 크기에 대한 대략적인 범위(바이트 단위)를 나타냅니다. -1은 크기가 중요하지 않음을 나타냅니다.
• min-time, max-time 이 항목을 수집하는 데 걸린 대략적인 시간 범위(초)를 나타냅니다. -1은 시간이 중요하지 않음을 나타냅니다.

• pii 신원을 확인할 수 있는 정보입니다. 항목에 시스템 소유자를 식별할 수 있는 정보나 네트워크 토폴로지의 세부 정보가 포함되어 있는지 여부를 나타냅니다. 속성은 다음 값 중 하나를 가질 수 있습니다.

  • no: 이 항목에는 PII가 없습니다.
  • yes: PII는 다음 항목에 포함될 가능성이 높거나 확실합니다.
  • maybe: PII에 대해 이러한 항목을 감사하는 것이 좋습니다.
  • if_customized 파일이 수정되지 않은 경우에는 PII가 포함되지 않습니다. 그러나 이러한 파일을 편집하는 것이 좋으므로 이러한 사용자 지정을 통해 PII가 도입되었을 수 있습니다. 이 값은 특히 제어 도메인의 네트워킹 스크립트에 사용됩니다.

  PII 선언에 상관없이 암호는 모든 버그 보고서에 절대 포함되지 않습니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조).

host-get-thread-diagnostics

xe host-get-thread-diagnostics uuid=uuid
<!--NeedCopy-->

호스트별 스레드 진단 정보를 표시합니다.

host-get-vms-which-prevent-evacuation

xe host-get-vms-which-prevent-evacuation uuid=uuid
<!--NeedCopy-->

특정 호스트의 비워짐을 방지하고 각 호스트에 대한 이유를 표시하는 VM 목록을 반환합니다.

host-is-in-emergency-mode

xe host-is-in-emergency-mode
<!--NeedCopy-->

CLI가 통신하는 호스트가 비상 모드인 경우 true, 그렇지 않은 경우 false을(를) 반환합니다. 이 CLI 명령은 마스터 서버가 없어도 풀 구성원 서버에서 직접 작동합니다.

host-license-add

xe host-license-add [license-file=path/license_filename] [host-uuid=host_uuid]
<!--NeedCopy-->

Citrix Hypervisor(무료 버전)의 경우 이 명령을 사용하여 로컬 라이센스 파일의 구문을 분석하고 지정된 Citrix Hypervisor 호스트에 추가합니다.

host-license-remove

xe host-license-remove [host-uuid=host_uuid]
<!--NeedCopy-->

호스트에 적용된 라이센스를 모두 제거합니다.

host-license-view

xe host-license-view [host-uuid=host_uuid]
<!--NeedCopy-->

Citrix Hypervisor 서버 라이센스의 내용을 표시합니다.

host-logs-download

xe host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버의 로그 사본을 다운로드합니다. 이 사본은 기본적으로 이름이 hostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz인 타임스탬프가 지정된 파일에 저장됩니다 . 선택적 매개 변수 file-name을 사용하여 다른 파일 이름을 지정할 수도 있습니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

중요:

xe host-logs-download 명령을 로컬 호스트에서 실행할 경우(즉, 특정 호스트 이름을 지정하지 않은 경우) 작동하지만 이 방법으로는 사용하지 마십시오. 이렇게 하면 제어 도메인 파티션이 로그 복사본으로 채워집니다. 로그 사본을 보관할 공간이 있는 원격 오프 호스트 시스템의 명령만 사용하십시오.

host-management-disable

xe host-management-disable
<!--NeedCopy-->

외부 관리 네트워크 인터페이스에서 수신 대기하는 호스트 에이전트를 비활성화하고 연결된 모든 API 클라이언트(예: XenCenter)의 연결을 끊습니다. 이 명령은 CLI가 연결된 Citrix Hypervisor 서버에서 직접 작동합니다. 이 명령이 구성원 Citrix Hypervisor 서버에 적용될 경우 풀 마스터로 전달되지 않습니다.

경고:

호스트 외부에서 이 CLI 명령을 사용할 때는 주의하십시오. 이 명령을 실행한 후에는 네트워크를 통해 원격으로 제어 도메인에 연결하여 호스트 에이전트를 다시 활성화할 수 없습니다.

host-management-reconfigure

xe host-management-reconfigure [interface=device] [pif-uuid=uuid]
<!--NeedCopy-->

지정된 네트워크 인터페이스를 관리 인터페이스로 사용하도록 Citrix Hypervisor 서버를 다시 구성합니다. 여기서 관리 인터페이스란 XenCenter에 연결하는 데 사용되는 인터페이스를 말합니다. 이 명령은 /etc/xensource-inventory에서 MANAGEMENT_INTERFACE 키를 재작성합니다.

인터페이스의 장치 이름(IP 주소가 있어야 함)을 지정하면 Citrix Hypervisor 서버에서 즉시 다시 바인딩합니다. 이 명령은 일반 모드와 긴급 모드에서 모두 작동합니다.

PIF 개체의 UUID가 지정되어 있으면 Citrix Hypervisor 서버가 자체적으로 다시 바인딩할 IP 주소를 결정합니다. 긴급 모드에서는 이 명령을 실행할 수 없습니다.

경고:

오프 호스트로 이 CLI 명령을 사용할 경우 주의해야 하며 새 인터페이스에 네트워크가 연결되어 있는지 확인해야 합니다. xe pif-reconfigure을(를) 사용하여 먼저 하나를 설정합니다. 그렇지 않으면 후속 CLI 명령이 Citrix Hypervisor 서버에 연결할 수 없습니다.

host-power-on

xe host-power-on [host=host_uuid]
<!--NeedCopy-->

호스트 전원 켜기 기능이 활성화된 상태에서 Citrix Hypervisor 서버의 전원을 켭니다. 이 명령을 사용하기 전에 호스트에서 host-set-power-on을(를) 활성화합니다.

host-reboot

xe host-reboot [host-selector=host_selector_value...]
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버를 재부팅합니다. 먼저 xe host-disable 명령을 사용하여 지정된 호스트를 비활성화해야 합니다. 그러지 않으면 HOST_IN_USE 오류 메시지가 표시됩니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

지정된 Citrix Hypervisor 서버가 풀의 구성원인 경우 종료 시 연결 손실이 처리되고 Citrix Hypervisor 서버가 반환되면 풀이 복구됩니다. 다른 구성원과 마스터는 계속 작동합니다.

마스터를 종료하면 다음 작업 중 하나가 발생할 때까지 풀이 동작하지 않습니다.

• 구성원 중 하나를 마스터로 만듭니다.

• 원래 마스터가 재부팅되고 다시 온라인 상태로 돌아갑니다.

  마스터가 다시 온라인 상태가 되면 구성원이 다시 연결하고 마스터와 동기화됩니다.

host-restore

xe host-restore [file-name=backup_filename] [host-selector=host_selector_value...]
<!--NeedCopy-->

이름이 file-name인 Citrix Hypervisor 서버 제어 소프트웨어 백업을 복원합니다. 여기서 사용된 “복원”이라는 단어는 일반적인 의미의 전체 복원이 아니라 단순히 압축된 백업 파일의 압축을 풀고 보조 파티션에 저장하는 것을 뜻합니다. xe host-restore을(를) 수행한 후에는 설치 CD를 부팅하고 Restore from Backup(백업에서 복원) 옵션을 사용해야 합니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

host-send-debug-keys

xe host-send-debug-keys  host-uuid=host_uuid keys=keys
<!--NeedCopy-->

지정된 하이퍼바이저 디버그 키를 지정된 호스트로 보냅니다.

host-server-certificate-install

xe host-server-certificate-install certificate=path_to_certificate_file private-key=path_to_private_key [certificate-chain=path_to_chain_file] [host=host_name | uuid=host_uuid]
<!--NeedCopy-->

Citrix Hypervisor 서버에 TLS 인증서를 설치합니다.

host-set-hostname-live

xe host-set-hostname-live host-uuid=uuid_of_host host-name=new_hostname
<!--NeedCopy-->

host-uuid에서 지정한 Citrix Hypervisor 서버의 호스트 이름을 변경합니다. 이 명령을 실행하면 호스트의 제어 도메인 데이터베이스 호스트 이름과 Citrix Hypervisor 서버의 실제 Linux 호스트 이름이 모두 영구적으로 설정됩니다. host-name의 값은 name_label 필드의 값과 같지 않습니다 .

host-set-power-on-mode

xe host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "DRAC" | "custom"} \
    [ power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]
<!--NeedCopy-->

원격 전원 솔루션과 호환되는 Citrix Hypervisor 호스트의 호스트 전원 켜기 기능을 활성화하는 데 사용합니다. host-set-power-on 명령을 사용할 때 호스트에서 전원 관리 솔루션의 유형(즉, power-on-mode)을 지정해야 합니다. 그런 다음 power-on-config 인수 및 관련 키-값 쌍을 사용하여 구성 옵션을 지정합니다.

암호 기능을 사용하여 암호를 저장하려면 "power_on_password_secret" 키를 지정합니다. 자세한 내용은 비밀을 참조하십시오.

host-shutdown

xe host-shutdown [host-selector=host_selector_value...]
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버를 종료합니다. 먼저 xe host-disable 명령을 사용하여 지정된 Citrix Hypervisor 서버를 비활성화해야 합니다. 그러지 않으면 HOST_IN_USE 오류 메시지가 표시됩니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

지정된 Citrix Hypervisor 서버가 풀의 구성원인 경우 종료 시 연결 손실이 처리되고 Citrix Hypervisor 서버가 반환되면 풀이 복구됩니다. 다른 구성원과 마스터는 계속 작동합니다.

마스터를 종료하면 다음 작업 중 하나가 발생할 때까지 풀이 동작하지 않습니다.

• 구성원 중 하나를 마스터로 만듭니다.

• 원래 마스터가 재부팅되고 다시 온라인 상태로 돌아갑니다.

  마스터가 다시 온라인 상태가 되면 구성원이 다시 연결하고 마스터와 동기화됩니다.

풀에 HA를 사용하도록 설정되어 있으면 구성원 중 하나가 자동으로 마스터로 설정됩니다. HA가 사용하지 않도록 설정되어 있으면 pool-designate-new-master 명령을 사용하여 직접 원하는 서버를 마스터로 지정해야 합니다. 자세한 내용은 pool-designate-new-master를 참조하십시오.

host-sm-dp-destroy

xe host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]
<!--NeedCopy-->

호스트에서 스토리지 데이터 경로를 제거하고 정리해 봅니다. allow-leak=true이(가) 제공되면 데이터 경로가 완전히 종료되지 않은 경우에도 데이터 경로의 모든 레코드가 삭제됩니다.

host-sync-data

xe host-sync-data
<!--NeedCopy-->

풀 마스터에 저장된 데이터를 명명된 호스트와 동기화합니다. 여기에는 데이터베이스 데이터가 포함되지 않습니다.

host-syslog-reconfigure

xe host-syslog-reconfigure [host-selector=host_selector_value...]
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버에서 syslog 데몬을 다시 구성합니다. 이 명령을 실행하면 호스트 logging 매개 변수에 정의된 구성 정보가 적용됩니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘으로 선택됩니다(위의 호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다.

host-data-source-list

xe host-data-source-list [host-selectors=host selector value...]
<!--NeedCopy-->

호스트에 대해 기록할 수 있는 데이터 소스를 나열합니다.

표준 선택 메커니즘을 사용하여 이 작업을 수행할 호스트를 선택합니다(호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다. 호스트 선택을 위한 매개 변수를 지정하지 않으면 모든 호스트에 대해 작업이 수행됩니다.

데이터 원본에는 standard 및 enabled의 두 가지 매개 변수가 있습니다 이 명령은 매개 변수 값을 출력합니다.

• 데이터 원본이 enabled을(를) true(으)로 설정한 경우 메트릭은 현재 성능 데이터베이스에 기록되고 있습니다.
• 데이터 원본이 standard을(를) true(으)로 설정한 경우 메트릭은 기본적으로 성능 데이터베이스에 기록됩니다. 이 데이터 원본에 대해서도 enabled의 값이 true(으)로 설정됩니다.
• 데이터 소스가 standard을(를) false(으)로 설정한 경우 메트릭은 기본적으로 성능 데이터베이스에 기록되지 않습니다. 이 데이터 원본에 대해서도 enabled의 값이 false(으)로 설정됩니다.

성능 데이터베이스에 데이터 원본 메트릭 기록을 시작하려면 host-data-source-record 명령을 실행합니다. 이 명령은 enabled을(를) true(으)로 설정합니다 . 중지하려면 host-data-source-forget을(를) 실행합니다. 이 명령은 enabled을(를) false(으)로 설정합니다 .

host-data-source-record

xe host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

호스트의 지정된 데이터 원본을 기록합니다.

이 작업을 수행하면 지정된 호스트의 영구 성능 메트릭 데이터베이스에 데이터 원본의 정보가 기록됩니다. 성능상의 이유로 이 데이터베이스는 일반 에이전트 데이터베이스와 구분됩니다.

표준 선택 메커니즘을 사용하여 이 작업을 수행할 호스트를 선택합니다(호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다. 호스트 선택을 위한 매개 변수를 지정하지 않으면 모든 호스트에 대해 작업이 수행됩니다.

host-data-source-forget

xe host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

호스트의 지정된 데이터 원본 기록을 중지하고 기록된 데이터를 모두 무시합니다.

표준 선택 메커니즘을 사용하여 이 작업을 수행할 호스트를 선택합니다(호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다. 호스트 선택을 위한 매개 변수를 지정하지 않으면 모든 호스트에 대해 작업이 수행됩니다.

host-data-source-query

xe host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

호스트의 지정된 데이터 원본을 표시합니다.

표준 선택 메커니즘을 사용하여 이 작업을 수행할 호스트를 선택합니다(호스트 선택기 참조). 선택적 인수는 이 섹션의 시작 부분에 나열된 호스트 매개 변수의 개수에 관계없이 사용할 수 있습니다. 호스트 선택을 위한 매개 변수를 지정하지 않으면 모든 호스트에 대해 작업이 수행됩니다.

더 이상 사용되지 않음: 로그 명령

로그 작업을 위한 명령입니다.

더 이상 사용되지 않음: log-get

xe log-get
<!--NeedCopy-->

문자열 로거에 현재 저장된 로그를 반환합니다.

더 이상 사용되지 않음: log-get-keys

xe log-get-keys
<!--NeedCopy-->

로거가 알고 있는 키를 나열합니다.

더 이상 사용되지 않음: log-reopen

xe log-reopen
<!--NeedCopy-->

모든 로거를 다시 엽니다(파일 회전에 사용).

더 이상 사용되지 않음: log-set-output

xe log-set-output output=output [key=key] [level=level]
<!--NeedCopy-->

모든 로거를 지정된 출력(nil, stderr, string, file:파일 이름, syslog:기타)으로 설정합니다.

메시지 명령

메시지 작업에 사용되는 명령입니다. 메시지는 사용자에게 중요한 이벤트를 알려 주기 위해 생성되며 XenCenter에 경고로 표시됩니다.

표준 개체 나열 명령(xe message-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 메시지 개체를 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

메시지 매개 변수

message-create

xe message-create name=message_name body=message_text [[host-uuid=uuid_of_host] | [sr-uuid=uuid_of_sr] | [vm-uuid=uuid_of_vm] | [pool-uuid=uuid_of_pool]]
<!--NeedCopy-->

메시지를 생성합니다.

message-destroy

xe message-destroy [uuid=message_uuid]
<!--NeedCopy-->

기존 메시지를 삭제합니다. 모든 메시지를 삭제하는 스크립트를 작성할 수 있습니다. 예:

# Dismiss all alerts   \
    IFS=","; for m in $(xe message-list params=uuid --minimal); do  \
    xe message-destroy uuid=$m  \
    done
<!--NeedCopy-->

네트워크 명령

네트워크 작업에 사용되는 명령입니다.

네트워크 개체는 표준 개체 나열 명령(xe network-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

네트워크 매개 변수

네트워크에는 다음과 같은 매개 변수가 사용됩니다.

network-create

xe network-create name-label=name_for_network [name-description=descriptive_text]
<!--NeedCopy-->

네트워크를 생성합니다.

network-destroy

xe network-destroy uuid=network_uuid
<!--NeedCopy-->

기존 네트워크를 삭제합니다.

SR-IOV 명령

SR-IOV 작업을 위한 명령입니다.

network-sriov 개체는 표준 개체 나열 명령(xe network-sriov-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

SR-IOV 매개 변수

SR-IOV에 다음과 같은 매개 변수가 있습니다.

network-sriov-create

xe network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid
<!--NeedCopy-->

지정된 물리적 PIF에 대해 SR-IOV 네트워크 개체를 생성하고 물리적 PIF에서 SR-IOV를 활성화합니다.

network-sriov-destroy

xe network-sriov-destroy uuid=network_sriov_uuid
<!--NeedCopy-->

네트워크 SR-IOV 개체를 제거하고 물리적 PIF에서 SR-IOV를 비활성화합니다.

SR-IOV VF 할당

xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid
<!--NeedCopy-->

SR-IOV 네트워크에서 VM에 VF를 할당합니다.

SDN 컨트롤러 명령

SDN 컨트롤러 작업에 사용되는 명령입니다.

sdn-controller-forget

xe sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]
<!--NeedCopy-->

SDN 컨트롤러를 도입합니다.

sdn-controller-introduce

xe sdn-controller-forget uuid=uuid
<!--NeedCopy-->

SDN 컨트롤러를 제거합니다.

터널 명령

터널 작업에 사용되는 명령입니다.

tunnel-create

xe tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid
<!--NeedCopy-->

호스트에 새 터널을 만듭니다.

tunnel-destroy

xe tunnel-destroy uuid=uuid
<!--NeedCopy-->

터널을 삭제합니다.

패치 명령

패치 작업에 사용되는 명령입니다.

patch-apply

xe patch-apply uuid=patch_uuid host-uuid=host_uuid
<!--NeedCopy-->

이전에 업로드한 패치를 지정된 호스트에 적용합니다.

patch-clean

xe patch-clean uuid=uuid
<!--NeedCopy-->

이전에 업로드한 패치 파일을 삭제합니다.

patch-destroy

xe patch-destroy uuid=uuid
<!--NeedCopy-->

적용되지 않은 패치 레코드 및 파일을 서버에서 제거합니다.

patch-pool-apply

xe patch-pool-apply uuid=uuid
<!--NeedCopy-->

이전에 업로드한 패치를 풀의 모든 호스트에 적용합니다.

patch-pool-clean

xe patch-pool-clean uuid=uuid
<!--NeedCopy-->

풀의 모든 호스트에서 이전에 업로드한 패치 파일을 삭제합니다.

patch-precheck

xe patch-precheck uuid=uuid host-uuid=host_uuid
<!--NeedCopy-->

이전에 지정된 호스트에 업로드된 패치 내에 포함되어 있는 사전 검사를 실행합니다.

patch-upload

xe patch-upload file-name=file_name
<!--NeedCopy-->

패치 파일을 서버에 업로드합니다.

PBD 명령

PBD(물리적 블록 장치) 작업에 사용되는 명령입니다. PBD는 Citrix Hypervisor 서버에서 SR(스토리지 저장소)에 액세스하는 데 사용되는 소프트웨어 개체입니다.

PBD 개체는 표준 개체 나열 명령(xe pbd-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

PBD 매개 변수

PBD에는 다음과 같은 매개 변수가 사용됩니다.

pbd-create

xe pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]
<!--NeedCopy-->

Citrix Hypervisor 서버에서 PBD를 만듭니다. 읽기 전용 device-config 매개 변수는 만들 때만 설정할 수 있습니다.

‘path’에서 ‘/tmp’로의 매핑을 추가하려면 명령줄에 device-config:path=/tmp 인수가 포함되어 있는지 확인하십시오.

각 SR 형식에 지원되는 device-config 키/값 쌍의 전체 목록은 스토리지를 참조하십시오.

pbd-destroy

xe pbd-destroy uuid=uuid_of_pbd
<!--NeedCopy-->

지정된 PBD를 삭제합니다.

pbd-plug

xe pbd-plug uuid=uuid_of_pbd
<!--NeedCopy-->

PBD를 Citrix Hypervisor 서버에 연결하려고 시도합니다. 이 명령이 성공하면 참조된 SR(및 그 안에 포함된 VDI)이 Citrix Hypervisor 서버에 표시됩니다.

pbd-unplug

xe pbd-unplug uuid=uuid_of_pbd
<!--NeedCopy-->

Citrix Hypervisor 서버에서 PBD를 분리해 봅니다.

PIF 명령

PIF(물리적 네트워크 인터페이스를 나타내는 개체) 작업에 사용되는 명령입니다.

PIF 개체는 표준 개체 나열 명령(xe pif-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

PIF 매개 변수

PIF에는 다음과 같은 매개 변수가 사용됩니다.

참고:

PIF의 other-config 필드를 변경한 경우 재부팅해야 변경 내용이 적용됩니다. 또는 xe pif-unplug 및 xe pif-plug 명령을 사용하여 PIF 구성을 다시 작성할 수 있습니다.

pif-forget

xe pif-forget uuid=uuid_of_pif
<!--NeedCopy-->

특정 호스트에서 지정된 PIF 개체를 삭제합니다.

pif-introduce

xe pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버의 물리적 인터페이스를 나타내는 PIF 개체를 만듭니다.

pif-plug

xe pif-plug uuid=uuid_of_pif
<!--NeedCopy-->

지정된 물리적 인터페이스를 활성화하려고 시도합니다.

pif-reconfigure-ip

xe pif-reconfigure-ip uuid=uuid_of_pif [mode=dhcp|mode=static] gateway=network_gateway_address IP=static_ip_for_this_pif netmask=netmask_for_this_pif [DNS=dns_address]
<!--NeedCopy-->

PIF의 IP 주소를 수정합니다. 정적 IP 구성의 경우에는 mode 매개 변수를 static(으)로 설정하고 gateway, IP, netmask 매개 변수를 적절한 값으로 설정합니다. DHCP를 사용하려면 mode 매개 변수를 DHCP(으)로 설정하고 정적 매개 변수를 정의되지 않은 상태로 둡니다.

참고:

STP 고속 링크가 해제되어 있거나 지원되지 않는 스패닝 트리 프로토콜을 사용하여 스위치의 포트에 연결된 물리적 네트워크 인터페이스에 정적 IP 주소를 사용하면 트래픽이 없는 기간이 발생합니다.

pif-reconfigure-ipv6

xe pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]
<!--NeedCopy-->

PIF에서 IPv6 주소 설정을 다시 구성합니다.

pif-scan

xe pif-scan host-uuid=host_uuid
<!--NeedCopy-->

Citrix Hypervisor 서버에서 새로운 물리적 인터페이스를 검색합니다.

pif-set-primary-address-type

xe pif-set-primary-address-type  uuid=uuid primary_address_type=address_type
<!--NeedCopy-->

이 PIF에서 사용하는 기본 주소 유형을 변경합니다.

pif-unplug

xe pif-unplug uuid=uuid_of_pif
<!--NeedCopy-->

지정된 물리적 인터페이스를 비활성화하려고 시도합니다.

풀 명령

풀 작업에 사용되는 명령입니다. 풀은 하나 이상의 Citrix Hypervisor 서버로 구성된 집합입니다. 풀에서는 하나 이상의 공유 스토리지 저장소를 사용하여 풀의 한 호스트에서 실행 중인 VM을 풀의 다른 호스트로 거의 실시간으로 마이그레이션할 수 있습니다. 이 마이그레이션은 VM을 종료하고 백업할 필요 없이 VM이 계속 실행 중일 때 수행됩니다. 각 Citrix Hypervisor 서버는 기본적으로 단일 구성원으로 이루어진 풀입니다. Citrix Hypervisor 서버를 풀에 참가시키면 구성원으로 지정되며 참가한 풀이 풀의 마스터가 됩니다.

표준 개체 나열 명령(xe pool-list)을 사용하여 싱글톤 풀 개체를 나열할 수 있습니다. 매개 변수는 표준 매개 변수 명령으로 조작할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

풀 매개 변수

풀에는 다음과 같은 매개 변수가 사용됩니다.

pool-apply-edition

xe pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]
<!--NeedCopy-->

풀 전체에 에디션을 적용합니다.

pool-certificate-install

xe pool-certificate-install filename=file_name
<!--NeedCopy-->

풀 전체에 TLS 인증서를 설치합니다.

pool-certificate-list

xe pool-certificate-list
<!--NeedCopy-->

풀에 설치된 모든 TLS 인증서를 나열합니다.

pool-certificate-sync

xe pool-certificate-sync
<!--NeedCopy-->

풀 마스터에서 다른 풀 구성원으로 TLS 인증서 및 인증서 해지 목록을 동기화합니다.

pool-certificate-uninstall

xe pool-certificate-uninstall name=name
<!--NeedCopy-->

TLS 인증서를 제거합니다.

pool-crl-install

xe pool-crl-install filename=file_name
<!--NeedCopy-->

풀 전체에 TLS 인증서 해지 목록을 설치합니다.

pool-crl-list

xe pool-crl-list
<!--NeedCopy-->

설치된 모든 TLS 인증서 해지 목록을 나열합니다.

pool-crl-uninstall

xe pool-crl-uninstall name=name
<!--NeedCopy-->

TLS 인증서 해지 목록을 제거합니다.

pool-deconfigure-wlb

xe pool-deconfigure-wlb
<!--NeedCopy-->

Workload Balancing을 위한 구성을 영구적으로 제거합니다.

pool-designate-new-master

xe pool-designate-new-master host-uuid=uuid_of_new_master
<!--NeedCopy-->

지정된 구성원 Citrix Hypervisor 서버를 기존 풀의 마스터가 되도록 지정합니다. 이 명령을 실행하면 마스터 호스트 역할이 리소스 풀의 다른 호스트로 차례로 전달됩니다. 이 명령은 현재 마스터가 온라인 상태일 때만 작동합니다. 아래 나열된 비상 모드 명령을 대체하는 것은 아닙니다.

pool-disable-external-auth

xe pool-disable-external-auth [uuid=uuid] [config=config]
<!--NeedCopy-->

풀의 모든 호스트에서 외부 인증을 비활성화합니다.

pool-disable-local-storage-caching

xe pool-disable-local-storage-caching uuid=uuid
<!--NeedCopy-->

풀 전체에서 로컬 스토리지 캐싱을 비활성화합니다.

pool-disable-redo-log

xe pool-disable-redo-log
<!--NeedCopy-->

redo 로그를 사용 중인 경우 HA가 활성화되지 않은 한 이 로그를 비활성화합니다.

pool-dump-database

xe pool-dump-database file-name=filename_to_dump_database_into_(on_client)
<!--NeedCopy-->

전체 풀 데이터베이스의 복사본을 다운로드하고 클라이언트의 파일에 덤프합니다.

pool-enable-external-auth

xe pool-enable-external-auth  auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config]
<!--NeedCopy-->

풀의 모든 호스트에서 외부 인증을 활성화합니다. auth-type의 일부 값에는 특정 config: 값이 필요합니다.

pool-enable-local-storage-caching

xe pool-enable-local-storage-caching uuid=uuid
<!--NeedCopy-->

풀 전체에서 로컬 스토리지 캐싱을 활성화합니다.

pool-enable-redo-log

xe pool-enable-redo-log sr-uuid=sr_uuid
<!--NeedCopy-->

redo 로그를 사용 중인 경우 HA가 활성화되지 않은 한 지정된 SR에서 이 로그를 활성화합니다.

pool-eject

xe pool-eject host-uuid=uuid_of_host_to_eject
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버에 기존 풀을 종료하도록 지시합니다.

pool-emergency-reset-master

xe pool-emergency-reset-master master-address=address_of_pool_master
<!--NeedCopy-->

풀 구성원 서버에 마스터 서버 주소를 새 값으로 재설정하고 연결을 시도하도록 지시합니다. 마스터 서버에서는 이 명령을 실행하지 마십시오.

pool-emergency-transition-to-master

xe pool-emergency-transition-to-master
<!--NeedCopy-->

구성원에게 Citrix Hypervisor 서버가 풀 마스터가 되도록 지시합니다. Citrix Hypervisor 서버는 호스트가 비상 모드로 전환된 후에만 이 명령을 수락합니다. 비상 모드란 네트워크에서 마스터가 사라지고 여러 번 다시 시도한 후에도 연결할 수 없는 풀의 구성원임을 의미합니다.

호스트가 풀에 가입한 이후 호스트 암호가 수정된 경우 이 명령으로 인해 호스트의 암호가 재설정될 수 있습니다. 자세한 내용은 (사용자 명령)을 참조하십시오.

pool-ha-enable

xe pool-ha-enable heartbeat-sr-uuids=uuid_of_heartbeat_sr
<!--NeedCopy-->

지정된 SR UUID를 중앙 스토리지 하트비트 저장소로 사용하여 리소스 풀에서 고가용성을 사용합니다.

pool-ha-disable

xe pool-ha-disable
<!--NeedCopy-->

리소스 풀에서 고가용성 기능을 비활성화합니다.

pool-ha-compute-hypothetical-max-host-failures-to-tolerate

현재 풀 구성에서 허용할 최대 호스트 오류 수를 계산합니다.

pool-ha-compute-max-host-failures-to-tolerate

xe pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority]
<!--NeedCopy-->

제공 및 제안된 보호 VM에서 허용할 최대 호스트 오류 수를 계산합니다.

pool-initialize-wlb

xe pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password
<!--NeedCopy-->

대상 Workload Balancing 서버를 사용하여 현재 풀에 대한 Workload Balancing을 초기화합니다.

pool-join

xe pool-join master-address=address master-username=username master-password=password
<!--NeedCopy-->

Citrix Hypervisor 서버에 기존 풀에 가입하도록 지시합니다.

pool-management-reconfigure

xe pool-management-reconfigure [network-uuid=network-uuid]
<!--NeedCopy-->

XenCenter에 연결하는 데 사용되는 인터페이스인 지정된 네트워크 인터페이스를 사용하도록 풀에 있는 모든 호스트의 관리 인터페이스를 다시 구성합니다. 이 명령은 /etc/xensource-inventory에서 풀의 모든 호스트에 대해 MANAGEMENT_INTERFACE 키를 재작성합니다.

인터페이스의 장치 이름(IP 주소가 있어야 함)을 지정하면 Citrix Hypervisor 마스터 호스트에서 즉시 다시 바인딩합니다. 이 명령은 일반 모드와 긴급 모드에서 모두 작동합니다.

지정된 네트워크 UUID에서 PIF 개체의 UUID가 식별되고 다시 바인딩할 IP 주소를 결정하는 Citrix Hypervisor 서버에 매핑됩니다. 긴급 모드에서는 이 명령을 실행할 수 없습니다.

경고:

오프 호스트로 이 CLI 명령을 사용할 경우 주의해야 하며 새 인터페이스에 네트워크가 연결되어 있는지 확인해야 합니다. xe pif-reconfigure을(를) 사용하여 먼저 하나를 설정합니다. 그렇지 않으면 후속 CLI 명령이 Citrix Hypervisor 서버에 연결할 수 없습니다.

pool-recover-slaves

xe pool-recover-slaves
<!--NeedCopy-->

풀 마스터를 현재 긴급 모드에서 실행 중인 모든 구성원의 마스터 주소를 시도하여 다시 설정하도록 지시합니다. 이 명령은 일반적으로 pool-emergency-transition-to-master을(를) 사용하여 구성원 중 하나를 새 마스터로 설정한 후 사용됩니다.

pool-restore-database

xe pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]
<!--NeedCopy-->

pool-dump-database(으)로 만든 데이터베이스 백업을 풀에 업로드합니다. 업로드를 수신하면 마스터가 자체적으로 새 데이터베이스로 다시 시작됩니다.

실제로 작업을 수행하지 않고도 풀 데이터베이스를 복원할 수 있는지 확인할 수 있는 드라이 런 옵션도 있습니다. 기본적으로 dry-run은(는) false로 설정됩니다.

pool-retrieve-wlb-configuration

xe pool-retrieve-wlb-configuration
<!--NeedCopy-->

Workload Balancing 서버에서 풀 최적화 기준을 검색합니다.

pool-retrieve-wlb-diagnostics

xe pool-retrieve-wlb-diagnostics [filename=file_name]
<!--NeedCopy-->

Workload Balancing 서버에서 진단을 검색합니다.

pool-retrieve-wlb-recommendations

xe pool-retrieve-wlb-recommendations
<!--NeedCopy-->

Workload Balancing 서버에서 풀에 대한 VM 마이그레이션 권장 사항을 검색합니다.

pool-retrieve-wlb-report

xe pool-retrieve-wlb-report report=report [filename=file_name]
<!--NeedCopy-->

Workload Balancing 서버에서 보고서를 검색합니다.

pool-secret-rotate

xe pool-secret-rotate
<!--NeedCopy-->

풀 비밀을 교체합니다.

풀 비밀은 풀에 있는 서버 간에 공유되는 비밀로, 서버가 풀에 대한 멤버쉽을 증명할 수 있도록 합니다. 풀 관리자 역할이 있는 사용자는 SSH를 통해 서버에 연결할 때 이 암호를 볼 수 있습니다. 이러한 사용자 중 한 명이 조직을 떠나거나 풀 관리자 역할을 상실하는 경우 풀 비밀을 교체합니다.

pool-send-test-post

xe pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body
<!--NeedCopy-->

HTTPS를 사용하여 지정된 본문을 지정된 호스트 및 포트에 보내고 응답을 출력합니다. TLS 계층을 디버깅하는 데 사용됩니다.

pool-send-wlb-configuration

xe pool-send-wlb-configuration [config:=config]
<!--NeedCopy-->

Workload Balancing 서버에 대한 풀 최적화 기준을 설정합니다.

pool-sync-database

xe pool-sync-database
<!--NeedCopy-->

리소스 풀의 모든 호스트에서 풀 데이터베이스를 강제로 동기화합니다. 데이터베이스가 정기적으로 자동 복제되기 때문에 정상적인 작업에서는 이 명령이 필요하지 않습니다. 그러나 이 명령은 중요한 CLI 작업을 수행한 후 변경 사항이 신속하게 복제되도록 하는 데 유용할 수 있습니다.

igmp-snooping-enabled

xe pool-param-set [uuid=pool-uuid] [igmp-snooping-enabled=true|false]
<!--NeedCopy-->

Citrix Hypervisor 풀에서 IGMP 스누핑을 활성화 또는 비활성화합니다.

https-only

xe pool-param-set [uuid=pool-uuid] [https-only=true|false]
<!--NeedCopy-->

Citrix Hypervisor 호스트의 관리 인터페이스에서 포트 80의 차단을 활성화하거나 비활성화합니다.

PVS Accelerator 명령

PVS Accelerator 작업에 사용되는 명령입니다.

pvs-cache-storage-create

xe pvs-cache-storage-create sr-uuid=sr_uuid pvs-site-uuid=pvs_site_uuid size=size
<!--NeedCopy-->

지정된 호스트에 대해 지정된 SR에 PVS 캐시를 구성합니다.

pvs-cache-storage-destroy

xe pvs-cache-storage-destroy uuid=uuid
<!--NeedCopy-->

PVS 캐시를 제거합니다.

pvs-proxy-create

xe pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid
<!--NeedCopy-->

PVS 프록시를 사용하도록 VM/VIF를 구성합니다.

pvs-proxy-destroy

xe pvs-proxy-destroy uuid=uuid
<!--NeedCopy-->

이 VIF/VM에 대한 PVS 프록시를 제거(또는 해제)합니다

pvs-server-forget

xe pvs-server-forget uuid=uuid
<!--NeedCopy-->

PVS 서버를 지웁니다.

pvs-server-introduce

xe pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid
<!--NeedCopy-->

새로운 PVS 서버를 도입합니다.

pvs-site-forget

xe pvs-site-forget uuid=uuid
<!--NeedCopy-->

PVS 사이트를 지웁니다.

pvs-site-introduce

xe pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]
<!--NeedCopy-->

새로운 PVS 사이트를 도입합니다.

스토리지 관리자 명령

스토리지 관리자 플러그인 제어 명령

스토리지 관리자 객체는 표준 객체 나열 명령(xe sm-list)을 사용하여 나열할 수 있습니다. 매개 변수는 표준 매개 변수 명령으로 조작할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

SM 매개 변수

SM에는 다음과 같은 매개 변수가 사용됩니다.

스냅샷 명령

스냅샷 작업 명령.

snapshot-clone

xe snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]
<!--NeedCopy-->

가능한 경우 스토리지 수준의 빠른 디스크 클론 작업을 사용하여 기존 스냅샷을 복제하여 새 템플릿을 생성합니다.

snapshot-copy

xe snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]
<!--NeedCopy-->

스토리지 수준의 빠른 디스크 클론 작업을 사용하지 않고 기존 VM을 복사하여 새 템플릿을 생성합니다(사용 가능한 경우에도 해당). 복사된 VM의 디스크 이미지는 ‘전체 이미지’로 보장됩니다. 즉, Cow 체인의 일부가 아닙니다.

snapshot-destroy

xe snapshot-destroy  [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->

스냅샷을 제거합니다. 이렇게 하면 스냅샷과 연결된 스토리지가 그대로 유지됩니다. 스토리지도 삭제하려면 snapshot-install을 사용하십시오.

snapshot-disk-list

xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
<!--NeedCopy-->

선택한 VM의 디스크를 나열합니다.

snapshot-export-to-template

xe snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid  [preserve-power-state=true|false]
<!--NeedCopy-->

스냅샷을 파일 이름으로내보냅니다.

snapshot-reset-powerstate

xe snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->

관리 툴스택 데이터베이스에서만 VM 전원 상태를 강제로 중지합니다. 이 명령은 ‘중단됨’으로 표시된 스냅샷을 복구하는 데 사용됩니다. 이 작업은 잠재적으로 위험한 작업입니다. 메모리 이미지가 더 이상 필요하지 않은지 확인해야 합니다. 스냅샷을 더 이상 재개할 수 없습니다.

snapshot-revert

xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->

기존 VM을 이전 체크포인트 상태 또는 스냅샷 상태로 되돌립니다.

snapshot-uninstall

xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->

스냅샷을 제거합니다. 이 작업을 수행하면 RW로 표시되고 이 스냅샷에만 연결된 VDI가 제거됩니다. VM 레코드를 간단히 제거하려면 스냅샷 제거를 사용합니다.

SR 명령

SR(스토리지 저장소)을 제어하는 명령입니다.

SR 개체는 표준 개체 나열 명령(xe sr-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

SR 매개 변수

SR에는 다음과 같은 매개 변수가 사용됩니다.

sr-create

xe sr-create name-label=name physical-size=size type=type content-type=content_type device-config:config_name=value [host-uuid=host_uuid] [shared=true|false]
<!--NeedCopy-->

디스크에 SR을 만들어 데이터베이스에 도입한 다음 SR을 Citrix Hypervisor 서버에 연결하는 PBD를 만듭니다. shared을(를) true(으)로 설정하면 풀의 각 Citrix Hypervisor 서버에 대해 PBD가 만들어집니다. shared을(를) 지정하지 않거나 false(으)로 설정하면 host-uuid(으)로 지정된 Citrix Hypervisor 서버에 대해서만 PBD가 만들어집니다.

정확한 device-config 매개 변수는 장치 type에 따라 다릅니다. 다양한 스토리지 백엔드에서 이러한 매개 변수에 대한 자세한 내용은 SR 생성을 참조하십시오.

sr-data-source-forget

xe sr-data-source-forget data-source=data_source
<!--NeedCopy-->

SR에 대해 지정된 데이터 소스 기록을 중지하고 기록된 모든 데이터는 삭제하십시오.

sr-data-source-list

xe sr-data-source-list
<!--NeedCopy-->

SR에 대해 기록할 수 있는 데이터 소스를 나열합니다.

sr-data-source-query

xe sr-data-source-query data-source=data_source
<!--NeedCopy-->

SR 데이터 소스에서 읽은 마지막 값을 쿼리합니다.

sr-data-source-record

xe sr-data-source-record  data-source=data_source
<!--NeedCopy-->

SR에 대해 지정된 데이터 소스를 기록합니다.

sr-destroy

xe sr-destroy uuid=sr_uuid
<!--NeedCopy-->

Citrix Hypervisor 서버에서 지정된 SR을 삭제합니다.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->

지정된(공유된) SR에 대한 XAPI 데이터베이스 복제를 활성화합니다.

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->

지정된 SR에 대한 XAPI 데이터베이스 복제를 비활성화합니다.

sr-forget

xe sr-forget uuid=sr_uuid
<!--NeedCopy-->

XAPI 에이전트는 Citrix Hypervisor 서버의 지정된 SR을 잊어 버립니다. XAPI 에이전트가 SR을 잊어 버리면 SR이 분리되어 VDI에 액세스할 수 없지만 소스 미디어에는 그대로 유지됩니다(데이터가 손실되지 않음).

sr-introduce

xe sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid
<!--NeedCopy-->

SR 레코드를 데이터베이스에 배치하기만 하면 됩니다. device-config:parameter_key=parameter_value 양식으로 추가 매개 변수를 지정하는 데 device-config를 사용합니다. 예를 들면 다음과 같습니다.

xe sr-introduce device-config:device=/dev/sdb1
<!--NeedCopy-->

참고:

일반 작업에서는 이 명령이 절대 사용되지 않습니다. 이 고급 작업은 SR을 작성한 후 공유로 재구성해야 하거나 다양한 오류 시나리오에서 복구하는 데 도움이 되는 경우에 유용할 수 있습니다.

sr-probe

xe sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]
<!--NeedCopy-->

제공된 device-config 키를 사용하여 백엔드 스캔을 수행합니다. SR 백엔드에 대해 device-config이 완료된 경우 이 명령은 디바이스에 있는 SR의 목록을 반환합니다(있는 경우). device-config 매개 변수가 부분적인 경우 백엔드 전용 스캔이 수행되어 나머지 device-config 매개 변수를 개선하는 데 도움이 되는 결과를 반환합니다. 스캔 결과는 백엔드와 관련된 XML로 반환되며 CLI에 인쇄됩니다.

정확한 device-config 매개 변수는 장치 type에 따라 다릅니다. 서로 다른 스토리지 백엔드에서 이러한 매개 변수에 대한 자세한 내용은 스토리지를 참조하십시오.

sr-probe-ext

xe sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]
<!--NeedCopy-->

스토리지 프로브를 수행합니다. 장치 구성 매개 변수는 예를 들어 device-config:devs=/dev/sdb1로 지정할 수 있습니다. sr-probe와 달리 이 명령은 모든 SR 유형에 대해 동일한 사람이 읽을 수 있는 형식으로 결과를 반환합니다.

sr-scan

xe sr-scan uuid=sr_uuid
<!--NeedCopy-->

XAPI 데이터베이스를 기본 스토리지 기판에 있는 VDI와 동기화하여 SR 스캔을 강제 실행합니다.

sr-update

xe sr-update uuid=uuid
<!--NeedCopy-->

데이터베이스에서 SR 개체의 필드를 새로 고칩니다.

lvhd-enable-thin-provisioning

xe lvhd-enable-thin-provisioning  sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum
<!--NeedCopy-->

LVHD SR에서 씬 프로비저닝을 활성화합니다.

주제 명령

주제 작업을 위한 명령.

session-subject-identifier-list

xe session-subject-identifier-list
<!--NeedCopy-->

외부에서 인증된 모든 기존 세션의 모든 사용자 주체 ID 목록을 반환합니다.

session-subject-identifier-logout

xe session-subject-identifier-logout subject-identifier=subject_identifier
<!--NeedCopy-->

사용자 주체 ID와 연결된 모든 외부 인증 세션을 로그아웃합니다.

session-subject-identifier-logout-all

xe session-subject-identifier-logout-all
<!--NeedCopy-->

외부에서 인증된 모든 세션을 로그아웃합니다.

subject-add

xe subject-add subject-name=subject_name
<!--NeedCopy-->

풀에 액세스할 수 있는 주제 목록에 제목을 추가합니다.

subject-remove

xe subject-remove subject-uuid=subject_uuid
<!--NeedCopy-->

풀에 액세스할 수 있는 주제 목록에서 제목을 제거합니다.

subject-role-add

xe subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->

주제에 역할을 추가합니다.

subject-role-remove

xe subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->

주체에서 역할을 제거합니다.

secret-create

xe secret-create value=value
<!--NeedCopy-->

비밀을 만듭니다.

secret-destroy

xe secret-destroy uuid=uuid
<!--NeedCopy-->

비밀을 삭제합니다.

태스크 명령

오래 실행되는 비동기 작업에 사용되는 명령입니다. 이러한 명령은 가상 시스템 시작, 중지 및 일시 중단과 같은 작업입니다. 작업은 일반적으로 요청된 작업을 함께 수행하는 다른 원자 하위 작업 집합으로 구성됩니다.

작업 개체는 표준 개체 나열 명령(xe task-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

작업 매개 변수

작업에는 다음과 같은 매개 변수가 사용됩니다.

task-cancel

xe task-cancel [uuid=task_uuid]
<!--NeedCopy-->

지정된 작업을 취소하고 반환하도록 지정합니다.

템플릿 명령

VM 템플릿 작업에 사용되는 명령입니다.

템플릿은 기본적으로 is-a-template 매개 변수가 true(으)로 설정된 VM입니다. 템플릿은 특정 VM을 인스턴스화하기 위한 모든 다양한 구성 설정이 포함된 “원판”입니다. Citrix Hypervisor에는 OS 공급업체 설치 CD(예: RHEL, CentOS, SLES, Windows) 를 부팅할 수 있는 일반적인 “원시” VM인 기본 템플릿 세트가 함께 제공됩니다. VM을 만들고 특정 요구 사항에 맞게 표준 양식으로 구성한 다음 나중에 VM 배포에서 사용할 수 있도록 VM의 복사본을 템플릿으로 저장할 수 있습니다.

템플릿 개체는 표준 개체 나열 명령(xe template-list) 과 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

참고:

is-a-template 매개 변수를 false로 설정하여 템플릿을 VM으로 직접 변환할 수 없습니다. is-a-template 매개 변수를 false로 설정하면 지원되지 않으며 VM을 시작할 수 없습니다.

VM 템플릿 매개 변수

템플릿에는 다음과 같은 매개 변수가 사용됩니다.

• uuid(읽기 전용) 템플릿의 고유 식별자/개체 참조
• name-label(읽기/쓰기) 템플릿의 이름
• name-description(읽기/쓰기) 템플릿의 설명 문자열
• 버전 정보를 입력하기 위한 VM 및 템플릿 작성자를 위한 user-version(읽기/쓰기) 문자열

• is-a-template(읽기/쓰기) 이 VM이 템플릿인 경우 true입니다. 템플릿 VM은 시작할 수 없으며 다른 VM 복제에만 사용됩니다. 이 값을 true로 설정한 후에는 false로 재설정할 수 없습니다. 이 매개 변수를 사용하여 템플릿 VM을 VM으로 변환할 수 없습니다.

  다음을 사용하여 VM을 템플릿으로 변환할 수 있습니다.

   xe vm-param-set uuid=<vm uuid> is-a-template=true
   <!--NeedCopy-->
  

• is-control-domain(읽기 전용) 제어 도메인(도메인 0 또는 드라이버 도메인) 인 경우 true
• power-state(읽기 전용) 현재 전원 상태입니다. 템플릿에 대한 값은 항상 중지됩니다.
• memory-dynamic-max(읽기 전용) 동적 최대 메모리(바이트)입니다. 현재 사용되지 않지만 변경된 경우 다음 제약 조건을 준수해야 합니다. memory_static_max >= memory_dynamic_max >= memory_dynamic_min >= memory_static_min
• memory-dynamic-min(읽기/쓰기) 동적 최소 메모리(바이트) 현재 사용되지 않지만 변경된 경우 memory-dynamic-max에 대한 동일한 제약 조건을 준수해야 합니다.
• memory-static-max(읽기/쓰기) 정적으로 설정된 (절대) 최대 메모리(바이트) 이 필드는 VM에 할당된 메모리 양을 결정하는 데 사용되는 기본 값입니다.
• memory-static-min(읽기/쓰기) 정적으로 설정된 (절대) 최소 메모리(바이트) 이 필드는 절대 최소 메모리를 나타내며 memory-static-min는 memory-static-max보다 작아야 합니다. 이 값은 일반적인 작업에서는 사용되지 않지만 이전 제약 조건을 따라야 합니다.
• suspend-VDI-uuid(읽기 전용) 일시 중단 이미지가 저장된 VDI(템플릿에는 의미가 없음)

• VCPUs-params(읽기/쓰기 map 매개 변수) 선택한 vCPU 정책에 대한 구성 매개 변수

  다음을 사용하여 vCPU 고정을 조정할 수 있습니다.

   xe template-param-set uuid=<template_uuid> vCPUs-params:mask=1,2,3
   <!--NeedCopy-->
  

  이 템플릿에서 생성된 VM은 물리적 CPU 1, 2 및 3에서만 실행됩니다.

  또한 상한값 및 가중치 매개 변수를 사용하여 vCPU 우선 순위(xen 스케줄링) 를 조정할 수 있습니다. 예:

   xe template-param-set uuid=<template_uuid> VCPUs-params:weight=512 xe template-param-set uuid=<template_uuid> VCPUs-params:cap=100
   <!--NeedCopy-->
  

  가중치가 512인 이 템플릿을 기반으로 하는 VM은 경합 호스트에서 가중치가 256인 도메인보다 두 배 많은 CPU를 사용합니다. 적합한 가중치 범위는 1에서 65535 사이이며 기본값은 256입니다.

  이 캡은 Citrix Hypervisor 서버에 유휴 CPU 주기가 있는 경우에도 이 템플릿을 기반으로 VM이 사용할 수 있는 최대 CPU 양을 선택적으로 수정합니다. 상한선은 하나의 물리적 CPU에 대한 백분율로 표시됩니다. 즉, 100은 물리적 CPU 1개, CPU의 절반 50개, CPU 4개입니다. 기본값 0은 위쪽 상한이 없음을 의미합니다.

• VCPUs-max(읽기/쓰기) 최대 vCPU 수
• VCPUs-at-startup(읽기/쓰기) vCPU의 부트 번호
• actions-after-crash 이 템플릿을 기반으로 한 VM이 충돌할 때 수행할 (읽기/쓰기) 작업
• console-uuids(읽기 전용 설정 매개 변수) 가상 콘솔 기기

• platform(읽기/쓰기 map 매개 변수) 플랫폼별 구성

  HVM 게스트(예: Windows 게스트)에 대해 병렬 포트의 에뮬레이션을 사용하지 않도록 설정하려면 다음을 사용합니다.

   xe vm-param-set uuid=<vm_uuid> platform:parallel=none
   <!--NeedCopy-->
  

  HVM 게스트에 대해 직렬 포트의 에뮬레이션을 사용하지 않도록 설정하려면 다음을 사용합니다.

   xe vm-param-set uuid=<vm_uuid> platform:hvm_serial=none
   <!--NeedCopy-->
  

  HVM 게스트에 대해 USB 컨트롤러 및 USB 태블릿 장치의 에뮬레이션을 사용하지 않도록 설정하려면 다음을 사용합니다.

   xe vm-param-set uuid=<vm_uuid> platform:usb=false
   xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false
   <!--NeedCopy-->
  

• allowed-operations(읽기 전용 설정 매개 변수) 이 상태에서 허용되는 작업 목록
• current-operations(읽기 전용 설정 매개 변수) 이 템플릿에서 현재 진행 중인 작업 목록
• allowed-VBD-devices(읽기 전용 집합 매개 변수) 사용할 수 있는 VBD 식별자의 목록으로, 0—15 범위의 정수로 표시됩니다. 이 목록은 정보 제공용으로만 제공되며 다른 장치도 사용할 수 있습니다(작동하지 않을 수 있음).
• allowed-VIF-devices(읽기 전용 세트 매개 변수) 사용할 수 있는 VIF 식별자 목록으로, 0-15 범위의 정수로 표시됩니다. 이 목록은 정보 제공용으로만 제공되며 다른 장치도 사용할 수 있습니다(작동하지 않을 수 있음).
• HVM-boot-policy(읽기/쓰기) HVM 게스트에 대한 부팅 정책입니다. BIOS 순서 또는 빈 문자열입니다.
• HVM-boot-params(맵 읽기/쓰기 매개 변수) 순서 키는 HVM 게스트 부팅 순서를 제어합니다. 여기서 각 문자는 부팅 방법인 문자열로 표시됩니다. d는 CD/DVD의 경우, c는 루트 디스크, n은 네트워크 PXE 부트입니다. 기본값은 dc 입니다.
• 커널로의 PV-kernel(읽기/쓰기) 경로
• initrd(으)로의 PV-ramdisk (읽기/쓰기) 경로
• PV-args (읽기/쓰기) 커널 명령줄 인수의 문자열
• PV-legacy-args (읽기/쓰기) 이 템플릿 부팅을 기반으로 레거시 VM을 만들기 위한 인수 문자열
• PV-bootloader (읽기/쓰기) 부트로더의 이름 또는 경로
• PV-bootloader-args (읽기/쓰기) 부트로더의 기타 인수 문자열
• last-boot-CPU-flags (읽기 전용) 이 템플릿을 기반으로 하는 VM이 마지막으로 부팅된 CPU 플래그를 설명합니다. 템플릿용으로 채워지지 않았습니다.
• resident-on (읽기 전용) 이 템플릿을 기반으로 하는 VM이 상주하는 Citrix Hypervisor 서버입니다. 템플릿에 not in database로 표시됨
• affinity (읽기/쓰기) 이 템플릿을 기반으로 하는 VM이 실행에 대한 기본 설정을 갖는 Citrix Hypervisor 서버입니다. xe vm-start 명령으로 VM 실행 위치를 결정하는 데 사용됩니다.
• other-config (읽기/쓰기 map 매개 변수) 템플릿에 대한 추가 구성 매개 변수를 지정하는 키/값 쌍의 목록
• start-time (읽기 전용) 이 템플릿을 기반으로 한 VM에 대한 메트릭을 읽은 날짜 및 시간의 타임스탬프(yyyymmddThh:mm:ss z 형식)입니다. 여기서 z는 단일 문자로 된 군사 시간대 표시기입니다(예: UTC (GMT) 의 경우 Z). 템플릿에 대해 1 Jan 1970 Z(Unitx/POSIX epoch 시작)(으)로 설정
• install-time (읽기 전용) 이 템플릿을 기반으로 한 VM에 대한 메트릭을 읽은 날짜 및 시간의 타임스탬프(yyyymmddThh:mm:ss z 형식)입니다. 여기서 z는 단일 문자로 된 군사 시간대 표시기입니다(예: UTC (GMT) 의 경우 Z). 템플릿에 대해 1 Jan 1970 Z(Unitx/POSIX epoch 시작)(으)로 설정
• memory-actual (읽기 전용) 이 템플릿을 기반으로 VM에서 사용 중인 실제 메모리, 템플릿의 경우 0
• VCPUs-number (읽기 전용) 이 템플릿을 기반으로 VM에 할당된 가상 CPU 수, 템플릿의 경우 0
• VCPUs-Utilization (읽기 전용 맵 매개 변수) 가상 CPU 목록 및 해당 가중치 읽기 전용 맵 매개 변수 os-version는 이 템플릿을 기반으로 하는 VM의 운영 체제 버전입니다. 템플릿에 not in database로 표시됨
• PV-drivers-version (읽기 전용 맵 매개 변수) 이 템플릿을 기반으로 하는 VM의 반가상화된 드라이버 버전입니다. 템플릿에 not in database로 표시됨
• PV-drivers-detected (읽기 전용) 이 템플릿을 기반으로 하는 VM에 대한 최신 버전의 반가상화된 드라이버에 대한 플래그입니다. 템플릿에 not in database로 표시됨
• memory (읽기 전용 맵 매개 변수) 이 템플릿을 기반으로 VM에서 에이전트가 보고한 메모리 메트릭입니다. 템플릿에 not in database로 표시됨
• disks (읽기 전용 맵 매개 변수) 이 템플릿을 기반으로 VM에서 에이전트가 보고한 디스크 메트릭입니다. 템플릿에 not in database로 표시됨
• networks (읽기 전용 맵 매개 변수) 이 템플릿을 기반으로 VM에서 에이전트가 보고한 네트워크 메트릭입니다. 템플릿에 not in database로 표시됨
• other (읽기 전용 맵 매개 변수) 이 템플릿을 기반으로 VM에서 에이전트가 보고한 다른 지표입니다. 템플릿에 not in database로 표시됨
• guest-metrics-last-updated (읽기 전용) 게스트 내 에이전트가 이러한 필드에 마지막 쓰기를 수행한 시간 타임스탬프 yyyymmddThh:mm:ss z 형식에서 z는 단일 문자 군사 시간대 표시기입니다(예: UTC (GMT) 의 경우 Z)
• actions-after-shutdown (읽기/쓰기) VM이 종료된 후 수행할 작업
• actions-after-reboot (읽기/쓰기) VM이 재부팅된 후 수행할 작업
• possible-hosts 잠재적으로 VM을 호스팅할 수 있는 호스트 목록 (읽기 전용)
• HVM-shadow-multiplier (읽기/쓰기) 게스트가 사용할 수 있는 섀도우의 양에 적용되는 승수
• dom-id (읽기 전용) 도메인 ID (사용 가능한 경우, 그렇지 않으면 -1)
• recommendations (읽기 전용) 이 VM의 속성에 대한 권장 값 및 범위의 XML 사양
• xenstore-data(맵 읽기/쓰기 매개 변수) VM을 만든 후 xenstore 트리(/local/domain/*domid*/vmdata) 에 삽입할 데이터입니다.
• is-a-snapshot (읽기 전용) 이 템플릿이 VM 스냅샷인 경우 True
• snapshot_of (읽기 전용) 이 템플릿이 스냅샷인 VM의 UUID
• snapshots (읽기 전용) 이 템플릿에서 생성된 스냅샷의 UUID
• snapshot_time (읽기 전용) 가장 최근에 생성된 VM 스냅샷의 타임스탬프
• memory-target (읽기 전용) 이 템플릿에 대해 설정된 대상 메모리 양
• blocked-operations (맵 읽기/쓰기 매개 변수) 는 이 템플릿에서 수행할 수 없는 작업을 나열합니다.
• last-boot-record (읽기 전용) 이 템플릿의 마지막 부팅 매개 변수 레코드 (XML 형식)
• ha-always-run (읽기/쓰기) 이 템플릿의 인스턴스가 상주하는 호스트에 장애가 발생할 경우 항상 다른 호스트에서 다시 시작되는 경우 True입니다. 이 매개 변수는 이제 더 이상 사용되지 않습니다. 대신 ha-restartpriority 매개 변수를 사용하십시오.
• ha-restart-priority (읽기 전용) 재시작 또는 최선의 노력의 읽기/쓰기 Blob 바이너리 데이터 저장소
• live (읽기 전용) 실행 중인 VM에만 관련됩니다.

template-export

xe template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template
<!--NeedCopy-->

지정된 템플릿의 복사본을 지정된 새 파일 이름의 파일로 내보냅니다.

template-uninstall

xe template-uninstall template-uuid=template_uuid [--force]
<!--NeedCopy-->

사용자 지정 템플릿을 제거합니다. 이 작업은 이 템플릿에서 ‘소유’로 표시된 VDI를 제거합니다.

업데이트 명령

다음 섹션에서는 Citrix Hypervisor 서버 업데이트 명령에 대해 설명합니다.

업데이트 개체는 표준 개체 나열 명령 (xe update-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

매개 변수 업데이트

Citrix Hypervisor 서버 업데이트에는 다음과 같은 매개 변수가 있습니다.

update-upload

xe update-upload file-name=update_filename
<!--NeedCopy-->

지정된 업데이트 파일을 Citrix Hypervisor 서버에 업로드합니다. 이 명령은 적용할 업데이트를 준비합니다. 성공하면 업로드된 업데이트의 UUID가 인쇄됩니다. 업데이트가 이전에 업로드된 경우 UPDATE_ALREADY_EXISTS 오류가 반환되고 패치가 다시 업로드되지 않습니다.

update-precheck

xe update-precheck uuid=update_uuid host-uuid=host_uuid
<!--NeedCopy-->

지정된 Citrix Hypervisor 서버에서 지정된 업데이트에 포함된 사전 검사를 실행합니다.

update-destroy

xe update-destroy uuid=update_file_uuid
<!--NeedCopy-->

풀에서 적용되지 않은 업데이트 파일을 삭제합니다. 호스트에 적용할 수 없는 업데이트 파일을 삭제하는 데 사용할 수 있습니다.

update-apply

xe update-apply host-uuid=host_uuid uuid=update_file_uuid
<!--NeedCopy-->

지정된 업데이트 파일을 적용합니다.

update-pool-apply

xe update-pool-apply uuid=update_uuid
<!--NeedCopy-->

지정된 업데이트를 풀의 모든 Citrix Hypervisor 서버에 적용합니다.

update-introduce

xe update-introduce vdi-uuid=vdi_uuid
<!--NeedCopy-->

업데이트 VDI를 소개합니다.

update-pool-clean

xe update-pool-clean uuid=uuid
<!--NeedCopy-->

풀의 모든 호스트에서 업데이트 파일을 제거합니다.

사용자 명령

user-password-change

xe user-password-change old=old_password new=new_password
<!--NeedCopy-->

로그인한 사용자의 암호를 변경합니다. 이 명령을 사용하려면 감독자 권한이 필요하므로 이전 암호 필드는 선택되지 않습니다.

VBD 명령

VBD(가상 블록 장치) 작업에 사용되는 명령입니다.

VBD는 가상 디스크의 콘텐츠를 나타내는 VDI에 VM을 연결하는 소프트웨어 개체입니다. VBD에는 VDI를 VM에 연결하는 속성 (부팅 가능, 읽기/쓰기 메트릭 등) 이 있습니다. VDI에는 가상 디스크의 물리적 특성 (SR 유형, 디스크 공유 가능 여부, 미디어가 읽기/쓰기 또는 읽기 전용인지 여부 등) 에 대한 정보가 있습니다.

VBD 개체는 표준 개체 나열 명령 (xe vbd-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

VBD 매개 변수

VBD에는 다음과 같은 매개 변수가 사용됩니다.

vbd-create

xe vbd-create vm-uuid=uuid_of_the_vm device=device_value vdi-uuid=uuid_of_vdi_to_connect_to [bootable=true] [type=Disk|CD] [mode=RW|RO]
<!--NeedCopy-->

VM에서 VBD를 생성합니다.

device 필드에 허용되는 값은 정수 0—15이며 숫자는 각 VM에 대해 고유해야 합니다. 현재 허용 가능한 값은 지정된 VM의 allowed-VBD-devices 매개 변수에서 확인할 수 있습니다. 이는 vbd 매개 변수에 userdevice(으)로 표시됩니다.

type이 Disk인 경우 vdi-uuid가 필요합니다. 모드는 RO 또는 RW 디스크일 수 있습니다.

type이 CD인 경우 vdi-uuid는 선택 사항입니다. VDI를 지정하지 않으면 CD에 대해 빈 VBD가 생성됩니다. 모드는 CD용 RO여야 합니다.

vbd-destroy

xe vbd-destroy uuid=uuid_of_vbd
<!--NeedCopy-->

지정된 VBD를 제거합니다.

VBD의 other-config:owner 매개 변수가 true(으)로 설정되어 있으면 연결된 VDI도 삭제됩니다.

vbd-eject

xe vbd-eject uuid=uuid_of_vbd
<!--NeedCopy-->

VBD로 표현된 드라이브에서 미디어를 제거합니다. 이 명령은 미디어가 이동식 유형 (물리적 CD 또는 ISO) 인 경우에만 작동합니다. 그렇지 않으면 VBD_NOT_REMOVABLE_MEDIA 오류 메시지가 반환됩니다.

vbd-insert

xe vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media
<!--NeedCopy-->

VBD로 표현된 드라이브에 새 미디어를 넣습니다. 이 명령은 미디어가 이동식 유형 (물리적 CD 또는 ISO) 인 경우에만 작동합니다. 그렇지 않으면 VBD_NOT_REMOVABLE_MEDIA 오류 메시지가 반환됩니다.

vbd-plug

xe vbd-plug uuid=uuid_of_vbd
<!--NeedCopy-->

VM이 실행 중인 상태에서 VBD를 연결합니다.

vbd-unplug

xe vbd-unplug uuid=uuid_of_vbd
<!--NeedCopy-->

VM이 실행 중인 상태에서 VBD를 분리합니다.

VDI 명령

VDI(가상 디스크 이미지) 작업에 사용되는 명령입니다.

VDI는 VM에서 볼 수 있는 가상 디스크의 내용을 나타내는 소프트웨어 개체입니다. 이는 VM을 VDI에 연결하는 개체인 VBD와는 다릅니다. VDI에는 가상 디스크의 물리적 특성 (SR 유형, 디스크 공유 가능 여부, 미디어가 읽기/쓰기 또는 읽기 전용인지 여부 등) 에 대한 정보가 있습니다. VBD에는 VDI를 VM에 연결하는 속성이 있습니다(부팅 가능, 읽기/쓰기 메트릭 등).

VDI 개체는 표준 개체 나열 명령 (xe vdi-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

VDI 매개 변수

VDI에는 다음과 같은 매개 변수가 사용됩니다.

vdi-clone

xe vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]
<!--NeedCopy-->

직접 사용할 수 있는 지정된 VDI의 쓰기 가능 복사본을 새로 만듭니다. 고속 이미지 복제 시설이 존재하는 곳에 노출 될 수 있는 vdi-copy의 변형입니다.

선택적 driver-params map 매개 변수를 사용하여 추가 공급업체별 구성 정보를 VDI의 기반이 되는 백엔드 스토리지 드라이버에 전달합니다. 자세한 내용은 저장소 공급업체 드라이버 설명서를 참조하십시오.

vdi-copy

xe vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr
<!--NeedCopy-->

VDI를 지정된 SR에 복사합니다.

vdi-create

xe vdi-create sr-uuid=uuid_of_sr_to_create_vdi_on name-label=name_for_the_vdi type=system|user|suspend|crashdump virtual-size=size_of_virtual_disk sm-config-*=storage_specific_configuration_data
<!--NeedCopy-->

VDI를 생성합니다.

virtual-size 매개 변수는 바이트 단위로 지정하거나 IEC 표준 접미사 KiB, MiB, GiB 및 TiB를 사용하여 지정할 수 있습니다.

참고:

디스크의 씬 프로비저닝을 지원하는 SR 유형(예: 로컬 VHD 및 NFS)에서는 디스크의 가상 할당을 강제하지 않습니다. SR에서 가상 디스크 공간을 과도하게 할당할 때는 주의해야 합니다. 과도하게 할당된 SR이 가득 차면 SR 대상 기판에서 또는 SR에서 사용되지 않는 VDI를 삭제하여 디스크 공간을 사용할 수 있어야 합니다.

일부 SR 유형은 virtual-size 값을 반올림하여 구성된 블록 크기로 나눌 수 있습니다.

vdi-data-destroy

xe vdi-data-destroy uuid=uuid_of_vdi
<!--NeedCopy-->

지정된 VDI와 연결된 데이터를 삭제하되 변경된 블록 추적 메타데이터는 유지합니다.

참고:

변경된 블록 추적을 사용하여 VDI의 증분 백업을 수행하는 경우 vdi-data-destroy 명령을 사용하여 스냅샷을 삭제하되 메타데이터는 유지해야 합니다. 블록 추적을 사용하도록 변경한 VDI의 스냅샷에는 vdi-destroy를 사용하지 마십시오.

vdi-destroy

xe vdi-destroy uuid=uuid_of_vdi
<!--NeedCopy-->

지정된 VDI를 삭제합니다.

참고:

변경된 블록 추적을 사용하여 VDI의 증분 백업을 수행하는 경우 vdi-data-destroy 명령을 사용하여 스냅샷을 삭제하되 메타데이터는 유지해야 합니다. 블록 추적을 사용하도록 변경한 VDI의 스냅샷에는 vdi-destroy를 사용하지 마십시오.

로컬 VHD 및 NFS SR 유형의 경우 vdi-destroy에서 디스크 공간이 즉시 해제되지 않고 스토리지 저장소 검색 작업을 진행하는 동안 주기적으로 해제됩니다. 삭제된 디스크 공간을 강제로 사용할 수 있도록 해야 하는 경우 sr-scan를 수동으로 호출합니다.

vdi-disable-cbt

xe vdi-disable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->

VDI에 대해 변경된 블록 추적을 비활성화합니다.

vdi-enable-cbt

xe vdi-enable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->

VDI에 대해 변경된 블록 추적을 활성화합니다.

참고:

Citrix Hypervisor 프리미엄 에디션의 라이선스가 부여된 인스턴스에서만 변경된 블록 추적을 활성화할 수 있습니다.

vdi-export

xe vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi] [--progress]
<!--NeedCopy-->

VDI를 지정된 파일 이름으로 내보냅니다. VDI를 다음 형식 중 하나로 내보낼 수 있습니다.

• raw
• vhd

VHD 형식은 스파스일 수 있습니다. VDI 내에 할당되지 않은 블록이 있는 경우 이러한 블록이 VHD 파일에서 생략될 수 있으므로 VHD 파일의 크기가 더 작아집니다. 지원되는 모든 VHD 기반 스토리지 유형 (EXT3/EXT4, NFS) 에서 VHD 형식으로 내보낼 수 있습니다.

base 매개 변수를 지정하면 이 명령은 내보낸 VDI와 기준 VDI 간에 변경된 블록만 내보냅니다.

vdi-forget

xe vdi-forget uuid=uuid_of_vdi
<!--NeedCopy-->

스토리지 백엔드를 건드리지 않고 데이터베이스에서 VDI 레코드를 무조건 제거합니다. 정상 작동 시에는 vdi-destroy를 대신 사용하십시오.

vdi-import

xe vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]
<!--NeedCopy-->

VDI를 가져옵니다. 다음 형식 중 하나에서 VDI를 가져올 수 있습니다.

• raw
• vhd

vdi-introduce

xe vdi-introduce uuid=uuid_of_vdi sr-uuid=uuid_of_sr name-label=name_of_new_vdi type=system|user|suspend|crashdump location=device_location_(varies_by_storage_type) [name-description=description_of_vdi] [sharable=yes|no] [read-only=yes|no] [other-config=map_to_store_misc_user_specific_data] [xenstore-data=map_to_of_additional_xenstore_keys] [sm-config=storage_specific_configuration_data]
<!--NeedCopy-->

실제로 스토리지를 수정하거나 만들지 않고 기존 스토리지 장치를 나타내는 VDI 개체를 만듭니다. 이 명령은 주로 내부적으로 핫 플러그된 스토리지 디바이스를 자동으로 도입하는 데 사용됩니다.

vdi-list-changed-blocks

xe vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid
<!--NeedCopy-->

두 VDI를 비교하고 둘 사이에 변경된 블록 목록을 base64로 인코딩된 문자열로 반환합니다. 이 명령은 블록 추적을 사용하도록 변경한 vDI에 대해서만 작동합니다.

자세한 내용은 변경된 블록 추적을 참조하십시오.

vdi-pool-migrate

xe vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid
<!--NeedCopy-->

VDI가 실행 중인 게스트에 연결되어 있는 동안 VDI를 지정한 SR로 마이그레이션합니다. (스토리지 라이브 마이그레이션)

자세한 내용은 VM 마이그레이션을 참조하십시오.

vdi-resize

xe vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk
<!--NeedCopy-->

UUID로 지정된 VDI의 크기를 변경합니다.

vdi-snapshot

xe vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]
<!--NeedCopy-->

백업 또는 템플릿 생성 목적 또는 둘 다에 대한 참조로 사용할 수 있는 VDI의 읽기/쓰기 버전을 생성합니다. VM 내에 백업 소프트웨어를 설치하고 실행하는 대신 스냅샷을 사용하여 백업을 수행합니다. 외부 백업 소프트웨어가 스냅샷의 콘텐츠를 백업 미디어로 스트리밍하는 동안 VM은 계속 실행됩니다. 마찬가지로 스냅샷은 템플릿의 기반이 되는 “골드 이미지”로 사용할 수 있습니다. 템플릿은 모든 VDI를 사용하여 만들 수 있습니다.

선택적 driver-params map 매개 변수를 사용하여 추가 공급업체별 구성 정보를 VDI의 기반이 되는 백엔드 스토리지 드라이버에 전달합니다. 자세한 내용은 저장소 공급업체 드라이버 설명서를 참조하십시오.

스냅샷의 클론은 항상 쓰기 가능한 VDI를 생성합니다.

vdi-unlock

xe vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]
<!--NeedCopy-->

지정된 VDI의 잠금을 해제합니다. force=true가 명령에 전달되면 잠금 해제 작업이 강제로 수행됩니다.

vdi-update

xe vdi-update uuid=uuid
<!--NeedCopy-->

데이터베이스에서 VDI 개체의 필드를 새로 고칩니다.

VIF 명령

VIF(가상 네트워크 인터페이스) 작업에 사용되는 명령입니다.

VIF 개체는 표준 개체 나열 명령(xe vif-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

VIF 매개 변수

VIF에는 다음과 같은 매개 변수가 사용됩니다.

• uuid (읽기 전용) VIF에 대한 고유 식별자/개체 참조
• vm-uuid (읽기 전용) 이 VIF가 상주하는 VM의 고유 식별자/개체 참조
• vm-name-label (읽기 전용) 이 VIF가 상주하는 VM의 이름
• allowed-operations (읽기 전용 설정 매개 변수) 이 상태에서 허용되는 작업 목록
• current-operations (읽기 전용 집합 매개 변수) 이 VIF에서 현재 진행 중인 작업 목록
• device (읽기 전용) 이 VIF의 정수 레이블로, VIF 백엔드가 만들어진 순서를 나타냅니다.
• MAC (읽기 전용) VM에 노출된 VIF의 MAC 주소

• MTU (읽기 전용) VIF의 최대 전송 단위 (바이트)

  이 매개 변수는 읽기 전용이지만 other-config map 매개 변수를 사용하여 MTU 설정을 mtu 키로 재정의할 수 있습니다. 예를 들어 점보 프레임을 사용하도록 가상 NIC에서 MTU를 재설정하려면 다음을 수행하십시오.

   xe vif-param-set \
       uuid=<vif_uuid> \
       other-config:mtu=9000
   <!--NeedCopy-->
  

• currently-attached (읽기 전용) 디바이스가 연결된 경우 true
• qos_algorithm_type (읽기/쓰기) 사용할 QoS 알고리즘
• qos_algorithm_params (읽기/쓰기 map 매개 변수) 선택한 QoS 알고리즘에 대한 매개 변수
• qos_supported_algorithms (읽기 전용 집합 매개 변수) 이 VIF에 대해 지원되는 QoS 알고리즘
• MAC-autogenerated (읽기 전용) VIF의 MAC 주소가 자동으로 생성된 경우 True입니다.
• other-config(읽기/쓰기 map 매개 변수) 추가 구성 key:value 쌍
• other-config:ethtoolrx (읽기/쓰기) 체크섬 수신을 활성화하려면 on으로 설정하고 해제하려면 off로 설정합니다.
• other-config:ethtooltx (읽기/쓰기) 체크섬 전송을 활성화하려면 on으로 설정하고 해제하려면 off로 설정합니다.
• other-config:ethtoolsg (읽기/쓰기) 분산 수집을 활성화하려면 on으로 설정하고 해제하려면 off로 설정합니다.
• other-config:ethtooltso (읽기/쓰기) TCP 세분화 오프로드를 활성화하려면 on으로 설정하고 해제하려면 off로 설정합니다.
• other-config:ethtoolufo (읽기/쓰기) UDP 조각 오프로드를 활성화하려면 on으로 설정하고 해제하려면 off로 설정합니다.
• other-config:ethtoolgso (읽기/쓰기) 일반 세그멘테이션 오프로드를 활성화하려면 on으로 설정하고 해제하려면 off로 설정합니다.
• other-config:promiscuous (읽기/쓰기) 브리지에서 무차별 처리되도록 VIF에 true로 설정하면 브리지를 통해 모든 트래픽이 표시됩니다. VM에서 침입 탐지 시스템 (IDS) 또는 이와 유사한 시스템을 실행하는 데 유용합니다.
• network-uuid (읽기 전용) 이 VIF가 연결된 가상 네트워크의 고유 식별자/개체 참조
• network-name-label (읽기 전용) 이 VIF가 연결된 가상 네트워크의 설명 이름
• io_read_kbs (읽기 전용) 이 VIF에 대한 평균 읽기 속도 (KB/초)
• io_write_kbs (읽기 전용) 이 VIF에 대한 평균 쓰기 속도 (KB/초)
• locking_mode (읽기/쓰기) MAC 및 IP 주소 목록으로부터의 트래픽을 필터링하는 VIF 기능에 영향을 줍니다. 추가 매개 변수가 필요합니다.

• locking_mode:default (읽기/쓰기) VIF 네트워크의 기본 잠금 모드에 따라 달라집니다.

  기본 잠금 모드가 disabled(으)로 설정된 경우 Citrix Hypervisor는 VIF가 트래픽을 보내거나 받을 수 없도록 필터링 규칙을 적용합니다. 기본 잠금 모드가 unlocked(으)로 설정된 경우 Citrix Hypervisor는 VIF와 연결된 모든 필터링 규칙을 제거합니다. 자세한 내용은 네트워크 명령을 참조하십시오.

• locking_mode:locked (읽기/쓰기) 지정된 MAC 및 IP 주소로 보내거나 보낸 트래픽만 VIF에서 허용됩니다. IP 주소를 지정하지 않으면 트래픽이 허용되지 않습니다.
• locking_mode:unlocked (읽기/쓰기) VIF에서 주고가는 트래픽에는 필터가 적용되지 않습니다.
• locking_mode:disabled (읽기/쓰기) Citrix Hypervisor는 VIF가 모든 트래픽을 삭제하도록 필터링 규칙을 적용합니다.

vif-create

xe vif-create vm-uuid=uuid_of_the_vm device=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]
<!--NeedCopy-->

VM에서 VIF를 만듭니다.

device 필드에 적합한 값이 지정된 VM의 allowed-VIF-devices 매개 변수에 나열됩니다. VIF가 존재하기 전에 허용되는 값은 0-15의 정수입니다.

mac 매개 변수는 aa:bb:cc:dd:ee:ff 양식의 표준 MAC 주소입니다. 지정되지 않은 상태로 두면 적절한 임의의 MAC 주소가 생성됩니다. mac=random를 지정하여 임의의 MAC 주소를 명시적으로 설정할 수도 있습니다.

vif-destroy

xe vif-destroy uuid=uuid_of_vif
<!--NeedCopy-->

VIF를 삭제하십시오.

vif-move

xe vif-move uuid=uuid network-uuid=network_uuid
<!--NeedCopy-->

VIF를 다른 네트워크로 이동합니다.

vif-plug

xe vif-plug uuid=uuid_of_vif
<!--NeedCopy-->

VM이 실행 중인 상태에서 VIF를 연결합니다.

vif-unplug

xe vif-unplug uuid=uuid_of_vif
<!--NeedCopy-->

VM이 실행 중인 상태에서 VIF를 분리합니다.

vif-configure-ipv4

이 가상 인터페이스에 대한 IPv4 설정을 구성합니다. 아래와 같이 IPv4 설정을 지정합니다.

xe vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address
<!--NeedCopy-->

예:

VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")
<!--NeedCopy-->

아래와 같이 IPv4 설정을 지웁니다.

xe vif-configure-ipv4 uuid=uuid_of_vif mode=none
<!--NeedCopy-->

vif-configure-ipv6

이 가상 인터페이스에 대한 IPv6 설정을 구성합니다. 아래와 같이 IPv6 설정을 지정합니다.

xe vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address
<!--NeedCopy-->

예:

VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")
<!--NeedCopy-->

아래와 같이 IPv6 설정을 지웁니다.

xe vif-configure-ipv6 uuid=uuid_of_vif mode=none
<!--NeedCopy-->

VLAN 명령

VLAN (가상 네트워크) 작업 명령. 가상 인터페이스를 나열하고 편집하려면 연결된 가상 네트워크가 있음을 알리는 VLAN 매개 변수가 있는 PIF 명령을 참조하십시오. 자세한 내용은 PIF 명령을 참조하십시오. 예를 들어 VLAN을 나열하려면 xe pif-list를 사용합니다.

vlan-create

xe vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->

Citrix Hypervisor 서버에서 VLAN을 만듭니다.

pool-vlan-create

xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->

지정된 네트워크가 각 호스트에 있는 인터페이스(예: eth0)를 확인하고 그에 따라 호스트마다 새 PIF 개체를 만들고 연결하여 풀의 모든 호스트에 VLAN을 만듭니다.

vlan-destroy

xe vlan-destroy uuid=uuid_of_pif_mapped_to_vlan
<!--NeedCopy-->

VLAN을 삭제합니다. VLAN을 나타내는 PIF의 UUID가 필요합니다.

VM 명령

VM과 해당 특성을 제어하는 데 사용되는 명령입니다.

VM 선택기

여기에 나열된 몇 가지 명령에는 작업을 수행할 하나 이상의 VM을 선택하는 일반적인 메커니즘이 있습니다. 가장 간단한 방법은 vm=name_or_uuid 인수를 제공하는 것입니다. 실제 VM의 UUID를 얻는 쉬운 방법은 예를 들어 xe vm-list power-state=running를 실행하는 것입니다. (xe vm-list params=all 명령을 사용하여 일치시킬 수 있는 필드의 전체 목록을 가져옵니다.) 예를 들어 power-state=halted을(를) 지정하면 power-state 매개 변수가 halted인 VM이 선택됩니다. 여러 VM이 일치하는 경우 작업을 수행하는 --multiple 옵션을 지정합니다. 일치할 수 있는 전체 매개 변수 목록은 이 섹션의 시작 부분에 설명되어 있습니다.

VM 개체는 표준 개체 나열 명령(xe vm-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

VM 매개 변수

VM에는 다음과 같은 매개 변수가 사용됩니다.

참고:

VM이 실행되는 동안 모든 쓰기 가능한 VM 매개 변수 값을 변경할 수 있지만 새 매개 변수는 동적으로 적용되지 않으며 VM이 재부팅될 때까지 적용할 수 없습니다.

• appliance(읽기/쓰기) VM이 속한 어플라이언스/vApp
• uuid (읽기 전용) VM의 고유 식별자/개체 참조
• name-label (읽기/쓰기) VM 이름
• name-description (읽기/쓰기) VM의 설명 문자열
• order (읽기/쓰기) vApp 시작/종료 및 HA 페일오버 후 시작용 순서 값이 0(영) 인 VM이 먼저 시작된 다음 순서 값이 1인 VM이 시작됩니다.
• version (읽기 전용) 이 VM이 복구된 횟수입니다. 새 VM을 이전 버전으로 덮어쓰려면 vm-recover를 호출합니다.
• 버전 정보를 입력하기 위한 VM 및 템플릿 작성자를 위한 user-version(읽기/쓰기) 문자열

• is-a-template (읽기/쓰기) 이 VM이 템플릿이 아닌 경우 False입니다. 템플릿 VM은 시작할 수 없으며 다른 VM 복제에만 사용됩니다. 이 값을 true로 설정한 후에는 false로 재설정할 수 없습니다. 이 매개 변수를 사용하여 템플릿 VM을 VM으로 변환할 수 없습니다.

  다음을 사용하여 VM을 템플릿으로 변환할 수 있습니다.

   xe vm-param-set uuid=<vm uuid> is-a-template=true
   <!--NeedCopy-->
  

• is-control-domain (읽기 전용) 제어 도메인 (도메인 0 또는 드라이버 도메인) 인 경우 True
• power-state (읽기 전용) 현재 전원 상태
• start-delay (읽기/쓰기) VM 시작 호출이 반환되기 전에 대기할 지연(초)
• shutdown-delay (읽기/쓰기) VM 종료 호출이 반환되기 전에 대기할 지연(초)
• memory-dynamic-max (읽기/쓰기) 동적 최대값 (바이트)
• memory-dynamic-min (읽기/쓰기) 동적 최소값 (바이트)
• memory-static-max (읽기/쓰기) 정적으로 설정된 (절대) 최대값 (바이트) 이 값을 변경하려면 VM을 종료해야 합니다.
• memory-static-min (읽기/쓰기) 정적으로 설정된 (절대) 최소값 (바이트) 이 값을 변경하려면 VM을 종료해야 합니다.
• suspend-VDI-uuid (읽기 전용) 일시 중단 이미지가 저장된 VDI

• VCPUs-params (읽기/쓰기 map 매개 변수) 선택한 vCPU 정책에 대한 구성 매개 변수

  다음을 사용하여 vCPU의 피닝을 조정할 수 있습니다.

   xe vm-param-set uuid=<vm_uuid> VCPUs-params:mask=1,2,3
   <!--NeedCopy-->
  

  그러면 선택한 VM이 물리적 CPU 1, 2 및 3에서만 실행됩니다. 또한 상한값 및 가중치 매개 변수를 사용하여 vCPU 우선 순위 (xen 스케줄링) 를 조정할 수 있습니다. 예:

   xe vm-param-set uuid=<vm_uuid> VCPUs-params:weight=512 xe vm-param-set uuid=<vm_uuid> VCPUs-params:cap=100
   <!--NeedCopy-->
  

  가중치가 512인 VM은 경합된 Citrix Hypervisor 서버에서 가중치가 256인 도메인보다 두 배 많은 CPU를 사용합니다. 적합한 가중치 범위는 1에서 65535 사이이며 기본값은 256입니다. 이 상한은 Citrix Hypervisor 서버에 유휴 CPU 주기가 있는 경우에도 VM이 소비할 수 있는 최대 CPU 양을 선택적으로 수정합니다. 상한선은 하나의 물리적 CPU에 대한 백분율로 표시됩니다. 즉, 100은 물리적 CPU 1개, CPU의 절반 50개, CPU 4개입니다. 기본값 0은 위쪽 상한이 없음을 의미합니다.

• VCPUs-max (읽기/쓰기) 최대 가상 CPU 수.
• VCPUs-at-startup (읽기/쓰기) 가상 CPU의 부팅 번호
• actions-after-crash (읽기/쓰기) VM이 충돌하는 경우 수행할 작업 PV 게스트의 경우 유효한 매개 변수는 다음과 같습니다.
  • preserve (분석에만 해당)
  • coredump_and_restart (코어 덤프 기록 및 VM 재부팅)
  • coredump_and_destroy (코어 덤프를 기록하고 VM을 중단된 상태로 둠)
  • restart (코어 덤프 및 VM을 다시 시작하지 않음)
  • destroy (코어 덤프가 없고 VM이 중단된 상태로 유지됨)
• console-uuids (읽기 전용 설정 매개 변수) 가상 콘솔 기기

• platform (읽기/쓰기 map 매개 변수) 플랫폼별 구성

  VDA를 사용하지 않도록 설정하여 Windows 10을 태블릿 모드로 전환하려면 다음을 수행하십시오.

   xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=0
   <!--NeedCopy-->
  

  VDA가 Windows 10을 태블릿 모드로 전환할 수 있도록 하려면 다음을 수행하십시오.

   xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=1
   <!--NeedCopy-->
  

  현재 상태를 확인하려면 다음을 수행하십시오.

   xe vm-param-get uuid=<vm_uuid> param-name=platform param-key=acpi_laptop_slate
   <!--NeedCopy-->
  

• allowed-operations (읽기 전용 설정 매개 변수) 이 상태에서 허용되는 작업 목록
• current-operations (읽기 전용 설정 매개 변수) VM에서 현재 진행 중인 작업 목록
• allowed-VBD-devices (읽기 전용 집합 매개 변수) 사용할 수 있는 VBD 식별자의 목록으로, 0—15 범위의 정수로 표시됩니다. 이 목록은 정보 제공용으로만 제공되며 다른 장치도 사용할 수 있습니다(작동하지 않을 수 있음).
• allowed-VIF-devices (읽기 전용 세트 매개 변수) 사용할 수 있는 VIF 식별자 목록으로, 0-15 범위의 정수로 표시됩니다. 이 목록은 정보 제공용으로만 제공되며 다른 장치도 사용할 수 있습니다(작동하지 않을 수 있음).
• HVM-boot-policy (읽기/쓰기) HVM 게스트에 대한 부팅 정책입니다. BIOS 순서 또는 빈 문자열입니다.
• HVM-boot-params (맵 읽기/쓰기 매개 변수) 순서 키는 HVM 게스트 부팅 순서를 제어합니다. 여기서 각 문자는 부팅 방법인 문자열로 표시됩니다. d는 CD/DVD의 경우, c는 루트 디스크, n은 네트워크 PXE 부트입니다. 기본값은 dc 입니다.
• HVM-shadow-multiplier (읽기/쓰기) VM을 부여하기 위한 섀도 메모리 오버헤드의 양을 제어하는 부동 소수점 값입니다. 기본값은 1.0(최소값)이며 고급 사용자일 경우에만 이 값을 변경합니다.
• 커널로의 PV-kernel(읽기/쓰기) 경로
• initrd(으)로의 PV-ramdisk(읽기/쓰기) 경로
• PV-args (읽기/쓰기) 커널 명령줄 인수의 문자열
• PV-legacy-args (읽기/쓰기) 레거시 VM을 부팅하기 위한 인수 문자열
• PV-bootloader (읽기/쓰기) 부트로더의 이름 또는 경로
• PV-bootloader-args (읽기/쓰기) 부트로더의 기타 인수 문자열
• last-boot-CPU-flags (읽기 전용) VM이 마지막으로 부팅된 CPU 플래그를 설명합니다.
• resident-on (읽기 전용) VM이 상주하는 Citrix Hypervisor 서버
• affinity (읽기/쓰기) VM에서 실행하기 위한 기본 설정이 있는 Citrix Hypervisor 서버입니다. xe vm-start 명령으로 VM 실행 위치를 결정하는 데 사용됩니다.

• other-config (읽기/쓰기 map 매개 변수) VM에 대한 추가 구성 매개 변수를 지정하는 키/값 쌍의 목록입니다.

  예를 들어 other-config 키/값 쌍 auto_poweron: true은(는) 풀의 호스트가 부팅된 후 VM을 자동으로 시작하도록 요청합니다. 또한 풀의 other-config에서 이 매개 변수를 설정해야 합니다. 이러한 매개 변수는 이제 더 이상 사용되지 않습니다. 대신 ha-restart-priority 매개 변수를 사용하십시오.

• start-time (읽기 전용) VM에 대한 메트릭을 읽은 날짜 및 시간의 타임스탬프입니다. 이 타임스탬프는 yyyymmddThh:mm:ss z 형식입니다. 여기서 z는 단일 문자 군사 시간대 표시기입니다(예: UTC (GMT) 의 경우 Z)
• install-time (읽기 전용) VM에 대한 메트릭을 읽은 날짜 및 시간의 타임스탬프입니다. 이 타임스탬프는 yyyymmddThh:mm:ss z 형식입니다. 여기서 z는 단일 문자 군사 시간대 표시기입니다(예: UTC (GMT) 의 경우 Z)
• memory-actual (읽기 전용) VM에서 사용 중인 실제 메모리
• VCPUs-number (읽기 전용) Linux VM용 VM에 할당된 가상 CPU의 수입니다. 이 숫자는 vm-vcpu-hotplug 명령을 사용하여 VM을 재부팅하지 않고도 변경할 수 있으며 VCPUS-max와(과) 다를 수 있습니다. 자세한 내용은 vm-vcpu-hotplug 항목을 참조하십시오. Windows VM은 항상 VCPUsmax에 설정된 개수의 VCPU만 사용하여 실행되며 이 값을 변경하려면 재부팅해야 합니다. VCPUs-number을(를) Citrix Hypervisor 서버의 물리적 CPU 수보다 큰 값으로 설정하면 성능이 급격히 떨어집니다.
• VCPUs-Utilization (읽기 전용 맵 매개 변수) 가상 CPU 목록 및 가중치
• os-version (읽기 전용 맵 매개 변수) VM용 운영 체제 버전
• PV-drivers-version (읽기 전용 맵 매개 변수) VM의 반가상화된 드라이버 버전
• PV-drivers-detected (읽기 전용) VM에 대한 최신 버전의 반가상화된 드라이버에 대한 플래그
• memory (읽기 전용 맵 매개 변수) VM의 에이전트가 보고한 메모리 메트릭
• disks (읽기 전용 맵 매개 변수) VM의 에이전트가 보고한 디스크 메트릭
• networks (읽기 전용 맵 매개 변수) VM의 에이전트가 보고한 네트워크 메트릭
• other (읽기 전용 맵 매개 변수) VM의 에이전트가 보고한 기타 메트릭
• guest-metrics-lastupdated (읽기 전용) 게스트 내 에이전트가 이러한 필드에 마지막 쓰기를 수행한 시간 타임스탬프 타임스탬프는 yyyymmddThh:mm:ss z 형식입니다. 여기서 z는 단일 문자 군사 시간대 표시기입니다(예: UTC (GMT)의 경우 Z)
• actions-after-shutdown (읽기/쓰기) VM이 종료된 후 수행할 작업
• actions-after-reboot (읽기/쓰기) VM이 재부팅된 후 수행할 작업
• possible-hosts 이 VM의 잠재적 호스트 읽기 전용
• dom-id (읽기 전용) 도메인 ID (사용 가능한 경우, 그렇지 않으면 -1)
• recommendations (읽기 전용) 이 VM의 속성에 대한 권장 값 및 범위의 XML 사양
• xenstore-data (읽기/쓰기 map 매개 변수) VM이 생성된 후 xenstore 트리에 삽입되는 데이터 (/local/domain/*domid*/vm-data)
• is-a-snapshot (읽기 전용) 이 VM이 스냅샷인 경우 True
• snapshot_of (읽기 전용) 이 스냅샷이 있는 VM의 UUID
• snapshots (읽기 전용) 이 VM의 모든 스냅샷의 UUID
• snapshot_time (읽기 전용) 이 VM 스냅샷을 생성한 스냅샷 작업의 타임스탬프
• memory-target (읽기 전용) 이 VM에 대해 설정된 대상 메모리 양
• blocked-operations (읽기/쓰기 map 매개 변수) 이 VM에서 수행할 수 없는 작업이 나열됨
• last-boot-record (읽기 전용) 이 템플릿의 마지막 부팅 매개 변수 레코드 (XML 형식)
• ha-always-run (읽기/쓰기) VM이 상주하는 호스트에 장애가 발생할 경우 이 VM이 항상 다른 호스트에서 다시 시작되면 True 이 매개 변수는 이제 더 이상 사용되지 않습니다. 대신 ha-restart-priority 매개 변수를 사용하십시오.
• ha-restart-priority (읽기/쓰기) 재시작 또는 최선의 노력
• blobs (읽기 전용) 이진 데이터 저장소
• live (읽기 전용) VM이 실행 중이면 True입니다. HA에서 VM이 실행되고 있지 않다고 의심되면 False입니다.

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid [database] vdi-uuid
<!--NeedCopy-->

이 VM을 복구하는 데 스토리지를 사용할 수 있는지 테스트합니다.

vm-call-plugin

xe vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]
<!--NeedCopy-->

선택적 인수 (args:key=value) 를 사용하여 지정된 VM의 플러그인 내에서 함수를 호출합니다. 특수 문자(예: 새 줄)가 포함된 “값” 문자열을 전달하기 위해 대체 구문 args:key:file=local_file을 대신 사용할 수 있습니다. 여기서 local_file 의 내용이 검색되어 “key”에 전체적으로 할당됩니다.

vm-cd-add

xe vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

선택한 VM에 새 가상 CD를 추가합니다. VM의 allowed-VBD-devices 매개 변수 값에서 device 매개 변수를 선택합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-cd-eject

xe vm-cd-eject [vm-selector=vm_selector_value...]
<!--NeedCopy-->

가상 CD 드라이브에서 CD를 꺼냅니다. 이 명령은 VM에 정확히 하나의 CD가 연결된 경우에만 작동합니다. CD가 두 개 이상 있는 경우 xe vbd-eject 명령을 사용하여 VBD의 UUID를 지정합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-cd-insert

xe vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

가상 CD 드라이브에 CD를 넣습니다. 이 명령은 VM에 정확히 하나의 빈 CD 장치가 연결되어 있는 경우에만 작동합니다. 둘 이상의 빈 CD 장치가 있는 경우 xe vbd-insert 명령을 사용하여 삽입할 VBD 및 VDI의 UUID를 지정합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-cd-list

xe vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

지정된 VM에 연결된 CD를 나열합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

나열할 VBD 및 VDI 매개 변수를 선택할 수도 있습니다.

vm-cd-remove

xe vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

지정된 VM에서 가상 CD를 제거합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-checkpoint

xe vm-checkpoint new-name-label=name_label [new-name-description=description]
<!--NeedCopy-->

가능한 경우 스토리지 수준의 빠른 디스크 스냅샷 작업을 사용하여 기존 VM을 체크포인트합니다.

vm-clone

xe vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

사용 가능한 경우 스토리지 수준 빠른 디스크 복제 작업을 사용하여 기존 VM을 복제합니다. new-name-label 및 new-name-description 인수를 사용하여 복제된 결과로 생성되는 VM의 이름과 설명 (선택 사항)을 지정합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-compute-maximum-memory

xe vm-compute-maximum-memory total=amount_of_available_physical_ram_in_bytes [approximate=add overhead memory for additional vCPUS? true|false] [vm_selector=vm_selector_value...]
<!--NeedCopy-->

물리적 RAM의 총합을 상한으로 사용하여 기존 VM에 할당할 수 있는 최대 정적 메모리의 양을 계산합니다. approximate 선택적 매개 변수는 나중에 VM에 vCPU를 추가하는 데 사용할 수 있도록 계산에 충분한 추가 메모리를 예약합니다.

예:

xe vm-compute-maximum-memory vm=testvm total=`xe host-list params=memory-free --minimal`
<!--NeedCopy-->

이 명령은 xe host-list 명령에서 반환된 memory-free 매개 변수의 값을 사용하여 testvm(이)라는 VM의 최대 메모리를 설정합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-compute-memory-overhead

xe vm-compute-memory-overhead
<!--NeedCopy-->

VM의 가상화 메모리 오버헤드를 계산합니다.

vm-copy

xe vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

스토리지 수준의 빠른 디스크 클론 작업을 사용하지 않고 기존 VM을 복사합니다(이 옵션을 사용할 수 있는 경우에도 해당). 복사된 VM의 디스크 이미지는 전체 이미지로 보장됩니다. 즉, CoW(기록 중 복사) 체인의 일부가 아닙니다.

new-name-label 및 new-name-description 인수를 사용하여 복사된 결과로 생성되는 VM의 이름과 설명 (선택 사항)을 지정합니다.

sr-uuid를 사용하여 복사된 결과 VM의 대상 SR을 지정합니다. 이 매개 변수를 지정하지 않으면 대상이 원래 VM이 있는 SR과 같게 됩니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-copy-bios-strings

xe vm-copy-bios-strings host-uuid=host_uuid
<!--NeedCopy-->

지정된 호스트의 BIOS 문자열을 VM에 복사합니다.

참고:

VM을 처음 시작한 후에는 해당 BIOS 문자열을 변경할 수 없습니다. VM을 처음 시작하기 전에 BIOS 문자열이 올바른지 확인하십시오.

vm-crashdump-list

xe vm-crashdump-list [vm-selector=vm selector value...]
<!--NeedCopy-->

지정된 VM과 연결된 크래시덤프를 나열합니다.

params 선택적 인수를 사용하는 경우 params 값은 표시하려는 이 객체의 매개 변수 목록이 포함된 문자열입니다. 또는 all 키워드를 사용하여 모든 매개 변수를 표시할 수 있습니다. params를 사용하지 않으면 반환된 목록에 사용 가능한 모든 매개 변수의 기본 하위 집합이 표시됩니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-data-source-list

xe vm-data-source-list [vm-selector=vm selector value...]
<!--NeedCopy-->

VM에 대해 기록할 수 있는 데이터 소스를 나열합니다.

표준 선택 메커니즘을 사용하여 이 작업을 수행할 VM을 선택합니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다. 호스트 선택을 위한 매개 변수를 지정하지 않으면 모든 VM에 대해 작업이 수행됩니다.

데이터 소스에는 두 개의 매개 변수(standard 및 enabled)가 있으며 이 매개 변수는 이 명령의 출력에서 확인할 수 있습니다. 데이터 원본이 enabled을(를) true(으)로 설정한 경우 메트릭은 현재 성능 데이터베이스에 기록되고 있습니다. 데이터 원본이 standard을(를) true(으)로 설정한 경우 메트릭은 기본적으로 성능 데이터베이스에 기록됩니다(이 데이터 원본에 대해서 enabled도 true(으)로 설정됨). 데이터 원본이 standard 을(를) false(으)로 설정한 경우 메트릭은 기본적으로 성능 데이터베이스에 기록되지 않습니다(데이터 원본에 대해서 enabled도 false(으)로 설정됨).

성능 데이터베이스에 데이터 원본 메트릭 기록을 시작하려면 vm-data-source-record 명령을 실행합니다. 이 명령은 enabled을(를) true(으)로 설정합니다 . 중지하려면 vm-data-source-forget을(를) 실행합니다. 이 명령은 enabled을(를) false(으)로 설정합니다 .

vm-data-source-record

xe vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->

VM의 지정된 데이터 원본을 기록합니다.

이 작업은 데이터 소스의 정보를 지정된 VM의 영구 성능 메트릭 데이터베이스에 기록합니다. 성능상의 이유로 이 데이터베이스는 일반 에이전트 데이터베이스와 구분됩니다.

표준 선택 메커니즘을 사용하여 이 작업을 수행할 VM을 선택합니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다. 호스트 선택을 위한 매개 변수를 지정하지 않으면 모든 VM에 대해 작업이 수행됩니다.

vm-data-source-forget

xe vm-data-source-forget data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->

VM의 지정된 데이터 원본 기록을 중지하고 기록된 데이터를 모두 무시합니다.

표준 선택 메커니즘을 사용하여 이 작업을 수행할 VM을 선택합니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다. 호스트 선택을 위한 매개 변수를 지정하지 않으면 모든 VM에 대해 작업이 수행됩니다.

vm-data-source-query

xe vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value...]
<!--NeedCopy-->

VM의 지정된 데이터 원본을 표시합니다.

표준 선택 메커니즘을 사용하여 이 작업을 수행할 VM을 선택합니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다. 호스트 선택을 위한 매개 변수를 지정하지 않으면 모든 VM에 대해 작업이 수행됩니다.

vm-destroy

xe vm-destroy uuid=uuid_of_vm
<!--NeedCopy-->

지정된 VM을 삭제합니다. VM과 관련된 스토리지는 그대로 유지됩니다. 스토리지도 삭제하려면 xe vm-uninstall를 사용하십시오.

vm-disk-add

xe vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]
<!--NeedCopy-->

지정된 VM에 디스크를 추가합니다. VM의 allowed-VBD-devices 매개 변수 값에서 device 매개 변수를 선택합니다.

disk-size 매개 변수는 바이트 단위로 지정하거나 IEC 표준 접미사 KiB, MiB, GiB 및 TiB를 사용하여 지정할 수 있습니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-disk-list

xe vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

지정된 VM에 연결된 디스크를 나열합니다. vbd-params 및 vdi-params 매개 변수는 출력할 각 오브젝트의 필드를 제어합니다. 매개 변수를 쉼표로 구분된 목록으로 지정하거나 전체 목록의 특수 키 all로 지정합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-disk-remove

xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]
<!--NeedCopy-->

지정된 VM에서 디스크를 제거하고 제거합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-export

xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

디스크 이미지를 포함한 지정된 VM을 로컬 컴퓨터의 파일로 내보냅니다. filename 매개 변수를 사용하여 VM을 내보낼 파일 이름을 지정합니다. 규칙에 따라 파일 이름의 확장자는 .xva입니다.

metadata 매개 변수가 true인 경우 디스크를 내보내지 않습니다. VM 메타데이터만 출력 파일에 기록됩니다. 기본 스토리지가 다른 메커니즘을 통해 전송되고 VM 정보를 다시 만들 수 있는 경우 이 매개 변수를 사용합니다. 자세한 내용은 vm-import 항목을 참조하십시오.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-import

xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]
<!--NeedCopy-->

이전에 내보낸 파일에서 VM을 가져옵니다. preserve가 true로 설정된 경우 원래 VM의 MAC 주소가 유지됩니다. sr-uuid는 VM을 가져올 대상 SR을 결정합니다. 이 매개 변수를 지정하지 않으면 기본 SR이 사용됩니다.

metadata이 true인 경우 연결된 디스크 블록 없이 이전에 내보낸 메타데이터 세트를 가져올 수 있습니다. --force 옵션을 지정하지 않은 경우(SR 및 VDI.location(으)로 명명된) VDI를 찾을 수 없으면 메타데이터 전용 가져오기가 실패합니다. 이 경우 가져오기는 관계없이 계속됩니다. 디스크를 대역외에서 미러링하거나 이동할 수 있는 경우 메타데이터 가져오기/내보내기를 사용하면 분리된 풀 간에 VM을 빠르게 이동할 수 있습니다. 예를 들어 재해 복구 계획의 일부로 사용할 수 있습니다.

참고:

여러 VM 가져오기가 병렬로 더 빠르게 수행됩니다.

vm-install

xe vm-install new-name-label=name [template-uuid=uuid_of_desired_template] [template=template_uuid_or_name] [sr-uuid=sr_uuid | sr-name-label=name_of_sr][copy-bios-strings-from=host_uuid]
<!--NeedCopy-->

템플릿에서 VM을 설치하거나 복제합니다. template-uuid 또는 template 인수를 사용하여 템플릿 이름을 지정합니다. sr-uuid 또는 sr-name-label 인수를 사용하여 SR을 지정합니다. copy-bios-strings-from 인수를 사용하여 BIOS 잠금 미디어를 설치하도록 지정합니다.

참고:

기존 디스크가 있는 템플릿에서 설치하는 경우 기본적으로 기존 디스크와 동일한 SR에 새 디스크가 생성됩니다. SR이 지원하는 경우 이러한 디스크는 빠른 복사본입니다. 명령줄에서 다른 SR을 지정하면 새 디스크가 생성됩니다. 이 경우 빠른 복사가 불가능하며 디스크는 전체 복사본입니다.

기존 디스크가 없는 템플릿에서 설치하는 경우 지정된 SR에 새 디스크가 생성되고, SR이 지정되지 않은 경우 풀 기본 SR에 새 디스크가 만들어집니다.

vm-is-bios-customized

xe vm-is-bios-customized
<!--NeedCopy-->

VM의 BIOS 문자열이 사용자 지정되었는지 여부를 나타냅니다.

vm-memory-dynamic-range-set

xe vm-memory-dynamic-range-set min=min max=max
<!--NeedCopy-->

VM의 동적 메모리 범위를 구성합니다. 동적 메모리 범위는 VM 메모리의 소프트 하한 및 상한을 정의합니다. VM이 실행 중이거나 중지된 경우 이러한 필드를 변경할 수 있습니다. 동적 범위는 정적 범위 내에 맞아야 합니다.

vm-memory-limits-set

xe vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max
<!--NeedCopy-->

VM의 메모리 제한을 구성합니다.

vm-memory-set

xe vm-memory-set memory=memory
<!--NeedCopy-->

VM의 메모리 할당을 구성합니다.

vm-memory-shadow-multiplier-set

xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]
<!--NeedCopy-->

지정된 VM의 섀도 메모리 승수를 설정합니다.

이 옵션은 하드웨어 지원 VM에 할당된 섀도 메모리의 양을 수정하는 고급 옵션입니다.

Citrix Virtual Apps와 같은 일부 특수 응용 프로그램 워크로드에서는 전체 성능을 달성하려면 추가 섀도우 메모리가 필요합니다.

이 메모리는 오버헤드로 간주되며, VM에 메모리를 할당하기 위한 일반적인 메모리 계산에서 제외됩니다. 이 명령을 호출하면 사용 가능한 호스트 메모리의 양은 승수에 따라 감소하고 HVM_shadow_multiplier 필드는 Xen이 VM에 할당한 값으로 업데이트됩니다. 사용 가능한 Citrix Hypervisor 서버 메모리가 부족하면 오류가 반환됩니다.

이 작업을 수행할 VM은 표준 선택 메커니즘으로 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오.

vm-memory-static-range-set

xe vm-memory-static-range-set min=min max=max
<!--NeedCopy-->

VM의 정적 메모리 범위를 구성합니다. 정적 메모리 범위는 VM 메모리의 하한 및 상한을 정의합니다. VM이 중지된 경우에만 이러한 필드를 변경할 수 있습니다. 정적 범위는 동적 범위를 포함해야 합니다.

vm-memory-target-set

xe vm-memory-target-set target=target
<!--NeedCopy-->

중지되거나 실행 중인 VM에 대한 메모리 대상을 설정합니다. 주어진 값은 VM의 memory_static_min 및 memory_static_max 값에 의해 정의된 범위 내에 있어야 합니다.

vm-migrate

xe vm-migrate [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:source_vif_uuid=destination_network_uuid] [vdi:vdi_uuid=destination_sr_uuid]
<!--NeedCopy-->

이 명령은 지정된 VM을 물리적 호스트 간에 마이그레이션합니다. host 매개 변수는 Citrix Hypervisor 서버의 이름 또는 UUID일 수 있습니다. 예를 들어 VM 디스크가 두 호스트가 공유하는 스토리지에 있는 풀의 다른 호스트로 VM을 마이그레이션하려면 다음을 수행하십시오.

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid
<!--NeedCopy-->

스토리지를 공유하지 않는 동일한 풀의 호스트 간에 VM을 이동하려면 (스토리지 실시간 마이그레이션):

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
    remote-master=192.0.2.35 remote-username=username remote-password=password
<!--NeedCopy-->

스토리지 실시간 마이그레이션의 경우 동일한 풀 내에서 마이그레이션하는 경우에도 풀 마스터의 호스트 이름 또는 IP 주소, 사용자 이름 및 암호를 제공해야 합니다.

다음과 같이 각 VDI가 저장되는 SR을 선택할 수 있습니다.

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 remote-username=username remote-password=password host-uuid=destination_host_uuid \
    vdi:vdi_1=destination_sr1_uuid \
    vdi:vdi_2=destination_sr2_uuid \
    vdi:vdi_3=destination_sr3_uuid
<!--NeedCopy-->

또한 마이그레이션 이후에 VM을 연결할 네트워크도 선택할 수 있습니다.

xe vm-migrate uuid=vm_uuid \
    vdi1:vdi_1_uuid=destination_sr1_uuid \
    vdi2:vdi_2_uuid=destination_sr2_uuid \
    vdi3:vdi_3_uuid=destination_sr3_uuid \
    vif:vif_uuid=network_uuid
<!--NeedCopy-->

풀 간 마이그레이션의 경우 다음과 같이 입력하십시오.

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 \
    remote-username=username remote-password=password \
    host-uuid=destination_host_uuid  \
    vif:source_vif_uuid=destination_network_uuid \
    vdi:vdi_uuid=destination_sr_uuid
<!--NeedCopy-->

스토리지 실시간 마이그레이션, 실시간 마이그레이션 및 라이브 VDI 마이그레이션에 대한 자세한 내용은 VM 마이그레이션을 참조하십시오

기본적으로 VM은 다른 호스트에서 일시 중단, 마이그레이션 및 재개됩니다. live 매개 변수는 실시간 마이그레이션을 선택합니다. 실시간 마이그레이션을 수행하면 마이그레이션을 수행하는 동안 VM이 계속 실행되므로 VM 가동 중지 시간이 최소화됩니다. VM의 메모리 사용량이 매우 많은 워크로드와 같은 일부 상황에서는 실시간 마이그레이션이 기본 모드로 전환되어 메모리 전송을 완료하기 전에 잠시 동안 VM을 일시 중단합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-pause

xe vm-pause
<!--NeedCopy-->

실행 중인 VM을 일시 중지합니다 이 작업은 관련 메모리를 해제하지 않습니다(vm-suspend 참조).

vm-reboot

xe vm-reboot [vm-selector=vm_selector_value...] [force=true]
<!--NeedCopy-->

지정된 VM을 재부팅합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

비정상 재부팅을 유발하려면 force 인수를 사용하십시오. 시스템 종료는 물리적 서버에서 플러그를 뽑는 것과 비슷합니다.

vm-recover

xe vm-recover vm-uuid [database] [vdi-uuid] [force]
<!--NeedCopy-->

제공된 VDI에 포함된 데이터베이스에서 VM을 복구합니다.

vm-reset-powerstate

xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
<!--NeedCopy-->

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

이 명령은 풀의 구성원 호스트가 다운될 때만 사용되는 고급 명령입니다. 이 명령을 사용하여 풀 마스터가 VM의 전원 상태를 halted로 재설정하도록 강제할 수 있습니다. 기본적으로 이 명령은 다른 풀 호스트에서 다음에 시작할 수 있도록 VM 및 해당 디스크를 강제로 잠급니다. 이 호출은 force 플래그를 지정해야 하며, 명령줄에 없으면 실패합니다.

vm-resume

xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
<!--NeedCopy-->

지정된 VM을 재개합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

VM이 호스트 풀의 공유 SR에 있는 경우 on 인수를 사용하여 시작할 풀 멤버를 지정합니다. 기본적으로 시스템에서는 풀의 구성원 중 적절한 호스트를 결정합니다.

vm-retrieve-wlb-recommendations

xe vm-retrieve-wlb-recommendations
<!--NeedCopy-->

선택한 VM에 대한 Workload Balancing 권장 사항을 검색합니다.

vm-shutdown

xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

지정된 VM을 종료합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

force 인수를 사용하면 물리적 서버에서 플러그를 뽑는 것과 유사하게 비정상적으로 종료됩니다.

vm-snapshot

xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
<!--NeedCopy-->

가능한 경우 스토리지 수준의 빠른 디스크 스냅샷 작업을 사용하여 기존 VM의 스냅샷을 생성합니다.

vm-start

xe vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]
<!--NeedCopy-->

지정된 VM을 시작합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

VM이 호스트 풀의 공유 SR에 있는 경우 on 인수를 사용하여 VM을 시작할 풀 구성원을 지정합니다. 기본적으로 시스템에서는 풀의 구성원 중 적절한 호스트를 결정합니다.

vm-suspend

xe vm-suspend [vm-selector=vm_selector_value...]
<!--NeedCopy-->

지정된 VM을 일시 중단합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-uninstall

xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

VM을 제거하고 메타데이터 레코드와 함께 디스크 (RW로 표시되고 이 VM에만 연결된 VDI) 를 제거합니다. VM 메타데이터만 제거하려면 xe vm-destroy를 사용하십시오.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

vm-unpause

xe vm-unpause
<!--NeedCopy-->

일시 중지된 VM의 일시 중지를 해제합니다.

vm-vcpu-hotplug

xe vm-vcpu-hotplug new-vcpus=new_total_vcpu_count [vm-selector=vm_selector_value...]
<!--NeedCopy-->

실행 중인 Linux VM에서 사용할 수 있는 vCPU 수를 동적으로 조정합니다. vCPU 수는 VCPUs-max 매개 변수에 의해 제한됩니다. Windows VM은 항상 VCPUs-max에 설정된 개수의 VCPU만 사용하여 실행되며 이 값을 변경하려면 재부팅해야 합니다.

new-vcpus 매개 변수를 사용하여 이 명령을 실행한 후 보유하려는 새로운 총 vCPU 수를 정의합니다. 추가하려는 vCPU 수를 전달하는 데 이 매개 변수를 사용하지 마십시오. 예를 들어 VM에 기존 vCPU가 두 개 있는데 vCPU를 두 개 더 추가하려는 경우 new-vcpus=4을(를) 지정하십시오.

이 작업이 수행되는 Linux VM 또는 Windows VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

참고:

Citrix VM Tools가 설치되지 않은 상태로 Linux VM을 실행하는 경우 VM에서 다음 명령을 root(으)로 실행하여 새로 핫 플러그된 vCPU가 사용되는지 확인합니다. # for i in /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(cat $i)" = 0 ]; then echo 1 > $i; fi; done

vm-vif-list

xe vm-vif-list [vm-selector=vm_selector_value...]
<!--NeedCopy-->

지정된 VM에서 VIF를 나열합니다.

이 작업이 수행되는 VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택기는 필터링할 때 VM 레코드에서 작동하며 VIF 값에서는 작동하지 않습니다 . 선택적 인수는 이 섹션의 시작 부분에 나열된 여러 VM 매개 변수일 수 있습니다.

예약된 스냅샷

VM 예약 스냅샷 및 해당 특성을 제어하기 위한 명령

vmss 개체는 표준 개체 나열 명령(xe vmss-list) 및 표준 매개 변수 명령으로 조작된 매개 변수를 사용하여 나열할 수 있습니다. 자세한 내용은 하위 수준 매개 변수 명령을 참조하십시오.

vmss-create

xe vmss-create enabled=True/False name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule
<!--NeedCopy-->

풀에 스냅샷 스케줄을 생성합니다.

예:

xe vmss-create retained-snapshots=9 enabled=true frequency=daily \
    name-description=sample name-label=samplepolicy type=snapshot \
    schedule:hour=10 schedule:min=30
<!--NeedCopy-->

스냅샷 스케줄에는 다음과 같은 매개 변수가 있습니다.

vmss-destroy

xe vmss-destroy uuid=uuid
<!--NeedCopy-->

풀에서 스냅샷 스케줄을 제거합니다.

USB 패스스루

USB 패스스루는 USB 버전 1.1, 2.0 및 3.0에서 지원됩니다.

USB 패스스루 사용/사용 안 함

xe pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
<!--NeedCopy-->

USB 패스스루를 활성화/비활성화합니다.

pusb-scan

xe pusb-scan host-uuid=host_uuid
<!--NeedCopy-->

PUSB를 스캔하고 업데이트합니다.

vusb-create

xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
<!--NeedCopy-->

풀에 가상 USB를 만듭니다. VM을 시작하여 USB를 통해 VM으로 전달합니다.

vusb-unplug

xe vusb-unplug uuid=vusb_uuid
<!--NeedCopy-->

VM에서 USB 플러그를 뽑습니다.

vusb-destroy

xe vusb-destroy uuid=vusb_uuid
<!--NeedCopy-->

VM에서 가상 USB 목록을 제거합니다.