IBM Books

Administration Guide

rconsole Command

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

  1. To open a remote console to one system, type:
    rconsole -n clsn02
     
     
    
  2. To open a remote console to a group of nodes defined in the CSM database as the node group clients, type:
    rconsole -N clients
     
     
    
  3. 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

Author

John Simpson - cluster@us.ibm.com


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]