The following locale error occurs when trying to install CABI 3.2 on Redhat Linux: Locale Check Failed

Document ID : KB000049661
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

Getting the following locale error when trying to install CABI 3.2 on Redhat Linux or Solaris:

Locale Check Failed. This could be due to one of the following reasons:

  • None of the environment variables: LC_ALL, LC_CTYPE and LANG have been set. At least one of these variables must be set to a valid utf8/UTF-8 locale.(ex en_US.UTF-8)

  • The language of the installer does not match the language set in the locale (An English installer will install on any locale provided it is utf8/UTF-8. A Non English installer requires a valid utf8/UTF-8 locale of the same language.)

  • BusinessObjects Enterprise currently only supports locales using UTF-8 and utf8 encoding. The locale set could be a non utf8/UTF-8 locale. Please refer the BIEK documentation for the complete list of supported locales.

  • The Locale that is set is either invalid or is a valid utf8/UTF-8 locale that is not installed on the system. The list of installed Locales can be viewed with the locale -a command.

Solution:

As per the CABI implementation guide BusinessObjects Enterprise currently only supports locales using UTF-8 and utf8 encoding. The locale set could be a non utf8/UTF-8 locale.

Upon seeing the above error message you should modify the locale / language settings to the correct locale for Linux or Solaris.

Linux uses: en_US.utf8
Solaris uses: en_US.UTF-8

The below example is showing the change required when installing on Redhat:

LC_ALL=en_US.utf8 
LANG=en_US.utf8 
export LC_ALL 
export LANG

Once done you can verify the changes have been set by typing:

Locale

You should see similar to:

LANG=en_US.UTF-8
LC_CTYPE="en_US.utf8"
LC_NUMERIC="en_US.utf8"
LC_TIME="en_US.utf8"
LC_COLLATE="en_US.utf8"
LC_MONETARY="en_US.utf8"
LC_MESSAGES="en_US.utf8"
LC_PAPER="en_US.utf8"
LC_NAME="en_US.utf8"
LC_ADDRESS="en_US.utf8"
LC_TELEPHONE="en_US.utf8"
LC_MEASUREMENT="en_US.utf8"
LC_IDENTIFICATION="en_US.utf8"
LC_ALL=en_US.utf8