명령줄 인터페이스

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

xe CLI 시작하기

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

젠서버 호스트에서

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

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

윈도우에서

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

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

리눅스에서

RPM 기반 배포판(예: Red Hat)에서는 주 XenServer 설치 ISO에 있는 client_install/xapi-xe-BUILD.x86_64.rpm이라는 RPM에서 독립 실행형 xe 명령을 설치할 수 있습니다.

RPM에서 설치하려면 다음 명령을 사용하십시오.

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

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

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

참고:

Linux에서 원격 xe CLI는 보안 연결을 통해 명령을 실행하고 이러한 명령에 파일 전송이 포함될 때 중단될 수 있습니다. 이 경우 --no-ssl 매개변수를 사용하여 XenServer 호스트에 대한 비보안 연결을 통해 명령을 실행할 수 있습니다.

xe 명령으로 도움말 얻기

호스트에서 CLI 명령에 대한 기본 도움말은 다음을 입력하여 사용할 수 있습니다.

xe help command
<!--NeedCopy-->

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

xe help
<!--NeedCopy-->

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

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

기본 xe 구문

모든 XenServer 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 인수는 원격 XenServer 호스트의 에이전트 포트를 지정하는 데 사용될 수 있습니다(기본값은 443).

예: 로컬 XenServer 호스트에서:

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

예: 원격 XenServer 호스트에서:

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

원격 연결 인수에 대한 약식 구문도 사용할 수 있습니다:

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

예: 원격 XenServer 호스트에서:

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

인수는 쉼표로 구분된 키-값 쌍 형식으로 환경 변수 XE_EXTRA_ARGS에서도 가져옵니다. 예를 들어, 원격 XenServer 호스트에서 실행되는 명령을 입력하려면 먼저 다음 명령을 실행하십시오:

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

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

XE_EXTRA_ARGS 환경 변수를 사용하면 원격 XenServer 호스트에 대해 xe 명령을 실행할 때 기본적으로 비활성화된 탭 완성을 사용할 수 있습니다.

특수 문자 및 구문

xe 명령줄에서 인수/값 쌍을 지정하려면 다음을 작성하십시오: argument=value

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

공백이 포함된 값의 경우 다음을 작성하십시오: argument="value with spaces"

XenServer 호스트에서 CLI를 사용할 때 명령에는 표준 Linux bash 셸의 기능과 유사한 탭 완성 기능이 있습니다. 예를 들어, xe vm-l을 입력한 다음 TAB 키를 누르면 나머지 명령이 표시됩니다. 둘 이상의 명령이 vm-l로 시작하는 경우 TAB을 두 번 누르면 가능한 목록이 표시됩니다. 이 기능은 명령에서 개체 UUID를 지정할 때 유용합니다.

참고:

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

명령 유형

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

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

• 클래스-목록

• class-매개변수-가져오기

• class-매개변수-설정

• 클래스-매개변수-목록

• 클래스-매개변수-추가

• 클래스-매개변수-제거

• 클래스-매개변수-지우기

여기서 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은 이 매개변수가 맵 매개변수이며 읽기 및 쓰기가 가능함을 나타냅니다. allowed-operations 매개변수는 항목 집합을 구성하는 목록을 가집니다. RO 앞에 있는 S는 이것이 세트 매개변수이며 읽기 가능하지만 쓰기 불가능함을 나타냅니다.

맵 매개변수를 필터링하거나 맵 매개변수를 설정하려면 콜론(:)을 사용하여 맵 매개변수 이름과 키-값 쌍을 구분합니다. 예를 들어, 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

  특정 매개변수의 값을 반환합니다. 맵 매개변수의 경우, 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

  맵 또는 세트 매개변수에 추가합니다. 맵 매개변수의 경우, 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의 값이 halted이고 필드 HVM-boot-policy의 값이 BIOS order인 VM만 나열합니다.

맵의 키 값 또는 세트의 값 존재 여부로 목록을 필터링할 수도 있습니다. 맵의 키를 기반으로 필터링하는 구문은 map-name:key=value입니다. 세트에 존재하는 값을 기반으로 필터링하는 구문은 set-name:contains=value입니다.

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

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

비밀

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

참고:

암호 비밀은 원격 xe CLI 인스턴스에서 XenServer 호스트에 인증하는 데 사용할 수 없습니다.

비밀 개체를 만들려면 XenServer 호스트에서 다음 명령을 실행하십시오.

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

비밀이 생성되어 XenServer 호스트에 저장됩니다. 이 명령은 비밀 개체의 UUID를 출력합니다. 예를 들어, 99945d96-5890-de2a-3899-8c04ef2521db입니다. 암호가 필요한 모든 명령에 이 UUID를 전달하려면 암호 인수 이름에 _secret를 추가하십시오.

예: 비밀을 생성한 XenServer 호스트에서 다음 명령을 실행할 수 있습니다.

    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이라고도 함)를 생성하고 수정하는 명령입니다. 자세한 내용은 vApps를 참조하십시오.

어플라이언스 매개변수

어플라이언스 명령에는 다음 매개변수가 있습니다.

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

본딩 명령

물리적 인터페이스 페일오버를 통한 복원력을 위한 네트워크 본드 작업 명령. 자세한 내용은 네트워킹을 참조하십시오.

본드 객체는 마스터 및 멤버 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가 동일한 XenServer 호스트에 없는 경우
• 제공된 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 명령

XenServer 호스트의 물리적 CD/DVD 드라이브 작업용 명령입니다.

CD 매개변수

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

cd-list

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

XenServer 호스트 또는 풀에 있는 CD 및 ISO(CD 이미지 파일)를 선택적 인수 params을(를) 기준으로 필터링하여 나열합니다.

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

선택적 인수는 이 섹션 시작 부분에 나열된 CD 매개변수 중 임의의 수일 수 있습니다.

GFS2 클러스터 명령

