Remove Tableau Server from Your Computer

Warning: The steps below completely remove Tableau Server on Linux, and delete users and groups created by initialize-tsm, all related data, and configuration information. This includes any files in /tmp or /var/tmp that are owned by users configured in /etc/opt/tableau/tableau_server/environment.bash as privileged and unprivileged users (by default, tsmagent and tableau). Tableau Server licenses are also deactivated, unless you omit the -l option when running the command shown below and the computer is connected to the internet.

If you want to uninstall a particular Tableau Server package to free up disk space (after upgrading, for example), see Uninstall Tableau Server.

As part of the regular installation of Tableau Server, a script is installed that provides you a way to completely remove Tableau and all associated files from your computer. This is something you would only do if you did not care about your Tableau data, configuration, or log files, or if you are working with Tableau Technical Support and need to reinstall Tableau Server after an installation or upgrade attempt fails. The obliterate script will not remove any drivers you installed separately, even those you installed to use with Tableau Server.

The tableau-server-obliterate script is intended for when you want to completely remove Tableau Server from your computer. You might want to do this for a couple of different reasons:

  • You no longer want Tableau Server installed on the computer. Use the tableau-server-obliterate script to remove Tableau Server completely. If this is the case, and the computer is connected to the internet, you can include a -l option to deactivate the Tableau Server license.

  • Troubleshooting Tableau Server installation problems—If you run into issues installing Tableau, you may need to use the tableau-server-obliterate script to completely remove Tableau Server from your computer before reinstalling. Doing this will clean up any older settings or states (such as the /etc/opt/tableau/tableau_server/environment.bash file) and allow you to reinstall on a "clean" computer. If you are doing this, you can leave off the -l option to preserve licensing information on the computer. When you omit the -l option, you will not need to activate your license when you reinstall Tableau Server.

What tableau-server-obliterate does

The intent of the tableau-server-obliterate script is to completely remove Tableau Server from your computer. This includes files, system settings and configurations, and, if you specify, licensing information.

When you run tableau-server-obliterate, the following steps are taken:

  • Uninstall is run for all installed versions of Tableau Server (yum erase or apt-get remove).
  • Most contents of the data directory is removed (by default /var/opt/tableau/tableau_server). Backup and log files are preserved by default. See the section below, "Preserving Tableau Server backup and log files."
  • All semaphores and shared memory segments are deleted.
  • All temp files owned by the "tableau" user are deleted from /tmp and /var/tmp.
  • All users and groups created during install are deleted.
  • /etc/opt/tableau is deleted.
  • Trusted certificates are removed from /etc/pki/ca-trust/source/anchors/TableauServer and /usr/share/ca-certificates/tableau
  • Configuration files are removed from:
    • /etc/sysctl.d/99-tableau-server.conf
    • /etc/profile.d/tableau_server*
    • /etc/security/limits.d/99-tableau_server*
    • /etc/systemd/logind.conf.d/tableau_server*
    • /usr/share/bash-completion/completions/tsm
    • etc/bash_completion.d/tsm
    • /usr/share/bash-completion/completions/tabcmd
    • /etc/bash_completion.d/tabcmd
    • /run/tableau
    • /usr/lib/tmpfiles.d/tableau-server.conf
  • All server licenses are deactivated if you use the -l option and the computer is connected to the internet. This option does not work in offline situations.

Preserving Tableau Server backup and log files

Prior to version 2020.1 of Tableau Server, running the tableau-server-obliterate script deleted all content from the Data directory. Beginning with version 2020.1, the default behavior of the tableau-server-obliterate script has changed: the script copies and saves Tableau Server backup and log files to the logs-temp directory. The default location for the logs-temp directory is at /var/opt/tableau/logs-temp. You can set options on the script to disable this new functionality.

To change the default behavior and to remove backup or log files, include on of the following options when running the tableau-server-obliterate script:

  • -k Do not copy backups to logs-temp directory.
  • -g Do not copy logs to logs-temp directory.
  • -a Do not copy anything to logs-temp directory.

Running the tableau-server-obliterate script

You can completely remove Tableau Server from a computer, either preserving the licensing information, or removing the licensing information along with all other aspects of Tableau Server. You might want to preserve licensing if you are going to reinstall Tableau Server on the same computer.

An older version of tableau-server-obliterate may miss files from new versions of Tableau Server. Always run the obliterate script for the version of Tableau Server that is installed on the computer.

To completely remove Tableau Server without removing server licensing

The example script in this procedure also includes the -a option to remove Tableau Server backup and log files.

Note: If you plan to reinstall Tableau Server and Activate Tableau Server Using the Authorization-To-Run (ATR) Service, we recommend that you remove licensing information before reinstalling and activating Tableau Server using Server ATR.

  1. On the initial node, open a terminal session.

  2. Run the tableau-server-obliterate script:

    sudo /opt/tableau/tableau_server/packages/scripts.<version_code>/tableau-server-obliterate -a -y -y -y

    Note: If you have already uninstalled Tableau Server and now you want to remove it, run the copy of the tableau-server-obliterate script located in the /var/tmp directory. If the script is not in that directory, reinstall the Tableau Server package and then run the tableau-server-obliterate script.

    If you have a multi-node (distributed) installation of Tableau Server, run the tableau-server-obliterate script on each node in the cluster.

  3. Restart each computer you ran the tableau-server-obliterate script on.

To completely remove Tableau Server and licensing

The example script in this procedure also includes the -a option to remove Tableau Server backup and log files.

  1. On the initial node, open a terminal session.

  2. Deactivate any active product keys.

    tsm licenses deactivate -k <product_key>

  3. Run the tableau-server-obliterate script:

    sudo /opt/tableau/tableau_server/packages/scripts.<version_code>/tableau-server-obliterate -a -y -y -y -l

    The -l option removes all licensing files from the computer if the computer is connected to the internet. The script first attempts to deactivate any active licenses, but it will remove all licensing information whether or not deactivation was successful. This is why we recommend you run the tsm licenses deactivate command before running the obliterate script.

    Note: If you have already uninstalled Tableau Server and now you want to remove it, run the copy of the tableau-server-obliterate script located in the /var/tmp directory. If the script is not in that directory, reinstall the Tableau Server package and then run the tableau-server-obliterate script.

    If you have a multi-node (distributed) installation of Tableau Server, run the tableau-server-obliterate script on each node in the cluster. You do not need to deactivate licenses on any additional nodes.

  4. Restart each computer you ran the tableau-server-obliterate script on.

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