Child pages
  • Java Environment Variables (2.8)

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: add french translation

...

Sv translation
languagees

Se deben definir algunas de las variables de entorno y propiedades relacionadas para Java. En los sistemas operativos UNIX normalmente se modifica el fichero de arranque como ~/.bash_login para configurar y exportar las variables mientras que los usuarios de Mac típicamente realizan esto mismo en .bash_profile. Para Windows, se va a  Inicio -> Panel de Control -> Sistema -> Avanzado -> Variables de Entorno y se configura JAVA_HOME mediante la Interfaz de Usuario.

Hay que configurar la variable de entorno JAVA_HOME para apuntar al directorio base de nuestra instalación Java y añadir el directorio /bin  de Java a la variable de entorno PATH .

(info) Si la variable JRE_HOME ya está configurada o deseas usar un JRE diferente en el caso de tener varios JRE instalados en tu máquina, entonces tendrás que configurar la variable JRE_HOME también. JRE_HOME es lo que Apache Tomcat usa cuando arranca, pero por defecto usa JAVA_HOME si JRE_HOME no está configurada. En la mayoría de los casos, configurar JAVA_HOME debería ser suficiente.

Variable

Unix

Mac

Windows

JAVA_HOME

export JAVA_HOME=/usr/java/java-current

export JAVA_HOME=/Library/Java/Home

JAVA_HOME=C:\jdk1.6.0_24

PATH

export PATH=$PATH:$JAVA_HOME/bin/

export PATH=$PATH:$JAVA_HOME/bin/

;C:\jdk1.6.0_24\bin

(warning) Windows: añadir esa cadena al final del la variable de sistema Path

Configurar JAVA_OPTS

Los ajustes de la máquina virtual de Java (JVM) por defecto   no son suficientes para una aplicación de tamaño de Sakai. Como resultado varios parámetros de la JVM deben aumentarse para que Sakai pueda funcionar, mientras que otros pueden necesitar ser ajustados para un rendimiento óptimo. Como mínimo, agregue los siguientes valores a la variable de entorno JAVA_OPTS.

(tick) Recomendamos que defina estas configuraciones en el directorio /bin del Tomcat en un fichero llamado setenv.sh (Unix/Mac) o setenv.bat (Windows). Ver la sección de Tomcat más abajo para más detalles

Unix/Mac:

No Format
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'

Windows:

No Format
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

(minus) Configuraciones adicionales necesarias

Ciertas herramientas que usan JSF (chat, portfolios, exámenes -test & quizzes) no compilan adecuadamente en Java 1.6. Para solucionarlo hay que añadir al sistema la propiedad allowArraySyntax ipara evitar los cuellos de botella de en los arrays (ver

Jira
SAK-17578
SAK-17578
). Además, Tomcat 5.5.27+ obliga a escapar las comillas, un cambio en *.jsp que aún no ha sido realizado en ciertas herramientas como portfolios (ver
Jira
SAK-15736
SAK-15736
). Finalmente, es necesario especificar otro "HTTP user agent" que no sea "Java/xxxxx" para Google y otros feeds RSS  (ver
Jira
SAK-10159
SAK-10159
,
Jira
SAK-13353
SAK-13353
y
Jira
SAK-18044
SAK-18044
).

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

Especificar un Lenguaje y un Locale (opcional)

Se puede definir el "laguage/locale" por defecto cuando Sakai arranca mediante las propiedades del sistema -Duser.language y -Duser.region. Para más información sobre los lenguajes soportados, por favor revisa las notas de la versión o visita el espacio del grupo de trabajo de i18N.

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

Especificar un Proxy HTTP  (opcional)

En entornos donde las políticas de red local o los firewalls requieran el uso de "upstream HTTP proxy/cache", Sakai se tiene que configurar adecuadamente. De otro modo, algunos componentes o servicios que usan peticiones HTTP, como el BasicNewsService para los feeds RSS en las Noticias, no podrían recibir datos de la URL destino. Esto de puede arreglar con las siguientes opciones en JAVA_OPTS:

No Format
-Dhttp.proxyHost=cache.some.domain 
-Dhttp.proxyPort=8080
Sv translation
languagefr

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.

(info) 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

export JAVA_HOME=/usr/java/java-current

export JAVA_HOME=/Library/Java/Home

JAVA_HOME=C:\jdk1.6.0_24

PATH

export PATH=$PATH:$JAVA_HOME/bin/

export PATH=$PATH:$JAVA_HOME/bin/

;C:\jdk1.6.0_24\bin

(warning) 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 .

(tick) 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 :

No Format
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:

No Format
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

(minus) 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
Jira
SAK-17578
SAK-17578
)
. 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
Jira
SAK-15736
SAK-15736
)
. 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
Jira
SAK-10159
SAK-10159
,
Jira
SAK-13353
SAK-13353
 
et
Jira
SAK-18044
SAK-18044
)
.

No Format
-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.

No Format
-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) :

No Format
-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:

No Format
-Dhttp.proxyHost=cache.some.domain_name 
-Dhttp.proxyPort=8080