How It works

Have questions about how the Nutanix Platform works? Looking to get started - start here!

  • 1,223 Topics
  • 1,874 Replies
Albert Mendoza
Rank
Albert Mendoza
started this topic

Top KB Articles for October 2022

Below are the top knowledge base articles for the month of October 2022.KB 1540 - [AOS Only] What to do when /home partition or /home/nutani...
  • 2
  • 0
Albert Mendoza
Rank
Albert Mendoza
started this topic

New KB Articles Published on Week Ending October 29, 2022

Below are new knowledge base articles published on the week of October 23-29, 2022.KB 13136 - NCC Health Check: microservice_infrastructure_...
  • 1
  • 0
Alona
Rank
Alona
started this topic

Help us help you! Assign Support Contact to your Nutanix assets.

We know you care about your infrastructure. Every time and auto support ticket is created for one of Nutanix clusters a Support Engineer con...
  • 0
  • 0

1223 Topics

I
Ivars StrazdinsVoyager
asked in How It works

Cannot create and attach a vdisk to VM via REST API

Hi, I am trying to attach a vdisk to a VM. So far I have found that the only way to create and attach a new vdisk to VM is via this API  POST /vms/{uuid}/disks/attach I am trying using this curl expression: curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{  "uuid": "IDEMPOTENT_UUID",  "vm_disks": [    {      "is_cdrom": false,      "is_empty": false,      "is_scsi_pass_through": false,      "is_thin_provisioned": false,      "vm_disk_create": {        "size": 1,        "storage_container_uuid": "CONTAINER_UUID"      }    }  ]}' 'https://10.10.10.10:9440/api/nutanix/v2.0/vms/VM_UUID/disks/attach' \--insecure --basic --user obfuscated_username:obfuscated_password The task fails and error is: “InvalidArgument: Invalid disk size 0”. What am I missing here? Thanks for your time, Ivars

2
aluciani
3 years ago
Albert Mendoza
Nutanix Employee
Albert MendozaNutanix Employee
posted in How It works

New KB Articles Published on Week Ending May 2, 2020

Below are new knowledge base articles published on the week of April 26-May 2, 2020. KB 8482 - Prism shows a spinning icon preventing AHV upgrades on mixed (ESXi+AHV) clusters KB 8874 - Nutanix Files - Alert - A160053 - File Server Share Backup diff path translation failed KB 9111 - LCM update is disabled since there is an emergency update available KB 9215 - NCC Health Check: dimm_hppr_check KB 9240 - ESXi Host may not enumerate all NICs due to outdated drivers KB 9289 - Licensing Conversion - LOD (Life of Device) to CBL (Capacity Based) License KB 9298 - Using tcpdump tool on AHV host KB 9301 - Windows: How to Reset Local Administrator Password KB 9310 - How to Disable the Windows 10 First Sign-in Animation KB 9323 - Upgrade or imaging of Windows 2019 might fail due to vmms registration problems Note: You may need to log in to the Support Portal to view some of these articles.

0
Albert Mendoza
Nutanix Employee
3 years ago
C
cviernes-59806Voyager
asked in How It works

Does AHV support Automatic Site Failover or supports Metro Witness?

I have read that it is only supported using ESXI. If so, what are the other ways to automate the failover.

3
JeremyJ
Nutanix Employee
3 years ago
Shaurya
Nutanix Employee
ShauryaNutanix Employee
posted in How It works

How to modify the hostname of the Controller VM?

This article describes how to rename the CVM entity in Prism within the AHV environment. This does not change the hostname of the CVM displayed in a console/SSH session as the hostname is a value configured within the CMV OS and is independent of the Controller VM name entity recorded in the Prism entity DB (Insights Data Fabric). It is the same name as in CVM’s XML definition on the AHV host. It can be checked by listing VMs on the host. The name displayed is the name that is shown in the Prism Wen console. Starting from AOS 5.10.10, 5.15 and 5.16, change_cvm_display_name script is available on CVM that can be used to change the display name.   Following is the overview of the rename procedure: Complete the pre-checks:  Name must start with NTNX- and end with -CVM. Only letters, numbers and "-" are supported in the name. CVM should be able to receive a shutdown token. Once CVM has shutdown token it will be turned off.  The script does not put the CVM or the host into mainten

0
Shaurya
Nutanix Employee
3 years ago
Albert Mendoza
Nutanix Employee
Albert MendozaNutanix Employee
posted in How It works

Top KB Articles for April 2020

