---
name: "ccs_test"
section: "8"
platform: "linux"
package: "cman"
version: "2.20081102-1+lenny1"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/ccs_test"
---

# ccs\_test(8)

CCS daemon (ccsd) diagnostic tool

## NAME

ccs\_test - CCS daemon (ccsd) diagnostic tool

## SYNOPSIS

**ccs\_test** \[**options**\] \<**command**\>

## DESCRIPTION

**ccs\_test** is part of the Cluster Configuration System (CCS).  It is a diagnostic tool that reads cluster.conf information to test ccsd.

## OPTIONS

- **-h**

  Help.  Print out the usage syntax and exit.

- **-V**

  Print the version information and exit.

## COMMANDS

- **connect** *\[force\]* *\[block\]* *\[cluster name\]*

  This command creates a connection to ccsd.  It returns a descriptor, which is used as an parameter to other commands.

  The 'force' key-word is used to establish a connection to ccsd in the absence of a quorate cluster manager.

  The 'block' key-word is used (with the 'force' key-word) to tell ccsd to keep broadcasting for a valid configuration file until one is found.

  The 'cluster name' is used (with the 'force' key-word) to specify that only configuration files containing the given cluster name are valid possibilities.

- **get** *\<desc\>* *\<request\>*

  Get the results of a given request.  The 'desc' is the number returned from the **connect** command.  The 'request' is a valid Xpath request.

  If 'request' results in multiple matches, the first will be returned. Subsequent calls with the same 'request' will result in the subsequent matches.  Once all the matches have been returned, a subsequent call will begin again with the first result.

- **get\_list** *\<desc\>* *\<request\>*

  Similar to the **get** command.  However, issuing subsequent calls with the same 'request' will result in all matches being returned (one at a time), then null, then starting over with the first result.

- **set** *\<desc\>* *\<path\>* *\<value\>*

  Sets a particular 'path' to the given 'value'.  Not yet implemented.

- **get\_state** *\<desc\>*

  Get the state associated with a given connection.

- **set\_state** *\<desc\>* *\<ncwp\>*

  Set the current working path (cwp) to 'ncwp' for a given connection.

## EXAMPLES

### To connect to ccsd:

\> ccs\_test connect

Connect successful.\
  Connection descriptor = 0

Or, if the cluster is not yet quorate and the name of the cluster is 'mycluster':

\> ccs\_test connect force block mycluster

Connect successful.\
  Connection descriptor = 0

### To get the cluster name from ccsd:

\> ccs\_test get 0 /cluster/@name

Get successful.\
  Value = \<mycluster\>

### To get the connection state:

\> ccs\_test get\_state 0

Get state successful.\
  Current working path:\
  Previous query      : /cluster/@name

### To set the connection state:

\> ccs\_test set\_state 0 /cluster

Set state successful.

### After setting the connection state, note the change:

\> ccs\_test get\_state 0

Get state successful.\
  Current working path: /cluster\
  Previous query      : /cluster/@name

### After setting the connection state, you can now query with an absolute or relative path:

\> ccs\_test get 0 @name

Get successful.\
  Value = \<brassow\>

\> ccs\_test get 0 /cluster/@name

Get successful.\
  Value = \<brassow\>

### To disconnect:

\> ccs\_test disconnect 0

Disconnect successful.

## SEE ALSO

[ccs(7)](/ccs/7.md), [ccsd(8)](/ccsd/8.md), [cluster.conf(5)](/cluster.conf/5.md)