Install > Installing WebSphere Commerce > Prepare to install WebSphere Commerce > Prerequisites for installing WebSphere Commerce


Globalization prerequisites for installing WebSphere Commerce


AIX

WebSphere Commerce only uses valid Java language locales. Verify the systems are set to the appropriate national language locale.

Verify the primary cultural convention and primary language translation are set to UTF-8 for the 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.

Ensure that locale-related environment variables are set to include the locale 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 the locale, run the following command: locale

If the locale is not supported, change the 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.

Verify the non-root user's locale is set to the appropriate language. If the locale is not set properly, some of the WebSphere Commerce tools will not display properly.


IBM i

For national languages, WebSphere Commerce only uses valid Java language locales. Verify the systems have the appropriate national language locale installed for the language. 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
Russia 1025 RUS RU
Polish 870 PLK PL

For additional information about IBM i globalization, navigate to the IBM i and System i Information Center, select the operating system version, and review the topics within the "i5/OS Globalization" section.


Linux

For national languages, WebSphere Commerce only uses valid Java language locales. Verify the systems have the appropriate national language locale installed for the language. 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
Russia 1025 RUS RU
Polish 870 PLK PL

To determine the 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 the locale is not supported, change the 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 the four letter locale code with the same capitalization as shown in the preceding table.

Verify the non-root user's locale is set to the appropriate language. If the locale is not set properly, some of the WebSphere Commerce tools will not display properly.

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.


Windows

For national languages, WebSphere Commerce only uses valid Java language locales. Verify the systems have the appropriate national language locale installed for the language. Ensure that any locale-related environment variables are set to include the WebSphere Commerce supported locale.

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.EUC
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 the locale, run the following command:

locale

If the locale is not supported, change the 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 preceding table.

Verify the non-root user's locale is set to the appropriate language. If the locale is not set properly, some of the WebSphere Commerce tools will not display properly.

  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. CHCHP is the command used to change the codepage. 65001 is the codepage for UTF-8. Run the following command, which sets the codepage to UTF-8:

    CHCHP 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 you select for the installation wizard, the prompts will not display correctly. For Simplified Chinese and Traditional Chinese, the installation wizard prompt will display in English if the operating system language setting does not match the language you select for the installation wizard.


+

Search Tips   |   Advanced Search