Installing the Access Server Web Application

The Cantara Access Server web application is distributed as a WAR file. WAR files for different Java application servers are available. The procedure to install a WAR file is different depending on the Java application server platform.

Deployment examples using Tomcat and WebLogic are provided 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
• Tomcat as a Window Service

1. Download the Access WAR file for Tomcat, from the Rinami Portal.

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

3. 

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

4. Ensure that the prerequisite JAR libraries are loaded into $CATALINA_HOME/lib
   
   • javax.mail.jar available at https://java.net/projects/javamail/pages/Home#Download_JavaMail_Release
   • xercesImpl.jar and xml-apis.jar are available at http://xerces.apache.org/mirrors.cgi
     
     
5. In the Tomcat /bin folder, locate the setenv file (Linux this will be setenv.sh and windows setenv.bat) and add a startup parameter defining the location of the Cantara Installation Component Folder:
   
      JAVA_OPTS="-Dcantara.access.home=/u01/rinami/cantara/access"
   
   
6. Start the Apache Tomcat instance. If the application 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:

• WebLogic WebApp Deployment

1. Copy the Oracle JDE EnterpriseOne Interoperability Libraries into the WebLogic WEB-INF folder.
2. Download the Access ZIP file for WebLogic, from the Rinami Portal.
3. Extract the ZIP file to your desired installation path and ensure that the service account running it has read write permission to that path.

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

5. Deploy the extracted Access web application as an application within WebLogic.
6. 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.
7. Verify configuration of the java property: "-Dcantara.access.home=/u01/rinami/cantara/access".
8. Start the WebLogic application. If the application fails to start, check the appropriate WebLogic logs for deployment errors.