GFS2 클러스터형 풀 작업용 명령입니다.

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

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

GFS2 클러스터 매개변수

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

GFS2 클러스터 내의 호스트(cluster-host)에는 다음 매개변수가 있습니다.

cluster-host-destroy

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

GFS2 클러스터 호스트를 제거하여 GFS2 클러스터를 효과적으로 떠납니다.

cluster-host-disable

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

활성화된 GFS2 클러스터 호스트에 대한 GFS2 클러스터 멤버십을 비활성화합니다.

cluster-host-enable

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

비활성화된 GFS2 클러스터 호스트에 대한 GFS2 클러스터 멤버십을 활성화합니다.

cluster-host-force-destroy

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

GFS2 클러스터 호스트 개체를 강제로 제거하여 GFS2 클러스터를 효과적으로 떠납니다.

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

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

cluster-pool-destroy

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

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

cluster-pool-force-destroy

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

풀 전체 GFS2 클러스터를 강제로 파괴합니다.

cluster-pool-resync

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

풀 전체 GFS2 클러스터를 재동기화합니다.

콘솔 명령

콘솔 작업용 명령입니다.

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

콘솔 매개변수

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

console

xe console
<!--NeedCopy-->

특정 콘솔에 연결합니다.

진단 명령

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

diagnostic-compact

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

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

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 그룹이 pGPU에 가상 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를 생성합니다. 이 명령은 VM을 지정된 GPU 그룹에 연결하고 선택적으로 가상 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는 활성화되어 있습니다.

호스트 명령

XenServer 호스트와 상호 작용하기 위한 명령입니다.

XenServer 호스트는 XenServer 소프트웨어를 실행하는 물리적 서버입니다. 이 서버에는 제어 도메인 또는 도메인 0으로 알려진 특수 권한 가상 머신의 제어 하에 VM이 실행됩니다.

XenServer 호스트 개체는 표준 개체 목록 명령(xe host-list, xe host-cpu-list, xe host-crashdump-list)으로 나열할 수 있습니다. 매개변수는 표준 매개변수 명령으로 조작할 수 있습니다. 자세한 내용은 하위 수준 매개변수 명령을(를) 참조하십시오.

호스트 선택기

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

호스트 매개변수

XenServer 호스트에는 다음 매개변수가 있습니다.

예시:

• xe host-param-set uuid=<uuid> ntp-mode=Factory
• xe host-param-set uuid=<uuid> ntp-custom-servers=server1,server2
• xe host-param-set uuid=<uuid> timezone=UTC
• xe host-param-set uuid=<uuid> max-cstate=1

XenServer 호스트에는 매개변수 목록을 가진 다른 개체도 포함되어 있습니다.

XenServer 호스트의 CPU에는 다음 매개변수가 있습니다:

XenServer 호스트의 크래시 덤프에는 다음 매개변수가 있습니다.

host-all-editions

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

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

host-apply-edition

xe host-apply-edition [host-uuid=host_uuid] [edition=premium-per-socket|standard-per-socket|cloud]
<!--NeedCopy-->

XenServer 라이선스를 호스트 서버에 할당합니다. 라이선스를 할당하면 XenServer는 라이선스 서버에 연결하여 지정된 유형의 라이선스를 요청합니다. 라이선스를 사용할 수 있는 경우 라이선스 서버에서 체크아웃됩니다.

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

에디션 값으로는 “cloud”, “free”, “premium-per-socket”, “standard-per-socket”과 같은 항목들이 있습니다. 앞으로는 “cloud” 에디션만 지원될 예정입니다.

host-backup

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

지정된 XenServer 호스트의 제어 도메인 백업을 명령이 호출된 시스템으로 다운로드합니다. 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-->

UUID로 지정된 호스트 크래시 덤프를 XenServer 호스트에서 삭제합니다.

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

지정된 XenServer 호스트를 비활성화하여 새 VM이 해당 호스트에서 시작되지 않도록 합니다. 이 작업은 XenServer 호스트를 종료하거나 재부팅할 준비를 합니다. 해당 호스트가 재부팅된 후, 활성화에 필요한 모든 조건(예: 스토리지를 사용할 수 있는 경우)이 충족되면 호스트는 자동으로 다시 활성화됩니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘을 사용하여 선택됩니다(호스트 선택기 참조). 선택적 인수는 이 섹션 시작 부분에 나열된 호스트 매개변수 중 임의의 수만큼 포함될 수 있습니다.

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

지정된 XenServer 호스트에서 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-->

이 XenServer 호스트의 관리 인터페이스를 재구성합니다. 이 명령은 XenServer 호스트가 비상 모드일 때만 사용하십시오. 비상 모드는 호스트가 리소스 풀의 구성원이며, 해당 풀 코디네이터가 네트워크에서 사라져 여러 번 재시도한 후에도 연락할 수 없는 상태를 의미합니다.

host-emergency-reset-server-certificate

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

명령이 실행되는 XenServer 호스트에 자체 서명된 인증서를 설치합니다.

host-enable

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

지정된 XenServer 호스트를 활성화하여 새 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가 활성화된 경우, 유일한 옵션은 XenServer 호스트를 종료하는 것이며, 이로 인해 HA가 무작위로 새 풀 코디네이터를 선택하게 됩니다. 자세한 내용은 host-shutdown을 참조하십시오.

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

host-forget

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

XAPI 에이전트는 지정된 XenServer 호스트에 명시적으로 연락하지 않고 해당 호스트를 잊어버립니다.

이 작업을 정말로 수행할 것인지 확인하라는 메시지가 표시되지 않도록 --force 매개변수를 사용하십시오.

경고:

풀에서 HA가 활성화된 경우 이 명령을 사용하지 마십시오. 먼저 HA를 비활성화한 다음, 호스트를 잊은 후에 다시 활성화하십시오.