Below are the top knowledge base articles for the month of April 2020. KB 7604 - Disk space usage for root on Controller VM has exceeded 80% KB 4116 - Alert - A1187, A1188 - ECCErrorsLast1Day, ECCErrorsLast10Days KB 7503 - G6, G7 platforms - DIMM Error handling and replacement policy KB 1540 - What to do when /home partition or /home/nutanix directory is full KB 4141 - Alert - A1046 - PowerSupplyDown KB 4158 - Alert - A1104 - PhysicalDiskBad KB 4409 - LCM: (LifeCycle Manager) Troubleshooting Guide KB 1113 - HDD/SSD Troubleshooting KB 8792 - NCC checks: same_hypervisor_version_check, duplicate_cvm_ip_check, same_timezone_check, esx_sioc_status_check, power_supply_check, orphan_vm_snapshot_check giving ERR KB 2090 - AHV | Host and Guest Networking KB 1523 - NCC Health Check: disk_usage_check KB 2473 - NCC Health Check: cvm_memory_usage_check KB 2486 - NCC Health Check: cvm_mtu_check KB 4519 - NCC Health Check: check_ntp KB 4541 - Alert - A101055 - MetadataDiskMountedCheck KB 3357 - NCC H

0
Albert Mendoza
Nutanix Employee
3 years ago
Drshoe28
Drshoe28Voyager
posted in How It works

VMware 6.0 to 6.7 Upgrade Process

Hey all,   At the suggestion of some people, sharing this video that I’ve created that goes through the VMware upgrade process using Nutanix 1-click functionality. Check it out if you’d like. Apologies in advance for the poor quality - it was the best way for me to hide any confidential info on screen. Cheers!

0
Drshoe28
3 years ago
HITESH0801
Nutanix Employee
HITESH0801Nutanix Employee
posted in How It works

Understanding alert node "marked to be detached" state

There may be instances where you'll receive the following alert in your environment      "Cassandra on CVM x.x.x.31 is now detached from the ring due to Node was down for a long time. Node detach procedure done by x.x.x.41."   Before understanding the alert, let's first understand what is Cassandra and the ring-structure?    Cassandra stores and manages all of the cluster metadata in a distributed ring-like manner based upon a heavily modified Apache Cassandra. The Paxos algorithm is utilized to enforce strict consistency. This service runs on every node in the cluster. The Cassandra is accessed via an interface called Medusa   To know more about Cassandra and the ring-structure, try going through Nutanix Bible which explains the architecture. .      Cassandra has a feature called auto-ring repair which helps to prevent taking the cluster down due to multiple node failures at different intervals.   The following article lists more information about the alert, auto-repair feature and ho

0
HITESH0801
Nutanix Employee
3 years ago
E
etr.ericAdventurer
asked in How It works

FIQL Filtering - Not Equal

We make use of a lot of the FIQL filtering in our automation to pare down results from various REST calls. However, it seems that while filtering on things like category_name or category_value work just fine with an ==, they don’t seem to work with an !=. Is there a way to do an inequality filter, specifically with v3 of the Prism Central API?

1
AntonioG
Nutanix Employee
3 years ago
AntonioG
Nutanix Employee
AntonioGNutanix Employee
posted in How It works

How to Reset password for Nutanix Prism Local User

Here is a tip on how to reset the password for Nutanix Prism local user. The guide applies to Nutanix Prism Central as well. There are two ways. 1. Using Prism interface Log in to Prism Element with domain user and  go to User Management Prism user management   From the user's window choose user and click update. On the bottom of the applet there is a Reset password button.     2. Command line Log in to CVM over SSH and get into ncli command line. Follow the step by step instructions by reading Reset Web Console or nCLI Password Also if you want to know how to modify the Prism user password expire days for security reasons, you can follow this article: Modify Prism admin and console user password expire days.

0
AntonioG
Nutanix Employee
3 years ago
Shaurya
Nutanix Employee
ShauryaNutanix Employee
posted in How It works

NCC Series | secure_boot_check

Secure Boot is specifically designed to prevent a malicious boot loader attack and has been the most widely accepted approach for both Windows and Linux. Secure Boot is supported by major hardware and hypervisor vendors.    Windows introduced a new specification called Unified Extensible Firmware Interface (UEFI) that connects the computer’s firmware to its operating system (OS). UEFI is now part of an open-source forum UEFI and is expected to eventually replace BIOS.   In order for Nutanix to fully support secure boot, Nutanix binaries are now signed with keys that the hardware trusts.   The Nutanix public keys will either be available by default in the hardware or a customer would need to manually obtain Nutanix Public Keys and import them into the hardware UEFI administration interface. With Nutanix public keys made available in the hardware, UEFI will allow Nutanix binaries to boot securely.   The NCC check returns a PASS if the following is true: All Hosts is running with Secure

