ExperSHOP - Quick Start instructions


Home Contents

Please email any bug reports, comments or suggestions to ExperLog's Online Support


Prerequisite

  • A java environment that supports java servlets (JDK 1.3+).
  • A web server that supports servlets, like Tomcat, Enhydra, or any commercial one like Weblogic or Websphere.
The sample shop comes with a demo database, there's an Hsql DB engine coming with ExperSHOP for demo purposes.

Installation as a web application

This chapter applies to servlet engines that support Web Applications Archive deployment (.war files).
Any server that supports at least the Servlets 2.2 specification (like, for example, Tomcat) should support .war deployment.
If your servlet engine DOES NOT support .war files, please skip to the next chapter.

To deploy ExperSHOP as a Web Application:

  • Download the expershop.war file on ExperLog's web site ("ExperShop Web Application Package" in the download section).
  • On Windows, this file may appear as "expershop.war.zip": if so, rename it "expershop.war".
  • Deploy the ExperShop Web Application, as specified in your servlet engine documentation about .war files deployment. (For example, on Tomcat, copy the expershop.war file in the "webapps" directory; other servlet engines may require that you use administration tools, or update configuration files - if so, refer to the relevant documentation).
  • Restart your servlet engine.
More detailed instructions can be found here, concerning specific installation on Tomcat 3.3 or 4.x or Enhydra 5.

To check if everything works, contact the expershop sample application with your web browser.

The URL looks like:
http://host[:port]/expershop
or (direct access to the servlet):
http://host[:port]/expershop/com.expershop.lite.ExperSHOP
For example, with a default installation of Tomcat on the local host:
http://localhost:8080/expershop
A welcome page should be displayed.

If it works now, you can leave this page !

Congratulations, the installation process is over.
If not, reading the next chapters may help...

Legacy installation (no web application archive support)

This chapter applies to legacy servlet engines, that do not support web application archive deployment.
It is also applicable to a servlet engine that supports .war files, but the process is more complex than simply deploying the .war file...

First, we suppose you have downloaded ExperSHOP.
If you don't have ExperSHOP, get it on ExperLog's Web Site. Then:

  • Create an ExperSHOP directory somewhere in your directory tree.
    Advice: On Windows, create it directly into C:\; On Unix, create it into /usr/local.
  • Copy the expershop.war file in your ExperSHOP directory. A .war file is in fact a jar archive (JAva aRchive).
  • Extract the files: jar xvf expershop.war.
  • On Windows: Make your CLASSPATH point to the C:\ExperSHOP\WEB-INF\lib\expershop.jar file, as well as to the C:\ExperSHOP\WEB-INF\lib\hsqldb.jar file. Example:
    set CLASSPATH=%CLASSPATH%;C:\ExperSHOP\WEB-INF\lib\expershop.jar;C:\ExperSHOP\WEB-INF\lib\hsqldb.jar
  • On Unix: Make your CLASSPATH point to the ExperSHOP/WEB-INF/lib/expershop.jar file, and to the ExperSHOP/WEB-INF/lib/hsqldb.jar file.
    Example in ksh syntax:
    export CLASSPATH=$CLASSPATH:/usr/local/ExperSHOP/WEB-INF/lib/expershop.jar:/usr/local/ExperSHOP/WEB-INF/lib/hsqldb.jar

DynHtml pages

They are in the ExperSHOP/shops/lite/ESRootDir/ESTemplates/Shop directory: have a look at them, along with the DynHtml tutorial.

Running the sample shop

Running the sample shop with Enhydra

Enhydra is an open-source application server, developed and maintained by the ObjectWeb community.
You can download Enhydra from enhydra.org.

Then, after you installed Enhydra on your server, check our Enhydra configuration for ExperShop release notes:

Running the sample shop with Tomcat

Tomcat is the reference implementation for java servlets, provided by Apache. It is intended to replace Apache JServ.

You can download Tomcat from Apache jakarta project pages.

Then, after you installed Tomcat on your server, check our Tomcat configuration for ExperShop release notes:

Running the sample shop with BEA Weblogic

Weblogic is the servlet and HTTP server provided by BEA systems.

You can evaluate and purchase Weblogic from BEA's web site.

Then, after you installed Weblogic on your server, check our Weblogic configuration for ExperShop release notes: