Skip to main content

Nutanix

Integrate Nutanix Prism Server with Cloudaware to inventory clusters, hosts, virtual machines, storage, networking, and related Nutanix resources across on‑premises and cloud environments in the CMDB.

info
  • Audience: Cloudaware administrators, virtualization/platform teams
  • Outcome: Prism Server is connected, and Nutanix objects are continuously discovered in the CMDB

Capabilities​

  • Read-only discovery of Nutanix Prism inventory (clusters, hosts, VMs, storage, networking)
  • Relationship mappings between Nutanix objects in the CMDB
  • Search and reporting for Nutanix objects using CMDB Navigator, CMDB list views, and reports

Prerequisites​

Before you begin, ensure the following prerequisites are met:

  • Authentication method selected
    • API key (recommended)
    • Username and password
  • Required permissions assigned
    • The Nutanix account used for the integration must have at least one of the following roles:
      • Cluster Viewer
      • Prism Viewer
    • The assigned role must provide full read access to all required entity types and instances within the selected scope. To learn more about roles, refer to Nutanix documentation.
  • TunHub connectivity configured (for private Prism endpoints)
    • Set up a TunHub gateway and configure a designated route to the Nutanix Prism Server endpoint.
    • Ensure the Prism Server is reachable from the internal host where the Cloudaware Breeze Agent is installed for TunHub.

Add Prism Server Details​

  1. In Cloudaware, go to Admin (Admin Console).
  2. Find Nutanix and click + ADD.
  3. Select the authentication type and fill out the form as described below.

Configure Authentication​

Provide the following values:

  • Name: Enter a descriptive name for this Nutanix integration.
  • Host: Enter the Prism Server hostname or IP address. For TunHub configurations, use the generated host in the following format: https://gw.tunhub.cloudaware.com:port.
  • Trust Certificate: Enable this option if the Prism endpoint is private and a TunHub gateway is configured in Cloudaware.
  • API Key: Enter a Nutanix Prism API key with read access for the required entities. Read more about API access in Nutanix documentation.

Using Username and Password​

Provide the following values:

  • Name: Enter a descriptive name for this Nutanix integration.
  • Host: Enter the Prism Server hostname or IP address.
  • Trust Certificate: Enable this option if the Prism endpoint is private and a TunHub gateway is configured in Cloudaware (in this case, the host link has the format https://gw.tunhub.cloudaware.com:port or similar).
  • Username: Enter the Nutanix username (with at least Cluster Viewer or Prism Viewer role and required read permissions).
  • Password: Enter the corresponding Nutanix password.

Save Integration Details and Verify Status​

  1. Click SAVE to create the integration.
  2. Verify the integration status:
    • A green light in the Status column indicates a successful configuration.
    • A red light indicates a problem. Contact support@cloudaware.com if status does not turn green after correcting credentials or connectivity.
tip

Allow some time for Cloudaware to ingest data after enabling the integration.

View Nutanix Data in CMDB​

To browse discovered Nutanix objects and related data::

  1. In Cloudaware, open CMDB Navigator.
  2. In the left pane, select NUTANIX.
  3. Open an object list, e.g., Nutanix Clusters, to view records.

Supported Objects​

Cloudaware ingests the following Nutanix objects:

Nutanix ObjectCMDB Object API Name
Nutanix ClusterCA10NUT__CaNutanixCluster__c
Nutanix DiskCA10NUT__CaNutanixDisk__c
Nutanix HostCA10NUT__CaNutanixHost__c
Nutanix ImageCA10NUT__CaNutanixImage__c
Nutanix NICCA10NUT__CaNutanixNic__c
Nutanix Object StoreCA10NUT__CaNutanixObjectStore__c
Nutanix Prism ServerCA10NUT__CaNutanixPrismServer__c
Nutanix SubnetCA10NUT__CaNutanixSubnet__c
Nutanix UserCA10NUT__CaNutanixUser__c
Nutanix Virtual MachineCA10NUT__CaNutanixVirtualMachine__c
Nutanix Virtual SwitchCA10NUT__CaNutanixVirtualSwitch__c
Nutanix Volume GroupCA10NUT__CaNutanixVolumeGroup__c
Nutanix VPCCA10NUT__CaNutanixVpc__c

Troubleshooting​

note

Allow some time for the initial data collection to complete after you save the integration.

Authentication Fails or Integration Shows Red Status​

  • Confirm that the Nutanix username/password or API key is valid by logging in to Prism Central or testing an API call.
  • Check that the Nutanix account has at least the Cluster Viewer or Prism Viewer role with read access to required entities.
  • If using a private endpoint through TunHub, verify that the tunnel and route are healthy and that the Host value in the integration matches the generated address (for example, https://gw.tunhub.cloudaware.com:port).
  • Re-enter the credentials or API key by editing the Nutanix integration in Cloudaware.

No Data Appears After a Successful Save Within Several Hours​

  • Allow time for the initial discovery cycle to complete.
  • Ensure the Nutanix account has read access to clusters, hosts, virtual machines, storage, networking, and other required objects.
  • Confirm that the Prism Server endpoint is reachable from the Breeze Agent/TunHub host (DNS resolution, firewall, and routing).
  • In CMDB Navigator, verify that you are viewing the NUTANIX section and related object lists.

SSL or Certificate Errors When Connecting to Prism​

  • If the Prism endpoint uses a private or self-signed certificate behind TunHub, enable Trust Certificate in the Nutanix integration settings.
  • Make sure the Host and port match the endpoint or TunHub route you intend to trust.

Changes in Nutanix Are Not Yet Visible in Cloudaware​

  • Synchronization is periodic; wait for the next collection cycle.
  • If changes remain missing, contact Cloudaware Support to review the collection schedule and logs.

Still stuck? Contact Cloudaware Support at support@cloudaware.com with the integration name and a brief description of the issue.

Reconfigure or Remove the Integration​

Update the Integration Details​

  1. Go to Admin.
  2. Select Nutanix.
  3. Select the specific integration.
  4. Open the three-dot menu (⋮), then click Edit.
  5. Update the required fields.
  6. Click Save.

Remove the Integration from Cloudaware​

  1. Go to Admin.
  2. Select Nutanix.
  3. Select the specific integration.
  4. Open the three-dot menu (⋮), then click Delete.
  5. Confirm the deletion if prompted.

Security Notes​

  • Use a dedicated Nutanix service account with the minimum required read‑only permissions (for example, Cluster Viewer or Prism Viewer).
  • Prefer API key authentication over username/password where possible, and rotate keys regularly according to your organization’s credential‑rotation policy.
  • For private endpoints accessed via TunHub, restrict TunHub routes to the specific Prism host and port required by the integration.
  • Credentials and API keys are stored securely in Cloudaware and are only visible to users with appropriate administrative permissions.