Guide d'Installation

Vérifiez la distribution

Vous devez disposer au minimum :

• Des scripts principaux :
  • Le script d'appel : ESSI.pl
  • Le fichier de configuration central : ESSIConf.pl
  • La librairie principale du processeur DIML : ESSI.pm
• Des librairies dans le sous-répertoire "ESSI" :
  • La librairie des fonctions CGI : ESSICgi.pm
  • La librairie des utilitaires généraux : ESSIGen.pm
  • La librairie spéciale pour l'implémentation de Web Composants¹ : ESSIWct.pm
  • La librairie spéciale pour les fonctions de sécurité¹ : ESSISecurity.pm
  • Une librairie de compatibilité pour les sites utilisant les fonctions de cache³ : ESSICache.pm

Vous pouvez également installer deux libraires d'extensions :

• La librairie d'exploration XML : ESSIXml.pm
• La librairie d'extensions SQL² : ESSISql.pm

(1) Cette librairie n'est pas obligatoire pour le fonctionnement du processeur DIML. Toutes les fonctionnalités déclarées de la spécification ESSI sont disponibles sans ce fichier.

(2) Seule MySQL supportée actuellement.

(3) Uniquement pour les sites codés avec les instructions de cache. Cette librairie pilote les instructions de cache , ou implémente une réponse neutre pour ces instructions dans la version stable.

Installation du moteur DIML pour apache (Windows)

1. Décompactez l'archive d'installation dans un répertoire quelconque
2. Vérifiez la disponibilité des modules standard Carp.pm et Exporter.pm dans la librairie standard du Perl.
3. Copiez les scripts principaux et le répertoire de librairies dans tout répertoire autorisé en exécution de votre serveur Web. Pour cela, la configuration serveur doit présenter les lignes :

   ScriptAlias /un_chemin_aliasé/ un_chemin_réel

   Le chemin réel doit être validé pour l'exécution cgi :

   <Directory un_chemin_réel>
   
      Options ExecCgi
   
      </Directory>

4. Alternativement, le répertoire de librairies peut être placé dans le répertoire de librairies de votre interpréteur Perl (typiquement "C:\perl\lib" ou C:\perl\site\lib"). Les librairies seront trouvées plus rapidement.
5. Modifiez le cas échant la ligne d'appel de l'interpréteur à la première ligne du processeur "essi.pl":
   
   

   #!C:\perl\bin\perl.exe

6. Spécifiez le handler de pré-traitement à exécuter pour tous les documents de type mime x-essi-parsed (extension .diml ou .dim)

   AddType application/x-essi-parsed .diml .dim
   
      Action application/x-essi-parsed /cgi-bin/essi.pl 

Exécuter la démonstration

La démonstration du processeur ESSI et de ses fonctionnalités est disponible dans la présente distribution.

• Copiez le fichier "dimltest.dim" dans un répertoire quelconque de votre racine des documents.
• Adressez le fichier par son URL réseau "http:// .... dimltest.dim".

Les instructions DIML présentes dans le fichier source devraient avoir disparues et être remplacées par les valeurs spécifiées.

Installation du moteur DIML pour Apache (Linux)

Procéder de la même manière que sous Windows, en vérifiant le chemin d'accès Unix vers l'interpréteur perl à la première ligne du processeur. Typiquement :

#!/usr/bin/perl

Veillez à bien respecter la casse des modules du processeur : ESSI.pm ESSIGen.pm, ESSIWct.pm et ESSICgi.pm (mais vous êtes déjà un pro d'Unix, je suis sûr)

Installation du moteur DIML pour IIS (Windows NT4.0)

Installation avec IIS 3

• Vérifiez la disponibilité des modules standard Carp.pm et Exporter.pm dans cette même librairie.
• Copiez les scripts principaux du processeur ESSI et le répertoire de librairies dans un répertoire activé pour les scripts. Pour cela, ouvrez le panneau d'administration d'IIS, créez un alias du répertoire, activez la capacité d'exécution du répertoire.
• Pour router directement les fichiers d'extension ".dim" vers le processeur, vous devez définir un point de routage des scripts dans la base de registres
  (->regedit). A l'entrée :
  
  HKEY_LOCAL_MACHINE->SYSTEM->CurrentControlSet->Services->W3SVC->Parameters->Script Map
  (faut aller la chercher, celle-là ;-)
  Créer la clef : (Menu Edit, New, String Value)
  
  

  KEY	.dim
  VALUE	perl_binary_path\perl.exe essi_processor_path\essi.pl %s %s

  
  
  • perl_binary_path est le chemin d'accès à l'exécutable de votre interpréteur Perl.
  • essi_processor_binary_path est le chemin d'accès au répertoire CGI dans lequel vous avez placé le processeur (typiquement "C:\InetPub\WWWroot\cgi-bin").
  • le premier "%s" va donner au processeur l'adresse transcrite du fichier ".diml" à traiter.
  • le deuxième "%s" donnera au processeur la chaîne des paramètres de requête CGI lors d'une requête de type GET

Installation avec IIS 4

• Installez la distribution du processeur comme ci-dessus.
• Lancez l'interface d'administration en ligne d'IIS (en local : http://localhost:4234/iisadmin/iis.asp), puis répetez les lignes suivantes pour chaque répertoire de vos fichiers DIML :
• Dans "application settings", cliquez sur le bouton "Create".
• Dans la liste "permissions", choisissez "Execute(including script)", puis cliquez sur le bouton "mappings".
• Une autre fenêtre apparaît ; cliquez sur le bouton "Add" puis entrez dans la nouvelle ligne les valeurs suivantes :
  
  • dans la première case : .dim
    
  • dans la seconde case : {perl_binary_path}\perl.exe {essi_processor_binary_path}\essi.pl %s %s
    (typiquement : c:\perl\bin\perl.exe c:\inetpub\wwwroot\cgi-bin\essi.pl %s %s )
    
  • laissez la troisième vide, et cochez la dernière petite case
    
• Cliquez sur "OK" ; puis sur "Save";
  
  
• Note : vous n'avez pas besoin de relancer le service, la mise à jour se fait automatiquement.