Control Product Updates for Tableau Desktop

Tableau Desktop can check for product updates and install them automatically. Users can also explicitly check for product updates using the Check for Product Updates feature. These features are enabled automatically, however, you can disable them either during the installation process (on Windows) or afterward (on the Windows or on the Mac).

To turn off the product update feature in Tableau Desktop for your users, modify the setting for the AutoUpdateAllowed property value. This also turns off the Check for Product Updates feature. This feature allows users to check for and install the most recent Tableau Desktop maintenance updates to their computer at any time.

Product updates only apply to dot release (maintenance) versions. Versions are shown this way:

2021.3.1

where 2021.3 is the release version, and 1 is the dot (maintenance) version. In this case, a product update would apply when 2021.3.1 is released, but not when 2021.3 is released.

In addition to being able to control product updates for your users, you can also control which dot version of Tableau Desktop your users will update to by modifying the TableauAutoUpdate.xml(Link opens in a new window) file.

Note: When a new release version of Tableau Desktop Public Edition or Tableau Reader becomes available, prior versions are no longer supported. Users automatically receive a notification that tells them to update to the current version. Also, you can only install one version of Tableau Desktop Public Edition at one time.

This article describes how to modify the automatic product update settings during installation and how to control the product maintenance version that your users can update to.

For information about how to change product update settings after you install, see Change Installation Settings after Installation.

Turn off product updates during installation (Windows only)

  • When you run the installer through the command line process for Tableau Desktop, you can turn off automatic product updates for your users by setting the AUTOUPDATE property value to "0". For example:

tableauDesktop-64bit-2021-3-1.exe AUTOUPDATE="0"

  • To turn off updates through the UI, go to Help > Settings and Performance, then turn off Enable Automatic Product Updates.

 

 

Specify the maintenance version you want users to get

You can specify the maintenance version of Tableau Desktop that product updates provides to your users by modifying the TableauAutoUpdate.xml file. The TableauAutoUpdate.xml(Link opens in a new window) file is an XML schema that contains the data that the update process uses to determine which product to update, which version to update to, and where to find the update (that is, the path to your download server). First, you copy or create a new TableauAutoUpdate.xml file and then you configure your users' computers to point to the download server where the files are stored.

Copy and modify the TableauAutoUpdate.xml file

You can copy the TableauAutoUpdate.xml file from the Tableau downloads(Link opens in a new window) site, modify it to suit your environment, and then save it to the root directory of the download server.

  1. Make sure that the product version listed in TableauAutoUpdate.xml is the version that you want your users to update to.

  2. Edit the latestVersionPath attribute for each version element to point to the folder on your download server that contains the product updates.

  3. (Optional) Remove any installers you don't need.

Create your own TableauAutoUpdate.xml file

If you are going to create and use your own TableauAutoUpdate.xml file, you will need to complete the following steps:

  1. Gather required information.

  2. Generate hash files

  3. Create the TableauAutoUpdate.xml file

  4. Configure users computers to point to the file location.

Gather required information

Gather the following information before you create the TableauAutoUpdate.xml file:

For the version entry in the XML file, you need the following:

  • latestVersion: The version number of the update you want to install on your user's computer. This is displayed in the About Tableau dialog box. When users start Tableau Desktop, Tableau checks to find out if a new version is available.

  • latestVersionPath: The name of the folder on the download server that contains the installers. Create this folder on the server if it doesn't already exist.

    Note: The installers are downloaded to the Downloads/TableauAutoUpdate. If the Downloads folder doesn't exist, the installers are downloaded to the TEMP/TableauAutoUpdate folder.

  • name: The Tableau Desktop version number, in the form release (X.x). For example, 2020.2.

  • releaseNotesVersion: The Tableau Desktop version number that you want users to install, in the form release.maintenance (X.x.x). For example, 2020.1.1. This parameter displays the correct link to the release notes.

You must create an installer element in the XML file for each product that you want to update.

For each product element, gather the following information:

  • hash: Generate a SHA-512 hash for the installer. This string must be correct or Tableau will not use the installer. For more information, see Generate hash files.

  • name: The name of the installer file to download.

  • size: The file size in bytes.

  • type: The predefined product type that Tableau uses to find the correct installer to download. You must use a type from the following list: desktop64, desktopMac, reader64, readerMac, public64, or publicMac.

Generate hash files

Use a utility such as SHA512SUM or Certutil to generate a SHA-512 hash for each installer. It is usually faster to generate a hash if you download the Tableau executable files and generate the hash locally.

Each utility works differently, so from a command prompt, enter the utility's name followed by -h or -? to display the help for the utility.

For example: sha512sum -h

