“Login to DSA Server” or “Tab_login function failed” Messages

Error message in section of log file under “Login to DSA Server”. Specific error messages include “Tab_login function failed”.

Log Files for DSA Cloud AD clients: There is an option that emails a copy of the log file from every run to a email address you designate.

“Login to DSA Server” or “Tab_login function failed”

Excerpt from DSA AD or DSA Cloud AD’s log file. Note lines 12 & 13 below.

NONE

***************  Login to DSA Server  ************************************
9:26:14 AM -- Login to DSA Server  [ tabcmd.exe file reference = C:\Program Files\Tableau\Tableau Server\2020.2\extras\Command Line Utility\tabcmd.exe ]
9:26:23 AM -- Return code from Tab_login function = 1
9:26:23 AM ===== Creating new session
9:26:23 AM =====     Server:   http://<server name>
9:26:23 AM =====     Username: sysera
9:26:23 AM ===== Connecting to the server...
9:26:23 AM !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
9:26:23 AM !!   ERROR!  - Error number 1 in this run.
9:26:23 AM  ********************************************************************
9:26:23 AM !! SERIOUS ERROR - Aborting remainder of run.
9:26:23 AM !! ERROR occured while attempting !! Tab_login function failed
9:26:23 AM !! Return code from Tab_login function = 1

Solution

The log file is indicating that Tableau’s tabcmd.exe utility isn’t connecting via the tabcmd login command to your Tableau Web Server.
This could be due to:

Credentials (URL to Tableau Web Server, Username & Password)

Credentials in the static parameter file no longer valid (file is usually SParms.ps1).
Credentials include URL to Tableau Web Server, username & password.
- Fix for clients with DSA AD installed on-prem (on one of your computer servers).
  1. Update the Tableau Web Server credentials on the static parameter file.
- Fix for DSA Cloud AD clients.
  1. Identify the credentials that need to be changed.
  2. Contact DataSelf support and request they make the change.

Tableau Upgrade (new version of Tableau Web Server)

Change or upgrade to Tableau – older release of the tabcmd.exe utility may no longer work with newer version of Tableau Web Server.
- Fix for clients with DSA AD installed on-prem (on one of your computer servers).
  1. Download appropriate release of tabcmd from Tableau.
  2. Install the new release of tabcmd on the server hosting DSA AD.
  3. Adjust the setting in the static parameter file to point to new file.

DSA AD & Cloud AD Requirements in Context

Must be able to login to Tableau web server using the the URL and credentials stored in DSA AD’s static parameter file.
A tabcmd.exe file and installation must be located in the path stored in the static parameter file.
The tabcmd.exe login command must be able to connect to Tableau Web Server using the tabcmd.exe file path, URL and credentials stored in DSA AD's static parameter file.