Xentools 재설치(Windows)

VPC 환경에서 이용 가능합니다.

Xentools은 Windows VM의 I/O 드라이버 및 관리 에이전트로 고성능의 I/O 서비스 제공하기 위해 사용되는 Tool입니다. Xentools 재설치(Windows)에서는 Windows 서버의 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 재설치 시 서버 재부팅 여부를 선택할 수 있습니다.

• [Yes] 버튼: 클릭 시 Xentools 재설치가 진행되고 서버가 즉시 재부팅 됩니다.
• [No] 버튼: 클릭 시 Xentools 재설치는 진행되나 서버는 재부팅되지 않습니다.
  • 이후에 서버 리부팅을 직접 수행해야 Xentools 재설치가 정상 완료됩니다.
  주의

  • 리부팅을 2회 이상 수행하지 않고 NCP 콘솔에서 재시작/정지 제어시, 제어 명령이 올바르게 수행되지 않을 수 있습니다.
  • 만약 서버 상태가 재시작에 멈춰있다면 서버에 접속하여 재부팅 팝업 창이 더 이상 뜨지 않는지, Xentools 재설치 후 리부팅을 2회 이상 진행하였는지 확인해 주십시오.
• [Cancel] 버튼: 클릭 시 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를 완료할 수 있습니다.

1. 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")

2. Zip 압축 해제
   C 드라이브에 다운로드 받은 Xentools_Delete.zip 파일의 압축을 해제해 주십시오.

3. Xentools_Delete.exe 파일을 관리자 모드로 실행
   관리자 모드를 실행해 주십시오.
   

4. 아래 CMD창으로 실행할 때 최소 1분 ~ 3분 정도 시간이 소요됩니다.
   

5. Yes을 눌러 서버 재시작을 실행해 주십시오.
   

• 유의 사항 : 서버 접속 불가능 시 콘솔을 오픈해야 합니다.

6. 재시작 후 devmgmt에서 System devieces → XenServer PV Bus (0002) uninstall 진행해 주십시오.
   6.1. cmd창에 devmgmt 입력
   

6.2. System devieces → XenServer PV Bus (0002) uninstall

7. 리부팅 실행 (재시작 필수)
   리부팅 후 아래와 같이 알림창 발생시 yes를 눌러 다시 리부팅을 수행해 주십시오.
   

8. Xentools 재설치 진행
   1. Xentools Download에 따라 진행해 주십시오.

   • 기존에 설치한 Xentools 버전보다 하위 버전으로 설치해 주십시오.

9. 라우팅룰 스크립트 실행
   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에 대한 라우팅룰이 잘 들어가 있는지 확인해 주십시오.