-
인쇄
-
PDF
Xentools 재설치(Windows)
-
인쇄
-
PDF
VPC 환경에서 이용 가능합니다.
Xentools은 Windows VM의 I/O 드라이버 및 관리 에이전트로 고성능의 I/O 서비스 제공하기 위해 사용되는 Tool입니다. Xentools 재설치(Windows)에서는 Windows 서버의 Xentools 재설치 방법을 안내합니다.
- Xentools 재설치 작업 전 스냅샷 기능을 통해 데이터를 백업한 후 작업해 주십시오.
Step 1. Xentools_install 파일 다운로드
아래 powershell script를 실행하여 Xentools_install.exe 파일을 다운로드해 주십시오.
Start-BitsTransfer -Source "http://init.gov-ncloud.com/xentools/windows/Xentools_install.exe" -Destination "c:\Xentools_install.exe"
Step 2. Xentools_install 파일 실행
Xentools_install.exe 파일을 관리자 모드로 실행해 주십시오.
Step 3. Xentools 및 서비스 상태 확인
Xentools 및 서비스 상태의 case와 증상을 확인하고 조치 방안에 따라 진행해 주십시오.
Xentools 및 서비스 상태 case | 증상 | 조치 방안 |
---|---|---|
- Xentools 버전: 권고 버전 - 관련 서비스: 정상 |
Xentools is normal 내용의 팝업 창이 나타남 | 없음 |
- Xentools 버전: 권고 버전 - 관련 서비스: XenServer Interface에 이상 있음 |
XenServer Interface가 Rollback 됨 | 서버 리부팅 |
- Xentools 버전: 권고 버전이 아니거나 Xentools을 설치하지 않음 | ![]() 위 화면과 함께 Xentools 재설치 진행 |
다음 단계(Step4. Xentools 재설치시 서버 재부팅 여부 선택)로 이동하여 Xentools 재설치 진행 |
Step 4. Xentools 재설치 시 서버 재부팅 여부 선택
Xentools 재설치 시 서버 재부팅 여부를 선택할 수 있습니다.
- Xentools 재설치 또는 Interface Rollback 후 서버가 리부팅 되어야 Xentools가 정상적으로 인식됩니다.
- 리부팅은 콘솔이 아닌 서버에서 직접 수행해 주십시오.
- [Yes] 버튼: 클릭 시 Xentools 재설치가 진행되고 서버가 즉시 재부팅 됩니다.
- [No] 버튼: 클릭 시 Xentools 재설치는 진행되나 서버는 재부팅되지 않습니다.
- 이후에 서버 리부팅을 직접 수행해야 Xentools 재설치가 정상 완료됩니다.
주의- 리부팅을 2회 이상 수행하지 않고 NCP 콘솔에서 재시작/정지 제어시, 제어 명령이 올바르게 수행되지 않을 수 있습니다.
- 만약 서버 상태가 재시작에 멈춰있다면 서버에 접속하여 재부팅 팝업 창이 더 이상 뜨지 않는지, Xentools 재설치 후 리부팅을 2회 이상 진행하였는지 확인해 주십시오.
- [Cancel] 버튼: 클릭 시 Xentools 재설치 작업을 취소합니다.
위와 같이 조치한 후에도 서버 상태가 재시작에서 멈춘다면 리부팅을 1회 진행해 주십시오. 그래도 현상이 지속된다면 Step6. Xentools 수동 설치를 참고하여 Xentools를 삭제한 후 다시 설치해 주십시오.
Step 5. 라우팅룰 스크립트 실행
Xentools를 재설치 하는 경우 내부 라우팅룰이 사라지는 경우가 있으므로, 라우팅룰 재설정을 위해 아래 exe를 다운로드 후 실행시켜주십시오.
Start-BitsTransfer -Source "http://init.gov-ncloud.com/windows/real/staticRoute.exe" -Destination "c:\staticRoute.exe"
- 아래와 같이 Persistent Routes에 169.254.0.0/16에 대한 라우팅룰이 잘 들어가 있는지 확인해 주십시오.
Step 6. Xentools 수동 설치
Xentools 수동 설치 방법을 설명합니다.
1. Xentools Download
Windows 서버에서 Xentools는 두 가지 방법으로 다운 받을 수 있습니다.
-
방법 1: 링크를 통해 윈도우 서버의 Xentools 정보 확인 및 다운로드 할 수 있습니다.
-
방법 2: 네이버 클라우드 플랫폼에서 제공하는 repo를 통해서 Xentools 설치 파일을 다운로드할 수 있습니다.
#7.2.1555 Start-BitsTransfer -Source "http://init.gov-ncloud.com/xentools/windows/managementagentx64_7.2.0.1555.msi" -Destination "c:\managementagentx64_7.2.0.1555.msi"
#최신 Start-BitsTransfer -Source "http://init.gov-ncloud.com/xentools/windows/managementagentx64-latest.msi" -Destination "c:\managementagentx64-latest.msi"
2. Xentools Service Check
powershell에서 아래 명령어를 수행하면, 다음과 같이 3개의 서비스가 운영중으로 보여야 합니다.
Get-Service -Name Xen*
Status Name DisplayName
------ ---- -----------
Running xenagent XenServer Agent
Running xenbus_monitor XenServer PV Driver Monitor
Running XenSvc Citrix XenServer Windows Management...
만약 Status가 Running 중이지 않다면, 해당 서비스를 실행시켜 주시기 바랍니다.
- run - service.msc 입력 후 서비스명을 확인하여 우클릭 후 서비스 시작 수행
3. Xentools Version Check
Windows 서버의 Xentools의 Version Check 방법은 3가지가 있으며, 편하신 방법으로 확인하시면 됩니다.
-
방법 1: powershell에서 Major -> Minor -> Micro 순서로 Xentools Version을 확인할 수 있습니다.
PS C:\Users\Administrator> REG QUERY "HKLM\SOFTWARE\Citrix\XenTools" HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XenTools HostTime REG_SZ MajorVersion REG_DWORD 0x7 MinorVersion REG_DWORD 0x2 MicroVersion REG_DWORD 0x0 BuildVersion REG_DWORD 0x601 Install_Dir REG_SZ C:\Program Files\Citrix\XenTools\ MsiGuestAgent REG_DWORD 0x1 Driver_Install_Dir REG_SZ C:\Program Files\Citrix\XenTools\\Drivers DisableAutoUpdate REG_DWORD 0x1 HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XenTools\AutoUpdate
-
방법 2 : 프로그램 추가/제거 메뉴에서 Xentools Version을 확인할 수 있습니다.
-
방법 3 : Registry에서 Xentools Version을 확인할 수 있습니다. HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XenTools 이동하여 다음과 같이 확인 가능합니다.
4. Xentools Install & Upgrade
Xentools Upgrade 방법은 신규 설치 방법과 동일합니다.(기존 버전 삭제 없이 상위 버전의 설치 파일을 바로 실행하시면 됩니다.)
- 리부팅은 콘솔이 아닌 서버에서 직접 수행해 주십시오.
- 설치가 완료되면 리부팅 이후 1회 리부팅이 더 발생할 수 있습니다.
- 설치 과정에서 Network Driver가 설치되기 때문에 원격접속 연결이 끊기고 재접속이 불가할 수 있습니다.
- 원격접속이 불가할 경우 콘솔 연결을 사용 하시거나 1회 리부팅 후 재접속 하시면 됩니다.
완료 후 최대 두 번의 리부팅이 필요하며, 리부팅 후 로그인 시 리부팅 알림 팝업이 발생합니다.
5. Xentools Downgrade
Windows 서버의 Xentools를 downgrade하기 위해서는 설치된 Xentools를 삭제하고, downgrade 할 버전으로 Xentools 설치를 진행해야 합니다. 다음과 같은 순서로 진행하시면, Xentools downgrade를 완료할 수 있습니다.
- Xentools_Delete 파일 다운로드
아래 powershell script를 실행시켜서 Xentools_Delete 파일을 다운로드해 주십시오.
Start-BitsTransfer -Source "http://init.gov-ncloud.com/xentools/windows/Xentools_Delete.zip" -Destination "c:\Xentools_Delete.zip"
[System.Reflection.Assembly]::LoadWithPartialName('System.IO.Compression.FileSystem')
[System.IO.Compression.ZipFile]::ExtractToDirectory("c:\Xentools_Delete.zip", "c:\Xentools_Delete")
-
Zip 압축 해제
C 드라이브에 다운로드 받은 Xentools_Delete.zip 파일의 압축을 해제해 주십시오. -
Xentools_Delete.exe 파일을 관리자 모드로 실행
관리자 모드를 실행해 주십시오.
-
아래 CMD창으로 실행할 때 최소 1분 ~ 3분 정도 시간이 소요됩니다.
-
Yes을 눌러 서버 재시작을 실행해 주십시오.
- 유의 사항 : 서버 접속 불가능 시 콘솔을 오픈해야 합니다.
- 재시작 후 devmgmt에서 System devieces → XenServer PV Bus (0002) uninstall 진행해 주십시오.
6.1. cmd창에 devmgmt 입력
6.2. System devieces → XenServer PV Bus (0002) uninstall
-
리부팅 실행 (재시작 필수)
리부팅 후 아래와 같이 알림창 발생시 yes를 눌러 다시 리부팅을 수행해 주십시오.
-
Xentools 재설치 진행
1. Xentools Download에 따라 진행해 주십시오.- 기존에 설치한 Xentools 버전보다 하위 버전으로 설치해 주십시오.
-
라우팅룰 스크립트 실행
Xentools를 재설치 하는 경우 내부 라우팅룰이 사라지는 경우가 있으므로, 라우팅룰 재설정을 위해 아래 exe를 다운로드 후 실행시켜주십시오.Start-BitsTransfer -Source "http://init.gov-ncloud.com/windows/real/staticRoute.exe" -Destination "c:\staticRoute.exe"
- 아래와 같이 Persistent Routes에 169.254.0.0/16에 대한 라우팅룰이 잘 들어가 있는지 확인해 주십시오.