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
- Avoir validé les prérequis lors de l'installation du socle d'archivage.
- 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/thirdPartyArchiving.git thirdPartyArchiving
git clone https://labs.maarch.org/maarch/archivesPubliques.git archivesPubliques
La récupération des sources de thirdPartyArchiving est impérative pour faire fonctionner l'extension Archives publiques. 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 :
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 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