| title | excerpt | updated |
|---|---|---|
Retrieving your Nutanix installation status information |
Find out how to retrieve essential information on the status of your Nutanix cluster |
2022-03-14 |
In order to optimise 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.
This guide explains how to retrieve essential information on the status of your Nutanix cluster.
- A Nutanix cluster in your OVHcloud account
- Login credentials and URL for Prism Central, received via email after the installation
We recommend that you retrieve all of the information detailed in this guide before contacting the OVHcloud support.
Log in to Prism Central, open the main menu in the top left-hand corner and click on Hardware{.action}, then Clusters{.action}.
{.thumbnail}
Click the List{.action} tab and note down the AOS version for the cluster concerned.
{.thumbnail}
Now open the main menu again and click on Hardware{.action} then Hosts{.action}.
Select a host from the list of hosts in your cluster.
{.thumbnail}
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.
{.thumbnail}
From the same host summary tab, note the Node Serial number.
{.thumbnail}
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{.action}, then Clusters{.action}.
{.thumbnail}
Select the cluster concerned to access its details.
From the Summary{.action} tab, click Launch Prism Element{.action}.
{.thumbnail}
The management interface for your cluster, Prism Element, will then open.
From the Prism Element interface, open the drop-down menu in the top left-hand corner, then click Health{.action}.
{.thumbnail}
To the right of the window, click on Actions{.action}, then Run NCC checks{.action}.
{.thumbnail}
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{.action}.
{.thumbnail}
You can track the execution of the NCC verification tasks by clicking Tasks{.action} from the Prism Element interface drop-down menu, or by clicking the blue icon for the current tasks and then clicking View all tasks{.action}.
{.thumbnail}
Once the verification is complete, click Succeeded{.action} in the "Status" column.
{.thumbnail}
You can then download the NCC report in .txt format by clicking Download output{.action}.
{.thumbnail}
Once the report has been downloaded, you can then send it to our teams along with any elements already retrieved:
[!primary] Use the Plik tool to upload your report and send it to us as a download link. You can find more information on using the Plik tool in this guide.
In order 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.
In the Prism Element interface, open the drop-down menu in the top left-hand corner and click Settings{.action}.
Scroll to the "Alerts and Notifications" submenu on the left and click SMTP Server{.action}.
{.thumbnail}
Enter the configuration details for your SMTP server, then click Save{.action}.
In the Prism Element interface, open the drop-down menu in the top left-hand corner and click Settings{.action}.
Scroll to the "Alerts and Notifications" submenu on the left and click Alert Email Configuration{.action}.
{.thumbnail}
Check at least the "Every Single Alert" box to receive the NCC report. Enter a valid email address in the field, then click Save{.action}.
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.
[!primary]
For more information about Logbay and Putty, see the Go further section of this guide.
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/bundlesThen 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: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 collectDisplay the names of all generated files:
allssh ls /home/nutanix/data/logbay/bundlesThen 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:[!primary] Use the Plik tool tool to upload your .zip files and send them to us as download links. You can find more information on using the Plik tool in this guide.
If you need training or technical assistance to implement our solutions, contact your sales representative or click on this link to get a quote and ask our Professional Services experts for assisting you on your specific use case of your project.
Join our community of users on https://community.ovh.com/en/.