KNOWLEDGE BASE

Error "Could not connect to TSM Controller at 'tableauserver.host.local:8850'." After Failing to execute any tsm Command


Published: 29 Oct 2018
Last Modified Date: 29 Nov 2019

Issue

When you try to run any tsm command, the following error occurs:

Could not connect to TSM Controller at 'tableauserver.host.local:8850'.
 

The following errors can be found in the tabadminfcontroller logs:

Command line operation failed to execute 
Error creating bean ... Initialization of bean failed; nested exception is java.lang.OutOfMemoryError: GC overhead limit exceeded

Environment

  • Tableau Server 
  • Linux

Resolution

There is a way to change the java heap space usage using tsm command, but since tsm command could not be run at all, the admin user will have to manually edit the configuration file to implement this change:
  1. Edit the tabadmincontroller.runjavaservice.json file in the path:   "/var/opt/tableau/tableau_server/data/tabsvc/config/tabadmincontroller_0.20181.18.0706.1237"
In 2018.1 versions, this file will look like this:
{   "jvmOptions" : [ "-Djavax.net.ssl.trustStore=/var/opt/tableau/tableau_server/data/tabsvc/config/tabadmincontroller_0.20181.18.0807.1415/cacerts", "-Xss2m", "config.properties=file:///var/opt/tableau/tableau_server/data/tabsvc/config/tabadmincontroller_0.20181.18.0807.1415/tabadmincontroller.properties" ],   "libraryPath" : [ "/var/opt/tableau/tableau_server/data/tabsvc/services/tabadmincontroller_0.20181.18.0807.1415/bin" ] }

Manually add the "-Xmx512m" entry into the first line to look like this:
{   "jvmOptions" : [ "-Xmx512m", "-Djavax.net.ssl.trustStore=/var/opt/tableau/tableau_server/data/tabsvc/config/tabadmincontroller_0.20181.18.0807.1415/cacerts", "-Xss2m", "config.properties=file:///var/opt/tableau/tableau_server/data/tabsvc/config/tabadmincontroller_0.20181.18.0807.1415/tabadmincontroller.properties" ],   "libraryPath" : [ "/var/opt/tableau/tableau_server/data/tabsvc/services/tabadmincontroller_0.20181.18.0807.1415/bin" ] }
  1. Once this edit is complete, save the file.
  2. Restart Tableau Server, or if possible, reboot the machine.

This should get past the OutOfMemory Error, admin user should be able to run tsm commands after this.

The resolution above, by manually editing the configuration file, will be overwritten at the next "tsm pending-changes apply" command.

In order to make this change permanent, please have the admin user run the following tsm commands:
# tsm configuration set -k tabadmincontroller.vmopts -v "-Xmx512m"
# tsm pending-changes apply

Cause

The Java heap space is low for the tabadmincontroller process.
Did this article resolve the issue?