Control panel for the state and boot managers. Provides a very simple GUI that can be used to control the state manager and run it through it states via allowed transitions.
See OPTIONS below for the command line options. Just a note first about how cpanel locates the state manager with which it will interact.
If the --state_uri and --transition-uri
are both defined, they are used as the URI's for the state/transition
publication port and the transition request port respectively.
If the above conditions are not satisified,
and the --host, --state-service
and --transition-service options are all
defined, the port manager is used to obtain the ports so that
the appropriate URI's can be constructed.
If the previous condition is not satisfied, cpanel will attempt to obtain the values of the environment variables: TRANSITION_SUBSCRIPTION_URI and TRANSITION_REQUEST_URI and use them as the state/transtion publication and transition request port URI's respectively. Note that if cpanel is run from the boot manager, the boot manager will have defined these environment variables. Note as well, that at least one control panel must not be run from the boot manager because the system has to be booted somehow.
If the previous condition is not satisfied, cpanel will attempt to connect to the user's state manager in localhost using the state manager's default service names to look up the ports needed.
--help, -hOutputs some help text that describes how to run the program. The program then exits without doing anything else.
--version, -v
Outputs the program version and then exits without doing
anything else. Note that if --help
is present on the command line, that takes
precedence.
--state-uri, -s
The value of this option is a URI that specifies the
host/port on which the state manager is broadcasting
state and transition updates. Note that this
must be used in conjunction
with the --transition-uri option
or this option will be ignored.
URI's are of the form:
tcp://hostname:portnum
For example:
--state-uri=tcp://localhost:1234
--transition-uri, -t
The value of this option is the URI that specifies the
host/port
on which the state manager
is accepting state transition requests. Note that this
must be used in conjunction
with the --state-uri option
or this option will be ignored.
See the --state-uri above for information
about the structure of URI's.
--host, -n
The value of this option is the host in which the
state manager is running.
The value of this option is used along with the
--state-service and
--transition-service options to
interact with the port manager to determine the
URIs to use to connect to the state manager. These
are only used if --state-uri
and --transition-uri are
not present on the command line.
--state-service, -S
This value supplies the name of the service the
state manager advertises for state/transition publication.
Used along with --host and
--transition-service options to
interact with the port manager to determine the
URIs to use to connect to the state manager. These
are only used if --state-uri
and --transition-uri are
not present on the command line.
--transitino-service, -T
The value of this option supplies the name
of the sevice the state manager is advertising on
which state transition requests will be accepted.
Used along with the --host
and --state-service options to
interact with the port manager to determine the
URIs to use to connect to the state manager. These
are only used if --state-uri
and --transition-uri are
not present on the command line.