Structure Management ─ Deployment and Administration
Manage failures
When a product configuration ends up in a failed state, it remains in that state until the administrator runs the structure:recoverfailures action. When that is run, any failed product configurations are returned to the initial state and the index is regenerated (re-indexed) on the next synchronization. Run the following command: Copy runTcFTSIndexer -task=structure:recoverfailures Following is truncated example output. It shows a failed product is now in state 0. Copy --- BOM Index Summary --- Status Product Config UID Window UID State Name TC Count Solr Count
AI gcRNanawIWcIeC s3PvF$$yM1ipFC 0 HDD-0527/B;1-Hard Drive Assemb 81 81 AC gcRNr4APIWcIeC 9Axq$7ymM1y6BD 8 SUB-479/A;1-holland-assy 2,254 2,254 AC gcUNanthIWcIeC $JCJg8_$M1Cq9C 8 flipfone_assembly/A;1 14 14
On the next synchronization interval, that product configuration's indexes regenerated, and in this case, it succeeds. Following is the truncated output: Copy --- BOM Index Summary --- Status Product Config UID Window UID State Name TC Count Solr Count
AC gcRNanawIWcIeC s3PvF$$yM1ipFC 8 HDD-0527/B;1-Hard Drive Assemb 81 81 AC gcRNr4APIWcIeC 9Axq$7ymM1y6BD 8 SUB-479/A;1-holland-assy 2,254 2,254 AC gcUNanthIWcIeC $JCJg8_$M1Cq9C 8 flipfone_assembly/A;1 14 14
If a product configuration continues to fail, output generated during the synchronization processing, TcFTSIndexer logs, and tcserver syslog files should help diagnose the underlying issue. A common source of errors is stopping the TcFTSIndexer while synchronization operations are in progress. If you wish to stop the TcFTSIndexer you should never kill the process while actions are being processed. Use the -stop option to stop the scheduling of any flows, then verify that all flows have stopped using the -status option, and then finally shut down the TcFTSIndexer process using Ctrl+C in the service console window.
Source: https://docs.sw.siemens.com/documentation/external/PL20251212545240207/en-US/tc_help/administering_product_structures/ygh1737253426868/xid909764.html · retrieved 2026-07-11