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.2, or 1.1 with Javasoft's JSDK installed).
  • A web server that supports servlets, like Java WebServer or Apache (but you can run the demo with servletrunner, the JSDK testing tool).
The sample shop comes with a demo database, there's an InstantDB engine coming with ExperSHOP for demo purposes.

Installation

First, we suppose you have downloaded ExperSHOP.
If you don't have ExperSHOP, get it on ExperLog's Web Site. Then:
  • Install the jar file somewhere in your directory tree.
    Advice: On Windows, copy it directly into C:\; On Unix, copy it into /usr/local. (in both cases, an "ExperSHOP" sub-directory will be created).
  • Extract the files: jar xvf ESLite.jar.
  • On Windows: Make your CLASSPATH point to the C:\ExperSHOP\lib\expershop.jar directory, as well as to the C:\ExperSHOP\InstantDB\Classes directory. Example:
    set CLASSPATH=%CLASSPATH%;C:\ExperSHOP\lib\expershop.jar;C:\ExperSHOP\InstantDB\Classes

  • On Unix: Make your CLASSPATH point to the ExperSHOP/lib/expershop.jar directory, and to the ExperSHOP/InstantDB/Classes directory.
    Example in ksh syntax:
    export CLASSPATH=$CLASSPATH:/usr/local/ExperSHOP/lib/expershop.jar :/usr/local/ExperSHOP/InstantDB/Classes

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 servletrunner

The easiest way to test the sample shop is, first, to run it using servletrunner (the servlet test tool that comes with java servlets).

  • Go into the ExperSHOP\shops\lite directory.
  • Run servletrunner -d .
  • In your web browser, call http://your-server-name:8080/servlet/com.expershop.lite.ExperSHOP
Some bugs in some releases of servletrunner.exe can cause ExperSHOP's configuration file not to be found...

Windows Users:

  • If you did not install ExperSHOP directly under C:\ExperSHOP, edit the EShopWin.cfg and DemoShopWin.cfg files and replace the "C:\\Expershop\\..." strings with the value that corresponds to your installation (always duplicate the "\" characters).
  • If you still encounter configuration problems (like "file not found" exceptions or database connection trouble), copy the EShopWin.cfg file into the JSDK root directory (for example, if servletrunner.exe is in C:\JSDK2.0\bin, copy EShopWin.cfg into C:\JSDK2.0).

Unix Users :

  • If you encounter configuration problems (like "file not found" exceptions or database connection trouble), copy the EShop.cfg and DemoShop.cfg files into the JSDK root directory (for example, if servletrunner is in /usr/local/JSDK2.0/bin, copy EShop.cfg and DemoShop.cfg into /usr/local/JSDK2.0).
  • Edit EShop.cfg and DemoShop.cfg, and replace relative paths with absolute ones (see the comments in the files).

Note For InstantDB Users:

You may encounter problems with the shopping cart, due to database initializing problems on some platforms: if the cart does not work properly, run java sample in the ExperSHOP/shops/lite directory.

Running the sample shop with Java Web Server

First, copy the configuration files in Java Web Server's root directory.

The configuration files are in the ExperSHOP\shops\lite directory (EShop.cfg, DemoShop.cfg, EShopWin.cfg, DemoShopWin.cfg).

Then:

  • Start Java Web Server.
  • In your web browser, call http://your-server-name:8080/servlet/com.expershop.lite.ExperSHOP
Running the sample shop with a Netscape server

Using the Netscape native servlet interface is not recommended: if you are using a Netscape server, better use LiveSoftware JRun for servlets.

  • Enable server-side java in your Netscape server (using the Netscape admin tool).
  • Download LiveSoftware JRun evaluation version (free); commercial users will have to buy the product.
  • Install JRun (comes with detailed installation instructions).
  • Don't forget to set the CLASSPATH value in the JRun administration tool (JRun does not use the CLASSPATH environment variable defined on your system, it has its own settings).
Running the sample shop with Apache

You need the JServ Apache module, to run servlets (see the java apache project for more info).

We'll suppose Apache and JServ are properly configured. Then:

  • Declare a JServ zone for the ExperSHOP sample shop, along with its configuration file (see the apache documentation for more details).
  • In the zone's configuration file, update the "repositories" property so it points to the shop's classes, just like a CLASSPATH. Example:
    repositories:yourpath/ExperSHOP/lib/expershop.jar:yourpath/ExperSHOP/InstantDB/Classes
  • In the same file, declare a SHOPDIR and a SHOPCONFIG parameter to be passed to the ExperSHOP servlets (SHOPDIR is the name of the directory that contains the ExperSHOP configuration file, SHOPCONFIG is the ExperSHOP configuration file name).
    You may specify SHOPCONFIG only, with the whole path inside.
    Example:
    servlets.default.initArgs=SHOPCONFIG=
    yourpath/ExperSHOP/shops/lite/EShop.cfg
  • Update the corresponding EShop.cfg and DemoShop.cfg files (on Windows, EShopWin.cfg and DemoShopWin.cfg), specifying full absolute paths for all files pointed there (example: ExperSHOP.RootDir must contain an absolute path).
  • In your web browser, call http://your-server-name/name-of-the-JServ-zone/com.expershop.lite.ExperSHOP
Then just surf, and buy !