PubMan:Environment Setup

From MPDLMediaWiki
Jump to: navigation, search

Outdated page

This page described the steps necessary to get the current PubMan distribution running on a local JBossOpen source Java EE-based application server Application Server 4.0.5.GA.

Java 1.5

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

JBossOpen source Java EE-based application server Application Server 4.0.5.GA (customized)

JBossOpen source Java EE-based application server with EJB3 support

PubManPublication Management needs a JBossOpen source Java EE-based application server AS 4.0.5.GA with EJB3 support. As the default distribution of JBossOpen source Java EE-based application server 4.0.5.GA comes without EJB3 support, you need the JEMS Installer 1.2.0.GA:

Switch from MyFaces to Sun-JSFJavaServer Faces

  • 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 XMLExtensible Markup Language 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 JDKJava Development Kit.

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>

PostgreSQL

Installation

  • Get an 8.2.X version of the PostgreSQL DBMSDatabase Management System 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 JDBCJava Database Connectivity 2 driver to JBossOpen source Java EE-based application server dir


PubManPublication Management

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 URLUniform Resource Locator to the eSciDocEnhanced Scientific Documentation Infrastructure installation PubManPublication Management will use.
db.superuser.login=postgres
db.superuser.password=postgres
These properties hold the superuser name and password for the PostgreSQL database required by PubManPublication Management.

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 JDBCJava Database Connectivity DataSource PubManPublication Management uses.

pubman.earEnterprise Archive File Formate

    • Get the pubman.earEnterprise Archive File Formate file from the PubMan Project pages and deploy it to JBOSS_INSTALL_DIR/server/default/deploy/ directory
  • This file contains the PubManPublication Management application.
  • After deployment, the application is accessible at http://localhost:8080/pubman