Citrix Hypervisor

Windows용 XenServer VM Tools

December 11, 2023

제공::

Windows용 XenServer VM 도구 (이전 명칭은 Citrix VM Tools) 는 기존 장치 에뮬레이션의 오버헤드 없이 고성능 I/O 서비스를 제공합니다. Windows용 XenServer VM Tools는 I/O 드라이버 (반가상화 드라이버 또는 PV 드라이버라고도 함)와 관리 에이전트로 구성됩니다.

VM이 완벽하게 지원되는 구성을 가지려면 각 Windows VM에 Windows용 XenServer VM Tools가 설치되어 있어야 합니다. 이러한 기능 없이도 VM은 작동하지만 성능이 저하됩니다.

Windows용 XenServer VM 도구 버전은 Citrix Hypervisor의 버전과 독립적으로 업데이트됩니다. VM과 VM을 만드는 데 사용하는 템플릿 모두에서 Windows용 XenServer VM Tools가 정기적으로 최신 버전으로 업데이트되는지 확인합니다. 최신 버전의 도구에 대한 자세한 내용은 Windows용 XenServer VM Tools 업데이트 또는 새로운 소식을 참조하십시오.

XenServer VM Tools 설치

참고:

Windows VM에 XenServer VM Tools를 설치하려면 VM에서 Microsoft .NET Framework 버전 4.0 이상을 실행해야 합니다.

Windows용 XenServer VM Tools를 설치하기 전에 VM이 Windows 업데이트에서 I/O 드라이버를 수신하도록 구성되어 있는지 확인합니다. Windows 업데이트는 I/O 드라이버에 대한 업데이트를 수신하는 데 권장되는 방법입니다. 그러나 VM에서 Windows Update를 사용할 수 없는 경우 관리 에이전트를 통해 I/O 드라이버에 대한 업데이트를 받거나 드라이버를 수동으로 업데이트할 수도 있습니다. 자세한 내용은 I/O 드라이버 업데이트를 참조하십시오.

Windows용 XenServer VM Tools를 설치하려면 다음을 수행하십시오.

XenServer VM Tools를 설치하거나 업데이트하기 전에 VM의 스냅샷을 생성하는 것이 좋습니다.
Citrix Hypervisor다운로드 페이지에서 Windows용 XenServer VM 도구 파일을 다운로드하십시오.
1. 다운로드 가능한 파일에 액세스하려면 Citrix 계정에 로그인합니다.
2. Citrix Hypervisor 다운로드 페이지에서 제품 섹션을 펼치고 지원되는 Citrix Hypervisor 버전을 클릭합니다.
3. 제품 페이지에서 Citrix Hypervisor 주요 구성 요소 섹션으로 이동합니다.
  
  Windows용 XenServer VM 도구는 32비트 및 64비트 버전으로 제공됩니다.
4. MSI 파일을 다운로드하고 제공된 SHA256 값과 비교하여 다운로드를 확인합니다.
파일을 Windows VM이나 Windows VM이 액세스할 수 있는 공유 드라이브에 복사합니다.
managementagentxXX.msi 파일을 실행하여 XenServer VM Tools 설치를 시작합니다.
```
Msiexec.exe /package managementagentxXX.msi
```
설치 프로그램의 프롬프트를 따릅니다.
- 마법사의 지침에 따라 라이센스 계약에 동의하고 대상 폴더를 선택합니다.
- 설치 및 업데이트 설정 페이지에서 설정을 사용자 지정합니다. Citrix Hypervisor Windows 관리 에이전트 설치 마법사에 권장 설정이 표시됩니다. 기본적으로 마법사에는 다음 설정이 표시됩니다.
  - 지금 I/O 드라이버 설치
  - 자동 관리 에이전트 업데이트 허용
  - 관리 에이전트에 의한 자동 I/O 드라이버 업데이트 허용 안 함
  - Citrix에 익명 사용 정보 보내기
  Management Agent의 자동 업데이트를 허용하지 않으려면 목록에서 자동 관리 에이전트 업데이트 허용 안 함을 선택합니다.
  
  Management Agent가 I/O 드라이버를 자동으로 업데이트하도록 허용하려면 관리 에이전트에 의한 자동 I/O 드라이버 업데이트 허용을 선택합니다. 그러나 Windows 업데이트를 사용하여 관리 에이전트가 아닌 I/O 드라이버를 업데이트하는 것이 좋습니다.
  
  참고:
  
  Windows 업데이트 메커니즘을 통해 I/O 드라이버 업데이트를 받도록 선택한 경우 관리 에이전트가 I/O 드라이버를 자동으로 업데이트하도록 허용하지 마십시오.
  
  익명 사용 정보를 Citrix와 공유하지 않으려면 익명 사용 정보를 Citrix로 보내기 확인란의 선택을 취소합니다. Citrix로 전송되는 정보에는 업데이트를 요청하는 VM의 UUID가 포함되어 있습니다. VM과 관련된 다른 정보는 수집되거나 Citrix로 전송되지 않습니다.
- 다음을 클릭한 후 설치를 클릭하여 Windows용 XenServer VM Tools 설치 프로세스를 시작합니다.
설치 프로세스를 완료하라는 메시지가 표시되면 VM을 다시 시작합니다.

참고:

