Pré-requis déclaration des variables d'environnement nécessaire à l'exécution des serveurs Il est nécessaire d'avoir un JRE6 ou JAVA6 minimum d'installé sur le poste. Spiral utilise actuellement la release 1.0 de Red5 (0.8 pour les versions ultérieures de Spiral COnnect 3.6.4), et JBoss 5.1 Jboss et Red5 sont 2 serveurs indépendants, et peuvent être placés sur des machines différentes. Copier le JBoss avec les packages Spiral+librairies et le Red5 aux emplacements voulus. Une copie de fichiers suffit, les serveurs sont multi-os (testé sous Windows, OSX et Linux/Unix). Exemple sous Windows : 1. Déclarer la variable d'environnement JAVA_HOME en précisant la racine du dossier: Ex : C:\Program Files\Java\jre6 Red5 l'utilise et provoque une erreur au lancement si mal déclaré 2. Déclarer la variable d'environnement JBOSS_HOME en précisant la racine du dossier: Ex : C:\jboss-5.1.0.GA 3. Déclarer les 2 variables dans le PATH en pointant sur le \bin du JRE: %JAVA_HOME%\bin;%JBOSS_HOME%; Librairies spécifiques JBoss Les librairies spécifiques JBoss utilisées pour Spiral Connect sont à placer dans : \jboss\server\default\lib Au 1 er mars 2012, 59 librairies batik-anim-1.7.jar batik-awt-util-1.7.jar batik-css-1.7.jar batik-dom-1.7.jar batik-ext-1.7.jar batik-parser-1.7.jar batik-svg-dom-1.7.jar batik-util-1.7.jar batik-xml-1.7.jar commons-beanutils-1.8.0.jar commons-codec-1.3.jar commons-fileupload-1.2.jar
commons-io-1.3.2.jar commons-io-1.4.jar commons-lang-2.4.jar core-renderer-r8pre2.jar dom4j-1.6.1.jar flex-messaging-common.jar flex-messaging-core.jar flex-messaging-opt.jar flex-messaging-proxy.jar flex-messaging-remoting.jar geronimo-stax-api_1.0_spec-1.0.jar hibernate-c3p0-3.3.1.ga.jar hibernate-search-3.1.1.ga.jar htmlcleaner-2.2.jar itext-2.0.8.jar itextasian-1.5.2.jar JAXB2_20091104.jar jcommon-1.0.16.jar jdom-1.1.jar jdom.jar jericho-html-3.1.jar jeuclid-core-3.1.8.jar jfreechart-1.0.13.jar joda-time-1.6.2.jar jtds-1.2.5.jar liste.txt lucene-core-2.9.4.jar msbase.jar mssqlserver.jar msutil.jar mysql-connector-java-5.1.14-bin.jar ojdbc14.jar org.apache.commons.lang_2.1.0.v200803061811.jar poi-3.6.jar poi-ooxml-3.6.jar poi-ooxml-schemas-3.6.jar rome-0.9.jar solr-common-1.3.0.jar solr-core-1.3.0.jar solr-lucene-analyzers-1.3.0.jar solr-lucene-snowball-1.3.0.jar solr-lucene-spellchecker-1.3.0.jar sqljdbc4.jar stax-api-1.0.1.jar xml-apis-1.3.04.jar xml-apis-ext-1.3.04.jar xmlbeans-2.3.0.jar xmlgraphics-commons-1.3.1.jar *installation de la police spécifique Arial TTF pour export PDF Choix du SGDB Les dialectes actuellement supportés par la configuration Hibernate de Spiral sont: mysql-ds.xml msslq_ds.xml oracle-ds.xml
1. Créer un schéma (ou une base de données) dédié à Spiral avant de lancer JBoss. Le nom de ce schéma sera à préciser dans les fichiers de configuration Spiral. 2. Il est aussi nécessaire de préciser le type du dialecte utilisé dans les fichiers de configuration. 3. UFT-8 pour support multi langages (à la création des tables ou du schéma) NB: il est important de vérifier si le SGBD est configuré en Case Insensitive pour les noms de table. La création des tables, ainsi que la gestion de la base de données sont entièrement gérées par Hibernate. Il est arrivé (sous Unix) que la création des tables soient en camelcase alors qu'hibernate tente d'accéder à des tables en minuscase. Paramètres dans les fichiers de configuration Le paramétrage de la plateforme se situe dans ces 5 fichiers : spiral-config.jar/spiral.xml spiral-api.jar/meta-inf/persistence.xml spiral.war/im-config.xml spiral.war/servers.xml spiral-root.war/webapp/js/server/server.js Pour connaître le détail de chacun des fichiers, veuillez vous reporter à l annexe. spiral-config.jar/spiral.xml Le plus gros fichier de configuration. Précise le domaine de l instance, son nom, les paramètres e-mail, les chemins vers Red5, la connexion pour la BD Tracking, les outils à activer ou non, et les param de base de l instance. Liste des balises : Catégorie Application : Version : indique le numéro de version de votre spiral (cf changelog). Name et description : information relative a votre instance. Domain : domain de votre server, pour lyon1 spiralconnect.univ-lyon1.fr Cookie_domain : domain de portée des cookie du serveur, pour lyon1.univ-lyon1.fr Application_name : nom de l application flex Instance_name : nom de votre instance, utilisé pour le stockage des fichiers, la connexion a red5, etc Eval : indique si votre spiral est une plateforme d évaluation. Authentification, max : nombre maximum d essai de log avant blocage du compte Authentification, timelock : temps de blocage des comptes en seconde User, default_template : pas encore utilisé
User, default_culture : la culture par défaut à la création d un nouveau compte utilisateur. User, email_notification : les nouveaux comptes acceptent par défaut l envoi de mail sur leur adresse mail. User, open_brick_in_blank : les nouveaux comptes ouvrent par défaut les briques spiral dans un page _blank Usergroup, authorize_creation : Les admins de l instance peuvent créer des grand groupes sur la plateforme. Usergroup, authorize_apogee_search : L instance est relié a apogée pour l inscription d utilisateur. Les responsables de modules peuvent rechercher un groupes sur apogée (UFR, Licences, parcours, etc) pour l inscrire sur à son module. Usergroup, authorize_self_group_inscription : Authorize les utilisateurs à choisir un grand groupe lors de la création de compte sur la page d accueil. Authsource, hash_method : méthode de cryptage des mots de passe utilisateur Session, timeout : temps de vie d une session entre deux actions utilisateurs (en minute). Brick_enabled : Liste de balise correspondant aux noms des briques. Cette liste définie quelles sont les briques actives sur l instance. Pdf_font_path : chemin physique vers la police utilisé pour la création des pdf. Period_enabled : definit si la plateforme a accès a l ouverture par période. Cas, domain : url du serveur d authentification CAS. Pour Lyon1 : https://cas.univ-lyon1.fr Cas, port : port sur serveur d authentification CAS Catégorie Mail : Smtp : domain du serveur smtp Port, port du serveur smtp User : login pour le serveur smtp Password : mot de passe pour le serveur smtp Email : email de la plateforme Catégorie bdd : Path : chemin vers le dossier représentant la base de donnée multimédia oldspiralpath : utilisé pour la migration d une instance classique vers l instance connect.
Webaccess : url de sortie web du dossier représentant la base de donnée multimédia. Pour Lyon1 http://spiralconnect.univlyon1.fr:5080/videostream/streams/ Catégorie tracking_bdd : Tracking_enabled : indique si le suivi est activé. (Enregistre les actions effectuées par les utilisateurs sur la plateforme) Catégorie trombinoscope : useravatarpath : Chemin physique vers le dossier comprenant les photos étudiante nommé par le numéro étudiant correspondant. usestudentpersonalavatar : définit si la photo personnel de l étudiant est prioritaire sur la photo fournit par l administration. Catégorie portfolio : Portfolio_enabled : défini si les portfolios sont activés pour cette instance. spiral-api.jar/meta-inf/persistence.xml Contient le type de dialecte SGDB, la liste des classes et le jta-data-source Les balises importantes sont : <jta-data-source>java:/test/jta-data-source> Faisant référence à une source de donnée décrite dans mysql-dsxml ou mssql-ds.xml (pour mysql ou mssql) Puis dans la balise properties, puis <property name="hibernate.dialect" value="xxx" /> Le champ «value» indique le dialect utilisé pour communiquer avec la bdd org.hibernate.dialect.sqlserverdialect pour mssql org.hibernate.dialect.mysqldialect pour mysql org.hibernate.dialect.oracledialect pour oracle org.hibernate.dialect.hsqldialect pour hsql spiral.war/im-config.xml Fichier présent dans le client Flex (spiral.war). Configuration Red5 pour l Instant Messenger. spiral.war/servers.xml Fichier présent dans le client flex (spiral.war). Liste des chemins physiques des différentes fonctionnalités spiral-root.war/webapp/js/server/server.js Précise l URL du serveur pour les outils Spiral HTML Deux champs sont à renseigner : serverpath : url vers le serveur. Pour lyon1 http://spiralconnect.univ-lyon1.fr
secureserverpath : url sécurisée vers le serveur. Sin on n utilise pas de sécurisation il faut renseigner la meme chose que pour serverpath. Et pour la personnalisation de la page d accueil de l instance : spiral-root.war/index.html spiral-root.war/webapp/css/home/*.* spiral-root.war/webapp/js/home/*.* Démarrage des serveurs Il est possible d'automatiser le lancement des serveurs en les transformant en services. Cette solution a l avantage de laisser au système d exploitation le soin du démarrage automatique des serveurs après un reboot par exemple. Démarrer Red5 avec : red5.bat ou red5.sh Par défaut le serveur utilise le port 5080. Il est possible de contrôler son bon démarrage à l'adresse http://localhost:5080 Démarrer JBoss avec : run.bat ou run.sh Au démarrage de JBoss, les tables manquantes en base de données seront créées. NB: il est important de vérifier si le SGBD est configuré en Case Insensitive pour les noms de table. La création des tables, ainsi que la gestion de la base de données sont entièrement gérées par Hibernate. Il est arrivé (sous Unix) que la création des tables soient en camelcase alors qu'hibernate tente d'accéder à des tables en minuscase.