PubMan:Environment Setup

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]

Get a Java SE Development Kit (JDK) 1.5.0_XX from http://java.sun.com/javase/downloads/index_jdk5.jsp and install it.
Add JAVA_HOME pointing to your JDK installation directory to your environment variables, e. g. C:\Programme\Java\jdk1.5.0_11

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:

Get the JEMS Installer 1.2.0.GA from http://labs.jboss.com/jemsinstaller/downloads/.
Start the installer with "java -jar jems-installer-1.2.0.GA.jar".
During installation choose "ejb3". Leave all other options as they are.

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]

Get an 8.1.XXX version of the PostgreSQL JDBC 2 driver from http://jdbc.postgresql.org/download.html and put it in the JBOSS_INSTALL_DIR/server/default/lib/ directory.

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]

- Get the pubman.ear file from the PubMan Project pages and deploy it to JBOSS_INSTALL_DIR/server/default/deploy/ directory
This file contains the PubMan application.
After deployment, the application is accessible at http://localhost:8080/pubman