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) etpkg-config, pour compiler depuis le dépôt git ; bison3.7 ou plus récent etflex;- 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 |
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
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.