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	[e-mail]	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

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)

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