Page Operations
Browse Space
Introduction
Starting from Penrose 1.1.3 you can embed Penrose Server inside Tomcat.
Tomcat Setup
The jmx.jar in TOMCAT_HOME/bin is old, replace it with the one in PENROSE_SERVER_HOME/lib.
Web Application Setup
To make Penrose available in your web application, copy all jar files from the following directories:
- PENROSE_SERVER_HOME/lib
- PENROSE_SERVER_HOME/lib/ext
- PENROSE_SERVER_HOME/server/lib
- PENROSE_SERVER_HOME/server/lib/ext
- PENROSE_SERVER_HOME/schema/ext
into the WEB-INF/lib directory. Exception: do not copy jbossall-client.jar.
Then copy PENROSE_SERVER_HOME/conf/log4j.xml into WEB-INF/classes.
Example
See the sample files in PENROSE_SERVER_HOME/samples/tomcat.
In this example, we have a servlet that will initialize Penrose Server:
public class DemoServlet extends GenericServlet { PenroseServer penroseServer; public void init(ServletConfig servletConfig) throws ServletException { super.init(servletConfig); try { String home = servletConfig.getInitParameter("penrose.home"); System.out.println("Starting Penrose Server at "+home+"..."); penroseServer = new PenroseServer(home); penroseServer.start(); System.out.println("Penrose Server started."); } catch (Exception e) { System.out.println("Failed starting Penrose Server: "+e.getMessage()); throw new ServletException(e); } } public void destroy() { try { System.out.println("Stopping Penrose Server..."); penroseServer.stop(); System.out.println("Penrose Server stopped."); } catch (Exception e) { System.out.println("Failed stopping Penrose Server: "+e.getMessage()); } } }
In the web.xml, the servlet is configured to start when the web application is started.
<web-app>
<servlet>
<servlet-name>DemoServlet</servlet-name>
<servlet-class>org.safehaus.penrose.example.tomcat.DemoServlet</servlet-class>
<init-param>
<param-name>penrose.home</param-name>
<param-value>${penrose.home}</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
</web-app>
Run "ant deploy" to deploy the web application into Tomcat.