_Modifying Tomcat's server.xml for Unicode Character Set
If your user directory contains usernames or group names with Unicode characters, you need to modify your Tomcat distribution's conf/server.xml
file. For example, you need to do this if your user directory allows for internationalized characters in usernames.
- In your Tomcat distribution's
conf/server.xml
file, find the connector definition for your HTTP protocol. The connector definition looks very much like this:<Connector port="8080" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true"/>
- Add a
URIEncoding="UTF-8"
property to the connector:<Connector port="8080" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8"/>
This setting affects all web applications
Because you must define this property at the connector level, this setting will affect all web applications you have deployed under the connector. This should not adversely affect the other web applications, but please be aware of this fact. Crowd and CrowdID will run fine without this property set, but you will run into issues if a username or group contains internationalized characters.