Xentools 재설치 (Linux)

Prev Next

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

Xentools는 Linux 서버의 다양한 정보를 XEN 하이퍼바이저로 전달하기 위해 사용됩니다. 문제 해결 목적으로 Linux 서버에서 Xentools를 재설치하는 방법을 설명합니다.

VM이 호스팅되고 있는 하이퍼바이저가 XEN인지 먼저 확인해 주십시오.

# 방법 1
[root@xen-rockylinux810 ~]# dmesg | grep "Hypervisor detected" | awk -F': ' '{print $2}'
Xen HVM

# 방법 2
[root@xen-rockylinux810 ~]# virt-what
xen
xen-hvm

스크립트를 활용한 Xentools 재설치

참

해당 기능은 CentOS 7, Ubuntu 18.04에서 사용할 수 있습니다.

스크립트를 활용한 Xentools 재설치 방법은 다음과 같습니다.

Xentools 다운로드 및 설치

네이버 클라우드 플랫폼 Linux 서버에서 제공되는 스크립트를 사용하여 Xentools를 다운로드해 주십시오.

  1. 다음의 명령어로 스크립트를 실행해 주십시오.
    • 공인 도메인 환경 서버
       # wget https://kr.object.gov-ncloudstorage.com/xen-tools-install/linux_xentools_install.sh
 # chmod u+x linux_xentools_install.sh
 # ./linux_xentools_install.sh
    • 사설 도메인 환경 서버
       # wget https://kr.object.private.gov-ncloudstorage.com/xen-tools-install/linux_xentools_install.sh
 # chmod u+x linux_xentools_install.sh
 # ./linux_xentools_install.sh
  2. 설치가 완료되면 서버를 리부팅해 주십시오.

Xentools 운영 상태 확인

Xentools를 재설치한 후 Xentools 운영 상태가 정상인지 확인해 주십시오.

  1. 다음의 명령을 실행해 주십시오.
    서비스 상태가 active (running) 상태인지 확인해 주십시오.
    [root@xen-centos78 ~]# systemctl status xe-linux-distribution.service
● xe-linux-distribution.service - LSB: Virtual Machine daemon providing host integration services
   Loaded: loaded (/etc/rc.d/init.d/xe-linux-distribution; bad; vendor preset: disabled)
   Active: active (running) since Tue 2025-06-24 16:39:18 KST; 18h ago
     Docs: man:systemd-sysv-generator(8)
  Process: 933 ExecStart=/etc/rc.d/init.d/xe-linux-distribution start (code=exited, status=0/SUCCESS)
   CGroup: /system.slice/xe-linux-distribution.service
           ├─1005 /usr/sbin/xe-daemon -p /var/run/xe-daemon.pid
           ├─1016 logger -t xe-daemon
           └─1021 logger -t xenstore

Jun 24 16:39:17 xen-centos78 systemd[1]: Starting LSB: Virtual Machine daemon providing host integration services...
Jun 24 16:39:17 xen-centos78 xe-linux-distribution[933]: Mounting xenfs on /proc/xen: [  OK  ]
Jun 24 16:39:18 xen-centos78 xe-linux-distribution[933]: Detecting Linux distribution version: [  OK  ]
Jun 24 16:39:18 xen-centos78 xe-linux-distribution[933]: Starting xe daemon:  [  OK  ]
Jun 24 16:39:18 xen-centos78 systemd[1]: Started LSB: Virtual Machine daemon providing host integration services.

NTK를 활용한 Xentools 점검

참

해당 기능은 Rocky Linux 8, Ubuntu 20.04에서 사용할 수 있습니다.
2025년 6월 20일 기준 NTK 최신 버전은 v0.8.0이며, 해당 버전을 기준으로 작성되었습니다.

Linux NTK 실행

Linux 서버에서 NTK를 실행하는 방법은 다음과 같습니다.

  1. NTK 파일이 위치한 경로로 이동해 주십시오.
    [root@xen-rockylinux810 ~]# cd /usr/local/etc
  2. NTK 파일 압축을 해제해 주십시오.
    [root@xen-rockylinux810 etc]# tar zxvf ntk.tar.gz
  3. NTK를 실행해 주십시오.
    [root@xen-rockylinux810 etc]# cd ntk; ./ntk

