KB442624: Japanese characters get garbled for MicroStrategy Web running on Tomcat with Java 9 or above

JavaScript Compile error:File: ../javascript/mojo/js/source/CustomGroupEditor.jsError: Invalid reqular expression:/?????\s*(\d+)/:Nothing to repeat

Click OK for the error.  Then the following error window shows up.

Warning: Javascript class not found:Mstrmojo.CustomGroupEditor

 
The issue only occurs to version JDK 9 and higher and it does not occur to JDK 8 or lower.
CAUSE
The issue is caused by encoding change starting from JDK 9 to read the resource bundles.
JDK 8 or lower versions read the resource bundles in ISO8859-1 by default, while JDK 9 or higher versions read those in UTF8 by default.
ACTION
Take below actions to avoid this encoding issue.
 
For Tomcat running on Windows OS:
1.  Go to C:\Program Files (x86)\Common Files\MicroStrategy\Tomcat\<apache-tomcat-x.y.z>\bin
2.  Launch application tomcat9w (or tomcat8w if you are using tomcat 8.x)
3. Go to Java tab and add the below system property in the Java Options pane     

-Djava.util.PropertyResourceBundle.encoding=ISO-8859-1

4. Restart tomcat server
 
For Tomcat running on Linux OS:
1. Create a file called setenv.sh in <tomcat_directory>\bin
2. Add the following entry into it

export CATALINA_OPTS="$CATALINA_OPTS -Djava.util.PropertyResourceBundle.encoding=ISO-8859-1"

3. Restart tomcat server
 
WARNING
The third-party product(s) discussed in this technical note is manufactured by vendors independent of Strategy. Strategy makes no warranty, express, implied or otherwise, regarding this product, including its performance or reliability.
 
KB442624