Sakai 10.x Guide d'installation (binaires) - French binary installation guide
Note : This the french translation for the "Sakai 10 install guide (binary)" web page.
1.0 Récupérer l'archive des fichiers binaires
Note : This the french translation for the english "Sakai Binary Distribution (2.x)" web page.
Limitations des binaires. Les correctifs sortis après une version de Sakai ne sont pas toujours empaquetés (packagées) sous forme de fichiers java *.jar , donc une installation binaire forces une mise en œuvre relativement statique qui ne peut pas être aussi facilement corrigé plus tard (que des binaires compilés à partir des sources).
La distribution binaire de Sakai fournit un raccourci/lien pour ceux qui ont déjà installé le serveur Tomcat et l'ont configuré suivant leurs besoins (dont la création et la configuration de la base de données). Elle le fait en fournissant un logiciel Sakai déjà pré-compilé et qui peut être simplement mis dans son répertoire de fonctionnement/de travail.Tout ce que vous devez faire est de décompresser l'archive des binaires dans le répertoire racine de Tomcat (ROOT). Les fichiers appropriées *.wars, *.jars, etc., pour l'application Sakai seront déposés dans les emplacements corrects.
L'archive des binaires de la dernière version de Saka est disponible sur le lien suivant http://source.sakaiproject.org/release/.
2.0 Verifier/Installer 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
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.
2.1 Paramétrer les variables d'environnement Java
Note : French translation for the web page "Java Environment Variables (2.8)"
Plusieurs variables d'environnement et les propriétés ou paramètres qui leur sont associés doivent être définies pour Java. Pour les systèmes d'exploitation UNIX, on modifie généralement un fichier de démarrage comme celui du ~/.bash_login (à la racine de votre compte utilisateur) pour définir et exporter les variables de l'interpréteur du shell ( bash, ksh, sh, etc..) tandis que les utilisateurs de Mac OS paramètrent et exportent en général leurs variables d'environnement dans le fichier .bash_profile. Pour MS Windows, cliquez dans le menu sur Démarrer -> Panneau de configuration -> Système ou Système et maintenance puis Système -> Avancé ou Paramètre système avancé -> Variables d'environnement (Start -> Control Panel -> System -> Advanced -> Environment Variables) et définissez la variable JAVA_HOME via l'interface graphique.
Définissez la variable d'environnement JAVA_HOME pour pointer vers le répertoire de base de votre installation de Java et ajouter le répertoire /bin de Java à la variable d'environnement PATH.
Si la variable JRE_HOME est déjà définie ou si vous voulez utiliser un autre JRE en particulier ou si vous avez plus d'un JRE installé sur votre machine, alors vous avez la possibilité de définir une variable JRE_HOME personnalisée. La variable JRE_HOME est utilisée par Apache Tomcat lorsqu'il démarre, mais par défaut il utilise la variable JAVA_HOME et se base sur celle-ci si la variable JRE_HOME n'est pas déjà définie. Dans la plupart des cas, le paramétrage de la variable JAVA_HOME doit convenir suffisamment aux différents cas.
Variable | Unix | Mac | Windows |
|---|---|---|---|
JAVA_HOME |
|
|
|
PATH |
|
|
|
MS Windows: ajouter la chaîne à la fin de la variable système Path
Paramétrer la variable JAVA_OPTS
Les paramètres par défaut de la machine virtuelle Java (JVM) sont insuffisants pour une application de la taille de Sakai. Par conséquent, plusieurs paramètres de la JVM doivent être augmentées pour permettre à Sakai de fonctionner, tandis que d'autres peuvent avoir besoin d'être ajustée pour obtenir des performances optimales de l'application. A minima, veuillez ajouter les paramètres de propriété suivants à votre variable d'environnement JAVA_OPTS .
Nous vous recommandons de définir ces paramètres dans le fichier nommé setenv.sh (Linux / Unix / Mac) ou setenv.bat (MS Windows) qui se trouve dans le répertoire /bin de Tomcat. Voir la section Tomcat ci-dessous pour plus de détails.
Unix/Mac/Linux :
export JAVA_OPTS='-server -Xms512m -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=512m -XX:NewSize=192m -XX:MaxNewSize=384m -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true'
MS Windows:
set JAVA_OPTS=-server -Xms512m -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=512m -XX:NewSize=192m -XX:MaxNewSize=384m -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true
Paramètres additionnels requis
En premier, certains outils développés en JSF (chat, portefeuilles, test et quiz) ne se compilent pas correctement avec Java 1.6. La solution de contournement nécessite l'ajout de la propriété système allowArraySyntax afin d'éviter des goulets d'étranglement avec la désérialisation dans les tableaux (voir ticket
-Dsun.lang.ClassLoader.allowArraySyntax=true
-Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false
-Dhttp.agent=Sakai
Spécifiez une langue et une locale (facultatif)
Vous pouvez définir la langue et la locale par défaut lors du démarrage de Sakai en paramétrant les propriétés système -Duser.language et -Duser.region. Pour plus d'informations sur les langues prises en charge, veuillez consulter les notes de version ou visitez l'espace du groupe de travail sur l'internationalisation ( i18N ). Liste des langues et locales disponibles dans Sakai : http://qa1-nl.sakaiproject.org/international/