OSEE Configuration Properties

OSEE can be configured by setting the following Java system properties when launching Eclipse. Java system properties are key/value pairs and can be passed as launch arguments in the form of -D= (i.e. -Dosee.authentication.protocol=trustAll). These -D options can be specified directly in the command to launch Eclipse or in the corresponding ini file for the eclipse executable used.

System Property Name Values Default Defining Class Description
org.osgi.service.http.port 1 - 65535 -1 OseeServerProperties Port the client will use to communicate with the OSEE Application Server
osee.application.server.data [FILE SYSTEM PATH] User Home OseeServerProperties A directory on the file system to be used by the application server to store and serve artifact binary data.
osee.derby.server [<address>:<port>] OseeServerProperties When specified, this system property sets the URL used to launch a derby database server.
osee.application.server.data [FILE SYSTEM PATH] User Home OseeServerProperties A directory on the file system to be used by the application server to store and serve artifact binary data.
osee.version [<"e;version 1"e;>;<"e;version 2"e;>] OseeServerProperties When specified, this system property sets the application server's supported client versions. NOTE: version string can use regular expressions
osee.check.tag.queue.on.startup true, false false OseeServerProperties When specified, this system property allows the application server to check the tag queue and begin tagging and pending tag jobs.
osee.connection.info.uri [FILE SYSTEM PATH] OseeProperties File system path or uri containing custom database connection information.
osee.db.connection.id <db identifier> Default from db.connection file OseeProperties Specifies which database OSEE should connect to. This id references connection information specified in the ...db.connection.xml file. See Database Connection Information file for more information.
osee.jini.forced.reggie.search true, false false OseeProperties If true, adds the lookupList to the global lookup list such that a refresh will try to locate the service again
osee.jini.lookup.groups user defined group name OseeProperties the Jini Group that all OSEE provided Jini services will register with
osee.log.default FINE, INFO, WARNING, SEVERE WARNING OseeProperties the default logging level for all loggers
osee.port.scanner.start.port 1 - 65535 18000 OseeProperties the first port number to test for availability when a new port is needed
osee.application.server [http://<address>:<port>] OseeClientProperties When specified, this system property sets the URL used to reference the application server and arbitration is bypassed.
osee.arbitration.server [http://<address>:<port>] OseeClientProperties The arbitration server address and port to use. This system property must be specified for the system to gain access to OSEE data. If the application server property is set then that address takes precedence and arbitration is bypassed.
osee.authentication.protocol protocol name OseeClientProperties protocol to be used by the client to authenticate with the server
osee.choice.on.db.init choice name OseeClientProperties the predefined database initialization choice
osee.file.specified.schema.names.on.db.init true, false false OseeClientProperties Specifies whether OSEE database initialization should use the schema names specified in the schema.xml files instead of using the connection schema. Using the connection specified schema is the default behavior.
osee.import.from.connection.id.on.db.init [FILE SYSTEM PATH] OseeClientProperties Specifies where table data should be imported from during OSEE database initialization. The default is to use the database connection id specified in the schema.xml files.
osee.import.on.db.init true, false false OseeClientProperties Specifies whether OSEE database initialization should import database data as part of its tasks.
osee.local.application.server true, false false OseeClientProperties

When set to true launches an application server upon start up. Uses org.osgi.service.http.port arg to determine port to use.

osee.local.http.worker.port <port> Port Scan starting from 18000 OseeClientProperties

Port to use for local worker server.

osee.prompt.on.db.init true, false true OseeClientProperties Specifies whether to interactively prompt the user during database initialization for init choice
osee.record.activity true, false true OseeClientProperties Specifies whether user activity should be logged
osee.ats.ignore.config.upgrades true, false AtsProperties
osee.ote.benchmark true, false OteProperties
osee.ote.cmd.console true, false OteProperties Specifies whether to enable the OTE command console
osee.ote.server.title free text name OteProperties name given to the OTE server which is displayed in the test manager
osee.ote.timing.log.path OteProperties