{section}
{column}

h1. Introduction

The Petals ESB "Autoloader" is an 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 a JBI archive from the uninstallation/undeployment directory to uninstall/undeploy it.

{column}
{column:width=35%}
{panel:title=Table of contents}{toc:outline=true}{panel}
{panel:title=Contributors}{contributors:order=name|mode=list|showAnonymous=true|showCount=true|showLastTime=true}{panel}
{column}

This extension is also available as a Debian package, see "[Installing Petals ESB using the Debian packages]" to install the package "{{petals-esb-autoloader}}".

h1. Using the Petals ESB Autoloader

To install/deploy a JBI artifact, just put its associated archive in the installation/deployment directory (identified by the property {color:red}{{petals.autoloader.XXXXXX}}{color}. It will be automatically installed/deployed after a delay lower than the value of {{petals.autoloader.scan.period}}, and moved in the uninstallation/undeployment directory.

To uninstall/undeploy a JBI artifact, just remove its associated archive from the uninstallation/undeployment directory (identified by the property {color:red}{{petals.autoloader.XXXXXX}}{color}. It will be automatically installed/deployed after a delay lower than the value of {{petals.autoloader.scan.period}}.

+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.

+Note 2:+ 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 trigerring another uninstallation/undeployment ;).

h1. Configuration

Configuration parameters of the Petals ESB Autoloader are available into the container local configuration (ie. into the file {{server.properties}}:
|| Parameter/Property name || Default value || Description ||
| {{petals.autoloader}} | {{true}} | Flag enabling/disabling the autoloader |
| {{petals.autoloader.scan.period}} | {{4000}} | Delay, in milliseconds, between two directory scans |

{color:red}*TODO: directory*{color}