신규 Xentools 설치

Xentools Guest Agent가 VM 내에 존재하지 않는 경우, 새로운 Xentools Guest Agent를 설치합니다.

  1. VM에 Xentools가 설치 여부를 확인해 주십시오.
    설치되어 있지 않은 경우에는 다음 단계를 진행해 주시고, 설치되어 있는 경우에는 Xentools 상태 점검 또는 Xentools 재설치 가이드를 참고해 주십시오.
    # RockyLinux 8
# 설치되어 있는 경우
[root@xen-rockylinux810 ~]# rpm -qa | grep xe-guest
xe-guest-utilities-xenstore-7.20.2-1.x86_64
xe-guest-utilities-7.20.2-1.x86_64

# 설치 안되어 있는 경우
[root@xen-rockylinux810 ntk]# rpm -qa | grep xe-guest
[root@xen-rockylinux810 ntk]#


# Ubuntu 20.04
# 설치되어 있는 경우
root@xen-ubuntu2004:~# dpkg -l | grep xe-guest
ii  xe-guest-utilities                   7.20.0-1                              amd64        Virtual Machine Monitoring Scripts

# 설치 안되어 있는 경우
root@xen-ubuntu2004:~# dpkg -l | grep xe-guest
root@xen-ubuntu2004:~#
  2. (E) EXECUTE - << Run System Apps >> 를 선택해 주십시오.
    xentools-check-01
  3. (X) XENTOOLS - XENTOOLS INSTALL >> 을 선택해 주십시오.
    xentools-check-02
  4. 왼쪽 상단에 설치된 버전이 없을 것을 확인하고, (R) RE-INSTALL XEN GUEST AGENT(Xentools) >> 를 선택해 주십시오.
    xentools-check-03
  5. 정상적으로 설치가 진행되는 경우, 아래와 같이 설치 수행 로그가 출력됩니다.
    xentools-check-04
  6. 설치된 버전을 확인하고 OK를 눌러서 재설치를 완료해 주십시오.
    xentools-check-05
  7. 왼쪽 상단에 설치된 버전을 확인해 주시고, 설치가 완료되면 서버를 리부팅해 주십시오.
    xentools-check-06

Xentools 상태 점검

Xentools 서비스의 상태를 점검합니다.

  1. (E) EXECUTE - << Run System Apps >> 를 선택해 주십시오.
    xentools-check-07

  2. (X) XENTOOLS - XENTOOLS INSTALL >> 을 선택해 주십시오.
    xentools-check-08

  3. (S) XEN GUEST AGENT(Xentools) STATUS >> 를 선택해 주십시오.
    xentools-check-09

  4. Xentools 서비스가 active (running) 상태인지 확인해 주십시오.
    xentools-check-10

Xentools 재시작

Xentools 프로세스를 재시작합니다.

  1. (E) EXECUTE - << Run System Apps >> 를 선택해 주십시오.
    xentools-check-11
  2. (X) XENTOOLS - XENTOOLS INSTALL >> 을 선택해 주십시오.
    xentools-check-12
  3. (T) RE-START XEN GUEST AGENT(Xentools) >> 을 선택해 주십시오.
    xentools-check-13
  4. Xentools 서비스가 active (running) 상태인지 확인해 주십시오.
    xentools-check-14

Xentools 재설치

기존에 설치된 Xentools를 삭제하고 재설치를 진행합니다.

  1. (E) EXECUTE - << Run System Apps >> 를 선택해 주십시오.
    xentools-check-15
  2. (X) XENTOOLS - XENTOOLS INSTALL >> 을 선택해 주십시오.
    xentools-check-16
  3. (R) RE-INSTALL XEN GUEST AGENT(Xentools) >> 를 선택해 주십시오.
    xentools-check-17
  4. 정상적으로 설치가 진행되는 경우, 아래와 같이 재설치 수행 로그가 출력됩니다.
    • 기동중인 Xentools Agent 정지
    • 기존에 설지된 Xentools Agent 삭제
    • Xentools Agent 재설치
      xentools-check-18
  5. 설치된 버전을 확인하고 OK를 눌러서 재설치를 완료해 주십시오.
    xentools-check-19
  6. 설치가 완료되면 서버를 리부팅해 주십시오.

