CA AuthMinder Windows Installation Guide › Preparing for Localization › Adding New Locales

Adding New Locales

AuthMinder supports English (US) out-of-the-box. To add a custom language other than English, perform the following tasks:

1. Navigate to the appropriate location in your <APP_SERVER_HOME> where the arcotadmin/WEB-INF/classes/ directory is available, after you deployed the arcotadmin.war.

   For example, on Apache Tomcat this location is <TOMCAT_HOME>/webapps/arcotadmin/WEB-INF/classes/.

2. Append the locale (see List of Available Locales) of the language that you want to localize to as the suffix to the following files:
   • adminconsole-admin-error.properties
   • adminconsole-admin-message.properties
   • adminconsole-admin-report.properties
   • framework-admin-error.properties
   • framework-admin-message.properties
   • framework-common-message.properties
   • framework-report-messages.properties
   • framework-useraccount-status.properties
   • message.properties
   • webfort-admin-error.properties
   • webfort-admin-message.properties
   • webfort-admin-report.properties

   For example, if you are localizing to Japanese, then add the suffix _ja_JP to all the preceding properties files. In this case, the adminconsole-admin-error.properties file name changes to adminconsole-admin-error_ja_JP.properties.

   See the "List of Available Locales" section to identify the locale string for a specific language and country.

3. Convert and save all the *<locale>.properties files to UTF-8 by using the native2ascii.exe tool, which is available in <JAVA_HOME used by Application Server>\bin.
4. Navigate to <install_location>\Arcot Systems\resourcepacks\i18n\, and:
5. Create a subdirectory called webfort.
6. Copy the converted and saved properties files to the <install_location>\Arcot Systems\resourcepacks\i18n\webfort directory.
7. Open the Command Prompt window.
8. Navigate to the <install_location>\Arcot Systems\tools\common\bundlemanager\ directory.
9. Run the following command to integrate the newly-ported resource bundles with the adminframework.war file and re-create arcotadmin.war under <install_location>\Arcot Systems\java\webapps\:

   java -jar bundle-manager.jar
   

10. Re-deploy the arcotadmin.war. See "Deploying Administration Console" and "Verifying the Administration Console" for more information.