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): ...