KNOWLEDGE BASE

Error "Unable to connect to the data source" When Connecting to Windows Shared Directory from Tableau Server on Linux


Published: 11 Jul 2018
Last Modified Date: 11 Jul 2018

Issue

In Tableau Server on Linux, after publishing data source or workbook that connects to flat files on Windows shared directory, following error message may be displayed when access to the view. 

Unable to connect to the data source
The directory is missing or has been moved: <UNC Path>

Environment

  • Tableau Server
  • Linux
  • UNC Path

Resolution

  1. Configure access to a Windows directory from Tableau Server on Linux
  2. Run "tsm configuration set -k native_api.unc_mountpoints -v 'mountpoints'" command to specifies UNC and FQDN path for shared Windows directories that are accessed by Tableau Server on Linux.
For Example: ‘//<server_name>/<folder name>’
UNC Path:
  • From Windows - //srv/shared
  • From Linux - /mnt/srv/shared

tsm native_api.unc_mountpoints:
tsm configuration set -k native_api.unc_mountpoints -v '//srv/shared;/mnt/srv/shared;//srv.example.lan/shared;/mnt/srv/shared

Cause

If workbook or data source connects to flat file (e.g. .csv or .xls file) with using UNC path and is published to Tableau Server on Linux, Tableau Server becomes unable to underline the data source because UNC path such as "\\srv\shared\" is not appropriate path for Linux OS.  
Did this article resolve the issue?