Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

clush.conf(5) [debian man page]

CLUSH.CONF(5)						     ClusterShell User Manual						     CLUSH.CONF(5)

NAME
clush.conf - Configuration file for clush DESCRIPTION
clush(1) obtains configuration options from the following sources in the following order: 1. command-line options 2. user configuration file (~/.clush.conf) 3. system-wide configuration file (/etc/clustershell/clush.conf) For each parameter, the first obtained value will be used. The configuration file has a format in the style of RFC 822 composed of one main section: Main Program options definition [Main] Configuration parameters of the Main section are described below. fanout Size of the sliding window of ssh connectors. connect_timeout Timeout in seconds to allow a connection to establish. This parameter is passed to ssh. If set to 0, no timeout occurs. command_timeout Timeout in seconds to allow a command to complete since the connection has been established. This parameter is passed to ssh. In addition, the ClusterShell library ensures that any commands complete in less than ( connect_timeout + command_timeout ). If set to 0, no timeout occurs. color Whether to use ANSI colors to surround node or nodeset prefix/header with escape sequences to display them in color on the terminal. Valid arguments are never, always or auto (which use color if standard output/error refer to a terminal). Colors are set to [34m (blue foreground text) for stdout and [31m (red foreground text) for stderr, and cannot be modified. fd_max Maximum number of open file descriptors permitted per clush process (soft resource limit for open files). This limit can never exceed the system (hard) limit. The fd_max (soft) and system (hard) limits should be high enough to run clush, although their values depend on your fanout value. history_size Set the maximum number of history entries saved in the GNU readline history list. Negative values imply unlimited history file size. node_count Should clush display additional (node count) information in buffer header? (yes/no) verbosity Set the verbosity level: 0 (quiet), 1 (default), 2 (verbose) or more (debug). ssh_user Set the ssh user to use for remote connection (default is to not specify). ssh_path Set the ssh binary path to use for remote connection (default is /usr/bin/ssh). ssh_options Set additional options to pass to the underlying ssh command. EXAMPLES
Simple configuration file. clush.conf [Main] fanout: 128 connect_timeout: 15 command_timeout: 0 history_size: 100 color: auto fd_max: 10240 node_count: yes FILES
~/.clush.conf This is the per-user configuration file. /etc/clustershell/clush.conf System-wide configuration file. HISTORY
As of ClusterShell version 1.3, the External section has been removed from clush.conf. External commands whose outputs were used by clush (-a, -g, -X) are now handled by the library itself and defined in groups.conf(5). SEE ALSO
clush(1), nodeset(1), groups.conf(5) http://clustershell.sourceforge.net/ AUTHOR
Stephane Thiell, CEA DAM <stephane.thiell@cea.fr> COPYRIGHT
CeCILL-C V1 1.6 2012-02-15 CLUSH.CONF(5)

Check Out this Related Man Page

NODESET(1)						     ClusterShell User Manual							NODESET(1)

NAME
nodeset - compute advanced nodeset operations SYNOPSIS
nodeset [COMMAND] [OPTIONS] [nodeset1 [-ixX] nodeset2|...] DESCRIPTION
nodeset is an utility command provided with the ClusterShell library which implements some features of ClusterShell's NodeSet and RangeSet Python classes. It provides easy manipulation of indexed cluster nodes and node groups. It is automatically bound to the library node group resolution mechanism. Thus, nodeset is especially useful to enhance cluster aware administration shell scripts. OPTIONS
--version show program's version number and exit -h, --help show this help message and exit -s GROUPSOURCE, --groupsource=GROUPSOURCE optional groups.conf(5) group source to use Commands: -c, --count show number of nodes in nodeset(s) -e, --expand expand nodeset(s) to separate nodes (see also -S SEPARATOR) -f, --fold fold nodeset(s) (or separate nodes) into one nodeset -l, --list list node groups, list node groups and nodes (-ll) or list node groups, nodes and node count (-lll). When no argument is specified at all, this command will list all node group names found in selected group source (see also -s GROUPSOURCE). If any nodesets are specified as argument, this command will find node groups these nodes belongs to (individually). Option- ally for each group, the fraction of these nodes being member of the group may be displayed (with -ll), and also member count/total group node count (with -lll). If a single hyphen-minus (-) is given as a nodeset, it will be read from stan- dard input. -r, --regroup fold nodes using node groups (see -s GROUPSOURCE) --groupsources list all configured group sources (see groups.conf(5)) Operations: -x SUB_NODES, --exclude=SUB_NODES exclude specified nodeset -i AND_NODES, --intersection=AND_NODES calculate nodesets intersection -X XOR_NODES, --xor=XOR_NODES calculate symmetric difference between nodesets Options: -a, --all call external node groups support to display all nodes --autostep=AUTOSTEP auto step threshold number when folding nodesets, if not specified, auto step is disabled. Example: autostep=4, "node2 node4 node6" folds in node[2,4,6] but autostep=3, "node2 node4 node6" folds in node[2-6/2] -d, --debug output more messages for debugging purpose -q, --quiet be quiet, print essential output only -R, --rangeset switch to RangeSet instead of NodeSet. Useful when working on numerical cluster ranges, eg. 1,5,18-31 -G, --groupbase hide group source prefix (always @groupname) -S SEPARATOR, --separator=SEPARATOR separator string to use when expanding nodesets (default: ' ') -I SLICE_RANGESET, --slice=SLICE_RANGESET return sliced off result; examples of SLICE_RANGESET are "0" for simple index selection, or "1-9/2,16" for complex range- set selection --split=MAXSPLIT split result into a number of subsets --contiguous split result into contiguous subsets (ie. for nodeset, subsets will contain nodes with same pattern name and a contiguous range of indexes, like foobar[1-100]; for rangeset, subsets with consists in contiguous index ranges)""" For a short explanation of these options, see -h, --help. If a single hyphen-minus (-) is given as a nodeset, it will be read from standard input. EXTENDED PATTERNS
The nodeset command benefits from ClusterShell NodeSet basic arithmetic addition. This feature extends recognized string patterns by sup- porting operators matching all Operations seen previously. String patterns are read from left to right, by proceeding any character opera- tors accordinately. Supported character operators , indicates that the union of both left and right nodeset should be computed before continuing ! indicates the difference operation & indicates the intersection operation ^ indicates the symmetric difference (XOR) operation Care should be taken to escape these characters as needed when the shell does not interpret them literally. Examples of use of extended patterns $ nodeset -f node[0-7],node[8-10] node[0-10] $ nodeset -f node[0-10]!node[8-10] node[0-7] $ nodeset -f node[0-10]&node[5-13] node[5-10] $ nodeset -f node[0-10]^node[5-13] node[0-4,11-13] Example of advanced usage $ nodeset -f @gpu^@slurm:bigmem!@chassis[1-9/2] This computes a folded nodeset containing nodes found in group @gpu and @slurm:bigmem, but not in both, minus the nodes found in odd chassis groups from 1 to 9. EXIT STATUS
An exit status of zero indicates success of the nodeset command. A non-zero exit status indicates failure. EXAMPLES
Getting the node count $ nodeset -c node[0-7,32-159] 136 $ nodeset -c node[0-7,32-159] node[160-163] 140 $ nodeset -c @login 4 Folding nodesets $ nodeset -f node[0-7,32-159] node[160-163] node[0-7,32-163] $ echo node3 node6 node1 node2 node7 node5 | nodeset -f node[1-3,5-7] Expanding nodesets $ nodeset -e node[160-163] node160 node161 node162 node163 Excluding nodes from nodeset $ nodeset -f node[32-159] -x node33 node[32,34-159] Computing nodesets intersection $ nodeset -f node[32-159] -i node[0-7,20-21,32,156-159] node[32,156-159] Computing nodesets symmetric difference (xor) $ nodeset -f node[33-159] --xor node[32-33,156-159] node[32,34-155] Splitting nodes into several nodesets (expanding results) $ nodeset -e --split=3 node[1-9] node1 node2 node3 node4 node5 node6 node7 node8 node9 Splitting non-contiguous nodesets (folding results) $ nodeset -f --contiguous node2 node3 node4 node8 node9 node[2-4] node[8-9] HISTORY
Command syntax has been changed since nodeset command available with ClusterShell v1.1. Operations, like --intersection or -x, are now specified between nodesets in the command line. ClusterShell v1.1: $ nodeset -f -x node[3,5-6,9] node[1-9] node[1-2,4,7-8] ClusterShell v1.2+: $ nodeset -f node[1-9] -x node[3,5-6,9] node[1-2,4,7-8] SEE ALSO
clush(1), clubak(1), groups.conf(5). BUG REPORTS
Use the following URL to submit a bug report or feedback: https://github.com/cea-hpc/clustershell/issues AUTHOR
Stephane Thiell, CEA DAM <stephane.thiell@cea.fr> COPYRIGHT
CeCILL-C V1 1.6 2012-03-31 NODESET(1)
Man Page

Featured Tech Videos