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

 * 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  pointing to your JDK installation directory to your environment variables, e. g.

JBoss with EJB3 support
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 " ".
 * During installation choose "ejb3". Leave all other options as they are.

Switch from MyFaces to Sun-JSF

 * 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  to.
 * Remove the contents of the directory

Prevent the clash of XML APIs
To prevent errors like the following, remove the file. 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
In the file following has to be added to the SystemPropertiesService MBean configuration:  pubman.properties.file=./pubman.properties com.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0

Installation

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

Copy JDBC 2 driver to JBoss dir

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

pubman.properties

 * Get the pubman.properties file from the eSciDoc Project pages and put it in the  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

 * Get the postgres-ds.xml file from the eSciDoc Project pages deploy it to  directory
 * This file contains a JDBC DataSource PubMan uses.

pubman.ear

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