KNOWLEDGE BASE

Tableau Server Initialize-Tsm Fails With Locale Error


Published: 02 Jul 2020
Last Modified Date: 17 Jul 2020

Issue

After "yum install" of Tableau Server, the next step "initialize-tsm" fails with locale error:

$ sudo /opt/tableau/tableau_server/packages/script<version>/initialize-tsm --accepteula -a user1 -f

Locale 'en_IN' is not using UTF-8 encoding. UTF-8 is required.
Example UTF-8 locales are en_US.UTF-8 or ja_JP.UTF-8 etc. Run 'locale -a' to see
a list of supported locales on your system.
Canceling.

Environment

  • Tableau Server
  • CentOS 7

Resolution

Check the system locale of the Linux to ensure it falls into the 11 supported locales, refer to Additional Information.

To check system locale, run the commands below:

$  cat /etc/locale.conf
$  localectl


To set the locale correctly, run the commands below:

$ sudo yum update systemd      (optional, run only if the systemd is in old version that causes the following command not updating)
$ sudo localectl set-locale LANG=en_US.UTF-8

In some cases, setting the above still may not resolve the issue. In that case, it may be the shell of the Linux prompt uses a specified locale. Run the commands below to set the environment variable for the shell:

$ localedef -c -f UTF-8 -i en_US en_US.UTF-8
$ export LC_ALL=en_US.UTF-8

After this, re-run the initialize-tsm command

 

Cause

Tableau Server runs on a system using one of the following locales:

de_DE, en_GB, en_US, es_ES, fr_FR, it_IT, ja_JP, ko_KR, pt_BR, zh_CN, or zh_TW.

Any other locale will generate the error.
 

Did this article resolve the issue?