|
|
## Prérequis: Java
|
|
|
HSQLDB repose sur java, il faut donc impérativement installer une version java pour lancer le serveur.
|
|
|
|
|
|
Vérifier l'installation java
|
|
|
|
|
|
$ java –version
|
|
|
|
|
|
Exemple:
|
|
|
|
|
|
dockey@beedock:/opt$ java -version
|
|
|
openjdk version "1.8.0_151"
|
|
|
OpenJDK Runtime Environment (build 1.8.0_151-8u151-b12-0ubuntu0.16.04.2-b12)
|
|
|
OpenJDK 64-Bit Server VM (build 25.151-b12, mixed mode)
|
|
|
|
|
|
Si java n'y est pas installé, une installation Libreoffice Base installe java dans ses dépendances.
|
|
|
le paquet openjdk est: "openjdk-8-jdk"
|
|
|
|
|
|
Pour Debian en backport:
|
|
|
"sudo apt-get -t jessie-backports install openjdk-8-jdk"
|
|
|
|
|
|
##Installation hsqldb server
|
|
|
Télécharger la version souhaitée auprès de:
|
|
|
https://sourceforge.net/projects/hsqldb/files/
|
|
|
|
|
|
Il semble qu'une pratique assez usuelle est de mettre l'ensemble du dossier hsqldb en tant que /opt/hsqldb/
|
|
|
Si plusieurs versions sont nécessaires ont peut avoir:
|
|
|
|
|
|
/opt/hsqldb_1_8/
|
|
|
/opt/hsqldb_2_4/
|
|
|
|
|
|
alternative en test /opt/hsqldb/ puis sous dossier par version
|
|
|
|
|
|
/opt/hsqldb/1_8_1_3/
|
|
|
/opt/hsqldb/2_4_0/
|
|
|
|
|
|
|
|
|
et avoir des instances multiples de hsqldb selon la version native de la base de données.
|
|
|
|
|
|
Un autre emplacement possible serait d'installer sous /usr/local. A décider...
|
|
|
https://unix.stackexchange.com/questions/11544/what-is-the-difference-between-opt-and-usr-local
|
|
|
|
|
|
## Démarrer hsqldb en mode serveur:
|
|
|
Il faut se placer dans le dossier contenant les fichier hsqldb (testdb.db, testdb.data, etc.)
|
|
|
|
|
|
$ cd <chemin_vers_testdb>
|
|
|
$ java -cp <chemin_vers_hsqldb>/lib/hsqldb.jar org.hsqldb.server.Server --database.0 file:testdb --dbname.0 testdb
|
|
|
|
|
|
## Tester la base avec DatabaseManager
|
|
|
Pour créer une connection avec DatabaseManager:
|
|
|
|
|
|
$ java -cp <chemin_vers_hsqldb>/lib/hsqldb.jar org.hsqldb.util.DatabaseManagerSwing
|
|
|
|
|
|
DatabaseManager se lance aussi par défaut si on exécute (par ex. par double-clic) hsqldb.jar.
|
|
|
|
|
|
##Pour connecter LibreOffice
|
|
|
Attention: il est important que la version hsqlDB soit compatible avec la base de donnée. Le client Libreoffice doit utiliser la même version que le serveur. hsqldb 1.8 ou hsqldb 2.4 par exemple.
|
|
|
|
|
|
le driver jdbc a changé de nom "org.hsqldb.jdbcDriver" est devenu "org.hsqldb.jdbc.JDBCDriver" à partir de la version 2 (à vérifier)
|
|
|
|
|
|
Il faut ajouter le .jar (/opt/hsqldb/lib/hsqldb.jar) aux préférences avancées de libreoffice base. Sans quoi le driver (org.hsqldb.jdbc.JDBCDriver) n'est pas reconnu. (Attention à synchroniser la version hsqldb avec celle du serveur).
|
|
|
|
|
|
Puis sélectionner "Nouvelle Base"
|
|
|
Utiliser JDBC
|
|
|
entrer l'adresse de connexion
|
|
|
|
|
|
(jdbc:)hsqldb:hsql://localhost/db -- le même nom que l'alias créé pour le serveur.
|
|
|
|
|
|
En cas de connexion distante remplacer localhost par l'adresse du serveur et éventuellement le numéro de port.
|
|
|
|
|
|
Exemple d'un TEST qui marche:
|
|
|
(TEST:"hsqldb:hsql://localhost/TSdb;default_schema=true;shutdown=true;hsqldb.default_table_type=cached;get_column_name=false")
|
|
|
et sous driver: "org.hsqldb.jdbc.JDBCDriver"
|
|
|
|
|
|
|
|
|
## Ref Links Instructions utiles:
|
|
|
"http://superuser.com/questions/555325/how-to-set-up-the-jdbc-driver-to-connect-to-hsqldb-from-libreoffice"
|
|
|
|
|
|
————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
|
|
|
|
|
|
## TEST sur mac (a marché)
|
|
|
- Téléchargement HSQLDB sur http://hsqldb.org/
|
|
|
- dézippé
|
|
|
- Installé dossier hsqldb/ comme /opt/hsqldb/
|
|
|
- Extraction des fichier database dans fichier.odb
|
|
|
- Renommé le contenu de “database” en préfixant tout avec “ff.”
|
|
|
- installation du contenu de database dans /opt/hsqldb/data/ffdb/
|
|
|
|
|
|
Pour démarrer l'instance hsqldb:
|
|
|
|
|
|
$ java -cp /opt/hsqldb/lib/hsqldb.jar org.hsqldb.server.Server --database.0 file:/opt/hsqldb/data/ffdb/ff --dbname.0 ffdb
|
|
|
|
|
|
Ouverture depuis Libreoffice (en local):
|
|
|
|
|
|
New database
|
|
|
|
|
|
“hsqldb:hsql://localhost/ffdb;default_schema=true;shutdown=true;hsqldb.default_table_type=cached;get_column_name=false"”
|
|
|
“org.hsqldb.jdbc.JDBCDriver”
|
|
|
|
|
|
|
|
|
Pour se connecter avec Databasemanager:
|
|
|
|
|
|
$ java -cp /opt/hsqldb/lib/hsqldb.jar org.hsqldb.util.DatabaseManagerSwing
|
|
|
|
|
|
ou double-clic sur /opt/hsqldb/lib/hsqldb.jar |