Troubleshooting12% of the exam

Validating resources, search index and disk recovery

How to validate and repair a site's workbooks and data sources before migration, recognise and rebuild a broken search index on 2022.3 and later releases, read the Server Disk Space view, and recover space or access when the Tableau Server disk fills.

Official exam objective
4.2 Understand how to: 4.2.1 Reset passwords for a Tableau user or Tableau Run-As Service account; 4.2.2 Package log files for reporting; 4.2.3 Use tsm to validate site resources; 4.2.4 Rebuild the search index; 4.2.5 Use maintenance analysis reports; 4.2.6 Create/open support requests.

~7 min read · 13 practice questions

What the exam expects

  • Use tsm maintenance validate-resources to check and repair a site's workbooks and data sources before a site migration, and handle what it cannot repair.
  • Recognise symptoms of a broken search index and pick the rebuild command for 2022.3 versus 2023.3 and later, including after a failed upgrade.
  • Read the Server Disk Space administrative view as a maintenance analysis report: who can open it, what it measures and why it differs from the operating system.
  • Recover disk space with cleanup, administrative views and the Coordination Service snapshot setting.
  • Restore access to Tableau Server and the TSM web UI after the disk has filled.

Key terms:

  • validate-resources: the tsm maintenance command that validates, and optionally repairs, one site's workbooks and data sources.
  • Search index: the content index behind site lists, project lists and search; on 2022.3 it is rebuilt with tsm maintenance reset-searchserver.
  • Server Disk Space: the administrative view showing disk use on the partition where Tableau Server is installed.
  • Coordination Service: the ZooKeeper-based service whose transaction logs and snapshots are kept in the appzookeeper data folder.
  • --force-keys: a tsm configuration set option that lets you set a key that has not been set before.

Key facts

validate-resources scope
Detail
One site; --site-id is required
validate-resources -r
Detail
Attempts repairs; unrepaired items are noted in output
Index rebuild on 2023.1 and earlier
Detail
tsm maintenance reset-searchserver
Index rebuild on 2023.3 and later
Detail
tsm maintenance reindex-search; reset-searchserver does nothing
Failed final upgrade step
Detail
Rebuild the index from a new admin prompt on the initial node
Server Disk Space access
Detail
Server administrators only, via Manage All Sites
What the view measures
Detail
Tableau Server partition only, in decimal GB
Disk usage monitoring
Detail
On by default
Coordination Service snapshots
Detail
Every 100,000 transaction logs; older than five days deleted
zookeeper.config.snapCount
Detail
Default 100,000 transactions
Access lost after a full disk
Detail
Free space, set a dummy key with --force-keys, apply on the initial node
Sources for this section (5)
  • When reset-searchserver runs, what happens to the existing search information?
  • How do you read the exact free disk space at a moment in the Server Disk Space view?
  • When does low free disk space stop merely slowing Tableau Server down?
  • When you want a configuration key back at its default value, which option do you use?

The questions are free to read. Answers with their sources and self-grading are included with the pack.

Keep reading with the Tableau Server Administrator pack

  • Core concepts
  • Exam traps
  • Worked scenario

The pack includes:

  • All 34 lessons of the Tableau Server Administrator guide, with reading progress
  • Interactive decision walks and step-by-step sequence steppers
  • Practice exams purchase adds inline bank questions and topic practice (13 questions for this lesson)
  • An official source cited for every claim
  • An AI tutor that answers from the guide
  • Choose guide-only, practice-only, or save $4 with both

Practice for the Tableau Server Administrator exam