Provided by:
ccs_1.20060222-0ubuntu5_i386 
NAME
ccs_tool - The tool used to make online updates of CCS config files.
SYNOPSIS
ccs_tool [OPTION].. <command>
DESCRIPTION
ccs_tool is part of the Cluster Configuration System (CCS). It is used
to make online updates of CCS config files. Additionally, it can be
used to upgrade old style (GFS <= 6.0) CCS archives to the new xml
format.
OPTIONS
-h Help. Print out the usage.
-V Print the version information.
COMMANDS
addfence [OPTION].. <name> <agent> [param=value]..
Add a new fencing agent to the cluster.
-c --configfile Name of configuration file
(/etc/cluster/cluster.conf).
-o --outputfile Name of output file (defaults to same as
--configfile).
-C --no_ccs Don’t tell CCSD about this change. (default: run
ccs_tool update if file is updated in place)
-F --force_ccs Force ccs_tool update even if input & output
files differ.
-h --help Display this help text for ccs_tool addfence.
Example:
ccs_tool addfence apc fence_apc ipaddr=apc.domain.net user=apc
password=apc
addnode [OPTION].. <nodename> [<fencearg>=<value>]..
Add a new node to the cluster.
-v --votes Number of votes for this node.
-n --nodeid Nodeid (optional)
-i --interface Interface name (needed if multicast is used)
-m --multicast Multicast address (only needed for first node in
a cman multicast cluster)
-f --fence_type Type of fencing to use
-c --configfile Name of configuration file
(/etc/cluster/cluster.conf).
-o --outputfile Name of output file (defaults to same as
--configfile).
-C --no_ccs Don’t tell CCSD about this change. (default: run
ccs_tool update if file is updated in place)
-F --force_ccs Force ccs_tool update even if input & output
files differ.
-h --help Display this help text for ccs_tool addnode.
Examples:
Add a new node to default configuration file:
ccs_tool addnode -v 1 -f manual ipaddr=newnode
Add a new node and dump config file to stdout rather than save
it
ccs_tool addnode -v 1 -f apc -i eth0 -o - newnode.temp.net
port=1
create [-2] <clustername>
-2 Create a 2-node cman cluster config file.
-c --configfile Name of configuration file
(/etc/cluster/cluster.conf).
-h --help Display this help text for ccs_tool create.
Note that create on its own will not create a valid
configuration file. Fence agents and nodes will need to be
added to it before handing it over to ccsd.
Example:
ccs_tool create MyCluster
ccs_tool addfence apc fence_apc ipaddr=apc.domain.net user=apc
password=apc
ccs_tool addnode node1 -v 1 -f apc port=1
ccs_tool addnode node2 -v 1 -f apc port=2
ccs_tool addnode node3 -v 1 -f apc port=3
ccs_tool addnode node4 -v 1 -f apc port=4
delfence [OPTION].. <fencename>
-c --configfile Name of configuration file
(/etc/cluster/cluster.conf).
-o --outputfile Name of output file (defaults to same as
--configfile).
-C --no_ccs Don’t tell CCSD about this change. (default: run
ccs_tool update if file is updated in place)
-F --force_ccs Force ccs_tool update even if input & output
files differ.
-h --help Display this help text for ccs_tool delfence.
delfence will allow you to remove a fence device that is in use
by nodes. This is to allow changes to be made, but be aware
that it may produce an invalid configuration file if you don’t
add it back in again.
delnode [OPTION].. <nodename>
-c --configfile Name of configuration file
(/etc/cluster/cluster.conf).
-o --outputfile Name of output file (defaults to same as
--configfile).
-C --no_ccs Don’t tell CCSD about this change. (default: run
ccs_tool update if file is updated in place)
-F --force_ccs Force ccs_tool upgdate even if input & output
files differ.
-h --help Display this help text for ccs_tool delnode.
help Prints the usage help. Same as ccs_tool -h.
lsfence [OPTION]..
-v --verbose Print all properties of the item.
-c --configfile Name of configuration file
(/etc/cluster/cluster.conf).
-h --help Display this help text for ccs_tool lsfence.
lsnode [OPTION]..
-v --verbose Print all properties of the item.
-c --configfile Name of configuration file
(/etc/cluster/cluster.conf).
-h --help Display this help text for ccs_tool lsnode.
update <xml file>
This command is used to update the config file that ccsd is
working with while the cluster is operational (i.e. online).
Run this on a single machine to update all instances of ccsd
across the cluster.
If you are using ’cman’ as your cluster manager, you will also
need to run cman_tool version -r <new version number> once the
update is complete. Failure to do so will result in new nodes
(or nodes rejoining after a failure) not being allowed to join
the working set due to version number mismatches.
upgrade <location>
This command is used to upgrade an old CCS format archive to the
new xml format. <location> is the location of the old archive,
which can be either a block device archive or a file archive.
The converted configuration will be printed to stdout.
SEE ALSO
ccs(7), ccsd(8), cluster.conf(5)
ccs_tool(8)