Windows용 XenServer VM Tools는 VM을 설치의 일부로 한 번 다시 시작한 후 /quiet /norestart 또는 /quiet /forcerestart를 지정한 상태로 다시 시작하도록 요청할 수 있습니다.

I/O 드라이버는 Windows 업데이트에서 업데이트를 받을 수 있는 Windows VM에 자동으로 설치됩니다. 그러나 관리 에이전트를 설치하고 지원되는 구성을 유지 관리하려면 Windows용 XenServer VM Tools를 설치하는 것이 좋습니다.

Windows용 XenServer VM Tools 또는 RDP를 통해 관리 에이전트를 설치하는 고객은 Windows 콘솔 세션에만 나타나므로 다시 시작 프롬프트가 표시되지 않을 수 있습니다. 필요한 경우 VM을 다시 시작하고 VM을 최적화된 상태로 전환하려면 RDP에서 강제 다시 시작 옵션을 지정합니다. 강제 재시작 옵션은 VM을 최적화된 상태로 가져와야 하는 경우에만 VM을 다시 시작합니다.

자동 설치

Windows용 XenServer VM Tools를 자동으로 설치하고 시스템이 재부팅되지 않도록 하려면 다음 명령 중 하나를 실행합니다.

Msiexec.exe /package managementagentx86.msi /quiet /norestart
Msiexec.exe /package managementagentx64.msi /quiet /norestart
<!--NeedCopy-->

또는

Setup.exe /quiet /norestart
<!--NeedCopy-->

다음 명령을 실행하면 비대화식의 수동 설치를 수행할 수 있습니다.

Msiexec.exe managementagentx86.msi /passive
Msiexec.exe managementagentx64.msi /passive
<!--NeedCopy-->

또는

Setup.exe /passive
<!--NeedCopy-->

설치 설정을 사용자 지정하려면 자동 설치 명령과 함께 다음 매개 변수를 사용합니다.

매개 변수	허용된 값	기본값	설명
ALLOWAUTOUPDATE	예 또는 아니요	예	자동 관리 에이전트 업데이트 허용
ALLOWDRIVERINSTALL	예 또는 아니요	예	지금 I/O 드라이버 설치
ALLOWDRIVERUPDATE	예 또는 아니요	아니요	자동 관리 에이전트 업데이트가 업데이트된 드라이버를 설치하도록 허용
IDENTIFYAUTOUPDATE	예 또는 아니요	예	Citrix에 익명 사용 정보 보내기

예를 들어 향후 자동 관리 에이전트 업데이트를 허용하지 않고 익명 정보를 Citrix에 보내지 않는 도구를 자동 설치하려면 다음 명령 중 하나를 실행합니다.

Msiexec.exe /package managementagentx86.msi ALLOWAUTOUPDATE=NO IDENTIFYAUTOUPDATE=NO /quiet /norestart
Msiexec.exe /package managementagentx64.msi ALLOWAUTOUPDATE=NO IDENTIFYAUTOUPDATE=NO /quiet /norestart
<!--NeedCopy-->

대화식, 자동 및 수동 설치의 경우 다음에 시스템을 다시 시작한 후 Windows용 XenServer VM Tools가 완전히 설치되기 전에 여러 자동 재부팅이 발생할 수 있습니다. 이 동작은 /norestart 플래그가 지정된 설치의 경우에도 마찬가지입니다. 그러나 /norestart 플래그가 제공되는 설치의 경우 초기 다시 시작이 수동으로 시작될 수 있습니다.

Windows용 XenServer VM Tools는 기본적으로 VM의 C:\Program Files\Citrix\XenTools 디렉터리에 설치됩니다.

참고:

Windows VM에 XenServer VM Tools를 설치하려면 VM에서 Microsoft .NET Framework 버전 4.0 이상을 실행해야 합니다.

이 /quiet 매개 변수는 설치 대화상자에만 적용되지만 장치 드라이버 설치에는 적용되지 않습니다. /quiet 매개 변수를 지정하면 장치 드라이버 설치에서 필요한 경우 재부팅 권한을 요청합니다.

/quiet /norestart를 지정하면 전체 도구 설치가 완료된 후 시스템이 재부팅되지 않습니다. 이 동작은 사용자가 재부팅 대화 상자에서 지정하는 것과 무관합니다.

/quiet /forcerestart를 지정하면 전체 도구 설치가 완료된 후 시스템이 재부팅됩니다. 이 동작은 사용자가 재부팅 대화 상자에서 지정하는 것과 무관합니다.

장치 드라이버 설치가 재부팅 권한을 요청하는 경우 지정된 quiet 매개 변수를 사용하는 도구 설치가 계속 진행 중일 수 있습니다. 작업 관리자를 사용하여 설치 프로그램이 아직 실행 중인지 확인합니다.

경고:

Windows용 XenServer VM Tools를 설치하거나 업그레이드하면 일부 네트워크 어댑터의 이름 및 식별자가 변경될 수 있습니다. 특정 어댑터를 사용하도록 구성된 모든 소프트웨어는 Windows용 XenServer VM Tools 설치 또는 업그레이드에 따라 다시 구성해야 할 수 있습니다.

Windows용 XenServer VM Tools 업데이트

