Skip to main content

Oracle WebLogic 12.1.3 / 12.2.1 - Cantara Assur Server Installation

This documentation does not intend to document WebLogic and It is assumed that anyone following the documentation contained on this page has experience working with WebLogic. However, you can refresh your WebLogic knowledge by reading below link:

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

Mail Session Resource

If you wish to override the default JNDI name for the mail resource, which is mail/Cantara then you must update the weblogic.xml file with the assigned resource name.

weblogic.xml

XML
<?xml version="1.0" encoding="UTF-8"?>
<weblogic-web-app 
    xmlns="http://xmlns.oracle.com/weblogic/weblogic-web-app" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd
                        http://xmlns.oracle.com/weblogic/weblogic-web-app http://xmlns.oracle.com/weblogic/weblogic-web-app/1.2/weblogic-web-app.xsd">
  ....
  <resource-description>
    <res-ref-name>mail/Cantara</res-ref-name>
    <jndi-name>mail/Cantara</jndi-name>
  </resource-description>
</weblogic-web-app>


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

    Make sure the Oracle WebLogic Server Instance that you are deploying to is not running during the deployment.

  2. Go to the Change Center and click Lock & Edit.
  3. In the left pane of the Console, select Deployments.
  4. In the right pane, click Install.
  5. Browse to the Cantara Assur Server application install path as shown in the following image:

    Change Context Root

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

  6. Accept the default for the Install this deployment as an application option, and click Next.
  7. Select the WebLogic Server instance you want to deploy to, and click Next.

  8. We recommended you select the I will make the deployment accessible from the following location option. Doing so will make the process of backing up or deploying updates simpler because the location of the installation is easy to maintain.
  9. Verify that this java property: "-Dcantara.assur.etc=/u01/rinami/cantara/assur/etc" is configured.
  10. Click Finish, and then click Activate changes located at the top left of the console.

  11. If the deployment is successful you will see the Cantara Access Server in the list of deployments with its state set to New.
  12. You can now start the WebLogic Server instance. Once the server instance starts, the deployment state will change to Prepared.
  13. Select the deployment and click on the Start -> Servicing all requests option.
  14. The state of the deployment should now change to Active. If the deployment fails to start correctly, check the appropriate WebLogic logs for deployment errors.

Validate Deployment

If you open a browser window to the base URL of the Cantara Assur 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.