KNOWLEDGE BASE

Not able to start VizQL server after configuring vizqlserver.vmopts


Published: 23 Jun 2021
Last Modified Date: 23 Jun 2021

Issue

Not able to start VizQL server in Tableau Server 2021.1.x after configuring vizqlserver.vmopts with the custom values including "UseParNewGC" such as:

tsm configuration set -k vizqlserver.vmopts -v "-XX:+UseConcMarkSweepGC -Xmx2g -Xms256m -XX:MaxNewSize=208m -XX:SurvivorRatio=5 -XX:+UseParNewGC -XX:+CMSParallelRemarkEnabled -XX:TargetSurvivorRatio=90 -XX:MaxTenuringThreshold=15 -XX:+CrashOnOutOfMemoryError -XX:-CreateMinidumpOnCrash"

Environment

  • Tableau Server 2021.1.2
  • Windows Server 2019

Resolution

Perform the steps below to undo the custom configuration changes made to vizqlserver.vmopts:

tsm stop
tsm configuration set -k vizqlserver.vmopts -d
tsm pending-changes apply
tsm start

Cause

This is the error found in stdout_vizqlserver_node1-0.log:

OpenJDK 64-Bit Server VM warning: Option UseConcMarkSweepGC was deprecated in version 9.0 and will likely be removed in a future release.
Unrecognized VM option 'UseParNewGC'
[ERROR] Error -6: Failed to initialize Java VM.

vizQL server will fail to start up due to -XX:+UseParNewGC which was set by default for Java 8 and no longer is no longer a valid option in Java 11.

Additional Information

Example of article using the affected parameters for increasing the max heap size (-Xmx):

https://kb.tableau.com/articles/issue/error-unknown-error-when-viewing-a-published-workbook-that-contains-multiple-filters-and-marks-in-a-view
Did this article resolve the issue?