Citrix Hypervisor에는 Windows VM용 I/O 드라이버 (PV 드라이버) 및 관리 에이전트를 자동으로 업데이트하는 간단한 메커니즘이 있습니다. 이 메커니즘을 사용하면 업데이트가 제공되는 대로 설치할 수 있습니다.

VM과 VM을 만드는 데 사용하는 템플릿 모두에서 Windows용 XenServer VM Tools가 정기적으로 최신 버전으로 업데이트되는지 확인합니다.

XenServer VM Tools를 설치하거나 업데이트하기 전에 VM의 스냅샷을 생성하는 것이 좋습니다.

중요:

현재 8.2.x.x 이전 버전의 드라이버를 사용 중이고 Management Agent MSI 파일을 사용하여 최신 버전의 드라이버로 업데이트하려는 경우 이러한 드라이버를 설치하기 전에 장치 관리자를 사용하여 VM에서 8.2.x.x 드라이버를 제거해야 합니다. 이 단계를 완료하지 않으면 MSI 설치 프로세스가 실패합니다.

Windows용 XenServer VM Tools의 여러 구성 요소를 업데이트하려면 다음 설정을 사용하는 것이 좋습니다.

다음 레지스트리 키의 값을 REG_DWORD 값 ‘3’ 으로 설정합니다. HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot
VM이 Windows 업데이트에서 I/O 드라이버를 수신하도록 구성되어 있는지 확인합니다.
자동으로 업데이트되도록 관리 에이전트를 구성합니다.

Citrix Hypervisor 센터의 VM의 일반 탭에 있는 가상화 상태 섹션에서는 VM이 Windows 업데이트에서 업데이트를 수신할 수 있는지 여부를 지정합니다. Windows 업데이트에서 I/O 드라이버 업데이트를 수신하는 메커니즘은 기본적으로 설정되어 있습니다. Windows 업데이트에서 I/O 드라이버 업데이트를 수신하지 않으려면 VM에서 Windows 업데이트를 사용하지 않도록 설정하거나 그룹 정책을 지정합니다.

중요:

요청된 모든 VM 다시 시작이 업데이트의 일부로 완료되었는지 확인합니다. 여러 번 다시 시작해야 할 수 있습니다. 요청한 모든 재시작이 완료되지 않으면 예기치 않은 동작이 발생할 수 있습니다.

다음 섹션에는 I/O 드라이버 및 관리 에이전트의 자동 업데이트에 대한 정보가 수록되어 있습니다.

I/O 드라이버 업데이트

다음과 같은 경우 Microsoft Windows 업데이트에서 I/O 드라이버 업데이트를 자동으로 받을 수 있습니다.

Citrix Hypervisor 8.2 프리미엄 에디션을 실행 중이거나 Citrix Virtual Apps and Desktops 또는 Citrix DaaS 권한을 통해 Citrix Hypervisor에 액세스할 수 있습니다.
Citrix Hypervisor 8.2와 함께 발행된 Citrix Hypervisor 센터를 사용하여 Windows VM을 만들었습니다.
VM 내에 Windows 업데이트가 사용하도록 설정되었음
VM이 인터넷에 액세스할 수 있거나 WSUS 프록시 서버에 연결할 수 있음

참고:

Windows Server Core는 Windows 업데이트를 사용하여 I/O 드라이버를 설치하거나 업데이트하는 것을 지원하지 않습니다. 대신 Citrix Hypervisor 다운로드 페이지에서 제공되는 Windows용 XenServer VM 도구 설치 프로그램을 사용하십시오. XenServer VM 도구는 지원되는 모든 버전의 Citrix Hypervisor에서 다운로드 가능한 구성 요소로 사용할 수 있습니다. 이러한 다운로드에 액세스하려면 Citrix 계정에 로그인해야 합니다.

고객은 또한 관리 에이전트의 자동 업데이트 메커니즘을 통해 I/O 드라이버 업데이트를 받을 수 있습니다. Windows용 XenServer VM Tools를 설치하는 동안 이 설정을 구성할 수 있습니다. 자세한 내용은 Windows용 XenServer VM Tools 설치를 참조하십시오.

자동 재부팅

요청된 모든 VM 다시 시작이 업데이트의 일부로 완료되었는지 확인합니다. 여러 번 다시 시작해야 할 수 있습니다. 요청한 모든 재시작이 완료되지 않으면 예기치 않은 동작이 발생할 수 있습니다.

장치 관리자 또는 Windows Update를 통해 드라이버를 설치할 때 수행되는 최대 자동 재부팅 수를 지정하는 레지스트리 키를 설정할 수 있습니다. xenbus 드라이버 버전 9.1.1.8 이상을 설치한 후에는 Windows용 XenServer VM Tools에서 이 레지스트리 키에서 제공하는 지침을 사용합니다.

이 기능을 사용하려면 가능한 한 빨리 다음 레지스트리 키를 설정하는 것이 좋습니다 HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot. 레지스트리 키 값은 양의 정수여야 합니다. 레지스트리 키의 재부팅 횟수를 3으로 설정하는 것이 좋습니다.

이 레지스트리 키를 설정하면 Windows용 XenServer VM Tools가 업데이트를 완료하는 데 필요한 횟수만큼 재부팅을 수행하거나 레지스트리 키로 지정된 재부팅 횟수 중 더 낮은 값을 반환합니다.

