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
allowArraySyntax
afin d'éviter des goulets d'étranglement avec la désérialisation dans les tableaux (voir ticket
-
SAK-17578Getting issue details...
STATUS
). Deuxièmement, Tomcat, en version 5.5.27 ou supérieure, applique strictement l'échappement des quotes (strict quote escaping), or un changement du traitement des fichiers *.jsp n'a pas encore été effectué dans certains outils tels que les portefeuilles (voir ticket
-
SAK-15736Getting issue details...
STATUS
). Enfin, spécifiez un agent utilisateur HTTP (identification comme navigateur web) autre que "Java / xxxxx" afin de résoudre les flux RSS de Google et d'autres sites (voir tickets
-
SAK-10159Getting issue details...
STATUS
,
-
SAK-13353Getting issue details...
STATUS
et
-
SAK-18044Getting issue details...
STATUS
).-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/
Canada :
Ndt: au , la traduction française pour la France (94%) est plus complète que celle pour le Canada (56%). Veuillez utiliser la traduction française France si vous voulez avoir le plus de menus et messages en français.
-Duser.language=fr -Duser.region=CA
France (fonctionne aussi pour la Belgique, le Luxembourg ou la Suisse en l'absence de traduction spécifique pour ces pays) :
-Duser.language=fr -Duser.region=FR
Spécifiez un Proxy HTTP (facultatif)
Dans les environnements où la politique du réseau local ou des pare-feu nécessite l'utilisation d'un serveur proxy/cache HTTP en amont , Sakai doit être configuré en conséquence. Sinon des composants ou services qui utilisent les requêtes HTTP, tels que le BasicNewsService
pour les flux RSS dans l'outil Nouvelles (News), ne peuvent pas récupérer des données à partir des URL cibles. Cela peut être corrigé avec les arguments JAVA_OPTS
suivants:
-Dhttp.proxyHost=cache.some.domain_name -Dhttp.proxyPort=8080