TERR Service (TERRSRV) (TerrServiceClient) returns error "The data function execution did not complete in the time allowed."

TERR Service (TERRSRV) (TerrServiceClient) returns error "The data function execution did not complete in the time allowed."

book

Article ID: KB0073544

calendar_today

Updated On:

Products Versions
Spotfire Server 10.0 and later
Spotfire Web Player 10.0 and later
Spotfire Automation Services 10.0 and later

Description

TERR Service (TERRSRV) (TerrServiceClient) returns error "The data function execution did not complete in the time allowed."
 

Environment

All supported environments

Resolution

(1) The TERR Service (TERRSRV) throws this error ("The data function execution did not complete in the time allowed") when either of the TERR Service timeout settings documented on the following docs page are reached while running a data function's TIBCO Enterprise Runtime for R (TERR) script:
____________________________________
https://docs.tibco.com/pub/terrsrv/1.1.0/doc/html/GUID-D458681C-B0DE-4CA5-99F4-20F444D7A6EF.html

Engine timeout

You can specify the length of time a TERR engine runs to complete a task before failing with a timeout error.

You can also specify the length of time for a TERR session to exist.


Configuration property
    Default setting
        Description

engine.execution.timeout
    60
        The length of time, in seconds, that the TERR service allows a TERR engine to execute a request before stopping the execution with a timeout error.

engine.session.maxtime
    120
        The length of time, in seconds, that the TERR service allows a TERR engine session to exist before killing it.
____________________________________

Starting TIBCO® Enterprise Runtime for R - Server Edition 1.3.0, the default timeout for engine.execution.timeout and engine.session.maxtime has updated to 600 and 1800.

(2) Both of these TERR Service (not TSSS) settings can be adjusted using its "custom.properties" file, using the instructions on the following docs page:

  https://docs.tibco.com/pub/terrsrv/1.1.0/doc/html/GUID-8BB5EB2D-C18A-4DD3-981F-FBF4D443A917.html

Issue/Introduction

TERR Service (TERRSRV) (TerrServiceClient) returns error "The data function execution did not complete in the time allowed."

Additional Information

Doc: The online docs page at the following URL explains the differences among TERR, the TERR Service, and TIBCO Spotfire Statistics Services:
KBA: The following public knowledge base article provides a very brief introduction to the TERR Service:
KBA: The following public knowledge base article discusses how a data function's error message and stack trace show where its TERR script was sent for processing:
Doc: The online docs page at the following URL describes the TERR Service's "Engine Timeout" settings and their default values:
Doc: The online docs page at the following URL describes how to adjust TERR Service configuration settings, using its "custom.properties" file: