Administration Guide
Name
rconsole - provides remote console support for Cluster Systems
Management (CSM) nodes.
Synopsis
rconsole [-a] [
[-h] [-t]
[-n
host[,host...]]
[-N
Node_group[,Node_group...]]
Description
The rconsole command provides remote console support for the
nodes in a cluster. The command uses the CSM database to determine the
nodes and their service processor information. The -a
option causes the rconsole command to display a console for each node
defined in the cluster. The -n and -N
options cause the command to display a console for each node defined by these
options. You can also define an environment variable RCONSOLE_LIST,
which is the name of a file that contains a list of nodes to manage.
The host names used must be the names specified when the nodes are defined in
the CSM database.
- Note:
- The -P and -B options are no longer
valid for this command.
The rconsole command provides an xterm window for each
node specified unless -t is specified. The font used
depends on the number of nodes specified:
- 1
- fixed
- 2 to 4
- 5x8
- greater than 4
- nil2
- Note:
- The nil2 font that is the default font when more that five systems
are specified is not intended to be readable. Rather, it is intended to
give a general idea of whether the node is up. Use RCONSOLE_FONT to
override this default if you intend to read the information provided on these
consoles.
Options
- -a
- Runs the command on all of the nodes in the cluster.
- -h
- Writes usage information to standard output.
- -n Host[,Host...]
- Specifies a list of nodes on which to run the command.
- -N
Node_group[,Node_group...]
- Specifies one or more node groups on which to run the command.
- -t
- Specifies text mode. Shows the contents of the remote console in
the current xterm session. This option is allowed only when
one node is specified.
Environment
- RCONSOLE_FONT
- Specifies the font to use for the remote console. This overrides
the default.
- RCONSOLE_LIST
- Specifies a file that contains a list of nodes, one host name per
line.
Exit Status
- 0
- Command has run successfully.
- 1
- Error occurred with one or more of the remote console commands.
Examples
- To open a remote console to one system, type:
rconsole -n clsn02
- To open a remote console to a group of nodes defined in the CSM database
as the node group clients, type:
rconsole -N clients
- To open consoles for a group of nodes with a specific font, type:
export RCONSOLE_FONT=fixed10; rconsole -n clsn02,clsn03
Files
- /opt/csm/bin/rconsole
- Location of the rconsole command.
See Also
- The espcfg, espdiag, esptty, and
lsnode man pages.
- IBM CSM for Linux: Hardware Planning and Control Guide.
Author
John Simpson - cluster@us.ibm.com
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]