Skip to main content
Outside service Partner
Hitachi Vantara Knowledge

Running diagnostics


You can run selected diagnostics on the nodes in an HCP system to help analyze and resolve issues related to interactions between the nodes and other components in the HCP environment. The available diagnostics let you:

Ping a specified device (ping)

Display the network path being used for communications between the node and a specified device (traceroute)

Query the DNS for the records that match a specified IP address or domain name (dig)

Display the routing table for the node (route)

Display the NFS exports table for a specified device (showmount)

On SAIN systems, display information about the logical volumes that are mapped to the node on the Fibre Channel SAN arrays (fchbainfo)

Display the ethtool command output command for both front-end interfaces (ethtool)

You run diagnostics from the system console for a node. To use the system console, you need a keyboard and monitor.

To run diagnostics, you use the Appliance Diagnostics menu. To display this menu in the system console, press Alt+F8.

ApplianceDiagnosticsMenu.png

To run diagnostics from the Appliance Diagnostics menu:

To execute a diagnostic command, enter the option number for that command. If the command requires an argument, HCP prompts you to enter a valid value for that argument. HCP then executes the command and displays the results on the screen.

To cancel a command before it finishes, press Ctrl+C.

If the information displayed in response to a command is longer than the space available on the screen, use Shift+PgUp and Shift+PgDn to scroll the display up or down, respectively.

To return to the Appliance Diagnostics menu after viewing the information displayed by a command, press Enter.

To clear the screen and redisplay the Appliance Diagnostics menu at the top, use option c from the menu.

To return to the console login prompt from the Appliance Diagnostics menu, press Alt+F1.

In addition to being displayed on screen, the results of each diagnostic command that you execute are sent to the syslog servers that you specify on the Syslog page in the HCP System Management Console. For information on specifying syslog servers, see Enabling syslog logging.

For more information on the diagnostic commands that you can execute from the Appliance Diagnostics menu, see the man pages for the commands on a Linux system.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

ping


The ping command pings a device that you identify by IP address or fully qualified domain name (FQDN). You might run this diagnostic, for example, to determine whether the node you’re on can communicate with a specific DNS server, external time server, or external storage device.

The ping command pings the specified device ten times, displaying the result of the ping each time. However, if the device is unreachable, the command displays only the summary of the ping attempts after the ten tries.

To execute the ping command:

1.From the Appliance Diagnostics menu, enter 1.

A prompt for an IP address or FQDN appears.

PingPrompt.png

2.Enter the target device IP address or FQDN.

The results of the ping command are displayed on the screen.

3.After viewing the display, press Enter to return to the Appliance Diagnostics menu.

Here’s a sample response to the ping command:

PingResponse.png

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

traceroute


The traceroute command displays the network path through which the node you’re on communicates with a device that you identify by IP address or FQDN. You might run this diagnostic, for example, if communication between the node and another device, such as a DNS server, is taking longer than expected.

For each pair of points in the network path, the traceroute command displays the round-trip time between the two points for each of three probes. You can use this information, for example, to determine whether the network topology is configured correctly.

To execute the traceroute command:

1.From the Appliance Diagnostics menu, enter 2.

A prompt for an IP address or FQDN appears.

TraceroutePrompt.png

2.Enter the target device IP address or FQDN.

The results of the traceroute command are displayed on the screen.

3.After viewing the display, press Enter to return to the Appliance Diagnostics menu.

Here’s a sample response to the traceroute command:

TracerouteResponse.png

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

dig


The dig command queries the DNS for records that match an IP address or FQDN that you specify. You might run this diagnostic with an HCP domain name, for example, if you have user-defined networks that are not working as expected.

When you execute the dig command, you are prompted for arguments. Although you can specify any dig command arguments, this document describes only IP addresses and FQDNs.

To execute the dig command:

1.From the Appliance Diagnostics menu, enter 3.

A prompt for dig command arguments appears.

DigPrompt.png

2.Enter one of these arguments:

o-x followed by an IP address (for example, -x 172.20.33.40)

oAn FQDN

3.In response to the confirming prompt, enter y to confirm your entry or n to try again.

When you enter y, the results of the dig command are displayed on the screen.

4.After viewing the display, press Enter to return to the Appliance Diagnostics menu.

Here’s a sample response to the dig command with the argument hcp.example.com:

DigResponse.png

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

route


The route command displays the routing table for the node you’re on. This table shows the subnets that the node belongs to. The information for each subnet includes the subnet mask and the network interface. For the [hcp_system] network (shown as default) and the network used for replication, the subnet information also includes the network gateway IP address.

This diagnostic is useful, for example, for exposing network connectivity problems such as missing interfaces. If you’ve created multiple networks in HCP, the display from the route command should show the subnet and interface for each network for which the node has an IP address.

To execute the route command:

1.From the Appliance Diagnostics menu, enter 4.

The results of the route command are displayed on the screen.

2.After viewing the display, press Enter to return to the Appliance Diagnostics menu.

Here’s a sample response to the route command:

RouteResponse.png

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

showmount


The showmount command displays the NFS exports table for a device that you identify by IP address or FQDN or for the node you’re on. You might run this diagnostic, for example, to check whether shares associated with external storage volumes are properly exported on the external storage device.

Each line in the exports table shows a path that can be mounted by other devices. For an HCP node, the exports table includes the paths to namespaces for which the NFS protocol is enabled.

To execute the showmount command:

1.From the Appliance Diagnostics menu, enter 5.

A prompt for an IP address or FQDN appears.

ShowmountPrompt.png

2.Enter the target device IP address or FQDN. For the FQDN of the node you’re on, use localhost.

The results of the showmount command are displayed on the screen.

3.After viewing the display, press Enter to return to the Appliance Diagnostics menu.

Here’s a sample response to the showmount command:

ShowmountResponse.png

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

fchbainfo


For SAIN systems only, the fchbainfo command displays information about the logical volumes that are mapped the node you’re on for all the Fibre Channel SAN arrays to which the node is connected. You might run this command, for example, to diagnose issues with zero-copy failover.

The information displayed by the fchbainfo command is broken out by HBA port. For each logical volume that maps to the port, the display includes the volume number and size.

To execute the fchbainfo command:

1.From the Appliance Diagnostics menu, enter 6.

The results of the fchbainfo command are displayed on the screen.

2.After viewing the display, press Enter to return to the Appliance Diagnostics menu.

Here’s a sample response to the fchbainfo command:

FchbainfoResponse.png

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Ethtool


The ethtool command displays information about the NIC parameters and device drivers for both front-end interfaces. You might run this command, for example, to diagnose issues with 10 gigabyte Ethernet network configurations.

To execute the ethtool command:

1.From the Appliance Diagnostics menu, enter 6.

The results of the ethtool command are displayed on the screen.

2.After viewing the display, press Enter to return to the Appliance Diagnostics menu.

 

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.