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:
<?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"/> <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