다시 부팅하기 전에 Windows는 60초 동안 다음 재부팅을 경고하는 경고를 표시할 수 있습니다. 경고를 무시할 수 있지만 이 작업을 수행해도 재부팅이 취소되지는 않습니다. 이러한 재부팅 사이의 지연으로 인해 초기 재부팅 후 재부팅 주기가 완료될 때까지 몇 분 정도 기다리십시오.

참고:

이 설정은 고정 IP 주소가 있는 헤드리스 서버에 필요합니다.

이 자동 재부팅 기능은 장치 관리자 또는 Windows 업데이트를 통한 Windows I/O 드라이버 업데이트에만 적용됩니다. Management Agent 설치 관리자를 사용하여 드라이버를 배포하는 경우 설치 관리자는 이 레지스트리 키를 무시하고 자체 설정에 따라 VM 재부팅을 관리합니다.

I/O 드라이버 버전 찾기

VM에 설치된 I/O 드라이버 버전을 찾으려면:

C:\Windows\System32\drivers로 이동합니다.
목록에서 드라이버를 찾습니다.
드라이버를 마우스 오른쪽 단추로 클릭하고 속성, 세부 정보순으로 선택합니다.

파일 버전 필드에는 VM에 설치된 드라이버의 버전이 표시됩니다.

관리 에이전트 업데이트

Citrix Hypervisor를 사용하면 새 Windows VM과 기존 Windows VM 모두에서 관리 에이전트를 자동으로 업데이트할 수 있습니다. 기본적으로 Citrix Hypervisor 관리 에이전트의 자동 업데이트를 허용합니다. 하지만 관리 에이전트가 I/O 드라이버를 자동으로 업데이트하는 것은 허용하지 않습니다. Windows용 XenServer VM Tools를 설치하는 동안 관리 에이전트 업데이트 설정을 사용자 지정할 수 있습니다. 관리 에이전트의 자동 업데이트는 운영 중단 없이 수행되므로 VM이 재부팅되지 않습니다. VM 재부팅이 필요한 시나리오에서는 VM의 Console 탭에 사용자에게 필요한 작업에 대해 알리는 메시지가 나타납니다.

다음과 같은 경우 Management Agent 업데이트를 자동으로 받을 수 있습니다.

Citrix Hypervisor 8.2 프리미엄 에디션을 실행 중이거나 Citrix Virtual Apps and Desktops 또는 Citrix DaaS 권한을 통해 Citrix Hypervisor에 액세스할 수 있습니다.
Citrix Hypervisor 7.0 이상에서 발급된 Windows용 XenServer VM Tools를 설치했습니다.
Windows VM에서 인터넷에 액세스할 수 있음

관리 에이전트 버전 찾기

VM에 설치된 관리 에이전트 버전을 찾으려면:

C:\Program Files\Citrix\XenTools로 이동합니다.
목록에서 XenGuestAgent를 마우스 오른쪽 버튼을 클릭하고 속성 을 클릭한 다음 세부 정보를 클릭합니다.

파일 버전 필드에는 VM에 설치된 관리 에이전트의 버전이 표시됩니다.

CLI를 사용하여 자동 업데이트 관리

Citrix Hypervisor를 사용하면 명령줄을 사용하여 I/O 드라이버 및 관리 에이전트의 자동 업데이트를 관리할 수 있습니다. 다음 표에 나열된 인수를 사용하여 msiexec.exe를 실행하여 I/O 드라이버 및 Management Agent가 자동으로 업데이트되는지 여부를 지정할 수 있습니다. msiexec.exe을(를) 사용하여 Windows용 XenServer VM Tools를 설치하는 방법에 대한 자세한 내용은 자동 설치를 참조하십시오.

참고:

PVS 또는 MCS를 사용하여 관리되는 VM의 경우 Citrix Virtual Desktops VDA가 있고 시스템이 비영구적이라고 보고하면 자동 업데이트가 자동으로 해제됩니다.

인수	값	설명
ALLOWAUTOUPDATE	예/아니요	관리 에이전트 자동 업데이트 허용/허용 안 함
ALLOWDRIVERINSTALL	예/아니요	Windows용 XenServer VM Tools 설치 관리자가 I/O 드라이버를 설치하도록 허용/허용 안 함
ALLOWDRIVERUPDATE	예/아니요	관리 에이전트가 I/O 드라이버를 자동으로 업데이트하도록 허용/허용 안 함
IDENTIFYAUTOUPDATE	예/아니요	자동 업데이트 메커니즘이 익명 사용 정보를 Citrix로 보내도록 허용/허용 안 함

예:

setup.exe  /passive /forcerestart ALLOWAUTOUPDATE=YES ALLOWDRIVERINSTALL=NO \
     ALLOWDRIVERUPDATE=NO IDENTIFYAUTOUPDATE=YES
<!--NeedCopy-->

또는

msiexec.exe /i managementagentx64.msi ALLOWAUTOUPDATE=YES ALLOWDRIVERINSTALL=NO \
    ALLOWDRIVERUPDATE=NO IDENTIFYAUTOUPDATE=YES
<!--NeedCopy-->

관리 에이전트 업데이트 리디렉션

