Activate and Register Tableau Server

This topic describes how to activate and register Tableau Server.

Tableau Server requires at least one product key that both activates the server and specifies the number of license levels you can assign to users. You can access your product keys from the Customer Portal.

If you need to activate Tableau Server on a computer that is offline, see Activate Tableau Server Offline. If you need to activate additional product keys to add capacity to an existing Tableau Server installation, see Add Capacity to Tableau Server.

Prerequisite

Before proceeding with the procedures in this topic, complete the following prerequisites as outlined in Install and Configure Tableau Server:

  1. Sign in to Tableau Services Manager Web UI.

    The account you use must have administrative privileges on the computer where TSM is installed.

  2. On the Activate page, Enter or paste your product key and click Activate License.

  3. On the Register page, enter your information into the fields and click Register.

Activate Tableau Server

To activate Tableau Server for production use, you must have a product key.

To activate a product key, run the following command:

tsm licenses activate -k <product key>

To activate a two-week trial, run the following command:

tsm licenses activate -t

If you are unable to activate Tableau, for example, if you get an error like this:

License Server not available

see Activate Tableau Server Offline.

What if I get an access denied error when I attempt to run TSM commands?

The account that you use to configure the rest of the installation must be a member of the tsmadmin group that was created during initialization. To view the user accounts in the tsmadmin group, run the following command:

grep tsmadmin /etc/group

If the user account is not in the group, run the following command to add the user to the tsmadmin group:

sudo usermod -G tsmadmin -a <username>

Register Tableau Server

After activation, you need to register Tableau Server. To do this, create a registration file and then pass it as an option with the tsm register command.

  1. Generate a template that you can edit by running the following command:

    tsm register --template > /path/to/<registration_file>.json

  2. Edit the template file to create your completed registration file.

    Here is an example of a registration file in the required format:

    {
    "zip" : "97403",
    "country" : "USA",
    "city" : "Springfield",
    "last_name" : "Simpson",
    "industry" : "Energy",
    "eula" : "yes",
    "title" : "Safety Inspection Engineer",
    "phone" : "5558675309",
    "company" : "Example",
    "state" : "OR",
    "department" : "Engineering",
    "first_name" : "Homer",
    "email" : "homer@example.com"
    }	
  3. After saving changes to the file, pass it with the --file option to register Tableau Server:

    tsm register --file /path/to/<registration_file>.json

    For example:

    tsm register --file /usr/share/tableau-reg-file.json

If you have a product key for Add-on license, you must activate that product key to be able to use the features included in each Add-on.

Next step

Thanks for your feedback! There was an error submitting your feedback. Try again or send us a message.