ccs_test(8)
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.