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のダウンロードとインストール

NAVERクラウドプラットフォーム Linuxサーバで提供されるスクリプトを使用して Xentoolsをダウンロードします。

  1. 次のコマンドでスクリプトを実行します。
  • グローバルドメイン環境サーバ
    $ wget https://kr.object.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.ncloudstorage.com/xen-tools-install/linux_xentools_install.sh
$ chmod u+x linux_xentools_install.sh
$ ./linux_xentools_install.sh
  1. インストールが完了したら、サーバを再起動します。

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 >> を選択します。
    xen-guest-agent01
  3. (X) XENTOOLS - XENTOOLS INSTALL >> を選択します。
    xen-guest-agent02
  4. 左上にインストールされたバージョンがないことを確認し、 (R) RE-INSTALL XEN GUEST AGENT(Xentools) >> を選択します。
    xen-guest-agent03
  5. 正常にインストールが実行される場合、以下のようにインストール実行ログが出力されます。
    xen-guest-agent04
  6. インストールされたバージョンを確認し、 OK をクリックして再インストールを完了します。
    xen-guest-agent05
  7. 左上にインストールされたバージョンを確認し、インストールが完了したらサーバを再起動します。

Xentoolsのヘルスチェック

Xentoolsサービスのヘルスチェックを行います。

  1. (E) EXECUTE - << Run System Apps >> を選択します。
    xen-guest-agent07
  2. (X) XENTOOLS - XENTOOLS INSTALL >> を選択します。
    xen-guest-agent08
  3. (S) XEN GUEST AGENT(Xentools) STATUS >> を選択します。
    xen-guest-agent09
  4. Xentoolsサービスが active(running) ステータスであるか確認します。
    xen-guest-agent10

Xentoolsの再起動

Xentoolsプロセスを再起動します。

  1. (E) EXECUTE - << Run System Apps >> を選択します。
    xen-guest-agent11
  2. (X) XENTOOLS - XENTOOLS INSTALL >> を選択します。
    xen-guest-agent12
  3. (T) RE-START XEN GUEST AGENT(Xentools) >> を選択します。
    xen-guest-agent13
  4. Xentoolsサービスが active(running) ステータスであるか確認します。
    xen-guest-agent14

Xentoolsの再インストール

既存にインストールされた Xentoolsを削除し、再インストールを行います。

  1. (E) EXECUTE - << Run System Apps >> を選択します。
    xen-guest-agent15
  2. (X) XENTOOLS - XENTOOLS INSTALL >> を選択します。
    xen-guest-agent16
  3. (R) RE-INSTALL XEN GUEST AGENT(Xentools) >> を選択します。
    xen-guest-agent17
  4. インストールが正常に実行される場合、以下のように再インストール実行ログが出力されます。
    • 起動中の Xentools Agentを停止
    • 既存にインストールされた Xentools Agentを削除
    • Xentools Agentの再インストール
      xen-guest-agent18
  5. インストールされたバージョンを確認し、OKをクリックして再インストールを完了します。
    xen-guest-agent19
  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を実行する方法は、次の通りです。

  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. Enter キーを入力してインストールを完了します。

Xentools Guest Agentに関するよくあるご質問

Q. 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でのみ確認できます。

    xen-guest-agent20

  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.