Loading

Tableau Server Initialize-Tsm Fails With Locale Error

Julkaisupäivä: Feb 25, 2026
Kuvaus

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.

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.
 

Ratkaisu
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

 
Knowledge-artikkelin numero

001472682

 
Ladataan
Salesforce Help | Article