Automated UTF-8 Settings

This section describes the changes that automatically occur when UTF-8 support is selected in ENOVIA Live Collaboration Server installations.

Related Topics
Manually Setting UTF-8 Options
Manually Setting UTF-8 Options for AIX
ENOVIA Live Collaboration Server Environment Settings

Changes for All J2EE Application Servers


  • The startup scripts for the Application Servers set the following:

    MX_CHARSET=UTF8
    LANG=C
    NLS_LANG=_UTF8
    

    Note: On UNIX, these settings are made in mxEnv.sh and are exported as required. The Application Server startup script runs this file. On Windows, these variables are set in the enovia.ini file.

  • The following setting is added to web.xml:
    ematrix.encoding=UTF8

RMI Standalone (non-RIP) changes

Both the rmid startup script and the RMIService set the following:

LANG=C
MX_CHARSET=UTF8

UNIX/Linux:

The settings are exported as required.

Windows:

These variables are set in the enovia.ini file.

WebLogic changes

The following lines in weblogic.xml are uncommented:

<charset-params>
   <input-charset> 
      <resource-path>/*</resource-path> 
      <java-charset-name>UTF8</java-charset-name> 
   </input-charset> 
</charset-params> 

WebSphere changes

In the ibm-web-ext.xml file, located in SERVERHOME/ematrixwarutil/, the autoRequestEncoding and autoResponseEncoding attributes are enabled in the <webappext> element. For example:

<webappext:WebAppExtension xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" 
xmlns:webappext="webappext.xmi" xmlns:webapplication="webapplication.xmi" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmi:id="WebApp_1_Ext" 
reloadInterval="60" reloadingEnabled="false" fileServingEnabled="true" 
directoryBrowsingEnabled="false" serveServletsByClassnameEnabled="false" 
autoRequestEncoding="true" autoResponseEncoding="true">

Sun Java System Application Server changes

The following entries are added to the sun-web.xml file:

<sun-web-app>
   <locale-charset-info  default-locale="en_US">
   <locale-charset-map locale="en" charset="ISO-8859-1"/>
   <locale-charset-map locale="en_US" charset="ISO-8859-1"/>
   <locale-charset-map locale="ja" charset="UTF-8"/>
   <locale-charset-map locale="ja_JP" charset="UTF-8"/>
   <locale-charset-map locale="fr" charset="UTF-8"/> 
   <locale-charset-map locale="fr_FR" charset="UTF-8"/>
   <locale-charset-map locale="de" charset="UTF-8"/>
   <locale-charset-map locale="de_DE" charset="UTF-8"/>
   <locale-charset-map locale="it" charset="UTF-8"/>
   <locale-charset-map locale="it_IT" charset="UTF-8"/>
   <locale-charset-map locale="ko" charset="UTF-8"/>
   <locale-charset-map locale="ko_KR" charset="UTF-8"/>
   <locale-charset-map locale="ko_KP" charset="UTF-8"/>
   <locale-charset-map locale="zh" charset="UTF-8"/>
   <locale-charset-map locale="zh_CN" charset="UTF-8"/>
   <locale-charset-map locale="zh_TW" charset="UTF-8"/>
  </locale-charset-info>
</sun-web-app>