Starting and stopping Petals ESB installed by Debian packages

Introduction

Once Petals ESB is installed through the Debian package, it can be started or stopped with two different ways:

  • at system level: the Petals ESB containers are running with a dedicated system user 'petals'. To use in production mode,
  • at user level: the Petals ESB containers are running as a process of the user that launches them. To use in a development mode.
Contributors
No contributors found for: authors on selected page(s)

Starting Petals ESB

Starting Petals ESB at system level

Automatic start

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

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

Two natures of containers are identified:

  • the "available containers" that are configured. These containers are to configure into the directory /etc/petals-esb/container-available. One sub-directory by container.
  • and, the "enable containers" that are automatically started. These containers are to configure into the directory /etc/petals-esb/container-enable. One sub-directory by container.

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

It's not possible to automatically start a container in debug mode. Use a manual startup.
Caution: The automatic startup starts all Petals ESB containers declared in the directory /etc/petals-esb/container-enable. So if you add a new Petals ESB container in this directory, and use the command "service petals-esb start", all other Petals ESB containers will be also started, and as they are already started, errors will occurs.

Manual start

A Petals ESB container configured at system level (its configuration is located in /etc/petals-esb/container-available, and uses sub-directories of /var/lib/petals-esb and /var/log/petals-esb) 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 container configured at user level, but using the system user 'petals' to be compliant with ACL of the filesystem:

sudo -u petals petals-esb -u <container-configuration>

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

For example, to launch the default sample container

sudo -u petals petals-esb -u file:///etc/petals-esb/container-available/default/server.properties
Caution: When manually starting a Petals ESB container, it will be automatically stopped when closing your shell. Don't use this way to start a Petals ESB container as a system service.

Starting Petals ESB at user level

Stopping Petals ESB

Stopping Petals ESB at system level

Stopping Petals ESB at user level

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.