Pré-requis
- un serveur BigBlueButton (testé avec les versions 0.7+ et 0.8).
- une base de données (mysql de préférence)
- un serveur smtp pour l'envoi des notifications et des invitations
- un annuaire ldap pour récupérer les noms et adresses email de l'auteur et des participants.
- un portail esup/uportal
Installation
Créer une base de données
La portlet utilise une base de données pour persister les informations des conférences et des invitations. Vous devez une créer une base et un utilisateur possédant les droits d'administrateur sur cette base. Pour la suite, nous prendrons l'exemple d'une BDD mysql appelée esup_bbb avec un utilisateur admin.
Installation à partir du war
- Déposer le fichier
esup-portlet-bigbluebutton-x.x.x.war sur le serveur dans /tmp par exemple. - Déployer la portlet à partir des sources du portail :
cd /usr/local/esup/esup-package
ant portlet.deploy -DportletApp=/tmp/esup-portlet-bigbluebutton-x.x.x.war
- Créer un nouveau context pour l'application dans le fichier
conf/server.xml de Tomcat :
<Context path="/esup-portlet-bigbluebutton" docBase="/usr/local/esup/webapps/esup-portlet-bigbluebutton-x.x.x" />
- Utilisez l'interface graphique d'administration pour publier la portlet.
Sur un portail esup 2.6,utilisez la commande :
ant deployPortletApp -DportletApp=/tmp/esup-portlet-bigbluebutton-x.x.x.war
A chaque déploiement du WAR, vous devrez supprimer la librairie jstl-1.2.jar du répertoire WEB-INF/lib qui entre en conflit avec celle livrée avec le portail et provoque des exceptions de type javax.servlet.ServletException : javax/el/ELException. |
Configuration
Une fois l'application déployée, vous devez la configurer en dupliquant le fichier WEB-INF/classes/properties/config.sample.properties et le renommer en WEB-INF/classes/properties/config.properties.
Vous devrez renseigner les propriétés de :
Votre serveur BBB :
- bbbserver.url : url de votre serveur BBB avec la slash de fin (par exemple http://bigbluebutton.domain.edu/bigbluebutton/)
- bbbserver.securitysalt : la clé de sécurité du serveur. Vous l'avez renseigné au moment de l'installation.
- bbbserver.logouturl l'url de déconnexion. Le créateur de la réunion sera redirigée vers cette adresse après sa déconnexion de BBB. Idéalement c'est l'adresse de la portlet.
Votre serveur smtp :
- smtp.host=mail.univ.fr
- smtp.fromEmail=franck.bordinat@univ-jfc.fr
- smtp.fromName=Esup-Portlet-Bigbluebutton
Votre serveur ldap :
Votre serveur base de données :
- jdbc.connection.driver_class=com.mysql.jdbc.Driver
- jdbc.connection.url=jdbc:mysql://localhost:3306/esup_bbb
- jdbc.connection.username=admin
- jdbc.connection.password=
- datasource.bean=JDBCDataSource
- jpa.database.type=MYSQL
Les propriétés smtp.intercept vous permettent d'intercepter tous les emails de la portlet pour la tester par exemple.
- smtp.interceptAll=true (mettre false en production)
- smtp.interceptEmail=admin@univ.fr
- smtp.interceptName=Admin
Sauvegarder le fichier et redémarrer le portail.
Personnalisation
Vous pouvez personnaliser les messages de l'interface ou le contenu des mails d'invitation en modifiant les fichiers messages_fr.properties et messages.properties qui se trouvent dans WEB-INF/classes/properties/i18n/bundles/ . Vous pouvez modifier l'affichage de la portlet en personnalisant le fichier css/main.css.