node list
Displays information about or the history of the nodes in the HPC cluster.
For examples of how to use this command, see Examples.
Syntax
node list [/activeheadnode] [/format:{list|table}] [/group:<group_name>]
[/history[:{true|false}]] [/lastdays:<days>] [/scheduler:<name>]
[/state:<state>]
node list {/? | /help}
Parameters
| Parameter | Description |
|---|---|
| /activeheadnode | Lists the active head node. Returns the cluster name if the cluster head node is on premises; otherwise, returns the head node instance name if the head node is in Windows Azure. Note: This parameter was introduced in Microsoft HPC Pack 2008 R2 with Service Pack 4 and is not supported in previous versions. |
| /format:{list|table} | Specifies the format in which the command should display the information. The valid formats are list and table. The default format is table. |
| /group:<group_name> | Specifies the name of the node group that contains the nodes about which you want to view information. The /group parameter has no effect if you also specify the /history parameter. |
| /history[:{true|false}] | Specifies whether to display information about the history of all of the nodes in the HPC cluster. - A value of True indicates that the node list command should display information about the history of all of the nodes in the HPC cluster. - A value of False indicates that the node list command should display information about the nodes instead of the history of the nodes. If you specify the /history or /history:true parameter, the /group and /state parameters have no effect. The node list command displays this history of all of the nodes in the HPC cluster, regardless of the node groups to which the nodes belong or the current state of the nodes. When you specify the /history parameter without a value, the node list command behaves as if you specified a value of True. If you do not specify the /history parameter, the node list command behaves as if you specified a value of False. |
| /lastdays:<days> | Specifies the number of the most recent days for which the node list command should display the history of the nodes. The default value is 30. The /lastdays parameter has no effect if you do not specify the /history parameter or specify the /history:false parameter. |
| /scheduler:<name> | Specifies the host name or IP address of the head node for the cluster for which you want to view information about the nodes. The value must be a valid computer name or IP address. If you do not specify the /scheduler parameter, this command uses the scheduler on the head node that the CCP_SCHEDULER environment variable specifies. |
| /state:<state> | Specifies a list of one for more states for the nodes for which you want to view information. If you specify the /state parameter, the node list command only lists the nodes that are in the specified states. The valid states are Online, Offline, Draining, and Unreachable. |
| /? | Displays Help at the command prompt. |
| /help | Displays Help at the command prompt. |
Examples
To view a list of all nodes in the HPC cluster, use the following command:
node list
To view a list of all nodes in the node group named MyNodeGroup that are in the offline state, use the following command:
node list /group:MyNodeGroup /state:offline
To view the history for all of the nodes in the HPC cluster for the last 15
days, use the following command:
node list /history:true /lastdays:15