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 windows 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.
Deux solutions s'offrent à vous :

• installer une machine virtuelle Java dès maintenant. Si vous préférez cette option, rendez-vous sur [http//www.java.com le site de Java], téléchargez et installez le.
• laisser le programme d'installation s'en charger. Le programme d'installation de Cantine vérifie que la bonne version de Java est installée sur votre système. S'il n'a pas pu être trouvé, le programme vous propose de le faire à votre place. Il vous est possible de refuser, et d'effectuer l'installation de la machine virtuelle vous même.

Java n'a pas été détecté sur votre machine...

Une fois le téléchargement terminé, l'installation de Cantine se met en pause au profit de celle de Java. L'installation de Java terminée (ou annulée), l'installation de Cantine reprendra.

L'installation du logiciel est relativement simple. Lancez l'exécutable, acceptez les informations de licence, puis choisissez éventuellement les options à installer.

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 : modèles 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
• Données : choisissez ici le moteur de données que vous souhaitez utiliser. Notez qu'il n'est pas possible avec le programme d'installation Windows d'installer en même temps les deux moteurs.
  • MySQL : installation des fichiers nécessaires au fonctionnement de Cantine avec MySQL
  • 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.

Installation en cours...

Une fois l'installation terminée, il vous est proposé de lancer le programme d'initialisation et de mise à jour des bases de données.

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 répertoire d'installation du programme.