TIBCO Spotfire Statistics Services server fails to start after hotfix application or installation

TIBCO Spotfire Statistics Services server fails to start after hotfix application or installation

book

Article ID: KB0079217

calendar_today

Updated On:

Products Versions
Spotfire Statistics Services All Versions

Description

After the application of a hotfix which updates the TERR engine or a new TIBCO Spotfire Statistics Services installation, the server fails to start and the following error is seen in the SplusServer.log:

2016-05-23 03:37:08,626 | ERROR |  | ContextLoader | Context initialization failed
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'clusterMessageListener' defined in class path resource [applicationContextClusterAdmin.xml]: Cannot resolve reference to bean 'jobService' while setting bean property 'jobQueuer'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'jobService' defined in class path resource [applicationContext-job-execution.xml]: Cannot resolve reference to bean 'jobExecutionThreadPool' while setting bean property 'jobExecutionThreadPool'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'splusMessageServerInitializer' defined in class path resource [applicationContext-job-execution.xml]: Invocation of init method failed; nested exception is java.lang.IllegalStateException: Specified TERR home doesn't contain terrJava library directory: C:\TIBCO\statsvcs75\SplusServer\engines\Terr
    at org.springframework.beans.factory.support.BeanDefinitionValueResolver.resolveReference(BeanDefinitionValueResolver.java:329)
    at org.springframework.beans.factory.support.BeanDefinitionValueResolver.resolveValueIfNecessary(BeanDefinitionValueResolver.java:107)
	...
Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'jobService' defined in class path resource [applicationContext-job-execution.xml]: Cannot resolve reference to bean 'jobExecutionThreadPool' while setting bean property 'jobExecutionThreadPool'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'splusMessageServerInitializer' defined in class path resource [applicationContext-job-execution.xml]: Invocation of init method failed; nested exception is java.lang.IllegalStateException: Specified TERR home doesn't contain terrJava library directory: D:\TIBCO\statsvcs75\SplusServer\engines\Terr
    at org.springframework.beans.factory.support.BeanDefinitionValueResolver.resolveReference(BeanDefinitionValueResolver.java:329)
    at org.springframework.beans.factory.support.BeanDefinitionValueResolver.resolveValueIfNecessary(BeanDefinitionValueResolver.java:107)
    ... 28 more
Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'splusMessageServerInitializer' defined in class path resource [applicationContext-job-execution.xml]: Invocation of init method failed; nested exception is java.lang.IllegalStateException: Specified TERR home doesn't contain terrJava library directory: D:\TIBCO\statsvcs75\SplusServer\engines\Terr
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1486)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:524)
    ... 38 more
Caused by: java.lang.IllegalStateException: Specified TERR home doesn't contain terrJava library directory: D:\TIBCO\statsvcs75\SplusServer\engines\Terr
    at com.insightful.splusserver.engine.support.terr.TerrEngineSupport.getTerrHomeDirectory(TerrEngineSupport.java:32)
    at com.insightful.splusserver.engine.support.terr.TerrEngineSupport.getEngineHomeDirectory(TerrEngineSupport.java:180)
    ... 47 more
2016-05-23 03:37:08,720 | INFO  |  | SplusServer | Enter application shutdown

 

Resolution

On startup, the TIBCO Spotfire Statistics Services will check the engine bundle from .\TIBCO\statsvcs75\SplusServer\data\binaries\ for updates, like TerrEngine.zip on Windows and TERREngine.tar.gz on UNIX\Linux. If the engine in .\TIBCO\statsvcs75\SplusServer\engines\Terr is out of date or the \Terr\ folder does not exist then it will re-extract the TerrEngine.zip. At times, there can be an issue with the extraction of the the zip archive resulting in an incomplete set of files in .\TIBCO\statsvcs75\SplusServer\engines\Terr. This can result in the error mentioned above.

There should be 6 folders in .\TIBCO\statsvcs75\SplusServer\engines\Terr, which can be compared against the contents of the TerrEngine.zip/TERREngine.tar.gz:
  • bin
  • doc
  • etc
  • library
  • scripts
  • share
If that folder is incomplete, then the folder can be deleted and the services restarted to force a new extraction of the engine. To resolve:
  1. Stop the TIBCO Spotfire Statistics Services service
  2. Delete the TERR engine folder (for example, .\TIBCO\statsvcs75\SplusServer\engines\Terr).
  3. Start the TIBCO Spotfire Statistics Services service again
  4. Verify the contents of the .\TIBCO\statsvcs75\SplusServer\engines\Terr folder are compete
The TIBCO Spotfire Statistics Services should now be running.

 

Issue/Introduction

The TIBCO Spotfire Statistics Services server fails to start after hotfix application or installation, with the following error in the SplusServer.log: java.lang.IllegalStateException: Specified TERR home doesn't contain terrJava library directory: D:\TIBCO\statsvcs75\SplusServer\engines\Terr

Additional Information

Doc: TIBCO Spotfire® Statistics Services Installation and Administration