Instructions d'installation de ShopSite SC 4.3

Pour installer ShopSite sur votre serveur UNIX, vous n'avez besoin que de votre navigateur Web favori et d'un accès ftp ou telnet au serveur.
Table des matières

I. Considérations préalables à l'installation
II. Structuration des répertoires ShopSite
III. Exécution du programme d'installation
IV. Installation sur un serveur virtuel
V. Configuration du serveur Web
VI. Mise à niveau
VII. Dépannage
VIII. Création de votre magasin
Considérations préalables à l'installation

Avant d'installer ShopSite, il convient de vérifier si le système présente la configuration matérielle et logicielle minimale requise.

Vérifiez par ailleurs le bon fonctionnement du serveur Web, y compris de l'authentification utilisateur. Si le serveur Web ne fonctionne pas, vous ne pourrez pas installer ShopSite. Si vous ne disposez pas de serveur Web, nous pouvons vous conseiller Apache. Il est gratuit. ShopSite fonctionne avec tous les serveurs Web compatibles NCSA, tels que Netscape et IIS de Microsoft.

Vous devez disposer de la version 5.003 de Perl si vous installez ShopSite Manager ou Pro. Vous pouvez télécharger la dernière version à l'adresse du site Web de Perl. Vous devrez compiler Perl pour le serveur. Bien qu'apparemment compliquée, la procédure se déroulera sans heurts si vous acceptez la configuration par défaut en appuyant successivement sur la touche Retour. Perl est également gratuit.

Structuration des répertoires ShopSite

Le programme d'installation de ShopSite SC vous invite à préciser l'emplacement de cinq répertoires :

Les fichiers exécutables sont placés dans deux répertoires séparés, "ShopSite" et "Caddie". Ces répertoires doivent porter un alias sur le serveur et être accessibles par URL.
® Vous devez placer ces répertoires dans ou sous le répertoire cgi-bin. Par mesure de précaution, vous devez configurer le serveur de telle sorte qu'il ne serve que des programmes CGI à partir des répertoires cgi-bin, et non pas des fichiers texte ou HTML.

Les graphiques utilisés par tous les magasins ShopSite sont conservés dans un répertoire séparé devant être accessible via le serveur Web. Le répertoire recommandé est shopsite-images sous le root de document du serveur Web.

Vous devez définir, pour votre magasin, un répertoire "Données" où iront se loger les bases de données de produits et de pages.
® Accordez les autorisations nécessaires dans le répertoire "Données" de telle sorte que votre serveur Web puisse y accéder, mais en veillant à ce qu'il ne soit pas accessible à partir d'un navigateur. En d'autres termes, ne placez pas le répertoire "Données" sous le root de document du serveur Web.

Vous avez également besoin, pour votre magasin, d'un répertoire "Sortie HTML" où iront se loger les fichiers HTML, à savoir les pages générées pour le magasin. L'URL de la vitrine de magasin doit être un alias pointant vers le répertoire de sortie HTML du magasin.
® Placez le répertoire de sortie HTML à l'emplacement où figurent vos pages HTML.
Notez que les images relatives à chaque magasin sont conservées dans un sous-répertoire media du répertoire de sortie HTML du magasin. Vous pouvez configurer l'accès FTP au répertoire media .

Structurez l'emplacement de chaque répertoire avant de procéder à l'installation. Voici un exemple de structure de répertoires :
 home

  httpd

      cgi-bin

       ss = Répertoire ShopSite,

               portant un alias pointant sur URL des CGI de ShopSite, tel que 

               http://www.xyz.com/cgi-bin/ss

       sc = Répertoire Caddie,

                 portant un alias pointant sur URL des CGI de caddie., tel que 

                 http://www.xyz.com/cgi-bin/sc

      html

       shopsite-images

       StoreName = Répertoire de sortie HTML, portant un alias pointant sur l' 

                      URL de vitrine de magasin définie dans le fichier store.auth .

          Pages du magasin

          media - vous avez peut-être besoin d'un accès FTP

              Images du magasin

      données

          StoreName = Répertoire de données
Exécution du programme d'installation

Une fois que vous avez téléchargé le programme d'installation compressé, vous pouvez aisément installer ShopSite à l'aide de votre navigateur.

Si ce n'est déjà fait, téléchargez le fichier d'installation compressé et le fichier store.auth vers le répertoire depuis lequel vous lancerez l'installation. Il est important que les programmes CGI puissent s'exécuter et écrire dans ce répertoire. Si vous utilisez le protocole FTP pour récupérer les fichiers, veillez à utiliser un mode de transfert binaire.

Décompressez le fichier d'installation.

Accordez les autorisations nécessaires aux fichiers et au répertoire ainsi qu'au niveau du serveur Web, en sorte que vous puissiez exécuter les programmes wwwinstall.cgi et info.cgi à partir de votre navigateur Web.

Pointez votre navigateur sur le fichier wwwinstall.cgi du répertoire d'installation.

Dans le premier écran, cliquez sur Install a Store si c'est la première fois que vous installez ShopSite sur ce serveur. Cliquez sur Upgrade si vous avez déjà installé ShopSite.

Complétez ensuite les champs de l'écran suivant, puis cliquez sur OK. Vous devez compléter tous les champs. A défaut, le programme d'installation ne fonctionnera pas.

Le programme d'installation commence l'installation de ShopSite et en affiche les résultats. Si le programme a rencontré des erreurs, modifiez les champs en conséquence, puis cliquez de nouveau sur le bouton OK.

Installation sur un serveur virtuel

Sur la plupart des serveurs virtuels, les chemins d'accès aux répertoires que l'on peut voir à partir d'une session telnet diffèrent de ceux que l'on pourrait voir à partir d'un navigateur Web. Songez-y au moment d'indiquer les chemins d'accès utilisés par le programme d'installation de type navigateur.

Veillez à ce qu'il y ait un répertoire tmp au niveau de la racine virtuelle ; à défaut, tar générera des erreurs.
Vérifiez si le serveur Web a accès à l'exécutable tar.

Problèmes d'installation Iserver (Verio)
Le serveur Web n'a pas accès à l'exécutable tar. Copiez le programme tar à partir de /bin/tar vers /bin/tar sous votre répertoire de base. Par exemple :
      cp /bin/tar ~/usr/bin/tar
      chmod ug=rx ~/usr/bin/tar
    
Par défaut, la version perl sur Iserver est 4.0. Vous devez trouver la version 5.004 (ou ultérieure) et la copier vers un répertoire ~/usr/bin/perl5 ou similaire qui soit accessible au serveur Web. N'oubliez pas de rendre le fichier exécutable ('x'). Par exemple :
      cp /usr/local/bin/perl5.004 ~/usr/bin/perl5
    
Configuration du serveur Web

Configurez le serveur Web de telle sorte qu'il reconnaisse les nouveaux répertoires :

Créez un alias de l'URL ShopSite qui pointe vers le répertoire " Shopsite ".
Créez un alias de l'URL du caddie qui pointe vers le répertoire " Caddie ".

Mise à niveau

La procédure de mise à niveau de type navigateur ressemble à s'y méprendre à la procédure d'installation, mais elle est encore plus simple. Le début de la procédure est identique.

Transférez par protocole FTP la nouvelle version compressée de ShopSite correspondant à votre système d'exploitation et placez-la dans le répertoire CGI (ou tout autre répertoire à partir duquel il est possible d'exécuter des CGI), puis décompressez-la. Si vous ne disposez pas d'un accès telnet, décompressez-la sur votre PC, puis transférez un à un les composants par protocole FTP.

Pointez le navigateur sur l'adresse http://votreURL/votrerépertoireCGI/wwwinstall.cgi.

Dans le premier écran, cliquez sur le bouton Upgrade. Le programme d'installation détermine automatiquement les chemins d'accès à vos répertoires CGI ShopSite et Caddie.

Si vous n'avez pas apporté de modifications incongrues à votre configuration de serveur, vous ne devrez rien changer. Cliquez simplement sur OK et votre magasin sera mis à jour.

Le programme d'installation met à jour les CGI et les bases de données du magasin. Si plusieurs magasins partagent les mêmes CGI, le programme met à jour les bases de données de chacun d'eux, puis vous informe des résultats. Si vous avez plusieurs magasins, la mise à jour peut prendre un certain temps.

Dépannage

Si l'installation a échoué, lisez attentivement les messages d'erreur qui s'affichent. Ils devraient vous remettre sur la bonne voie. Sinon, vérifiez les aspects suivants :

Les autorisations de fichier sont-elles correctement définies pour tous les répertoires indiqués ? Une définition incorrecte des autorisations et de la propriété est la principale source de problème d'installation que rencontrent les utilisateurs. Spécifiquement, le compte utilisateur UNIX sous lequel les CGI s'exécutent doit avoir un accès en écriture dans ces répertoires CGI.

Votre serveur Web est-il correctement configuré ?

Avez-vous entré les même ID de magasin et URL que celles communiquées au vendeur lors de la création du fichier store.auth ? Si ce n'est pas le cas, il vous faut un nouveau fichier store.auth .

Le fichier store.auth se trouvait-il dans le même répertoire que le programme d'installation ? Dans ce cas, il aurait dû créer un nouveau fichier appelé yourstoreid.auth dans le répertoire de données du magasin.

Si vous ne parvenez toujours pas à résoudre le problème, effectuez une recherche dans notre Technical Support Knowledgebase pour voir si ce problème a déjà été signalé et si une solution a été publiée ou suggérée.
Création de votre magasin

Une fois le logiciel installé, vous êtes fin prêt pour créer un magasin ! Pointez le navigateur sur l'adresse start.cgi dans le répertoire dans lequel vous avez installé les CGI. Après avoir introduit vos nom d'utilisateur et mot de passe, vous accédez à la première page de l'Assistant d'installation du magasin ShopSite qui vous guidera pas à pas tout au long de la création du magasin.
Vous pouvez cliquer sur point d'interrogation ("?") situé dans le coin supérieur droit de chaque écran pour obtenir de l'aide sur cet écran et pour accéder à la " Knowledgebase " et au système d'aide de ShopSite dans lesquels vous pouvez effectuer des recherches.