Document d'installation : FHoSS
Logiciel requis pour l'installation du FHoSS sur le serveur : MySQL
Subversion
Ant
JDK v1.5
libxml2-dev
Lors de l'installation, toutes les commandes importantes sont précédées de la commande sudo, permettant de donner des droits "root" à l'utilisateur courant. En effet, certaines opérations nécessitent ces droits.
Première partie : récupération des fichiersProgrammes requis : Subversion.La récupération de fichiers se fait avec le logiciel subversion. Celui-ci permet d'utiliser des dépôts par le biais du réseau.
Pour récupérer ces fichiers, et installer le code sans modifier les fichiers de configuration, il faut créer les répertoires suivant.
sudo mkdir /opt/OpenIMSCore
sudo mkdir opt/OpenIMSCore/FHoSSEnsuite, il faut se placer dans le répertoire que nous venons de créer :
cd /opt/OpenIMSCore/Pour terminer, il faut lancer la commande de récupération des données :
sudo svn checkout http://svn.berlios.de/svnroot/repos/openimscore/FHoSS/trunk FHoSSLes fichiers sont rapatriés dans le répertoire FHoSS que nous venons de créer.
Deuxième partie : compilation des fichiersProgrammes requis : Ant, javac, java.1. génération du codeLe lancement de la compilation commence par une génération de fichiers. La commande à effectuer est :
sudo ant genErreur rencontrée :Lors du lancement de la génération de fichier, une exception est apparue à propos d'un fichier : xml.xsd. (voir copie d'écran ci-dessous)
Après une recherche d'information dans la mailing-list de FOKUS, il m'est apparu que ce problème était déjà arrivé.
Solution :Pour que cette erreur n'arrive pas, il faut mettre en commentaire une certaine ligne située dans le fichier "xsd/ZhDataType.xsd"
D'après les développeurs, cette ligne ne servirait qu'a faire des vérification de schéma XML, n'affectant absolument pas le code généré.
>After I comment out this line, FHoSS can be compiled successfully. Do you think if this will cause some side effects during test run?
>No, it will not cause side effects. That schema is used by castor when is generating the additional classes for Zh data types, but I think that the xml.xsd schema is used only to make some validation stuff.
2. CompilationApres la génération du code, on poursuit sur la compilation à proprement parler. La commande à effectuer (Depuis le dossier /opt/OpenIMSCore/FHoSS comme pour la génération) est la suivante :
sudo ant compileLa compilation s'effectue sans problèmes, quelques warning sans importants peuvent se produire.
3. déploiementLa dernière partie de la compilation consiste en une création de fichiers jar. Utiliser la commande :
sudo ant deploy
Pas de problèmes rencontrés.
Troisième partie : Configuration de l'environnementLire la documentation sur l'installation et la configuration du serveur DNS bind9.
La configuration du FHoSS est simple, elle consiste à entrer des valeurs dans la base de donnée.
Pour cela, des fichiers .sql sont préfabriqués : voici les commandes à effectuer :
mysql -u root -p -h localhost "flèche pointant vers la gauche" FHoSS/scripts/hssdb.sqlmysql -u root -p -h localhost "flèche pointant vers la gauche" FHoSS/scripts/userdata.sqlOn peut vérifier que les tables ont bien été créées :
hss@hss-desktop:/opt/OpenIMSCore$
mysql -u root –pmysql>
show databases;mysql>
use hssdbmysql>
show tables;