Skip to main content
Skip table of contents

JBoss EAP 7.0 - Cantara Server Installation

This documentation does not intend to document JBoss and It is assumed that anyone following the documentation contained on this page has experience working with JBoss.

Make sure you have done the following before deploying the Cantara Access Server:

Oracle Database Module

If you are using an Oracle database you must ensure that the Oracle JDBC Driver module is listed as a dependency in the jboss-deployment-structure.xml configuration file.


<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
            <module name="org.apache.logging.log4j" />
            <subsystem name="resteasy" />
            <subsystem name="jaxrs" />
            <subsystem name="webservices" />
            <subsystem name="logging"/>
        <local-last value="false" />
        <!-- enable Oracle database driver module -->
            <module name=""/>

To deploy an instance of the Cantara Server
  1. Log in to the JBoss EAP Server Administration Console.

  2. Go to the Depoyments tab and click Add.
  3. Select Create an unmanaged deployment and click Next.
  4. Enter the path to the extracted WAR archive along with the archive name.

    Change Context Root

    If you want to change the context root you can do so in the WEB-INF/jboss-web.xml located in the installation directory. The default context root is /cantara.

  5. Verify that this java property: "-Dcantara.worker.etc=/u01/rinami/cantara/access/etc" is configured.
  6. Click Finish, and the application should be deployed and enabled on your server.

  7. If the deployment is successful you will see the Cantara Access Server in the list of deployments with its state set to Enabled. If the deployment fails to start correctly, check the appropriate JBoss logs for deployment errors.

Validate Deployment

If you open a browser window to the base URL of the Cantara Access Server deployment you can confirm that the deployment has completed successfully.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.