SourceForge.net Logo  e-Commerce Portal Framework

First steps

Before going further, you need the sources of the e-Commerce Portal Framework. If you are a developer registered on the project and want the latest sources to work on it, you can take it from the CVS server located on SourceForge (Follow all steps provided on this link on how to do that). If you are an end-user of the ICM Portal Test Bed, simply download the latest version located on the following page http://sourceforge.net/projects/web-portal. Store the sources under the root directory, that is C:\web-portal if you are under Windows, or the directory you want under Linux (/usr/local/ is recomended if you want to ease installation process for some installation scripts are provided).

Once you are done, read the documentation that goes whith the package, under this page for windows or this page for linux. This documentation will help you to install the package. At some point, you will have to come back on this page to download additional software and libraries.


Additional software and libraries

The e-Commerce Portal Framework requires the installation of several components to run properly. The libraries and software are provided on this website for convenience, though you can easily download each of them for free on the official websites. However, the e-Commerce Portal Framework has only been tested with the libraries and software provided here, and newer versions are not assured to work properly (Some troubles have been experienced with newer version of SAX and DOM libraries). So you are srongly encouraged to download the versions provided on this page.

Download this archive to download the additional software and libraries. Unpack in a temporary directory and follow the instructions on this page.

Software

Javadoc for the JDK is provided but optional.

Windows

Install all of it in their default place, in the order it appears in the table below. Follow the installation instructions coming with each of them. Do not forget to set the JAVA_HOME variable (to the path where you installed Java) before installing Tomcat.

name need
j2sdk-1_3_1_06-windows-i586.exe required. To be installed under C:\Program Files\jdk1.3.1_06. Add C:\Program Files\jdk1.3.1_06\bin to the PATH environment variable. Add C:\Program Files\jdk1.3.1_06 to a newly created JAVA_HOME environment variable before installing Tomcat.
j2sdk-1_3_1-doc.zip optional (javadoc for j2sdk-1_3_1-doc.zip)
jakarta-tomcat-4.0.3.exe required. Keep default installation (C:\Program Files\Apache Tomcat 4.0).
mysql-3.23.55-win.zip required. Keep default installation (C:\mysql).

Linux

CVS should already be installed by default on your linux distribution. If not, do it from your installation CD or download the latest versions on the net.

Install Java and Tomcat provided below, in that order. Do not forget to set the JAVA_HOME variable (to the path where you installed Java) before installing Tomcat. Tomcat must be installed under /usr/local/ in order for the Web-Portal to work. Follow the installation instructions coming with each of them.

name need
j2sdk-1_3_1_09-linux-i586.bin required. Add path_to_java\bin to the PATH environment variable. Add path_to_java to a newly created JAVA_HOME environment variable before installing Tomcat.
j2sdk-1_3_1-doc.zip optional (javadoc for jdk 1.5.0)
jakarta-tomcat-4.0.3.tar.gz required
mysql-max-3.23.55-pc-linux-i686.tar.gz required. Follow instructions written in the INSTALL-BINARY text file placed at the root of the unpacked tar file.

Libraries

Before going further you must have installed all required software provided on this page in their default directories. It is also taken for granted that you uploaded the e-Commerce Portal Framework sources and saved it at the right path, as explained at the beginning of this documentation.

All the libraries needed are included in the archive you downloaded earlier. Open the lib directory and run the .bat (under windows) or .sh (under linux) file to copy these libraries in the right place where they need to be. The script requires that you already installed the software provided above in their default path.

Below is a table given just for information, to show where each library does come from, and what is its version. You don't need to download any of the files provided below. For each library is provided the package it comes from and its official website.

library package official website
jaxp-api.jar java_xml_pack-spring02-dev.zip http://java.sun.com/xml/downloads/javaxmlpack.html
xerces.jar deprecatedXerces-J-bin.2.0.1.zip http://xml.apache.org/dist/xerces-j
mail.jar javamail-1_3.zip http://java.sun.com/products/javamail/index.html
soap.jar soap-bin-2.2.zip http://xml.apache.org/dist/soap/version-2.2
xalan.jar java_xml_pack-spring02-dev.zip http://java.sun.com/xml/downloads/javaxmlpack.html
cos.jar cos-27May2002.zip http://www.servlets.com/cos/index.html
osworflow-2.1.0.jar osworkflow-2.1.0.zip http://sourceforge.net/project/showfiles.php?goup_id=9890
oscore-2.0.1.jar osworkflow-2.1.0.zip http://sourceforge.net/pr oject/showfiles.php?goup_id=9890
mysql-connector-java-2.0.14-bin.jar none http://dev.mysql.com/downloads/
jakarta-regexp-1.2.jar jakarta-regexp-1.2.tar http://www.apache.org/dist/jakarta/regexp/

Next steps

Please refer to the e-Commerce Portal Framework Programmer's Manual