Sakai 10.x Guide d'installation (demo) - French demo installation guide

1.0 Get the demo


(minus) Demo limitations. The data for a demo installation is stored in a HypersonicSQL database (HSQLDB) that is stored in memory and then written out to files when Tomcat is shut down. These files are located at sakai-demo/sakai/db/sakai.db.*. Second, certain features such as e-mail and search are disabled.

Installing the Sakai Demo involves only a few steps. The most technically challenging aspect of a demo install is making sure that your Java environment is compatible with Sakai.

The latest Sakai fdemo archive is available at http://source.sakaiproject.org/release/.

Once you have downloaded the archive, choose a location to unpack the files (your home directory is fine). When unpacked you will see a directory named sakai-src. Unix/Mac users should make sure that they have write permissions to the Tomcat servlet container files and directories before proceeding or startup permission errors may occur.


2.0 Verify/Install Java 1.7


Le logiciel Sun Java SE 7, alias Java 1.7, est la version recommandée pour utiliser Sakai CLE, parce qu'il a été testé de la manière la plus complète possible avec cette version. Sakai 10 devrait être compatible binairement avec Java 6 et donc fonctionner avec un JDK/JRE 6.0 . Certains fichiers, tels que les *.jsp and *.jws, nécessitent une  compilation, aussi veuillez télécharger et utiliser uniquement le JDK, le JRE avec uniquement l'environnement d'exécution (JRE 6.0 ou JRE 7.0) ne suffira pas. Mac OS X 10.7 et les versions ultérieures ne fournissent plus l'installation de Java par défaut, donc les utilisateurs de Mac devront installer Java par eux-mêmes. Si vous trouvez les conventions de de nommage et de numérotation de version de Sun confuses, consultez la page web Sun Java SE Naming and Versions  pour avoir un aperçu de leurs pratiques.

(minus) Le logiciel  Sun Java SE 6 d'Oracle (alias Java 1.6) est arrivé en fin de vie (EOL) et n'est plus supporté et mis à jour par Oracle (hors contrat de maintenance payant). Si vous utilisez toujours Java 1.6, veuillez noter que des failles de sécurité existent actuellement dans le JDK/JRE 6.0.

Java 7

En date du 19 Juin 2013, un problème a été signalé et il concerne la compatibilité avec Java 7. Le problème est dans les comparateurs et la solution de contournement consiste à utiliser la propriété suivante de la JVM (Java Virtual Machine) :

-Djava.util.Arrays.useLegacyMergeSort=true

Pour plus de détails, consultez le lien - http://sakai-project-mail-list-archives.1343168.n2.nabble.com/Building-Sakai-Java-7-and-Sakai-comparators-tt7589944.html et le ticket de bug SAK-38978 - Content Hosting comparators are incompatible with java 7 CLOSED


Pour vérifier que Java est installé sur votre système et que cette version est correcte et suffisante pour utiliser Sakai, exécuter la commande java -version  depuis la ligne de commande (dans un terminal ou une console ) :
java -version

Si Java est bien installé, la commande retournera la version exacte et les informations de compilation de votre JDK/JRE à l'écran:

java version "1.6.0_24"
Java(TM) SE Runtime Environment (build 1.6.0_24-b07-334-10M3326)
Java HotSpot(TM) 64-Bit Server VM (build 19.1-b02-334, mixed mode)

Si Java n'est pas installé ou que vous utilisez la mauvaise version de Java, vous pouvez télécharger les différentes versions du Java SE 7.0  JDK depuis le site web des archives Sun d'Oracle à:

http://www.oracle.com/technetwork/java/javase/archive-139210.html

 Installez le JDK, habituellement dans le répertoire /opt (sur Linux/Unix), par exemple /opt/java. Installez le JRE dans un répertoire différent (habituellement le répertoire par défaut, en particulier si vous utilisez Windows) ou vous pourriez rencontrer des problèmes d'exécution.


3.0 Démarrer/Arrêter Tomcat


At this stage your installation of Sakai has not yet been configured to use your preferred database (it will use its own HSQLDB by default) but you should now be able to bring it up as a working web application by simply starting Tomcat, and it can be helpful at this point to know if any problems exist before you try to connect it to another database. Tomcat will take a minute or so to start up, depending on the speed of your machine, and it's a good idea to watch the Tomcat log as it comes up to catch any errors.

You can start Tomcat by running the appropriate start batch/shell script file from the root Tomcat directory:

Unix/Mac:

start-sakai.sh

