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 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)

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 "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

• 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

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

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>

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 postgres / postgres.

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 JBOSS_INSTALL_DIR/server/default/lib/ directory.

PubMan

pubman.properties

• 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

• 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

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

Open source Java EE-based application server

Java Development Kit

Publication Management

JavaServer Faces

Extensible Markup Language

Database Management System

Java Database Connectivity

Uniform Resource Locator

Enhanced Scientific Documentation

Enterprise Archive File Formate