KNOWLEDGE BASE

Incorrectly Changing the <process>.vmopts Configuration Option May Cause The Process To Become STATUS_UNAVAILABLE And Fail To Start


Published: 07 Oct 2022
Last Modified Date: 11 Oct 2022

Issue

After changing a <process>.vmopts configuration option or importing a .json configuration file of an older Tableau Server version, the result of "tsm status -v" may be STATUS_UNAVAILABLE and the processes may fail to start.

Please note: These values should be changed from the default values only when absolutely necessary for troubleshooting or performance tuning as designated by a Technical Support Engineer, Tableau Online Help, or a Tableau knowledge article.

 

Environment

  • Tableau Server

Resolution

Perform the following commands to set the configuration option changes back to the default values:
  1. tsm configuration set -k <process>.vmopts -d
  2. tsm pending-changes apply

To check the default values use the following command to ensure the custom values (JVM options) are in the correct format.  Do not omit any necessary settings of the current version. 
tsm configuration get -k <process>.vmopts

Cause

 A <process>.vmopts update has occurred that is not valid.

Additional Information

The following error can be found in stdout_<process>_node<n>-<0>.log:
Loading JVM library <path>\data\tabsvc\services\<process>_0.<build number>\repository\jre\bin\server\jvm.dll
Unrecognized option: <custom values>
[ERROR] Error -1: Failed to initialize Java VM.
Did this article resolve the issue?