Wednesday 14 May 2014

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 use only 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.
  • The online map could not be loaded.
Configuration changes will be required within Internet Explorer and may require additional configuration of the operating system or network settings. Tableau recommends that this be done by a system administrator. This article describes 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 topic in the Tableau Server Help.

Addresses and Ports

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.
Tableau versions 6.1, 7.0.x, and 8.0.x 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), orMiami and Havana (dark water).

Tableau Public

Tableau Public uses the following web server:  public.tableausoftware.com:443. 

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

Configuring Internet Explorer Proxy Settings

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 by selecting 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):
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.
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.
3. In IE, select Tools > Internet Options.
4. In the Internet Options dialog box, select the Connections tab and then click the LAN Settings button.
5. Select the Use a proxy server for your LAN check box and complete the appropriate address and port number text boxes.

User-added image

Notes:
  • 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.
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.
7. Close all open instances of IE.
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: After you have completed both configurations, you may need to restart Tableau Server to ensure that all changes are implemented. 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.

No comments:

Post a Comment