Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

As of uPortal 2.5, uPortal requires the modern JAXP 1.3 XML libraries. Not coincidentally, these APIs are built right into JRE 1.5. uPortal 2.5 does not, however, require JRE 1.5, and is committed to also running under JRE 1.4.

This page aspires to explain exactly what you'll neeed to do to make uPortal 2.5 run under JRE 1.4.x.

Stepwise instructions

Acquire the JAXP 1.3 jars

Download the JAXP 1.3 api implementation jars distributed at Java.net for use in JRE 1.3 and JRE 1.4. uPortal 2.5 requires JRE 1.4 or later and so we aren't particularly concerned with how to make these APIs available in JRE 1.3.

Install those JAXP 1.3 jars in the /lib/endorsed/ directory of your JDK JRE

You'll need these .jars to be installed into the /jre/lib/endorsed/ directory of the JDK under which you will be running your ANT builds or otherwise compiling the uPortal source to build your local uPortal for deployment.

Into /jre/lib/endorsed/ go:

  • dom.jar
  • jaxp-api.jar
  • sax.jar
  • xalan.jar
  • xercesImpl.jar

If you're using Eclipse

More generally, you'll need to configure your IDE such that you can compile the project using these JAXP jars.

Here's the .classpath file I'm using locally:

.classpath
<?xml version="1.0" encoding="UTF-8"?>
<classpath>
	<classpathentry kind="src" path="source"/>
	<classpathentry kind="src" path="tests"/>
	<classpathentry kind="lib" path="lib/activation.jar"/>
	<classpathentry kind="lib" path="lib/commons-logging.jar"/>
	<classpathentry kind="lib" path="lib/cos.jar"/>
	<classpathentry kind="lib" path="lib/hsqldb.jar"/>
	<classpathentry kind="lib" path="lib/jakarta-oro-2.0.8.jar"/>
	<classpathentry kind="lib" path="lib/junit.jar"/>
	<classpathentry kind="lib" path="lib/log4j-1.2.8.jar"/>
	<classpathentry kind="lib" path="lib/portlet-api-1.0.jar"/>
	<classpathentry kind="lib" path="lib/proxyportlet.jar"/>
	<classpathentry kind="lib" path="lib/servlet.jar"/>
	<classpathentry kind="lib" path="lib/tyrex-1.0.1.jar"/>
	<classpathentry kind="lib" path="lib/wsrp4j-consumer-0.3.jar"/>
	<classpathentry kind="lib" path="lib/wsrp4j-shared-0.3.jar"/>
	<classpathentry kind="lib" path="lib/commons-collections-3.1.jar"/>
	<classpathentry kind="lib" path="lib/commons-dbcp-1.2.1.jar"/>
	<classpathentry kind="lib" path="lib/commons-pool-1.2.jar"/>
	<classpathentry kind="lib" path="lib/spring.jar"/>
	<classpathentry kind="lib" path="lib/pluto-1.0.1-rc1.jar"/>
<!-- I've inserted a linebreak in the following entry to make it look nice in the Wiki -- you need to
  remove the linebreak between internal. and debug.ui... -->
	<classpathentry kind="con"
path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.
debug.ui.launcher.StandardVMType/jaxp13_1_4_2_04"/>
	<classpathentry kind="lib" path="lib/tidy.jar"/>
	<classpathentry kind="output" path="bin"/>
</classpath>

Install those JAXP 1.3 jars in the /common/endorsed/ directory of your Tomcat.

Into your Tomcat's /common/endorsed/ directory go:

  • dom.jar
  • jaxp-api.jar
  • sax.jar
  • xalan.jar
  • xercesImpl.jar

What to do if these instructions are insufficient

It is expected that this dependency upgrade for uPortal 2.5 will create some support issues. The hope is that the value of upgrading to these new libraries will exceed the cost imposed on deployers of making the upgrade.

We can collaboratively improve this documentation by commenting upon this Wiki page and editing this page to present improved documentation of how to accomplish this upgrade.

So, if these instructions weren't good enough, please: bring it up on the discussion list, post comments here, edit this page to improve it.

  • No labels