Ces ressources vous permettront une prise en main plus rapide de la plateforme Sakai OAE. Vous trouverez pas mal de comple?ments d'informations dans les autres pages du wiki.
Sling
Sakai OAE est ba?ti sur le framework Apache Sling. Il est alors bon d'en savoir plus et d'en connai?tre un minimum sur son fonctionnement.
? http://en.wikipedia.org/wiki/Apache_Sling
? http://sling.apache.org/
? http://dev.day.com/docs/en/cq/current/developing/the_basics.html (tout n'est pas essentiel !)
Un ancien tuto pour Nakamura vraiment inte?ressant :https://confluence.sakaiproject.org/display/KERNDOC/Your+First+Day+With+Sakai+Nakamura
Les projets de Sakai OAE
Sakai OAE se de?coupe en plusieurs projets dont les deux premiers sont indispensables :
? 3akai-Ux (Frontend) : L'interface de Sakai OAE incluant les fichiers JavaScript, HTML et CSS.
? nakamura (Backend) : Le moteur de Sakai OAE en Java, tournant sur un framework OSGi
(Apache Sling).
? sparsemapcontent : An open source sparse hash column oriented data storage layer. Si vous
utilisez une base Oracle pour le stockage, vous aurez besoin de compiler les drivers Oracle avec
sparsemapcontent.
? solr : Configuration solr personnalise?e pour la fonction recherche. Solr est fourni avec Nakamura.
Le de?po?t se?pare? fourni des outils pour installer un serveur solr autonome dans une architecture multinoeud.
Petite pre?sentation
Une bonne petite pre?sentation d'OAE cible?e de?veloppeur est disponible depuis peu :http://www.slideshare.net/bertpareyn/oae-developer-bootcamp
L'architecture de la plateforme est compose?e essentiellement de :
“Some key OAE technologies in the stack”, issue de “Sakai OAE Deployment and Management”, page 42
De?velopper sur Nakamura
Issues de la page de la documentation Nakamura officielle, prenez connaissance de Nakamura Boot Camp et Developers Guides.
On retrouve mainte et mainte fois dans la documentation des instructions pour de?marrer/installer Sakai OAE, depuis les sources ou pas. Dans notre cas, pre?fe?rez compiler a? partir des sources, utiliser Git, et mettre en place 3akai-Ux comme indique? sur les Notes d'installation Sakai OAE avec MySQL. Vous n'e?tes pas oblige? d'utiliser MySQL, si vous ignorez cette partie, Sakai OAE utilisera automatiquement Derby 1.
La mise en place de votre environnement de de?veloppement pour Nakamura est mentionne?e dans Nakamura Boot Camp. Eclipse est l'outil conseille? avec ses puissants plugins de de?bogage. Pour travailler sur tel ou tel bundle de Sakai OAE, j'ai personnellement ge?ne?re? un projet Eclipse a? partir du bundle a? l'aide de mvn eclipse:eclipse avant de l'importer dans mon environnement de travail.
De?velopper sur 3akai-Ux
Il est juste ne?cessaire de mettre en place 3akai-Ux. Utilisez ensuite votre e?diteur favori pour e?diter les fichiers .html, .css et .js. Rendez-vous dans la documentation officielle (liens ci-dessous).
Documentation officielle
Me?fiez-vous de la documentation ! Oui faites attention, les pages ne sont pas toujours a? jour.
? https://confluence.sakaiproject.org/display/KERNDOC/Nakamura+Documentation ? https://confluence.sakaiproject.org/display/3AK/OAE+Home
? http://oae-widgets.sakaiproject.org/sdk
Autres ressources
Le Github du projet est une ve?ritable mine d'information ! https://github.com/sakaiproject/ Certaines informations peuvent e?galement e?tre trouve?es sur :
? Mailing Lists : http://collab.sakaiproject.org/mailman/listinfo
? Communaute? : https://oae-community.sakaiproject.org/
? Sakai IRC : https://confluence.sakaiproject.org/display/3AK/IRC+Guide
? Jira : https://jira.sakaiproject.org/secure/Dashboard.jspa
Quelques forks GitHub d'universite?s :
? New-York University : https://github.com/nyuatlas/
? University of Cambridge : https://github.com/caret/
? University of California (“online education initiative”) : https://github.com/UCOnline/
? Berkeley – University of California : https://github.com/ets-berkeley-edu/
? https://github.com/rSmart/
Gestion des logs !
Les logs sont ge?re?s par Sling 2 et sont enregistre?s dans sling/logs de votre re?pertoire Nakamura.
Il est possible de personnaliser le niveau de log (Trace, Debug, Info, Warnings, Errors) et de cibler le package voulu. Pour le faire sur l'authentification CAS, allez dans votre console Sling, onglet Configuration, repe?rez Apache Sling Logging Logger Configuration et cliquez sur le signe + pour ajouter une nouvelle entre?e.
Apre?s avoir choisi le niveau de log, le nom du fichier, renseignez le logger qui est dans notre cas org.sakaiproject.nakamura.auth.cas
De?sactivation du cache
En mode de?veloppement, vous pouvez de?sactiver le cache via votre console Sling, onglet Configuration, repe?rez org.sakaiproject.nakamura.http.cache.CacheControlFilter.name et changez disable.cache.for.dev.mode.name.
N'oubliez pas de de?sactiver la fonction cache de votre navigateur si vous de?veloppez sur 3akai-Ux.
1) Apache Derby
2) Sling logging - http://sling.apache.org/site/logging.html