Configuring Theseus via Theseus.properties

Contents

  1. Overview
  2. Complete list of properties

1. Overview

Theseus relies on a single file called Theseus.properties for dynamic configuration. Each line in this file consists of:

[setting name] = [setting value]
where the setting name is a configuration identifier and setting value is a value supplied by the user.

Your distribution of Theseus contains a Theseus.properties file with various default values filled in. You can change any of these values as necessary, but it is suggested that you first make a backup of the original file.

2. Complete list of properties

What follows is a complete list of properties, their meaning, and their default values.

PropertyMeaningDefault
/system/debug/show_dfg Displays text representation of internal dataflow graph formed after compiling the plan. false
/system/executor/model Model of executor to run. Currently, only "pool" is supported. pool
/system/executor/pool/worker_profiles Worker thread mix. Each entry consists of a name, the number of threads, and the thread priority that they should run at (0 being highest). A typical entry looks like: name=num_threads:pri. There must be at least one entry named "default". NOTE: If you alter anything, it is suggested that you only alter the number of threads available to default. default=10:0
/system/executor/pool/admin_period Indicates the frequency (in milliseconds) that the administrative thread runs (0 or less means: do not run). 0
/system/executor/streaming_rate Specifies the granularity of streaming (in tuples). 1
/system/logger/level Shows diagnostic/error/warn messages based on this setting. Values range between 0 and 9, lower meaning "less verbose". For example, "0" shows nothing but "3" shows quite a bit. 0
/system/logger/period Number of milliseconds between times that logging messages are flushed to the file system. 0
/system/logger/file File to use for logger output ("stdout" or the name of a file is acceptable). theseus.log
/system/tools/trcli/runtime_stats Whether or not runtime statistics (such as overall execution time) should be shown. false
/system/tools/trcli/output_format How output should be annotated. Possible settings are "normal" (just display the output) and "timeline" (don't display the data, just the time that it arrived). normal
/system/tools/trcli/show_output_asap Whether or not output should be shown immediately or only after the EOS of the last output stream has been recieved. Setting this to true can be useful for more accurate timing meaasurements. false
/operators/jdbc/driver Desired JDBC driver class to be used by DbExport, DbAppend, DbUpdate, DbQuery, Schedule, and Unschedule. sun.jdbc.odbc.JdbcOdbcDriver
/operators/quip/path Filesystem path to the Quip.exe executable file. This file is called for each Xquery operator execution. c:\quip.exe
/operators/task/table_name Name of the table to be used for storing task information. TASK