Spectrum tomcat service is missing after hotfix install or upgrade on Windows platform

Products

• Spectrum

Issue/Introduction

Spectrum tomcat service is missing after hotfix install or upgrade on Windows platform

After installing a Spectrum hotfix patch or upgrading the base Spectrum version on a Windows Server, the install indicates that it failed to start the tomcat service. The following error will be seen in the post-installation log:

Starting tomcat
System error 1058 has occurred.

The service cannot be started, either because it is disabled or because it has no enabled devices associated with it.

A subsequent investigation shows that the Spectrum tomcat service doesn't exists.

Environment

Release: Any version installed on Windows
Component: SPCOCK

Cause

The reason this occurs is because more than likely the Windows Services UI was left open during the installation. During the install the original Spectrum tomcat service is removed and the new one added.

However, due to a Windows limitation, a service cannot be completely removed while the Services UI is open.

Resolution

Short-term workaround: Close the Windows Services UI and run the command $SPECROOT/tomcat/bin/OneClickService.exe --install to manually re-add the service.

Long-term workaround: Ensure that the Windows Services UI is completely closed prior to starting an installation.