PubMan:Environment Setup

From MPDLMediaWiki
Jump to navigation Jump to search

Outdated page

This page described the steps necessary to get the current PubMan distribution running on a local JBoss Application Server 4.0.5.GA.

Java 1.5[edit]

JBoss Application Server 4.0.5.GA (customized)[edit]

JBoss with EJB3 support[edit]

PubMan needs a JBoss AS 4.0.5.GA with EJB3 support. As the default distribution of JBoss 4.0.5.GA comes without EJB3 support, you need the JEMS Installer 1.2.0.GA:

Switch from MyFaces to Sun-JSF[edit]

  • Get Sun Java Studio Creator 2 Update 1 from and do a straightforward installation.
  • Copy the two files jstl.jar ans standard.jar from the CREATOR_INSTALL_DIR/enterprise1/config/TagLibraries/JSTL11/ to JBOSS_SERVER_DEPLOY_DIR/jbossweb-tomcat55.sar.
  • Remove the contents of the directory JBOSS_INSTALL_DIR/server/default/deploy/jbossweb-tomcat55.sar/jsf-libs/

Prevent the clash of XML APIs[edit]

To prevent errors like the following, remove the file JBOSS_INSTALL_DIR/lib/endorsed/xml-apis.jar. With Java 1.5, this file is dispensable, because it's already included in the JDK.

Caused by: java.rmi.MarshalException: Failed to communicate.
Problem during marshalling/unmarshalling; nested exception is: javax.xml.transform.TransformerException;
local class incompatible: stream classdesc serialVersionUID = 5899130644898226159,
local class serialVersionUID = 975798773772956428

Property configuration[edit]

In the file JBOSS_INSTALL_DIR/server/default/deploy/properties-service.xml following has to be added to the SystemPropertiesService MBean configuration:

<attribute name="Properties">



  • Get an 8.2.X version of the PostgreSQL DBMS from and install it. Please align the chosen superuser name and password in the file mentioned below. Its default settings are postgres / postgres.

Copy JDBC 2 driver to JBoss dir[edit]


  • Get the file from the eSciDoc Project pages and put it in the JBOSS_INSTALL_DIR/server/default/conf/ directory
  • The file contains amongst others following properties, which should be aligned as needed:
This property holds the URL to the eSciDoc Infrastructure installation PubMan will use.
These properties hold the superuser name and password for the PostgreSQL database required by PubMan.


  • Get the postgres-ds.xml file from the eSciDoc Project pages deploy it to JBOSS_INSTALL_DIR/server/default/deploy/ directory
  • This file contains a JDBC DataSource PubMan uses.