Table des matières

, ,

Maarch

Cette page n'est pas à jour, ici vous trouverez un tutoriel complet pour l'installer à partir des sources.

Le logiciel Maarch est un logiciel de gestion électronique des documents (GED) sous licence libre distribué sous plusieurs formes. Cette documentation est dédiée à l'installation de la version Enterprise du logiciel.

Pré-requis

Installation

Etant donné que ce logiciel n'est pas préconfiguré pour Ubuntu, nous tenterons de l'installer en respectant la nomenclature habituelle des logiciels du même type (comme par exemple phpmyadmin).

Répertoire des fichiers de configuration de Maarch

Il faut commencer par créer un répertoire de configuration pour Maarch, qui contiendra notamment le fichier de configuration d'Apache. A cet effet, il est nécessaire de créer le répertoire /etc/maarch via la commande suivante, lancée depuis un terminal :

sudo mkdir /etc/maarch

Fichier de configuration d'Apache 2

Ensuite, nous allons créer le fichier de configuration d'Apache 2 nécessaire au fonctionnement de Maarch. Ce fichier de configuration permettra notamment de préciser l'emplacement des répertoires constituant l'application, du contexte d'URL à utiliser et des droits d'accès. Le fichier de configuration que nous proposons n'autorise que les accès depuis la machine en local. Nous verrons ultérieurement comment élargir le périmètre des utilisateurs autorisés à se connecter au système.

Ainsi pour créer ce fameux fichier, veuillez lancer la commande soit dans un terminal soit directement depuis le bureau Gnome (en tapant Alt-F2) : gksudo gedit /etc/maarch/apache.conf, puis copiez-y le contenu du paragraphe suivant en prenant soin de remplacer <nom-de-votre-serveur-smtp> par le nom d'hôte de votre serveur d'envoi de courrier électronique SMTP et sauvez votre fichier :

Alias /maarch /usr/share/maarch/

<Directory /usr/share/maarch/>

DirectoryIndex index.php

Options +FollowSymLinks
AllowOverride None

order deny,allow
deny from all
allow from 127.0.0.0/255.0.0.0 ::1/128
# allow from all

<IfModule mod_php5.c>
  php_value error_reporting E_ALL & ~E_NOTICE
  php_flag display_errors On
  php_flag register_globals Off
  php_value session.auto_start 0
  php_flag short_open_tag On
  php_value default_charset "UTF-8"
  php_flag magic_quotes_gpc Off
  php_flag magic_quotes_runtime Off
  php_flag magic_quotes_sybase Off
  php_value smtp <nom-de-votre-serveur-smtp>
  php_value smtp_port 25
</IfModule>

</Directory>

Maintenant, il nous faut lier ce fichier à la liste des fichiers de configuration pris en charge par apache 2. Pour cela, il suffit de créer un lien symbolique dans le répertoire /etc/apache2/conf.d qui pointera vers notre nouveau fichier. A cet effet, lancez la commande suivante dans un terminal :

sudo ln -s /etc/maarch/apache.conf /etc/apache2/conf.d/maarch.conf 

Création de la base de données

L'équipe de développement de Maarch préconique l'utilisation de la base de données PostgreSQL pour l'installation de leur produit logiciel. Cependant, il est possible également d'utiliser d'autres types de bases de données que nous ne détaillerons pas dans ce document.

Pour la suite de ces opérations, nous allons avoir besoin du contenu du fichier ZIP d'installation de Maarch Enterprise. Créez à l'occasion le répertoire /tmp/maarch et décompressez le contenu de l'archive dans ce dernier.

Pour la création de la structure de base de données de Maarch, nous allons opérer en ligne de commande. A cet effet, ouvrez un terminal et tapez la séquence de commandes suivantes en entrant chacune des lignes indiquées suivies de la touche Entrée :

mkdir /tmp/maarch 
cd /tmp/maarch
sudo su postgres
psql template1;
CREATE DATABASE maarch WITH OWNER = postgres ENCODING = 'UNICODE' TABLESPACE pg_default;
\connect maarch
CREATE USER maarch PASSWORD 'maarch' VALID UNTIL 'infinity';
GRANT ALL ON SCHEMA public TO maarch;
\i structure.sql
\i data.sql
\quit

Création du répertoire de stockage des documents

Maarch exploite un répertoire dédié au stockage des documents à archiver dans la GED, intitulé docserver. Nous allons nous charger dans cette partie de la documentation de créer ce répertoire et de le configurer.

A cet effet, tapez la commande suivante dans un terminal :

sudo mkdir -p /var/cache/maarch/docserver

Il faut ensuite donner les droits nécessaires et suffisants à Apache afin qu'il puisse y accéder. Pour cela tapez les commandes suivantes dans un terminal :

sudo chown www-data:www-data /var/cache/maarch/docserver
sudo chmod 700 /var/cache/maarch/docserver

Création du répertoire de l'application web

Maarch est une application PHP qui doit être disponible dans un emplacement dédié. Dans cette partie de la documentation, nous allons nous charger de cette tâche.

Ainsi, tapez les commandes suivantes dans un terminal :

sudo mkdir -p /usr/share/maarch
sudo cp -Rf /tmp/maarch/* /usr/share/maarch/
sudo chown -Rf www-data:www-data /usr/share/maarch
sudo chmod -Rf 700 /usr/share/maarch

Configuration

En théorie, notre installation est terminée, il reste maintenant à configurer Maarch. Cette partie du document est dédiée à cette tâche.

Configuration du répertoire des documents

Pour spécifier à Maarch où se trouve le répertoire destiné à stocker les documents, il faut ajouter une entrée dans la base de données. A cet effet, connectez-vous à la base de données en tant que l'utilisateur maarch (nous avons initialisé le mot de passe à 'maarch') en tapant les commandes suivantes dans un terminal :

psql -u maarch -p maarch maarch;

Vous serez ensuite en mesure d'exécuter des requêtes SQL. Lancez la requête suivante en tapant dans le terminal le texte ci-dessous :

INSERT INTO docservers (docserver_id, path_template,  size_limit, creation_date, coll_id, priority)
VALUES ('mydocserver','/var/cache/maarch/docserver', 10000000000, now(),'coll_1', 10);

Liens

Ressources

Maarch Entreprise

La GED de production complète basée sur le Framework 3

Maarch LetterBox

L'application de gestion de courrier pour les collectivités basée sur le Framework d'archivage Maarch

mysql -h localhost -u root -p maarch <  structure.sql
mysql -h localhost -u root -p maarch < data_minimal_fr.sql

Maarch Framework 3

Documentation technique de la v3.0 du Framework

Maarch AutoImport

Un outil d'import de masse pour toute la gamme Maarch (LetterBox et Framework)

Maarch Capture Connector

Le connecteur entre votre scanner et les applications

Maarch ScanSnap Connector

L'outil de numérisation en ligne pour un enregistrement ultra rapide et pratique

Maarch SAI

Le serveur de communication et de transformation des images en sortie de numérisation de masse

Maarch PeopleBox

Un exemple d'application de gestion des documents RH basé sur l'ancien Framework Maarch 2.1

Maarch Framework 2.1

Une architecture simple et robuste d'archivage documentaire (ancienne version 2.1)

Tutoriels


Contributeurs principaux : Hoani CROSS.