Tableau Connector for SuiteCRM

Build 22.0.8462

Tableau Server

Prerequisites

Before you start you must have installed a supported Tableau application. This includes Tableau Server 2020.1 or later.

For older versions of Tableau Desktop, please use either the CData ODBC Driver or the JDBC Driver for SuiteCRM instead.

If a connector has the same class as a connector previously registered, the new one is rejected.

Install the Connector

Once the prerequisites are satisfied, complete the following depending upon your platform:

Windows

  1. Run the setup.exe installer. The driver JAR file will be automatically placed in the drivers directory, C:\Program Files\Tableau\Drivers.
  2. Navigate to the lib folder under the installation directory. By default the installation directory is a folder in C:\Program Files\CData.
  3. Copy cdata.tableau.suitecrm.lic into the drivers directory.
  4. Copy cdata.tableau.suitecrm.taco into the connectors directory, MyTableauServerRootDir/data/tabsvc/vizqlserver/Connectors. In most cases MyTableauServerRootDir is located under C:\ProgramData.

Linux

  1. Unpack the setup.zip archive. Creating a directory for the connector like /opt/cdata/suitecrm is recommended, but the exact install location does not matter.
  2. Navigate to the lib subdirectory under the install directory. Generate a license file by running this command and following the prompts:
    java -jar cdata.tableau.suitecrm.jar -l
  3. Copy cdata.tableau.suitecrm.jar and cdata.tableau.suitecrm.lic into the drivers directory, /opt/tableau/tableau_driver/jdbc.
  4. Copy cdata.suitecrm.taco into the connectors directory, MyTableauServerRootDir/data/tabsvc/vizqlserver/Connectors. In most cases MyTableauServerRootDir is located at /var/opt/tableau/tableau_server.

If you cannot execute the java commmand from step 2, you will need to install a Java runtime environment. The name of this package differs on Red Hat-based and Debian-based systems:

OSJava Package
Ubuntuopenjdk-8-jre-headless
Debianopenjdk-8-jre-headless
RHELjava-1.8.0-openjdk
CentOSjava-1.8.0-openjdk
Fedorajava-1.8.0-openjdk
SUSEjava-1_8_0-openjdk

You can substitute Java 8 with a later Java release as needed.

Copyright (c) 2023 CData Software, Inc. - All rights reserved.
Build 22.0.8462