Search Knowledge Base by Keyword

Nutanix AHV Compatibility Matrix

< Back

Overview

Nutanix publishes a Guest OS compatibility and interoperability matrix on its support portal. The matrix lists which guest operating systems are supported on AHV, the Nutanix hypervisor, and at which AOS releases, along with the driver and integration caveats that apply to each. It is reference data rather than estate data: it describes what Nutanix supports, and it changes when Nutanix publishes a new AOS release or adds guest OS coverage.

The ReadyWorks connector imports the CSV export of that matrix. There is no API and no credential. An administrator downloads the matrix from the Nutanix portal and uploads it through the ReadyWorks console, and the csv_file.php driver parses it into the nutanix_ahv_matrix staging table. The connection defaults Manual File Upload to Yes, which reflects the fact that the file is fetched by a human from a portal rather than dropped on a server by a scheduled export.

The value is in the join. On its own the matrix is a support document. Loaded into the data fabric alongside VMware inventory from RVTools, Nutanix Collector or the vCenter connector, it turns each virtual machine’s guest OS descriptor into an AHV migration verdict: supported, supported at a later AOS level, or unsupported. That is the input a migration team needs to split an estate into waves and to identify the machines that need an OS upgrade before they can move at all.

The connector is inbound only. It reads a file and writes a staging table, and nothing is sent to Nutanix.

NOTE: This is the one connector in this set whose shipped job arrives enabled, on a monthly schedule. It will start running as soon as a connection exists, so upload the matrix file before you create the connection.

Connector Properties

Property Value
Identifier NUTANIX_AHV_MATRIX
Name Nutanix AHV Compatibility Matrix
Description Imports the Guest OS compatibility matrix CSV exported from the Nutanix support portal, used to classify VMware guest OS descriptors for AHV migration readiness.
Job Types Inbound Only
Order 32
Enabled Yes
Locked Yes
Block Update No
Single Authentication No
Windows Only No
Connector Version 2026-07-06
Hooks None
Additional Job Fields None
Image None

Authentication Methods

The connector offers one method. It expects the matrix CSV to be uploaded through the console, and it needs no credentials.

Method Identifier Base Method Script Order Enabled Config Fields
Comma Separated File NUTANIX_AHV_MATRIX_631a CSV_file csv_file.php 10 Yes 3

Method 1: Comma Separated File (NUTANIX_AHV_MATRIX_631a)

No Authentication

Comma Separated File reads the matrix export from the connection path. Manual File Upload defaults to Yes here, so the expected workflow is that an administrator downloads the CSV from the Nutanix support portal and attaches it in the console. Set it to No and adjust Server File Path if you have an automated process that drops the file on the ReadyWorks server instead.

Connection Configuration Fields (3)

Order Label Type Required Default Max Len Tooltip
30 Server File Path text Yes storage/etl5 255 Enter path where the files to process are located or where manually uploaded files are stored (exclude starting and ending backslash)
230 Manual File Upload radio Yes 1 Choose if file is uploaded manually or processed from the server
250 Additional Job Fields fields_list No Enter list of additional fields to add to staging data for all jobs

No authentication recipe is stored. The driver script authenticates natively using the fields above.

Inbound Job Fields Enabled (11)

These are the job-level settings exposed for the compatibility matrix import.

Order Label Type Required Default Tooltip
10 Job Description text Yes Enter description of the Job
20 Job Schedule lookup Yes Monthly Select frequency Job should run
30 Enabled radio Yes Yes Choose if Job is enabled
60 Allow Empty Table radio Yes Yes Choose if an empty table is allowed
70 Destination Table text Yes Enter name of the destination table
80 Data Identity text No Enter identity of the Job
90 CSV File or Path textarea No Enter CSV filename or path (exclude starting and ending backslash); leave blank to upload all files in the base folder path of the Connection
110 Append Files to Same Destination Table radio No No Choose if multiple files in the same path will append to the same destination table, or will create a new destination table for each file
120 Append New Data to Existing Tables radio No No Choose if new data will append to the existing destination table, or will create a new destination table
130 Fields to Index text No Enter fields to index
560 Order text Yes Enter order of the Job

Inbound Job Templates (1)

One inbound template ships. It is enabled by default and runs monthly, which matches the rate at which Nutanix revises the matrix.

# Job Description Destination Table API End Point Enabled What It Pulls
1 Nutanix AHV Guest OS Compatibility Matrix nutanix_ahv_matrix Not set Yes Reads OS Compatibility Matrix.csv into nutanix_ahv_matrix. Each row pairs a guest operating system and version with the AOS release levels that support it on AHV, plus the qualifying notes Nutanix attaches to that combination. The template also carries a data processing value of AOS Version, which tells the parser which column identifies the AOS release.

Job Template Configuration

Settings

Setting Value
Order 10
Enabled Yes
Job Schedule Monthly (45 2 1 * *)
Destination Table nutanix_ahv_matrix
Data Identity nutanix_ahv_matrix
data_processing AOS Version
Allow Empty Table Yes
Append Files to Same Destination Table No
Append New Data to Existing Tables No
Use Unparsed Data No
Convert UUID-Keyed Objects to Rows No
Ignore XML Attributes No
Log Raw API Calls No
Method Type GET
Body Data Sending Method JSON Encoded Data

Job Parameters and Enumeration

Nutanix AHV Guest OS Compatibility Matrix

CSV File or Path: OS Compatibility Matrix.csv

NOTE: The file name contains spaces. Enter it exactly as OS Compatibility Matrix.csv, without wrapping quotes, and confirm the name matches what the portal download actually produced.

Outbound Job Templates (0)

This connector ships no outbound templates and does not support outbound jobs.

Tags: