Spotfire® Server and Environment - Installation and Administration

Running Web Player or Automation Services on Linux

If you install a node manager on a Linux host with the intention to use it for a Spotfire Web Player or Automation Services service, there are a few additional things required. You should also be aware of some differences that your end users might encounter when opening analyses on clients running on different operating systems (for example, if the authors of the analyses use the installed Spotfire client (on Windows), and the end users run a web client from a Web Player service on Linux).

Before you begin

About this task

Before adding the Web Player or Automation services instance to the node, follow the steps below to install required packages and fonts on the Linux node manager host.
Note: New versions of the worker hosts might require updated prerequisites packages so this step is also needed on upgrades.

Procedure

  1. Make sure that the required .NET version is installed on your node manager host.
    For example, see Install .NET on Debian, Install .NET on Ubuntu, or other resources.
  2. In the installation software for the deployment (see Downloading installation software) locate the file SPOT_sfire_deploy_version.zip, unzip it, and find the prerequisites script for your Linux distribution (from version 14.5 and forward).
    For example, if you want to use Debian: prerequisites-debian12.sh.
  3. Run the script corresponding to your distribution, for example:
    sh prerequisites-debian12.sh
    This will install required system dependencies and recommended font packages on the host.
  4. Optional: To use data connectors that require an ODBC driver, install the unixodbc package and odbcinst.
  5. Optional: To use the Dremio or Apache Drill connectors, you must create a driver entry on the Linux host with the expected Windows name. See Connector for Dremio and Connector for Apache Drill in the Drivers and data sources in Spotfire document for more information.
  6. Optional: To use the Oracle, Teradata, or Vertica connectors, you must package the DLL files from NuGet packages and create an SPK file to deploy separately on the deployment area. See the information about Oracle, Teradata and Vertica, respectively, in the Drivers and data sources in Spotfire document, for details about the required DLLs. See also the Developer Documentation for information about how to build packages.

Results

When the steps have been completed, you can add a Spotfire Web Player instance or an Automation Services instance to the node. You must also add Spotfire.Dxp.netcore-linux.sdn to a deployment area on the Spotfire Server. For instructions, see Deploying client packages to Spotfire Server.

When this is done, it is possible for end users to create and open analyses running on the Linux node.

Review the notes below for additional information.

Note: There are some differences when using Web Player or Automation Services on Linux, compared to Windows.
  • Formatting of numbers and dates can have minor differences (for example, rounding to a specific number of decimals is handled slightly differently on Linux and Windows).
  • Available fonts can differ when running on Linux and Windows. Suitable fonts must be installed on the Web Player host to be able to show the same fonts in a Linux environment as those you have when creating analyses with the installed Spotfire client. By running the script in the steps below, you get some common fonts on both systems, but, to be able to use, for example, a specific company font, you must install that font separately on the Linux host. Rendering of fonts might still be different on the different systems. An administrator can specify preferred fonts as a preference, to help authors choose appropriate fonts.
  • Analyses with linked data to files might be complex to handle on Linux due to differences in file paths and case-sensitivity on Linux and Windows. However, as an administrator you can add one or more aliases to provide both a Windows and a Linux path to the shared files in the AllowedFilePath setting of the Spotfire.Dxp.Worker.Host.dll.config file.
  • Custom extensions must be compiled for the target framework, which differs in Linux and Windows. This means that extensions developed for services on Windows will not work when running the service on Linux, unless they are recompiled for the Linux target framework (due to differences in the .NET requirements). If using both operating systems, custom extensions must be compiled for both target frameworks. See Building packages that work with the Web Player on Linux in the Developer Documentation for more information.
  • The information available from certificates when running on Windows and Linux is slightly different.
Note: The following capabilities are not supported on Linux.
  • Kerberos is not supported on Linux.
  • Some data connectors are not supported on Linux: SAP BW, Oracle Essbase, and Microsoft SQL Server Analysis Services (SSAS)
  • The two Automation Services tasks "Set Data Source Credentials" and "Set Credentials for External Connection" are not supported on Linux.
  • Windows Metafiles (WMF & EMF) are not supported in visualizations when running on Linux.
  • The scheduled updates cache is not available when running a Web Player service on Linux. This means that if a Linux node running scheduled updates is restarted, scheduled updates will need to load the data from the sources again, rather than reading data from the cache on disk.
  • Data functions using the discontinued TIBCO Spotfire® Statistics Services server are not supported in Web Player or Automation Services on Linux. To use data functions on Linux, make sure to instead use the Spotfire Statistics Services. See the Migration Guide for more information.