Installation de l'extension Archives Publiques

Cette procédure va vous guider pas à pas dans l'installation d'une extension de maarch RM.

Attention : Cette documentation permet uniquement l'installation d'une extension de l'application. Le socle d'archivage doit déjà être téléchargé et ses prérequis validés pour la bonne intégration de cette extension. La documentation relative à l'installation du socle d'archivage est disponible ici : Installation socle d'archivage

Prérequis

  1. Avoir validé les prérequis lors de l'installation du socle d'archivage.
  2. Avoir récupéré les sources du socle d'archivage.

Déploiement de l'extension Archives publiques

Récupération des sources

Si vous souhaitez installer l'extension Archives publiques, placez-vous dans le répertoire /var/www/laabs/src/ext et récupérez les sources grâce à la commande git.

cd /var/www/laabs/src/ext
git clone https://labs.maarch.org/maarch/archivesPubliques.git archivesPubliques

Les sources de l'extension sont maintenant disponibles dans le répertoire archivesPubliques.

Pour la suite de cette installation nous considérerons que l'instance de l'application avec l'extension 'Archives publiques' sera nommée "maarchrmap" ('AP' pour Archives Publiques)

Création de la base données Archives publiques

Créez une nouvelle base de données pour l'instance Archives publiques

su postgres

psql

CREATE DATABASE "maarchRMAP" WITH OWNER maarch;
\q

exit

Ici la base de données s'appelle donc "maarchRMAP" et l'utilisateur 'maarch' est administrateur de celle-ci.

Rendez vous dans le répertoire contenant les scripts de base de données

cd /var/www/laabs/src/ext/archivesPubliques/data/batch/pgsql

Rendez les scripts executables :

chmod +x *.sh

Créez les tables de la base de données :

./schema.sh -u=maarch -p=5432 -d="maarchRMAP" -h=127.0.0.1

En ce qui concerne les données, deux options s'offrent à vous.

Vous pouvez exécuter ce script qui créera un jeu de données correspondant au guide de visite (conseillé pour une première expérience avec Maarch RM) :

./data.sh -u=maarch -p=5432 -d="maarchRMAP" -h=127.0.0.1  

ou ce script qui créera uniquement les données minimales permettant le bon fonctionnement de l'application en production :

./data.min.sh -u=maarch -p=5432 -d="maarchRMAP" -h=127.0.0.1  

NB : Les paramètres des scripts sont les suivants :

  • -u : L'utilisateur étant administrateur de la base de données (maarch par défaut)
  • -p : Le port de connexion au serveur de base de données (5432 par défaut)
  • -d : Le nom de la base de données entre guillemets ("maarchRMAP" par défaut)
  • -h : L'adresse ip du serveur de la base de données (127.0.0.1 par défaut)

Préparation de fichiers de configuration

Copiez les modèles de configuration suivants et enlevez leurs extensions .default pour que l'application puisse y accéder.

cp /var/www/laabs/src/ext/archivesPubliques/data/conf/configuration.ini.default /var/www/laabs/src/ext/archivesPubliques/data/conf/configuration.ini
cp /var/www/laabs/src/ext/archivesPubliques/data/conf/confvars.ini.default /var/www/laabs/src/ext/archivesPubliques/data/conf/confvars.ini
cp /var/www/laabs/src/ext/archivesPubliques/data/conf/vhost.conf.default /var/www/laabs/src/ext/archivesPubliques/data/conf/vhost.conf

Configuration Apache

Créez une configuration Apache pour directement inclure le fichier de configuration de l'hôte virtuel livré :

echo "Include /var/www/laabs/src/ext/archivesPubliques/data/conf/vhost.conf" > /etc/apache2/sites-available/maarchRMAP.conf

Éditez le fichier de configuration que vous venez d'inclure (/var/www/laabs/src/ext/archivesPubliques/data/conf/vhost.conf) et modifiez les valeurs si elles sont différentes de celles par défaut.

# Chemin vers le répertoire public web de Laabs
DocumentRoot /var/www/laabs/web/
# Nom du vhost (identique au nom associé à l'adresse IP dans le fichier host)
ServerName maarchrmap

Se reporter à la page de configuration pour une description complète des variables et personnaliser ces valeurs si besoin.

Activation du nouveau VirtualHost

a2ensite maarchRMAP

Relancez Apache :

service apache2 restart

Éditez le fichier de configuration confvars.ini se situant dans /var/www/laabs/src/ext/archivesPubliques/data/conf contenant les variables d'accès à la base de données PSQL, et remplacez les par vos valeurs.

@var.dsn = "pgsql:host=localhost;dbname=maarchRMAP;port=5432" 
@var.username = maarch 
@var.password = maarch

Le fichier de configuration principal est nommé "configuration.ini". Voir l'article consacré à la configuration configuration pour une description détaillée des directives.

Connexion à l'application

Fichier hosts

Ajoutez dans le fichier hosts du système qui doit accéder à l'application les coordonnées du serveur :

  • Sous Linux: /etc/hosts
  • Sous Windows : C:\windows\system32\drivers\etc\hosts

    127.0.0.1 maarchrmap

Bravo !

L'installation est terminée, et l'application est maintenant accessible depuis un navigateur internet.

Avec notre exemple :

http://maarchrmap/

L'administrateur général est 'superadmin', mot de passe 'superadmin'.

Si vous utilisez le jeu de données intitulé data.sh, l'administrateur fonctionnel est 'nnataly', mot de passe 'maarch'. Cependant si vous intégrez le jeu de donnée minimal (data-min.sh), vous devrez créer vous même un administrateur fonctionnel dans l'application.

Tous les autres utilisateurs livrés dans les données d'exemple ont pour mot de passe par défaut 'maarch'.

Rappel : Cette documentation permet uniquement l'installation de l'extension Archives Publiques. Pour l'installation du socle d'archivage, merci de vous référer à sa Documentation

Se reporter aux guides de visite pour prendre connaissance des grandes fonctionnalités de Maarch RM

results matching ""

    No results matching ""