Settings
Last modified by Sabrina V. on 2026/07/23 11:22
The settings in ACMP are organized into various sections that you can configure.
In addition, you can change settings directly via the configuration file.
Changing Settings via the Configuration File (Config.xml)
In addition to the settings you can customize directly in the ACMP Console, others can only be customized via a configuration file. This section lists the configuration options that can only be customized via config.xml. If the values for a section can be customized in a full manner via the ACMP Console, that section is not listed here.
Warning:
Customizations to the configuration file directly affect the functions and appearance of the ACMP Console. Therefore, be sure to create an unmodified backup copy before you begin customizing it!
Storage location
Note:
To customize the configuration file, you must exit the ACMP Server service!
Note that the configuration file is only located here if the ACMP Server service has been exited.
The configuration file is located in the following directory:
%ProgramData%\Aagon\ACMP\Server\Config\%ServerId%\Config.xml
The %ServerID% is unique to each installation and can be found in the Server.ini file in the server directory.
Sections
The configuration file is divided into several sections so that you can quickly find and customize the function you're looking for.
ClientConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| ConnectionReadTimeout | Seconds | 3600 | The time a client connection waits for data from the Server. |
| SearchOnlineForInstallableWindowsUpdates | true false | true | Specifies whether the WUM Scanner should find Windows Updates that can be installed online. |
| PortRangeStart | Integer | 12666 | |
| PortRangeEnd | Integer | 12699 | |
| UserLoginTimeThresholdInSeconds | Integer | 30 | Specifies the number of seconds that a user login may have occurred in the past and still be counted as a new user login for the agent (This does not affect jobs that were not executed during user login because the Windows user login occurs before the ACMP Agent starts). |
| ShutdownDialogWaitPeriodInSeconds | Integer | 10 | Specifies the number of seconds the shutdown dialog waits on the Client before the shutdown jobs are started automatically. |
| CanAbortShutdownJobs | true | true | Specifies whether users can cancel jobs during shutdown in the shutdown dialog. If the value is false, the jobs start immediately without a delay. |
| WUSPort | Integer | 8530 | The port on which the Client listens for Windows Update requests. |
ServerConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| FileRepoPath | Windows Pfad | Path to the ACMP Server's file repository | |
| FileRepoUserName | Text | Username, used when FileRepoUseAuthentication = true | |
| FileRepoPassword | Encrypted text | Password used when FileRepoUseAuthentication = true | |
| FileRepoUseAuthentication | true false | false | Specifies whether a connection to the file repository should be established. |
| SQLCommandTimeout | Seconds | 30 | Time until timeout for SQL calls |
| PushQueueSendThreadCount | Integer | 5 | Simultaneous Push Attempts |
| ServerConsolePortActive | true | TCP port on the server for ACMP consoles only | |
| ServerConsolePort | Integer | 2109 | TCP port on the server for ACMP consoles only |
| AcceptConsoleOnlyOnConsolePort | true | false | Allow ACMP console connections only through the ACMP console port. |
| ServerTmpPath | Windows path | %AcmpServer%\Temp | Path to a directory that can be used as an ACMP temporary directory. This allows you to, for example, move the directory to a RAM disk with a capacity of several gigabytes. |
| ClientAddressMode | amIpAddress amComputerName amComputerFQDN | amIpAddress | Specifies whether the client should be addressed during a push using its primary IP address (amIpAddress), computer name (amComputerName), or FQDN (amComputerFQDN). |
| UseNagle | true false | false | Enables the Nagle algorithm for the ACMP Server's outgoing TCP connections. Does not affect incoming connections. |
| CanAcceptClientsWithEmptyServerId | true false | true | If this option is enabled, the ACMP Server allows clients that have sent an empty ServerId to establish a connection. |
| ConsoleTimeout | Integer | 2880 | Timeout in minutes after which an ACMP session exits due to inactivity. |
ServerProxyConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| HostName | string | update.aagon.com | The URL of the web server from which the definition files are downloaded. This applies to vulnerability management, as well as to Managed Software, DNA, and Windows Update Management. |
| UseOwnProxySettings | true false | false | Specify whether to use the proxy settings from Active Update (false) or whether different settings should be active (true). |
AgentInstallationConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| ScanActiveDirectoryForClients | true false | true | Specifies whether Clients should be imported into the agent installation via Active Directory. |
| LastActivityOfActiveDirectoryClientsInDays | Days | 60 | The number of days since a client last logged in to Active Directory in order to be included in the import. |
| ActiveDirectoryClientScanBaseDN | Text | Leerstring | Base DN, which is used to perform Active Directory Queries. |
| InstallServiceRetryTimeout | Minutes | 10 | Time between two installation attempts |
| MaxSimultaneousInstallThreads | Integer | 5 | Specifies the number of concurrent agent installations running at the same time. |
| PingTimeout | Integer | 500 | The number of milliseconds of the timeout to wait for when pinging an IP address within the IP range. |
ClientCommandConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| IsContainerInheritanceEnabled | true false | false | Gibt an, dass Clients sich auch Scripte vom ACMP Server ziehen, die sie durch eine ContainerStruktur vererbt bekommen haben. |
| IsContainerRecalcBeforeScriptExecutionEnabled | true false | true | Specifies whether a container recalculation should be executed before the execution of a Client Command. |
HelpdeskConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| DefaultSendCommentPerMail | true false | false | Specifies whether the “Send comment via email” checkbox is initially enabled or not. This option has no effect on the bulk change. |
EMailConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| TicketIdOpenTag | Text | { | Opening tag for the ticket ID used in emails. Spaces at the beginning or end of the tag are not supported. |
| TicketIdCloseTag | Text | } | Closing tag for the ticket ID used in emails. Spaces at the beginning or end of the tag are not supported. |
MailConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| AlwaysUseFileReceiver | true false | false | DEBUG KEY: XML import for emails; to test email processing without requiring an email Server. |
Mailboxes
| Name | Value range | Default value | Description |
|---|---|---|---|
| Name | Text | Display Name (not used) | |
| Id | GUID | ID | |
| ReplyToEMail | Email adress | Reply to email | |
| ReplyToName | Text | Reply to name |
WebInterfaceConfig
HdInfoList
| Name | Value range | Default value | Description |
|---|---|---|---|
| CreatorID | GUID | Creator ID | |
| CreationDate | ISO 8601 timestamp | Date of Creation | |
| LastModified | ISO 8601 timestamp | Date of the last change | |
| ModifierID | GUID | Modifier ID | |
| HasStartDate | true false | false | Indicates whether StartDate has been set. |
| HasEndDate | true false | false | Indicates whether EndDate has been set. |
| PostDate | ISO 8601 timestamp | Used by the web interface for sorting multiple items. |
DistribFileRepoConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| NumberOfConnectionErrorsBeforePause | Integer | 3 | Specifies the maximum number of connection errors that can occur before waiting for the time specified under TimeMinutesToWaitAfterConnectionFailure. |
| NumberOfSyncProcessors | Integer | 2 | Specify how many concurrent synchronization operations are in progress. |
| TimeMinutesToWaitAfterConnectionFailure | Minutes | 5 | Specifies how many minutes to wait before retrying after the `NumberOfConnectionErrorsBeforePause` threshold has been reached. |
| ConnectionTimeOut | Seconds | 30 | Timeout during connection attempt |
| AllowedFileSizeDelta | Kilobyte | 0 | The threshold value allowed during a file size comparison before the files are considered different. If the source and target files are located on different file systems, the API may report different file sizes due to differences in block size. |
| EnableUncCopyResumption | true false | true | By default, the value is set to true, which causes the Sync Service to behave as it has in the past. If the value is set to false, files are no longer first written as part~ files and then renamed; instead, they are written directly as the target file. When set to false, resuming a transfer is no longer possible if a file was not previously transferred in its full state (incomplete files are always transferred in full again).
This value is available only in ACMP version 6.9.2. |
QueryManagementConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| RecordCountOfPage | Integer | 25000 | Number of rows per page in a query result |
| ValueDirectoryScannerTimeoutInMinutes | Positive Integer | 10 | The number of minutes the Server waits before executing the ValueDirectoryScanner after values change. |
ActiveUpdateConfig
NewUpdatesData
| Name | Value range | Default value | Description |
|---|---|---|---|
| LastTimeCheckedForUpdatesOnWebServer | floating-point number | 0 | TDateTime: The time when the system last checked the update server for Updates. |
FinancialConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| CurrencyCode | Text | EUR | Display text for cost entry in Ticket Management. |
DatabaseConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| IsFullTextSearchSupported | true false | true | Indicates whether SQL Server full-text search is installed. Determined and assigned dynamically. |
LicenseManagementConfig
| Name | Value range | Default value | Description |
|---|---|---|---|
| DNADetectionPatternResultCountLimit | 1 - 2147483647 (Integer) | 20.000 | Defines the maximum allowed number of datasets that can be returned for DNA detection patterns. |
Office365portal
| Name | Value range | Default value | Description |
|---|---|---|---|
| PortalLink | HTML Link | https://login.microsoftonline.com | The link to the web service for the Microsoft Office 365 portal. |