Citrix Hypervisor를 사용하면 고객이 관리 에이전트 업데이트를 설치하기 전에 내부 웹 서버로 리디렉션할 수 있습니다. 이 리디렉션을 통해 고객은 VM에 자동으로 설치되기 전에 업데이트를 검토할 수 있습니다.

관리 에이전트 업데이트를 리디렉션하려면 다음과 같이 하십시오.

Management Agent는 업데이트 파일을 사용하여 사용 가능한 업데이트에 대한 정보를 가져옵니다. 이 업데이트 파일의 이름은 사용하는 Management Agent의 버전에 따라 다릅니다.

관리 에이전트 9.2.1.35 이상에서는 https://pvupdates.vmd.citrix.com/autoupdate.v1.json를 사용합니다.
관리 에이전트 9.0.0.0부터 9.2.0.27 https://pvupdates.vmd.citrix.com/updates.v9.json까지 사용할 수 있습니다.

Management Agent 업데이트를 리디렉션하려면 다음 단계를 완료하십시오.

업데이트 파일을 다운로드합니다.
업데이트 파일에서 참조하는 관리 에이전트 MSI 파일을 다운로드합니다.
VM이 액세스할 수 있는 내부 웹 서버에 MSI 파일을 업로드합니다.
내부 웹 서버의 MSI 파일을 가리키도록 업데이트 파일을 업데이트합니다.
업데이트 파일을 웹 서버에 업로드합니다.

VM별 또는 풀별 기반으로 자동 업데이트를 리디렉션할 수도 있습니다. VM별 기반으로 업데이트를 리디렉션하려면

VM에서 관리자로 명령 프롬프트를 엽니다.

다음 명령을 실행합니다.

reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools /t REG_SZ /v update_url /d \
    url of the update file on the web server
<!--NeedCopy-->

풀별 기반으로 관리 에이전트의 자동 업데이트를 리디렉션하려면 다음 명령을 실행합니다.

xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_url=url of the update file on the web server
<!--NeedCopy-->

관리 에이전트 업데이트 사용 안 함

VM별로 관리 에이전트의 자동 업데이트를 사용하지 않도록 설정하려면 다음과 같이 하십시오.

VM에서 관리자로 명령 프롬프트를 엽니다.

다음 명령을 실행합니다.

reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools /t REG_DWORD /v DisableAutoUpdate /d 1
<!--NeedCopy-->

풀별 기반으로 관리 에이전트의 자동 업데이트를 사용하지 않도록 설정하려면 다음 명령을 실행합니다.

xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_enabled=false
<!--NeedCopy-->

자동 I/O 드라이버 업데이트 설정 수정

Windows용 XenServer VM Tools를 설치하는 동안 관리 에이전트가 I/O 드라이버를 자동으로 업데이트하도록 허용할지 여부를 지정할 수 있습니다. Windows용 XenServer VM Tools 설치 프로세스를 완료한 후 이 설정을 업데이트하려면 다음 단계를 수행하십시오.

VM에서 관리자로 명령 프롬프트를 엽니다.

다음 명령을 실행합니다.

reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate /t REG_SZ /v \
    InstallDrivers /d YES/NO
<!--NeedCopy-->

익명 사용 정보를 Citrix에 보내려면:

Windows용 XenServer VM Tools를 설치하는 동안 익명 사용 정보를 Citrix에 보낼지 여부를 지정할 수 있습니다. Windows용 XenServer VM Tools 설치 프로세스를 완료한 후 이 설정을 업데이트하려면 다음 단계를 수행하십시오.

VM에서 관리자로 명령 프롬프트를 엽니다.

다음 명령을 실행합니다.

reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate REG_SZ /v \
    IDENTIFYAUTOUPDATE /d YES/NO
<!--NeedCopy-->

Windows용 XenServer VM Tools 제거

Windows VM에서 XenServer VM Tools를 제거하지 않는 것이 좋습니다. Windows VM을 완벽하게 지원하려면 이러한 도구가 필요합니다. 제거하면 예기치 않은 동작이 발생할 수 있습니다. 최후의 수단으로만 XenServer VM Tools를 수동으로 제거하십시오.

표준 제거

XenServer VM Tools 표준 제거를 수행하려면 Windows 프로그램 추가/제거 기능을 사용합니다.

시작하기 전에 VM의 스냅샷을 생성합니다.
Windows VM에서 프로그램 추가/제거로 이동합니다.
Citrix Hypervisor PV Tools를 선택하고 제거를 클릭합니다.
VM을 재부팅합니다.

`uninstall.exe` 명령

Windows 프로그램 추가/제거 기능을 사용하여 XenServer VM Tools를 제거하면 <tools-install-directory>\uninstall.exe 파일이 호출되어 제거 작업이 수행됩니다. 대신 관리자 권한으로 PowerShell 터미널이나 명령 프롬프트에서 이 명령을 호출하도록 선택할 수도 있습니다.

시작하기 전에 VM의 스냅샷을 생성합니다.
관리자로 명령 프롬프트 또는 PowerShell 터미널을 엽니다.
<tools-install-directory>\uninstall.exe 명령을 실행합니다.
VM을 재부팅합니다.

명령 옵션

이 uninstall.exe 명령은 다음 매개 변수를 받아들입니다.

