ccs_tool - The tool used to make online updates of CCS config files.

ccs_tool [OPTION].. <command>

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.

-h

Help. Print out the usage.

-V

Print the version information.

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

-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

-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

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

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

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

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

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.

ccs(7), ccsd(8), cluster.conf(5)