KNOWLEDGE BASE

Adding Nodes to a Tableau Server 2019.4.0 Cluster Fails with Fatal Error When Bootstrap File or Path Contains a Space


Published: 24 Oct 2019
Last Modified Date: 16 May 2020

Issue

When adding a node to a Tableau Server 2019.4.0 cluster on Windows, the installation of Tableau Server on the new node eventually fails and rolls back. The first error that might occur is as followed:

"Tableau Service Manager (TSM) Error: The server may not have started properly. Part of the installer exited with error code:1. Check the logs: [path]\logs\app-worker-install.log for more information. [OK]"

After clicking OK, the installation rolls back and the installer displays:

"Setup Failed: One or more issues caused the setup to fail. Please fix the issues and then retry setup. For more information see the log file. 0x80070643 - Fatal error during installation." 

Environment

  • Tableau Server 2019.4.0
  • Windows
  • Mutli-node installation

Resolution

Option 1

Install Tableau Server 2019.4.1 or a newer version. Click here for downloads of current and previous versions of Tableau Server: Tableau Server Downloads and Release Notes. For more information on current releases, see Upgrade Tableau Server and Server Upgrade.

Option 2

Work with your Tableau Server Administrator to perform the steps below:
  1. Run the obliterate script on the node which has the failed installation. For more information about the obliterate script, see Remove Tableau Server from Your Computer in Tableau Help. 
  2. If the bootstrap filename has a space in it, create a new bootstrap file without a space in the name.
  3. Put the bootstrap file in a path which contains no spaces.
  4. Re-run the installation on the node which had the failed installation.

Cause

Tableau Server 2019.4.0 for Windows does not handle a space in the bootstrap file or the path to the bootstrap file. This behavior is tracked under known issue 1020319 and has been corrected in more recent releases.

Additional Information

Renaming the file to remove a space will not work - a new bootstrap file must be generated without a space in the name.



Discuss this article... Feedback Forum
Did this article resolve the issue?