Installation du logiciel E-Maj

Source de téléchargement

E-Maj est disponible en téléchargement sur le site Internet PGXN (https://pgxn.org/dist/e-maj/).

E-Maj et ses compléments sont également disponibles sur le site Internet github.org :

Composants sources (https://github.org/dalibo/emaj)
Documentation (https://github.com/beaud76/emaj_doc)
Interface graphique Emaj_web (https://github.com/dalibo/emaj_web)

Prudence

Installer l’extension à partir du dépôt github.org crée l’extension en version de développement (« devel »), même en téléchargeant une version “taguée”. Il sera alors impossible de procéder à des mises à jour de l’extension dans le futur. Pour une utilisation dans la durée, il est fortement recommandé d’utiliser les paquets versionnés disponibles sur PGXN.

Installation standard sur Linux

Avec le client pgxn

Si le client pgxn est installé, une simple commande suffit :

pgxn install E-Maj --sudo

Sans le client pgxn

Téléchargez la dernière version d’E-Maj depuis le site pgxn.org, par un moyen à votre convenance, par exemple avec la commande wget

wget https://api.pgxn.org/dist/e-maj/<version>/e-maj-<version>.zip

Puis décompressez l’archive et installer les composants avec les commandes

unzip e-maj-<version>.zip

cd e-maj-<version>/

sudo make install

Localisation des composants

Dans les 2 cas de figure, les composants sont installés dans les répertoires usuels des composants PostgreSQL. En particulier :

les scripts SQL sont dans <répertoire_SHAREDIR>/emaj/
les clients en mode ligne de commande sont dans <répertoire_BINDIR>, avec les clients PostgreSQL
la documentation est dans <répertoire_DOCDIR>/emaj/

La localisation physique des répertoires SHAREDIR, BINDIR et DOCDIR sur le système peut être retrouvée à l’aide de la commande pg_config.

Installation manuelle sur Linux

Téléchargez la dernière version d’E-Maj depuis le site pgxn.org, par un moyen à votre convenance, par exemple avec la commande wget

wget https://api.pgxn.org/dist/e-maj/<version>/e-maj-<version>.zip

Puis décompressez l’archive avec les commandes suivantes :

unzip e-maj-<version>.zip

cd e-maj-<version>/

Identifiez la localisation précise du répertoire SHAREDIR. Selon l’installation de PostgreSQL, la commande pg_config –sharedir peut retourner directement le nom du répertoire. Sinon, rechercher les localisations typiques, telles que :

/usr/share/postgresql/<pg_version> pour Debian ou Ubuntu
/usr/pgsql-<pg_version>/share pour RedHat ou CentOS

Copiez quelques fichiers vers le répertoire des extensions de la version de PostgreSQL souhaitée. En tant que super-utilisateur ou en préfixant les commandes avec sudo, taper

cp emaj.control <répertoire_SHAREDIR>/extension/.

cp sql/emaj--* <répertoire_SHAREDIR>/extension/.

La dernière version d’E-Maj est maintenant installée et référencée par PostgreSQL. Le répertoire e-maj-<version> contient l’arborescence décrite ici.

Installation minimale sur Linux

Sur certains environnements (cloud de type DBaaS par exemple), il n’est pas possible d’ajouter des extensions dans le répertoire SHAREDIR. Pour ces cas de figure, on peut procéder à une installation minimale.

Téléchargez la dernière version d’E-Maj par un moyen à votre convenance, et décompressez la.

Le répertoire e-maj-<version> généré contient l’arborescence décrite ici.

La création de l’extension est alors un peu différente.

Installation sous Windows

Pour installer E-Maj sous Windows, il faut :

Télécharger l’extension depuis le site pgxn.org,
Extraire l’arborescence du fichier zip reçu,
En copier les fichiers emaj.control et sql/emaj–* dans le dossier share\extension du dossier d’installation de la version de PostgreSQL (typiquement c:\Program_Files\PostgreSQL\<version_postgres>).

Localisation alternative des scripts SQL pour les installations manuelles

Le fichier emaj.control, positionné dans le répertoire SHAREDIR/extension de la version de PostgreSQL, peut contenir une directive indiquant à PostgreSQL le répertoire dans lequel sont localisés les scripts SQL d’installation ou d’upgrade.

Il est donc possible de ne mettre dans ce répertoire SHAREDIR/extension que le seul fichier emaj.control en créant ce pointeur vers le répertoire de scripts. Pour ce faire, il faut :

Copier le fichier emaj.control fourni dans le répertoire racine de la version décompressée vers le répertoire SHAREDIR/extension,
Adapter la directive directory du fichier emaj.control pour spécifier le répertoire sql contenant les scripts d’installation d’E-Maj.