You can use the tabcmd command-line utility on a Windows computer to create scripts to automate administrative tasks on your Tableau Server site. For example, creating or deleting users, projects, and groups.
Note: The utility is installed automatically on the primary server node when you install Tableau Server, but the tabcmd Setup program for installing the utility on other computers is not.
Prior to version 10.1, the tabcmd Setup program was included on the primary node when you installed Tableau Server. If you have Tableau Server 10.0.x or earlier, you can find TabcmdInstaller.exe in
<server install location>\<version>\extras. For example:
When Tableau Server is upgraded to a new version, if an updated version of tabcmd is required, you can download it from the Tableau Alternate Downloads Site (link below) to avoid issues caused by version incompatibilities.
This site contains tabcmd installers for Tableau Server 10.1 and later. Make sure you download the version that matches your server version and is compatible with the computer from which you’ll run the commands. If you need the tabcmd installer for a version of Tableau Server prior to 10.1, see the note above.
Tableau recommends that you install tabcmd to a folder named tabcmd at the root of the C:\ drive (C:\tabcmd), for convenience when using tabcmd, and to accommodate some limitations with the Windows operating system.
Note The tabcmd Setup program does not add the tabcmd directory to the Windows PATH variable. You can add it manually, or you can include the full path to tabcmd each time you call it.
How to use tabcmd
The basic steps for using tabcmd are as follows:
Open the Command Prompt as an administrator.
Change to the directory where tabcmd is installed.
If you are using tabcmd on the Tableau Server primary node, change to the Tableau Server bin folder. For example:
cd C:\Program Files\Tableau\Tableau Server\10.3\bin
If you installed tabcmd on a computer other than the primary node, change to the directory where you installed tabcmd.
Run the tabcmd command.
When you use tabcmd, you must establish an authenticated server session. The session identifies the server or Tableau Online site and the user running the session. You can start a session first, and then specify your command next, or you can start a session and execute a command all at once. If you are using tabcmd to perform more than one task, you must run tasks one after another (serially), rather than in parallel.
Commands (such as
login) and the options (such as
-u, etc.) are not case sensitive, but the values you provide (such as
User@Example.com) are case sensitive.
The following command demonstrates starting a session with the Tableau Server named tabserver.myco.com:
tabcmd login -s http://tabserver.mycompany.com -u admin -p mypassword
The next example shows a command that deletes a workbook named Sales_Workbook:
tabcmd delete "Sales_Workbook"
Here’s how to accomplish all of the above with one command—note that you do not need
tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -u admin -p mypassword
A Tableau Server can run multiple sites. When a workbook is on the Default site of a multi-site server you don't need to specify Default, the above command is sufficient. However, if the command applies to something on a site other than Default, you need to specify the site ID for that site (see login). Here's the same command for a workbook that's on the West Coast Sales site (site ID
tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -t wsales -u admin -p mypassword
-p are among the tabcmd global variables, which can be used with any command.
For more information, see tabcmd Commands.
Status messages and logs
When a command is successful, tabcmd returns a status code of zero. A full error message for non-zero status codes is printed to stderr. In addition, informative or progress messages may be printed to stdout.
A full log named tabcmd.log that includes debugging, progress, and error messages is written to C:\Users\<username>\AppData\Local\Tableau.