Guide d`installation rapide

Guide d'installation rapide
Sommaire
• 1 Guide d'installation rapide
• 2 Pré-requis
• 3 Téléchargement et installation des packages ou du SVN
• 4 Création des Document Servers
• 5 Chargement des documents d'exemple
Guide d'installation rapide
Cette page vous guide dans l'installation de Maarch à partir du package téléchargé sur SourceForge.
Maarch a été configuré pour favoriser une installation rapide. Il a donc été prévu pour tourner sous XAMPP installé dans le dossier c:\xampp.
Si vous désirez utiliser Maarch sur un serveur linux, inspirez-vous de ces instructions.
Il est bien entendu possible d'utiliser autre chose que XAMPP sous Windows, mais cela demande des connaissances informatiques plus approfondies
pour adapter les fichiers de configuration. Dans ce cas, consultez (en) le guide d'installation et de configuration pour la configuration de Maarch
Framework.
Respectez bien le chemin d'installation de XAMPP car nous avons tout pré-paramétré pour une installation sous C:\xampp, et vérifiez bien les options
du php.ini, ce qui vous évitera bien des problèmes !
Pré-requis
La liste des pré-requis se trouve dans les détails ici. Cependant, pour installer très rapidement une version opérationnelle de Maarch, nous vous
conseillons de :
• Télécharger et installer XAMPP sur une machine XP ou Windows, dans le répertoire C:\xampp.
• Télécharger et installer PostgreSQL
• Vérifier l'application des paramètres suivants dans le PHP.ini (C:\xampp\php\php.ini)
♦ error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED
♦ display_errors = on
♦ short_open_tag = On
♦ magic_quotes_gpc = off
♦ extension=php_pgsql.dll (n'est pas mis par défaut à partir de Xampp 1.7.2)
• Installer la librairie complémentaire Maarch pour le pilotage des batchs (via pear dans C:\xampp\php) :
♦ C:\xampp\php\pear channel-discover pear.maarch.org
♦ C:\xampp\php\pear install maarch/CLITools-0.3.1
♦ C:\xampp\php\pear install MIME_Type (normalement installé par défaut sous Windows)
NB : Après une modification du php.ini, il faut relancer Apache avec la console Xampp.
Après avoir activé l'extension php_pgsql.dll dans le php.ini, il se peut qu'Apache refuse de démarrer pour cause de librairie php_pgsql.dll non présente.
Cette erreur est en réalité due à une version de libpq.dll livrée avec XAMPP périmée par rapport à celle qui se trouve dans votre installation
PostgreSQL. Il faut tout d'abord ajouter à la variable d'environnement système "path" le chemin vers php : c:\xampp\php\. Si cela n'est pas suffisant, il
faut ajouter la ligne suivante dans C:\xampp\apache\conf\httpd.conf :
LoadFile "C:/Program Files/PostgreSQL/8.4/bin/libpq.dll"
Téléchargement et installation des packages ou du SVN
La version 1.2 de Maarch a été packagée. Il suffit de récupérer sur Sourceforge les packages suivants (http://www.maarch.org/telecharger) :
• MaarchEntreprise-1.2
• MaarchAutoImport-3.2
• MCC_Client-1.1 et MCC_Server-1.1
Pour suivre les derniers packages de ces versions il faut utiliser le SVN Maarch. Installez l'outil SVN et exécutez les scripts svn pour les branches
MaarchEntreprise-1.2, MaarchAutoImport-3.2, MCC_Client-1.1 et MCC_Server-1.1. (http://www.maarch.org/telecharger/svn-maarch).
Créez le répertoire C:\xampp\htdocs\maarch_entreprise, puis dezippez et installez :
• Maarch dans C:\xampp\htdocs\maarch_entreprise (ce qui doit vous donner c:\xampp\htdocs\maarch_entreprise)
• le package d'AutoImport dans C:\autoimport
Le package d'AutoImport contient des documents d'exemple pour les factures client (documents sortant) et de la numérisation de masse entrante.
Création de la base de données et des valeurs par défaut
A l'aide du programme d'administration de postgreSQL (ex: pgAdmin III), créez une nouvelle base de données appelée "maarch_entreprise", encodage
UTF8.
Cliquez sur la base nouvellement créée, puis dans une fenêtre SQL, ouvrez et exécutez :
• C:\xampp\htdocs\maarch_entreprise\structure.sql, ce qui a pour effet de créer toutes les tables Maarch
• C:\xampp\htdocs\maarch_entreprise\data.sql, pour créer un paramétrage d'exemple
Important : Dans le répertoire "C:\xampp\htdocs\maarch_entreprise\core\xml" vous trouverez un fichier nommé config.xml.default contenant le
paramétrage par défaut. Copiez-le dans un fichier config.xml, attendu par Maarch et mettez-le à jour en fonction de votre environnement. Faites de
même pour :
C:\xampp\htdocs\maarch_entreprise\apps\maarch_entreprise\xml\config.xml.default
C:\xampp\htdocs\maarch_entreprise\modules\full_text\xml\config.xml.default (si branché)
C:\xampp\htdocs\maarch_entreprise\modules\autofoldering\xml\config.xml.default (si branché)
C:\xampp\htdocs\maarch_entreprise\modules\life_cycle\xml\config.xml.default (si branché)
C:\xampp\htdocs\maarch_entreprise\modules\postindexing\xml\config.xml.default (si branché)
Création des Document Servers
Les document servers sont les zones de stockage qui sont déclarées dans Maarch (table docservers : unixiens attention à changer le basepath dans
cette table). Une des nouveautés de la version 1.2, c'est que vous pouvez désormais paramétrer vos zones de stockage depuis l'administration de
Maarch.
Sinon vous pouvez les éditer depuis la base de données : les zones de stockage sont définies dans la table docservers, champ path_template. Le plus
simple est de créer les bons chemins à partir des valeurs de cette colonne, en fonction du jeu de test disponible dans la version téléchargée.
Pour le jeu de test intégré dans le paquet de téléchargement 1.2 (Windows) :
mkdir c:\maarch\docservers\entreprise\ai\ mkdir c:\maarch\docservers\entreprise\manual\ mkdir c:\maarch\docservers\entreprise\oais_main\ mkdir
c:\maarch\docservers\entreprise\oais_safe\ mkdir c:\maarch\docservers\entreprise\offline\
Création du répertoire de catalogue pour les index lucène (recherche plein texte)
Il doit y avoir un répertoire d'index par collection Maarch. Créez le répertoire suivant :
C:\Maarch\indexes\entreprise\letterbox_coll
Chargement des documents d'exemple
A ce stade, vous pouvez d'ores et déjà vous connecter à l'application en tant que super-utilisateur (superadmin/superadmin) ou utilisateur fonctionnel.
Pour que ce soit plus parlant, nous avons créé pour vous deux jeux de documents d'exemple (factures client et documents scannés en masse), à
charger avec Maarch AutoImport.
Les documents sont dans :
C:\autoimport\samples\entreprise_scan (le scan de masse)
C:\autoimport\samples\entreprise_cold (les factures client)
Copiez le le premier jeu de documents et leur index dans les répertoires d'entrée de l'autoimport :
copy C:\autoimport\samples\entreprise_scan\*.* C:\autoimport\incoming\entreprise
Executez ensuite le batch d'importation : C:\autoimport\autoimport_entreprise_scan.bat
Procédez de même avec C:\autoimport\samples\entreprise_cold :
copy C:\autoimport\samples\entreprise_cold\*.* C:\autoimport\incoming\entreprise
Batch d'importation : C:\autoimport\autoimport_entreprise_cold.bat Lancer l'application
Dans la barre d'adresse de votre navigateur web tapez : http://127.0.0.1/maarch_entreprise pour lancer l'application.
Vous arrivez sur la page de connexion. Et voilà ! Vous êtes maintenant prêt à utiliser Maarch! Suivez attentivement le guide de visite.