CLUSH(1) ClusterShell User Manual CLUSH(1) (NAME) clush - (SYNOPSIS) clush -a | -g group | -w nodes [OPTIONS] clush -a | -g group | -w nodes [OPTIONS] command clush -a | -g group | -w nodes [OPTIONS] --copy file | dir [ file | dir ...] [ --dest path ] clush -a | -g group | -w nodes [OPTIONS] --rcopy file | dir [ file | dir ...] [ --dest path ] (DESCRIPTION) clush () . clush . (front-end) ClusterShell . clush (worker) ClusterShell ssh(1) ( OpenSSH SSH) . (INVOCATION) clush command . clush clush command . (Non-interactive mode) clush command . -b --dshbak clush . -w NodeSet ClusterShell @group (Extended Patterns) NodeSet ( @Agroup\&@Bgroup) . EXTENDED PATTERNS nodeset(1) groups.conf(5) . --nostdin ( -n) clush ( isatty(3)). clush Enter . . --nostdin clush : # echo foo | clush -w node[40-42] -b cat --------------- node[40-42] --------------- foo <<>> . (Interactive session) command clush . clush readline . Readline Control-R . clush (nodeset - ) . : clush> ? clush> @ clush> + clush> - clush> !COMMAND COMMAND clush> = ( ) quit Control-D . ( --worker=exec -R exec ) clush exec . . %h %host %n %rank [0-N] ( % %% ). %hosts . ( --copy ) clush -c --copy / . --dest () . --dest clush . ( --rcopy ) clush --rcopy / . --dest . . (OPTIONS) --version clush -s GROUPSOURCE, --groupsource=GROUPSOURCE groups.conf(5) -n, --nostdin stdin clush ( ) . --groupsconf=FILE groups.conf(5) --conf=FILE clush.conf(5) -O , --option= key=value clush.conf(5) ( ) : -w NODES -x NODES -a, --all -g GROUP, --group=GROUP -X GROUP --hostfile=FILE, --machinefile=FILE ( ) --topology=FILE --pick=N N : -q, --quiet -v, --verbose -d, --debug -G, --groupbase ( @groupname) -L -b/-B clush -b/-B ( -bL) clush << >> ( ) -N -P, --progress -b, --dshbak dshbak (: ) -B -b -r, --regroup --axis=RANGESET n (nD) ( ) . n rangeset ( '1' '1-2' '1,3') . . fold_axis . -S, --maxrc --color=WHENCOLOR clush NO_COLOR CLICOLOR CLICOLOR_FORCE . NO_COLOR CLICOLOR_FORCE CLICOLOR . --color . --color ANSI / (escape) . WHENCOLOR never always auto ( / ). [34m ( ) [31m ( ) . --diff ( ) --outdir=OUTDIR stdout () --errdir=ERRDIR stderr () : -c, --copy --rcopy --dest=DEST_PATH (: ) -p () : -f FANOUT, --fanout=FANOUT FANOUT . fanout (head node) (gateway) ( fanout ). fanout 16 16 . fanout clush.conf(5) . -l USER, --user=USER -o OPTIONS, --options=OPTIONS ssh -o "-p 2022 -i ~/.ssh/myidrsa" ssh -t CONNECT_TIMEOUT, --connect_timeout=CONNECT_TIMEOUT -u COMMAND_TIMEOUT, --command_timeout=COMMAND_TIMEOUT -m MODE, --mode=MODE MODE /*.conf -R WORKER, --worker=WORKER (exec ssh rsh pdsh ) ssh --remote=REMOTE : 'yes' 'no' ( 'yes' ) -h, --help . (EXIT STATUS) clush . -S clush . -qS clush : clush: node[40-42]: exited with exit code 1 (EXAMPLES) # clush -w node[3-5,62] uname -r uname -r : node3 node4 node5 node62 # clush -w node[1-3] --worker=exec ping -c1 %host ping : node1 node2 node3. -R exec pdsh . # clush -w node[3-5,62] -b uname -r uname -r nodes[3-5,62] ( dshbak). # clush -w node[3-5,62] -bL uname -r : uname -r nodes[3-5,62] . # ssh node32 find /etc/yum.repos.d -type f | clush -w node[40-42] -b xargs ls -l node32 /etc/yum.repos.d clush node[40-42] -b . # clush -w node[3-5,62] --diff dmidecode -s bios-version nodes[3-5,62] ( ). # clush -w dc[1-2]n[1-2] --axis=1 -b uname -r dc[1-2]n1,dc[1-2]n2 dc[1-2]n[1-2] . fold_axis . # clush -a uname -r uname -r ( all:) groups.conf(5) . # clush -a -x node[5,7] uname -r uname -r node5 node7. # clush -a --diff cat /some/file cat /some/file ( ) . # clush -w @oss modprobe lustre modprobe lustre oss ( map:) groups.conf(5) . # clush -g oss modprobe lustre -g @ . # clush -w @mds,@oss modprobe lustre ( EXTENDED PATTERNS nodeset(1) groups.conf(5) ). # clush -w node[3-5,62] --copy /etc/motd /etc/motd node[3-5,62]. # clush -w node[3-5,62] --copy /etc/motd --dest /tmp/motd2 /etc/motd node[3-5,62] /tmp/motd2. # clush -w node[3-5,62] -c /usr/share/doc/clustershell /usr/share/doc/clustershell node[3-5,62]. # clush -w node[3-5,62] --rcopy /etc/motd --dest /tmp /etc/motd node[3-5,62] /tmp /tmp/motd.node3. (FILES) $CLUSTERSHELL_CFGDIR/clush.conf clush. $CLUSTERSHELL_CFGDIR /etc/clustershell/clush.conf . $XDG_CONFIG_HOME/clustershell/clush.conf clush. $XDG_CONFIG_HOME $HOME/.config/clustershell/clush.conf . {sys.prefix}/etc/clustershell/clush.conf ClusterShell . $HOME/.local/etc/clustershell/clush.conf clush ( pip --user) ~/.clush.conf clush ( . ). ~/.clush_history clush . (SEE ALSO) clubak(1), cluset(1), nodeset(1), readline(3), clush.conf(5), groups.conf(5). https://clustershell.readthedocs.io (BUG REPORTS) : https://github.com/clustershell/clustershell/issues (AUTHOR) Stephane Thiell (COPYRIGHT) (LGPL) . (LGPLv2.1+) 1.10.1 2026-07-16 CLUSH(1)