Variables d'environment Java (2.8)

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.

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

Additional required settings

Certain JSF tools (chat, portfolios, test & quizzes) do not compile properly in Java 1.6. The workaround requires adding the system property allowArraySyntax in order to avoid deserialization bottlenecks in arrays (see SAK-17578 - Getting issue details... STATUS ). Second, Tomcat 5.5.27+ enforces strict quote escaping, a change in *.jsp handling that has yet to be addressed in certain tools such as portfolios (see SAK-15736 - Getting issue details... STATUS ). Finally, specify an HTTP user agent other than "Java/xxxxx" in order to resolve Google and other RSS feeds (see SAK-10159 - Getting issue details... STATUS , SAK-13353 - Getting issue details... STATUS and SAK-18044 - Getting issue details... STATUS ).

-Dsun.lang.ClassLoader.allowArraySyntax=true
-Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false
-Dhttp.agent=Sakai

Specify a Language and Locale (optional)

You can define the default language/locale when starting Sakai by setting the system properties -Duser.language and -Duser.region. For information on supported languages see the release notes or visit the i18N Work Group space.

-Duser.language=pt 
-Duser.region=PT

Specify an HTTP Proxy (optional)

In environments where local network policy or firewalls require use of an upstream HTTP proxy/cache, Sakai needs to be configured accordingly. Otherwise components or services which use HTTP requests, such as the BasicNewsService for RSS feeds in the News tool, cannot retrieve data from the target URLs. This can be fixed with the following JAVA_OPTS arguments:

-Dhttp.proxyHost=cache.some.domain 
-Dhttp.proxyPort=8080