Web Proxy and Firewall Settings

Depending on local network policies, Tableau Desktop and Tableau Server may require adjustment to the configuration of proxy or firewall settings. This applies when installing Tableau Products on a machine that is connected to the internet. When installed on a disconnected machine, Tableau products will require offline activation and can only use the offline version of the built-in maps.

A proxy or firewall issue can manifest in the following ways:

• The licensing process requests an "offline activation"
• Map views appear blank in Tableau Desktop or with the broken image icon when published to Tableau Server
• Web objects in dashboards fail to load

Configuration changes will be required within Internet Explorer and may require additional configuration of the Window OS and / or network settings. Tableau recommends that this be done by, or in conjunction with, a local network or system administrator. This article will walk through the necessary ports, settings and troubleshooting steps for ensuring Tableau Server can load map views. For more information about Tableau Server ports, refer to the "TCP/IP Ports" section of the Administrator Guide.

Licensing

Enabling the licensing port is optional. If the licensing port is blocked, the licensing activation will prompt for offline (email based) activation. Note: prior to 5.2, once a license key is activated online, all subsequent activations must be made online.

Licensing communications are handled via:

• licensing.tableausoftware.com:443

Maps

Map addresses always use port 80.

Note: Tableau versions 4.1, 5.0, and 5.1 map servers have been discontinued.Tableau no longer supports these versions and has discontinued the online map support for these versions. Please upgrade to an active version of Tableau or use the offline maps.

Tableau versions 5.2 and 6.0 use the following map servers:

• mapvisual.tableausoftware.com
• mapspatial.tableausoftware.com

Test directly in Internet Explorer (IE) using this link: Miami and Havana.

Tableau versions 6.1 and later use the following map servers:

• mapvisual2.tableausoftware.com
• mapspatial.tableausoftware.com

Test directly in Internet Explorer (IE) using these links: Miami and Havana (blue water), Miami and Havana (white water), or Miami and Havana (dark water).

Crash Logs

When Tableau Desktop encounters unforeseen circumstances it may exit unexpectedly. If a crash occurs, extra log files and dump files are produced to capture detailed information for the engineering team to resolve the issue. The next time Tableau Desktop is opened, the user will be given the option to automatically upload the log and dump files. This is optional.

Log file uploads are handled via:

• uploader.tableausoftware.com:443

If your organization uses a web proxy, the Tableau Server Run As User may not be automatically configured to use this proxy when requesting content from the internet. Tableau Desktop and Tableau Server use the Windows Wininet component (underpinning of Internet Explorer) to access content on the web. This includes the built in maps,web page objects on dashboards, licensing, and log uploads.

Requirements for configuring Tableau Server to use a proxy web server:

• Existing Tableau Server installation
• Tableau Server Run As User with interactive login rights
• Review this document with your local network or system administrator

**The Tableau Server Run As User is listed on the General tab of the Tableau Server Configuration window accessed via Start > All Programs > Tableau Server > Configure Tableau Server.

When configuring for Tableau Desktop, make the changes for the end user's Windows account.

To adjust the proxy settings for Tableau Desktop users or the Tableau Server Run As User in Internet Explorer (IE):

Step 1

Log in to the Windows machine where Tableau Server is installed as the Tableau Server Run As User, this will require this account to have Interactive Login rights during troubleshooting.

Step 2

Launch Internet Explorer.
Important: Do not use another browser such as Mozilla Firefox or Google Chrome because Tableau uses the Windows Wininet component of IE.

Step 3

In IE, select Tools > Internet Options.

Step 4

In the Internet Options dialog box, select the Connections tab and then click the LAN Settings button.

Step 5

Select the Use a proxy server for your LAN checkbox and complete the appropriate address and port number textboxes.

Note:

• These settings will typically match a regular Tableau Desktop user's settings, if the mapped views work fine from Tableau Desktop, compare the settings for this screen on Tableau Server to your Tableau Desktop machine.
• Even though these settings typically match, Tableau recommends checking with your local network or system administrator before making these changes.

Step 6

Click OK to close the Local Area Network (LAN) Settings dialog box, and then click OK again to close the Internet Options dialog box.

Step 7

Close all open instances of IE.

Step 8

Launch a new instance of IE and test one of the following URLs:

• Tableau versions 5.2 and 6.0: Miami and Havana
• Tableau versions 6.1 and later: Miami and Havana (blue water), Miami and Havana (white water), or Miami and Havana (dark water)

Note: If a map tile does not resolve, the issue will require troubleshooting by local IT resources using the server address and port list in this article.