Miscellaneous Commands

connect

Usage:

:: connect cluster-name

Available In:

Cluster

In order to access any objects or attributes in a Sun HPC cluster, you must be connected to the cluster.

However, connecting to a cluster ordinarily happens automatically, so you are not likely to ever need to use the connect command.

The environment variable SUNHPC_CLUSTER names a default cluster. If no other action is taken to override this default, any mpadmin session will connect to the cluster named by this environment variable.

If you issue the mpadmin command on a node that is part of a cluster, you are automatically connected to that cluster, regardless of the SUNHPC_CLUSTER setting.

If you are not logged in to the cluster you want to use and you do not want to use the default cluster, you can use the mpadmin -s option, specifying the name of the cluster of interest as an argument to the option. See "-s cluster-name - Connect to Specified Cluster" for a description of the -s option.

When the CRE creates a cluster, it always names it after the hostname of the cluster's master node--that is, the node on which the master daemons are running. Therefore, whenever you need to specify the name of a cluster, use the hostname of the cluster's master node.

If, for some reason, you want to use the connect command, see the following example. It shows the command being used to connect to a cluster whose master node is node0.

[hpc-demo]:: connect node0[node0]::

echo

Usage:

:: echo text-message

Available In:

Cluster, Node, Partition, Network

The echo command prints the specified text on the standard output. If you write a script to be run with mpadmin -f, you can include the echo command in the script so that it will print status information as it executes.

[node0]:: echo Enabling part0 and part1Enabling part0 and part1
[node0]::

help

Usage:

:: help [command]

Available In:

Cluster, Node, Partition, Network

When invoked without a command argument, the help command lists the mpadmin commands that are available within the current context. The following example shows help being invoked at the Cluster level

[node0]:: helpconnect <cluster-name>			connect to
a Sun HPC cluster
set <attribute>[=value]			set an attribute in
the current context
unset <attribute>			delete an attribute in the current
context
show			show attributes in current context 
dump			show all objects on the cluster
node 			go to the node context
partition			go to the partition context
echo ...			print the rest of the line on standard output
quit			quit mpadmin
help [command]			show information about command command? [command]			show information about command command[node0]:: 

To get a description of a particular command, enter the command name as an argument to help.

If you specify a context command (node, partition, or network), mpadmin lists the commands available within that context. Note that you can specify network as an argument to help only at the node level.

[node0]:: help nodecurrent <node>			set the current node for future
commands
create <node>			create a new node with the given name
delete [node]			delete a node
list			list all the defined nodes
show [node]			show a node's attributes
dump [node]			show attributes for a node and its network
      
			interfaces
set <attribute>[=value]  	set the current
node's attribute
unset <attribute>			delete the current node's attribute
network			enter the network interface command mode
up			go up to the Cluster level command prompt
top			go up to the Cluster level command prompt
echo ...			print the rest of the line on standard output
help [command]			show information about command command? [command]			show information about command command[node0]:: 

The "?" character is a synonym for help.

quit/exit

Usage:

:: quit
:: exit

Available In:

Cluster, Node, Partition, Network

Entering either quit or exit causes mpadmin to terminate and return you to the shell level.

Example:

[node0]:: quit#

Example:

[node0]
N(node2):: exit#