Skip to content

Latest commit

 

History

History
102 lines (76 loc) · 3.88 KB

README.md

File metadata and controls

102 lines (76 loc) · 3.88 KB
Raw

Démarrage rapide

Build Status

ezPAARSE se présente sous la forme d'un Web service dans lequel vous pouvez injecter vos logs et récupérer les évènements de consultation correspondants. Cette procédure décrit comment installer ezPAARSE sur votre ordinateur.

Pré-requis

Voici les outils dont vous avez besoin pour faire fonctionner ezPAARSE :

  • Système d'exploitation Linux : voir les pré-requis par systèmes
  • Outils standards Linux : bash, make, grep, sed ...
  • curl (utilisé par nvm)
  • git >= 1.7.10 (demandé par github)

ezPAARSE embarque tous les éléments nécessaires à son fonctionnement. Lorsque les pré-requis sont remplis, le lancement de la commande make (voir ci-dessous) réalise toutes les opérations d'installation.

Installation

Si vous êtes utilisateur du système d'exploitation Windows, vous pouvez installer ezPAARSE sur votre ordinateur en téléchargant le setup et en lançant l'installation comme n'importe quel autre programme.

Si vous souhaitez installer ezPAARSE sur un système de type Unix, téléchargez une version stable au format tar.gz puis ouvrez un terminal et tapez :

unzip ezpaarse-X.X.X.zip
cd ezpaarse-X.X.X
make

Si vous souhaitez installer la version de développement, ouvrez un terminal et tapez :

git clone http://github.com/ezpaarse-project/ezpaarse.git
cd ezpaarse
make

Vous avez également la possibilité de télécharger une archives pour deb et de l'installer sur votre système Debian/Ubuntu de cette façon :

sudo -E dpkg -i ezpaarse-X.X.X.deb
sudo /etc/init.d/ezpaarse start

Tester l'installation

Cette étape vous permettra de valider que votre installation est fonctionnelle.

make start
make test

Usage

Des fichiers de logs exemple et anonymisés sont disponibles dans les répertoires d'ezPAARSE.

Vous devez tout d'abord vous assurer qu'ezPAARSE est démarré en lançant la commande suivante :

make start

Si vous n'êtes pas informaticien, la méthode la plus simple pour utiliser ezPAARSE est de passer par son formulaire HTML directement accessible depuis votre navigateur Web favoris. Il suffit pour cela d'ouvrir cette adresse : http://localhost:59599/

Si vous êtes informaticien, vous pouvez utiliser un client HTTP (ici curl) pour envoyer un fichier de données de log (ici ./test/dataset/sd.2012-11-30.300.log) sur le Web service d'ezPAARSE et obtenir en réponse un flux CSV d'événements de consultation :

curl -X POST http://127.0.0.1:59599 \
             -v --proxy "" --no-buffer \
             --data-binary @./test/dataset/sd.2012-11-30.300.log

Alternativement, vous pouvez utiliser la commande ./bin/loginjector fournie par ezPAARSE pour injecter plus simplement le fichier de log dans le Web service d'ezPAARSE :

. ./bin/env
cat ./test/dataset/sd.2012-11-30.300.log | ./bin/loginjector

Vous pouvez également réaluser des comptages rapides en rajoutant la commande ./bin/csvtotalizer à la suite de la ligne de commande. Vous aurez entre autre un aperçu des événements de consultation reconnus par ezPAARSE sur vos logs :

. ./bin/env
cat ./test/dataset/sd.2012-11-30.300.log | ./bin/loginjector | ./bin/csvtotalizer

Paramétrage avancé

  • Le port d'écoute du Web service d'ezPAARSE peut être réglé en modifiant la variable EZPAARSE_NODEJS_PORT dans le fichier config.json (par défaut 59599)