Study guide
6.3 Nutanix Guest Tools (NGT) Architecture, Features, and Deployment
Nutanix Certified Associate NCA
Track your progress as you read
Finished sections get a check mark.
1 Chapter 1: Nutanix Cloud Platform & HCI Foundations
1.1 Nutanix NCA Exam Overview, Format, and Objectives 1.2 Hyperconverged Infrastructure (HCI) vs. Traditional 3-Tier Architecture 1.3 The Nutanix Enterprise Cloud Portfolio (NCI, NUS, NCM, EUC, NC2)
2 Chapter 2: Platform Architecture & Distributed Core Services
2.1 Hardware Building Blocks: Nodes, Blocks, Clusters, and Quorum 2.2 Controller VM (CVM) Architecture, Datapath, and Autopathing 2.3 Core Distributed Services: Cassandra, Stargate, Curator, Zookeeper, and Genesis
3 Chapter 3: Prism Administration & Cluster Operations
3.1 Prism Element vs. Prism Central Architecture and Interface Navigation 3.2 Entity Management, Categories, and Role-Based Access Control 3.3 Nutanix Licensing Tiers, Add-ons, and Pulse Telemetry
4 Chapter 4: AOS Distributed Storage Fabric & Data Placement
4.1 Storage Pools, Storage Containers, and vDisk Virtual Architecture 4.2 Redundancy Factor (RF2 vs. RF3), Failure Domains, and Fault Tolerance 4.3 Data Locality Mechanics and Intelligent Lifecycle Management (ILM)
5 Chapter 5: Storage Optimization & Business Continuity
5.1 Storage Efficiency: Compression, Deduplication, and Erasure Coding (EC-X) 5.2 Space-Efficient Redirect-on-Write (ROW) Snapshots and Zero-Byte Clones 5.3 Protection Domains, Consistency Groups, and Disaster Recovery Replication
6 Chapter 6: AHV Virtual Machine Lifecycle Management
6.1 AHV VM Provisioning, Resource Allocation (vCPU, vRAM, Disks), and Boot Types 6.2 Nutanix Image Service and Virtual Machine Templates 6.3 Nutanix Guest Tools (NGT) Architecture, Features, and Deployment 6.4 AHV High Availability (HA), Acropolis Dynamic Scheduling (ADS), and Affinity Rules
7 Chapter 7: AHV Networking & Flow Security Fundamentals
7.1 AHV Virtual Networking Architecture, Open vSwitch (OVS), and Bridges 7.2 Host Network Uplinks, Virtual Switch Configuration, and NIC Bonding Modes 7.3 Virtual Networks: Managed vs. Unmanaged Networks and IPAM 7.4 Nutanix Flow Network Security & Microsegmentation Fundamentals
8 Chapter 8: Cluster Maintenance, Health Monitoring & Support
8.1 Nutanix Cluster Health Monitoring, Alerts, and Events Engine 8.2 Nutanix Cluster Check (NCC) Architecture and Execution 8.3 Life Cycle Manager (LCM) and Rolling Non-Disruptive Upgrades 8.4 Nutanix Support Ecosystem: Diagnostics, Log Gathering, and Support Bundles
9 Chapter 9: Recognizing Nutanix Solutions, Hypervisors & the Product Portfolio
9.1 Supported Hypervisors for NCI and Feature Supportability 9.2 NCI Core Components, Configurations, and Common Deployment Scenarios 9.3 Nutanix Unified Storage: Files, Objects, and Volumes Use Cases 9.4 Nutanix Database Service (NDB) and Database Automation 9.5 Nutanix Kubernetes Platform, Enterprise AI, and End-User Computing
10 Chapter 10: Nutanix Tools — Migration, Deployment, and Validation
10.1 Nutanix Move: Cross-Hypervisor and Cloud Migration 10.2 Foundation and Foundation Central: Imaging and Cluster Deployment 10.3 X-Ray, Collector, and the Objective 1.3 Tool Inventory
11 Chapter 11: Cluster Configuration, Security & Hardware Maintenance
11.1 Cluster Services Configuration: DNS, NTP, SMTP, and SNMP 11.2 Cluster Security Options: Lockdown, Encryption, and the Recycle Bin 11.3 Node Maintenance Mode, Host Shutdown, and Cluster Shutdown 11.4 Cluster Expansion: Node Types and In-Node Expansion Capabilities 11.5 Out-of-Band Management and Remote Console Access
12 Chapter 12: Storage, Network, and Software Administration Tasks
12.1 Volume Groups, vDisk Placement, and Live vDisk Migration 12.2 Network Visualizer, Physical Switch Monitoring, and Network Segmentation 12.3 The Software Compatibility Matrix and Upgrade Path Planning 12.4 Taking and Managing VM Snapshots in Prism 12.5 License Operations: State, Assignment, Reclamation, and Expiry
13 Chapter 13: Performance Analysis, Reporting & Support Operations
13.1 Prism Analysis: Metric Charts, Entity Charts, and Custom Reports 13.2 Custom Alert Policies and Behavioural Anomaly Detection 13.3 Interpreting Workload Performance: CPU Contention, CPU Ready, Memory, and I/O Latency 13.4 Creating Support Cases, Required Documentation, and Insights
6.3 Nutanix Guest Tools (NGT) Architecture, Features, and Deployment
Key Takeaways Explain This Topic AI
Nutanix Guest Tools (NGT) is an in-guest software package comprising the Nutanix Guest Agent (NGA), high-performance VirtIO drivers, Nutanix VM Mobility drivers, the VSS hardware provider, and the Self-Service Restore (SSR) agent.
Communication between the in-guest Nutanix Guest Agent and the Controller VM occurs exclusively over TCP port 2074 via a secure, mutual TLS (mTLS) encrypted session authenticated by cluster-signed certificates.
The Nutanix Volume Shadow Copy Service (VSS) Hardware Provider integrates with Windows VSS writers to orchestrate application-consistent snapshots for mission-critical transactional workloads like Microsoft SQL Server, Exchange, and Active Directory.
On Linux guest operating systems, application-consistent quiescence is achieved through custom executable shell scripts located at /usr/local/sbin/pre_freeze and /usr/local/sbin/post_freeze.
Self-Service Restore (SSR) hosts a local web service on guest TCP port 2105, enabling authorized guest administrators to mount snapshot disks as secondary drives and restore individual files without hypervisor administrator assistance.
Last updated: September 2026
Nutanix Guest Tools (NGT) Architecture, Features, and Deployment
Quick Summary: Nutanix Guest Tools (NGT) is a specialized software bundle installed directly within guest operating systems to establish secure, bidirectional communication with the Nutanix Controller VM (CVM). NGT delivers four core capabilities: optimized VirtIO drivers for high-throughput networking and storage, Nutanix VM Mobility for cross-hypervisor conversions, the Nutanix VSS Hardware Provider for zero-impact application-consistent snapshots, and Self-Service Restore (SSR) for in-guest file-level recovery. Security is maintained via mutual TLS (mTLS) on TCP port 2074 , authenticated through cluster-generated cryptographic certificates.
1. NGT Architectural Overview and Core Components
While basic virtual machines can run on AHV using standard open-source drivers, enterprise workloads require tight coordination between the guest operating system and the underlying Distributed Storage Fabric (DSF). Nutanix Guest Tools bridges this boundary through an integrated suite of user-space daemons and kernel-space drivers. +-------------------------------------------------------------------------+
- | Guest Virtual Machine |
- | +-------------------------------------------------------------------+ |
- | | Nutanix Guest Agent (NGA Service / Daemon) | |
- | | - Self-Service Restore (SSR) Web Service (Port 2105) | |
- | | - Mutual TLS Cryptographic Client Engine | |
- | +-------------------------------------------------------------------+ |
- | +-------------------------------------------------------------------+ |
- | | In-Guest Drivers & Providers | |
- | | - Nutanix VSS Hardware Provider (Windows VSS coordination) | |
- | | - Application Freeze / Thaw Scripts (Linux pre/post freeze) | |
- | | - VirtIO Multi-Queue Storage & Network Drivers | |
- | | - Nutanix VM Mobility Drivers (Cross-Hypervisor Migration) | |
- | +-------------------------------------------------------------------+ |
- +------------------------------------+------------------------------------+
- | (mTLS Encrypted / TCP Port 2074)
- v
- +------------------------------------+------------------------------------+
- | Controller VM (Local CVM / Cluster) |
- | - Guest Tools Service (Listening on Port 2074) |
- | - Internal Certificate Authority (CA) & Handshake Validator |
- | - Distributed Storage Fabric Snapshot Engine |
- +-------------------------------------------------------------------------+
- The Four Core Functional Pillars of NGT
Nutanix Guest Agent (NGA): The primary background service (running as a Windows Service or Linux systemd daemon) that maintains continuous telemetry heartbeats and command execution channels with the cluster CVMs.
Nutanix VSS Hardware Provider: A certified VSS hardware provider plugin that hooks into the Microsoft Volume Shadow Copy Service framework, coordinating zero-overhead application quiescing directly with DSF.
Self-Service Restore (SSR) Agent: An embedded web server listening locally on TCP port 2105 that empowers guest administrators to browse and mount point-in-time snapshots for file-level recovery.
Nutanix VM Mobility Drivers: A comprehensive driver package pre-installing AHV-compatible storage (VirtIO-SCSI) and network (VirtIO-Net) drivers, enabling non-disruptive migration from VMware ESXi to Nutanix AHV.
2. Security Architecture: Mutual TLS Handshake over Port 2074
Unlike legacy hypervisor guest tools that rely on unauthenticated memory-bus backdoors or cleartext hypervisor communication channels, Nutanix enforces strict cryptographic isolation for all NGT operations. +-------------------------------------------------------------------------+
- | NGT Mutual TLS Security Handshake |
- +-------------------------------------------------------------------------+
- | 1. Admin enables NGT in Prism Element / Prism Central |
- | 2. Acropolis generates VM-unique SSL/TLS certificate pair |
- | 3. Cluster mounts dynamic NGT ISO containing certs to VM CD-ROM |
- | 4. In-Guest Installer extracts client certs to secure key store |
- | 5. NGA initiates mTLS connection to CVM on TCP Port 2074 |
- | 6. CVM validates client certificate; NGA validates cluster CA |
- | 7. Secure, encrypted bi-directional control tunnel established |
- +-------------------------------------------------------------------------+
- The mTLS Authentication Workflow
Dynamic ISO Generation: When an administrator enables NGT for a VM in Prism, the cluster does not attach a generic installer disc. Instead, Acropolis dynamically creates a customized ISO image unique to that specific VM. This ISO contains the NGT installation binaries alongside a unique private key and client certificate signed by the Nutanix cluster's internal Certificate Authority (CA).
Encrypted Session Establishment: Once installed, the Nutanix Guest Agent initiates an outbound TCP connection to the local CVM on TCP port 2074 .
Mutual Authentication: The CVM verifies the validity of the VM's client certificate against its internal database, and the guest agent validates the CVM's SSL certificate against the cluster CA root. If a certificate is revoked, expired, or cloned from another VM, communication is rejected immediately.
Important
If a virtual machine with NGT is cloned without sysprepping, or if the Nutanix cluster certificates are regenerated, NGT communication breaks due to certificate mismatch. To remediate, the administrator must toggle Manage Guest Tools in Prism to mount a fresh NGT ISO and refresh the certificates.
3. Application-Consistent Snapshots: VSS and Linux Scripts
Data protection strategies depend on the consistency level of recovery snapshots. Nutanix classifies snapshots into two critical tiers: +-------------------------------------------------------------------------+
- | Snapshot Consistency Comparison |
- +-----------------------+-------------------------------------------------+
- | Crash-Consistent | - Instantaneous block-level metadata capture |
- | (Standard DSF) | - Equivalent to pulling physical power cord |
- | | - In-flight memory and unwritten buffers lost |
- | | - Requires filesystem journal / DB replay |
- +-----------------------+-------------------------------------------------+
- | Application-Consistent| - In-guest caches flushed to disk before snap |
- | (NGT + VSS / Scripts) | - VSS Writers pause transactional activity |
- | | - Zero database log replay required on recovery |
- | | - Maximum recovery integrity for SQL/Exchange |
- +-----------------------+-------------------------------------------------+
- Windows: Nutanix VSS Hardware Provider
In a standard crash-consistent snapshot, any data residing in volatile server RAM or uncommitted database buffers is lost. While modern transactional databases (such as Microsoft SQL Server or Oracle) can replay transaction logs upon reboot, recovery takes valuable time and carries the risk of partial corruption.
Nutanix solves this on Windows guests through the Nutanix VSS Hardware Provider :
The Nutanix Protection Domain or Prism Central Protection Policy triggers a scheduled snapshot.
The CVM sends an RPC command over TCP port 2074 to the in-guest NGA.
NGA invokes the native Windows Volume Shadow Copy Service (VSS) framework.
VSS notifies registered VSS Writers (Microsoft SQL Server, Exchange Server, Active Directory NTDS, Hyper-V, Oracle VSS Writer).
The VSS writers temporarily quiesce application writes, flush all dirty memory buffers to disk, and freeze the database engine.
The Nutanix VSS Hardware Provider alerts the CVM, which takes an instantaneous Redirect-on-Write (RoW) snapshot at the Distributed Storage Fabric tier in milliseconds.
The CVM signals NGA, which thaws the VSS writers. Normal database transaction processing resumes without application timeout or connection dropping.
Linux: Pre-Freeze and Post-Freeze Scripts
Because Linux operating systems lack a universal native equivalent to Microsoft VSS, NGT implements application consistency via customizable hook scripts:
Directory Location: The Nutanix Guest Agent monitors /usr/local/sbin/ for two specific executable scripts:
- /usr/local/sbin/pre_freeze
- /usr/local/sbin/post_freeze
Execution Mechanics: When an application-consistent snapshot is triggered, NGA executes pre_freeze . This script contains commands to flush buffers and lock tables (for example, executing FLUSH TABLES WITH READ LOCK; in MySQL/MariaDB or issuing ALTER DATABASE BEGIN BACKUP; in Oracle).
Snapshot & Thaw: Once pre_freeze exits with return code 0 , the CVM captures the DSF snapshot. NGA immediately executes post_freeze (e.g., UNLOCK TABLES; or ALTER DATABASE END BACKUP; ) to restore normal read-write database operations.
Tip
The pre_freeze and post_freeze scripts must be owned by root , have executable permissions ( chmod 700 ), and execute within the timeout window (default 60 seconds). If pre_freeze fails or times out, the snapshot defaults to crash-consistent.
4. Nutanix Self-Service Restore (SSR)
In traditional IT environments, restoring an accidentally deleted file or reverting a corrupted configuration document requires submitting a helpdesk ticket to storage administrators, who must locate the backup catalog, mount a historic volume, and copy the file manually.
Nutanix Self-Service Restore (SSR) eliminates this administrative overhead by providing a secure, web-based file recovery interface directly within the guest operating system. +-------------------------------------------------------------------------+
- | Self-Service Restore (SSR) Architecture |
- +-------------------------------------------------------------------------+
- | 1. Guest User browses to: https://localhost:2105 |
- | 2. User logs in with local Windows / Linux OS Admin Credentials |
- | 3. SSR queries CVM (Port 2074) for available historical snapshots |
- | 4. User selects snapshot (e.g., Yesterday 5:00 PM) and clicks [Mount] |
- | 5. CVM dynamically attaches snapshot vDisk as secondary drive (e.g., E:)|
- | 6. User copies desired files directly back to production folders |
- | 7. User clicks [Unmount] (or automatic timeout unmounts after 24 hours) |
- +-------------------------------------------------------------------------+
- SSR Operational Characteristics
Local Web Console: SSR hosts a lightweight web management service listening on TCP port 2105 ( https://localhost:2105 ).
Authentication & RBAC: Users log in using their native guest operating system credentials (local administrator or Active Directory user with administrative rights on that VM). Hypervisor-level credentials are never exposed or required.
Snapshot Mounting: Upon selecting an available snapshot date/time, the CVM attaches the snapshot vDisk to the VM as a secondary drive letter (in Windows, e.g., E: ) or mount point (in Linux, e.g., /mnt/nutanix/ssr/ ).
Safety & Auto-Unmount: Snapshot disks are mounted strictly in read-only mode to preserve historical data integrity. To prevent disk sprawl and stranded iSCSI/SCSI attachments, SSR automatically unmounts mounted snapshot disks after a configurable inactivity threshold (default 24 hours ).
Command-Line Interface: SSR includes a CLI utility ( nutanix-guest-tools/bin/ssr ) allowing power users and backup administrators to script snapshot mount and restore operations.
5. Nutanix VM Mobility and Cross-Hypervisor Migration
One of the most complex challenges in enterprise cloud transformation is migrating workloads between disparate hypervisors (such as moving from VMware ESXi to Nutanix AHV, or between on-premises AHV clusters and public cloud Nutanix Cloud Clusters [NC2] on AWS or Azure).
When a virtual machine running on VMware ESXi is converted to AHV, the VM often crashes during its initial boot with a 0x0000007B INACCESSIBLE_BOOT_DEVICE stop error because the guest OS lacks the required KVM/AHV VirtIO storage controller drivers.
Nutanix VM Mobility solves this driver dilemma:
Pre-Installation: When NGT is deployed to a VM running on VMware ESXi, the VM Mobility service silently pre-injects and registers all requisite Nutanix VirtIO storage and network drivers into the guest operating system's driver store.
Registry Configuration: VM Mobility configures Windows CriticalDeviceDatabase and hardware registry keys to ensure the VirtIO-SCSI driver initializes early during boot phase.
Seamless Cutover: When the VM is migrated to AHV (via Nutanix Move or native asynchronous replication), the guest OS detects the virtual VirtIO controller immediately upon first boot and initializes cleanly without manual driver injection or rescue disk recovery.
6. NGT Deployment and Lifecycle Management
Nutanix provides flexible options for deploying, managing, and upgrading NGT across single workloads or enterprise-scale estates.
- Deployment Method Target Scale Automation Level Prerequisites
- Prism Element GUI Single VM Manual Mount NGT ISO, run installer via VM Console
- Prism Central Batch Install 1 to 1,000+ VMs Automated Push Guest OS administrative credentials provided in PC
Scripted / Silent Install Enterprise Automated High (Ansible, SCCM) Silent installer command flags ( /quiet , ACC=1 )
- AOS Rolling Upgrade Cluster-wide Automated In-Place Automatic NGT upgrade toggle enabled in Prism
- Silent Installation Command Syntax
For enterprise software deployment tools (Microsoft Endpoint Configuration Manager [MECM/SCCM], Group Policy, Ansible, or Puppet), NGT supports fully unattended installations:
Windows Silent Install (MSI): NutanixGuestTools.exe /quiet /norestart ACC=1 SSR=1
Where ACC=1 enables the Application-Consistent snapshot provider, and SSR=1 installs the Self-Service Restore agent.