PubMan:Environment Setup

From MPDLMediaWiki
Jump to navigation Jump to search

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 http://developers.sun.com/prodtech/javatools/jscreator/downloads/index.jsp 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:
java.io.InvalidClassException: 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">
  pubman.properties.file=./pubman.properties
  com.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0
</attribute>

PostgreSQL[edit]

Installation[edit]

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

Copy JDBC 2 driver to JBoss dir[edit]


PubMan[edit]

pubman.properties[edit]

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

postgres-ds.xml[edit]

  • 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.

pubman.ear[edit]