Installation de l'extension Archives Mutualisées

Cette procédure va vous guider pas à pas dans l'installation de l'extension Archives Mutualisées 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épendances

Cette extension nécessite le socle d'archivage pour pouvoir fonctionner, et doit aujourd'hui être couplée avec l'extension Archives Publiques dont la documentation est disponible ici : Installation Archives Publiques.

Déploiement de l'extension Archives Mutualisées

Récupération des sources

Si vous souhaitez installer l'extension Archives Mutualisées uniquement, 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/thirdPartyArchiving.git thirdPartyArchiving

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

Pour la suite de cette installation nous considérerons que l'instance de l'application avec l'extension 'Archives Mutualisées' sera nommée "maarchrmtpa" ('TPA' pour Third Party Archiving)

Création de la base données Archives Mutualisées

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

su postgres

psql

CREATE DATABASE "maarchRMTPA" WITH OWNER maarch;
\q

exit

Ici la base de données s'appelle donc "maarchRMTPA" 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/thirdPartyArchiving/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="maarchRMTPA" -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="maarchRMTPA" -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="maarchRMTPA" -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 ("maarchRMTP" 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/thirdPartyArchiving/data/conf/configuration.ini.default /var/www/laabs/src/ext/thirdPartyArchiving/data/conf/configuration.ini
cp /var/www/laabs/src/ext/thirdPartyArchiving/data/conf/confvars.ini.default /var/www/laabs/src/ext/thirdPartyArchiving/data/conf/confvars.ini
cp /var/www/laabs/src/ext/thirdPartyArchiving/data/conf/vhost.conf.default /var/www/laabs/src/ext/thirdPartyArchiving/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/thirdPartyArchiving/data/conf/vhost.conf" > /etc/apache2/sites-available/maarchRMTPA.conf

Éditez le fichier de configuration que vous venez d'inclure (/var/www/laabs/src/ext/thirdPartyArchiving/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 maarchrmtpa

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

Activation du nouveau VirtualHost

a2ensite maarchRMTPA

Relancez Apache :

service apache2 restart

Éditez le fichier de configuration confvars.ini se situant dans /var/www/laabs/src/ext/thirdPartyArchiving/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=maarchRMTPA;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 maarchrmtpa

Bravo !

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

Avec notre exemple :

http://maarchrmtpa/

L'administrateur fonctionnel est 'superadmin', mot de passe 'superadmin'.

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 Mutualisées. 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 ""