Section: C3 User Manual (4)
Updated: 4.0
Index Return to Main Contents


cshutdown - A utility that runs shutdown on each cluster node.



Usage: cshutdown [OPTIONS] [MACHINE DEFINITIONS] t time [warning-message]  


cshutdown executes 'shutdown' with the given options and time on each cluster node.  


--help -h
:display help message

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

:interactive mode, ask once before executing

:execute command on head node does not execute on compute nodes if specified

:Use /etc/shutdown.allow.

-t sec
:Tell init(8) to wait sec seconds between sending processes the warning and the kill signal, before changing to another runlevel.

:Don't really shutdown; only send the warning messages to everybody.

:reboot after shutdown.

:Halt after shutdown.

:Skip fsck on reboot.

:Force fsck on reboot.

:Cancel an already running shutdown.

:reboot to specified lilo label

:execute command on all nodes in all clusters that are accessible. When specifying --head only the head nodes will participate. This ignores the [MACHINE_DEFINITIONS] section.


There are many ways to call cshutdown only a few examples are shown:

1. To shutdown the default cluster:

cshutdown -t 0

Shutsdown the nodes immediately

2. to reboot the cluster to another lilo label

cshutdown --onreboot w2k 0 rebooting to windows 2000 now!

This command tells lilo when it reboots to use the given label for the next reboot only. this is useful for things like the above example, to reboot to windows 2000

3. To shutdown several clusters

cshutdown -k cluster1: cluster2: -t 5 system going down for updates

This will tell shutdown to send the following message but not really shutdown. Most of the options to shutdown(8) will work in cshutdown


See the C3 INSTALL file for installation instructions. Also see C3-range for help on node ranges on the command line. If using the scalable setup please see c3-scale




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


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'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


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




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 format


cexec(1), c3(1), cget(1), ckill(1), cpush(1 ), cpushimage(4), crm(1), cshutdown(4), cname(1), cnum(1), clist(1), c3.conf(5), c3-scale(5)




SRT     C3 Home     Download     Documentation     Papers     Contacts     Related Research    

For user questions and information about releases, email/subscribe to: c3-users
For report bugs or problem, e-mail: c3-devel@ornl.gov

Computer Science and Math Division
Oak Ridge National Laboratory
Last Modified: Wed 04-23-2014