Globalization prerequisites for installing WebSphere Commerce

Before you install WebSphere Commerce, ensure that the system meets all globalization prerequisites for your operating system.

Globalization prerequisites

WebSphere Commerce Version 8.0 supports ICU4J version 55. These tables provide configuration details for some of the locales that are supported by WebSphere Commerce. For details about the configuration settings for other locales, see your operating system documentation.

Operating system Description
WebSphere Commerce uses only valid Java language locales. Ensure that your systems are set to the appropriate national language locale.
  1. Ensure that the primary cultural convention and primary language translation are set to UTF-8 for your language: You can set the primary cultural convention and primary language translation by completing these steps:
    1. Log on as the root user.
    2. Issue the following command: smit mlang
    3. Select Change/Show Primary Language Environment. Change the value to match the table.
    4. Select Change/Show Cultural Convention, Language, or Keyboard. Change the value to match the table.
    5. Exit SMIT.
    6. Log off.
  2. Ensure that locale-related environment variables are set to include the locale that is supported by WebSphere Commerce:
    Language Locale Code LC_ALL value
    Brazilian Portuguese PT_BR PT_BR
    English EN_US EN_US
    French FR_FR FR_FR
    German DE_DE DE_DE
    Italian IT_IT IT_IT
    Japanese JA_JP JA_JP
    Korean KO_KR KO_KR
    Polish PL_PL PL_PL
    Romanian RO_RO RO_RO
    Russian RU_RU RU_RU
    Simplified Chinese ZH_CN ZH_CN
    Spanish ES_ES ES_ES
    Traditional Chinese ZH_TW ZH_TW
    To determine your locale, run the following command: locale
    If your locale is not supported, change your locale properties by running the following commands as root user: 
    LANG=xx_XX
export LANG
LC_ALL=xx_XX
export LC_ALL
    where xx_XX is the four letter locale code with the same capitalization as shown in the table.
    Note: Ensure that the WebSphere Commerce non-root user's locale is set to the appropriate language. If the locale is not set properly, some of the WebSphere Commerce tools do not display properly.
For national languages, WebSphere Commerce uses only valid Java language locales. Ensure that your systems have the appropriate national language locale for your language installed. Ensure that any locale-related environment variables are set to include the WebSphere Commerce supported locale.
Language CCSID LangID CountryID
English 37 ENU US
French 297 FRA FR
German 273 DEU DE
Italian 280 ITA IT
Spanish 284 ESP ES
Brazilian Portuguese 37 PTB BR
Japanese 5035 JPN JP
Korean 933 KOR KR
Traditional Chinese 937 CHT TW
Simplified Chinese 935 CHS CN
Romanian 870 ROM RO
Russian 1025 RUS RU
Polish 870 PLK PL
For national languages, WebSphere Commerce uses only valid Java language locales. Ensure that your systems have the appropriate national language locale for your language installed. Ensure that any locale-related environment variables are set to include the WebSphere Commerce supported locale.
Language CCSID LangID CountryID
English 37 ENU US
French 297 FRA FR
German 273 DEU DE
Italian 280 ITA IT
Spanish 284 ESP ES
Brazilian Portuguese 37 PTB BR
Japanese 5035 JPN JP
Korean 933 KOR KR
Traditional Chinese 937 CHT TW
Simplified Chinese 935 CHS CN
Romanian 870 ROM RO
Russian 1025 RUS RU
Polish 870 PLK PL
Language Locale Code LC_ALL value
German de_DE.UTF-8 de_DE.UTF-8
English en_US.UTF-8 en_US.UTF-8
Spanish es_ES.UTF-8 es_ES.UTF-8
French fr_FR.UTF-8 fr_FR.UTF-8
Italian it_IT.UTF-8 it_IT.UTF-8
Japanese ja_JP.UTF-8 ja_JP.UTF-8
Korean ko_KR.UTF-8 ko_KR.UTF-8
Brazilian Portuguese pt_BR.UTF-8 pt_BR.UTF-8
Simplified Chinese zh_CN.UTF-8 zh_CN.UTF-8
Traditional Chinese zh_TW.UTF-8 zh_TW.UTF-8
Polish pl_PL.UTF-8 pl_PL.UTF-8
Romanian ro_RO.UTF-8 ro_RO.UTF-8
Russian ru_RU.UTF-8 ru_RU.UTF-8
To determine your locale, run the following commands, depending on the Linux distribution you are using:
Linux distribution Command
Red Hat Linux
  • echo $LANG
SUSE Linux
  • echo $LANG
  • echo $LC_CTYPE
If your locale is not supported, change your locale properties by running one of the following sets of commands as root user, depending on the Linux distribution you are using:
Linux® distribution Command
Red Hat Linux® 
LANG=xx_XX
export LANG
SUSE Linux 
LANG=xx_XX
export LANG
LC_CTYPE=xx_XX
export LC_CTYPE
Where xx_XX is your four letter locale code with the same capitalization as shown in the preceding table.
Notes:
  1. Ensure that the WebSphere Commerce non-root user's locale is set to the appropriate language. If the locale is not set properly, some of the WebSphere Commerce tools do not display properly.
  2. In SUSE environments, you can avoid any locale-related issues by changing the locale at the operating system level. Use the YaST command to change the locale.
  1. Open the Control Panel or Control Panel menu from the Start bar.
  2. Select Regional and language settings. Click the Advanced tab.
  3. Make sure that the required code pages are checked in the Code page conversion table.
  4. Open a Command Prompt. Enter the CHCP command to change the code page. The code page for UTF-8 is 65001. Run the following command:
    CHCP 65001

For double-byte national languages (Japanese, Korean, Simplified Chinese, and Traditional Chinese), ensure that the local language of the machine is set to the language in which you read the prompts in the installation wizard.

If the operating system language setting does not match the language that you select for the installation wizard, the prompts do display correctly. For Simplified Chinese and Traditional Chinese, the installation wizard prompt displays in English if the operating system language setting does not match the language that you select for the installation wizard.