Windows:

start-sakai.bat

Once Tomcat has loaded the Sakai application (again, this can take a couple of minutes) point your browser to

http://localhost:8080/portal

This will bring you to the Sakai gateway site from which you can create new accounts and log in to the system. If the gateway page fails to load, check the Tomcat logs for any errors and stack traces. If the gateway page does come up, log in with the default admin account (the username and password are both 'admin'). If you can log in without errors Sakai is alive and well.

Stopping Sakai involves shutting down Tomcat by running the appropriate stop batch/shell script file from the root Tomcat directory:

Unix/Mac:

stop-sakai.sh

Windows:

stop-sakai.bat


4.0 Explorer Sakai


Note : this is the french translation for the web page "Using Sakai (2.x)"

Vous devez avoir une installation fonctionnelle de Sakai en ce moment. Maintenant il est temps de commencer à ajouter des utilisateurs, de créer des espaces de travail (sites), et par ailleurs de jouer avec les outils. Nous n'allons pas essayer de présenter ici un guide de l'utilisateur complet, mais nous pouvons vous offrir quelques conseils ou pointeurs pour vous orienter sur votre chemin, et vous guider vers des  sources d'information plus exhaustives ailleurs.

La page passerelle/portail (Gateway)

Une fois que Tomcat a démarré avec succès, vous devriez être en mesure d'accéder depuis votre navigateur web à la page de la passerelle/portail à l'URL http://localhost:8080/portal (ou remplacer alors 'localhost' par le nom du serveur sur lequel il est installé). A partir de la page de la passerelle, vous pouvez créer de nouveaux comptes ou parcourir le contenu du site public. Vous pourriez commencer par créer un nouveau compte, mais cela peut aussi être fait en tant qu'administrateur.  Les fonctions d'administrateur sont aussi nécessaires pour donner à ce compte les autorisations appropriées. Il est tout aussi bien de commencer par se connecter en tant qu'administrateur. Le compte administrateur par défaut de Sakai est simplement nommé «admin» (avec également comme mot de passe   «admin»), aussi veuillez utiliser ces informations d'identification pour vous connecter à Sakai.

Mon espace de travail (My Workspace)

