Was this page helpful?
Yes No
Tableau Help > Tableau Desktop Deployment Guide Overview > 
Install for Others > Control Product Updates

Control Product Updates

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 maintenance versions. Versions are shown this way:

10.3.1

where 10 is the major version, 3 is the minor version, and 1 is the maintenance version. In this case, a product update would apply when 10.3.2 is released, but not when 10.4 is released.

In addition to being able to control product updates for your users, you can also control which maintenance version of Tableau Desktop your users will update to by modifying the TableauAutoUpdate.xml file.

Note: When a new major version of Tableau Public 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 Public 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.

In this article

Turn off product updates during installation (Windows only)

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

  • For Tableau Desktop version 9.3 and later: <path to the Tableau .exe installer> AUTOUPDATE="0"

  • For Tableau Desktop version 9.2 and earlier: msiexec /i <path to the Tableau .msi installer> AUTOUPDATE="0"

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 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 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: For Tableau Desktop version 10.0 or later, 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 major.minor (X.x). For example, 10.3.

  • releaseNotesVersion: The Tableau Desktop version number that you want users to install, in the form major.minor.maintenance (X.x.x). For example, 10.2.5. 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, desktop32, desktopMac, reader64, reader32, readerMac, public64, public32, 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 10.1.4.

Note: If your version is the currently released version of Tableau Public or Tableau Reader, such as Tableau 10.3, set public_supported="true" reader_supported="true". If your version is a prior version of Tableau Public 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="10.1.4" 
        name="10.1" 
        latestVersionPath="esdalt/10.1.4" 
        latestVersion="1001.16.0114.0856" 
        hashAlg="sha512">
    <installer name="TableauDesktop-10-1-4.dmg" type="desktopMac" 
               size="192202277" hash="<128-byte_hash>"/>
    <installer name="TableauPublicDesktop-64bit-10-1-4.exe" type="public64" 
               size="147025920" hash="<128-byte_hash>"/>
    <installer name="TableauReader-10-1-4.dmg" type="readerMac" 
               size="190243904" hash="<128-byte_hash>"/>
    <installer name="TableauPublic-10-1-4.dmg" type="publicMac" 
               size="186465418" hash="<128-byte_hash>"/>
    <installer name="TableauReader-64bit-10-1-4.exe" type="reader64" 
               size="167346176" hash="<128-byte_hash>"/>
    <installer name="TableauDesktop-64bit-10-1-4.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 (32-bit and 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 10.3\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-10.3 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.

(Back to top)