...
This document relates to Grouper and internationalization, handling non-English characters, utfUTF-8, accents, etc.
Grouper and non-English characters
...
also the default for grouper.base.properties for file encoding was changed. If you dont don't need non english -English chars and you are worried about the risk of this change please change it in grouper.properties
...
These settings will detect if you database and file system can handle utfUTF-8, and if transactions, and case sensitivity are handled correctly. You can get a success message if you are debugging, but this defaults to off. These will run in another thread so they dont affect start time (optionally default to true)
...
Grouper and UTF-8
For Grouper to handle utfUTF-8 characters:
Make sure java starts with this setting: -Dfile.encoding=UTF-8 for example, in tomcat, put something like this in your startup script:
Code Block export JAVA_OPTS="-server -Xms50M -Xmx200M -XX:MaxPermSize=95M -Dfile.encoding=UTF-8"
Make sure URIEncoding is set to UTF-8 in the server.xml in tomcat in the Connector element, here is an example
Code Block <Connector port="8111" protocol="AJP/1.3" request.tomcatAuthentication="false" URIEncoding="UTF-8" />
- Make sure your database tables are using UTF-8. If not, e.g. for mysql, you might need to SQL dump, delete the DB, create with default UTF-8 bin collation, and import the SQL.
Make sure your connect string to the database is configured to use UTF-8 (if applicable). For mysql, here is an example (see the stuff after the question mark). Note, in windows mysql this isnt isn't necessary
Code Block hibernate.connection.url = jdbc:mysql://localhost:3306/grouper_v2_2?CharSet=utf8&useUnicode=true&characterEncoding=utf8
...
If you want to add a localization to the grouper Grouper UI text (example for french):
...
Change your browser to prefer french French from franceFrance, (either wait a bit or bounce app server), and hit the UI and you should see your french French text
Code changes
In the tomcat server.xml Edit the <Connectors to have uri encoding of utf8, e.g. <Connector URIEncoding="UTF-8"
...