Chaque utilisateur du système - y compris le ou les administrateur(s) - a un espace (site) privé appelé "Mon espace de travail". C'est le point d'arrivé après l'authentification sur le site, et c'est le premier onglet de l'espace (site) qui est visible en haut à gauche de la page web. Sur le côté gauche de l'écran, il y a une partie (panneau) avec des liens vers les différentes pages de l'outil au sein d'un espace (site) donné. L'espace "Mon espace de travail" de l'administrateur a un ensemble différent de ces options que la plupart des utilisateurs (chaque type de compte différent peut être configuré pour avoir un ensemble différent d'outils dans son "Mon Espace de travail" en modifiant un modèle - voir ci-dessous).

Autres espaces (Sites)

Chaque nouveau espace (site) (accessible) devient visible sous forme d'onglet, en haut et à droite, de l'onglet "Mon espace de travail". Pour la plupart des utilisateurs, ils ont d'abord uniquement accès à un seul espace (site) - leur "Mon espace de travail". L'utilisateur admin (administrateur) est un peu différent, en ce qui le concerne, il a accès à deux. Le deuxième espace (site) d'administration (sur lequel vous pouvez entrer en cliquant sur son onglet) est nommé "Espace de travail Administration" (Administration Workspace). Ce dernier, curieusement, est exactement le même que l'espace "Mon espace de travail" de l'administrateur (admin). 


Pourquoi la redondance? Parce que vous aurez probablement envie de rendre accessible ces outils d'administration à un utilisateur en particulier qui n'a pas accès à l'espace "Mon espace de travail" de l'administrateur (admin) (personne n'a accès aux autres espaces "Mon Espace de travail" de d'autres personnes sur le système). Pour permettre l'accès de quiconque aux outils d'administration, il vous suffit de les ajouter à la liste des utilisateurs de l'espace "Espace de travail Administration" (Administration Workspace), puis de les promouvoir au rôle "admin" dans l'espace (site)  ou de leur ajouter ce rôle.

Outils d'administration

Création des utilisateurs

La première chose que vous pouvez faire est de changer le mot de passe du compte "admin" pour quelque chose de sûr, et ensuite par commencer à créer quelques exemples d'utilisateurs sur votre système. Vous pouvez faire ces deux tâches à travers l'outil "Utilisateurs (users)" sur la gauche. Pour changer le mot de passe de l'utilisateur "admin", cliquez simplement sur le nom d'utilisateur "admin" dans la liste des utilisateurs, et modifiez les champs sur la page suivante. Pour créer des utilisateurs, cliquez sur le lien "Nouveau utilisateur" pour réaliser l'action en haut de la page de l'outil.

Création des espaces (sites)

Si vous avez envie de créer votre premier espace de travail , vous pouvez être tenté de plonger directement dans l'outil Sites. Ce serait sans doute une erreur. L'outil Sites est un moyen puissant pour construire un site entier à partir de rien, avec un contrôle précis sur chaque page, outil, et détails de la configuration. Mais la souplesse de cette puissance a un prix qui rend l'interface intimidante et la gestion de flux (workflow) à des dimensions épiques. L'outil Sites est donc utilisé de référence comme un moyen de modifier un site existant, en fait, une fois que les éléments standards les plus appropriées ont été   assemblés.


La meilleure façon de commencer la création d'espaces (sites)  est par conséquent d'utiliser l'outil de configuration de l'espace de travail (Worksite Setup). Cliquez sur le lien Nouveau en haut de la page de l'outil, puis, pour des raisons de simplicité, choisissez le type d'espace (site) du projet. Celà vous permettra d'éviter les problèmes de saison (session) universitaire, etc, qui sont provoquées par un espace "cours (course) " - problèmes/questions qui sont probablement inutiles si vous voulez juste de commencer à jouer avec les outils. Soit le type de site servira, ou soit il faudra en faire un autre, cependant: les deux types de sites ont tous les outils à leur disposition.

Parcourez les pages de création des sites restants et faites des sélections de vos sites ou pages préférés. Assurez-vous de cliquer sur le bouton Créer un espace (site) à la fin du processus. Après cela, vous devriez voir le titre de l'espace (site) visible comme un nouvel onglet en haut de l'écran.

Ajouter des utilisateurs à des espaces (sites)

Puisque vous paramétrez  ce site en tant qu'administrateur (admin), l'administrateur est techniquement le propriétaire de cet espace (site), et son seul membre en premier. Si vous souhaitez ajouter d'autres  utilisateurs d'exemple à ce site avec des rôles différents, vous pouvez le faire via l'outil Informations sur le site (Site Info) du site lui-même.

Cliquez sur l'onglet de votre nouveau espace (site) (qui devrait maintenant être visible) pour y accéder, puis cliquez sur le lien Informations sur le site (Site Info) le long du côté gauche. Informations sur le site (Site Info) a un certain nombre de fonctions de responsable de site disponibles comme des liens d'action dans le haut, et Ajouter un participant est celui qui vous permettra de connecter/autoriser les autres utilisateurs au site. Ces utilisateurs devront bien sûr avoir été préalablement créé.
Tant que nous sommes ici dans Informations sur le site (Site Info), il est important de souligner que le lien Modifier Outils en haut vous permettra de supprimer et ajouter des outils à partir du site.

Expérimenter avec les outils

Vous avez peut-être remarqué qu'un outil supplémentaire apparaîtra sur votre espace (site) - celui que vous n'avez pas choisi explicitement - marqué Aide (Help) . Cet outil fournit de la documentation en ligne d'un ensemble de différents outils , et de d'autres aspects du système. Cela devrait être votre compagnon pour en apprendre davantage sur les fonctionnalités du logiciel.

Cet outil d'Aide est aussi accessible d'une manière contextuelle en cliquant sur les icônes "point d'interrogation" en haut et à droite de n'importe quel panneau (frame) d'outil en particulier. En cliquant sur ces points d'interrogation, un contenu d'information précis sur l'outil choisi s'affichera au moment où vous en avez besoin .

Un peu plus tard, lorsque vous serez à l'aise avec les outils standard, vous pouvez souhaiter voir d'autres outils plus expérimentaux qui sont disponibles pour Sakai. La distribution Sakai comprend des outils provisoires qui sont encore en cours de croissance (développement et amélioration), mais peuvent déjà répondre aux besoins par des moyens novateurs là où les les outils standards ne le peuvent pas. Ces outils supplémentaires nécessitent des étapes supplémentaires pour être activé, de sorte que les utilisateurs du système ne pourront pas tomber sur eux par inadvertance si cela n'est pas souhaité, mais nous vous encourageons à les évaluer pour votre propre déploiement.

Où en apprendre plus

À propos du projet

Le site web sakaiproject.org offre la meilleure information de fond et l'orientation du projet et de ses objectifs, mais il y a des chances que vous ayez déjà vu ce site. Pour plus d'informations, notamment sur les progrès et les feuilles de route de certains outils ou d'autres initiatives, veuillez consulter les espaces de Confluence pertinents (https://confluence.sakaiproject.org/spacedirectory/view.action).

Participation à la communauté

La Communauté Sakai fournit des forums électroniques sur une variété de sujets. Les listes sont ouvertes, cependant, elles rejettent tous les courriels des non-membres.  Aussi vous avez besoin de rejoindre une liste avant de pouvoir poster dans celle-ci , mais vous pouvez toujours accéder à ses archives.

Les quatre principales listes de la communauté Sakai sont les suivantes: 
 

Annonces (announcements@apereo.org) - sujets d'intérêt à l'échelle de la communauté dans Apereo, y compris Sakai (recevoir les lettres d'information, s'informer sur les conférences et les dates butoir; suivre les progrès général sur les versions à venir, participer à des appels à contribution de la communauté). Une liste, à faible volume et en lecture seule , à laquelle tout le monde devrait s'abonner.

Développer pour Sakai (sakai-dev@collab.sakaiproject.org) - la conception, le développement, les tests et la documentation de Sakai (en apprendre plus sur les détails techniques de développement d'outils ou d'intégration de services; trouver des lignes directrices pour la conception et le développement d'outils et de services; repérer les spécifications techniques ; en apprendre davantage sur les plans pour les prochaines versions). Pour les concepteurs, les programmeurs, développeurs, et l'assurance qualité.

Pédagogie (pedagogy@collab.sakaiproject.org) - l'enseignement et l'apprentissage, le collaboratif et d'autres utilisations de Sakai (en apprendre plus sur les meilleures pratiques, partager des expériences, avoir des liens avec les communautés d'utilisateurs ayant des intérêts similaires, enseignement primaire et secondaire, enseignement supérieur , portefeuilles). Pour les enseignants, le personnel, les étudiants, les chercheurs, les concepteurs pédagogiques, les technologues en enseignement et l'équipe support de l'utilisateur final .

Déploiement de Sakai (production@collab.sakaiproject.org) - la mise en œuvre, l'installation, la configuration et le support de Sakai (trouver de la documentation d'une version donnée ; en apprendre davantage sur l'optimisation des performances; parcourir les configurations matérielles et logicielles proposées; partager des exemples de matériel de formation, de tutorat et de support). Pour les administrateurs système, les administrateurs de bases de données (DBA), et le personnel du support technique.

Il y a aussi une variété de petits groupes de travail sur des sujets précis, ceux-ci utilisent des listes de courriel, dans lesquelles vous pouvez également y trouver de l'intérêt puisque vous êtes plus impliqués dans la communauté.

Pour rejoindre une liste de diffusion Sakai, allez avec votre navigateur web à l'adresse :

http://collab.sakaiproject.org/mailman/listinfo/

et rejoignez les listes qui vous intéressent. Vous serez invité à remplir un court formulaire (nom d'utilisateur, mot de passe) et vous pouvez choisir de recevoir ou non les messages (post) de chaque liste individuellement (par défaut) ou en lot dans un résumé quotidien. Une fois que vous avez soumis votre demande, vous recevrez un courriel de confirmation avec une courte série d'instructions à effectuer pour confirmer votre demande d'abonnement.

À propos de questions techniques 

La documentation (matériel) de référence pour les diverses questions techniques se trouve au mieux dans le référentiel subversion du code source de  Sakai (où ces documents d'installation sont aussi stockés) ou dans le wiki Confluence du projet. Les documents dans le dépôt Subversion peuvent être trouvées dans le module de référence, par exemple,  https://source.sakaiproject.org/svn/reference. Voir en particulier le dossier docs/architecture contenu -bas, qui contient une vaste collection de livres blancs techniques.

Le wiki Confluence est une source plus informelle d'information, mais aussi précieuse et d'une portée plus large. Les nouveaux développeurs en particulier devraient visiter le Programmer's Cafe. Vous êtes invité/encouragé à y créer un compte et à y participer.

Mais souvent l'information la plus incisive vient de l'interaction directe avec vos pairs. Comme mentionné ci-dessus, la Collab Server est l'endroit où aller pour cela. Pour les questions techniques, le meilleur (et le plus actif) groupe est DG: développement, aussi communément appelé par son alias, «Sakai-dev."