CNUM

NAME

cnum - A utility that returns a node index from the given cluster(s) and a name.

SYNOPSIS

Usage: cnum [OPTIONS] [MACHINE DEFINITIONS] node_name1 [node_name2 node_name3...]  

DESCRIPTION

cnum is a utility that returns a node index from the given cluster(s) and node name. Only one node name can be searched per invocation. The index returned is the index you would use in the node-range section of the command line. see c3-range(5) man page for more details on using node ranges  

OPTIONS

--help -h

:display help message

--file -f <filename>

:alternate cluster configuration file, if one is not supplied then /etc/c3.conf will be used

GENERAL

There is two ways to call cnum:

1. To search the default cluster:

cnum node2

This returns the node name and it's index

2. To to search any cluster in the configuration file

cnum cluster1: cluster2: node3

This returns the node name and it's index for each cluster in the list

SETUP

See the C3 INSTALL file for installation instructions. Also see C3-range for help on node ranges on the command line  

ENVIRONMENT

C3_RSH

By default, the C3 tools will use ssh to issue the remote commands. If you would like to have them use rsh instead, you must set the C3_RSH environment variable to rsh.

For example, if you are using the bash shell you would do the following:

export C3_RSH=rsh

any program that behaves like rsh or ssh is acceptable

C3_PATH

The default install path for C3 is /opt/c3-4. If you install C3 in an alternate location this variable must point to that installation. For remote clusters C3 must be installed in the same directory on each cluster.

For example, if you installed C3 in your home directory you might use the following:

export C3_PATH=/home/sgrundy/c3-4

C3_CONF

C3's default configuration file is /etc/c3.conf. If you wish an alternate default configuration file set this to point to the file

For example, if you keep a special c3.conf file in your home directory you may use:

export C3_CONF=/home/sgrundy/.c3conf

C3_USER

By default, the C3 tools will use your local username to access a remote cluster. If you wish to use a different default then set this variable to it

For example, this will change the example user from sgrundy to mmanhunter:

export C3_USER=mmanhunter

FILES

/etc/c3.conf

This file is the cluster configuration file that contains the names of the nodes to which commands will be sent. The cluster configuration file of nodes may also be specified from the command line. The format of both files is identical.

See the c3.conf(5) man page for the format

SEE ALSO

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

GENERAL

SETUP

ENVIRONMENT

FILES

SEE ALSO