NTK CLI(ntk-cli.sh)를 이용한 Xentools 재설치

참고

해당 기능은 Rocky Linux 8, Ubuntu 20.04에서 사용할 수 있습니다.
2025년 6월 20일 기준 NTK 최신 버전은 v0.8.0이며, 해당 버전을 기준으로 작성되었습니다.

Linux NTK CLI ntk-cli.sh 실행

Linux 서버에서 NTK CLI명령어인 ntk-cli.sh를 실행하는 방법은 다음과 같습니다.

  1. NTK 파일이 위치한 경로로 이동해 주십시오.
    [root@xen-rockylinux810 ~]# cd /usr/local/etc
  2. NTK 파일 압축을 해제해 주십시오.
    [root@xen-rockylinux810 etc]# tar zxvf ntk.tar.gz
  3. ntk-cli.sh를 실행해 주십시오.
    [root@xen-rockylinux810 etc]# cd ntk

[root@xen-rockylinux810 ntk]# ls
apps  core  logs  ntk  ntk-cli.sh  ntk_main  tree-dir.sh

[root@xen-rockylinux810 ntk]# ./ntk-cli.sh
Option is not correct
Version: NTK v0.8.0
Usage: ntk-cli.sh Option
Option:
    --help              show this page
    --check-ncp-vm      check NCP VM configuration in a XEN environment

Xentools:
    --xentools          check and install Xentools agent
                        CentOS 7      : 7.4.0-1
                        Rocky Linux 8 : 7.20.2-1
                        Ubuntu 18.04  : 7.4.0-1
                        Ubuntu 20.04  : 7.20.2-1
    --xentools-latest   install latest Xentools agent (please refer to the belew version)
                        CentOS 7      : 7.4.0-1  => 7.20.2-1
                        Rocky Linux 8 : 7.20.2-1 => 8.2.1-1
                        Ubuntu 18.04  : 7.4.0-1  => 7.20.2-1
                        Ubuntu 20.04  : 7.20.2-1 => 8.2.1-1

Xen2KVM Migration:
    --x2k_validate      validation check VM to migrate from XEN to KVM
  4. OS 버전 따라 지정한 버전을 설치할 때(–-xentools 옵션)와 상위 버전(--xentools-latest 옵션)을 지정해서 설치할 수 있습니다.
    [root@xen-rockylinux810 ntk]# ./ntk-cli.sh --xentools

Executing ... /usr/local/etc/ntk/apps/ntk-cli/xentools-agent.sh


Package-Searching...


Download Package...

--2025-06-27 15:49:08--  http://init.ncloud.com/server/linux/xentools/CitrixVMTools-Linux-7.20.2-1.tar.gz
Resolving init.ncloud.com (init.ncloud.com)... 169.254.1.5, 169.254.80.160
Connecting to init.ncloud.com (init.ncloud.com)|169.254.1.5|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 8252206 (7.9M) [application/x-gzip]
Saving to: '/usr/local/etc/ntk/apps/system_agent/CitrixVMTools-Linux-7.20.2-1.tar.gz'
2025-06-27 15:49:08 (171 MB/s) - '/usr/local/etc/ntk/apps/system_agent/CitrixVMTools-Linux-7.20.2-1.tar.gz' saved [8252206/8252206]


Remove Old Package...


Install New Package...

