Install TSM

This topic guides you through the process of installing Tableau Server Tableau Services Manager (TSM).

Important: Do not install a beta version of Tableau Server in your production environment. You should also never restore a production Tableau Server installation using a backup of a beta version.

Prerequisites

Before proceeding, review the topic, Before you install....

Running Setup

After you download the Tableau Server installation file, follow the instructions below to install the server.

Important: Do not install a beta version of Tableau Server in your production environment. You should also never restore a production Tableau Server installation using a backup of a beta version.

  1. Sign in as a user with administrator access to the computer where you want to install Tableau Server and double-click the installation file.

  2. Follow the on-screen instructions to complete Setup and install the application.

    Image from setup that allows you to change the file path

    The default installation path is C:\Program Files\Tableau\Tableau Server\<version>. The Setup program displays the install path without the version, like this: C:\Program Files\Tableau\Tableau Server. You can choose a different location, including a different drive, by either browsing to or typing in a new path. Be aware that if you browse to a location, the Setup program appends \Tableau Server to the end of the path. You can remove this if it is not the location you want.

    If you are upgrading from Tableau Server version 2018.1 or earlier and Tableau was installed to a non-default location, you need to specify the location of your existing version. Upgrade steps vary depending on your target version and install location. See Upgrade Tableau Server Overview for information on how to choose your upgrade steps.

    Note: If you are prompted by Windows Defender Firewall, click Allow access. You may need to do this multiple times for the installation to complete.

  3. Click Next.

    Image from setup that allows you to change the installation type

    On the Server installation type page, you can specify whether you are installing the first node of a Server installation, or additional nodes in a multi-node installation. You do not need to change this from the default (Create new Tableau Server installation.) unless you are installing a multi-node Tableau Server. If you are installing a multi-node Tableau Server, see Install and Configure Additional Nodes.

  4. Click Next.

    Image from setup that allows you to change the installation type

    On the Product activation type page, select whether you want to use the Tableau authorisation-to-run (ATR) service to activate Tableau Server (the default), and then click Install. For more information about the Tableau authorisation-to-run (ATR) service, see Activate Tableau Server using the authorisation-to-run (ATR) service(Link opens in a new window).

  5. After the installation completes, click Finish. Setup will then open the TSM configuration web page on the computer where you are installing Tableau Server.

    If you need to support characters that are not the Latin-1 set, install the Windows Language Packs via Control Panel > Regional and Language Options. The language packs will need to be installed on the initial server as well as any additional nodes.

Install Tableau Server

  1. Open a command prompt as a user with administrator access to the computer where you want to install Tableau Server.

  2. Download the Setup program from the Tableau Server Downloads(Link opens in a new window) page.

  3. Navigate to the directory where you copied the Setup program.

  4. Run the Setup program from the command line using the /silent flag (run unattended and silently with no UI prompts), ACCEPTEULA (accept the End User Licence Agreement), and ACTIVATIONSERVICE (use Server ATR to activate Tableau Server) properties:

    TableauServer-64bit-<version>.exe /silent ACCEPTEULA=1 ACTIVATIONSERVICE="1"

    Note: There are a number of different installation options you can specify during CLI installation, for example, to change installation and logging paths, or to specify the TSM controller port. For a complete list of switches that you can specify during CLI installation, see Install Switches and Properties for Tableau Server.

  5. Close the command window and open a new one, then confirm that TSM is installed and running:

    tsm status -v

    The status will be STOPPED but the tsm-specific processes will be running:

    node1: localhost
    Status: STOPPED
    'Tableau Server Coordination Service 0' is running.
    'Tableau Server Administration Agent 0' is running.
    'Tableau Server Administration Controller 0' is running.
    'Tableau Server License Manager 0' is running.
    'Tableau Server Client File Service 0' is running.

Configure Tableau Server for a forward proxy

If your organisation uses a forward proxy solution to access the internet, then configure Tableau Server to use the proxy server. Tableau Server must access the internet for map data and for default licensing functionality.

We recommend configuring Tableau Server for a forward proxy solution at this point of the installation process. See Configuring Tableau Server on Windows to work with a forward proxy.

Next step

Thanks for your feedback!Your feedback has been successfully submitted. Thank you!