TeamcenterKnowledge

Monitoring the status of indexing

Inspect the status of the indexer or a structure using Teamcenter Command Prompt

To validate if the index creation process is complete and if structures are indexed successfully by using Smart Discovery Indexing, you can generate a report and inspect the status of the indexer. To inspect the status, you can run either the TcFTSIndexer utility or the smart_discovery_index utility.

Inspect the status of the indexer or a structure by using the TcFTSIndexer utility

Run the TcFTSIndexer utility on the machine where Indexer is deployed:

TC_ROOT/TcFTSIndexer/bin/runTcFTSIndexer -task=discovery:admin -inspect_indexer -depth=<report_level>

Here, report_level specifies the level to which the inspection routine can go. The value can be 0, 1, or 2. It is recommended that you set the value as 1. If you set the value as 2, the report may take longer to execute.

The inspection report is available in TC_ROOT/TcFTSIndexer/logs/report/, named inspect_indexer_<yyyy_MM_dd_HH_mm_ss>.txt.

To generate a report to find objects that did not get indexed or updated in Solr, run:

TC_ROOT/TcFTSIndexer/bin/runTcFTSIndexer -task=discovery:admin -report_failures

This report is also available in TC_ROOT/TcFTSIndexer/logs/report/, named occpropreport_<yyyy_MM_dd_HH_mm_ss>.txt.

Inspect the status of the indexer or a structure by using the smart_discovery_index utility

Run the smart_discovery_index utility on the machine where Teamcenter is deployed:

smart_discovery_index -u=<user_id> -p=<password> -g=<group> -inspect

The details of the report are displayed in the command prompt. If any issues are listed, you may troubleshoot to fix them.

You can update the following preferences to specify various duration and time limits:

Preference Description
QSEARCH_ADMIN_inspect_updater_last_processed_date_age_limit Specify the time limit to determine when the updater is deemed stale with respect to its last processed date.
QSEARCH_ADMIN_inspect_stale_product_age Specify the time limit to determine when a structure is deemed stale with respect to its last updated date.
QSEARCH_ADMIN_inspect_stale_product_age_delta_updater Specify the time limit to determine when a structure is deemed stale with respect to its last updated date relative to the last processed date of the index updater.

You can also inspect the status of a specific structure by using a hierarchical path consisting of item IDs or unique IDs:

smart_discovery_index -u=<user_id> -p=<password> -g=<group> -inspect -path="root_ID,child01,child02,target_id"

Example — to inspect the status of GREEN_SEAT_DC2 in CROSSKART_DC:

smart_discovery_index -u=<user_id> -p=<password> -g=<group> -inspect -path="CROSSKART_DC,INTERIOR CK,FR SEAT CK,GREEN_SEAT_DC2"

Source: https://docs.sw.siemens.com/en-US/doc/282219420/PL20251212545240207.structure_discovery_admin/xid1856842 · retrieved 2026-07-11