Prerequisites for running TERR Console, TERR Tools, or local execution of TERR data functions on the installed Windows Client (aka Analyst) in Spotfire 14.0.8 and 14.6.0

Products: Spotfire 14.0.8 and above

Summary:

This article discusses the prerequisites that must be met to run TERR Console, TERR Tools, or perform local executions of TERR data functions on the installed Spotfire Analyst (Windows Client). Failing to meet these prerequisites would cause the application to crash or make the specified components unusable.

Details:

The release of Spotfire 14.0.8 and later comes bundled with TERR 6.1.6 and later. TERR now requires the Microsoft Visual C++ Redistributable for Visual Studio 2015-2022 to be installed on the computer that uses the TERR Console, TERR Tools, or local execution of TERR data functions, to be able to run.

As per the system requirement for the Spotfire Analyst application for Windows 14.0.8 and above: https://docs.tibco.com/pub/spotfire/general/sr/sr/topics/spotfire_analyst_desktop_14_0.html

==========================
In version 14.0.8 and later (with TERR 6.1.6 and later), MSVCP140.dll and VCRUNTIME140.dll are required when executing TERR data functions locally, and when launching the TERR Tools.

These DLLs are included in all released versions of Microsoft Visual C++ Redistributable for Visual Studio 2015-2022, however, it is recommended to always use the latest update to benefit from Microsoft's security updates.
==========================

Example Scenario:

If the prerequisites are not met and TERR Tools is accessed, it may lead to an error followed by a crash:

As per the logs:

2025-10-16T13:47:00,538+00:00 2025-10-16 13:47:00,538 [Main Thread] ERROR Spotfire.Dxp.Web.Menus.MenuItemHandler [(null)] - Unable to invoke tool user action 'TERR Tools'

System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.InvalidOperationException: Unable to create the View 'Spotfire.Dxp.TERRTools.TERRToolsPromptDialog' found in the ViewRegistry with argument 'Spotfire.Dxp.TERRTools.TERRToolsPromptModel'. ---> System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.InvalidOperationException: TERR crash detected
   at TIBCO.TERR.TERREngine.ReadLine(Boolean error)
   at TIBCO.TERR.TERREngine..ctor(String terrHome, String packages, String libraryPath)
   at TIBCO.TERR.TERRManagerImpl.NewEngine(String packages)
   at TIBCO.TERR.TERRManagerImpl.ExecuteScriptCore(TERRScript script)
   at TIBCO.TERR.TERRManagerImpl.EvaluateSimpleExpressionCore(String expression, Boolean print, String packages)
   at Spotfire.Dxp.TERRTools.TERRToolsPromptDialog..ctor(TERRToolsPromptModel promptModel)
.
.
.
FATAL Spotfire.Dxp.Loader.Program [(null)] - Unhandled exception
System.InvalidOperationException: TERR crash detected
   at TIBCO.TERR.TERREngine.ReadLine(Boolean error)
   at TIBCO.TERR.TERREngine..ctor(String terrHome, String packages, String libraryPath)
   at TIBCO.TERR.TERRManagerImpl.ServiceLoop()
   at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)

Note: Web Player and Automation Services are not affected by this issue.

Resolution:

In Spotfire 14.0.8 LTS:

From Spotfire client hotfix 14.0.8.65 LTS HF-033, the mentioned DLLs are bundled with Spotfire instead, removing the need for installing Microsoft Visual C++ Redistributable for Visual Studio 2015-2022.
Check the Community Article for more information: List of hotfixes for Spotfire® Clients (Analyst, Web Player (Consumer/Business Author) and Automation Services)

In Spotfire 14.6.0 LTS:

Check in the Installed Programs list if Microsoft Visual C++ Redistributable for Visual Studio 2015-2022 (x64) and Microsoft Visual C++ Redistributable for Visual Studio 2015-2022 (x86) are already installed on the machine.

If it is not, then you can download and install them from the official Microsoft website.

After installing both packages, it's best practice to restart your computer to ensure all the new runtime files are correctly registered with the system. The application that required the redistributable should now run without errors.

Kindly contact your Windows Administrator to ensure these dependencies are met.

References:

Documentation: System Requirements for Spotfire Analyst 14.0 LTS: