Configuring Global Options for Watson Explorer Engine

Watson™ Explorer Engine uses a number of option settings to identify the location of various filesystem resources and, in some cases, to trigger the use of those resources. Many Watson Explorer Engine options, such as the location of temporary directories, are always used, while others, such as the location and name of debugging files, are only used if the debug option is used to activate the generation of debugging output. Most of the options used by Watson Explorer Engine are traditionally set in the Watson Explorer Engine administration tool, but some must be set before starting that tool. All of these options can therefore be specified in the Watson Explorer Engine vivisimo.conf configuration file regardless of whether the Watson Explorer Engine administration tool is being used.

The default contents of a vivisimo.conf file in a Microsoft Windows Watson Explorer Engine installation are the following:

<?xml version="1.0" encoding="UTF-8" ?>
    <options>
    <option name="install-dir">C:\Program Files\IBM\WEX\Engine</option>
    <option name="base-url">/vivisimo/</option>
    </options>

The default contents of a vivisimo.conf file in a Linux Watson Explorer Engine installation are the following:

<?xml version="1.0" encoding="UTF-8" ?>
    <options>
    <option name="install-dir">/opt/ibm/WEX/Engine</option>
    <option name="base-url">/vivisimo/</option>
    </options>

To set any of the options that are discussed in this section, simply add an appropriate option entry to the vivisimo.conf file for your Watson Explorer Engine installation. Any directories that you modify from their installation defaults must be writable by the web server with which Watson Explorer Engine is integrated.

Warning: The vivisimo.conf file should only be modified when Watson Explorer Engine is not running. If you need to modify the contents of this file, IBM recommends that you modify this file before running Watson Explorer Engine for the first time.

For example, the following vivisimo.conf file sets the directory used to store debugging output (debug-dir) to C:\debug (which must already exist - Watson Explorer Engine will not create this directory):

<?xml version="1.0" encoding="UTF-8" ?>
    <options>
    <option name="install-dir">C:\Program Files\IBM\WEX\Engine</option>
    <option name="base-url">/vivisimo/</option>
    <option name="debug-dir">C:\debug</option>
    </options>
Note: When setting networked file or directory locations for Watson Explorer Engine related storage on Microsoft Windows systems, do not use mapped drives (in other words, network locations that are associated with a drive letter) because they may be user- or system-specific. Watson Explorer Engine supports networked file or directory locations for related storage that is specified in Universal Naming Convention (UNC) notation.