LabKey's JDBC driver allows Spotfire to query the server and use the results to build visualizations and perform other Spotfire analysis.

• Set Up
• Using LabKey Data
• Logging
• Troubleshooting

Set Up

To configure Spotfire to use the LabKey JDBC driver, do the following:

• Copy the LabKey JDBC driver jar to the appropriate location on the Spotfire Server.
• Starting with Spotfire Server 10.3, the driver should be placed in the following directory, to ensure that the files are handled properly by the Spotfire Server Upgrade Tool:

  <tibco-server-install>/tomcat/custom-ext/

• On earlier versions of Spotfire, you may have placed the driver in the directory:

  <tibco-server-install>/tomcat/lib/

• If files are placed in this "lib" (or another) directory, then one will have to manually move them during an upgrade.
• For any version, if you encounter problems such as "The information link cannot be loaded from the server", trying the other folder location may resolve the problem.

• Launch the Spotfire Server Configuration Tool.
• Click the Configuration tab.
• On the lefthand pane click DataSource Templates.
• Add a new LabKey data source using the following template, substituting your HOST, PORT, and CONTEXT in the connection-url-pattern:

<jdbc-type-settings>
    <type-name>LabKey</type-name>
    <driver>org.labkey.jdbc.LabKeyDriver</driver>
    <connection-url-pattern>jdbc:labkey:https://HOST:PORT/CONTEXT</connection-url-pattern>
    <ping-command></ping-command>
    <use-ansi-join>true</use-ansi-join>
    <connection-properties>
        <connection-property>
            <key>rootIsCatalog</key>
            <value>true</value>
        </connection-property>
    </connection-properties>
</jdbc-type-settings>

For more details, see the Spotfire documentation:

• Adding the JDBC driver and Data Source Template
• TIBCO Spotfire® JDBC Data Access Connectivity Details

connection-url-pattern

The connection URL pattern includes your HOST, PORT, and CONTEXT. The CONTEXT is either "labkey" or not necessary. The folder path on LabKey Server will be appended to this connection URL pattern.

For example, on a local development server, the connection URL line would look like:

<connection-url-pattern>jdbc:labkey:http://localhost:8080/labkey</connection-url-pattern>

On a production server, the connection URL line might look more like:

<connection-url-pattern>jdbc:labkey:https://labkey.org/</connection-url-pattern>

Applying Folder Filters

To control what folders and subfolders of data will be queried, limiting (or expanding) the scope of data included in spotfire visualizations, apply a container filter. Include a <connection-property> key-value pair in your XML configuration similar to this:

<connection-property>
    <key>containerFilter</key>
    <value>CurrentAndSubfolders</value>
</connection-property>

Possible values for the containerFilter parameter are:

• Current (Default)
• CurrentAndSubfolders
• CurrentPlusProject
• CurrentAndParents
• CurrentPlusProjectAndShared
• AllFolders

Using LabKey Data

• In the Spotfire Information Designer add a data source of type 'labkey'. (Once you have successfully added the driver above, 'labkey' will be available in the Type dropdown.
• You must also provide a Connection URL, Username, and Password. See an example screen shot below.

• Now you will be able to see the LabKey Server folder hierarchy and exposed schemas.

Logging

In your Spotfire Server, you can add additional logging at these levels:

• org.labkey.jdbc.level = FINE (Provides java.util.logging levels)
• org.labkey.jdbc.level = DEBUG (Provides log4j or slf4j logging levels)

Spotfire versions 7.9 and above use the log4j2 logging framework. This property should be set in the [Spotfire_Server_installation_dir]/tomcat/spotfire-config/log4j2.xml file. Generally there will already be a <Loggers> section in this file to which you can add:

<Logger name="org.labkey.jdbc.level" level="DEBUG"/>

Troubleshooting

If you have difficulties connecting to LabKey from Spotfire, first check the installation instructions in this topic and in LabKey JDBC Driver to ensure the properties and settings are configured correctly.

Additional troubleshooting steps:

• Confirm that the user account connecting from Spotfire can independently access the desired resources on LabKey Server directly.
• Try accessing the same resources from Spotfire using a user account with site administrator access. If this works and the intended user does not, you may need to temporarily increase the account's permissions, or contact your LabKey Account Manager to obtain an updated JDBC driver.
• Check the ViewServlet and HTTP access logs for errors.
• Review the Spotfire Server logs for errors.
• Try setting DEBUG logging on org.labkey.api.data.ConnectionWrapper and retrying the connection.

Related Topics

• LabKey JDBC Driver