clush.conf - Man Page

Configuration parameters of the Main section are described below.

fanout

Size of the sliding window (fanout) of active commands for clush. This fanout is used to avoid too many concurrent connections and to conserve resources on the initiating hosts. In tree mode, the same fanout value is used on the head node and on each gateway (the fanout value is propagated). That is, if the fanout is 16 on the head node, each gateway will initate up to 16 connections to their target nodes at the same time.

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

clush can use NO_COLOR, CLICOLOR and CLICOLOR_FORCE environment variables. NO_COLOR takes precedence over CLICOLOR_FORCE which takes precedence over CLICOLOR. When the option is set in configuration file environment variables are taken into account only with auto argument. color tells  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)

maxrc

Should clush return the largest of command return codes? (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 ssh).

ssh_options

Set additional options to pass to the underlying ssh command.

scp_path

Set the scp binary path to use for remote copy (default is scp).

scp_options

Set additional options to pass to the underlying scp command. If not specified, ssh_options are used instead.

rsh_path

Set the rsh binary path to use for remote connection (default is rsh). You could easily use mrsh or krsh by simply changing this value.

rcp_path

Same a rsh_path for rcp command. (Default is rcp)

rsh_options

Set additional options to pass to the underlying rsh/rcp command.

[Main]
fanout: 128
connect_timeout: 15
command_timeout: 0
history_size: 100
color: auto
fd_max: 10240
maxrc: no
node_count: yes