前回までに、Convert Clusterを実行するためのvCenter Serverの設定変更を行いました。
では、準備フェーズとして最後の手順を行います。
4.仮想マシンへのNGTのインストール
AHVへの変換を行うと、ゲストOS側でVirtIO Driverが読み込まれていない場合、正常に起動できません。そのため、あらかじめゲストOSにNutanix Guest Tools（NGT）をインストールします。NGTをインストールすると、VM Mobilityの機能としてVirtIO Driverがインストールされます。
Prism ElementのVM画面から、NGTをインストールする仮想マシンを選択し、「Manage Guest Tools」をクリックして設定画面を開きます。
「Enable Nutanix Guest Tools」にチェックを入れ、「Mount Nutanix Guest Tools」にチェックを入れます。
以下の画面のように「Guest Tools cannot be mounted as there not enough empty CD-ROM(s)」と表示される場合は、OSインストールメディアなど、CD-ROMドライブに何らかのISOがマウントされている可能性があります。
CDがマウントされていた場合は、vCenter Serverの画面から仮想マシンのCD-ROMドライブのマウントを解除し、「クライアントデバイス」に変更します。
次に、ゲストOSのコンソール画面に入ります。
まずは、Windows版のインストール方法から紹介します。
CD-ROMドライブを見ると、「NUTANIX_TOOLS」というメディアがマウントされているかと思いますので、「setup.exe」を実行します。
インストールウィザードが表示されますので、ライセンスを承諾し、「Install」をクリックします。
すると、すぐにインストールが開始されます。
インストールは数分で終わります。
すでにNGTをインストールしている環境で、NGTをアップグレードインストールした場合は、ドライバーが更新されるためOSの再起動を要求されます。
新規でNGTをインストールした場合は、ゲストOSの再起動は不要です。
続いて、Linux版のインストール方法をご紹介します。
Prism Elementの画面から、同様にNGTのISOをマウントします。
ここでは、Rocky Linux 10.1で説明しますが、Linux系であれば基本的な手順は同じです。
まず、mountコマンドを利用し、CD-ROMドライブをマウントします。（ここでは、/mediaにマウントしています）
sudo mount /dev/cdrom /media
続いて、CD-ROM内のディレクトリに移動します。
cd /media/installer/linux
インストールにはPythonを利用します。Python 3がインストール済みの場合は、以下のように実行します。
python3 ./install_ngt.py --operation install
以下のような形で、インストールが完了します。
[root@rocky10 linux]# python3 ./install_ngt.py --operation install
[2026-09-12 16:08:17] {install_ngt.py:61} INFO - Executing command: which rpm
[2026-09-12 16:08:17] {install_ngt.py:81} INFO - Output: /bin/rpm
[2026-09-12 16:08:17] {install_ngt.py:61} INFO - Executing command: which dpkg
[2026-09-12 16:08:17] {install_ngt.py:106} WARNING - Dpkg command failed due to error : which dpkg failed, Status code:1, Output:'', Error:'which: no dpkg in (/root/.local/bin:/root/bin:/sbin:/bin:/usr/sbin:/usr/bin)\n'
[2026-09-12 16:08:17] {install_ngt.py:61} INFO - Executing command: sh /media/installer/linux/ngt_rpm_installer/ngt_install_upgrade.sh
[2026-09-12 16:09:54] {install_ngt.py:81} INFO - Output: Current Directory: /media/installer/linux/ngt_rpm_installer
Linux Distribution : NAME="ROCKY LINUX"
VERSION="10.1 (RED QUARTZ)"
ID="ROCKY"
ID_LIKE="RHEL CENTOS FEDORA"
VERSION_ID="10.1"
PLATFORM_ID="PLATFORM:EL10"
PRETTY_NAME="ROCKY LINUX 10.1 (RED QUARTZ)"
ANSI_COLOR="0;32"
LOGO="FEDORA-LOGO-ICON"
CPE_NAME="CPE:/O:ROCKY:ROCKY:10::BASEOS"
HOME_URL="HTTPS://ROCKYLINUX.ORG/"
VENDOR_NAME="RESF"
VENDOR_URL="HTTPS://RESF.ORG/"
BUG_REPORT_URL="HTTPS://BUGS.ROCKYLINUX.ORG/"
SUPPORT_END="2035-05-31"
ROCKY_SUPPORT_PRODUCT="ROCKY-LINUX-10"
ROCKY_SUPPORT_PRODUCT_VERSION="10.1"
REDHAT_SUPPORT_PRODUCT="ROCKY LINUX"
REDHAT_SUPPORT_PRODUCT_VERSION="10.1"
ROCKY LINUX RELEASE 10.1 (RED QUARTZ)
ROCKY LINUX RELEASE 10.1 (RED QUARTZ)
ROCKY LINUX RELEASE 10.1 (RED QUARTZ)
Rocky Linux 10 - BaseOS 8.6 kB/s | 4.3 kB 00:00
Rocky Linux 10 - BaseOS 27 MB/s | 27 MB 00:00
Rocky Linux 10 - AppStream 9.1 kB/s | 4.4 kB 00:00
Rocky Linux 10 - AppStream 739 kB/s | 2.6 MB 00:03
Rocky Linux 10 - Extras 7.0 kB/s | 3.1 kB 00:00
Rocky Linux 10 - Extras 11 kB/s | 5.8 kB 00:00
インストール済みパッケージ
名前 : rpm
バージョン : 4.19.1.1
リリース : 20.el10
Arch : x86_64
サイズ : 3.0 M
ソース : rpm-4.19.1.1-20.el10.src.rpm
リポジトリー : @System
repo から : anaconda
概要 : The RPM package management system
URL : http://www.rpm.org/
ライセンス : GPL-2.0-or-later
説明 : The RPM Package Manager (RPM) is a powerful command line driven
: package management system capable of installing, uninstalling,
: verifying, querying, and updating software packages. Each software
: package consists of an archive of files along with information about
: the package like its version, a description, etc.
利用可能なパッケージ
名前 : rpm
バージョン : 4.19.1.1
リリース : 23.el10
Arch : x86_64
サイズ : 543 k
ソース : rpm-4.19.1.1-23.el10.src.rpm
リポジトリー : baseos
概要 : The RPM package management system
URL : http://www.rpm.org/
ライセンス : GPL-2.0-or-later
説明 : The RPM Package Manager (RPM) is a powerful command line driven
: package management system capable of installing, uninstalling,
: verifying, querying, and updating software packages. Each software
: package consists of an archive of files along with information about
: the package like its version, a description, etc.
Nutanix NGT 390 kB/s | 2.1 kB 00:00
利用可能なパッケージ
nutanix-guest-agent.i686 4.3.1-1 nutanix-ngt-20260912160817
nutanix-guest-agent.x86_64 4.3.1-1 nutanix-ngt-20260912160817
メタデータの期限切れの最終確認: 0:00:01 前の 2026年07月12日 16時08分30秒 に実施 しました。
依存関係が解決しました。
============
# パッケージ Arch バージョン リポジトリー サイズ
インストール:
nutanix-guest-agent x86_64 4.3.1-1 nutanix-ngt-20260912160817 60 M
依存関係のインストール:
libxcrypt-compat x86_64 4.4.36-10.el10 appstream 90 k
# トランザクションの概要
インストール 2 パッケージ
合計サイズ: 60 M
ダウンロードサイズの合計: 90 k
インストール後のサイズ: 302 M
パッケージのダウンロード:
libxcrypt-compat-4.4.36-10.el10.x86_64.rpm 1.0 MB/s | 90 kB 00:00
---------------------------------------------------------------------------
合計 181 kB/s | 90 kB 00:00
Nutanix NGT 3.0 MB/s | 3.1 kB 00:00
鍵のインポートに成功しました
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
準備 : 1/1
インストール中 : libxcrypt-compat-4.4.36-10.el10.x86_64 1/2
scriptletの実行中: nutanix-guest-agent-4.3.1-1.x86_64 2/2
Pre: RPM is getting installed
インストール中 : nutanix-guest-agent-4.3.1-1.x86_64 2/2
scriptletの実行中: nutanix-guest-agent-4.3.1-1.x86_64 2/2
Post: RPM is getting installed.
Running installer utility script.
/usr/local/nutanix/ngt//src/rpm_installer_utils.py:74: DeprecationWarning: distutils Version classes are deprecated. Use packaging.version instead.
if LooseVersion(self.version) < LooseVersion(self.REDHAT_8_VERSION):
INFO: Setting up Nutanix Guest Tools - VM mobility drivers.
WARNING: Kernel module bochs-drm does not exist.
INFO: Successfully set up Nutanix Guest Tools - VM mobility drivers.
INFO: Creating desktop shortcuts...
Reloading systemd manager configuration...
Restarting ngt_guest_agent.service systemctl service...
ngt_guest_agent.service service restart done.
Restarting ngt_self_service_restore.service systemctl service...
ngt_self_service_restore.service service restart done.
インストール済み:
libxcrypt-compat-4.4.36-10.el10.x86_64 nutanix-guest-agent-4.3.1-1.x86_64
完了しました!
メタデータの期限切れの最終確認: 0:01:23 前の 2026年07月12日 16時08分30秒 に実施 しました。
依存関係が解決しました。
行うべきことはありません。
完了しました!
cleanup started...
Removing yum repo : /etc/yum.repos.d//nutanix-ngt-20260912160817.repo, if exists.
Removing temporary created repo file : /tmp/nutanix-ngt-20260912160817.repo, if exists.
cleanup done...
[2026-07-12 16:09:54] {install_ngt.py:83} ERROR - Failure : GPG 鍵 0x6E4B3ED2 をインポート中:
Userid : "Nutanix, Inc. (NGT Packaging) "
Fingerprint: 112B XXXX XXXX XXXX XXXX XXXX XXXX 46BC 6E4B 3ED2
From : /media/installer/linux/ngt_rpm_installer/RPM-GPG-PUBLIC-KEY
[root@rocky10mst linux]#
最後にGPG鍵のインポートエラーが出ていますが、ドライバーのインストール自体は完了しているため、ここでは一旦この問題はスキップします。
これで、NGTのインストールは完了です。
ただし、インストールしただけではなく、Convert ClusterのValidationでWarningが表示されないようにするため、NGTとNutanixクラスターが正常に通信できていることを確認します。
CVMにSSHでログインし、NGTエージェントとNutanixクラスターが通信できているかを確認します。
ncli vm lsで、NGTをインストールした仮想マシンのUUIDを確認します。
nutanix@NTNX-XXXX-A-CVM:XX.XX.XX.XXX:~$ ncli vm ls name=CNV-RokcyLinux10.1 ``` Id : 00063087-e3d4-f515-1df0-1866da62c70a::50380ffc-8f75-393c-49c0-a1164d96d1a2 Uuid : 9566cc78-ba5d-4ab7-9763-ebce99dca637 #★こちらを控える Name : CNV-RokcyLinux10.1 VM IP Addresses : XX.XX.XX.18, fe80::250:56ff:feb8:ffe0 Hypervisor Host Id : 00063087-e3d4-f515-1df0-1866da62c70a::6 Hypervisor Host Uuid : b17e247e-aa3c-4da0-94f3-5eb251e3991a Hypervisor Host Name : ESX3 Memory : 4 GiB (4,294,967,296 bytes) Virtual CPUs : 4 VDisk Count : 2 VDisks : 00063087-e3d4-f515-1df0-1866da62c70a::NFS:4:0:13174, 00063087-e3d4-f515-1df0-1866da62c70a::NFS:4:0:13231 Protection Domain : Consistency Group : ``` nutanix@NTNX-XXXX-A-CVM:XX.XX.XX.XXX:~$ ncli ngt get vm-id=9566cc78-ba5d-4ab7-9763-ebce99dca637 ``` VM Id : 00063087-e3d4-f515-1df0-1866da62c70a::50380ffc-8f75-393c-49c0-a1164d96d1a2 VM Name : CNV-RokcyLinux10.1 NGT Enabled : true Tools ISO Mounted : false Vss Snapshot : true File Level Restore : false Communication Link Active : true #★ここがtrueならOK ```
「Communication Link Active」がtrueになっていれば問題ありません。
2026年9月時点でサポートされているAOS 6.10以降であれば、NGTはNutanixクラスターのVIP以外に、COMポートを使用してハイパーバイザーとの通信も行えるようになっているため、仮想マシンのネットワークとNutanixクラスターの管理ネットワークが分離されていても、通信上の問題はありません。
これで、仮想マシンの準備は終わりました。
仮想アプライアンスなど、NGTをインストールできないものについては、あらかじめVirtIO Driverが組み込まれているかを確認してください。仮想アプライアンスがESXi版とAHV版で分かれている場合は、仮想アプライアンス上で稼働するシステム設定のバックアップを取得し、AHV版のアプライアンスを再展開して設定をインポートするなど、無理に変換だけにこだわらない手法を選択してください。
5.仮想マシンの保護
クラスターを変換する準備ができたら、必ずData Protectionで、すべての仮想マシンを保護してください。万が一、変換中にエラーが発生した場合でも、Protection Domainから仮想マシンを復旧することができます。（AHVへの変換後にリストアした場合、自動的にAHVに変換された仮想マシンとしてリストア可能です）
以上で準備は整いました。次回は、Convert Clusterの作業を行いたいと思います。
0 件のコメント:
コメントを投稿