Petals ESB "Autoloader"

compared with
Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (6)

View Page History
h1. Introduction

The Petals ESB "Autoloader" is an a *post*-extension providing (un)installation/(un)deployment service copying or removing files from the filesystem.

To install/deploy a JBI artifact, just copy the JBI archive into the installation/deployment directory, and remove the file associated to a JBI archive from the uninstallation/undeployment directory to uninstall/undeploy it.

Supoorted JBI artifact to be deployed are:
* shared libraries,
* components: binding components and service engines,
* service assemblies,
* deployable service units.

{column}
{column:width=35%}
+Note 1:+ If a JBI artifact is installed/deployed by another process, using the JMX API for example, the autoloader is notified and the associated JBI archive is put in the uninstallation/undeployment directory, so it will be possible to use the Petals ESB autoloader to uninstall/undeploy the JBI artifact.

+Note 2:+ A service assembly is automatically generated during the deployment process of a deployable service unit. So to undeploy such a service unit, you *MUST* undeploy the generated service assembly identified by:
* its JBI identifier defined as the service unit identifier,
* its filename defined as {{sa-<su-jbi-identifier>-<uid>.zip}}, where {{su-jbi-identifier}} is the service unit identifier and {{<uid>}} is an UID.

+Note 23:+ If Petals ESB was installed on a Debian-based operating system from Debian packages, the filesystem operations must be done with the right system user: {{petals}}
{code}
sudo -u petals cp /tmp/petals-bc-soap-4.3.0.zip /var/lib/petals-esb/sample0/install
If a JBI artifact is uninstalled/undeployed through the Petals ESB autoloader and has another JBI artifacts depending on it, they will be automatically uninstalled/undeployed.

+Note 34:+ If a JBI artifact is uninstalled/undeployed by another process, using the JMX API for example, the autoloader is notified and the associated JBI archive is automatically removed from the uninstallation/undeployment directory, without trigering another uninstallation/undeployment ;).

+Note 45:+ If Petals ESB was installed on a Debian-based operating system from Debian packages, the filesystem operations must be done with the right system user: {{petals}}
{code}
sudo -u petals rm /var/lib/petals-esb/sample0/installed/petals-bc-soap-4.3.0.zip