Create the TableauAutoUpdate.xml file

Create your TableauAutoUpdate.xml file based on the information you gathered earlier. Create one version element for each version, and within the version element, create one installer element for each product type that you want to update. Save the XML file to the root of your download server.

The following sample XML file updates Tableau Desktop 64-bit version to 2020.2.1. An example for updating Tableau Desktop version 9.2.1 is also included. When installing Tableau on a MacOS, use the .pkg files. If you download the .dmg files, you will need to mount the .dmg and then copy the enclosed .pkg files to use to install the product.

Note: If your version is the currently released version of Tableau Desktop Public Edition or Tableau Reader, such as Tableau 2020.2, set public_supported="true" reader_supported="true". If your version is a prior version of Tableau Desktop Public Edition or Tableau Reader, such as Tableau 9.2, set public_supported="false" and reader_supported="false.

<?xml version="1.0" ?>
<versions xmlns="http://www.tableau.com/schemas/InstallerVersions/V1">
  <version 
        public_supported="true" 
        reader_supported="true" 
        showEula="false" 
        releaseNotesVersion="2020.2.1" 
        name="2020.1" 
        latestVersionPath="esdalt/2020.2.1" 
        latestVersion="20202.19.0123.2221" 
        hashAlg="sha512">
    <installer name="TableauDesktop-2020-2-1.pkg" type="desktopMac" 
               size="192202277" hash="<128-byte_hash>"/>
    <installer name="TableauPublicDesktop-64bit-2020-2-1.exe" type="public64" 
               size="147025920" hash="<128-byte_hash>"/>
    <installer name="TableauReader-2020-2-1.pkg" type="readerMac" 
               size="190243904" hash="<128-byte_hash>"/>
    <installer name="TableauPublic-2020-2-1.pkg" type="publicMac" 
               size="186465418" hash="<128-byte_hash>"/>
    <installer name="TableauReader-64bit-2020-2-1.exe" type="reader64" 
               size="167346176" hash="<128-byte_hash>"/>
    <installer name="TableauDesktop-64bit-2020-2-1.exe" type="desktop64" 
               size="186908672" hash="<128-byte_hash>"/>
  </version>
  <version 
        public_supported="false" 
        reader_supported="false" 
        showEula="false" 
        releaseNotesVersion="9.2.1" 
        name="9.2" 
        latestVersionPath="esdalt/9.2.1" 
        latestVersion="9200.16.0114.0755" 
        hashAlg="sha512">
    <installer name="TableauDesktop-9-2-1.dmg" type="desktopMac" 
               size="183617138" hash="<128-byte_hash>"/>
    <installer name="TableauDesktop-64bit-9-2-1.msi" type="desktop64" 
               size="177065984" hash="<128-byte_hash>"/>
  </version>
  <version 
        public_supported="false" 
        reader_supported="false" 
        showEula="false" 
        releaseNotesVersion="9.1.4" 
        name="9.1" 
        latestVersionPath="esdalt/9.1.4" 
        latestVersion="9100.16.0114.0755" 
        hashAlg="sha512">
    <installer name="TableauDesktop-9-1-4.dmg" type="desktopMac" 
               size="183617138" hash="<128-byte_hash>"/>
    <installer name="TableauDesktop-64bit-9-1-4.msi" type="desktop64" 
               size="177065984" hash="<128-byte_hash>"/>
 </version>
</versions>

Configure user computers and the download server

After you've created the TableauAutoUpdate.xml file, follow this procedure to point the user's computers to the file location:

  1. Set the server registry entry on each of your users' computers to point to your download server.
    • Windows: Make an entry for each product and operating system type (64-bit) in your environment. The following entry is for 64-bit Tableau Desktop:

      HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau <version>\AutoUpdate
      Server = "<MyDownLoadServerName>"

      For example:

      HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau 2020.2\AutoUpdate
      Server = "MyCompanyDownloadServer"
    • Mac: Change the settings file for each user to list the download server. Use the defaults command.

      defaults write com.tableau.Tableau-<version> AutoUpdate.Server "<MyDownLoadServerName>"

      For example:

      defaults write com.tableau.Tableau-2020.2 AutoUpdate.Server "MyCompanyDownloadServer"
  2. Make sure that HTTPS is enabled on the download server. Tableau always prefixes the download server name with https:// when contacting the server.

  3. Save TableauAutoUpdate.xml to the root of your download server.

  4. Upload the Tableau installers to the download server location specified in the latestVersionPath parameter.

Update TableauAutoUpdate.xml each time there's a new release that you want to make available to your users.

Thanks for your feedback!Your feedback has been successfully submitted. Thank you!