Provided by: ccs_1.20060222-0ubuntu5_i386 bug

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)