Téléchargement et préparation de l’extension

Téléchargement

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

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

Décompression

L’extension est fournie sous la forme d’un unique fichier compressé. Pour pouvoir être utilisé, ce fichier doit donc être décompressé.

Sous Windows, vous pouvez utiliser votre utilitaire de décompression préféré (Winzip, 7zip,...). Sous Unix/Linux, une commande du type

tar -xvzf emaj-<version>.tar.gz

peut être utilisée pour un fichier .tar.gz ou

unzip e-maj-<version>.zip

pour un fichier zip.

On dispose maintenant d’un répertoire emaj-<version> comprenant l’arborescence suivante :

Fichiers Usage
sql/emaj–2.1.0.sql script d’installation de l’extension (vers. 2.1.0)
sql/emaj–2.0.1–2.1.0.sql script d’upgrade de l’extension de 2.0.1 vers 2.1.0
sql/emaj–2.0.0–2.0.1.sql script d’upgrade de l’extension de 2.0.0 vers 2.0.1
sql/emaj–1.3.1–2.0.0.sql script d’upgrade de l’extension de 1.3.1 vers 2.0.0
sql/emaj–unpackaged–1.3.1.sql script de transformation en extension d’une version 1.3.1 existante
sql/emaj-1.3.0-to-1.3.1.sql script de mise à jour d’une version E-Maj 1.3.0
sql/emaj-1.2.0-to-1.3.0.sql script de mise à jour d’une version E-Maj 1.2.0
sql/emaj-1.1.0-to-1.2.0.sql script de mise à jour d’une version E-Maj 1.1.0
sql/emaj-1.0.2-to-1.1.0.sql script de mise à jour d’une version E-Maj 1.0.2
sql/emaj-1.0.1-to-1.0.2.sql script de mise à jour d’une version E-Maj 1.0.1
sql/emaj-1.0.0-to-1.0.1.sql script de mise à jour d’une version E-Maj 1.0.0
sql/emaj-0.11.1-to-1.0.0.sql script de mise à jour d’une version E-Maj 0.11.1
sql/emaj-0.11.0-to-0.11.1.sql script de mise à jour d’une version E-Maj 0.11.0
sql/emaj_demo.sql script psql de démonstration d’ E-Maj
sql/emaj_prepare_parallel_rollback_test.sql script psql de test pour les rollbacks parallélisés
sql/emaj_uninstall.sql script psql de désinstallation
README.md documentation réduite de l’extension
CHANGES.md notes de versions
LICENSE information sur la licence utilisée pour E-Maj
AUTHORS identification des auteurs
META.json données techniques destinées à PGXN
emaj.control fichier de contrôle utilisé par la gestion intégrée des extensions
doc/Emaj.<version>_doc_en.pdf documentation en anglais de l’extension E-Maj
doc/Emaj.<version>_doc_fr.pdf documentation en français de l’extension E-Maj
doc/Emaj.<version>_pres.en.pdf présentation en anglais de l’extension E-Maj
doc/Emaj.<version>_pres.fr.pdf présentation en français de l’extension E-Maj
php/emajParallelRollback.php client php pour les rollbacks parallélisés
php/emajRollbackMonitor.php client php pour le suivi des rollbacks

Préparation du fichier emaj.control

A partir de la version 2.0.0, l’installation d’E-Maj dans les databases PostgreSQL s’effectue sous la forme d’une EXTENSION.

Mais pour qu’E-Maj soit connu du gestionnaire intégré des extensions, un fichier emaj.control doit être positionné dans le répertoire SHAREDIR de la version de PostgreSQL.

Pour ce faire :

  • Identifier l’emplacement précis du répertoire SHAREDIR de votre installation en utilisant la commande shell

    pg_config --sharedir
    
  • Copier le fichier emaj.control fourni dans le répertoire racine de la version décompressée vers le répertoire SHAREDIR,

  • Adapter la directive directory du fichier emaj.control pour spécifier le répertoire sql contenant les scripts d’installation d’E-Maj.