KNOWLEDGE BASE

Activating Tableau Server in a Disconnected Air-Gap Environment


Published: 03 Jan 2014
Last Modified Date: 04 Mar 2020

Question

How to activate or deactivate Tableau Server in a disconnected (air-gap) environment.

Environment

  • Tableau Server
  • Air-Gap/Disconnected Computer

Answer

Activation

  1. On a computer that is disconnected from the Internet, follow steps 1-4 described in Activate Tableau Offline and save the generated offline.tlq file. 
  2. On a separate computer that is connected to the Internet and is capable of sending files via email, download the Server activation template 64 bit.tlq template that is attached to this article.
    The file is a simple XML file.
  3. Open both offline.tlq and Server activation template 64 bit.tlq in an XML text editor, such as UltraEdit, Sublime, or Notepad++ to allow the file to visually display line numbering
  4. Update the following XML elements in Server activation template 64 bit.tlq with the values for the same elements in offline.tlq on the disconnected computer. Use all caps for any letters. (Double check the characters most frequently misinterpreted: number 8 versus letter B, Number 0 versus the letter O, Number 5 versus letter S.)

    Line 2 - <EntitlementId>
    Line 5 - <ClientVersion>
    Line 5 - <MachineIdentifier>
    (Optional: This XML element might not be present in some circumstances.)
    Line 11 - <Value>
    Line 12 - <Value>
    Line 14 - <SequenceNumber>
    Line 60 - <Hash>
  5. Rename Server activation template 64 bit.tlq to offline.tlq.
  6. Upload the edited template (offline.tlq) to the Activating Tableau Offline website.
NOTE: Two passes may be necessary to completely activate the customer's air gap Tableau Server. The first offline -> activation will set up Trusted Storage on the machine if Tableau has never been licensed on the machine. The second pass of offline.tlq -> activation will propagate the licensing information into Trusted Storage.  If upgrading an existing install of Tableau Server, use the "second_pass" template file as that will match all the places to put the values from the generated TLQ file.   

Deactivation

  1. On a computer that is disconnected from the Internet, follow the steps in the Tableau Online Help to create and save the return.tlq file.
  2. Contact Tableau Technical Support to provide the Tableau Server key being deactivated.
  3. In the return.tlq file, locate the FID_#marker. The FID string can be from 26 to 36 characters in length. The return.tlq can be opened with any XML editor such as NotePad++.
  4. Tableau Technical Support can return the activation on our Tableau License Server on your behalf.
NOTE: The deactivation file is of a format that is very difficult to hand edit correctly and rarely accepted by our Activation website.

Additional Information

All the Machine / Hash values in the TLQ files are Hex values.  The only valid characters are 0 - 9 and A - F.



Discuss this article... Feedback Forum
Did this article resolve the issue?