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 ! |