This topic provides all of the steps required to perform a basic, quick-start installation of Tableau Server using the command line. The purpose of the configuration described here is to provide the quickest, simplest path to a Tableau Server installation on a computer running the CentOS 7.3 (and higher) or Ubuntu distribution of Linux. Use this procedure as practice, to try out the Tableau Server installation, management, and user experience before your actual server deployment.
Important: Do not use this procedure as a stand-alone resource for deploying Tableau Server into a production environment. To deploy Tableau Server into a production environment, refer to the content at Install and Configure Tableau Server.
The procedures in this topic will install an instance of Tableau Server for Linux with the following characteristics:
- Operating system: Supported RHEL-like Linux distribution, Ubuntu, or Debian.
- Identity store: local authentication
- Gateway port: 80
- Tableau Server administrator account: admin
Before you begin
Review the topic, Before you install.... The procedure below assumes that you have installed Linux on conforming hardware and according to the environmental requirements specified in that topic.
Note that the computer you install on must meet the minimum hardware requirements specified in Minimum Hardware Requirements and Recommendations for Tableau Server. The setup program will not install Tableau Server onto systems that do not meet the minimum hardware requirements.
Step 1: Install Tableau Server package and start Tableau Services Manager
Install Tableau Server with your distribution’s package manager, then run a script to initialize Tableau Services Manager (TSM). Tableau Services Manager is a the management toolset used to install, configure, and manage Tableau services.
The initialize script is included with the installed package. For more details, see Install and Initialize TSM.
Log on as a user with sudo access to the computer where you want to install Tableau Server.
Navigate to the directory where you copied the Tableau Server installation package.
Use the package manager to install the Tableau Server package.
Do not install to a location using a symbolic link or to a directory on a Network File System (NFS) volume.
On RHEL-like distributions, including CentOS, run the following commands, where
<version>is formatted as major-minor-maintenance (ex:
sudo yum update
sudo yum install tableau-server-<version>.x86_64.rpm
Note: When you use
yumto install Tableau Server, all dependent packages are automatically downloaded and installed. This is the preferred method for installing Tableau. If your organization does not allow you to use
yumand you must install using
rpm -i, you must also install all dependent packages separately.
On Ubuntu and Debian, run the following commands, where
<version>is formatted as major-minor-maintenance (ex:
sudo apt-get update sudo apt-get upgrade sudo apt-get -y install gdebi-core sudo gdebi -n tableau-server-<version>_amd64.deb
Navigate to the
Run the following script to start TSM:
sudo ./initialize-tsm --accepteula
After initialization is complete, close the terminal session:
Step 2: Activate and register Tableau Server
Before you can configure Tableau Server you must activate a license and register. For more details, see Activate and Register Tableau Server.
Open a Bash session and sign in with the same account that you previously used to run
Activate the Tableau Server license. Run the following command:
tsm licenses activate -k <license_key>
Register Tableau Server. Generate a template that you can edit by running the following command:
tsm register --template > /path/to/registration_file.json
Open a text editing program, fill in the registration file, save it, then pass it with the following command:
tsm register --file /path/to/registration_file.json
Step 3: Configure local identity store
You must configure the identity store settings. This procedure simplifies installation setting identity store to local authentication. Workbook examples are installed by default. For more details on customizing these defaults, see Configure Initial Node Settings.
Pass the configuration file with the following command:
tsm settings import -f
Step 4: Finalize installation
The final steps of installation are to apply changes, initialize and start TSM, and then to create the administration account. More details about these steps are at Configure Initial Node Settings.
Apply the configurations you made in the previous steps. Run the following command:
Initialize and start Tableau Server. Run the following command:
Create the Tableau Server administrator account. Run the following command:
tabcmd initialuser --server 'localhost:80' --username 'admin' --password '<password>'
'<password>'is a strong password. Enclose the password and other arguments in single quotes.
tsm pending-changes apply
tsm initialize --start-server --request-timeout 1800
admin account that you created to access the Tableau Server admin web pages. See Sign in to the Tableau Server Admin Area.
Step 5: Install PostgreSQL drivers
To validate that Tableau Server is installed and running properly and to review the built-in administrative views, you must install the PostgreSQL driver.
Download PostgreSQL drivers from the Driver Download page(Link opens in a new window).
Install the drivers on your Tableau Server computer:
On CentOS and RHEL, download the .rpm file and then run the following command:
sudo yum install <driver-installation-package>.rpm
sudo yum install tableau-postgresql-odbc-09.06.0500-1.x86_64.rpm
On Ubuntu and Debian systems, download the .deb file and then run the following command:
sudo gdebi <driver-installation-package>.deb
sudo gdebi tableau-postgresql-odbc_09.06.0501_amd64.deb
Note: The actual command will depend on the name of the driver installation package you download from the Driver Download page(Link opens in a new window).
To validate that the drivers installed, navigate to the Administrative Views in Tableau Server.