×
Menu

Server parameters

In this topic you will find some server parameters, which can be added to configure your server more individually. To add one of these you will need to open the Web.config, which can be found here: C:\Programm Files\andagon GmbH\aqua for IIS\Web\Webservice\Web.config
 
In order to add a parameter you need to find the "<appSettings>" section in the Web.config file and insert a new line (or edit an existing one)
 
<addKey="<yourParameter>" value="<yourValue>" />
 
Below you will find a list of available server parameters. Changing these parameters is at your own risk.
 
Parameter
Allowed / sample values
Default
Meaning
ServerIdentity
e.g. aqua
None
(required)
Identifies the server instance
Database
e.g. Data Source=localhost\sqlexpress;Initial Catalog=AQUA;Integrated Security=True
None (required)
Database connection string
ServerAddress
e.g. aqua.company.local
None (required)
Address of the server as included in the new user notification
LocalServerBaseDir
e.g. c:\aquaWebserviceConfig
None (required)
Parent folder where additional config files are located (in a subdirectory named after ServerIdentity). Contains, for example, subfolders with licenses and logs.
 
Parameters for Notifications
Parameter
Allowed / sample values
Default
Meaning
NotificationEmailSmtpHost
e.g. mail.company.local
Not existing
Address of SMTP server. If not defined then notifications functionality is disabled.
NotificationEmailSmtpPort
 
25
SMTP server's port
NotificationEmailSmtpUserName
 
none
...
NotificationEmailSmtpPassword
 
none
...
NotificationEmailSmtpEnableSSL
true / false
false
If true then SSL communication is enabled. Only STARTTLS is supported. (-> SMTPS (port 465) does not work).
NotificationEmailSmtpRetries
 
1
How many times to try to send a single message.
NotificationEmailFrom
aqua@andagon.com
None
'From' address of notifications send by aqua server
NotificationEmailTimeout
number (in ms)
60000
SMTP timeout
NotificationSubjectMaxLength
 
4000
Maximum length of generated subject. If exceeds, then will be cut (using ellipsis)
NotificationPeriod
number of ms
3000
 
DisableDefaultNotifications
true/false
false
Can be used to disable sending default notifications (e.g. about new items) to all members of a project.
 
Parameters for Dependecies
Parameter
Allowed / sample values
Default
Meaning
CreateCopyDependencies
true/false
true
If false then no dependency created on copying an item
CreateNewVersionDependencies
true/false
true
If false then no dependency created on creating new version of an item
 
Parameters for Attachments
Parameter
Allowed / sample values
Default
Meaning
MaximumAllowedAttachmentSizeInBytes
Number, in bytes
10485760 (10MB)
Maximum size (in bytes) of attachments that can be stored in aqua.
MaximumAllowedImageInRTFSizeInBytes
 
 
 
MaximumAllowedQTPScriptFileSizeInBytes
 
 
 
MaximumAllowedScriptAttachmentSizeInBytes
 
 
 
MaximumAllowedOverallScriptAttachmentSizeInBytes
 
 
 
 
Parameters for Performance Log
Parameter
Allowed / sample values
Default
Meaning
DbLogEnabled
true/false
false
If enabled, long running db queries are logged
DbLogLimit
number
1000
 Limit in milliseconds for the execution time of single db query or transaction
DbLogAll
true/false
false
If enabled, all db queries are logged. This produces lots of log entries!
RequestStatisticsEnabled
true/false
true
If enabled, long running requests are logged
RequestStatisticsWindowSize
number
600000
Time window in milliseconds to consider for the overall limit
RequestStatisticsOverallLimit
number
30000
Overall limit in milliseconds for the execution time used by a session.
RequestStatisticsRequestLimit
number
2000
Limit in milliseconds for the execution time of a single request
RequestStatisticsLogAll
true/false
false
If enabled, all requests are logged
 
Parameters for numbers of elements
Parameter
Allowed / sample values
Default
Meaning
NumberOfElementsInTestCaseExecutionHistory
 
 
How many elements to show in the execution history ("sparkline") of a test case. Old data is not updated after changing this.
MaximumAllowedNumberOfItemsInOneUpdate
 
 
How many items can be updated in single operation (by context's menu "Change" operation)
NumberOfItemsInOneUpdateWarningLevel
 
 
How many items selected for updated in single operation (by context's menu "Change" operation) causes a warning (because selecting too many items can take long time).
MaximumNumberOfTestJobsInTestScenario
number
2000
Maximum number of test jobs allowed in a test scenario.
 
Miscellaneous parameters
Parameter
Allowed / sample values
Default
Meaning
SingleSignOn
true/false
false
Activates SSO functionality. Requires AD plugin.
EnableStopWatchForManualExecutions
true/false
true
If false then timer in execution window will not be shown (useful when legal regulations prevent from using such a timer)
ActiveDirectory.Domain
domain name
None