De Cantine - Documentation.

Base de données

Cantine fonctionne avec deux moteurs de base de données différents : MySQL et HsqlDB.
MySQL est plus rapide que HsqlDB à l'utilisation, mais nécessite l'installation préalable d'un serveur. HsqlDB est quant à lui entièrement intégré à Cantine et ne requiert aucune installation ni configuration supplémentaire.

MySQL

MySQL est un serveur de base de données Open Source très répandu. MySQL 5 est le moteur sélectionné par défaut lors de l'installation du logiciel.

Consultez le guide d'installation de MySQL pour Linux pour la procédure à suivre afin d'installer un serveur MySQL sur votre ordinateur.

L'initialisation de la base de données se lance à la fin de l'installation du logiciel.

HsqlDB

HsqlDB est un moteur de base de données écrit en Java. Son utilisation ne requiert pas d'installation ou de configuration préalable.

Tout ce que vous aurez à faire, c'est de sélectionner l'entrée HsqlDB lors de l'installation, puis d'initialiser la base.

Installation de Cantine

Machine virtuelle Java

Cantine est un logiciel écrit en Java qui nécessite donc une machine virtuelle Java fonctionnelle sur votre ordinateur.

Vous devrez donc posséder une machine virtuelle Java. Si ce n'est pas déjà le cas, rendez-vous sur [http//www.java.com le site de Java], téléchargez et installez-le.

Si vous utilisez Fedora, CentOS ou RHEL, vous pouvez vous référer au tutoriel d'installation Java sur la documentation francophone de Fedora. Pour les autres distributions, les informations de ce tutoriel fonctionneront peut-être, sinon référez-vous à la documentation de votre distribution.

Une fois votre machine virtuelle installée, décompactez l'archive tar bzippée que vous aurez préalablement téléchargée :

tar jxvf cantine_{version}.tar.bz2

Où {version} correspond à la version téléchargée.

Cantine 1.0.x

Les versions 1.0 de Cantine ne possédaient pas de système d'installation. Une fois l'archive décompactée, il suffisait de lancer le programme, depuis le dossier créé :

java -jar cantine.jar

Cantine 1.1.x

À compter de la version 1.1RC1 de Cantine, un programme d'installation graphique est fourni pour Linux. La base de données par défaut est MySQL, il vous faudra donc l'initialiser après l'installation.

Choix de la langue d'installation

Chemin de l'installation

Choix des composants

Les composants se présentent comme suit :

• Cantine : base du logiciel, indispensable ;-)
• Librairies : diverses bibliothèques nécessaires au fonctionnement de l'application. Normalement ce composant devrait toujours être installé
• Impressions : fichiers des impressions. Devrait toujours être sélectionné sauf en cas de mise à jour si les modèles de base ont été modifiés pour convenir à vos besoins particuliers
• Modèles impressions : modèles des impressions. Vous permet de modifier les modèles d'impression pour convenir à vos besoins particuliers
• Initialisation MySQL : installation des fichiers nécessaires au fonctionnement de Cantine avec MySQL
• Initialisation HSQL : installation des fichiers nécessaires au fonctionnement de Cantine avec HsqlDB
• Sources du programme : code sources de la version de Cantine que vous installez.

Une fois l'installation terminée, il est conseillé d'utiliser le programme de mise à jour fourni avec Cantine, sauf si vous désirez employer les scripts SQL fournis et disponibles dans le dossier files du répertoire d'installation du programme.

Pour lancer le programme de mise à jour (depuis le répertoire d'installation de Cantine) :

java -jar xtnd_db_updater.jar

Vous pourrez suivre ensuite les instructions d'Initialisation et mise à jour des données.

Il est également possible d'initialiser la base MySQL sans utiliser le programme de mise à jour.