LinuxGuestTools-7.20.2-1/
LinuxGuestTools-7.20.2-1/versions.rpm
LinuxGuestTools-7.20.2-1/xe-guest-utilities-xenstore-7.20.2-1.i386.rpm
LinuxGuestTools-7.20.2-1/xe-linux-distribution
LinuxGuestTools-7.20.2-1/versions.tgz
LinuxGuestTools-7.20.2-1/install.sh
LinuxGuestTools-7.20.2-1/versions.deb
LinuxGuestTools-7.20.2-1/xe-guest-utilities_7.20.2-1_i386.deb
LinuxGuestTools-7.20.2-1/xen-vcpu-hotplug.rules
LinuxGuestTools-7.20.2-1/xe-guest-utilities-xenstore-7.20.2-1.x86_64.rpm
LinuxGuestTools-7.20.2-1/SRPM/
LinuxGuestTools-7.20.2-1/SRPM/xe-guest-utilities-7.20.2-1.src.rpm
LinuxGuestTools-7.20.2-1/xe-linux-distribution.service
LinuxGuestTools-7.20.2-1/xe-daemon
LinuxGuestTools-7.20.2-1/xe-guest-utilities_7.20.2-1_amd64.deb
LinuxGuestTools-7.20.2-1/LICENSE
LinuxGuestTools-7.20.2-1/xe-guest-utilities-7.20.2-1.x86_64.rpm
LinuxGuestTools-7.20.2-1/README.txt
LinuxGuestTools-7.20.2-1/xe-guest-utilities_7.20.2-1_all.tgz
LinuxGuestTools-7.20.2-1/xe-guest-utilities-7.20.2-1.i386.rpm
LinuxGuestTools-7.20.2-1/DEB_SRC_PACKAGES/
LinuxGuestTools-7.20.2-1/DEB_SRC_PACKAGES/xe-guest-utilities_7.20.2-1.dsc
LinuxGuestTools-7.20.2-1/DEB_SRC_PACKAGES/xe-guest-utilities_7.20.2-1.tar.gz
Detected `Rocky Linux release 8.10 (Green Obsidian)' (rocky version 8).

The following changes will be made to this Virtual Machine:
  * packages to be installed/upgraded:
    - xe-guest-utilities-7.20.2-1.x86_64.rpm
    - xe-guest-utilities-xenstore-7.20.2-1.x86_64.rpm



Verifying...                          ########################################
Preparing...                          ########################################
Updating / installing...
xe-guest-utilities-xenstore-7.20.2-1  ########################################
xe-guest-utilities-7.20.2-1           ########################################

You should now reboot this Virtual Machine.

# systemctl status xe-linux-distribution.service
* xe-linux-distribution.service - LSB: Virtual Machine daemon providing host integration services
   Loaded: loaded (/etc/rc.d/init.d/xe-linux-distribution; generated)
   Active: active (running) since Fri 2025-06-27 15:49:11 KST; 50ms ago
     Docs: man:systemd-sysv-generator(8)
  Process: 125068 ExecStart=/etc/rc.d/init.d/xe-linux-distribution start (code=exited, status=0/SUCCESS)
    Tasks: 9 (limit: 23076)
   Memory: 1.6M
   CGroup: /system.slice/xe-linux-distribution.service
           |-125084 /usr/sbin/xe-daemon -p /var/run/xe-daemon.pid
           `-125088 logger -t xe-daemon -p debug

Jun 27 15:49:11 xen-rockylinux810 systemd[1]: Starting LSB: Virtual Machine daemon providing host integration services...
Jun 27 15:49:11 xen-rockylinux810 xe-linux-distribution[125068]: Detecting Linux distribution version: [  OK  ]
Jun 27 15:49:11 xen-rockylinux810 xe-linux-distribution[125068]: Starting xe daemon:  [  OK  ]
Jun 27 15:49:11 xen-rockylinux810 systemd[1]: Started LSB: Virtual Machine daemon providing host integration services.

# ps -ef|grep xe-daemon
root      125084       1  0 15:49 ?        00:00:00 /usr/sbin/xe-daemon -p /var/run/xe-daemon.pid

Press Any Key to exit
  5. 엔터 키를 입력해 설치를 마무리 합니다.

Xentools Guest Agent 관련 자주하는 질문

MC 콘솔에서 Guest Agent가 설치되지 않았습니다 라는 알람이 떴습니다. 어떻게 해야 되나요?

