Changes to the web.config file can leave Enterprise Tester inoperable. We advise taking a backup of your web.config file and database prior to making changes.
Some configuration settings in Enterprise Tester are not yet exposed in the User interface. The you can apply custom settings to some features in the appSettings section in the web.config file. In the appSettings section, you can add key/value pairs which can be used to control features of Enterprise Tester .
Supported Keys
The grid below scrolls, but if you are having trouble viewing it in your screen please refer to this attachment as an alternative.
| Key | Feature | Example Value | |||||||||||||||
ActivityStreams.AvatarImages.Path | The path to avatar images used by the activity stream dashboard portlet. | c:\Enterprise Tester\data\Avatars\\\ | |||||||||||||||
attachment.storage.method | Storage method to use, either InDatabase or FileSystemCas - defaults to InDatabase. | FileSystemCas | |||||||||||||||
attachment.storage.garbagecollection.disable | Set to true to disable garbage collection or false to enable garbage collection. | true or false | |||||||||||||||
attachment.storage.garbagecollection.dwell | Minutes between garbage collections, should generally be set to an hour or more. | 30 | |||||||||||||||
attachment.storage.path | Path to where attachments are stored, defaults to \Data\Attachments|f:\et-attachments. | f:\et-attachments | |||||||||||||||
Baseline.Export.MaxAttachmentSize | The maximum size for attachments (in bytes) to be included in any exported baseline, if not set it will default to 4mb. | 1024000 | |||||||||||||||
defects.synchronizer.disable | If true, the defect synchronizer service will never start its background synchronization thread, and enqueued synchronization requests will be discarded. | true or false | |||||||||||||||
defecttracking.settings.populator.syncuncachedonstartup | If true (the default) then at startup we check to see if any projects are "uncached" and require a refresh lookups sync to be executed, if so we trigger an update at startup. | true or false | |||||||||||||||
defecttracking.settings.timebetweensynchronizations | Time to wait after completing a defect synchronization pass across all projects, before checking again. | 00:01:00 | |||||||||||||||
EnterpriseArchitect.Synchronization.Requirements.DisplayExistingElementsReport | Disables displaying / calculating the existing elements report for requirements EA import/sync. This report can be very costly (half hour +) to calculate for large EA projects where there may be tens of thousands of requirements. Default for 4.2 and above is "false" | true or false | |||||||||||||||
externaldata.createlink.autorefreshlookups | If true (the default) then after creating a link the lookup refresh process will be triggered to refresh of all the cached custom/inbuilt field info. The refresh process will only work if the defect tracker is also enabled. | true or false | |||||||||||||||
extjs.timeouts.ajaxFormSubmitTimeoutInSeconds | The timeout when submitting ExtJS forms (in seconds). | 30 | |||||||||||||||
extjs.timeouts.ajaxRequestTimeoutInMilliseconds | The timeout for ajax requests (in milliseconds). | 30000 | |||||||||||||||
extjs.timeouts.ajaxUpdaterTimeoutInSeconds | The ajax update timeout for requests (in seconds). | 30 | |||||||||||||||
Help.CanEdit | If true, then editing functions in online help are enabled (currently alpha state) - defaults to false | true or false | |||||||||||||||
incident.create.defaultStatus | Defaults to "Open", but can be set to either a single value i.e. "Closed" or multiple options, separated by commas i.e. "Open, Ready, Awaiting Review" - in which case each value in the list will be tried until we can find a match - useful if you have different projects which have different sets of statuses. | Open, Created | |||||||||||||||
JIRA.Issues.DateFormat | The date format used for rendering ET date fields to strings, as required by JIRA - defaults to "dd/MMM/yy hh:mm a". | dd/MMM/yy hh:mm a | |||||||||||||||
JIRA.remotelinks.prefix | The prefix added to the start of relationship names when synchronized to JIRA as remote links, it defaults to "ET: " - to disable the prefix, you can switch it a blank value, or distinguish between ET instances by setting it say "ET-Prod: " and "ET-Dev:". | ET: | |||||||||||||||
JIRA.session.timeouts.open | The max time it can take to open an http connection to the JIRA soap service, defaults to 00:02:00 (2 minutes - prior to v3.3 this was fixed at 1 minute) | 00:02:00 | |||||||||||||||
JIRA.session.timeouts.close | The max time it can take to close a connection to theJIRA soap service, defaults to 00:02:00 (2 minutes - prior to v3.3 this was fixed at 1 minute) | 00:02:00 | |||||||||||||||
JIRA.session.timeouts.send | The max time it can take to send a request to the JIRA soap service, defaults to 00:02:00 (2 minutes - prior to v3.3 this was fixed at 1 minute) | 00:02:00 | |||||||||||||||
JIRA.session.timeouts.dwellBetweenScraping | The time to wait between successive screen-scraping requests when fetching options for custom fields, for low-spec JIRA servers you might need to adjust this to give the server a chance to "breathe" between requests, to avoid degradation in performance for other users. Defaults to 1 second delay. For high-spec JIRA servers, you can set this value at 0 seconds, to have no delay between scraping requests | 00:00:01
| |||||||||||||||
licensing.serverkey.generationmode | Generates a stable server key even if the MAC address changes over time. | Stable | |||||||||||||||
migration.providerName | The name of the provider class used for applying database migrations. | Migrator.Providers.SqlServer.SqlServer2005Dialect | |||||||||||||||
notifications.peruserlimit | The maximum number of notifications to record per user, once the limit is reached older notifications will be discarded for newer ones. | 100 | |||||||||||||||
PathService.PackagePathSeparator | The separator character used for display requirement/script paths - defaults to "|" in v4.2 and above (the default is “/” in V4.1 and earlier) . | # | |||||||||||||||
project.templates.path | The path to the set of baselines which are used as project templates available when creating a new project. | c:\ET\project_templates\ | |||||||||||||||
remotelinks.synchronization.dwellBetweenSynchronizations | The value can be specified as either a number e.g. 5 - which would be 5 seconds, or formatted as what's called a timspan e.g. "hh:mm:ss" - so 5 minutes would be specified as 00:05:00.
| ||||||||||||||||
ScriptService.MaximumStepsPerScript | The maximum number of steps allowed for a script - default is 100. | 100 | |||||||||||||||
search.indexes.path | The path to the indexes folder (in v4.0 and later, if not specified, this defaults to the \Data\Indexes folder of the installation directory. | c:\Enterprise Tester\data\Indexes\ | |||||||||||||||
Search.Relationships.Expand.AllRelationships | Defaults to false, if set to true then "all relationships" are indexed, which will results in a much larger set of re-indexing occurring after each change within the application. | true or false | |||||||||||||||
search.reindex.waituntilemptytimeout | The time to wait before aborting the reindexing process when waiting for the index queue to flush - 5 minutes by default. | 00:05:00 | |||||||||||||||
search.indexworkprocess.timebetweencommits | The time between commit changes to the search index. | 00:01:00 | |||||||||||||||
search.indexworkprocess.workerdwell | The time to wait before waking up again processing search index changes (changes in ET will also trigger the worker process to "wake up"). | 00:00:15 | |||||||||||||||
search.indexworkprocess.waituntilemptytimeout | The time the index worker processor will wait for the queue to empty - currently used in unit tests. | 00:01:00 | |||||||||||||||
site.root.url | Root URL to use for the site when generating external links for applications such as defect trackers, this can be useful when ET uses the wrong address when generating links. | ||||||||||||||||
site.root.url.scheme |
| Https | |||||||||||||||
site.staticcontent.url | Allows configuration of a cookieless domain for serving static content | ||||||||||||||||
slowpages.enabled | Slow page logging enabled/disabled. If enabled, then this will impact on application performance somewhat (it turns nhibernate statistics on for the request). | true or false | |||||||||||||||
slowpages.threshold | The threshold before a page is logged as being "slow" (in milliseconds). | 2000 | |||||||||||||||
synchronization.mapattachmentsstep.dontsyncfileswithsamenameandsize | Defaults to false, but if set to true then when synchronizing if a file is found that has the same file name and file size as a previously synchronized file, it will be skipped - useful if you want to avoid attachments which have been duplicated by another synchronization process or user error.
| true or false | |||||||||||||||
Testing.Scripts.Delete.InsertDelayInSeconds | Inserts a delay into the delete script action i.e. request to delete an item will take XX number of seconds long to complete. | 30 | |||||||||||||||
Testing.Scripts.Get.InsertDelayInSeconds | Inserts a delay into the getscript action i.e. request to get details of single script for display of edit window, will take XX number of seconds longer to complete. | 30 | |||||||||||||||
Testing.Scripts.List.InsertDelayInSeconds | Inserts a delay into list action i.e. request to get items to display in the scripts grid (value is in seconds). | 30 | |||||||||||||||
Testing.Scripts.Save.InsertDelayInSeconds | Inserts a delay in the save script action, increase the time to complete the action by XX seconds. | 30 | |||||||||||||||
TrialSupport.EnableAnonymousTrialStatistics | Enable the sending of anonymous trial statistics to allow Catch Software to monitor the quality of the installation and initial project setup experience for users with an Enterprise Tester trial license applied. | true | |||||||||||||||
versionControl.changeTracking.disable | Disables change tracking (this will prevent the change tracking information from being recorded on save, this will cause the "History" tab of the Requirement, Script and Incident screens to remain empty. | true or false |
Setting a Key
To set a key:
- Open the web.config file in a text editor.
- Locate the section starting with <appSettings>
- Add the new entry, in the format off: <add key="key-name" value="value" />
- Save changes
- Refresh ET in browser, it should reload with the new settings applied.
Example - before adding new values:
<appSettings>
<add key="migration.providerName" value="Migrator.Providers.SqlServer.SqlServer2005Dialect"/>
</appSettings>
Example - after adding new values:
<appSettings>
<add key="migration.providerName" value="Migrator.Providers.SqlServer.SqlServer2005Dialect"/>
<add key="search.index.disable" value="true"/>
<add key="versionControl.changeTracking.disable" value="true"/>
</appSettings>