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 by default 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)
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
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)
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
Reports.MaxExecutionsTC
number
100
specifies maximum number of (test job-) executions to be included in test case report
Reports.MaxExecutionsTS
number
1000
specifies maximum number of (test job-)executions to be included in test scenario report
Parameters WebClient
The following parameters can be configured in the aquaWebNG.config for the WebClient, which can be found in the following default path:
C:\Program Files\andagon GmbH\aquaWebNG\aquaWebNG
In order to add a parameter, you need to find the "<aquaWebNGConfig>" section in the aquaWebNG.config file and insert a new line (or edit an existing one)
Parameter
Allowed / sample values
Default
Meaning
AQUA_REPORT_SCRIPTING_MODE
Deny/Allow
Deny
Allows to create Reports in WebClient that contain Scripts. Attention: Not trusted users might use this to compromise your server. Thus, please make sure that only trusted users are able to create/import reports to your aqua instance.
IEAllowed
true/false
false
Enables Internet Explorer, if set to true.
AQUA_FORCE_HTTPS
true/false
false
Forces forwarding to https in the Web client if the value is TRUE.
Last updated