이 명령은 “잊을” XenServer 호스트가 죽은 경우에 유용합니다. 그러나 XenServer 호스트가 활성 상태이고 풀의 일부인 경우 대신 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가 이 항목을 기본적으로 선택하는지 여부를 나타냅s니다.
• 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 목록을 반환하고 각 VM에 대한 이유를 표시합니다.

host-is-in-emergency-mode

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

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

host-license-view

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

XenServer 호스트 라이선스의 내용을 표시합니다.

host-logs-download

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

지정된 XenServer 호스트의 로그 사본을 다운로드합니다. 사본은 기본적으로 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가 연결된 XenServer 호스트에서 직접 작동합니다. 멤버 XenServer 호스트에 적용될 때 이 명령은 풀 코디네이터로 전달되지 않습니다.

경고:

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

host-management-reconfigure

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

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

인터페이스의 장치 이름(IP 주소가 있어야 함)이 지정되면 XenServer 호스트는 즉시 다시 바인딩됩니다. 이 명령은 일반 모드와 비상 모드 모두에서 작동합니다.

PIF 개체의 UUID가 지정되면 XenServer 호스트는 자체적으로 다시 바인딩할 IP 주소를 결정합니다. 이 명령을 실행할 때 비상 모드에 있어서는 안 됩니다.

경고:

호스트 외부에서 이 CLI 명령을 사용할 때는 주의하고 새 인터페이스에 네트워크 연결이 되어 있는지 확인하십시오. 먼저 xe pif-reconfigure을 사용하여 설정하십시오. 그렇지 않으면 후속 CLI 명령이 XenServer 호스트에 연결할 수 없습니다.

host-power-on

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

호스트 전원 켜기 기능이 활성화된 XenServer 호스트의 전원을 웁니다. 이 명령을 사용하기 전에 호스트에서 host-set-power-on을 활성화하십시오.

host-reboot

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

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

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

지정된 XenServer 호스트가 풀의 구성원인 경우, 종료 시 연결 손실이 처리되고 XenServer 호스트가 복귀하면 풀이 복구됩니다. 다른 구성원과 풀 코디네이터는 계속 작동합니다.

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

• 구성원 중 하나를 풀 코디네이터로 만듭니다.

• 원래 풀 코디네이터가 재부팅되어 온라인 상태로 돌아옵니다.

  풀 코디네이터가 다시 온라인 상태가 되면 구성원들은 풀 코디네이터와 다시 연결하고 동기화합니다.

host-restore

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

XenServer 호스트 제어 소프트웨어의 file-name이라는 백업을 복원합니다. 여기서 “복원”이라는 단어는 일반적인 의미의 완전한 복원을 의미하는 것이 아니라, 압축된 백업 파일이 보조 파티션에 압축 해제되어 풀렸음을 의미합니다. xe host-restore를 수행한 후에는 설치 CD로 부팅하여 백업에서 복원 옵션을 사용해야 합니다.

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

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

XenServer 호스트에 TLS 인증서를 설치합니다.

host-set-hostname-live

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

host-uuid으로 지정된 XenServer 호스트의 호스트 이름을 변경합니다. 이 명령은 제어 도메인 데이터베이스의 호스트 이름과 XenServer 호스트의 실제 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" | "IPMI" | "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-->

원격 전원 솔루션과 호환되는 XenServer 호스트에서 호스트 전원 켜기 기능을 활성화하는 데 사용합니다. 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-->

지정된 XenServer 호스트를 종료합니다. 지정된 XenServer 호스트는 xe host-disable 명령을 사용하여 먼저 비활성화해야 합니다. 그렇지 않으면 HOST_IN_USE 오류 메시지가 표시됩니다.

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

지정된 XenServer 호스트가 풀의 멤버인 경우, 종료 시 연결 손실이 처리되고 XenServer 호스트가 돌아오면 풀이 복구됩니다. 다른 멤버와 풀 코디네이터는 계속 작동합니다.

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

• 멤버 중 하나를 풀 코디네이터로 만듭니다.

• 원래 풀 코디네이터가 재부팅되어 온라인 상태가 됩니다.

  풀 코디네이터가 다시 온라인 상태가 되면 멤버들이 풀 코디네이터와 다시 연결하고 동기화합니다.

풀에 HA가 활성화된 경우, 멤버 중 하나가 자동으로 풀 코디네이터가 됩니다. HA가 비활성화된 경우, pool-designate-new-master 명령을 사용하여 원하는 XenServer 호스트를 수동으로 풀 코디네이터로 지정해야 합니다. 자세한 내용은 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-->

지정된 XenServer 호스트에서 syslog 데몬을 재구성합니다. 이 명령은 호스트 logging 매개변수에 정의된 구성 정보를 적용합니다.

이 작업을 수행할 호스트는 표준 선택 메커니즘을 사용하여 선택됩니다(위의 host selectors 참조). 선택적 인수는 이 섹션 시작 부분에 나열된 host parameters 중 임의의 수일 수 있습니다.

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

호스트에 대해 지정된 데이터 소스를 표시합니다.

