Lenovo ThinkAgile HX Series knowledge base article landing page

Description

The Lenovo ThinkAgile HX Series combines Nutanix software with Lenovo’s highly reliable and scalable servers. Lenovo has created a series of documents and knowledge base articles to describe the diagnostic tests that you can perform, and troubleshooting procedures for the error messages and error codes. This landing page lists the relevant “How to” articles for Lenovo ThinkAgile HX Series diagnostic tools and troubleshooting information that is available to help you solve problems that might occur with the server.

Applicable Systems

ThinkAgile HX Series

Nutanix diagnostic tools

Diagnostic tool	Description
Syscheck utility	Syscheck is a tool that runs a load on a cluster and evaluates its performance characteristics. This tool provides pass or fail feedback on all the checks. The current checks are network throughput and direct disk random write performance. Syscheck tracks the tests on a per-node basis and prints the results at the conclusion of the test.
Nutanix Cluster Check (NCC)	Nutanix Cluster Check (NCC) is a framework of scripts that can help diagnose cluster health. NCC can be run provided that the individual nodes are up, regardless of the cluster state. NCC is used to gather both health checks and logs.
Diagnostics.py tool	This tool is useful in pre-sales demonstration of a cluster and while identifying the source of performance issues in a production cluster. Diagnostics should also be run as a part of the setup process to ensure a cluster is running properly before the customer takes ownership of it. You can use diagnostics.py from the shell of one of the Nutanix Controller VM.

Nutanix management tools

Management tool	Description
Prism central	Nutanix provides an option to monitor and manage multiple clusters through a single Web console. This multi-cluster view, known as Prism Central, is a centralized management tool that runs as a separate instance comprised of either a single VM or a set of VMs.
Nutanix command-line interface (nCLI)	The Nutanix command-line interface (nCLI) allows you to run system administration commands against the Nutanix cluster from any of the local machines (preferred) or any Controller VM in the cluster.

How to articles

Troubleshooting

Title	KB Article
How to use diagnostic tools to run performance tests on a cluster in ThinkAgile HX	HT510112
How to diagnose ThinkAgile HX Series hard drive issues	HT510046
How to troubleshoot drive issues in ThinkAgile HX using CVM commands	HT509525
How to troubleshoot PCI adapter issues in ThinkAgile HX using CVM commands	HT509546
How to clear ThinkAgile HX alerts using the Nutanix Controller VM CLI	HT510050
How to use the syscheck utility to evaluate cluster performance in ThinkAgile HX clusters	HT509897
How to troubleshoot faulty or missing memory issues on ThinkAgile HX Series systems	HT510087
How to enable or disable the Nutanix CVM maintenance mode for ThinkAgile HX	HT510918
How to enable or disable the Nutanix AHV host maintenance mode for ThinkAgile HX	HT511230
How to enable or disable the Nutanix ESXi host maintenance mode for ThinkAgile HX	HT511255
How to fix a Prism login issue when an “Account locked due to too many failed attempts” message is displayed on ThinkAgile HX systems	HT511228

Nutanix Cluster Check

Title	KB Article
How to create an account on the Nutanix support portal for the ThinkAgile HX	HT510181
How to find and download Nutanix Cluster Check files from the Nutanix support portal Web site for the ThinkAgile HX	HT510151
How to install Nutanix Cluster Check (NCC) from an installer file	HT510037
How to use Nutanix Cluster Check (NCC) to diagnose cluster health	HT509220
How to run the NCC health check and collect the output using the Nutanix Prism	HT509770
How to run the NCC health check and collect the output using the Nutanix CVM CLI	HT509634
How to collect Hyper-V logs using SSH to connect to a Controller VM in ThinkAgile HX systems	HT509985
How to use Nutanix Cluster Check to check whether the vmware-hostd service is running on the ESXi host	HT511754

Collecting logs

Title	KB Article
How to collect Hyper-V logs from a Nutanix Hyper-V host using PowerShell commands	HT510086

Shutting down or restarting a Controller VM

Title	KB Article
How to shut down and restart the Controller VM and AHV host in ThinkAgile HX	HT509629
How to shut down the Controller VM and ESXi host in ThinkAgile HX	HT509617
How to shut down the Controller VM and Hyper-V host in ThinkAgile HX	HT509596

VM disk management

Title	KB Article
How to resize Nutanix Virtual Machine disks for ThinkAgile HX systems	HT511857
How to insert or eject an ISO for a Nutanix virtual machine CDROM on ThinkAgile HX systems	HT512029
How to change the Nutanix VM disk bus type or disk index on ThinkAgile HX systems	HT511992
How to make and use an image for a Nutanix VM disk on ThinkAgile HX systems	HT511951
How to create a Phoenix ISO or AHV ISO from a Controller VM for the ThinkAgile HX Series	HT510419
How to create a Phoenix ISO from Foundation VM for the ThinkAgile HX Series	HT510443

Miscellaneous

Title	KB Article
How to find the machine type and serial number for ThinkAgile HX Series systems using Nutanix Prism	HT510300
How to find the machine type and serial number for ThinkAgile HX Series systems using Nutanix CLI	HT510406
How to set recommended UEFI settings for Lenovo ThinkAgile HX systems using Lenovo XClarity Essentials OneCLI	HT511216
How to create a Lenovo XClarity Essentials Bootable Media Creator image and update firmware for ThinkAgile HX systems	HT511359

Additional Information

Document ID:HT510142

Original Publish Date:03/20/2020

Last Modified Date:09/03/2024