0
Shaurya
Nutanix Employee
3 years ago
Shaurya
Nutanix Employee
ShauryaNutanix Employee
posted in How It works

What are the Nutanix compute nodes?

There are 3 types of Nutanix nodes:    An HCI Node is the most common kind of node. It is heavily equipped with all three components: processing capacity (CPU), memory (RAM), and data storage capacity. An HCI node can run any kind of supported hypervisor. A Storage Node only runs the Nutanix AHV hypervisor. These nodes have a bare minimum of processing and memory capacity however, as the name suggests, have plenty of storage onboard. A Compute Node only runs the Nutanix AHV hypervisor. Logically, these are nodes that have minimum storage onboard but are powerful compute and memory devices.   We are going to take a look at compute nodes in this post.   A compute-only (CO) node allows you to seamlessly and efficiently expand the computing capacity (CPU and memory) of your AHV cluster. The Nutanix cluster uses the resources (CPUs and memory) of a CO node exclusively for computing purposes.   CO nodes enable you to achieve more control and value from restrictive licenses such as Ora

0
Shaurya
Nutanix Employee
3 years ago
Shaurya
Nutanix Employee
ShauryaNutanix Employee
posted in How It works

What are the Nutanix Storage nodes?

There are 3 types of Nutanix nodes:    An HCI Node is the most common kind of node. It is heavily equipped with all three components: processing capacity (CPU), memory (RAM), and data storage capacity. An HCI node can run any kind of supported hypervisor. A Storage Node only runs the Nutanix AHV hypervisor. These nodes have a bare minimum of processing and memory capacity however, as the name suggests, have plenty of storage onboard. A Compute Node only runs the Nutanix AHV hypervisor. Logically, these are nodes that have minimum storage onboard but are powerful compute and memory devices.   We are going to take a look at storage nodes in this post.   Storage Nodes (sometimes referred to as “Light Compute” Nodes) are nodes that only use AHV as their hypervisor. Due to their nature no user VMs should be run on these nodes. You will still see a CVM. CVMs are integral to Nutanix architecture as they process all storage input-output requests. Simply put you must have a CMV on each no

0
Shaurya
Nutanix Employee
3 years ago
J
JohanITGTrailblazer
asked in How It works

CVM Crashed

All, I have a 6 Node 1065 system in 2 blocks.  Recently one of the CVMs (node 2, block A) crashed.  When rebooted it was just going in loops.  When diagnosed it seems the SSD (not the SATADOM) had failed and we replaced it.  When we try to boot the CVM, it still just loops. We were told to boot that node with Phoenix which the cluster provided me for download.  I do that and it doesn’t load Phoenix and gets errors instead.  I’m looking for a suggestion of how to get the node back to 100%.  At this point (and throughout) the ESXi on the SATADOM has booted fine and I guess if I didn’t care about the storage side I could just ignore this but I’d like the system to be fully healthy. Any suggestion about how to get the CVM working again would be appreciated. Thank you Johan

34
J
3 years ago
AntonioG
Nutanix Employee
AntonioGNutanix Employee
posted in How It works

Redundancy Factor vs Replication Factor

What is the difference between the Redundancy Factor and Replication Factor? Redundancy factor 3 is a configurable option that allows a Nutanix cluster to withstand the failure of two nodes or drives in different blocks. By default, Nutanix clusters have redundancy factor 2, which means they can tolerate the failure of a single node or drive. The larger the cluster, the more likely it is to experience multiple failures. Redundancy Factor 3 requirements: Min 5 nodes in the cluster. CVM with 32GB RAM configured. For guest VM to tolerate a simultaneous failure of 2 nodes or 2 disks in different blocks, VM data must be stored on a container with replication factor 3. NOTE: Nutanix cluster with FT2 enabled, can host storage containers with RF=2 and RF=3. Redundancy Factor 2 requirements: Min 3 nodes in the cluster. CVM with 24GB RAM configured. Some background to understand Redundancy Factor. Cassandra Key Role: Distributed metadata store Description: Cassandra stores and manag

0
AntonioG
Nutanix Employee
3 years ago
Shaurya
Nutanix Employee
ShauryaNutanix Employee
posted in How It works

NCC Series | idf_db_to_db_sync_heartbeat_status_check