표준 선택 메커니즘((/ko-kr/xenserver/9/command-line-interface.html#host-selectors) 참조)을 사용하여 이 작업을 수행할 호스트를 선택합니다. 선택적 인수는 이 섹션 시작 부분에 나열된 (/ko-kr/xenserver/9/command-line-interface.html#host-parameters) 중 임의의 수일 수 있습니다. 호스트를 선택할 매개변수가 제공되지 않으면 모든 호스트에서 작업이 수행됩니다.

메시지 명령

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

메시지 개체는 표준 개체 목록 명령(xe message-list)으로 나열할 수 있으며, 매개변수는 표준 매개변수 명령으로 조작할 수 있습니다. 자세한 내용은 (/ko-kr/xenserver/9/command-line-interface.html#low-level-parameter-commands)를 참조하십시오.

메시지 매개변수

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 네트워크의 VF를 VM에 할당합니다.

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는 XenServer 호스트가 스토리지 리포지토리(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-->

XenServer 호스트에 PBD를 생성합니다. 읽기 전용 device-config 매개변수는 생성 시에만 설정할 수 있습니다.

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

각 SR 유형에서 지원되는 device-config 키-값 쌍의 전체 목록은 Storage를 참조하십시오.

pbd-destroy

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

지정된 PBD를 제거합니다.

pbd-plug

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

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

pbd-unplug

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

XenServer 호스트에서 PBD를 분리하려고 시도합니다.

PIF 명령

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

PIF 객체는 표준 객체 목록 명령(xe pif-list)으로 나열할 수 있으며, 매개변수는 표준 매개변수 명령으로 조작할 수 있습니다. 자세한 내용은 Low-level parameter commands를 참조하십시오.

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

지정된 XenServer 호스트에서 물리적 인터페이스를 나타내는 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 구성의 경우, gateway, IP, netmask 매개변수를 적절한 값으로 설정하고 mode 매개변수를 static로 설정합니다. DHCP를 사용하려면 mode 매개변수를 DHCP로 설정하고 고정 매개변수는 정의하지 않은 상태로 둡니다.

참고:

STP Fast Link가 꺼져 있거나(또는 지원되지 않는) Spanning Tree Protocol을 사용하는 스위치의 포트에 연결된 물리적 네트워크 인터페이스에서 고정 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-->

XenServer 호스트에서 새 물리적 인터페이스를 검색합니다.

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

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

풀 명령

풀 작업을 위한 명령입니다. 풀은 하나 이상의 XenServer 호스트의 집합입니다. 풀은 하나 이상의 공유 스토리지 리포지토리를 사용하여 풀 내의 한 호스트에서 실행되는 VM을 풀 내의 다른 호스트로 거의 실시간으로 마이그레이션할 수 있도록 합니다. 이 마이그레이션은 VM이 여전히 실행 중인 상태에서 종료하거나 다시 시작할 필요 없이 발생합니다.

각 XenServer 호스트는 기본적으로 단일 멤버로 구성된 풀입니다. XenServer 호스트가 풀에 조인되면 멤버로 지정됩니다. 호스트가 조인된 풀이 단일 멤버로 구성된 경우 해당 멤버가 풀 코디네이터가 됩니다. 호스트가 조인된 풀에 이미 여러 멤버가 있는 경우, 이 멤버 중 하나가 이미 풀 코디네이터이며 새 호스트가 풀에 조인할 때도 그대로 유지됩니다.

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

풀 매개변수

풀에는 다음 매개변수가 있습니다.

pool-apply-edition

xe pool-apply-edition edition=cloud|standard-per-socket|premium-per-socket [uuid=uuid] [license-server-address=address] [license-server-port=port]
<!--NeedCopy-->

풀 전체에 에디션을 적용합니다. 에디션 값에는 “cloud”, “standard-per-socket”, “premium-per-socket”이 포함됩니다. 향후에는 “cloud”만 지원됩니다.

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

워크로드 밸런싱 구성을 영구적으로 제거합니다.

pool-designate-new-master

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

지정된 멤버 XenServer 호스트가 기존 풀의 코디네이터(이전에는 “마스터”라고 불림)가 되도록 지시합니다. 이 명령은 풀 코디네이터 역할을 리소스 풀의 다른 호스트로 질서 있게 인계합니다. 이 명령은 현재 풀 코디네이터가 온라인 상태일 때만 작동합니다. 아래 나열된 비상 모드 명령을 대체하지 않습니다.

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

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-ensable-redo-log sr-uuid=sr_uuid
<!--NeedCopy-->

HA가 활성화되지 않은 경우 사용 중인 SR에서 재실행 로그를 활성화합니다.

pool-eject

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

지정된 XenServer 호스트가 기존 풀을 떠나도록 지시합니다.

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

멤버 XenServer 호스트에게 풀 코디네이터(이전에는 “풀 마스터”라고 불림)가 되도록 지시합니다. XenServer 호스트는 호스트가 비상 모드로 전환된 후에만 이 명령을 수락합니다. 비상 모드는 코디네이터가 네트워크에서 사라지고 여러 번의 재시도 후에도 연락할 수 없는 풀의 멤버임을 의미합니다.

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

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

대상 워크로드 밸런싱 서버를 사용하여 현재 풀에 대한 워크로드 밸런싱을 초기화합니다.

pool-join

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

XenServer 호스트가 기존 풀에 참여하도록 지시합니다.

pool-management-reconfigure

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

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

인터페이스의 장치 이름(IP 주소가 있어야 함)이 지정되면 XenServer 풀 코디네이터가 즉시 다시 바인딩합니다. 이 명령은 일반 모드와 비상 모드 모두에서 작동합니다.

지정된 네트워크 UUID에서 PIF 개체의 UUID가 식별되어 XenServer 호스트에 매핑되며, 이는 자체적으로 다시 바인딩할 IP 주소를 결정합니다. 이 명령을 실행할 때 비상 모드에 있어서는 안 됩니다.

경고:

이 CLI 명령을 오프호스트에서 사용할 때는 주의하고 새 인터페이스에 네트워크 연결이 되어 있는지 확인하십시오. 먼저 xe pif-reconfigure을 사용하여 설정하십시오. 그렇지 않으면 후속 CLI 명령이 XenServer 호스트에 연결할 수 없습니다.

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 server에서 풀에 대한 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-->

풀 암호를 순환합니다.

풀 암호는 호스트가 풀에 대한 멤버십을 증명할 수 있도록 풀의 XenServer 호스트 간에 공유되는 암호입니다. 풀 관리자 역할을 가진 사용자는 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 작업을 수행한 후 변경 사항이 신속하게 복제되도록 하는 데 유용할 수 있습니다.

https-only 설정

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

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

PVS 액셀러레이터 명령

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에는 다음 매개변수가 있습니다:

호스트 및 풀에서 SSH 액세스 관리

개요

XenServer 8.4에서는 dom0에 대한 SSH 액세스가 이제 기본적으로 활성화됩니다. 이 릴리스에서는 XenAPI 또는 xe 명령줄 인터페이스(CLI)를 사용하여 SSH 액세스를 프로그래밍 방식으로 제어하는 기능을 도입합니다.

이 개선 사항을 통해 관리자는 개별 호스트 및 전체 풀 수준에서 SSH 액세스를 관리할 수 있으며, 각 서버 콘솔과의 수동 상호 작용 필요성을 없앱니다.

장점

• 자동화된 관리: 개별 호스트 또는 전체 풀에서 SSH를 프로그래밍 방식으로 활성화하거나 비활성화합니다.

• 관리 오버헤드 감소: SSH 액세스 관리에 필요한 수동 관리 노력을 크게 줄입니다.

• 향상된 워크플로: 기존 관리 시스템에 SSH 제어를 통합하여 자동화 스크립트를 개선하고 보안 워크플로를 강화합니다.

호환성 및 주의사항

• 추가 요구 사항 없음: 이 기능은 추가 구성이나 특정 호환성 조정이 필요하지 않습니다.

• 서비스 동작: SSH를 비활성화하면 지정된 호스트에서 sshd 서비스가 중지되고 비활성화됩니다.

• 기존 세션: 서비스를 비활성화한 후에도 기존 SSH 세션은 활성 상태를 유지하며 중단되지 않습니다.

• 새 연결: SSH가 비활성화되면 새 연결 시도는 거부됩니다.

• 풀 전체 작업: 풀 내의 하나 이상의 호스트에서 오류가 발생하더라도 전체 풀에서 수행되는 작업은 계속됩니다.

실패한 작업에 대한 세부 정보가 포함된 요약 메시지가 제공됩니다.

CLI 구성

호스트에서 SSH 활성화

xe host-enable-ssh host=<host_uuid_or_name_label>
<!--NeedCopy-->

이 명령은 지정된 호스트에서 sshd 서비스를 시작하고 활성화합니다. 유효한 host 선택기에 대해서는 호스트 선택기를 참조하십시오. .

호스트에서 SSH 비활성화

xe host-disable-ssh host=<host_uuid_or_name_label>
<!--NeedCopy-->

이 명령은 지정된 호스트에서 sshd 서비스를 중지하고 비활성화합니다.

풀의 모든 호스트에서 SSH 활성화

xe pool-enable-ssh
<!--NeedCopy-->

이 명령은 현재 풀의 모든 호스트에서 sshd 서비스를 시작하고 활성화합니다.

풀의 모든 호스트에서 SSH 비활성화

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

이 명령은 현재 풀의 모든 호스트에서 sshd 서비스를 중지하고 비활성화합니다.

예시 출력 (풀 수준 작업)

xe pool-enable-ssh

Some of hosts failed to enable SSH access.
hosts: d734ff47-f429-4bd4-93f7-245cffbdc79e (genus-35-003d)
<!--NeedCopy-->

호스트가 실패하면 명령은 나머지 호스트 처리를 계속하고 마지막에 실패를 보고합니다.

스냅샷 명령

스냅샷 작업용 명령입니다.

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-uninstall을 사용하십시오.

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 레코드를 파괴하려면 snapshot-destroy를 사용하십시오.

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을 XenServer 호스트에 연결하는 PBD를 생성합니다. shared이 true로 설정된 경우, 풀의 각 XenServer 호스트에 대해 PBD가 생성됩니다. shared이 지정되지 않았거나 false로 설정된 경우, host-uuid로 지정된 XenServer 호스트에 대해서만 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-->

XenServer 호스트에서 지정된 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 에이전트가 XenServer 호스트에서 지정된 SR을 잊습니다. XAPI 에이전트가 SR을 잊으면 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을 사용하여 device-config:parameter_key=parameter_value 형식으로 추가 매개변수를 지정합니다. 예를 들어:

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 매개변수는 예를 들어 device-config:devs=/dev/sdb1과 같이 지정할 수 있습니다. sr-probe와 달리 이 명령은 모든 SR 유형에 대해 동일한 사람이 읽을 수 있는 형식으로 결과를 반환합니다.

sr-scan

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

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

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을 인스턴스화하는 데 필요한 모든 다양한 구성 설정을 포함하는 “골드 이미지”입니다. XenServer는 OS 공급업체 설치 CD(예: RHEL, CentOS, SLES, Windows)를 부팅할 수 있는 일반적인 “원시” VM인 기본 템플릿 세트와 함께 제공됩니다. VM을 생성하고, 특정 요구 사항에 맞게 표준 형식으로 구성한 다음, VM 배포에 나중에 사용할 템플릿으로 사본을 저장할 수 있습니다.

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

참고:

템플릿은 is-a-template 매개변수를 false로 설정하여 VM으로 직접 변환할 수 없습니다. is-a-template 매개변수를 false로 설정하는 것은 지원되지 않으며, 시작할 수 없는 VM이 생성됩니다.

VM 템플릿 매개변수

템플릿에는 다음 매개변수가 있습니다.

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

• 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 (읽기/쓰기 맵 매개변수) 선택한 vCPU 정책에 대한 구성 매개변수.
• VCPUs-max (읽기/쓰기) 최대 vCPU 수
• VCPUs-at-startup (읽기/쓰기) 부팅 시 vCPU 수
• actions-after-crash (읽기/쓰기) 이 템플릿을 기반으로 하는 VM이 충돌할 때 수행할 작업
• console-uuids (읽기 전용 세트 매개변수) 가상 콘솔 장치

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

  게스트에 대한 병렬 포트 에뮬레이션을 비활성화하려면:

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

  직렬 포트 에뮬레이션을 비활성화하려면:

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

  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-254 범위의 정수로 표시됩니다. 이 목록은 정보 제공용일 뿐이며, 다른 장치를 사용할 수도 있습니다(하지만 작동하지 않을 수 있습니다).
• allowed-VIF-devices (읽기 전용 설정 매개변수) 사용할 수 있는 VIF 식별자 목록으로, 0-6 범위의 정수로 표시됩니다. 이 목록은 정보 제공용일 뿐이며, 다른 장치를 사용할 수도 있습니다(하지만 작동하지 않을 수 있습니다).
• HVM-boot-policy (읽기/쓰기) 게스트의 부팅 정책입니다. BIOS 순서 또는 빈 문자열입니다.
• HVM-boot-params (읽기/쓰기 맵 매개변수) 순서 키는 게스트 부팅 순서를 제어하며, 각 문자가 부팅 방법인 문자열로 표시됩니다. d는 CD/DVD, c는 루트 디스크, n은 네트워크 PXE 부팅을 나타냅니다. 기본값은 dc입니다.
• PV-kernel (읽기/쓰기) 커널 경로
• PV-ramdisk (읽기/쓰기) initrd 경로
• PV-args (읽기/쓰기) 커널 명령줄 인수 문자열
• PV-legacy-args (읽기/쓰기) 이 템플릿을 기반으로 하는 레거시 VM을 부팅하기 위한 인수 문자열
• PV-bootloader (읽기/쓰기) 부트로더 이름 또는 경로
• PV-bootloader-args (읽기/쓰기) 부트로더에 대한 기타 인수 문자열
• last-boot-CPU-flags (읽기 전용) 이 템플릿을 기반으로 하는 VM이 마지막으로 부팅된 CPU 플래그를 설명합니다. 템플릿에는 채워지지 않습니다.
• resident-on (읽기 전용) 이 템플릿을 기반으로 하는 VM이 상주하는 XenServer 호스트입니다. 템플릿의 경우 not in database로 나타납니다.
• affinity (읽기/쓰기) 이 템플릿을 기반으로 하는 VM이 실행을 선호하는 XenServer 호스트입니다. xe vm-start 명령에서 VM을 실행할 위치를 결정하는 데 사용됩니다. 홈 서버라고도 합니다.
• groups (읽기/쓰기) 이 VM이 속한 VM 그룹입니다. VM 그룹은 XenServer가 VM을 시작하거나 대피시키려는 위치를 정의합니다.
• other-config (읽기/쓰기 맵 매개변수) 템플릿에 대한 추가 구성 매개변수를 지정하는 키-값 쌍 목록
• start-time (읽기 전용) 이 템플릿을 기반으로 하는 VM에 대한 메트릭이 읽힌 날짜 및 시간의 타임스탬프입니다. 형식은 yyyymmddThh:mm:ss z이며, 여기서 z는 단일 문자 군사 시간대 표시기(예: UTC(GMT)의 경우 Z)입니다. 템플릿의 경우 1 Jan 1970 Z (Unix/POSIX epoch 시작)으로 설정됩니다.
• install-time (읽기 전용) 이 템플릿을 기반으로 하는 VM에 대한 메트릭이 읽힌 날짜 및 시간의 타임스탬프입니다. 형식은 yyyymmddThh:mm:ss z이며, 여기서 z는 단일 문자 군사 시간대 표시기(예: UTC (GMT)의 경우 Z)입니다. 템플릿의 경우 1 Jan 1970 Z (Unix/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를 파괴합니다.

업데이트 명령

다음 섹션에는 XenServer 호스트 업데이트 명령이 포함되어 있습니다.

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

업데이트 매개변수

XenServer 호스트 업데이트에는 다음 매개변수가 있습니다.

update-upload

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

지정된 업데이트 파일을 XenServer 호스트에 업로드합니다. 이 명령은 적용할 업데이트를 준비합니다. 성공하면 업로드된 업데이트의 UUID가 출력됩니다. 업데이트가 이전에 업로드된 경우, UPDATE_ALREADY_EXISTS 오류가 반환되고 패치는 다시 업로드되지 않습니다.

update-precheck

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

지정된 업데이트에 포함된 사전 검사를 지정된 XenServer 호스트에서 실행합니다.

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

지정된 업데이트를 풀의 모든 XenServer 호스트에 적용합니다.

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는 VM을 가상 디스크의 내용을 나타내는 VDI에 연결하는 소프트웨어 개체입니다. 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-254 범위의 정수이며, 각 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를 VM에서 분리하려고 시도합니다.

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 맵 매개변수를 사용하여 VDI가 기반으로 하는 백엔드 스토리지 드라이버에 추가 공급업체별 구성 정보를 전달합니다. 자세한 내용은 스토리지 공급업체 드라이버 설명서를 참조하십시오.

vdi-copy

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

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

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에 대한 변경된 블록 추적을 활성화합니다.

참고:

XenServer Premium Edition의 라이선스 인스턴스에서만 변경된 블록 추적을 활성화할 수 있습니다.

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를 비교하고 두 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를 사용하여 템플릿을 만들 수 있습니다.

VDI가 기반으로 하는 백엔드 스토리지 드라이버에 추가 공급업체별 구성 정보를 전달하려면 선택적 driver-params 맵 매개변수를 사용하십시오. 자세한 내용은 스토리지 공급업체 드라이버 설명서를 참조하십시오.

스냅샷의 클론은 항상 쓰기 가능한 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의 최대 전송 단위(MTU).

  이 매개변수는 읽기 전용이지만, other-config 맵 매개변수를 사용하여 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 (읽기/쓰기 맵 매개변수) 선택한 QoS 알고리즘에 대한 매개변수
• qos_supported_algorithms (읽기 전용 설정 매개변수) 이 VIF에 대해 지원되는 QoS 알고리즘
• MAC-autogenerated (읽기 전용) VIF의 MAC 주소가 자동으로 생성된 경우 값은 true입니다.
• other-config (읽기/쓰기 맵 매개변수) 추가 구성 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/s)
• io_write_kbs (읽기 전용) 이 VIF의 평균 쓰기 속도(kB/s)
• locking_mode (읽기/쓰기) VIF가 MAC 및 IP 주소 목록으로/에서 트래픽을 필터링하는 기능에 영향을 줍니다. 추가 매개변수가 필요합니다.

• locking_mode:default (읽기/쓰기) VIF 네트워크의 기본 잠금 모드에 따라 달라집니다.

  default-locking-mode가 disabled으로 설정된 경우, XenServer는 VIF가 트래픽을 보내거나 받을 수 없도록 필터링 규칙을 적용합니다. default-lockingmode가 unlocked로 설정된 경우, XenServer는 VIF와 관련된 모든 필터링 규칙을 제거합니다. 자세한 내용은 네트워크 명령을 참조하십시오.

• locking_mode:locked (읽기/쓰기) 지정된 MAC 및 IP 주소로 보내거나 보낸 트래픽만 VIF에서 허용됩니다. IP 주소가 지정되지 않은 경우 트래픽은 허용되지 않습니다.
• locking_mode:unlocked (읽기/쓰기) VIF로/에서 이동하는 트래픽에는 필터가 적용되지 않습니다.
• locking_mode:disabled (읽기/쓰기) XenServer는 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-6 사이의 정수 값이 허용됩니다.

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를 VM에서 분리하려고 시도합니다.

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

XenServer 호스트에 VLAN을 생성합니다.

pool-vlan-create

xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->

풀의 모든 호스트에 VLAN을 생성합니다. 각 호스트에서 지정된 네트워크가 있는 인터페이스(예: eno12429np0)를 확인한 다음, 각 호스트에 새 PIF 개체를 생성하고 연결합니다.

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를(을) 호출하십시오.
• user-version (읽기/쓰기) VM 및 템플릿 생성자가 버전 정보를 넣기 위한 문자열

• 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 (읽기/쓰기 맵 매개변수) 선택한 vCPU 정책에 대한 구성 매개변수.
• 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 (읽기/쓰기 맵 매개변수) 플랫폼별 구성

  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 (읽기 전용 설정 매개변수) 0-254 범위의 정수로 표시되는 사용 가능한 VBD 식별자 목록입니다. 이 목록은 정보 제공용이며, 다른 장치를 사용할 수도 있습니다(하지만 작동하지 않을 수 있음).
• allowed-VIF-devices (읽기 전용 설정 매개변수) 0-6 범위의 정수로 표시되는 사용 가능한 VIF 식별자 목록입니다. 이 목록은 정보 제공용이며, 다른 장치를 사용할 수도 있습니다(하지만 작동하지 않을 수 있음).
• HVM-boot-policy (읽기/쓰기) 게스트의 부팅 정책. BIOS 순서 또는 빈 문자열입니다.
• HVM-boot-params (읽기/쓰기 맵 매개변수) 순서 키는 게스트 부팅 순서를 제어하며, 각 문자가 부팅 방법을 나타내는 문자열로 표시됩니다. d는 CD/DVD, c는 루트 디스크, n은 네트워크 PXE 부팅을 의미합니다. 기본값은 dc입니다.
• HVM-shadow-multiplier (읽기/쓰기) VM에 할당할 섀도우 메모리 오버헤드 양을 제어하는 부동 소수점 값입니다. 기본값은 1.0(최소값)이며, 고급 사용자만 이 값을 변경해야 합니다.
• PV-kernel (읽기/쓰기) 커널 경로
• PV-ramdisk (읽기/쓰기) initrd 경로
• PV-args (읽기/쓰기) 커널 명령줄 인수 문자열
• PV-legacy-args (읽기/쓰기) 레거시 VM을 부팅하기 위한 인수 문자열
• PV-bootloader (읽기/쓰기) 부트로더 이름 또는 경로
• PV-bootloader-args (읽기/쓰기) 부트로더에 대한 기타 인수 문자열
• last-boot-CPU-flags (읽기 전용) VM이 마지막으로 부팅된 CPU 플래그를 설명합니다.
• resident-on (읽기 전용) VM이 상주하는 XenServer 호스트
• affinity (읽기/쓰기) VM이 실행될 것을 선호하는 XenServer 호스트입니다. xe vm-start 명령에서 VM을 실행할 위치를 결정하는 데 사용됩니다. 홈 서버라고도 합니다.
• groups (읽기/쓰기) 이 VM이 속한 VM 그룹입니다. VM 그룹은 XenServer가 VM을 시작하거나 마이그레이션할 위치를 정의합니다.

• other-config (읽기/쓰기 맵 매개변수) 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에 할당된 가상 CPU 수입니다. 이 수는 VCPUS-max와 다를 수 있으며, vm-vcpu-hotplug 명령을 사용하여 VM을 재부팅하지 않고 변경할 수 있습니다. 자세한 내용은 vm-vcpu-hotplug를 참조하십시오. Windows VM은 항상 VCPUsmax로 설정된 vCPU 수로 실행되며, 이 값을 변경하려면 재부팅해야 합니다. VCPUs-number를 XenServer 호스트의 물리적 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 (읽기/쓰기 맵 매개변수) 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 (읽기/쓰기 맵 매개변수) 이 VM에서 수행할 수 없는 작업을 나열합니다.
• last-boot-record (읽기 전용) 이 템플릿의 마지막 부팅 매개변수 기록 (XML 형식)
• ha-always-run (읽기/쓰기) 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-->

주어진 VM에서 플러그인 내의 함수를 선택적 인수(args:key=value)와 함께 호출합니다. 특수 문자(예: 새 줄)가 포함된 “value” 문자열을 전달하려면, 대신 대체 구문 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를 추가합니다. 0-3 범위에서 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(copy-on-write) 체인의 일부가 아닙니다.

결과로 생성되는 복사된 VM의 이름과 선택적 설명을 new-name-label 및 new-name-description 인수를 사용하여 지정합니다.

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 옵션을 지정하지 않으면 VDI를 찾을 수 없는 경우(SR 및 VDI.location로 명명됨) 메타데이터 전용 가져오기가 실패하며, 이 옵션을 지정하면 가져오기가 계속 진행됩니다. 디스크를 미러링하거나 대역 외로 이동할 수 있는 경우, 메타데이터 가져오기/내보내기는 분리된 풀 간에 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에 메모리를 할당하기 위한 일반 메모리 계산과 분리됩니다. 이 명령이 호출되면 승수에 따라 사용 가능한 호스트 메모리 양이 감소하고 Xen이 VM에 할당한 값으로 HVM_shadow_multiplier 필드가 업데이트됩니다. XenServer 호스트 메모리가 충분하지 않으면 오류가 반환됩니다.

이 작업을 수행할 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 [compress=true|false] [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을 물리적 호스트 간에 마이그레이션합니다.

compress 매개변수는 xe pool-param-set에 대한 migration-compression 풀 매개변수를 재정의합니다.

vm-migrate 명령의 host 매개변수는 XenServer 호스트의 이름 또는 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:source_vif_uuid=destination_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 마이그레이션을 참조하십시오.

참고:

이전 버전의 XenServer에서 업그레이드하는 경우, 새로운 가상화 기능이 적용되도록 VM을 마이그레이션한 후 모든 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 매개변수 중 여러 개가 될 수 있습니다.

이것은 풀의 멤버 호스트가 다운될 때만 사용해야 하는 고급 명령입니다. 이 명령을 사용하여 풀 코디네이터가 VM의 전원 상태를 halted으로 재설정하도록 강제할 수 있습니다. 본질적으로 이 명령은 VM 및 해당 디스크에 대한 잠금을 강제하여 다른 풀 호스트에서 다음에 시작할 수 있도록 합니다. 이 호출은 force 플래그를 지정해야 하며, 명령줄에 없으면 실패합니다.

vm-restart-device-models

xe vm-restart-device-models [vm-selector=vm_selector_value...]
<!--NeedCopy-->

호스트에서 이 VM의 장치 모델을 다시 시작합니다. 장치 모델이 다시 시작되는 동안 VM을 중지, 시작 또는 마이그레이션할 수 없습니다. VM의 최종 사용자는 세션에서 약간의 일시 중지 및 재개를 경험할 수 있습니다.

참고:

Windows VM에서 장치 모델 다시 시작 작업이 지원되려면 VM에 XenServer VM Tools for Windows가 설치되어 있어야 합니다.

vm-resume

xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
<!--NeedCopy-->

지정된 VM을 재개합니다.

이 작업이 수행되는 VM 또는 VM들은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를 참조하십시오. 선택적 인수는 이 섹션 시작 부분에 나열된 VM 매개변수 중 여러 개가 될 수 있습니다.

VM이 호스트 풀의 공유 SR에 있는 경우, on 인수를 사용하여 어떤 풀 멤버에서 시작할지 지정합니다. 기본적으로 시스템은 적절한 호스트를 결정하며, 이는 풀의 멤버 중 하나일 수 있습니다.

vm-retrieve-wlb-recommendations

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

선택한 VM에 대한 워크로드 밸런싱 권장 사항을 검색합니다.

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은 항상 vCPU 수가 VCPUs-max로 설정된 상태로 실행되며, 이 값을 변경하려면 재부팅해야 합니다.

이 명령을 실행한 후 가질 새로운 총 vCPU 수를 정의하려면 new-vcpus 매개변수를 사용하십시오. 추가하려는 vCPU 수를 전달하는 데 이 매개변수를 사용하지 마십시오. 예를 들어, VM에 기존 vCPU가 두 개 있고 vCPU 두 개를 더 추가하려면 new-vcpus=4를(을) 지정하십시오.

이 작업이 수행되는 Linux VM 또는 Windows VM은 표준 선택 메커니즘을 사용하여 선택됩니다. 자세한 내용은 VM 선택기를(을) 참조하십시오. 선택적 인수는 이 섹션 시작 부분에 나열된 VM 매개변수 중 임의의 수만큼 포함될 수 있습니다.

참고:

XenServer VM Tools가 설치되지 않은 Linux VM을 실행할 때, 새로 핫 플러그된 vCPU가 사용되도록 하려면 VM에서 root으로 다음 명령을 실행하십시오: # 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 목록을 제거합니다.

VM 그룹 명령

VM 그룹 및 해당 속성을 제어하는 명령입니다.

VM 그룹 매개변수

• uuid (읽기 전용) VM의 고유 식별자/객체 참조
• name-label (읽기/쓰기) VM의 이름
• name-description (읽기/쓰기) VM의 설명 문자열
• placement (읽기 전용) 그룹 내 VM에 적용할 배치 규칙 유형. 사용 가능한 값은 anti-affinity 및 normal입니다.

VM 그룹 목록

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

이 풀의 모든 VM 그룹을 나열합니다.

VM 그룹 생성

xe vm-group-create placement=anti-affinity|normal name-label=<name-label> [name-description=<name-description>]
<!--NeedCopy-->

VM 그룹을 생성합니다.

VM 그룹 삭제

xe vm-group-destroy uuid=<vm-group-uuid>
<!--NeedCopy-->

이 VM 그룹을 삭제합니다. VM이 포함된 VM 그룹을 삭제하면 해당 VM은 더 이상 그룹과 연결되지 않지만, 그 외에는 영향을 받지 않습니다.