KNOWLEDGE BASE

Search & Browse Process Fails Intermittently


Published: 11 Mar 2019
Last Modified Date: 29 May 2020

Issue

Search & Browse process terminates abruptly intermittently. Tableau Server logs indicate that the process was terminated due to Java Heap Out of memory.
 

Environment

  • Tableau Server 2018.2 or higher
  • Windows Server

Resolution

Increase the size of Java Heap Maximum Memory for the process

Steps:
1. Get the current value for Java Heap Size of Search & Browse process (searchserver.vmopts)
tsm configuration get --k <config.key> [global options]
Command and returned value:
tsm configuration get -k searchserver.vmopts
-XX:+UseConcMarkSweepGC -Xmx512m -Xms256m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData


2. Increase the Java Heap Maximum Memory (-Xms) from 512MB to 1GB
before: -XX:+UseConcMarkSweepGC -Xmx512m -Xms256m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData
after:    -XX:+UseConcMarkSweepGC -Xmx1g -Xms256m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData

3. Set the new value for Java Heap Size of Search & Browse process (searchserver.vmopts)
tsm configuration set --k <config.key> --v "<config_value>" [global options]
Commands:
tsm configuration set -k searchserver.vmopts -v "-XX:+UseConcMarkSweepGC -Xmx1g -Xms256m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData"
tsm pending-changes apply


Quotes around the <config_value> are optional unless there are spaces, in which case you must use quotes around the value.

CAVEAT: Unlike pre-2018.2 command, the <config_value> should not be enclosed in both double- and single-quotes even it begins with a hyphen.

Additional Information

Pre-2018.2 command: tabadmin set <config.key> "'<config_value>'"
Commands:
tabadmin set searchserver.vmopts "'-XX:+UseConcMarkSweepGC -Xmx1g -Xms256m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData'"

tabadmin config

If the <config_value> begins with a hyphen, enclose the value in both double-quotes (") and single-quotes (').
Did this article resolve the issue?