Troubleshooting Global search - Documentation for Remedy with Smart IT 20.02
Michael Hansen
Task
Description
- On the AR System Administrator Console, select System > General > Server Information.
- Click the FTS tab.
The Full Text Search Threshold field displays 10000, which is the default value. - Change this value to 2000 and click Apply.
Best practice: We recommend that you set the FTS threshold to 2000 to improve the Smart IT search performance.
- Press the F12 key in the Smart IT Universal Client and enable the browser developer tools.
- Go to the Network tab and select All.
- Select the
/ux/rest/globalsearchrest call and verify if the response of the REST call is '500'.
For information about enabling debug log level, see How to enable debug log for Smart IT version 1805 and 1808 .
ux/smartit log.Check for the word ERROR in the ux.log or smartit.log and verify the response of the ux/rest/globalsearch REST call.
The response is /smartit/rest/globalsearch/suggest/search.
In the logback.xml file, add the following logging level to capture the Global search occurrences.
Example:
<!--Optional Globalsearch logger--> <if condition='${LOG_GLOBALSEARCH}'> <then> <logger name="com.bmc.bsm.myit.service.globalsearch" level="DEBUG" additivity="false"> <appender-ref ref="GLOBALSEARCH-FILE"/> </logger> </then> </if>
Verify the FTS configuration.
For more information, see Troubleshooting FTS configuration issues and Troubleshooting Remedy Full Text Search
.
Enable API and SQL logging on the server where the search is being performed.
For load-balanced environments, enable API and SQL logging from all user-facing servers in the group.
For more information about how to enable logs across servers and server groups, see Managing the server group logs .
Reproduce the issue and note search-related information.
Enable logs and reproduce the problem.
If you are unable to reproduce the issue, wait until the problem occurs on its own.
Collect the following information to provide to BMC Support:
Important:
Analyze Java heap stack if you encounter any of the following problems:
- Increase in Java heap size
- AR System Server stops responding
- FTS plug-in server stops responding
Use a Java Virtual Machine (JVM) or other appropriate tools to obtain a heap dump or thread dump as necessary. Collect the dump files when you observe any issue.
See the following knowledge articles for more information about collecting a heap or thread dump:
Disable logging.
Allow three to five minutes for log buffering before running the Log Zipper utility. Use steps listed in the Enabling server-side AR System logs to disable logging.
Collect the logs.
Copy logs to another location where you can view them. Make sure that the logs are not overwritten.
Review the symptoms and error messages. Use the information in this table to troubleshoot the issue.
Create a BMC Support Case.
When creating a case with BMC Support, collect and send logs and detailed information:
- Provide the following information as part of your case:
- Name of the user who performed the search
- The search criteria used
- Time when the problem occurred
- Any error messages received
- Run the Log Zipper utility on each affected indexer server and select Zip Logs.
For more information about this utility, see Collecting diagnostics using the Log Zipper.
For information about how to run the Log Zipper utility using the maintenance tool, see BMC Remedy AR System Maintenance Tool.
- Attach the zip file to your case. You can attach a zip file up to 2 GB.
For more information, see SFT - Steps to send logs, files, screenshots to BMC Support for a Remedy Product related case.