How to retrieve your Nutanix installation status information

To optimize the handling of support tickets for Nutanix on OVHcloud, it is essential to provide OVHcloud teams with a set of information on the status of your Nutanix installation.

Requirements

• A Nutanix cluster in your OVHcloud account
• Login credentials and URL for Prism Central, received via email after the installation

Instructions

We recommend that you retrieve all of the information detailed in this guide before contacting OVHcloud support.

Information on the AOS

Log in to Prism Central, open the main menu in the top left-hand corner, and click on Hardware, then Clusters.

Click the List tab and note down the AOS version for the cluster concerned.

Hypervisor information

Now open the main menu again and click on Hardware then Hosts.
Select a host from the list of hosts in your cluster.

Note the type of Hypervisor and the Hypervisor Version.
In the example below, the hypervisor type is AHV and the hypervisor version is 20201105.1161.

Node Serial Number

From the same host summary tab, note the Node Serial number.

Nutanix Cluster Check (NCC) Health Report

The Nutanix Cluster Check (NCC) health report is a comprehensive report on the current state of the cluster, including many hardware and software control points.

This NCC report can help OVHcloud and Nutanix support carry out investigations on any faults found on your cluster.

To get this report, log into Prism Central, open the menu in the top left-hand corner, and click Hardware, then Clusters.

Select the cluster concerned to access its details.
From the Summary tab, click Launch Prism Element.

The management interface for your cluster, Prism Element, will then open.

Generating NCC checks

From the Prism Element interface, open the drop-down menu in the top left-hand corner, then click Health.

To the right of the window, click on Actions, then Run NCC checks.

In the window that appears, tick the boxes “All Checks” and “Send the cluster check report in the email” (only if you would like to receive the report by email), then click Run.

You can track the execution of the NCC verification tasks by clicking Tasks from the Prism Element interface drop-down menu, or by clicking the blue icon for the current tasks and then clicking View all tasks.

Once the verification is complete, click Succeeded in the "Status" column.

You can then download the NCC report in .txt format by clicking Download Output.

Once the report has been downloaded, you can then send it to our teams along with any elements already retrieved:

• AOS version
• Hypervisor type and version
• Node serial number

Receiving NCC report by email

To receive the NCC report by email, it is necessary to have pre-populated an SMTP server and at least one email address for notification of alerts and activity reports.

Adding an SMTP server

In the Prism Element interface, open the drop-down menu in the top left-hand corner and click Settings.

Scroll to the "Alerts and Notifications" submenu on the left and click SMTP Server.

Enter the configuration details for your SMTP server, then click Save.

Adding an email address

In the Prism Element interface, open the drop-down menu in the top left-hand corner and click Settings.

Scroll to the "Alerts and Notifications" submenu on the left and click Alert Email Configuration.

Check at least the "Every Single Alert" box to receive the NCC report. Enter a valid email address in the field, then click Save.

Collect all cluster logs

For more accurate analysis, it may be necessary to retrieve logs from nodes and Prism Central.

It is possible to collect logs from Prism Element but we recommend using the command line on the cluster or on Prism Central.

The log recovery tool (Logbay) is available on each CVM of a node and on Prism Central.

You can generate the logs and retrieve them via SSH.

Collect logs about Prism Central

Connect to the IP address of Prism Central via SSH with the ssh command on Linux, or with the Putty tool on Windows.

For example on Linux:

bash nutanix@prismcentralipaddress

Collect logs:

logbay collect 

Display the name of the generated file:

ls /home/nutanix/data/logbay/bundles

Then retrieve the logs collected in a .zip file.
To do this, make a copy of the files from a computer on Linux via the scp command, or on Windows with pscp:

scp nutanix@adresseipprismcentral:/home/nutanix/data/logbay/bundlesNTNX-Log-generatedfile.zip
nutanix@adresseipprismcentral's password:

Collect all node logs from Prism Element IP

Log in on the cluster’s IP address via SSH with the ssh command on Linux, or with the Putty tool on Windows.

For example on Linux:

bash nutanix@prismelementipaddress

Collect all node logs:

allssh logbay collect

Display the names of all generated files:

allssh ls /home/nutanix/data/logbay/bundles

Then retrieve the logs collected in .zip files.
To do this, copy each generated file onto each node:

scp nutanix@CVM1:/home/nutanix/data/logbay/bundlesNTNX-Log-generatednumber-PE-prismelementipaddress.zip
nutanix@CVM1's password:
scp nutanix@CVMN:/home/nutanix/data/logbay/bundlesNTNX-Log-numerodemande-PE-prismelementipaddress.zip
nutanix@CVMN's password:

Go further

Browse all the Nutanix guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about Nutanix on OVHcloud on the OVHcloud US website.

You can also use the resources mentioned in this guide:

• Putty
• Logbay Nutanix documentation