help - 명령의 사용 정보를 표시합니다.
log - 명령이 수행한 작업을 나타내는 로그 파일을 생성합니다.
verbose - 명령이 수행한 작업을 콘솔에 출력합니다.
disable - 설치 프로그램 MSI로 설치한 드라이버를 비활성화합니다.
force-disable - 모든 상황에서 드라이버를 비활성화합니다.
hidden - 숨겨진 장치를 삭제합니다. 이러한 장치는 사용되지 않고 대체되었지만 오래된 레지스트리 항목이 남아 있을 수 있습니다.
cleanup - 프로그램 추가/제거에서 이전 제거 프로그램을 제거합니다. 이러한 제거 프로그램에는 이전 버전 도구의 중복된 항목이 포함될 수 있습니다.
purge - (9.3.1 이상) VM을 XenServer VM Tools의 일부가 설치되기 전의 깨끗한 상태로 재설정합니다. 자세한 내용은 모든 XenServer VM Tools 구성 요소 전체 제거를 참조하십시오.
install - (9.3.1 이상) 현재 I/O 드라이버 세트를 설치하고 필요한 경우 VM을 재부팅하라는 메시지를 표시합니다.
reboot - 다른 모든 명령 작업이 완료된 후 VM을 재부팅합니다.

모든 XenServer VM Tools 구성 요소 전체 제거

Windows용 XenServer VM Tools 최신 버전(9.3.1 이상)에는 uninstall.exe purge 명령이 포함되어 있습니다. uninstall.exe 애플리케이션의 purge 옵션은 VM을 I/O 드라이버가 설치되기 전 상태로 재설정합니다. 도구를 최신 버전으로 업그레이드할 때 문제가 발생하거나 VM에 최신 도구 세트를 설치하기 위한 클린 슬레이트가 필요한 경우 이 유틸리티를 사용하십시오.

시작하기 전에 VM의 스냅샷을 생성합니다.
관리자로 명령 프롬프트 또는 PowerShell 터미널을 엽니다.
<tools-install-directory>\uninstall.exe purge verbose 명령을 실행합니다.
VM을 재부팅합니다.

이 명령을 사용한 후에는 이전 버전의 XenServer VM Tools에서 수행했던 것처럼 수동 정리 단계를 수행할 필요가 없습니다. XenServer VM Tools 관련 모든 변경 사항이 제거되었습니다.

이 `purge` 옵션은 무엇을 제거합니까?

uninstall.exe purge 명령을 사용하면 Windows VM에서 XenServer VM Tools의 모든 흔적이 제거됩니다. 이 명령으로 수행된 작업 목록은 다음과 같습니다.

서비스:
- 모든 XenServer VM Tools 서비스를 비활성화하여 재부팅 시 설치된 드라이버 및 서비스가 시작되지 않도록 합니다.
- 실행 중인 XenServer VM Tools 서비스를 모두 중지합니다.
드라이버:
- 모든 장치 노드에서 I/O 드라이버를 제거합니다.
- 숨겨진 장치를 제거합니다. 이 작업은 hidden 명령줄 옵션을 수행한 작업과 동일합니다.
- 캐시된 드라이버 패키지를 제거하여 드라이버 저장소에서 제거합니다. 따라서 I/O 드라이버가 자동으로 다시 설치되지 않습니다.
레지스트리:
- 지원되지 않는 드라이버 버전에서 사용하는 오래된 레지스트리 정보를 제거합니다.
- HKLM\System\CurrentControlSet\Control\Class\...에서 도구 관련 키를 삭제합니다.
- HKLM\System\CurrentControlSet\Services에서 도구 관련 키를 삭제합니다.
- HKLM\System\CurrentControlSet\Enum\...에서 도구 관련 키를 삭제합니다.
파일:
- C:\Windows\System32 및 C:\Windows\System32\drivers에서 XenServer VM Tools 드라이버 파일을 모두 삭제합니다.
- C:\Windows\INF에서 XenServer VM Tools INF 파일을 삭제합니다.
- C:\Program Files\Citrix\XenTools에서 지원되지 않는 버전의 도구에 남아 있는 오래된 파일을 모두 삭제합니다.
기타:
- 프로그램 추가/제거에서 이전 항목을 삭제합니다. 이 작업은 cleanup 명령줄 옵션을 수행한 작업과 동일합니다.
- InstallAgent의 일부 오래된 상태 정보를 지웁니다.
- 상위 필터에서 xenfilt.sys를 제거합니다. 이 변경으로 인해 xenfilt.sys가 드라이버 노드에 로드되지 않습니다.
- unplug 키가 제거되므로 재부팅 시 VM이 에뮬레이션된 장치로 되돌아갑니다.
- StorNvme의 StartOverride를 제거합니다. 이 변경으로 인해 stornvme.sys가 부팅 시 강제로 시작되며 에뮬레이션된 NVMe (UEFI) 부팅 디바이스가 작동할 수 있습니다.

새로운 항목

Windows용 XenServer VM 도구 버전은 Citrix Hypervisor의 버전과 독립적으로 업데이트됩니다. VM과 VM을 만드는 데 사용하는 템플릿 모두에서 Windows용 XenServer VM Tools가 정기적으로 최신 버전으로 업데이트되는지 확인합니다.

Windows용 XenServer VM Tools 9.3.1

