Dell Nutanix: How to upgrade Nutanix Cluster Check (NCC)

The upgrade steps are different depends on the AOS version.

• AOS 5.1.1 and later: all of the above method 2, 3, 4
• AOS 4.7～5.1: above method 4 only

Perform Health Check

Before upgrade NCC, perform a health check to ensure the cluster does not have any issue.

Upgrade Online - GUI

1. Open the Prism, click the gear icon on the upper right corner and select Upgrade Software.
   

• On the Upgrade Software screen click NCC tab.

• Check the current version on CURRENT VERSION field and available upgrade version on AVAILABLE COMPATIBLE VERSIONS field, then click Download.
  

• Wait for a while after download starts and click Upgrade when download completed.

• Click Yes on the confirmation window and upgrade starts.
  

• The following popup may be displayed during the upgrade.
  This message indicates the possibility of which Prism service may be temporarily unavailable during this upgrade.
  This is not an error message and you can click OK to proceed upgrade.
  

• The upgrade is completed when the progress becomes 100%.
  Click Close to close the Upgrade Software window.
  

Upgrade Offline - GUI

1. Download files required from Nutanix Support Portal (https://portal.nutanix.com/#/page/static/supportTools).
   Alternatively, log in to Nutanix Support Portal and navigate to Tools & Firmware from download screen to download files.

2. Enter "NCC" into the filter on the upper part and download Nutanix Cluster Check Metadata JSON file and a binary file with the filename extension .tar.gz.
   

• Same as step 1 in "Upgrade Online - GUI", open Upgrade Software window from the gear icon.

• Click NCC tab on the Upgrade Software screen and click upload the NCC binary on the lower part.
  

• Select each file downloaded in step 1 on NCC METADATA FILE and NCC BINARY FILE field.

• Click Upload Now and files will be uploaded to the Prism.

• After upload completed the version will be displayed in AVAILABLE COMPATIBLE VERSIONS field.
  Click Upgrade and upgrade will be started.
  

• The steps after are the same as step 5 and after in "Upgrade Online - GUI".

Upgrade Offline - CLI

1. Download files required from Nutanix Support Portal (https://portal.nutanix.com/#/page/static/supportTools).
   Alternatively, log in to Nutanix Support Portal and navigate to Tools & Firmware from download screen to download files.

2. Enter "NCC" and download the file which has "installer.sh" at the end of the file name.
   At the same time, write down the MD5 value.
   

• Upload installer.sh file to under "/home/nutanix" of one of the Controller VM (CVM) under Cluster (Upload is available using common SCP tool such as WinSCP).
  In the following example screen, the result of which confirmed the information in the directory with ls command after login with SSH to CVM uploaded to after upload completed is displayed.
  In this example, "nutanix-ncc-el7.3-release-ncc-3.6.3-x86_64-latest-installer.sh" is the install program for NCC 3.6.3.
  

• Log in with SSH to uploaded CVM, and confirm MD5 value with command $ md5sum ./NCC installer file name.sh before installation.
  The strings displayed before the file name is the MD5 value. Ensure that MD5 value is the same as which you wrote down in step 2, and proceed the remain steps.
  If the confirmed MD5 value is not the same as which you wrote down in step 2, delete the uploaded file, download and upload the file again and recheck the MD5 value.
  

• Use the following commands to grant the executive authority to the installer file and execute it.

  • Grant executive authority: $ chmod u+x ./NCC installer file name.sh
  • Execution: $ ./NCC installer file name.sh

  If there is no error output after the command executed, granting executive authority was completed successfully. Once the installer is executed, NCC is upgraded every each node participating in the Cluster.
  

• When "Successfully updated NCC version" displayed, the upgrade is completed.