Resolve TcFTSIndexer issues

Understand the issues that arise while using TcFTSIndexer and their possible resolutions. Issue Possible resolution Locate errors in TcFTSIndexer TcFTSIndexer logs are located in TC_ROOT\TcFTSIndexer\logs. Choose a method for finding errors that most closely aligns with your issue. If the TcFTSIndexer is still running, you can send a summary log report to the command window and to the TcFtsIndexer.log. Open a new shell and run: TcFtsIndexer.bat/sh -status to generate the summary report in the console. The summary shows the steps in the flow where errors occurred. TcFtsIndexer.bat/sh -debug to generate additional information in the summary report. The summary shows the flow in progress, including connections and the logs associated with them. If the TcFTSIndexer finished processing, navigate to the end of TcFtsIndexer.log. The report contains an entry for each TaskId that has an error. Search for the TaskId in the log to locate the point of failure to learn more about the error.

Note If you need more information or if a file is referenced in the error, you can search for the TaskId in the files associated with the error, including the files from the previous step, in the TcFtsIndexer\working directory. For example, if the error is in Transform, the associated directory contains export files and transform files that you can use to resolve the error. Indexing performance Indexing performance depends on the number of warmed-up tcserver instances and the number of connections to those servers that are available for indexing. Using more servers and connections supports greater parallelization.

Note To ensure the optimal number of warmed up servers, Siemens Digital Industries Software recommends that the pool manager that maintains the tcservers be setup on a separate, dedicated machine. You can edit the Tc.maxConnections property in the TcFtsindexer\conf\TcFtsIndexer.properties file to specify the maximum number of Tc connections open simultaneously. You can also change this value dynamically: Open a new Teamcenter command window and navigate to the TC_ROOT\TcFTSIndexer\bin directory. Run the following runTcFTSIndexer utility command, where the value for connections is the number of connections desired: Copy runTcFTSIndexer -maxConnections=connections The connections value should never exceed the number of warmed up servers.

Note If you receive WARN - Connection to Tc failed messages, check to ensure the number of Tc.maxConnections has not exceeded the number of warmed servers. Login error You may encounter the following error when attempting to run the runTcFTSIndexer utility and the environment is configured for SSO: Copy Login Error: The login attempt failed: either the user ID or the password is invalid. It may occur because the user running the utility is not properly authenticated in the LDAP server. The default user that runs the utility is a user with Teamcenter administrative privileges, as defined in the Tc.user setting in the TC_ROOT\TcFTSIndexer\conf\TcFtsIndexer.properties file. Ensure that the user running the indexer is authorized in LDAP: If you are using multiple TCCS SSO App IDs, make sure they are configured correctly. You can configure multiple application IDs using the Environment Settings for Client Communication System panel in Teamcenter Environment Manager (TEM). Ensure that the user defined by the Tc.user setting in the TC_ROOT\TcFTSIndexer\conf\TcFtsIndexer.properties file is a valid user in the LDAP server and the Teamcenter database. Create a user in both if needed, or select an existing valid active user to run the runTcFTSIndexer utility. In the console, set an environment variable to the password value. Copy set mytcenv=password Create an encrypted password file for this user by running the encryptPass.bat/sh utility, located in the TC_ROOT\TcFTSIndexer\bin directory, with the -tc argument and specifying the environment variable name created in the previous step, for example: Copy encryptPass -tc mytcenv After you create the encrypted password file, remove the environment variable value. Copy set mytcenv= TcFTSIndexer output states the search engine is not accessible The following message is displayed in output after running the runTcFTSIndexer utility: Copy ERROR - The search engine is not accessible or the search engine schema is not correct. The Solr schema needs to be updated. Use the following command: Copy SOLR_HOME\TcSchemaToSolrSchemaTransform.bat TC_DATA\ftsi\solr_schema_files tcservers run out of memory Reduce the Tc.maxConnectionUsedCount value in the TcFtsindexer\conf\TcFtsIndexer.properties file to reduce the number of times a tcserver connection can be reused before log out. This helps to lower the memory consumption per tcserver. tcserver Solr authentication error Error: An error has occurred during JSON parsing: Unknown value type. Line 1 character 1. To resolve this error, update Solr credentials to reset the Solr password.