Xentools가 설치되어 있지 않거나, 설치가 되었어도 프로세스가 기동되어 있지 않으면 발생하는 알람입니다.
아래의 순서대로 고객분께서 자체적으로 점검해 보실 수 있습니다.

  1. Xentools가 정상 기동되고 있는지 확인합니다.
    상태 점검은 Xentools 상태 점검 항목을 참고해 주십시오.
    서버에 접속된 상태이면 아래의 명령어로 active (running) 상태인지 확인 가능합니다.

    [root@xen-rockylinux810 ~]# systemctl status xe-linux-distribution.service
● xe-linux-distribution.service - LSB: Virtual Machine daemon providing host integration services
   Loaded: loaded (/etc/rc.d/init.d/xe-linux-distribution; generated)
   Active: active (running) since Wed 2025-06-25 11:15:26 KST; 26s ago
     Docs: man:systemd-sysv-generator(8)
  Process: 35015 ExecStop=/etc/rc.d/init.d/xe-linux-distribution stop (code=exited, status=0/SUCCESS)
  Process: 35243 ExecStart=/etc/rc.d/init.d/xe-linux-distribution start (code=exited, status=0/SUCCESS)
    Tasks: 10 (limit: 23076)
   Memory: 3.8M
   CGroup: /system.slice/xe-linux-distribution.service
           ├─35259 /usr/sbin/xe-daemon -p /var/run/xe-daemon.pid
           └─35263 logger -t xe-daemon -p debug

Jun 25 11:15:26 xen-rockylinux810 systemd[1]: Starting LSB: Virtual Machine daemon providing host integration services...
Jun 25 11:15:26 xen-rockylinux810 xe-linux-distribution[35243]: Detecting Linux distribution version: [  OK  ]
Jun 25 11:15:26 xen-rockylinux810 xe-linux-distribution[35243]: Starting xe daemon:  [  OK  ]
Jun 25 11:15:26 xen-rockylinux810 systemd[1]: Started LSB: Virtual Machine daemon providing host integration services.

  2. Xentools가 정상 기동 중이라면 XEN 하이퍼바이저와 마지막 통신된 시간을 확인합니다.

    참고

    XEN 하이퍼바이저에서는 1분마다 상태를 업데이트 합니다.
    Rocky Linux 8 과 Ubuntu 20.04에서만 확인 가능합니다.

    xentools-check-20

  3. 마지막 통신 시간이 최근이 아니면 Xentools를 재시작해서 시간이 업데이트 되는지 확인합니다.
    Xentools 재시작 방법은 "Xentools 재시작" 항목을 참고해 주십시오.
    서버에 접속된 상태이면 아래의 명령어로 재시작 및 상태 체크가 가능합니다.

    [root@xen-rockylinux810 ~]# systemctl restart xe-linux-distribution.service
[root@xen-rockylinux810 ~]# systemctl status xe-linux-distribution.service
● xe-linux-distribution.service - LSB: Virtual Machine daemon providing host integration services
   Loaded: loaded (/etc/rc.d/init.d/xe-linux-distribution; generated)
   Active: active (running) since Wed 2025-06-25 11:17:54 KST; 9s ago
     Docs: man:systemd-sysv-generator(8)
  Process: 35689 ExecStop=/etc/rc.d/init.d/xe-linux-distribution stop (code=exited, status=0/SUCCESS)
  Process: 35698 ExecStart=/etc/rc.d/init.d/xe-linux-distribution start (code=exited, status=0/SUCCESS)
    Tasks: 9 (limit: 23076)
   Memory: 2.2M
   CGroup: /system.slice/xe-linux-distribution.service
           ├─35714 /usr/sbin/xe-daemon -p /var/run/xe-daemon.pid
           └─35718 logger -t xe-daemon -p debug

Jun 25 11:17:54 xen-rockylinux810 systemd[1]: Starting LSB: Virtual Machine daemon providing host integration services...
Jun 25 11:17:54 xen-rockylinux810 xe-linux-distribution[35698]: Detecting Linux distribution version: [  OK  ]
Jun 25 11:17:54 xen-rockylinux810 xe-linux-distribution[35698]: Starting xe daemon:  [  OK  ]
Jun 25 11:17:54 xen-rockylinux810 systemd[1]: Started LSB: Virtual Machine daemon providing host integration services.