Installation de l'extension coffre fort numérique

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 coffre fort numérique

Récupération des sources

Si vous souhaitez installer l'extension coffre fort numérique, 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/digitalSafe.git digitalSafe

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

Pour la suite de cette installation nous considérerons que l'instance de l'application avec l'extension 'Coffre fort numérique' sera nommée "maarchrmccfn" ('CCFN' pour Composant de Coffre Fort Numérique)

Création de la base données Coffre fort numérique

Créez une nouvelle base de données pour l'instance Coffre fort numérique

su postgres

psql

CREATE DATABASE "maarchRMCCFN" WITH OWNER maarch;
\q

exit

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

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

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

Activation du nouveau VirtualHost

a2ensite maarchRMCCFN

Relancez Apache :

service apache2 restart

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

Bravo !

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

Avec notre exemple :

http://maarchrmccfn/

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 Coffre fort numérique. Pour l'installation du socle d'archivage, merci de vous référer à sa Documentation