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, configuration information, and logs. 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.

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, 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.

    The script will remove all log files, so if you run into an issue that you want to troubleshoot, or if Tableau Support requests log files for a support case, you should zip up the log files before running the script. For details on gathering log files, see Work with Log Files.

    If you have a backup file you want to save (if you will be reinstalling Tableau for example), copy it to a safe location on a separate computer.

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.

Note: An older version of tableau-server-obliterate may miss files from new versions of Tableau Server. As a best practice you should always run the obliterate script from the most recent version of Tableau you installed.

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).
  • All contents of the data directory is removed (by default /var/opt/tableau/tableau_server).
  • 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 (except trial licenses) are deactivated if you use the -l option.

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 computer.

To completely remove Tableau Server without removing server licensing:

  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 -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:

  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 -y -y -y -l

    The -l option removes all licensing files from the computer. 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! There was an error submitting your feedback. Try again or send us a message.