... h4. {color:#005480}OpenSSO Globalization{color}
This page contains information OpenSSO Globalization, which is super set of activities related to Internationalization(I18n) and Localization(L10n). An International user of OpenSSO can not only see OpenSSO in English language but also in localized version Of OpenSSO in their local Language.
{panel}
{section}
{column:width=50%}
h1. Frequently Asked Questions
{expand:*Whats new in OpenSSO regarding Globalization?*}
With OpenSSO 8.0 release, 7 non-English languages are bundled by default for all OpenSSO supported platforms along with the base product binary. Adding these languages does not need any additional steps while installing/configuring OpenSSO now.
{expand}
{expand:*What are the Languages supported by OpenSSO?*}
OpenSSO by default is shipped with 7 non-English Languages. There are no additional installation or configuration steps required to have these languages in your OpenSSO deployment. Following are the languages available by default:
* German (de)
* French (fr)
* Spanish (es)
* Japanese (ja)
* Korean (ko)
* Simplified Chinese (zh_CN)
* Traditional Chinese (zh_TW)
{expand}
{expand:*Is OpenSSO Internationalized?*}
Yes, OpenSSO is completely Internationalized. Saying that, one will be able to plug-in any new language of your requirement to OpenSSO without making any changes to the code base.
{expand}
{expand:*What is Localized in OpenSSO?*}
OpenSSO is Localized in 7 non-English languages as mentioned above. Content in the Browser User Interface(BUI), Command Line Interface(CLI) has been completely Localized. In the BUI - the core product functionality and Help contents and screens can be seen in above mentioned 7 non-English languages.
{expand}
{expand:*How to install and configure OpenSSO in non-English language from browser?*}
* Download the latest version of OpenSSO from the OpenSSO Download Page
* Deploy the opensso.war on Web Containers Supported For OpenSSO Enterprise 8.0 in Sun OpenSSO Enterprise 8.0 Release Notes
* From browser, set the browser preferred language to a Language that OpenSSO is Localized in by default. Example: German(de), French(fr), Spanish(es), Japanese(ja), Korean(ko), Chinese/Simplified Chinese(zh/zh_ZN), Traditional Chinese(zh_TW)
* Provide the OpenSSO application URL in the browser - You will now see the OpenSSO Installation and Configuration page completely localized through out\!
{expand}
{expand:*How to set Language/Locale for OpenSSO after installation?*}
Once you have installed and configured OpenSSO, there are various ways to see Localized versions of OpenSSO, they are:
* Append "locale" paramter to the OpenSSO application URL. Ex: PROTOCOL://HOST:PORT/opensso_app?locale=ja
* Set a locale value to te Accept-Language header of HTTP Request
* User Preferred Locale - Language of the OpenSSO can be set based on the user who logs into OpenSSO
* Auth Locale - Org specific locale value
* Platform Locale - which is global value for Entire OpenSSO
* Operating System Locale - Which is the value returned by java.util.Locale.getDefault() call
{expand}
{expand:*What is locale fallback?*}
Locale fallback is often termed to note the order in which the locale setting happens on priority basis to display Localized OpenSSO.
{expand}
{expand:*How does locale fall back happen in OpenSSO?*}
Locale fallback happens in the following order, where Priority 0 is Last priority and Priority 5 is Highest Priority:
* Priority 0 - OS_LOCALE - value returned by java.util.Locale.getDefault()
* Priority 1 - PLATFORM_LOCALE - iplanet-am-platform-locale attribute value in iPlanetAMPlatform Service - Global value for entire OpenSSO
* Priority 2 - AUTH-LOCALE - iplanet-am-auth-locale attribute value in iPlantAMAuth service - Org specific locale value
* Priority 3 - USER_LOCALE - preferredlocale - iPlanetAMUser service and it can be configured per org and user level
* Priority 4 - HTTP_HEADER_LOCALE - Accept-Language header of HTTP Request
* Priority 5 - URL_LOCALE - locale value passed as URL parameter
{expand}
{expand:*How to use OpenSSO Command Line Interface(CLI) utilities in Localized OS?*}
OpenSSO provides a set of Tools/Utilities that can be run from the Command Line Interface(CLI) of any OpenSSO Supported Operating Systems. For Example: Telnet terminal in Solaris. Therefore, all the CLI Utilities of OpenSSO are localized for great International user Experience.
When you are using a non-English Operating System to run OpenSSO CLI utilities, there are no additional steps required to see the OpenSSO CLI tools messages in non-English. However, when you are using an English Operating System containing Localized Language packages on the Operating System, you need to do the following to run CLI tools in non-English.
Below Example demonstrates setting a terminal to Japanese in Solaris Operating System:
* Open terminal and run the following commands
* > export LANG=ja_JP.UTF-8
* > export LC_ALL=ja_JP.UTF-8
* > locale
** Run locale command to verify if your terminal is now set to Japanese locale
* *TIP:* type "locale \-a" command to see the available locales in the Solaris OS
* *NOTE:* Japanese language pack needs to be installed order to set the terminal to Japanese and have the fonts rendered correctly, else its is likely that you may see garbled characters in the terminal.
{expand}
{expand:*OpenSSO Login page in non-English in your Language with your Localized Messages*}
With OpenSSO you can customize and your Localized OpenSSO Login page with your desired messages. For Example, you can make the OpenSSO Login page to Look like your Own Application's Login Page and that too with your desired Localized text.
Read the [Localizaing the Sun OpenSSO Enterprise 8.0 Login Page|http://docs.sun.com/source/820-7172/index.html] article to Customize OpenSSO Login Page in your Language.
{expand}
h1. Globalized OpenSSO Sites
*[Japanese|http://wikis.sun.com/display/OpenSSO/OpenSSO_ja]*
*[Simplified Chinese|http://wikis.sun.com/display/OpenSSO/OpenSSO_zh]*
h1. G11n Customization Guides
*[Wiki format of the Localizing the Sun OpenSSO Enterprise 8.0 Login Page|http://wikis.sun.com/display/OpenSSO/Localizing+the+Sun+OpenSSO+Enterprise+8.0+Login+Page]*
{column}
{column:width=50%}
h1. Globalization Blog |