Introduction

Starting Petals ESB Registry

Starting Petals ESB Registry at system level

Automatic startup

The Petals ESB Registry package comes with an automatic startup script based on System V (initd) to automatically launch Petals ESB Registry nodes as system services when the host boots.
To start the Petals ESB Registry nodes, for example, launch the following command on a Ubuntu box:

cdeneux@sph-latitude-D630:~$ sudo service petals-registry start

Two natures of cluster nodes are identified:

• the "available members" that are configured. These nodes are to configure into the directory /etc/petals-registry/member-available. One sub-directory by member node.
• and, the "enable members" that are automatically started. These nodes are to configure into the directory /etc/petals-registry/member-enable. One sub-directory by member node.

As "Enable members" are a subset of "Available members", we recommend to put the configuration of a node into a sub-directory of /etc/petals-registry/member-available, and create a symbolic link on this sub-directory into /etc/petals-registry/member-enable to "enable" it.

It's not possible to automatically start a Petals ESB Registry node in debug mode. Use a manual startup.

The automatic startup starts all Petals ESB Registry nodes declared in the directory /etc/petals-registry/member-enable. So if you add a new Petals ESB Registry node in this directory, and use the command "service petals-registry start", all other Petals ESB registry nodes will be also started, and as they are already started, errors will occurs.

Manual startup

A Petals ESB Registry node configured at system level (its configuration is located in /etc/petals-registry/member-available, and uses sub-directory /var/log/petals-registry) can be started using a manual startup, for example, to test its configuration. This startup is done using the same mechanism as a Petals ESB Registry node configured at user level, but using the system user 'petals' to be compliant with ACL of the filesystem:

sudo -u petals petals-registry -c <node-configuration>

where <node-configuration> is the URL of the Petals ESB Registry node configuration (ie, URL locating the file member.properties)

For example, to launch the default sample node

sudo -u petals petals-esb -u file:///etc/petals-registry/member-available/default/member.properties

Note 1: When manually starting a Petals ESB Registry node, it will be automatically stopped when closing your shell. Don't use this way to start a Petals ESB Registry node as a system service. Note 2: The command below uses the default JVM installed on your system. If it is not the right one, you can use a command line as following to specify the right JVM to use: sudo -u petals JAVA_HOME=${HOME}/jdk1.7.0_80 petals-registry -u file:///etc/petals-registry/member-available/default/member.properties

Starting Petals ESB Registry at user level

A Petals ESB Registry node configured at user level (its full configuration is located under the user's home directory) can be only started using a manual startup:

petals-registry -c <node-configuration>

where <node-configuration> is the URL of the Petals ESB Registry node configuration (ie, URL locating the file member.properties)

For example:

petals-registry -c file:///home/cdeneux/my-petals-esb-registry-node/demo1/member.properties

When manually starting a Petals ESB Registry node, it will be automatically stopped when closing your shell.

Stopping Petals ESB Registry

The process stopping a Petals ESB Registry node reads the contents of its local configuration file (ie. member.properties)to get the JMX credentials required to connect to the Petals ESB Registry node and invoke a shutdown. The security to block a shutdown is based on filesystem ACLs of the configuration files of the node. So, don't forget to set the right ACL on these files.

Example: "me:my-group rw-r-----" for your node to authorize you (me) and all member of the group my-group) to shutdown the Petals ESB Registry node.

Stopping Petals ESB Registry at system level

Automatic stop

To stop the Petals ESB Registry nodes started as system services uses the following command on a Ubuntu box, for example:

cdeneux@sph-latitude-D630:~$ sudo service petals-registry stop

The automatic stop stops all Petals ESB Registry nodes declared in the directory /etc/petals-registry/member-enable. So if you have removed a Petals ESB Registry node in this directory since the last automatic startup, it will not be stopped. Use a manual stop to stop it.

Manual stop

Manual stop of a Petals ESB Registry node automatically started

To stop a Petals ESB Registry node started as system service use the following command:

sudo -u petals petals-registry -c <node-configuration> stop

where <node-configuration> is the URL of the node configuration (ie, URL locating the file member.properties)

For example, to stop the default sample node

sudo -u petals petals-registry -c file:///etc/petals-registry/member-available/default/member.properties stop

Manual stop of a Petals ESB Registry node manually started

If you have manually started a Petals ESB Registry node at system level, just kill it with a Ctrl-C on its console, or use the following command from another shell:

sudo -u petals petals-registry -c <node-configuration> stop

where <node-configuration> is the URL of the node configuration (ie, URL locating the file member.properties)

For example, to stop the default sample node

sudo -u petals petals-registry -c file:///etc/petals-registry/member-available/default/member.properties stop

Stopping Petals ESB Registry at user level

To stop your Petals ESB Registry node, just kill it with a Ctrl-C on its console, or use the following command from another shell:

petals-registry -c <node-configuration> stop

where <node-configuration> is the URL of the node configuration (ie, URL locating the file member.properties)

For example

petals-registry -c file:///home/cdeneux/my-petals-esb-registry-nodes/demo1/member.properties stop

Reference guide of script 'petals-registry'

This reference guide is also available as "man" page installed with the Debian package 'petals-registry'.

Synopsis

petals-registry -c node-cfg-url [stop] [-e]
petals-registry -h
petals-registry -V

Description

petals-registry is used to start and stop manually a Petals ESB Registry node.

Options