top of page

How to Run Active Workspace TcFTSIndexer as a Service

Updated: Nov 27, 2023

In the Active Workspace Client (AWC), the TcFTSIndexer must be running for Global Search to work.

Image of the Global Search in Teamcenter's Active Workspace Client (AWC)
The Global Search in the Active Workspace Client (AWC).

Out of the box, to achieve this, you must run the TcFTSIndexer program in a Teamcenter Command Prompt similar to the following to pick up *new* objects to be available in the search results.

runtcFTSIndexer -task=objdata:sync -interval=300

As an administrator, you know that running commands in a Command Prompt is okay for one-offs but not okay to leave running all the time due to the server unexpectedly rebooting or the System Administrators may push updates to the Operating System (OS) and reboot the system. After either of these situations happen, then indexing is no longer running. Then you, the administrator, must log into the server and restart the TcFTSIndexer process. There is a better way.


What we need to do is create a wrapper around a batch script that starts our command. The traditional way to do this is with a commercial utility, called AlwaysUp, which runs as a service. However, AlwaysUp only checks that AlwaysUp is running and not if the underlying command is running. I found an open source solution using NSSM.


NSSM (Non-Sucking Service Manager), it really is named that. validates the underlying program is running and it is simple to use. Not only will it save you money but will save hours of debugging time trying to figure out why indexing is not working.


After downloading and installing NSSM (I used E:\NSSM), create a batch script in that directory named Start-TcFTSIndexerSync.cmd.

Example of the NSSM Installation Directory.
The NSSM Installation directory and script used in the example.
The Start-TcFTSIndexerSync.cmd startup script contents
The Start-TcFTSIndexerSync.cmd startup script contents.

Create a service, named TcFTSIndexerSync (no spaces) but use Display name Teamcenter TcFTSIndexer Sync so the service sorts correctly with your other Teamcenter services.

the services property page with the indicated service names.
The services property page with the indicated service names.
The Teamcenter TcFTSIndexer Sync Service
The Services dialog post adding the service.

Now you will be able to start and stop the TcFTSIndexer utility for sync without much effort. Furthermore, your environment is more robust since the service will automatically start this utility if the server is rebooted. No more manual management.


This post is provided by Sherpa Design, Inc.




Let's Get in Touch

Have questions? There are several methods to ask questions, get answers, explore invoicing options, and more! Use the form below to send our team a message, use the chat bubble to chat with us LIVE (no bots), or email us at info@awtoolbox.com. We are looking forward to hearing from you soon.

Let's get acquainted
Let us know how we can help
Thank you for getting in touch! Our team will respond as soon as we can.

Helpful links and information for Teamcenter

Build a repository of links to useful online help and communities related to Teamcenter and Active Workspace.

Siemens' Teamcenter Knowledge Base

Siemens' Teamcenter Community

Teamcenter News

Teamcenter Users Forum

Teamcenter Administrators Forum

Siemens' Teamcenter Case Studies

TeamcenterX

Siemens provided resources for Teamcenter

The links in this section are directed at the Siemens Support Center website online documentation, downloads, and more. To access the links below, you must login to the Siemens Support Center prior to clicking the link.

Siemens' Support Center

Siemens' Support Center: Teamcenter

Siemens' Support Center: Teamcenter Training

Siemens' Support Center: Teamcenter Downloads

Siemens' Support Center: Teamcenter Documentation

Siemens' Support Center: Additional Video Content

AWToolbox.com |  All Rights Reserved

bottom of page