Installation

GixSQL est distribué sous forme de code source. Ce chapitre explique comment le compiler et l’installer sous GNU/Linux. La compilation pour Windows (Visual Studio ou MSYS2/MinGW) est décrite dans Compilation sous Windows.

Prérequis

Pour compiler GixSQL, il faut :

  • un compilateur C++17 (GCC 8 ou plus récent, ou Clang) ;
  • les autotools (autoconf, automake, libtool) et pkg-config, pour compiler depuis le dépôt git ;
  • bison 3.7 ou plus récent et flex ;
  • le paquet de développement de spdlog (et de fmt, sa dépendance) ;
  • pour chaque pilote de base de données souhaité, le paquet de développement de sa bibliothèque cliente :
Pilote Paquet Debian/Ubuntu Remarques
pgsql libpq-dev
mysql libmariadb-dev (ou libmysqlclient-dev)
odbc unixodbc-dev plus le pilote ODBC de la base de données
oracle aucun pour la compilation les bibliothèques clientes Oracle (Instant Client) sont nécessaires à l’exécution
sqlite aucun SQLite est intégré

Sous Debian ou Ubuntu :

$ sudo apt install build-essential autoconf automake libtool pkg-config \
    bison flex libspdlog-dev libfmt-dev \
    libpq-dev libmariadb-dev unixodbc-dev

Pour exécuter les programmes, il faut aussi GnuCOBOL (cobc et libcob).

Compilation depuis le dépôt git

$ git clone https://github.com/superbol4gnucobol/gixsql-superbol.git
$ cd gixsql-superbol
$ autoreconf -fi
$ mkdir _build && cd _build
$ ../configure --prefix=/opt/gixsql
$ make
$ sudo make install

Les fichiers générés par les autotools ne sont pas stockés dans le dépôt : autoreconf -fi est toujours nécessaire après un clone.

Options de configuration

Par défaut, configure compile le précompilateur et chaque pilote dont la bibliothèque cliente est trouvée. Les options suivantes modifient ce comportement :

Option Effet
--enable-gixpp / --disable-gixpp compiler le précompilateur gixpp (par défaut : oui)
--disable-pgsql ne pas compiler le pilote PostgreSQL
--disable-oracle ne pas compiler le pilote Oracle
--disable-mysql ne pas compiler le pilote MySQL/MariaDB
--disable-odbc ne pas compiler le pilote ODBC
--disable-sqlite ne pas compiler le pilote SQLite
--with-default-driver=DRIVER pilote utilisé lorsque la chaîne de connexion n’en nomme aucun : none (par défaut), pgsql, oracle, mysql, odbc, sqlite (voir Le pilote par défaut)

Lorsqu’un pilote est explicitement activé (--enable-pgsql) et que sa bibliothèque cliente est absente, configure échoue ; sinon, le pilote est ignoré silencieusement. Vérifiez le résumé affiché à la fin de configure.

Par exemple, pour compiler uniquement le précompilateur :

$ ../configure --disable-mysql --disable-odbc --disable-pgsql \
               --disable-oracle --disable-sqlite --enable-gixpp

Pour compiler la bibliothèque d’exécution avec PostgreSQL et Oracle seulement :

$ ../configure --prefix=/opt/gixsql --disable-mysql --disable-odbc --disable-sqlite

Fichiers installés

Avec --prefix=/opt/gixsql, make install installe :

Fichier Description
bin/gixpp le précompilateur
lib/libgixsql.so la bibliothèque d’exécution, liée aux programmes
lib/libgixsql-<driver>.so les pilotes de bases de données, chargés à l’exécution
share/gixsql/copy/SQLCA.cpy le copybook SQLCA
NoteÀ vérifier

Vérifier la liste exacte et les chemins des fichiers installés (make install DESTDIR=...).

À l’exécution, libgixsql charge le pilote libgixsql-<driver>.so avec dlopen : le répertoire lib doit se trouver dans le chemin de recherche des bibliothèques, par exemple :

$ export LD_LIBRARY_PATH=/opt/gixsql/lib:$LD_LIBRARY_PATH

Compilation avec Nix

Le dépôt contient un flake Nix :

$ nix build .#runtime     # the runtime, with the Oracle and PostgreSQL drivers
$ nix build .#gixpp       # the precompiler only
$ result/bin/gixpp --version

Compilation sous Windows

Visual Studio

Le fichier de solution gixsql.sln compile GixSQL avec Visual Studio 2019 ou plus récent. Les dépendances sont attendues depuis vcpkg :

> vcpkg install libpq:x64-windows libmariadb:x64-windows fmt:x64-windows-static-md spdlog:x64-windows-static-md

MSYS2/MinGW

Le script configure fonctionne aussi sous MSYS2, avec les paquets :

$ pacman -S mingw-w64-x86_64-pkg-config autoconf make automake libtool bison flex \
    mingw-w64-x86_64-gcc mingw-w64-x86_64-postgresql mingw-w64-x86_64-libmariadbclient \
    mingw-w64-x86_64-unixodbc mingw-w64-x86_64-spdlog
Avertissement

Les compilations sous Windows ne sont pas testées par les mainteneurs de SuperBOL.

Vérification de l’installation

$ gixpp --version
gixpp - the ESQL preprocessor for Gix-IDE/GixSQL
Version: 1.0.21dev
libgixpp version: 1.0.21dev

La suite de tests du précompilateur utilise autofonce : depuis le répertoire des sources, après la compilation dans _build, lancez autofonce run.