Version 2021

Configure the locale of the account-based Identity Server

Identity Server only recognizes the following locales by default. Locales not in this list go through the fallback process.

  • da
  • it
  • pt-BR
  • de
  • ja
  • sv
  • en
  • ko
  • zh
  • es
  • nl
  • zh-CN
  • es-Es
  • pl
  • zh-TW
  • fr
  • pt
 

To support additional locales

  1. Get the message bundle file for the locale to be supported.
  2. Save the message bundle as MessageBundle_<locale>.properties in <usher server installation path>/usherApps/shardIDM/webapps/ROOT/WEB-INF/classes/. An example of en_us would be MessageBundle_en_US.properties.
  3. Open <usher server installation path>/usherApps/shardIDM/webapps/ROOT/WEB-INF/classes/application.conf.
  4. Locate the following array:

    Copy
    message.langs = [“en”,“zh-CN”,“fr”,“da”,“de”,“es-Es”,“it”,“ja”,“ko”,“nl”,“pl”,“pt-BR”,“sv”,“zh-TW”,“zh”,“pt”,“es”]
  5. Add the locale to be supported the array and save the change.
  6. Restart the IDM server (Tomcat instance).

Please note this change is not preserved after redeployment of an updated war file. This process needs to be repeated after deployment.