Install Switches and Properties for Tableau Server

You can use the following installer switches when installing Tableau Server on Windows from the command line.

Note: Beginning with version 2019.4.0, the Tableau Server Setup program is new. The switches and properties below only apply for version 2019.4.0 and later. If you are installing an earlier version of Tableau Server and need information about command line options, see Install Switches for Tableau Server (2019.3 and earlier)(Link opens in a new window) in the 2019.3 Server Administrator Guide. If you are upgrading to version 2019.4.0 or later and have been using install switches in earlier versions, see Changes to Command Line Install Options for Tableau Server Setup for details on specific changes.

Switch Description Comments
/install | /repair | /uninstall | /layout "<directory>"

Run Setup to either install, repair, or uninstall Tableau Server, or with /layout, create a complete local copy of the installation bundle in the directory specified.

Default is to install, displaying UI and all prompts. If no directory is specified on a fresh install, C:\Program Files\Tableau\Tableau Server is assumed. If Tableau Server is already installed, Setup will assume the same location as the current installation.
/passive

Run Setup with minimal UI and no prompts.

Tableau Server does not start automatically when installed in /passive mode. To start Tableau Server, use tsm start.
/quiet | /silent

Run Setup in unattended, fully silent mode. No UI or prompts are displayed.

Tableau Server does not start automatically when installed in /silent or /quiet mode. To start Tableau Server, use tsm start.

Note: Use either /silent or /quiet, not both.

/norestart

Run Setup without restarting Windows, even if a restart is necessary.

Note: In certain rare cases, a restart cannot be suppressed, even when this option is used. This is most likely when an earlier system restart was skipped, for example, during installation of other software.

/log "<drive>\<path>\<log-file>.<ext>" Log information to the specified file and path.

Note: The behaviour when using the /log option changed starting in version 2021.2.0. For more information, see What's New and Changed in Tableau Server

.

Use this switch with a path and log file name to make the log available after installation is complete.

If this switch is used with a log file name but no path, the log file is written to a temporary location and deleted at the end of the installation.

If this switch is used but no log file name is specified, the switch is ignored and the file is written to %TEMP%.

If this switch is not used, the log file is written to %TEMP%.

 

Properties Description Comments
ACCEPTEULA=1|0 Accept the End User Licence Agreement (EULA). Required for quiet, silent and passive install on both initial and additional nodes. 1 = true, accept the EULA, 0 = false, do not accept the EULA.

If not included when using /passive, /silent or /quiet, Setup fails silently.

If included but set to 0, Setup fails.

ACTIVATIONSERVICE="1" Activate Tableau Server using the authorisation-to-run (ATR) service. "1" = use ATR.

This option is for new installs only, not upgrades. Select this option if:

  • You plan to activate Tableau Server online
  • You plan to install Tableau Server in the cloud
  • You plan to install Tableau Server on a virtual machine or other non-persistent environment

Do not use this option if:

  • You plan to activate Tableau Server offline
  • You plan to install Tableau Server in an air-gapped environment

For more information, see Activate Tableau Server Using the Authorisation-To-Run (ATR) Service(Link opens in a new window).

BOOTSTRAPFILE="<path\to\bootstrap\file>" Required when adding a node to a cluster. The bootstrap file contains the configuration used by additional nodes. Example: <Setup file> /silent ACCEPTEULA=1 BOOTSTRAPFILE="C:\Users\tableauadmin\Downloads\bootstrap.json"
CONTROLLERPORT= Optional. The port on which the Tableau Services Manager (TSM) Controller should run. If not included, defaults to 8850.
COORDINATIONSERVICECLIENTPORT= Optional. The port on which the Tableau Services Manager (TSM) Coordination Service client should run. If not included, defaults to a dynamically mapped port. For more information, see Tableau Services Manager Ports.
COORDINATIONSERVICEPEERPORT= Optional. The port on which the Tableau Services Manager (TSM) Coordination Service peer should run. If not included, defaults to a dynamically mapped port. For more information, see Tableau Services Manager Ports.
COORDINATIONSERVICELEADERPORT= Optional. The port on which the Tableau Services Manager (TSM) Coordination Service Leader should run. If not included, defaults to a dynamically mapped port. For more information, see Tableau Services Manager Ports.
DATADIR="<path\to\data\directory>" Optional. The location where the Tableau Server software configuration and data are stored. If you don't provide a data directory path and Tableau Server is being installed to the default location (INSTALLDIR is not specified), the default data directory is used: C:\ProgramData\Tableau\Tableau Server. If you don't provide a data directory path and INSTALLDIR is specified, DATADIR is also set to the INSTALLDIR location. Example: DATADIR="D:\TableauServerData"
EMBEDDEDCREDENTIAL=1|0

Required when adding a node to a cluster and the bootstrap file contains the embedded credentials of an administrator on the TSM computer.

1=true, 0=false. Default is 0.

Must be used with /silent or /quiet and with BOOTSTRAPFILE

Example: <Setup file> /silent ACCEPTEULA=1 BOOTSTRAPFILE="C:\Users\tableauadmin\Downloads\bootstrap.json" EMBEDDEDCREDENTIAL=1

INSTALLDIR="<path\to\installation\directory>" Install to the specified non-default install location.

Specifies the location to install server. If not used, Tableau Server is installed to C:\Program Files\Tableau\Tableau Server

Example: <Setup file> /silent INSTALLDIR="D:\Tableau\Tableau Server"

LICENSESERVICEVENDORDAEMONPORT= Optional. The port on which the Licence service vendor daemon should run. This is used in multi-node installations for licensing-related communication between nodes. If not included, defaults to a dynamically mapped port. For more information, see Tableau Services Manager Ports.
SKIPPYTHONINSTALL=1|0

Added in version 2021.3.0

Optional. If set to 0 (the default), the Setup program installs the included Python package. If set to 1, specifies that the Setup program should not install the Python package as part of Tableau Server.

Note: Python will be used in future releases of Tableau Server to support advanced analytics features. If you choose to skip installation of Python, Tableau Server users will not have access to those advanced analytics features when those features are available.

If not included, defaults to installing Python as part of Tableau Server.

 

Thanks for your feedback!