Troubleshoot issues related to administering Smart Discovery Indexing

First, verify if Smart Discovery Indexing is set up correctly. If yes, proceed to troubleshooting:

• Issues found while creating the Smart Discovery index.
• Issues found while populating Solr with the Smart Discovery index.
• Issues found while updating the Smart Discovery index at regular time intervals.

Issues found while creating the Smart Discovery index

Issue	Fix
The Teamcenter relational database is unavailable.	Inspect the Smart Discovery index to see if there are any issues reported for the structure or for a target item. Consider deleting the Smart Discovery index only if needed, and index the structure again.
The smart_discovery_index utility is used incorrectly or an issue occurs while executing this utility.	Run smart_discovery_index -h to see its help on the correct argument usage. Check the Teamcenter command prompt to see if there are any errors reported.
The Smart Discovery index creation process is not complete.	As large structures can take several days to index, periodically inspect if the structure is still in the indexing process. Wait for the indexing to be complete. Check for suitable system resources. Consider deleting the Smart Discovery index only if needed, and index the structure again. Consider setting the value of the DB_FILE_MULTIBLOCK_READ_COUNT parameter to 16 so that the structure data can be read from the Teamcenter database.
The icon for the product structure is not displayed even though it is indexed using Smart Discovery.	Run the recurring task. If the recurring task is not already set up, you can consider setting it up. Additionally, inspect the tcserver log files for issues. Also, restrict the active users to administrators till the initial Smart Discovery index creation is complete.

Issues found while populating Solr with the Smart Discovery index

Issue	Fix
Solr is unavailable.	Restart the indexer (FTSIndexer) and Solr processes. Perform the Solr indexing again.
The query times out.	Increase system resources. Increase the timeout period in Solr and of FTSIndexer. Restart the FTSIndexer and Solr processes. Perform the Solr indexing again. Additionally, inspect the FTSIndexer log files for issues.

Issues found while updating the Smart Discovery index at regular time intervals (FTSIndexer synchronization)

Issue	Fix
The Smart Discovery index in Solr is unavailable.	Ensure that the synchronization task is set up and is executed at the specified time interval. The structures in which issues were found while updating the Smart Discovery index are considered again for synchronization.
The product path in the Smart Discovery index is not updated, OR there is a long work queue.	Ensure that the synchronization task is set up and is executed at the specified time interval. The Smart Discovery index in Solr is automatically updated when the product path is updated in the Teamcenter relational database. Wait for the synchronization task to complete — large structures and a longer queue take time. Check the last-indexed timestamp of a structure; if the structure was indexed after the last synchronization happened, it may not be synchronized yet. Check if the session settings are correct. Increase the number of tcserver instances in the server pool. Inspect the tcserver log files for issues.
The synchronization task is not running.	Inspect the Smart Discovery index to see the last available update.
The synchronization task is stuck.	Wait for large structures to get indexed completely. Delete unused structure indexes. Increase the number of tcserver instances in the server pool. Increase the system resources. Inspect the TcFTSIndexer and tcserver log files for issues.
The changes are too large and the synchronization task times out.	Increase the timeout period. Inspect the TcFTSIndexer and tcserver log files for issues.
The Solr schema is not updated.	Stop the TcFTSIndexer synchronization task, reindex Solr, and restart the synchronization task. Verify if the required item revision and occurrence properties are set up for indexing. Also ensure that after setting up the properties for indexing, you update and merge the schema file.