Context Navigation

By default, mpadmin commands affect objects that are in the current context--that is, objects that are in the same context in which the command is invoked. For example, if the command list is invoked in the Node context, mpadmin will list all the nodes in the cluster. If list is invoked in the Partition context, it will list all the partitions in the cluster, as shown below:

[node0]
Partition:: list           part0
           part1
           part2
[node0] Partition::

mpadmin provides several context navigation commands that enable you to operate on objects and attributes outside the current context.

current

Usage:

:: current object-name 

Available In:

Cluster, Node, Partition, Network

The current command changes the current context to the context of the object specified by object-name. The target object must exist. That is, if it is a partition, you must already have used the create command to create it. If the target object is a cluster, node, or network interface, it must have been created by the CRE.

The following example changes the current context from the general Node context to the context of a specific node, node1.

[node0]
Node:: current node1 
[node0] N(node1):: 

If the name of the target object does not conflict with an mpadmin command, you can omit the current command. This is illustrated by the following example, where node1 is the name of the target object.

[node0]
Node:: node1[node0] N(hpc-node1)::

This works even when the object is in a different context.

[node0]
Partition:: node1[node0] N(node1)::

The current command must be used when the name of the object is the same as an mpadmin command. For example, if you have a partition named Partition, its name conflicts with the command Partition. In this case, to make the object Partition the current context, you would need to include the current command to make it clear that the Partition term refers to the object and is not an invocation of the command.

Top

Usage:

:: top

Available In:

Node, Partition, Network

The top command moves you to the Cluster context. The following example moves from the Partition context to the Cluster context.

[node0]
Partition:: top[node0]:: 

up

Usage:

:: up

Available In:

Node, Partition, Network

The up command moves you up one level from the current context. The following example moves from the Network context to the context of node node2.

[node0]
N[node2] Network:: up[node0] N[node2]:: 

node

Usage:

:: node

Available In:

Cluster

The node command moves you from the Cluster context to the Node context.

[node0]:: node[node0] Node:: 

partition

Usage:

:: partition

Available In:

Cluster, Node, Network

The partition command moves you from the Cluster, Node, or Network context to the Partition context.

[node0]:: partition[node0] Partition:: 

network

Usage:

:: network

Available In:

Node

The network command moves you from a specific Node context to the Network context associated with that node.

[node0]
N[node2]:: network[node0] N[node2] Network::