2023년 1월 25일 출시

이 도구 세트에는 다음과 같은 구성 요소 버전이 포함되어 있습니다.

설치 프로그램: 9.3.1
관리 에이전트: 9.2.1.35
xenbus: 9.1.5.54
xeniface: 9.1.5.42
xennet: 9.1.3.34
xenvbd: 9.1.4.37
xenvif: 9.1.8.58

9.3.1의 개선 사항

이 릴리스에는 다음과 같은 개선 사항이 포함되어 있습니다.

purge 매개 변수를 포함한 uninstall.exe 유틸리티에 대한 개선 사항. 자세한 내용은 Windows용 XenServer VM Tools 제거를 참조하십시오.
XenServer VM Tools 설치 프로그램에 대한 일반적인 개선 사항.
레지스트리 키의 문자열 처리에 대한 일반적인 개선 사항.

9.3.1에서 수정된 문제

이 릴리스에는 다음 문제에 대한 수정 사항이 포함되어 있습니다.

Windows 업데이트를 통해 XenServer VM Tools를 업데이트하면 고정 IP 설정이 손실되고 네트워크 설정이 DHCP를 사용하도록 변경되는 경우가 있습니다.
Windows VM에서는 권한 부여 테이블이 쉽게 소진될 수 있습니다. 이 경우 읽기 및 쓰기 요청이 실패하거나 추가 VIF가 제대로 활성화되지 않아 시작되지 않을 수 있습니다.
드문 경우지만 Windows용 XenServer VM Tools를 업그레이드할 때 기존 관리 에이전트가 종료되지 않아 업그레이드가 성공하지 못할 수 있습니다.
Windows VM에서 설치된 프로그램에 나열된 도구 또는 관리 에이전트의 이전 버전과 최신 버전이 모두 표시될 수 있습니다.
- (이전) Citrix XenServer Windows 관리 에이전트
- (최신) Citrix Hypervisor PV Tools.

이전 릴리스

9.3.0

2022년 7월 26일 출시

이 도구 세트에는 다음과 같은 구성 요소 버전이 포함되어 있습니다.

설치 프로그램: 9.3.0
관리 에이전트: 9.2.0.27
xenbus: 9.1.4.49
xeniface: 9.1.4.34
xennet: 9.1.3.34
xenvbd: 9.1.3.33
xenvif: 9.1.6.52

이 릴리스에는 다음과 같은 개선 사항이 포함되어 있습니다.

XenServer VM Tools 설치 프로그램에 대한 일반적인 개선 사항.

이 릴리스에는 다음 문제에 대한 수정 사항이 포함되어 있습니다.

보안 소프트웨어가 데이터 유출 방지 조치로 제거 가능으로 표시된 보조 디스크가 OS에 노출되지 않도록 차단하고 있었습니다. 이 업데이트를 통해 VBD를 제거할 수 없는 것으로 지정하고 OS를 통해 올바르게 노출되도록 할 수 있습니다.
Windows VM에서 SR-IOV VIF의 IP 주소가 Citrix Hypervisor 센터에 표시되지 않는 경우가 있습니다.

9.2.3

2022년 4월 28일 출시

이 도구 세트에는 다음과 같은 구성 요소 버전이 포함되어 있습니다.

설치 프로그램: 9.2.3
관리 에이전트: 9.1.1.13
xenbus: 9.1.3.30
xeniface: 9.1.4.34
xennet:
- 9.1.1.8(Windows Server 2012 및 Windows Server 2012 R2용)
- 9.1.2.23(지원되는 다른 모든 Windows 운영 체제용)
xenvbd: 9.1.2.20
xenvif: 9.1.5.48

이 릴리스에는 다음 문제에 대한 수정 사항이 포함되어 있습니다.

Windows용 XenServer VM Tools 버전 9.2.2에서는 시간 동기화 옵션을 사용할 수 없습니다.
경합 상태로 인해 Citrix Hypervisor 8.2 누적 업데이트 1에서 실시간 마이그레이션을 수행한 후 Windows VM에 블루 스크린 오류가 표시될 수 있습니다.
XenServer VM Tools 버전 9.2.1 또는 9.2.2가 설치되어 있고 PVS 대상인 Windows VM은 때때로 검은색 화면과 함께 멈출 수 있습니다. dom0 커널 로그에 “게스트 Rx가 중단되었습니다”라는 메시지가 표시됩니다. 이 문제는 다른 풀 멤버보다 풀 마스터에서 더 자주 발생합니다.
vCPU가 8개 이상인 Windows VM에서는 xenvif 드라이버가 간접 테이블을 설정하지 못하기 때문에 수신 측 크기 조정이 작동하지 않을 수 있습니다.

9.2.2

2022년 1월 14일 출시

이 도구 세트에는 다음과 같은 구성 요소 버전이 포함되어 있습니다.

설치 프로그램: 9.2.2
관리 에이전트: 9.1.1.13
xenbus: 9.1.3.30
xeniface: 9.1.2.22
xennet:
- 9.1.1.8(Windows Server 2012 및 Windows Server 2012 R2용)
- 9.1.2.23(지원되는 다른 모든 Windows 운영 체제용)
xenvbd: 9.1.2.20
xenvif: 9.1.3.31

