You can use the Server authorization-to-run (ATR) service to activate Tableau Server deployed in on-premises, cloud, container, or virtual environments without running out of license activations. The ATR service achieves this by providing short-term leases of configurable duration (ATR duration) that ties the license to the device until product key expiration date is met. ATR handles activation capacity tracking so that when there is an underlying hardware change, maximum activation errors don't occur. This option is ideal for cloud-based or virtual environments, but is available to anyone who can activate their copy of Tableau Server online because Tableau Server needs to connect to various internet locations for licensing purposes. For more information, see Communicating with the Internet(Link opens in a new window).

Select this option if:

  • You plan to activate Tableau Server online
  • You plan to install Tableau Server in the cloud
  • You plan to install Tableau Server on a virtual machine or other non-persistent environment
  • You frequently test Tableau Server installations
  • You often experience maximum activation errors

Do not use this option if:

  • You plan to activate Tableau Server offline
  • You plan to install Tableau Server in an air-gapped environment

Selecting ATR for product activation is a permanent choice that cannot be easily undone. To change this later, you must backup, remove, and then reinstall Tableau Server.

Note: When using Server ATR with subscription licenses, you do not need to refresh product keys in Tableau Server. To renew an expired subscription or make licensing changes, you must identify the new product key in the Tableau Customer Portal and activate it.

Select the Server ATR option

You can select the Server authorization-to-run (ATR) option when installing Tableau Services Manager (TSM) using the TSM web interface or the TSM CLI. For more information, see Install TSM(Link opens in a new window).

Set or change the Server ATR duration

When using Server authorization-to-run (ATR) to activate Tableau Server, you can change the ATR duration and use a setting different than the default of 432000 seconds (5 days). The ATR duration is the length of time that Tableau Server is authorized to run and will refresh while Tableau Services Manager (TSM) processes are up, requiring no new activation until the key(s) have reached their expiration date. If you're creating a test server or virtual machine (VM) that will have a short lifespan, you might want to shorten the ATR duration. Similarly, if you have a server that you plan to keep for a long time, you might want to lengthen the ATR duration.

To change the ATR duration, you use the tsm licenses atr-configuration set –duration <value_in_seconds> command. For more information, see tsm licenses atr-configuration set(Link opens in a new window).

ATR duration in seconds Minimum Maximum Default
Tableau Server (container) 3600 (1 hour) 2593000 (30 days) 14400 (4 hours)
Tableau Server (non-container) 14400 (4 hours) 7776000 (90 days) 432000 (5 days)

The license refresh duration varies from hourly to daily, depending on the ATR duration.

ATR duration How often to refresh
< 4 hours every 15 minutes
< 24 hours every hour
< 7 days every 12 hours
> 7 days every 24 hours

You should keep your Tableau Server running as much as possible. Otherwise, if the Tableau Server is left shut down too long, Server ATR may reclaim the license lease and then you'll need to reapply your license.

Tableau Server on Linux

To set ATR duration and manually start the Activation Service, run the following commands:

  1. On the initial node, open a terminal session, and then use the following commands:

  2. tsm licenses atr-configuration set -–duration <value_in_seconds>

  3. tsm pending-changes apply

  4. sudo su -l tableau

  5. systemctl --user stop activationservice_0

  6. systemctl --user start activationservice_0

  7. Verify that the Activation Service is running by using the tsm status -v command. Tableau Server Activation Service should be listed as "is running". If the Activation Service is not started, then run:

    systemctl --user restart activationservice_0

Tableau Server in a Container

To set ATR duration and manually start the Activation Service, run the following commands:

  1. On the initial node, open a terminal session, and then use the following commands:

  2. tsm licenses atr-configuration set -–duration <value_in_seconds>

  3. tsm pending-changes apply

  4. sudo su -l tableau

  5. supervisorctl stop activationservice_0

  6. supervisorctl start activationservice_0

  7. Verify that the Activation Service is running by using the tsm status -v command. Tableau Server Activation Service should be listed as "is running". If the Activation Service is not started, then run:

    supervisorctl restart activationservice_0

Note: For Tableau Server running in a container, the TTL Start and TTL End values reflect the current lease being used by Tableau Server. Container leases that are shorter than a day are refreshed hourly, but longer leases can take up to 24 hours to renew.

Move a Server ATR license to another Tableau Server

If you want to stop using your license on an existing Tableau Server and use it on a new installation of Tableau Server, you can move your Server ATR license. You might want to move licenses when:

  • Switching between development or pre-production environments.

  • Moving Tableau Server to upgraded hardware.

  • Moving Tableau Server to cloud infrastructure.

  • Using an ephemeral Tableau Server, such as a virtual machine (VM) or container.

How do ATR leases work?

When you sign into Tableau Server and activate it using your product key, your ATR lease remains active as long as the Administration Controller, also called the TSM Controller, and the Activation Service are running. If you stop using Tableau Server, such as when you shut down the computer where Tableau Server is installed, you are automatically logged out and the ATR lease expires. Tableau reclaims the license and frees the capacity for new use after the ATR lease duration has elapsed.

Activate the same license on another Tableau Server

You can have one production and two non-production installations per license. If you have unused activations on a license, you can activate the same license on another Tableau Server. If you’re out of activations, you can still activate the license after its lease expires.

  1. You have an existing Tableau Server that is licensed using Server ATR.

  2. Stop the existing Tableau Server from refreshing its leased activation. You can do this using any of the following methods:

    • Shut down your existing Tableau Server.

    • Uninstall the existing Tableau Server.

    • Disconnect the existing Tableau Server from the Internet by unplugging the ethernet cable or disconnecting wifi.

  3. After the ATR lease expires, you can reuse the license on another Tableau Server.

  4. On the new computer, install Tableau Server.

    When prompted, activate Tableau Server using the same license.

Remove product keys that were activated using Server ATR

You can remove product key(s) that were activated using Server ATR when you want to reclaim license capacity from one Tableau Server installation and use it on another. For more information about reclaiming a product key, see Deactivate Product Key(Link opens in a new window).

Stop using Server ATR for activation

If you no longer want to use the Server ATR activation method for a specific Tableau Server, you must perform a backup, delete the existing Tableau Server, install a new Tableau Server, and then restore from backup.

  1. Perform a full backup of your Tableau Server. For more information, see Perform a Full Backup and Restore of Tableau Server(Link opens in a new window).

  2. Completely remove Tableau Server using the tableau-server-obliterate script with the -l option. For more information, see Remove Tableau Server from Your Computer(Link opens in a new window).

  3. Install and configure Tableau Server. For more information, see Install and Configure Tableau Server(Link opens in a new window) and Install and Initialize TSM(Link opens in a new window).

    Navigate to the scripts directory:

    cd /opt/tableau/tableau_server/packages/scripts.<version_code>/

  4. Run the following script to start TSM:

    sudo ./initialize-tsm --accepteula --no-activation-service --<optional_parameters>

    The only required parameter for the initialize-tsm script is --accepteula. You must include this parameter to accept the Tableau Server End User License Agreement (EULA). The EULA is available in the following location:

    /opt/tableau/tableau_server/packages/docs.<version_code>/Commercial_EULA.txt

  5. Log off and log on again to the terminal before you configure Tableau Server.

    When you log on again, you create a new session in which group membership changes have taken effect. The new session also has access to the environment variables added by the initialize-tsm script.

  6. Restore from backup. For more information, see Perform a Full Backup and Restore of Tableau Server(Link opens in a new window).

Thanks for your feedback!