Commands Reference, Volume 3

mgmtsvr Command

Purpose

Displays or sets the management server entry for the managed node.

Syntax

mgmtsvr [-h] [-k] [-v | -V] [-N] [-n nodename] [host | -d]

Description

The mgmtsvr command runs on managed nodes to display or set the management server for the node.

Flags

-d

Deletes the management server entry.

-h

Writes the command's usage statement to standard output.

host

Specifies the host name or IP address of the CSM management server that will be managing this node. If no host is specified, and the -d flag is not specified, the current setting will be displayed. In this case, the exit status can be examined to distinguish between nodes and the management server.

-k

Exchanges RSCT public keys, host name, and node identifier between the node and the management server. Only use this flag if the host name, node identifier, or public key of either machines has changed. At the time this flag is used, you must trust your network to ensure that a rogue machine is not going to insert its public key in place of the public key of the real node.

-n nodename

Specifies the hostname known to the CSM management server for this node. This flag is used internally by the updatenode command to ensure correct operation when the hostname value on the node resolves to a different name than the name known to the management server. The default is /bin/hostname.

-N

Displays the value for the local node name and management server. This flag is only valid if a host name or IP address for the management server is not specified.

-v | -V

Writes the command's verbose messages to standard output.

Parameters

None.

Security

You must have root privilege to run this command.

Exit Status

0

This is a managed node only and the management server value is set

1

The combination of flags is not valid.

11

This is a managed node only and the management server value is not set.

21

This node is its own management server.

22

This node is also a management server for a separate cluster.

23

This machine is a CSM management server and a node, but the node does not currently have a management server set for it.

31

This machine is a CSM management server only.

101

This machine is neither a CSM management server or node.

Environment Variables

DSH_PATH

Sets the path that is used on the remote nodes. If DSH_PATH is not set, the default path for the remote shell is used. For example, DSH_PATH=$PATH sets the path on the remote node to the same path that is used on the source node.

DSH_REMOTE_CMD

Specifies the path of the remote shell executable to use instead of the default.

DSH_REMOTE_OPTS

Includes the options specified in the remote command when the command is forwarded to the remote nodes.

DSH_FANOUT

Sets the maximum number of concurrent remote shell commands. This can also be set by the -f flag.

DSH_LIST

Specifies a file that contains definitions of the set of nodes that comprise the node list.

DSH_TIMEOUT

Specifies the time, in seconds, to wait for response from the remote shell. This can also be set with the -t flag.

WCOLL

Specifies a file that contains definitions of the set of nodes that comprise the working collective.

Examples

To query the current CSM management server for this node, enter:

mgmtsvr

Files

See the output files in the Examples section.

Prerequisite Information

/var/log/csm/install.log

Location of the log output from the updatenode command.

Related Information

See the IBM CSM for AIX 5L: Administration Guide for information on editing the RMC ACL file.