Manually Setting UTF-8 Options

This section describes changes you must make to your Application Server environment after selecting UTF-8 support during Live Collaboration Server installation. These changes apply to all platforms besides AIX.

This task shows you how to:

Related Topics
Manually Setting UTF-8 Options for AIX
Automated UTF-8 Settings
Installing Multiple ENOVIA Live Collaboration Servers (RIP only)

Make manual changes for WebLogic

To make manual changes for WebLogic:

  • Edit the startWLS file located in the WebLogic installation directory for your platform (see table below). In $JAVA_OPTIONS or on the line that starts up the Java process, add the following after the classpath:

    -Dfile.encoding=ENCODING

    where ENCODING is the character encoding in which the JVM will run. This needs to be set to UTF-8.

    For example, the line should read:

    $JAVA $JAVA_OPTIONS -ms128m -mx128m -classpath $JAVACLASSPATH -Dfile.encoding=UTF-8 ...weblogic.Server
    

    Note: Java accepts both UTF-8 and UTF8.

    UNIX/Linux:

    Edit the startWebLogic.sh/startWLS.sh file.

    Windows:

    Edit the startWebLogic.cmd/startWLS.cmd file.

Make manual changes for WebSphere

To make manual changes for WebSphere:

  1. Open the WebSphere admin console (http://MACHINE_NAME:9090/admin) and log in.

  2. Click Servers > Application Servers in the left-side tree.

  3. Click the server name in the right-side frame.

  4. Scroll down and click Process Definition > Java Virutal Machine in the right-side frame.

  5. Scroll down to the Generic JVM arguments field and add the following:

    -Dclient.encoding.override=UTF-8
    -Ddefault.client.encoding=UTF-8
    -Dfile.encoding=UTF-8
    

    For AIX you also need:

    -Xmso1152k -Xss1024k
    

  6. Click OK > Save at the top of the page.

  7. Stop and restart the server.

Make manual changes for Sun Java System Application Server

To make manual changes for Sun Java System Application Server:

  • Using the Sun Java System Application Server Administrator's console, add the following JVM option on the JVM settings tab:

    -Dfile.encoding=UTF-8
    

Make manual changes for Tomcat

To make manual changes for Tomcat:

  1. In TOMCATINSTALLDIR/bin/startup.sh, add the following:

    CATALINA_OPTS="-Dfile.encoding=UTF-8 -server"
    

  2. In TOMCATINSTALLDIR/webapps/enovia/WEB-INF/web.xml, uncomment the Tomcat UTF-8 settings:

    <!--  TomCat UTF-8 settings
       <filter>
          <filter-name>Set Character Encoding</filter-name>
          <filter-class>com.matrixone.servlet.SetCharacterEncodingFilter</filter-class>
          <init-param>
             <param-name>encoding</param-name>
             <param-value>UTF-8</param-value>
          </init-param>
       </filter>
       <filter-mapping>
          <filter-name>Set Character Encoding</filter-name>
          <url-pattern>/*</url-pattern>
       </filter-mapping>
    -->
    

  3. In TOMCATINSTALLDIR/conf/server.xml, add the URIEncoding parameter to the connector, as shown below in bold:

    <Connector acceptCount="100" connectionTimeout="20000" 
    disableUploadTimeout="true" port="8080" redirectPort="8443" 
    URIEncoding="UTF-8"/>