The NCC health check idf_db_to_db_sync_heartbeat_status_check verifies the consistency of data replicated from the Source Cluster to the Replica Cluster. IDF is Insights Data Fabric. A DB that contains data about all the entities in the cluster. And it has to be synced between PE and PC. For the purposes of the check, the source cluster is where the check is run from and the replica cluster is the DB instance that is compared against. This check returns a FAIL status when the heartbeat sync time between database on the source cluster and database on the replica cluster crosses a predefined threshold value (10 minutes, by default).  This check is scheduled to run every 5 minutes, by default and will generate an alert after 3 consecutive failures across scheduled intervals   What is the impact? The impact is the data replicated from the source to the replica cluster is not up to date. This could be because some services may not be working as expected.   If this check returns FAIL, verify

0
Shaurya
Nutanix Employee
3 years ago
Shaurya
Nutanix Employee
ShauryaNutanix Employee
posted in How It works

How to identify whether the installed AOS version is LTS or STS

Currently, we have two types of releases: Short Term Support (STS) releases that have new features, but also imply regular upgrades. Long Term Support (LTS) releases that are maintained for a longer duration and provide primarily bug fixes for an extended period of time on a particular release family. Depending on your choice of the type of the release i.e. LTS or STS, you can identify the type that has been currently installed using one of the following methods:  By looking for is LTS field in the nCLI version. By looking for is LTS field in cluster information. From release tag file contents on the CVM. From the Zeus configuration printer. From the upgrade history.   To take a look at the commands involved, how the output looks, and what to expect, please give a read to KB-6235.   To know more about short term and long term releases, take a look at https://next.nutanix.com/prism-infrastructure-management-26/long-term-vs-short-term-support-releases-lts-vs-sts-37087

0
Shaurya
Nutanix Employee
3 years ago
JeremyJ
Nutanix Employee
JeremyJNutanix Employee
posted in How It works

What does Pulse send and why would I want to enable it?

If you've set up a new Nutanix cluster, you've seen the popup during the initial login that asks if you want to disable Pulse (not recommended). Yes, that one.   So you may be wondering, what will it send and why would I want to enable this?   The purpose and scope of Pulse data is cluster health monitoring. The data sent to Nutanix includes hardware, software, and firmware version information, storage usage and configuration details, resiliency status, CVM health status information, and some limited detail about VMs on the cluster. In the Pulse settings UI in Prism you have the option to enable or disable additional support information such as entity names, so you can keep those user-friendly names private if needed.   More complete detail on what gets included in Pulse data transmissions can be found in the document Nutanix Pulse and Remote Diagnostics, or in the article "What is in a Pulse submission to Nutanix?"   So why send this data to Nutanix? The short answer is “so that Nutan

0
JeremyJ
Nutanix Employee
3 years ago
TimGaray
TimGarayTrailblazer
asked in How It works

Checking PowerShell Cmdlet Connection to Cluster

I’m running into an issue with my script to deploy and setup a new VM in AHV.  The part to check for and install Windows Patches can take a while and sometimes I come out of that routine and I’m no longer connected to Prism Element. I connect with Connect-NTNXCluster… I’ve seen where you can use $TestConnect = Get-NutanixCluster and then check the .IsConnected parameter. However in my testing, I last connected yesterday and when I run that this morning it still shows .IsConnected = True so it doesn’t seem like it gets updated. I’ve also changed the Prism Element GUI settings to a 2 hour timeout but still seems like after way less than that I am no longer connected.  Does that apply to script connections as well? What is a good/reliable way to test if I'm still connected (outside of trying a command and catching the “unauthorized” error)?   Thanks!  

2
M
3 years ago
Albert Mendoza
Nutanix Employee
Albert MendozaNutanix Employee
posted in How It works

New KB Articles Published on Week Ending April 25, 2020

Below are new knowledge base articles published on the week of April 19-25, 2020. KB 9225 - Flow | Traffic between Target Group VMs may be blocked whenever a VM Migrate or Power On event is triggered KB 9272 - How to open Urls within the Frame Session KB 9281 - Xi Frame on AHV Manual CCA Configuration Note: You may need to log in to the Support Portal to view some of these articles.    

0
Albert Mendoza
Nutanix Employee
3 years ago
JeremyJ
Nutanix Employee
JeremyJNutanix Employee
posted in How It works

Pulse configuration and connection troubleshooting.

