Difference between revisions of "PubMan:Environment Setup"
Jump to navigation
Jump to search
(New page: This page described the steps necessary to get the [http://www.escidoc-project.de/JSPWiki/Wiki.jsp?page=Download current PubMan distribution] running on a local JBoss Application Server 4....) |
|||
Line 2: | Line 2: | ||
== Java 1.5 == | == Java 1.5 == | ||
*Get a Java SE Development Kit (JDK) 1.5.0_XX from [http://java.sun.com/javase/downloads/index_jdk5.jsp http://java.sun.com/javase/downloads/index_jdk5.jsp] and install it. | |||
*Add <code>JAVA_HOME</code> pointing to your JDK installation directory to your environment variables, e. g. <code>C:\Programme\Java\jdk1.5.0_11</code> | |||
== JBoss Application Server 4.0.5.GA (customized) == | == JBoss Application Server 4.0.5.GA (customized) == | ||
Line 16: | Line 18: | ||
* Remove the contents of the directory <code>JBOSS_INSTALL_DIR/server/default/deploy/jbossweb-tomcat55.sar/jsf-libs/</code> | * Remove the contents of the directory <code>JBOSS_INSTALL_DIR/server/default/deploy/jbossweb-tomcat55.sar/jsf-libs/</code> | ||
=== Prevent the clash of XML | === Prevent the clash of XML APIs === | ||
To prevent errors like the following, remove the file <code>JBOSS_INSTALL_DIR/lib/endorsed/xml-apis.jar</code>. With Java 1.5, this file is dispensable, because it's already included in the JDK. | To prevent errors like the following, remove the file <code>JBOSS_INSTALL_DIR/lib/endorsed/xml-apis.jar</code>. With Java 1.5, this file is dispensable, because it's already included in the JDK. | ||
Caused by: java.rmi.MarshalException: Failed to communicate. | Caused by: java.rmi.MarshalException: Failed to communicate. | ||
Line 34: | Line 36: | ||
== PostgreSQL == | == PostgreSQL == | ||
== Installation == | == Installation == | ||
*Get an 8.2.X version of the ''PostgreSQL DBMS'' from [http://www.postgresql.org/ http://www.postgresql.org/] and install it. Please | *Get an 8.2.X version of the ''PostgreSQL DBMS'' from [http://www.postgresql.org/ 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 <code>postgres / postgres</code>. | ||
== Copy JDBC 2 driver to JBoss dir == | == Copy JDBC 2 driver to JBoss dir == | ||
Line 42: | Line 44: | ||
== PubMan == | == PubMan == | ||
=== pubman.properties === | === pubman.properties === | ||
*Get the ''pubman.properties'' file from [http://www.escidoc-project.de/JSPWiki/Wiki.jsp?page=Download the eSciDoc Project pages] and put it in the <code>JBOSS_INSTALL_DIR/server/default/'''conf'''/</code> 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 [http://www.escidoc-project.de/JSPWiki/Wiki.jsp?page=Download the eSciDoc Project pages] deploy it to <code>JBOSS_INSTALL_DIR/server/default/'''deploy'''/</code> directory | |||
* This file contains a JDBC DataSource PubMan uses. | |||
=== pubman.ear === | === pubman.ear === | ||
**Get the ''pubman.ear'' file from [http://www.escidoc-project.de/JSPWiki/Wiki.jsp?page=Download the eSciDoc Project pages] and deploy it to <code>JBOSS_INSTALL_DIR/server/default/'''deploy'''/</code> directory | |||
*This file contains the PubMan application. | |||
*After deployment, the application is accessible at [http://localhost:8080/pubman http://localhost:8080/pubman] | |||
[[Category:PubMan]] | [[Category:PubMan]] |
Revision as of 18:35, 18 December 2007
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/
toJBOSS_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 eSciDoc Project pages and deploy it to
JBOSS_INSTALL_DIR/server/default/deploy/
directory
- Get the pubman.ear file from the eSciDoc Project pages and deploy it to
- This file contains the PubMan application.
- After deployment, the application is accessible at http://localhost:8080/pubman