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

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

1.0 Get the demo

 

 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.

 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.