ExperSHOP - Démarrer rapidement


Page Principale Table

Pour tout rapport de bug ou suggestion, envoyez un mèl au Support ExperLog


Prérequis

  • Un environnement java qui supporte les servlets (JDK 1.2, ou 1.1 avec le JSDK de Javasoft installé) ; le JDK/JSDK n'est pas nécessaire en exploitation, mais sera précieux pour les tests.
  • Un serveur Web supportant les servlets, comme Java WebServer ou Apache (pour les tests, vous pouvez utiliser servletrunner, le serveur de test du JSDK).
ExperSHOP est livré avec une base de données de démo afin que vous puissiez le faire fonctionner rapidement :
Il y a une base de données InstantDB dans le package ExperSHOP (la version n'est pas garantie).

Installation

Tout d'abord, vous avez besoin du package ExperShop Lite.
Si vous ne l'avez pas encore, téléchargez-le sur le Site Web ExperLog. Ensuite :
  • Installez le fichier ESLite.jar dans votre arborescence de fichiers.
    Conseil : sous Windows, copiez-le directement sous C:\; Sous Unix, copiez-le dans /usr/local. (dans les deux cas, un répertoire "ExperShop" sera créé à l'installation).
  • Procédez à l'extraction des fichiers : jar xvf ESLite.jar.
  • Sous Windows : faites pointer la variable système CLASSPATH vers les répertoires C:\ExperSHOP\lib\expershop.jar et C:\ExperSHOP\InstantDB\Classes.
    Exemple :
    set CLASSPATH=%CLASSPATH%;C: \ExperSHOP\lib\expershop.jar;C:\ExperSHOP\InstantDB\Classes

  • Sous Unix : faites pointer la variable d'environnement CLASSPATH vers les répertoires ExperSHOP/lib/expershop.jar et ExperSHOP/InstantDB/Classes.
    Exemple en syntaxe ksh :
    export CLASSPATH=$CLASSPATH:/usr/local/ExperSHOP/lib/expershop.jar :/usr/local/ExperSHOP/InstantDB/Classes

Pages DynHtml

Elles se trouvent dans le répertoire
ExperSHOP/shops/lite/ESRootDir/ESTemplates/Shop :
allez les consulter, avec l'aide du guide d'utilisation DynHtml.

Faire fonctionner la boutique d'exemple ExperSHOP Lite

Faire fonctionner la boutique avec servletrunner

La manière la plus simple de tester la boutique est, avant tout, de la faire tourner avec servletrunner (le serveur de test pour les servlets, livré avec les servlets par JavaSoft).

  • Allez dans le répertoire ExperSHOP\shops\lite.
  • Lancez servletrunner -d .
  • Dans votre navigateur Web, accédez :
    http://votre-machine:8080/servlet/com.expershop.lite.ExperSHOP
Certaines versions de servletrunner peuvent causer des problèmes de fichier de configuration...

Sous Windows :

  • Si vous n'avez pas directement installé ExperSHOP sous C:\ExperSHOP, éditez les fichiers EShopWin.cfg et DemoShopWin.cfg, et remplacez chaque occurence de "C:\\Expershop\\..." par le chemin qui convient (dupliquez toujours les caractères "\").
  • Si vous avez encore des problèmes (type exceptions "file not found" ou problèmes de connexion à la base de données), copiez le fichier EShopWin.cfg dans le répertoire racine du JSDK (par exemple, si servletrunner.exe est dans C:\JSDK2.0\bin, copiez EShopWin.cfg dans C:\JSDK2.0).

Sous Unix :

  • Si vous avez encore des problèmes (type exceptions "file not found" ou problèmes de connexion à la base de données), copiez les fichiers EShop.cfg et DemoShop.cfg dans le répertoire racine du JSDK (par exemple, si servletrunner est dans /usr/local/JSDK2.0/bin, copiez EShop.cfget DemoShop.cfg dans /usr/local/JSDK2.0).
  • Editez ces fichiers, et remplacez les chemins relatifs par des chemins absolus (voir commentaires dans les fichiers).

Note pour la base de données InstantDB :

Sur certaines plateformes, des problèmes d'initialisation peuvent se produire, causant un mauvais fonctionnement du panier d'achats.
Si le panier d'achats ne fonctionne pas, lancez java org.enhydra.instantdb.ScriptTool dans le répertoire ExperSHOP/shops/lite.

Faire fonctionner la boutique avec Java Web Server

D'abord, copiez les fichiers de configuration ExperSHOP dans le répertoire racine de Java Web Server.

Les fichiers de configuration sont dans le répertoire ExperSHOP\shops\lite (EShop.cfg, DemoShop.cfg, EShopWin.cfg et DemoShopWin.cfg).

Ensuite:

  • Lancez Java Web Server.
  • Dans votre navigateur Web, accédez :
    http://votre-machine:8080/servlet/com.expershop.lite.ExperSHOP
Faire fonctionner la boutique avec un serveur Netscape

Nous recommandons de ne pas utiliser l'interface servlet native de Netscape: utilisez plutôt LiveSoftware JRun pour les servlets.

  • A l'aide de l'outil d'administration Netscape, autorisez votre serveur Netscape à éxécuter du java.
  • Téléchargez la version d'évaluation de LiveSoftware JRun ; les utilisateurs commerciaux devront ensuite acheter le produit.
  • Installez JRun (suivez les instructions données dans la documentation du produit).
  • N'oubliez pas de positionner la valeur du CLASSPATH dans l'outil d'administration de JRun (JRun n'utilise pas la variable CLASSPATH définie sur votre système).
Faire fonctionner la boutique avec Apache

Vous avez besoin du module Apache JServ, pour les servlets (voir le projet Apache Java - en anglais - pour plus d'informations).

Nous supposerons que vous avez convenablement installé Apache et JServ. Ensuite:

  • Déclarez une zone JServ pour la boutique ExperSHOP Lite, associée a un fichier de configuration (voir la documentation Apache pour plus de details).
  • Dans le fichier de configuration de la zone, mettez à jour la propriété "repositories" pour pointer vers les classes ExperSHOP.
    Exemple :
    repositories:/usr/local/ExperSHOP/lib/expershop.jar:/usr/local/ ExperSHOP/InstantDB/Classes
  • Dans le même fichier, déclarez des paramètres SHOPDIR et SHOPCONFIG à passer aux servlets ExperSHOP (SHOPDIR est le nom du répertoire qui contient le fichier de configuration ExperSHOP, SHOPCONFIG est le nom du fichier de configuration ExperSHOP).
    Vous pouvez si vous le souhaitez mettre le chemin complet vers le fichier de configuration ExperSHOP dans SHOPCONFIG, et ne pas définir SHOPDIR.
    Exemple :
    servlets.default.initArgs=SHOPCONFIG= /usr/local/ExperSHOP/shops/lite/EShop.cfg
  • Mettez à jour les fichiers de configuration ExperSHOP (EShop.cfg et DemoShop.cfg sous Unix, EShopWin.cfg et DemoShopWin.cfg sous Windows), en y spécifiant les chemins complets d'accès aux différents répertoires et fichiers listés dans la configuration (exemple: ExperSHOP.RootDir doit contenir un chemin absolu).
  • Dans votre navigateur Web, accédez :
    http://votre-machine/nom-de-la-zone-JServ/com.expershop.lite.ExperSHOP
C'est prêt !