To enable connector logging, add the Conditional Setting named Connector Logging in the Search Collection > Configuration > Crawling tab's Conditional Settings section. Adding this will enable logging for the Java-based connectors. The following list consists of the labels shown in the Watson™ Explorer Engine administration tool for each variable that can be passed to this function, the type and default value of that variable, and the tooltip that is associated with it:
- Enable Logging (variable boolean enabled, default: true) - This option disables connector logging, allowing you to quickly add or remove logging without losing your configuration.
- Protocol (variable string protocol, default: *) - To restrict logging to a specific protocol, enter it here. For example, to restrict logging to the SMB Fileshare connector, use smb.
- Directory (variable string directory, default: tmp) - The directory in which to save log files. Connector log files have the name of the connector that they are associated with and are stored in the tmp sub-directory of your Watson Explorer Engine installation directory by default. You can store them in another directory by setting the Directory option to the full pathname of that directory. The location that you specify must be writable by the web server with which you integrated Watson Explorer Engine during the Watson Explorer Engine installation process.
- Log4J Configuration - the XML configuration information to pass to Log4J. The
default value for this information is the following:
<category name="com.vivisimo.connector"> <priority value="error" /> </category> <category name="httpclient.wire"> <priority value="error" /> </category> <root> <priority value="error" /> <appender-ref ref="FILE" /> </root>
After it has been added, you need to specify the log4j configuration. Select the default setting for the log4j configuration, copy the default, and paste it into the text box. You can then modify the priority setting for the logger. For example, in most situations you will want to change the following setting:
<category name="com.vivisimo.connector"> <priority value="error" /> </category>
To increase logging to the debug level (from the default, error level, enter the following setting
<category name="com.vivisimo.connector"> <priority value="debug" /> </category>