Installing the Cantara Administration Console Web Application

The Cantara Administration Console web application is distributed as a WAR file for Tomcat and a ZIP file for WebLogic. The procedure to install the file is different depending on the Java application server platform.

Deployment examples using Tomcat and WebLogic are provided for reference below. Refer to the documentation for your chosen Java application server for further information about how to deploy an application.

Tomcat Java Application Server

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

• Configuration: context.xml
• Tomcat as Window Service

1. Copy your chosen Database Driver into $CATALINA_HOME/lib.
2. Download the Console WAR file from the Rinami Portal.

3. Copy the WAR file to the webapps folder of your web application server.
   For example:  cp console.war $CATALINA_HOME/webapps
   

   

   The folder destination for WAR files may be different on your system.

4. In the tomcat /bin folder locate the setenv file (on Linux this will be setenv.sh and on windows setenv.bat). Set a startup parameter for your web application server, defining the location of the Cantara Installation Component Folder.
   For example:  JAVA_OPTS="-Dcantara.console.home=/u01/rinami/cantara/console"
   
5. Start the Apache Tomcat instance. If the deployment fails to start, check the appropriate Tomcat logs for deployment errors.

Oracle WebLogic Java Application Server

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:

• WebApp Deployment

1. Copy the Oracle JDE EnterpriseOne Interoperability Libraries into the WebLogic WEB-INF folder.
2. Create the required Data Sources within your WebLogic instance for your chosen Database platform.
3. Download the Console ZIP file for WebLogic, from the Rinami Portal.
4. Extract the ZIP file to your desired installation path and ensure that the service account running it has read write permission to that path.

5. If you want to change the context root you can do so in the WEB-INF/weblogic.xml. The default context root is /console.

6. Deploy the extracted Console web application as an application within WebLogic.
7. We recommended you select the option "I will make the deployment accessible from the following location". Doing so will make the process of backing up or deploying updates simpler because the location of the installation is easy to maintain.
8. Verify configuration of the java property: "-Dcantara.console.home=/u01/rinami/cantara/console".
9. Start the WebLogic application. If the application fails to start, check the appropriate WebLogic logs for deployment errors.