When using Server ATR, you don't need to refresh your product key(s) when you purchase a new subscription term, add roles or add features to an upgradable subscription licence. That's because Server ATR automatically refreshes your product key(s) for you and updates the product key with the new date that reflects the new expiration dates.
If you aren't using Server ATR, you can refresh your product key(s) manually. If you refresh a subscription (term) product key before the expiration date occurs, the product key will not change but the expiration date will. This can create a mismatch between the product keys listed in the Tableau Customer Portal and those listed in the Tableau Server TSM product key list. The product key will change when the expiration date occurs or shortly thereafter. If a subscription (term) product key is not refreshed and has expired, Tableau will stop working and you will have to activate a new product key in the Tableau Customer Portal regardless of whether you are using Server ATR or manual activation methods.
On the other hand, if the product key is perpetual (legacy) and its maintenance has expired, Tableau will continue to operate but you will not have access to upgrades until the maintenance is renewed. After renewing the maintenance, if you aren't using Server ATR, you must refresh the existing product key to update its maintenance expiry date. The product key will never change. For more information about different product key types and associated licences, see tsm licences list.
Note: This topic describes how to refresh the expiry date for Tableau Server, the Advanced Management and the Data Management. For information about refreshing the maintenance date on Tableau Desktop see Refresh the product key(Link opens in a new window) in the Tableau Desktop and Tableau Prep Deployment Guide.
Before you begin
Verify the expiration date of your licence(s). You can view the expiration date by following the TSM web interface procedure below, or by running tsm licences list in the CLI.
- Compare the date with the date displayed in the Tableau Customer Portal(Link opens in a new window).
- If the portal does not display the date that you expect, contact Customer Success(Link opens in a new window).
- To renew your licence, visit the Tableau renewal(Link opens in a new window) web page.
If the TSM date matches the portal date and the following refresh operation fails, contact Tableau Support(Link opens in a new window).
Note: To refresh your product key in an offline environment, visit the Tableau Customer Portal to obtain the latest term key, and then activate it. For more information about offline activation, see Activate Tableau Server Offline - Adding a Licence. Activate all product keys before starting Tableau Server. Otherwise some users might become unlicensed.
If the computer where you are running Tableau Server has been configured to connect to the internet through a forward proxy, follow the procedure in the topic, Configure Product Key Operations with Forward Proxy, before continuing.
Open TSM in a browser:
Click Configuration and Licensing and click Refresh All:
Open a command prompt as administrator on the initial node (the node where TSM is installed).
Run the following command:
tsm licenses refresh