Logging and tracing for the Db2 Text Search server

The Db2 Text Search server logs system messages and traces messages to help you determine the source of problems that might occur. Diagnostic data that you collect, and the sources from which you collect that data, depend on the type of problem that you are investigating.

For specific symptoms, you might have to collect additional problem-specific data from the following locations:
  • <install-path> for the server. This might vary depending on the server type:
    • <DBPATH>/db2tss for the integrated text search server
    • <ECMTS_HOME> for the stand-alone text search server
  • <absolute-path-to-config-folder> the location for configuration files for the text search server
  • <collection-path> the directory that is specified as COLLECTION DIRECTORY in the CREATE INDEX operation (only for integrated text search servers), or if the default is used, in the defaultDataDirectory (for integrated and stand-alone text search servers).

To collect diagnostic data for the stand-alone Db2 Text Search server:

  1. Run the administration tool with the version command:
    adminTool version -configPath <absolute-path-to-config-folder>
  2. Collect log files that are stored in the logpath configured for the text search server.
  3. In some cases, you might want to capture more detailed information:
    • Specify your preferred command-line tool logging properties by editing the ecmts_config_logging.properties file in the directory <absolute_path_to_config_folder>.
    • Specify trace logging properties by editing the ecmts_logging.properties file in the directory <absolute_path_to_config_folder>.
    • Enable tracing by using the adminTool command.
    adminTool configureTrace -configPath <absolute-path-to-config-folder> -trace on
  4. Gather the following configuration files from the <absolute-path-to-config> directory:
    1. configuration.xml
    2. key.txt
    3. authentication.xml
    4. constructors.xml
  5. If you encounter a collection-related issue when creating, deleting, indexing, or searching a collection, locate the collection configuration file in the <collection-path> directory, and if required, collection data from the <collection-path>/data directory.
  6. If you encounter an issue that is related to stop words, collect the stop word XML files from the <install-path>/resource/uima folder.

    Stop word XML files are named as <language_code>-Stw.xml.

  7. If you encounter an issue that is related to synonyms, collect the synonyms from the <collection-path>/data/synonym directory and contact Db2 Support.