This documentation supports the 19.02 version of Remedy with Smart IT.

To view an earlier version, select the version from the Product version menu.

Troubleshooting Global search

When you search for information in Smart IT, sometimes data is not indexed properly or Full text search (FTS) or Global search does not work properly. As a result, Smart IT might take a long time to display incidents or fetch results. Use this information to understand and resolve the problem or to create a BMC Support case.

Symptoms

  • You do not get any results while performing Global search in Smart IT.
  • Poor performance is observed while performing a search in Smart Recorder.
  • Smart Recorder does not return suggested results.
  • You encounter a performance issue while performing a Global search.
  • You get search results that are incorrect or do not match your query.
  • You receive error messages while performing an FTS or Global search.

Scope

  • One or more users experience these problems.
  • In a Server Group environment, these problems might affect one or more servers.

Resolution 

Perform the following steps to troubleshoot the FTS search issues:

Step

Task

Description

1Perform test searches in Smart IT and Remedy IT Service Management.Perform a few basic searches in Remedy IT Service Management, and check if the application fetches any search results.
2If the search takes time, check the FTS Threshold value.
  1. On the AR System Administrator Console, select System > General > Server Information.
  2. Click the FTS tab.
    The Full Text Search Threshold field displays 10000, which is the default value.
  3. Change this value to 2000 and click Apply.

BMC recommends that you set the FTS threshold to 2000 to improve Smart IT search performance.

3If the performance issue persists, reproduce the issue with the browser developer tools.
  1. Press the F12 key in the Smart IT Universal Client and enable the browser developer tools.
  2. Go to the Network tab and select All.
  3. Select the /ux/rest/globalsearch rest call and verify if the response of the REST call is '500'.
4Check the search results by running the search directly on the MFS:MultiFormSearch search form.Open the MFS:MultiFormSearch form in mid-tier. Search for the same keyword that you used in Global search and check the results.
5Change the log level of the UX or Smart IT log to DEBUG.

For information about enabling debug log level, see How to enable debug log for Smart IT version 1805 and 1808 .

6Check the response from the Global search in the 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.

7Enable additional logging level for Global 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>

8Check for any indexing activity on your environment by verifying the FTS configuration.

Verify the FTS configuration.

For more information, see Troubleshooting FTS configuration issues and Troubleshooting full text search .

9

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 .

10

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:

  • Name of the user who executed the search

  • The search criteria used
  • Time period when the problem occurred

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:

  • Collecting a Heap or Thread dump of the AR Server
  • Collecting a Heap or Thread dump of the FTS Plugin Server
11

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.

12

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.

13

Create a BMC Support Case.

When creating a case with BMC Support, collect and send logs and detailed information:

  1. 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
  2. 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 .
  3. Attach the zip file to your case.
    You can attach a zip file up to 2 GB. You can also upload the files on FTP.
    For more information, see How to use BMC's Managed File Transfer (MFT) to send log files to BMC Support to comply with GDPR policies.
14Analyze the logs.You can review the logs to identify error messages or behaviors. Use the information in this table to help identify possible symptoms and solutions.


After you determine a specific symptom or error message, use the following table to identify the solution:

SymptomWhereActionReference
If you add a leading % to your search text or paste text that has a leading % in the Global search, the search term is accepted.Global searchContact BMC Support for the latest patch as per your current version.SW00531676
Global search queries run a full table scan on the CTM:People table.Global search

Contact BMC Support for the latest patch as per your current version.

SW00543535

SW00540868

Asset Search is slow and takes time to retrieve results.Global search

Contact BMC Support for the latest patch as per your current version.


SW00551040
Global Search is slow.Global search

If searches results take a long time, you can improve the search performance by modifying parameters in Server Group Configuration.

  1. Select Remedy Management Console > AR System Server Group Console > Server Group Configuration.

  2. Set the value of the isExclude_TAG_and_CI_ID and useLeadingSearchForAsset parameters as True.


Was this page helpful? Yes No Submitting... Thank you

Comments