Troubleshooting FTS configuration issues


When you configure AR System server for Full Text Search (FTS) or Global search, you might encounter certain issues while configuring a single indexer, multiple indexers, and searchers. Use the information in this topic to understand and resolve the issues.

Symptoms

  • FTS is not configured or set to the default installation values.
  • FTS is not configured correctly and is not working as expected.

Scope

In a server group environment, this might impact one or more servers.

Resolution

Perform the following steps to troubleshoot the FTS configuration issues:

Step

Task

Description

1

Check if FTS is configured correctly by reviewing the information in the FTS Best Practice documentation.

  • For the complete FTS Deployment and Configuration, see the knowledge article 000251833.

  • For the ITSM Best Practices document, see the knowledge article 000232571.

  • For the FTS Best Practices documentation, see the knowledge article 000291396.

  • For specific information about setting up load-balanced FTSsearchers, see the knowledge article  000236071.
    The following video (5:29) explains how to use all FTS indexers for searching:

2

Review the FTS training material for High Availability Configuration setup.

3

Determine the architecture design of AR System server.

Identify which servers are indexers and which are searchers.

4

Make sure that AR System server and FTS are licensed.

AR System server and FTS must be licensed.

For more information, see Adding-FTS-licenses.

5

Use the FTS Management form to configure FTS.

Select Application > AR System Management Console > AR System Server Group Console > FTS Management.

6

Configure FTS indexers.

Configure multiple indexers for High Availability and Disaster Recovery.

7

Configure FTS and MFS options.

Configure FTS thresholds and other options.
For more information, see Configuring-FTS-by-using-the-Server-Information-form
Configure weighting and MFS categories as required.

After you determine a specific symptom or error message, use the following table to resolve the FTS configuration issues:

Symptom

Location

Resolution

Reference

You receive an error message that FTS is either not licensed or the FTS service is not ready yet.

Browser

  • Check the Add or Remove License form and confirm that an FTS license is applied.
  • Check the FTS Configuration form to confirm that FTS has been enabled.


ERROR (678): Full text indexing is disabled.


The arfts-searcher-plugin.log file in the browser


  • Turn on full text indexing and retry the operation.
  • Check the FTS tab from Server Information form and confirm that the FTS search is not disabled.

Searches are database rather than FTS searches

The SQL logs in the browser

Check the configuration to ensure that FTS is enabled and configured.


If the issues still persist, contact BMC Support

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*