Pulse is an essential tool for maintaining uptime on a Nutanix cluster. While alert emails can directly open a case for an issue which has already happened, the data gathered and sent by Pulse enables identification of potential known issues that haven’t impacted your cluster yet.   Enabling this feature within a Nutanix cluster is fairly simple, but depending on your network setup and security there may be some additional steps to make sure it’s working.   When you first set up your cluster, right around the time you accept the EULA and change the password for ‘admin’ you are given the option to disable Pulse. So long as you don’t select to disable it, Pulse will attempt to work with the default settings. For some environments it’s just that simple. The cluster will start sending data periodically to Nutanix and our Support Portal will highlight any concerns identified based on that configuration. The configuration is once-per-cluster. If you want to check or update your Pulse configu

0
JeremyJ
Nutanix Employee
3 years ago
SubodhJayswal
SubodhJayswalScout
asked in How It works

Webhooks

Where we can see and create webhooks to integrate with third party monitoring tools e.g. BigPanda.

1
Jubran
Nutanix Employee
3 years ago
Shaurya
Nutanix Employee
ShauryaNutanix Employee
posted in How It works

NCC Series | duplicate_hypervisor_ip_check

The NCC health check duplicate_hypervisor_ip_check detects IP addresses that conflict with any of the PE/clusters hypervisor host IPs on the same network. It does so by enumerating all available IPs for the external hypervisor interfaces in the cluster, checks responses to these IPs on the local network, and calls out any duplicate IP's which may be detected.   This check results in a PASS status if none of the Hypervisor IPs have been duplicated in the network. If this check returns a FAIL status, that means that either the Hypervisor External IP or Hypervisor backplane network has a conflicting IP address assigned with another device on the same network.   What can be the impact?   Hypervisor host connectivity can become unstable or unavailable, leading to performance impact, redundancy concerns, and potential downtime.   Below is an overview of the steps involved in case the check reports a failure:   Run an arping command from any of the CVM and ensure a reply is received from onl

0
Shaurya
Nutanix Employee
3 years ago
Shaurya
Nutanix Employee
ShauryaNutanix Employee
posted in How It works

2-Node cluster graceful start/shutdown procedure.

In a traditional Nutanix cluster at least 3 nodes are expected to form a cluster. There is an option however to form a single-node or a two-nodes cluster for ROBO (Remote Office/Branch Office) implementations or as a backup site.   The working of the two-node cluster is different from our usual 3 or more nodes cluster. Some examples are: We cannot expand a two-node cluster. Node removal is not supported. There is no cluster stop for 2 node cluster   So what is the graceful way to shut down and start a two-node cluster?  How to shut down a 2-node cluster: Ensure that the cluster has data resiliency OK and can tolerate one node down from Prism. Stop user VMs - graceful shutdown. There is no cluster stop for 2 node clusters. Log in to a CVM using the nutanix account, and perform a graceful shut down of the CVM.  Wait for 5-10 mins, and then shut down the second CVM.  Shut down the hosts. NOTE: The above two commands used to shutdown the CVMs are different. Take a look at

0
Shaurya
Nutanix Employee
3 years ago
E
etr.ericAdventurer
asked in How It works

Updating a VM via PrismCentral v3 API

While attempting to update a VM category via the prism central API, we are getting a 409 response saying: { 'api_version': '3.1', 'code': 409, 'message_list': [{ 'message': 'Edit conflict: please retry change. Entity CAS version mismatch.', 'reason': 'CONCURRENT_REQUESTS_NOT_ALLOWED' }], 'state': 'ERROR'} It seems to be occurring on only one VM as all others seem to update normally. I can clear it by updating the VM through the gui, however once I try and do it via API I get that error.   Any thoughts on what could be going on with this VM?

7
E
3 years ago
AntonioG
Nutanix Employee
AntonioGNutanix Employee
posted in How It works

Scaling out Prism Central

Are you looking for a way to support more than 12K VMs as part of your Prism Central installation? Then you should try to scale out Prism Central. Nutanix introduced Prism Central scale-out architecture in AOS 5.6. Prism Central scale-out architecture allows  customers to scale out its Prism Central deployments incrementally, depending on the needs. Single Prism Central instance can support up to 12k VMs, with Prism Central scale-out, the number of supported VMs increases up to 25k PoweredOn VMs.  Prism Central scales-out has 3 VMs and has been architected to tolerate one node failure (n+1 fault tolerance). The following requirements must be met before you can expand Prism Central or deploy a Prism Central VM: The specified gateway must be reachable. No duplicate IP addresses can be used. The container used for deployment is mounted on the hypervisor hosts. When installing on an ESXi cluster: vCenter and the ESXi cluster must be configured properly. See the vSphere Administra

0
AntonioG
Nutanix Employee
3 years ago

Badges

Show all badges
Terms & Conditions