Table of Contents


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

PropertyValue
IdentifierNUTANIX_AHV_MATRIX
NameNutanix AHV Compatibility Matrix
DescriptionImports the Guest OS compatibility matrix CSV exported from the Nutanix support portal, used to classify VMware guest OS descriptors for AHV migration readiness.
Job TypesInbound Only
Order32
EnabledYes
LockedYes
Block UpdateNo
Single AuthenticationNo
Windows OnlyNo
Connector Version2026-07-06
HooksNone
Additional Job FieldsNone
ImageNone

Authentication Methods

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

MethodIdentifierBase MethodScriptOrderEnabledConfig Fields
Comma Separated FileNUTANIX_AHV_MATRIX_631aCSV_filecsv_file.php10Yes3

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)

OrderLabelTypeRequiredDefaultMax LenTooltip
30Server File PathtextYesstorage/etl5255Enter path where the files to process are located or where manually uploaded files are stored (exclude starting and ending backslash)
230Manual File UploadradioYes1Choose if file is uploaded manually or processed from the server
250Additional Job Fieldsfields_listNoEnter 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.

OrderLabelTypeRequiredDefaultTooltip
10Job DescriptiontextYesEnter description of the Job
20Job SchedulelookupYesMonthlySelect frequency Job should run
30EnabledradioYesYesChoose if Job is enabled
60Allow Empty TableradioYesYesChoose if an empty table is allowed
70Destination TabletextYesEnter name of the destination table
80Data IdentitytextNoEnter identity of the Job
90CSV File or PathtextareaNoEnter CSV filename or path (exclude starting and ending backslash); leave blank to upload all files in the base folder path of the Connection
110Append Files to Same Destination TableradioNoNoChoose if multiple files in the same path will append to the same destination table, or will create a new destination table for each file
120Append New Data to Existing TablesradioNoNoChoose if new data will append to the existing destination table, or will create a new destination table
130Fields to IndextextNoEnter fields to index
560OrdertextYesEnter 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 DescriptionDestination TableAPI End PointEnabledWhat It Pulls
1Nutanix AHV Guest OS Compatibility Matrixnutanix_ahv_matrixNot setYesReads 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

SettingValue
Order10
EnabledYes
Job ScheduleMonthly (45 2 1 * *)
Destination Tablenutanix_ahv_matrix
Data Identitynutanix_ahv_matrix
data_processingAOS Version
Allow Empty TableYes
Append Files to Same Destination TableNo
Append New Data to Existing TablesNo
Use Unparsed DataNo
Convert UUID-Keyed Objects to RowsNo
Ignore XML AttributesNo
Log Raw API CallsNo
Method TypeGET
Body Data Sending MethodJSON 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.

Last updated on 11/4/2026

Attachments