lsservicenodes

Edit online

Use the lsservicenodes command to display a list of all the nodes that can be serviced by using the service assistant CLI.

Syntax

Read syntax diagramSkip visual syntax diagram sainfo lsservicenodes

Parameters

None

Description

Nodes that are online_spare display as active nodes. No spare node extra fields are left blank.

This command displays a list of all the nodes that can be serviced by using the service assistant CLI. This list includes nodes that at a code level of at least 6.2.0, are visible on the fabric, and meet one of the following conditions:
  • The partner node in a control enclosure to the node that is running the command.
  • In the same clustered system as the node that is running the command.
  • In candidate state.
  • Not in a clustered system and in service state.
  • Not in an enclosure with a stored clustered system ID (which is not the clustered system ID of the local node).
Nodes that are not clustered with the local node are not shown unless they are the partner node. This table shows possible outputs.
Table 1. lsservicenodes outputs
Attribute Value
panel_name Indicates the front panel name, enclosure IDs, or canister IDs that identify the node.
cluster_id Indicates the system ID. The value is blank if node is a candidate; otherwise, the value is determined from vpd_cluster.
cluster_name Indicates the system name. The value is blank if node is a candidate; otherwise, the value is determined from vpd_cluster.
node_id Indicates the node ID. The value is blank if node is a candidate; otherwise, the value is determined from vpd_cluster.
node_name Indicates the node name. The value is blank if node is a candidate; otherwise, the value is determined from vpd_cluster.
relation Indicates the relationship. The values are:
  • local indicates that the node the CLI command was issued from.
  • partner indicates that the node is in the same enclosure as the local node.
  • cluster indicates that nodes other than the partner that is in the same system as the local node.
  • candidate indicates that the node is not part of the system.
node_status Indicates the node status. The values are:
  • active indicates that the node is part of a system and can perform I/O.
  • service indicates that the node is in service mode, standby mode, or node rescue mode.
  • candidate indicates that the node is not part of a system.
  • starting indicates that the node is part of a system and is attempting to join the system, and cannot perform I/O.
  • spare indicates that the node is a spare node.
error_data Indicates the outstanding error and error data that is indicated by priority.

An invocation example

sainfo lsservicenodes

The resulting output:

panel_name cluster_id       cluster_name        node_id node_name relation  node_status error_data
01-1       0000020073C0A0D4 Cluster_9.180.28.82 1       node1     local     Active
01-2       0000020073C0A0D4 Cluster_9.180.28.82 2       node2     partner   Active