Guide d`installation de Maarch 1.3 sous Windows

Guide d'installation de Maarch 1.3 sous Windows
Sommaire
• 1 Guide d'installation rapide - Maarch 1.3
• 2 Pré-requis
• 3 Téléchargement et installation des packages ou du SVN
• 4 Création des zones de stockage
• 5 Chargement des documents d'exemple
Guide d'installation rapide - Maarch 1.3
Cette page vous guide dans l'installation manuelle de Maarch à partir du package téléchargé sur SourceForge ou mieux du dépôt SVN.
Utilisez ce quide si l'installeur ne fonctionne pas pour une raison ou une autre. En particulier, les problèmes suivants peuvent survenir avec l'installeur :
• les prerequis ne sont pas respectés, ce qui empêche de passer aux pages suivantes. (modif demandée pour passer à la suite avec des
drapeaux rouges)
• impossible de créer la base de donnée (souvent dû à un user postgres qui ne peut pas créer de bases)
Maarch a été configuré pour favoriser une installation rapide sous Windows, essentiellement en vue de monter rapidement un démonstrateur. Les
paramètres par défaut sont prévus pour une exécution avec XAMPP installé dans le dossier c:\xampp.
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 les guides pour Linux(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
Pour installer très rapidement une version opérationnelle de Maarch, nous vous conseillons de :
• Télécharger et installer XAMPP 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.3 de Maarch a été packagée. Il suffit de récupérer sur Sourceforge les packages suivants (http://www.maarch.org/telecharger) :
• MaarchEntreprise-1.3
• MaarchAutoImport-3.3
• MCC_Client-1.1 et MCC_Server-1.1
Pour suivre les derniers upgrades validés il faut utiliser le [SVN Maarch]. Installez l'outil SVN et exécutez les scripts svn pour les branches
MaarchEntreprise-1.3, MaarchAutoImport-3.3, 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
Pour le jeu de données, vous avez le choix entre :
• C:\xampp\htdocs\maarch_entreprise\data_mini.sql, pour le strict minimum, utile pour démarrer un vrai paramétrage
• C:\xampp\htdocs\maarch_entreprise\data_fr.sql, pour un jeu de démo orienté archivage et assurances
• C:\xampp\htdocs\maarch_entreprise\data.sql, pour un jeu de démo orienté gestion du courrier en collectivité
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 zones de stockage
Les zones de stockage sont déclarées dans Maarch (table docservers : unixiens attention à changer le basepath dans cette table). Une des nouveautés
depuis 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 les jeux de test intégrés (data_fr et data_mlb_fr), il faut créer les répertoires à l'aide des commandes suivantes :
mkdir
mkdir
mkdir
mkdir
mkdir
mkdir
c:\maarch\docservers\entreprise\ai\
c:\maarch\docservers\entreprise\manual\
c:\maarch\docservers\entreprise\oais_main\
c:\maarch\docservers\entreprise\oais_safe\
c:\maarch\docservers\entreprise\offline\
c:\maarch\docservers\entreprise\templates\
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 :
mkdir 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].