Services Communauté Forum Documentation Contact : info@maarch.org +33 1 47 24 51 59

Guide d'installation de Maarch Entreprise 1.3 sous Windows

De Maarch // Wiki.

Sommaire

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 Entreprise 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 Entreprise 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 Entreprise

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 Entreprise.

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 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\
mkdir 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 Entreprise ! Suivez attentivement le [guide de visite].

Outils personnels
Language