This chapter contains is a troubleshooting instruction for problems related to the full-text search containing four levels of examination.
If the full-text search does not work (e.g. the full-text search does not appear in the user interface), maybe the installation failed and first check the following: Does WebOffice FTS-Index run without WebOffice and is Solr Admin-Web accessible? Call the URL of WebOffice FTS-Index in the browser: http://localhost:8983/FTS-Index/
Note: If the URL is used via 'localhost' and if no other IP address has been configured in the IP-Filter, then this URL must be executed on the server machine on which WebOffice FTS-Index is installed.
<%FTS-Index%> Solr Web-Admin interface must be accessible
If WebOffice FTS-Index is not accessible review the following log files for errors:
- solr.log in directory .\WebOffice FTS-Index\server\logs
Note: The log level can be set to a higher level (e.g. 'ALL') in the file '..\WebOffice FTS-Index\server\resources\log4j2.xml' to get more information in the log.
- FTS-Index_Service_log.txt in directory .\WebOffice FTS-Index\bin
In case the Solr Web-Admin of the WebOffice FTS-Index is accessible, then the communication between WebOffice FTS-Index and WebOffice application should be checked.
Open the WebOffice Application Configuration and check in the Full-Text Search configuration element whether the settings are correct:
- Check if the searchindex address contains the correct URL of the Solr server (e.g. http://localhost:8983/FTS-Index/)
Note: See chapter Configuring WebOffice FTS-Index if you want to use an IP address as URL instead of 'localhost'.
- Check whether user name and password have been entered correctly
Note: See chapter Configuring WebOffice FTS-Index for information about configuration of user and password for WebOffice FTS-Index.
Checking the settings in the WebOffice application configuration
If problems still occur after level two troubleshooting, review the WebOffice log file.
If the WebOffice log file contains an FTS-specific notification in HTML code, copy this part and save it as an HTML file in order to view the error in HTML format.
Copy the body part of the HTML code in the WebOffice log file and save it as *.htm file. The result is an error message in HTML format where it is possible to see that the domain name does not exist.
FTS error in HTML format
If WebOffice FTS-Index is running and the communication between WebOffice FTS-Index and WebOffice is working, the tab Full-Text Search in WebOffice Administration Page (SynAdmin) will be available. In case problems arise during calculating sub indices, activate the log category FULLTEXTSEARCH.INDICES and open the WebOffice log file. This log category loggs every single feature that has been indexed. The entries in the log file may explain the cause of indexing failure.
Note: The sub index has to be calculated after the log category FULLTEXTSEARCH.INDICES has been activated in order to create the respective entries into the WebOffice log file.
Tab "Full-Text Search" in SynAdmin - Communication between FTS-Index and WebOffice is working, subindices have been created successfully
Note: If problems arise during calculation of sub indices, also see chapter Problems During Initializing a Subindex for a Joined Layer.
If all sub indices have been calculated successfully but the search results of the full-text search in the client are unexpected, use the log category FULLTEXTSEARCH.SEARCH to review the WebOffice log file for errors.
Note: Execute the full-text search after the log category FULLTEXTSEARCH.SEARCH has been activated in order to create the respective entries in the WebOffice log file.
Please sign in to leave a comment.