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 7 supports ICU4J version 3.4.5. 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 systemDescription
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:
    LanguageLocale CodeLC_ALL value
    Brazilian PortuguesePT_BRPT_BR
    EnglishEN_USEN_US
    FrenchFR_FRFR_FR
    GermanDE_DEDE_DE
    ItalianIT_ITIT_IT
    JapaneseJA_JPJA_JP
    KoreanKO_KRKO_KR
    PolishPL_PLPL_PL
    RomanianRO_RORO_RO
    RussianRU_RURU_RU
    Simplified Chinese ZH_CNZH_CN
    Spanish ES_ESES_ES
    Traditional ChineseZH_TWZH_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 CodeLC_ALL value
German de_DE.UTF-8 de_DE.UTF-8
Englishen_US.UTF-8 en_US.UTF-8
Spanishes_ES.UTF-8 es_ES.UTF-8
Frenchfr_FR.UTF-8 fr_FR.UTF-8
Italianit_IT.UTF-8 it_IT.UTF-8
Japaneseja_JP.UTF-8 ja_JP.UTF-8
Koreanko_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
Polishpl_PL.UTF-8 pl_PL.UTF-8
Romanianro_RO.UTF-8 ro_RO.UTF-8
Russianru_RU.UTF-8 ru_RU.UTF-8
To determine your locale, run the following commands, depending on the Linux distribution you are using:
Linux distributionCommand
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.
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 CodeLC_ALL value
German de_DE.UTF-8 de_DE.UTF-8
Englishen_US.UTF-8 en_US.UTF-8
Spanishes_ES.UTF-8 es_ES.UTF-8
Frenchfr_FR.UTF-8 fr_FR.UTF-8
Italianit_IT.UTF-8 it_IT.UTF-8
Japaneseja_JP.UTF-8 ja_JP.UTF-8
Koreanko_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
Polishpl_PL.UTF-8 pl_PL.UTF-8
Romanianro_RO.UTF-8 ro_RO.UTF-8
Russianru_RU.UTF-8 ru_RU.UTF-8
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.
  1. On Windows 2003:
    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.
  2. On Windows 2003 and Windows 2008:
    • 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.