How It works | Nutanix Community
Skip to main content

How It works

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

  • 1,430 Topics
  • 2,160 Replies
Albert Mendoza
Rank
Albert Mendoza
started this topic

New KB Articles Published on Week Ending March 9, 2024

Below are new knowledge base articles published on the week of March 3-9, 2024.KB 16144 - Nutanix Files - "Server has no Shares" error in PC...
  • 1
  • 0
Albert Mendoza
Rank
Albert Mendoza
started this topic

Top KB Articles for February 2024

Below are the top knowledge base articles for the month of February 2024.KB 6082 - inode_usage_check fails due to large amount of email file...
  • 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
1430 Topics
S
SeanLittleVoyager
asked in How It works
Stuck on Auth?

Here is my Code Snip [System.Net.ServicePointManager]::ServerCertificateValidationCallback = {$true}$body = "{`"kind`":`"vm`", `"filter`":`"vm_name==.*VMName*`"}"$username = "Admin";$password = ConvertTo-SecureString –String "AdminPassword" –AsPlainText -Force$credential = New-Object –TypeName "System.Management.Automation.PSCredential" –ArgumentList $username, $password$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $username,$password)))$response = Invoke-RestMethod 'https://PRISMIP:9440/api/nutanix/v3/vms/list' -Method 'POST' -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)} -Body $body -Credential $credential$response | ConvertTo-Json And my Response is  Invoke-RestMethod : {"state": "ERROR", "code": 401, "message_list": [{"reason": "AUTHENTICATION_REQUIRED", "message": "Authentication required.", "details": "Basic realm=\"Intent Gateway Login Required\""}], "api_version": "3.1"}At C:\Scripts\Untitled1.ps1:9 char:13+ $response = In

43002
C
Nutanix Employee
4 years ago
P
pso9968Voyager
asked in How It works
Unmount ISO CD-ROM via PC V3 API

I am struggling to get my VM to unmount the ISO via the PC v3 API.  I’m performing a GET, to get the VM Info, I’ve attempted to update the vm with data_source_reference removed, PC updates, but the iso is still attached.  I see different references with V1 on PE, but can’t seem to do it via v3.  anyone had any luck?

40024
P
4 years ago
M
moatasemAdventurer
asked in How It works
Cluster can not tolerate 1 node failure(s) and guarantee available rebuild capacity

Hi all I have a 3 nodes cluster with RF2. I keep getting the following critical alert: Cluster can not tolerate 1 node failure(s) and guarantee available rebuild capacity Cluster cannot tolerate 1 node failure. Current usage of 6552243087527 bytes exceeds max limit of 9010877278002 bytes. I’m not sure which storage this error is about, the numbers in the error is way to big to what the cluster actually has. I’ve attached screenshot of the storage of the cluster. Any help will be much appreciated.  

44793
Alona
Nutanix Employee
4 years ago
C
CharuTrailblazer
asked in How It works
Not able to Delete Snapshot of a Deleted VM(AHV)

I have exported list of all snapshots running on AHV in our environment. On a few snapshots, VM name is empty. I suspect, this is because VM has been deleted without deleting snapshot. Now how to delete such snapshots? Below is example: Snapshot name is “removing ngt” VM-Name Snapshot-Name Creation-Time   servername Test Snapshot 3/19/2019 11:00     removing ngt 2/6/2020 1:00    

38122
C
4 years ago
B
bbrk364Adventurer
posted in How It works
Cover changing the default passwords on the Nutanix CVM (Controller VM), hypervisor, Prism Element and IPMI.

Find the best way to change all of the administrators password on Nutanix. This what I have done: #Changing the admin acct of PE ncli user reset-password user-name=admin password='$NewPassWD$@pe' #Changing the root acct of AHV for i in `hostips`;do echo "--$i--";ssh root@$i 'echo -e "$NewPassWD$@ahv" | passwd --stdin root';done #Changing the nutanix acct of CVM echo "$NewPassWD$@cvm" | sudo passwd --stdin nutanix #Change the ADMIN acct of the IPMI for i in `hostips`; do                 ssh root@$i 'for id in `/ipmitool user list |grep 'ADMIN '|cut -d" " -f1`; do                 echo $id;                 /ipmitool user set password $id "ADMINXXXXXXX";                 done' ; done  ncc health_checks system_checks default_password_check   https://portal.nutanix.com/kb/6153

18460
B
4 years ago
dlira
dliraTrailblazer
posted in How It works
NIACtool [Nutanix inventory AHV collector tool]

I share my software to collect information associated with a Nutanix cluster with AHV hypervisor. Link to download NIACtool v2.1

393510
dlira
4 years ago
Y
YPPVoyager
asked in How It works
Nutanix cluster upgrade

In the Nutanix Cluster upgrade there are five options Upgrade Software AOS File Server Hypervisor NCC Foundation so what is the correct sequence to upgrade whole stack of nutanix software?  

48383
SankarArumugam
4 years ago
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

39342
aluciani
4 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.

11090
Albert Mendoza
Nutanix Employee
4 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.

18613
JeremyJ
Nutanix Employee
4 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

23510
Shaurya
Nutanix Employee
4 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

10990
Albert Mendoza
Nutanix Employee
4 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!

10550
Drshoe28
4 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

20780
HITESH0801
Nutanix Employee
4 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?

39651
AntonioG
Nutanix Employee
4 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.

139670
AntonioG
Nutanix Employee
4 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

6030
Shaurya
Nutanix Employee
4 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

100150
Shaurya
Nutanix Employee
4 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

100230
Shaurya
Nutanix Employee
4 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

1705143
J
4 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

296380
AntonioG
Nutanix Employee
4 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

20010
Shaurya
Nutanix Employee
4 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

10490
Shaurya
Nutanix Employee
4 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

15690
JeremyJ
Nutanix Employee
4 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!  

27562
M
4 years ago

Badges

Show all badges
Terms & Conditions