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 (Par exemple, Java 2). le JDK n'est pas nécessaire en exploitation (une JRE suffit), mais sera précieux pour les tests.
  • Un serveur Web supportant les servlets, comme Tomcat, Enhydra, ou des serveurs commerciaux tels que Weblogic ou Websphere.
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 sous forme d'application web

Ce chapitre s'applique aux serveurs de servlets qui supportent le déploiement d'applications web (fichiers .war, pour "Web Application aRchive").
Ce devrait être le cas de tout serveur supportant au moins la spécification Servlets 2.2 (comme par exemple Tomcat).
Si votre serveur de servlets ne SUPPORTE PAS les fichiers .war, veuillez passer au chapitre suivant.

Pour déployer ExperSHOP comme une application web:

  • Téléchargez le fichier expershop.war sur le site web d'ExperLog's ("Package Application Web ExperSHOP" dans la section "Télécharger").
  • Sous Windows, ce fichier peut apparaître sous le nom "expershop.war.zip": renommez-le en "expershop.war".
  • Déployez l'application web ExperSHOP, comme spécifié dans la documentation de votre serveur de servlets pour les fichiers .war. (Par exemple, avec Tomcat, copiez le fichier expershop.war dans le répertoire "webapps"; avec d'autres serveurs de servlets, il peut être nécessaire d'utiliser des outils d'administration spécifiques, ou de mettre à jour un fichier de configuration - dans ce cas, lisez la documentation correspondante).
  • Redémarrez votre serveur de servlets.
Vous trouverez ici des instructions plus détaillées concernant l'installation avec Tomcat 3.3 or 4.x ou Enhydra 5.

Pour vérifier que tout fonctionne bien, contactez l'application de démo d'ExperSHOP avec votre navigateur Web.

L'URL devrait ressembler à ceci :
http://host[:port]/expershop
ou (accès direct au servlet) :
http://host[:port]/expershop/com.expershop.lite.ExperSHOP
Par exemple, pour une installation standard de Tomcat sur la machine locale :
http://localhost:8080/expershop
Une page de bienvenue devrait s'afficher.

Si ExperSHOP fonctionne maintenant, vous pouvez quitter cette page !

Félicitations, l'installation est terminée.
Si ce n'est pas le cas, lire les chapitres suivants peut s'avérer utile...

Installation sans support des applications web

Ce chapitre s'applique aux serveur de servlets qui ne supportent pas les applications web (fichiers .war) - supportés depuis la spécification servlets 2.2.
Il s'applique aussi aux serveurs qui supportent les fichiers .war, mais ce mode d'installation est plus complexe que le simple déploiement d'une application web.

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, ou ESLite.zip, 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, ou unzip ESLite.zip (le fichier .zip peut être extrait avec WinZip sous Windows).
  • Sous Windows : faites pointer la variable système CLASSPATH vers les fichiers C:\ExperSHOP\lib\expershop.jar et C:\ExperSHOP\InstantDB\idb.jar.
    Exemple :
    set CLASSPATH=%CLASSPATH%;C:\ExperSHOP\lib\expershop.jar;C:\ExperSHOP\InstantDB\idb.jar
  • Sous Unix : faites pointer la variable d'environnement CLASSPATH vers les fichiers ExperSHOP/lib/expershop.jar et ExperSHOP/InstantDB/idb.jar.
    Exemple en syntaxe ksh :
    export CLASSPATH=$CLASSPATH:/usr/local/ExperSHOP/lib/expershop.jar:/usr/local/ExperSHOP/InstantDB/idb.jar
UNIX: script de configuration rapide

Le répertoire ExperSHOP contient un script shell (essetup.sh) qui peut simplifier l'installation (en particulier, pour positionner les droits d'accès aux fichiers d'InstantDB...).
Pour l'utiliser, allez dans le répertoire ExperSHOP, et exécutez le script (par exemple, comme suit, ou changez ses droits d'accès et lancez-le directement):

 source essetup.sh

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 ExperShop avec servletrunner

Une manière simple de tester la boutique est 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:\JSDK\bin, copiez EShopWin.cfg dans C:\JSDK).

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/JSDK/bin, copiez EShop.cfget DemoShop.cfg dans /usr/local/JSDK).
  • 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 ExperShop avec Enhydra

Enhydra est un serveur d'applications open-source, developpé et maintenu by Lutris technologies.
Vous pouvez télécharger Enhydra sur enhydra.org.

Ensuite, après avoir installé Enhydra sur votre serveur, consultez nos "Release Notes" ExperShop pour Enhydra :

  • Enhydra 3.1
  • Enhydra 4 (pas encore disponible - tests réalisés sur Enhydra 4 beta)

Faire fonctionner ExperShop avec Tomcat

Tomcat est l'implementation de référence des servlets java, fournie par Apache. Tomcat est destiné à remplacer Apache JServ.

Vous pouvez télécharger Tomcat sur les pages du projet jakarta d'Apache.

Ensuite, après avoir installé Tomcat sur votre serveur, consultez nos "Release Notes" ExperShop pour Tomcat :

Faire fonctionner ExperShop avec BEA Weblogic

Weblogic est le serveur de servlets de BEA systems.

Vous pouvez évaluer ou acheter Weblogic sur le site web de BEA.

Ensuite, après avoir installé Weblogic sur votre serveur, consultez nos "Release Notes" ExperShop pour Weblogic:

Faire fonctionner ExperShop avec Apache JServ

Le module Apache JServ, distribué par Apache, permet de faire tourner des 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 l'application 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/idb.jar
  • 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

Faire fonctionner ExperShop avec un serveur Netscape

Nous recommandons de ne pas utiliser l'interface servlet native de Netscape: utilisez plutôt 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 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 ExperShop 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