10.36.6.3 Configuring Tomcat for PrologBeans

This section will briefly describe how to set up a Tomcat server so that is it possible to test the example JSPs. Some knowledge about how to run Tomcat and how to set up your own web application is required. Detailed information about Tomcat is available at http://jakarta.apache.org/tomcat/.

The following example has been tested with Tomcat 9 on Ubuntu 22.04. Please note: Tomcat 10 has changed incompatibly and will give an error in Java, “Unable to compile class for JSP” caused by the migration from javax.servlet to “Jakarta EE”. So, in order to use Prologbeans with Tomcat 10 you would probably need to modify prologbeans.jar.

Assuming that the environment variable CATALINA_BASE is set to the directory where Tomcat looks for its webapps/ folder, do the following:

1. Create the directory $CATALINA_BASE/webapps/PB_example
2. Copy the file pbexamples('sessionsum/sessionsum.jsp') to $CATALINA_BASE/webapps/PB_example/sessionsum.jsp
3. Create the directory $CATALINA_BASE/webapps/PB_example/WEB-INF/lib
4. Copy the file $SP_PATH/bin/prologbeans.jar to $CATALINA_BASE/webapps/PB_example/WEB-INF/lib/prologbeans.jar
5. Create the directory $CATALINA_BASE/webapps/PB_example/META-INF
6. Create the file $CATALINA_BASE/webapps/PB_example/META-INF/context.xml with the following content:

   <Context docBase="PB_example">
      <Resource name="prolog/PrologSession" auth="Container"
                type="se.sics.prologbeans.PrologSession"
                factory="org.apache.naming.factory.BeanFactory" />
   </Context>
   

7. Create the file $CATALINA_BASE/webapps/PB_example/WEB-INF/web.xml with the following content:

   <?xml version="1.0" encoding="ISO-8859-1"?>
   <!DOCTYPE web-app
        PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
       "http://java.sun.com/dtd/web-app_2_3.dtd">
   <web-app>
   
       <resource-env-ref>
         <description>
           Object factory for PrologSession instances.
         </description>
         <resource-env-ref-name>
           prolog/PrologSession
         </resource-env-ref-name>
         <resource-env-ref-type>
           se.sics.prologbeans.PrologSession
         </resource-env-ref-type>
       </resource-env-ref>
   
   </web-app>
   

8. Start SICStus, load sessionsum.pl and run main.
9. Start the Tomcat server.
10. In a web browser, enter http://localhost:8080/PB_example/sessionsum.jsp