Refer to the documentation of each add-on for additional installation and configuration information in conjunction with this documentation.
Each add-on bundle version is intended to run with a specific EBX® version and all its fix releases. Make sure that the EBX® and add-on bundle versions are compatible, otherwise the add-on registration will abort.
Copy the add-on common JAR file (named lib/ebx-addons.jar) in the EBX® class-path; it must be accessible from the ebx.jar class-loader.
Copy the add-on common WAR file (named wars/ebx-addons-common.war) in the same folder or EAR as EBX® built-in web applications.
If an add-on is used, copy the EBX® add-on WAR file (named wars/ebx-addons-<name>.war) in the same folder or EAR as EBX® built-in web applications.
See Web applications, Deployment details and Installation notes for more information.
The add-on log level can be managed in the main configuration file.
Registering an add-on makes its configuration available in the admin section. Add-on features are only available to end-users when the add-on is also activated.
To register a new EBX® add-on in the repository:
Navigate to the 'Administration' area.
Click the down-arrow in the navigation pane and select Technical configuration > Add-ons registration.
On the Registered add-ons page, click the + button to create a new entry.
Select the add-on you are registering.
Click on Save.
Unregistering an add-on will not delete any existing configuration, but will make it available in the UI until the add-on is registered again.
Activating an add-on makes its features available to the end-users. Only registered add-ons can be activated.
To activate an EBX® add-on in the repository:
Navigate to the 'Administration' area.
Click the down-arrow in the navigation pane and select Technical configuration > Add-ons registration.
Select the registered add-on you are activating and enable the 'Activation' field.
Click on Save.
To delete an add-on module from the EBX® repository:
Navigate to the 'Administration' area.
Click the down-arrow in the navigation pane and select Technical configuration > Add-ons registration.
On the Registered add-ons page, tick the box corresponding to the add-on to be deleted.
In the 'Actions' menu, select 'Delete'.
Close and purge the Administration datasets related to the previously used add-on, as well as the including dataspaces.
When an add-on is no longer deployed, a dataspace corresponding to the Administration dataset will then appear in the list of Reference children under the dataspaces. When an add-on module is no longer deployed, it is thus necessary to close/delete and purge manually all data/dataspaces related to the add-on.