How to Configure Localization Settings - Identity Manager

Products

• CA Identity Manager
• CA Identity Governance
• CA Identity Portal
• CA Identity Suite

Issue/Introduction

Localization enables administrators to translate User Console elements, such as prompts, buttons, tabs, titles, status messages, and email notifications, into multiple languages. This guide provides instructions for configuring localization within your environment to support languages including French, German, Italian, Japanese, Korean, Polish, Simplified Chinese, and Spanish. Note that Identity Manager reports do not support localization.

Environment

Identity Manager 14.5 & 15

Cause

Localization requires specific configuration steps and prerequisites to correctly map resource bundles and role definitions to the desired language pack.

Resolution

Follow these steps to configure localization in your environment.

1. Prerequisites Ensure Apache Ant (1.7 or later) and Java JDK (1.8 or later) are installed and added to your system path.

• Windows: PATH %JAVA_HOME%\bin;%PATH%
• Windows: PATH %ANT_HOME%\bin;%PATH%

2. Enable Language Switching

1. Navigate to the Management Console: .../iam/immanage.
2. Go to: Environments > > Advanced Settings > User Console.
3. Select the Enable Language Switching checkbox.
   
   
   
   

3. Configure Language Environment Choose the procedure that matches your deployment requirements:

• Option A: Single Language Environment

  1. Locate the sample files in: ...\Identity Manager\IAM Suite\Identity Manager\tools\samples\Localization.
  2. Select the RoleDefinition.xml corresponding to your language folder.
  3. Import the file using the Management Console.
     
     
     
     

• Option B: Multi-language Environment

  1. Export the Roles and Tasks XML from the Management Console.
  2. Tokenize the RolesDefinition.xml by running: ant tokenizeroledef -Dinputfile=RoleDefinitions.xml. This generates RoleDefinitions_Tokenized.xml and RoleDefinitions_Tokenized.properties.
  3. Translate the tokenized file using the dictionary in the Localization directory by running: ant translateroledef -Dinputfile=RoleDefinitions.xml.
  4. Translate resource bundles using: ant translateresourcebundle -Dinputfile=bundlename.properties.
  5. Restart the application server.
  6. Upload the tokenized RolesDefinition.xml into your environment.

4. Deployment Paths

• Wildfly: Place files in <Wildfly_Home>\standalone\deployments\iam_im.ear\custom\resourceBundles.
• JBoss: Place files in <Jboss_directory>\server\default\deploy\iam_im.ear\custom\provisioning\resourceBundles.

Additional Information

For further information about Localization, see documentation Identity Manager Localization - 14.5 or Identity Manager Localization - v15

To speak with a customer representative or a Support Engineer see Contact Support. Scroll to the bottom of the page and click on your respective region.