Xentools 재설치(Windows)
  • 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을 설치하지 않음 compute-xentoolswindow-vpc-01-ko.png
위 화면과 함께 Xentools 재설치 진행
다음 단계(Step4. Xentools 재설치시 서버 재부팅 여부 선택)로 이동하여 Xentools 재설치 진행

Step 4. Xentools 재설치 시 서버 재부팅 여부 선택

Xentools 재설치 시 서버 재부팅 여부를 선택할 수 있습니다.
compute-xentoolswindow-vpc-02-ko.png

주의
  • 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에 대한 라우팅룰이 잘 들어가 있는지 확인해 주십시오.
    compute-xentoolswindow-vpc-03-ko.png

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을 확인할 수 있습니다.
    compute-xentoolswindow-vpc-04-ko.png

  • 방법 3 : Registry에서 Xentools Version을 확인할 수 있습니다. HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XenTools 이동하여 다음과 같이 확인 가능합니다.
    compute-xentoolswindow-vpc-05-ko.png

4. Xentools Install & Upgrade

Xentools Upgrade 방법은 신규 설치 방법과 동일합니다.(기존 버전 삭제 없이 상위 버전의 설치 파일을 바로 실행하시면 됩니다.)

  • 리부팅은 콘솔이 아닌 서버에서 직접 수행해 주십시오.
  • 설치가 완료되면 리부팅 이후 1회 리부팅이 더 발생할 수 있습니다.
  • 설치 과정에서 Network Driver가 설치되기 때문에 원격접속 연결이 끊기고 재접속이 불가할 수 있습니다.
  • 원격접속이 불가할 경우 콘솔 연결을 사용 하시거나 1회 리부팅 후 재접속 하시면 됩니다.

compute-xentoolswindow-vpc-06-ko.png

compute-xentoolswindow-vpc-07-ko.png

compute-xentoolswindow-vpc-08-ko.png

compute-xentoolswindow-vpc-09-ko.png

완료 후 최대 두 번의 리부팅이 필요하며, 리부팅 후 로그인 시 리부팅 알림 팝업이 발생합니다.

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")
  1. Zip 압축 해제
    C 드라이브에 다운로드 받은 Xentools_Delete.zip 파일의 압축을 해제해 주십시오.

  2. Xentools_Delete.exe 파일을 관리자 모드로 실행
    관리자 모드를 실행해 주십시오.
    compute-xentoolswindow-vpc-10-ko.png

  3. 아래 CMD창으로 실행할 때 최소 1분 ~ 3분 정도 시간이 소요됩니다.
    compute-xentoolswindow-vpc-11-ko.png

  4. Yes을 눌러 서버 재시작을 실행해 주십시오.
    compute-xentoolswindow-vpc-12-ko.png

  • 유의 사항 : 서버 접속 불가능 시 콘솔을 오픈해야 합니다.
  1. 재시작 후 devmgmt에서 System devieces → XenServer PV Bus (0002) uninstall 진행해 주십시오.
    6.1. cmd창에 devmgmt 입력
    compute-xentoolswindow-vpc-13-ko.png

6.2. System devieces → XenServer PV Bus (0002) uninstall
compute-xentoolswindow-vpc-14-ko.png

compute-xentoolswindow-vpc-13-ko.png

  1. 리부팅 실행 (재시작 필수)
    리부팅 후 아래와 같이 알림창 발생시 yes를 눌러 다시 리부팅을 수행해 주십시오.
    compute-xentoolswindow-vpc-16-ko.png

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

    • 기존에 설치한 Xentools 버전보다 하위 버전으로 설치해 주십시오.
  3. 라우팅룰 스크립트 실행
    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에 대한 라우팅룰이 잘 들어가 있는지 확인해 주십시오.
    compute-xentoolswindow-vpc-03-ko.png

이 문서가 도움이 되었습니까?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.