이 릴리스에는 다음 문제에 대한 수정 사항이 포함되어 있습니다.

도구를 업데이트하는 동안 xenbus 드라이버에 드라이버 설치가 완료되기 전에 재부트하라는 메시지가 표시될 수 있습니다. 재부팅을 수락하면 Windows VM에서 블루 스크린 오류가 발생할 수 있습니다.
수집된 진단 정보를 압축하면 xt-bugtool 진단 도구가 20초 후에 타임아웃됩니다. 이 동작으로 인해 진단 zip 파일이 제대로 생성되지 않을 수 있습니다.
VNC 클립보드 공유가 작동하지 않습니다.
이전 버전의 드라이버는 Windows Update를 통해 출시되지 않았습니다.

9.2.1

2021년 6월 24일 출시

이 도구 세트에는 다음과 같은 구성 요소 버전이 포함되어 있습니다.

설치 프로그램: 9.2.1
관리 에이전트: 9.1.0.10
xenbus: 9.1.2.14
xeniface: 9.1.1.11
xennet: 9.1.1.8
xenvbd: 9.1.1.8
xenvif: 9.1.2.16

참고:

이 드라이버 세트는 Windows Update를 통해 제공되지 않았습니다.

이 릴리스에는 다음 문제에 대한 수정 사항이 포함되어 있습니다.

경우에 따라 VM의 랩탑/슬레이트 상태를 변경할 수 없습니다.
VM을 다시 시작한 후 daemon.log 파일에 과도한 로그 메시지가 전송되기 시작하는 경우가 있을 수 있습니다.
OS 업그레이드 후 드라이버 로드 종속성의 경합 상태가 발생하면 XenServer VM Tools를 업그레이드하지 못할 수 있습니다.
스토리지 오류로 인해 Windows VM이 충돌할 수 있습니다.
SR-IOV VIF의 IP 주소가 Citrix Hypervisor 센터에 표시되지 않는 경우가 있습니다. 이 문제를 해결하려면 VM 서비스 관리자 내에서 관리 에이전트를 다시 시작합니다.
네트워크 및 시스템 부하가 많고 리소스가 부족한 경우 VM에서 Citrix 및 타사 드라이버 모두에 버그 체크가 발생할 수 있습니다(일반적으로 코드는 IRQL_NOT_LESS_OR_EQUAL임). 이 수정 사항은 네트워크 버퍼링을 개선하여 이러한 버그 체크를 방지합니다.
Windows I/O 드라이버를 업그레이드하면 UEFI VM이 부팅되지 않아 “0xC000000E. 필요한 장치가 연결되지 않았거나 액세스할 수 없습니다”라고 보고될 수 있습니다.
이전 버전의 XenServer VM Tools를 제거한 후 XenServer VM Tools를 설치할 때 “이 장치를 시작할 수 없음(코드 10) (작업 실패) 요청된 작업이 실패했습니다”라는 오류 메시지가 반환되는 문제가 발생할 수 있습니다.

이 콘텐츠의 공식 버전은 영어로 작성되었습니다. 일부 Cloud Software Group 설명서 콘텐츠는 사용자의 편의를 위해 기계 번역되었습니다. Cloud Software Group는 기계 번역 콘텐츠를 제어할 수 없으며, 오류, 부정확성 또는 부적절한 언어가 포함될 수 있습니다. 영어 원본에서 다른 언어로 번역된 모든 콘텐츠의 정확성, 신뢰성, 적합성 또는 적절성에 대한 모든 종류의 명시적 또는 묵시적 보증이나 Cloud Software Group 제품 또는 서비스가 기계 번역된 콘텐츠를 준수한다는 보증은 하지 않으며, 해당하는 최종 사용자 사용권 계약, 이용 약관 또는 제품 또는 서비스가 준수해야 하는 Cloud Software Group와의 모든 계약에 제공된 모든 보증은 기계 번역된 범위까지 적용되지 않습니다. Cloud Software Group는 기계 번역된 콘텐츠의 사용으로 인해 발생할 수 있는 손상이나 문제에 대해 책임을 지지 않습니다.

도움이 되었나요?

Windows용 XenServer VM Tools

December 11, 2023

제공::

December 11, 2023

제공::

도움이 되었나요?

Windows용 XenServer VM Tools

XenServer VM Tools 설치

자동 설치

Windows용 XenServer VM Tools 업데이트

I/O 드라이버 업데이트

자동 재부팅

I/O 드라이버 버전 찾기

관리 에이전트 업데이트

관리 에이전트 버전 찾기

CLI를 사용하여 자동 업데이트 관리

관리 에이전트 업데이트 리디렉션

관리 에이전트 업데이트 사용 안 함

자동 I/O 드라이버 업데이트 설정 수정

Windows용 XenServer VM Tools 제거

표준 제거

uninstall.exe 명령

명령 옵션

모든 XenServer VM Tools 구성 요소 전체 제거

이 purge 옵션은 무엇을 제거합니까?

새로운 항목

Windows용 XenServer VM Tools 9.3.1

9.3.1의 개선 사항

9.3.1에서 수정된 문제

이전 릴리스

9.3.0

9.2.3

9.2.2

9.2.1

이 문서

`uninstall.exe` 명령

이 `purge` 옵션은 무엇을 제거합니까?