User Console Design Guide › CA Identity Manager Localization › How to Configure Support for Localization › Localization Prerequisites

Localization Prerequisites

Before configuring CA Identity Manager for localization, note the following:

• CA Identity Manager must be installed and configured, and at least one Environment must exist.

  Note: If you are using CA SiteMinder and your Environment manages users with multi-byte user IDs, those users must authenticate with a CA SiteMinder authentication scheme that supports multi-byte characters. For example, HTML Forms Based authentication. The basic authentication scheme does not support multi-byte authentication. For information on configuring an authentication scheme for CA Identity Manager, see the chapter on configuring CA SiteMinder Features for CA Identity Manager in the Configuration Guide.

• If you are using CA SiteMinder, ensure that a supported version of the CA SiteMinder Policy Server is installed and configured.
• Ensure the user directory is configured to support localization. For more information, see the documentation for the user store you are using.
• If you are using an LDAP directory as a user store, verify that the LDAP directory is not enforcing a 7-bit check for the user ID, password, and email attribute. For more information, see the documentation for the LDAP directory you are using.
• If you are using an Oracle database object store, verify that the character set component in the NLS_LANG parameter, and the database character encoding are set to AL32UTF8, a multi-byte character set.

  CA Identity Manager uses multi-byte character encoding (UTF-8). If you specify a single-byte character set, characters may appear corrupted because of insufficient character space.

  Note: For instructions on setting the NLS_LANG parameter and the database character encoding, see the Oracle documentation.

• CA Identity Manager includes tools that you use to localize a new CA Identity Manager environment.To use these tools, you need the following software:

  Java SDK native2ascii tool

  Translates to and from Unicode escape sequences. Because localization mainly involves the translation of property files, the tools process all files in ASCII with Unicode escape sequences.

  To configure the localization tools, install the native2ascii tool by installing a JDK on the system where the CA Identity Manager Administrative Tools are installed.

  For information about the native2ascii tool, go to the following location at the Java Web site:

  http://java.sun.com/j2se/1.5.0/docs/guide/intl/index.html

  ant 1.7 or greater