Server parameters

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)
 
<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
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.
Note: the 
following additional adjustments need to be configured, depending on the server settings.
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
 

Parameter 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)
<addKey="<YourParameter>" value="<YourValue>" />

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.

    • Related Articles

    • Server

      System Requirements – aqua Server aqua recommends the following minimal hardware configuration: Intel Core Processor 4x2,4GHz or higher / AMD 64bit Quad Core Processor 4x2,4GHz or higher 8 GB RAM or higher At least 5 GB free hard disk space plus at ...
    • Start Server

      After updating aqua Database and Server, you can start your aqua Server. Go back to IIS-Manager and start aquaAPIPool, aquaFileServerPool and aquaWebservicePool and (if installed) aquaWebNGAppPool. Your aqua Server is running on the new version. For ...
    • Stop Server

      First, you should ensure, that no one is working with aqua.   For JIRA-Sync users: In case you have configured one or more JIRA-Syncs, please stop all running JIRA-Syncs using the aqua Sync Configurator before you stop the aqua server. Please note ...
    • Server Installation

      Please make sure, that you have all files available to install your aqua server. 123   1. aqua for IIS Installer.msi 2. license.lic   First, you must to install the aqua for IIS Installer.msi on the Microsoft Windows server. In order to do so, double ...
    • Updating Server

      Update the aqua Server by executing the installer package “aqua For IIS Installer.exe”.   After Updating to a major aqua version, e.g. from aqua 20.X to aqua 21.X, please copy the new license(s) to the following folder (in default installations): ...