JVM and Operating System (Checks #1, #2)
Some of the string values and date formats that appear in client’s navigator are taken by Bedework from the locale management of the OS of server side. The JVM on which Bedework runs on, takes some of the string values and date formats from the underlying OS using java locale and date and time classes. So it is quite important that both, JVM and OS, are configured correctly.
Operating System checks
To check the current locale configuration of the OS you can use the command “locale” in Unix boxes or checking the language options of Control Panel in Windows machines
In Unix the locale command returns something like this:
$ locale LANG=en_US.UTF-8 LC_CTYPE="en_US.UTF-8" LC_NUMERIC="en_US.UTF-8" LC_TIME="en_US.UTF-8" LC_COLLATE="en_US.UTF-8" LC_MONETARY="en_US.UTF-8" LC_MESSAGES="en_US.UTF-8" LC_PAPER="en_US.UTF-8" LC_NAME="en_US.UTF-8" LC_ADDRESS="en_US.UTF-8" LC_TELEPHONE="en_US.UTF-8" LC_MEASUREMENT="en_US.UTF-8" LC_IDENTIFICATION="en_US.UTF-8" LC_ALL=
In this case “English – United States” seems to be the default language configuration. To change it to “Spanish – Spain”.
$ export LC_ALL=es_ES.UTF-8 $ export LANG=es_ES.UTF-8
And now the command locale should show
$ locale LANG=es_ES.UTF-8 LC_CTYPE="es_ES.UTF-8" LC_NUMERIC="es_ES.UTF-8" LC_TIME="es_ES.UTF-8" LC_COLLATE="es_ES.UTF-8" LC_MONETARY="es_ES.UTF-8" LC_MESSAGES="es_ES.UTF-8" LC_PAPER="es_ES.UTF-8" LC_NAME="es_ES.UTF-8" LC_ADDRESS="es_ES.UTF-8" LC_TELEPHONE="es_ES.UTF-8" LC_MEASUREMENT="es_ES.UTF-8" LC_IDENTIFICATION="es_ES.UTF-8" LC_ALL=es_ES.UTF-8
For Unix boxes: Your server could not have all possible locale configurations installed. Some Unix(es) gives you some information about it with non-priviledged commands. In Linux (Fedora, CentOS, etc) the command “set” gives you some info.
..... SUPPORTED=eu_ES.UTF-8:eu_ES:eu:en_US.UTF-8:en_US:en:fr_FR.UTF-8:fr_FR:fr:de_DE.UTF-8:de_DE:de:es_ES.UTF-8:es_ES:es .....
Be aware that you can configure and issue the “$export LC_ALL=<locale>” even when that locale is not really supported on your installation. Even more, after that unsupported configuration, the “locale” command shows supposed current locale even when the OS does not really manage it if it is not installed.
JVM Checks
JVM takes some environment values from the OS ones by default. To check the default locale (among others) your JVM is using you can use this class:
(See http://www.dickbaldwin.com/java/Java052.htm):
import java.util.*;
import java.lang.*;
class Prop01{
public static void main(String[] args){
//Instantiate and display a Properties object
// containing the system properties
Properties obj = new Properties(System.getProperties() );
obj.list(System.out);
}//end main()
}
Running this class in command line, “ java Prop01 ”, returns a list like this:
java.runtime.name=Java(TM) 2 Runtime Environment, Stand... sun.boot.library.path=/apps/jdk/jdk142_04/jre/lib/sparc java.vm.version=1.4.2_04-b05 java.vm.vendor=Sun Microsystems Inc. java.vendor.url=http://java.sun.com/ path.separator=: java.vm.name=Java HotSpot(TM) Client VM file.encoding.pkg=sun.io user.country=ES sun.os.patch.level=unknown java.vm.specification.name=Java Virtual Machine Specification user.dir=/export/home/unavarra java.runtime.version=1.4.2_04-b05 java.awt.graphicsenv=sun.awt.X11GraphicsEnvironment java.endorsed.dirs=/apps/jdk/jdk142_04/jre/lib/endorsed os.arch=sparc java.io.tmpdir=/var/tmp/ line.separator= java.vm.specification.vendor=Sun Microsystems Inc. os.name=SunOS sun.java2d.fontpath= java.library.path=/apps/jdk/jdk142_04/jre/lib/sparc/cli... java.specification.name=Java Platform API Specification java.class.version=48.0 java.util.prefs.PreferencesFactory=java.util.prefs.FileSystemPreferences... os.version=5.8 user.home=/export/home/unavarra user.timezone= java.awt.printerjob=sun.print.PSPrinterJob file.encoding=ISO8859-15 java.specification.version=1.4 user.name=unavarra java.class.path=.:/apps/jdk/jdk142_04/lib/tools.jar:/... java.vm.specification.version=1.0 sun.arch.data.model=32 java.home=/apps/jdk/jdk142_04/jre java.specification.vendor=Sun Microsystems Inc. user.language=es java.vm.info=mixed mode java.version=1.4.2_04 java.ext.dirs=/apps/jdk/jdk142_04/jre/lib/ext sun.boot.class.path=/apps/jdk/jdk142_04/jre/lib/rt.jar:/a... java.vendor=Sun Microsystems Inc. file.separator=/ java.vendor.url.bug=http://java.sun.com/cgi-bin/bugreport... sun.cpu.endian=big sun.io.unicode.encoding=UnicodeBig sun.cpu.isalist=sparcv9+vis2 sparcv9+vis sparcv9 spar...
From this list, the relevant values in our case are:
user.country=ES user.timezone= user.language=es
Notice that the value “user.timezone=” is empty. To run the JVM with the correct ones, the Java command line options can be used, as:
$java -Duser.timezone=Europe/Madrid -Duser.country=ES -Duser.language=es Prop01 java.runtime.name=Java(TM) 2 Runtime Environment, Stand... sun.boot.library.path=/apps/jdk/jdk150_02/jre/lib/i386 java.vm.version=1.5.0_02-b09 ..... user.country=ES user.timezone=Europe/Madrid user.language=es .....
You should put those environment variables before starting your bedework installation, as this
(Unix) JAVA_OPTS="$JAVA_OPTS -Duser.timezone= Europe/Madrid -Duser.country=ES -Duser.language=es -Dfile.encoding=UTF-8 -Duser.variant=ES "
(windows) SET JAVA_OPTS=%JAVA_OPTS% -Duser.timezone=Europe/Madrid -Duser.country=ES -Duser.language=es -Dfile.encoding=UTF-8 -Duser.variant=ES
The startjboss or startjboss.bat inherits the values of JAVA_OPTS and adds them to the ones it sets itselt.