OpenCCM - Comanche Module User's Guide

Comanche Module User's Guide

Starting the OpenCCM Comanche Server

The OpenCCM Comanche Server is a micro HTTP and a Multicast server allowing you to remotely access to the content of the OpenCCM Configuration Repository, e.g. the IOR of started OpenCCM services.

The comanche_start script starts the OpenCCM Comanche Server, e.g.:

$ comanche_start
The OpenCCM Comanche Server will be started.
Launching the OpenCCM Comanche Server.
The OpenCCM Comanche Server is waiting Multicast requests on mcast://224.0.0.100
The OpenCCM Comanche Server is waiting HTTP requests on http://host.domain:8080
The OpenCCM Comanche Server is started.
$

The comanche_start script supports the following options:

Option	Description
`--port port`	Set the TCP/IP port, default is `8080`.
`--group groupAddress`	Set the Multicast group address, default is `224.0.0.100`.

Then you could access to the IOR of the started OpenCCM services via URL or Multicast group address:

Service	URL
CosNaming	`http://host.domain:8080/NameService.IOR` `mcast://multicast_group_address/NameService.IOR`
CosTrading	`http://host.domain:8080/TradingService.IOR` `mcast://multicast_group_address/TradingService.IOR`
CosTransactions	`http://host.domain:8080/TransactionService.IOR` `mcast://multicast_group_address/TransactionService.IOR`
DCI Manager	`http://host.domain:8080/DCI.IOR` `mcast://multicast_group_address/DCI.IOR`

Let's note that this script automatically launches an OpenCCM Comanche Server process and stores its output and PID into the OpenCCM Configuration Repository, e.g.:

$ ls $OpenCCM_CONFIG_DIR
. . . Comanche.IOR Comanche.PID
$

Warning: Only one OpenCCM Comanche Server can be started for an OpenCCM Configuration Repository, e.g.:

$ comanche_start
Error: The OpenCCM Comanche Server is already started!
$

See the comanche_stop script to stop the started OpenCCM Comanche Server.

Stopping the OpenCCM Comanche Server

The comanche_stop script stops the previously started OpenCCM Comanche Server, e.g.:

$ comanche_stop
The OpenCCM Comanche Server will be stopped.
The OpenCCM Comanche Server is stopped.
$
$ comanche_stop
Error: The OpenCCM Comanche Server is not started!
$

Let's note that this script shutdowns the OpenCCM Comanche Server process and removes its output and PID files from the OpenCCM Configuration Repository.