ACMP Server
The ACMP Server
This section allows you to reduce the load on your ACMP Server.

ACMP Server - Performance Settings
Job Submission
Specify the wait time until the next submission attempt if a job fails. This value is specified in minutes and is set to 15 minutes by default.
Performance Settings
You can configure performance using the performance settings. There are 6 different queues available for this purpose, each covering a separate performance area.
This division helps prevent potential performance issues that would otherwise cause delays in processing requests. With the various queues, you can specify the number of threads for each individual area.
| Queue | Description |
| Allocated threads for the dispatcher queue | The dispatcher queue is responsible for all requests and distributes them to the other queues. It reads the header and performs the SSL handshake, which allows all requests to be routed to the other queues. The number of specified threads (default: 4) is sufficient for small to medium-sized environments. |
| Allocated threads for the agent queue | The agent queue is one of the most important settings when you have many Clients in use. For the queue, you can use the “Active Client Connections” metric in performance monitoring to check whether there are any delays in terms of performance deviation. |
| Allocated threads for the console queue | If you have many consoles running at the same time, delays may occur when there are a large number of concurrent requests. This can happen, for example, when many consoles are using the Helpdesk. If delays occur in the console, you can increase the number of threads to alleviate the load. |
| Allocated threads for the Web Interface queue | The Web Interface queue occurs when many browsers in your environment are accessing the Web Interface at the same time, causing delays. In this case, increasing the number of threads may help. |
| Allocated threads for agent in rollout queue | The difference between the agent queue and the agent rollout queue is that the latter explicitly refers to the Clients that are assigned a Rollout. |
| Allocated threads for the ACMP Kiosk queue | This queue is used, for example, when you want to install Client Commands, Job Collections, or Managed Software via your clients and the ACMP Kiosk. |
Checking Queues for Overload
You can use Performance Monitor to check whether the queues are overloaded. To do this, add a new performance counter using the Performance Monitor service and select the ACMP Server instance.

Add ACMP Server as a Performance Indicator
You can identify an overload by looking at the graph; if it shows a consistently high value and does not drop toward 0, there is an overload. Use the various lines in the chart to determine which queue is causing a delay in the system.
Port Settings
The port settings allow you to customize the port for server communication with the ACMP Console.
To change the port, first enable the “Use alternative port” checkbox. Then enter the desired port number.
If you've changed the port, save your settings.
Console Login Settings
This setting configures the option to save the password in the console login dialog. If you want to disable this option, check the checkbox below it. This prevents the password from being saved, and the user must enter it manually each time.
Active Directory
ACMP can read user and group information from Active Directory. To do this, you need a user account with read permissions in the domain.

System Settings: Active Directory
Manage Active Directory
Enter the required information under Active Directory. To do this, click the Change button and enter the domain, username, and password to be used. You can also choose whether to use encryption for Active Directory (SSL/TLS), which encrypts the data being transmitted. You can enter additional information in the “Description” field. If you want to use a static IP address to connect to a specific domain controller, you must enable the corresponding checkbox. It is advisable to use a static IP address (domain controller IP or global catalog IP) if, for example, the domain controller cannot be resolved using Windows’ built-in mechanisms. Otherwise, you can disable the field.

Credential Properties
Recommendations for Use with Active Directory
The following recommendations apply when using Active Directory:
- Under “User Domain,” enter the FQDN (Fully Qualified Domain Name) and not “just” the NetBIOS name. In this example, it is the internal Windows domain (aagon.local).
- Use SSL/TLS as the encryption method to secure data transmission.
- Ensure that the client executing the Query is a domain member (for example, in the case of this AD login, that would be the ACMP Server).
- Additional examples: For kiosk visibility, the client must be a domain member; for Client Commands, the executor itself must be a domain member (either the ACMP Console or the ACMP Agent).
Only by following the recommendations above can you ensure that Windows uses Kerberos for authentication and does not fall back on NTLM.
Multiple Domains
If you want to use multiple domains for Active Directory - for example, to search them for users - you can assign global accounts here. You assign these accounts by clicking Link. A mask will open where you can add new accounts, edit existing ones, or delete them entirely. Clicking OK will immediately enable the account to find the specified domain. If you want to deselect all domains, select the appropriate domain and click the Unlink button. This function allows you to delete old domains from your system and exclude them from searches.
Active Directory Login
You can import Active Directory users into the ACMP User Management module. This means that user account management is configured entirely in Active Directory, but permissions are still managed in the ACMP User Management module.
To enable ACMP login for AD users, enable the checkbox labeled Enable ACMP Console Login for Active Directory Users. Additionally, you must configure the ACMP access group “AD Login” and assign to it the AD groups that are permitted to log in to ACMP. To do this, click the link displayed under the “Access Groups” heading and navigate to user management to customize the access group. Now assign the groups from your domains - which are permitted to log in to the ACMP Console - to the ACMP group “AD Login.”
LDAP Result Cache
The LDAP Result Cache allows you to specify how long the ACMP Server should cache the results of LDAP Queries. The default value is 15 minutes; you can enter up to 120 minutes as the maximum cache lifetime.
Importing AD Users
To import an AD user, you must first add an AD account via System > Settings > ACMP Server > Active Directory. Then configure an AD-Login and select an AD group. Next, in user management, import the desired AD users.
Convert Existing ACMP Users to AD Users
If AD login is enabled at a later date, the existing ACMP users can be converted to AD users. The conversion is performed using ADUserMigrate.exe, which is located in the ACMP server directory. Run the executable from the Command line. First specify the ACMP User, then the AD User (e.g., “C:\Program Files (x86)\Aagon\ACMP Server\ADUserMigrate.exe” tester tester@domain.local). Once the execution has been completed, the users will be converted.
Allowing Additional Users from a Trusted Domain
If you want to allow additional users from a trusted domain - hat is, another trusted domain - you must grant the querying AD user read permissions on the ForeignSecurityPrincipal object and its child objects.

Advanced Security Settings for “ForeignSecurityPrincipals”
To do this, enable the advanced features in your Active Directory Users and Computers MMC. On the Security tab of the ForeignSecurityPrincipal container, click Advanced to view all users and groups that already have access to this object. Using Add, you can then add the user who should have access to the Trusted Domain. Make sure that the user is granted Read permissions (these are usually already selected) and that the permissions are applied to This object and all child objects.
This user must then also be added in ACMP under Settings > ACMP Server > Active Directory.
Email Service
On this page, you can enter the connection details for your email service and the server. This allows emails to be retrieved automatically and saved as tickets. Emails can also be sent automatically, for example, during automatic ticket generation or when a specific escalation level is reached (see Escalations and Rules).

Settings: Email Service
Server information
First, specify whether you want to enable receiving and sending emails. To do this, check the box next to Enable Email Service. This is also a condition for making changes in the following sections. Insert the sender and the display name. The sender should be an email address, and the display name is the name that will appear when sending and receiving emails. You can use the timeout setting to specify how long the email service should wait before responding to a connection request. The default setting is 30 seconds. You can also specify the interval at which incoming emails should be retrieved.
After you have entered all relevant information for sending and receiving email, you can also test the connection to verify that all entered data is correct.
Receiving Email
First, enable the Enable Email Reception checkbox to enter additional information in this section. Then enter the incoming mail server. New emails will then be retrieved via IMAP4 or POP3 through this account. If you use IMAP, you must also specify the corresponding inbox folder. In addition to entering the incoming mail port, you can also configure transport encryption. You have the following options:
| Option | Explanation |
|---|---|
| No SSL | An unencrypted connection is established for communication. |
| STARTTLS | In this process, the connection is initially established in unencrypted form. Once encryption has been negotiated, the subsequent connection is encrypted. If the negotiation fails, communication continues in unencrypted form. |
| SSL/TLS | Encryption is negotiated at the start of the connection establishment. If this fails, communication is not possible, and no unencrypted data is transmitted. |
Now enter a username and password for the account.
To configure password encryption, you have the following options in addition to the encryption level:
| Option | Explanation |
|---|---|
| Regular Password | In this case, the system attempts to use PLAIN or login as the authentication mechanism. If the Server does not explicitly support any of these mechanisms in its capabilities, the protocol default is used. |
| Encrypted Password | The SASL mechanism performs an automatic determination of which authentication mechanism is used. The available options are CRAM SHA1, CRAM MD5, SKEY, OTP, and DIGEST. |
| NTLM | The NTLM mechanism is used here. |
| OAuth | With this encryption method, you cannot enter a password; however, OAuth configuration is available. Selecting the OAuth option enables OAuth configuration. Here, you can request a new token or delete an existing one. |
Under “Inbox Folder,” you can enter a caption; the default is INBOX. If you want to delete emails after retrieving them from the Server, you can check the checkbox with the same name.
Send Email
Enter some details for sending emails. Specify the Server and port through which the messages are to be sent. To do this, you must specify the outgoing port and the transport method:
| Option | Explanation |
| No SSL | An unencrypted connection is established for communication. |
| STARTTLS | In this process, the connection is initially established in unencrypted form. Once encryption has been negotiated, the subsequent connection is encrypted. If the negotiation fails, communication continues in unencrypted form. |
| SSL/TLS | Encryption is negotiated at the start of the connection establishment. If this fails, communication is not possible, and no unencrypted data is transmitted. |
Check this box if you do not want to accept trusted certificates. For the authentication mechanism, you can choose from various options (no authentication, use settings from the email inbox, or use these credentials). Depending on your selection, the user credentials will be imported from the email inbox, or you will need to enter your own credentials. Also select password encryption for sending emails:
| Option | Explanation |
| Regular Password | In this case, the system attempts to use PLAIN or login as the authentication mechanism. If the Server does not explicitly support any of these mechanisms in its capabilities, the protocol default is used. |
| Encrypted Password | The SASL mechanism performs an automatic determination of which authentication mechanism is used. The available options are CRAM SHA1, CRAM MD5, SKEY, OTP, and DIGEST. |
| NTLM | The NTLM mechanism is used here. |
| OAuth | With this encryption method, you cannot enter a password; however, OAuth configuration is available. Selecting the OAuth option enables OAuth configuration. Here, you can request a new token or delete an existing one. |
OAuth configuration
Using the OAuth configuration, you can view a token username, request a new token, or delete a token. To use the latter two options, you must already have a token. You can only use this option if you have selected OAuth as the password encryption method.
End-to-End Encryption
In ACMP, you have the option to use S/MIME encryption technology for your email traffic. End-to-end encryption is established when both the sender and the recipients have received the other party’s public key via an S/MIME-encrypted email. The content of the communication can then only be read by the sender and recipients. Third-party access is prevented.
Go to System > Settings > ACMP Server > Email Service > End-to-End Encryption. By default, ACMP does not use any email encryption technology. If you want to use S/MIME, you must first choose an encryption mode:
Encryption Mode | Meaning |
| No email signing or encryption | S/MIME is not used; email traffic is transmitted without sender verification and is unencrypted. |
| Signing Emails | The email is digitally signed, which verifies the sender's identity. In this case, however, third parties can still read the message. There is no encryption. |
| Sign and encrypt emails, but allow them to be sent unencrypted | The email is digitally signed and encrypted. However, emails can still be sent even if an S/MIME certificate is not on file for every recipient. |
| Sign and encrypt emails; never allow them to be sent unencrypted | The email is digitally signed and encrypted. However, emails can only be sent if an S/MIME certificate is on file for EVERY recipient. |
Manage Certificates
To ensure that your emails have an S/MIME certificate and are therefore encrypted, you must first specify your certificate in ACMP. You can obtain a certificate either by generating one yourself or by purchasing a CA certificate.
Go to Manage Certificates > Add Certificate.
Specify the certificate file and the private key file.
For the private key file, enter the corresponding password under Passphrase. Click OK. The certificate's serial number and validity period will be automatically retrieved and filled in.
When you send an email, a certificate with S/MIME will be automatically attached.
If you want to delete the certificate later, click Manage Certificates > Delete Certificate.
Adding Recipient Certificates Manually
By default, public certificates from received emails are automatically saved. However, if you receive a sender’s certificate through a method other than email, you can add the certificate manually.
To do this, go to Master Data > Contacts on the ribbon bar. In the Contact Details of an existing contact or a new contact you are creating, click the icon in the Email field and enter the certificate there.

Add a Certificate for Contacts in Master Data
Scheduled Server Tasks
To manage server load, you can define predefined server tasks and their individual start conditions here.

Settings - Scheduled Server Tasks
You can select the start conditions yourself by double-clicking on the corresponding task. The following options are available to you:
| Possibility | Explanation |
| At a specific time | The task is executed daily at the specified time. |
| Within a start interval | The task will be performed at the specified time. |
| On the last day of every month (deprecated) | In this case, the execution always starts on the last day of the month. You can also specify whether the execution should run at a specific time, during shutdown, based on a start interval, or within a time window. |
| Within a date range | Specify an interval in minutes, hours, or days. |
| On specific days of a week | Specify one or more days. You can then specify a specific time, a start interval, or a time window. |
| On specific days of a month | Specify a day of the month. You can then specify a specific time, a start interval, or a time range. |
| Within a time frame | Specify a time window for execution. |
You can also manually trigger the execution by clicking Start Now.
You can choose from the following predefined server tasks:
| General | |
|---|---|
| Checks for items with new Distribution Ring | Checks whether elements can be moved to the next distribution ring. |
| Client Tenant relation calculation | Dynamically links clients to clients based on the tenant filter. |
| ACMP Gateway cleanup | Removes expired certificates from the ACMP Gateway. |
| Server Monitor log cleanup | Removes server job executions that are older than 30 days (default). |
| Assigns Clients to Containers dynamically | Calculates dynamic shortcuts from Clients to containers. |
| Renew Client Certificates | Renew the Gateway certificates on the Clients. |
| Scan network | Scan the network for new Clients. |
| Server license update | Retrieves new license information from the Aagon license server. |
| VMware vSphere Scanner | Scans VMware vSphere Server for guest systems. |
| Generate value directory | Updates the available values for filters. |
| Client Commands | |
| Client Command versions cleanup | Performs a cleanup of Client Command versions whose last date modified is older than 120 days (default). |
| Client Command log cleanup | Performs cleanup on logs that are older than 30 days (default). |
| Job logs cleanup | Performs cleanup on logs that are older than 30 days (default). |
| Defender Management | |
| Defender Event cleanup | Performs cleanup on logs that are older than 30 days (default). |
| Defender quarantined items log cleanup | Performs cleanup on logs that are older than 40 days (default). |
| Helpdesk | |
| Mail Service cleanup | Deletes message IDs that no longer exist on the email server from the database. |
| Escalate Tickets | Checks escalation criteria and escalates tickets as needed. |
| Intune | |
| Import Intune data | Imports Intune Apps, Groups, Users and Devices |
| License Management | |
| Contract auto extension | Automatically renews the relevant contracts. |
| Import Microsoft 365 license data | Importes Microsoft 365 license and product data for License Management. |
| DNA2 catalog update | Updates the DNA2 catalog, calculates new and unrecognized software to improve the detection rate, and reports this information to ACMP. |
| Recalculate License Management compliance view | Recalculates the compliance data. |
| Clients without Primary User calculation | Calculates dynamically determined Clients that do not have a mapping to a primary user |
| Managed Software | |
| Managed Software cleanup | Deletes software versions that are no longer needed, thereby freeing up storage space. |
| Managed Software catalog update | Updates the software catalog for Managed Software. |
| Managed Software version download | Downloads new versions of Managed Software. |
| Vulnerability Management | |
| Vulnerability history cleanup | Performs a cleanup on logs that are older than 90 days. |
| Update vulnerability definition file | Updates the vulnerability definition file.
|
| Windows Update Management | |
| Windows Update log cleanup | Performs cleanup on logs that are older than 30 days (default). |
| Windows Update Managed Clients recalc | Calculates dynamic links for clients managed by ACMP Windows Update Management. |
| Windows Update Management cleanup | Frees up hard drive space occupied by unnecessary Windows Updates. |
| Windows Update Management metadata download | Downloads metadata about Windows Updates. |
| Windows Update setup download | Downloads setup files for Windows Updates. |
Global User Accounts
Here you can create global user accounts. These are used to access deployed file repositories, join domains during OS Deployment, run AD Queries, install agents, and execute Client Commands.
Add a Global User Account
To add a new user account, click the Add button. In the window that opens, enter the username and password. You must re-enter the password to perform passwort confirmation. After confirming with OK, the user account will appear in the overview. You can edit or delete it as needed.

Global User Accounts
Edit Global User Account
To edit a global user account, select it in the overview and click the Edit button on the right. You can now edit all the fields that are also available when you Add a user account. After you have made the desired customizations, click OK.
Delete a Global User Account
To delete a global user account, select the account in the overview and click the Delete button on the right. The system will now check whether the global user account to be deleted is being used by other elements in ACMP. The result will be displayed in a dialog box.
HTTP API
In this setting, you can specify the port used for file transfers in the ACMP app or for the active SICS connection. The ACMP HTTP API port is responsible for uploading and downloading files. By default, the checkbox is enabled. To disable it, you must explicitly uncheck the box. Also, specify the port to be used for the connection.
Also, check the additional checkbox if you want to disable TLS Legacy. This will disable the versions available starting with Windows Server 2022.

Settings for the HTTP API
Multi tenancy
To enable general multi tenancy in ACMP, click Enable Multi Tenancy.
1. Click “Enable Multi Tenancy.” A wizard will open.
2. On the first page, you’ll see a graphical representation of the multi tenancy architecture. Click Next.
3. On the second page, the system checks whether all prerequisites are met:
- At least one tenant must exist.
- There must be users who have permissions for at least one tenant or who are registered as tenant administrators.
Attention:
Any users who do not have permissions specified for individual tenants or the “Tenant Administrator” role will no longer be able to log in to the ACMP Console after multi tenancy is activated. If there are any such users, a warning will be displayed!
4. In the next step, you’ll configure two settings:
- Login:
Here, you specify whether a user is allowed to log in to multiple tenants at the same time.
- Execution of the “SQL Query” Command
You decide whether the “Execute on ACMP Server/Database” option should be enabled or disabled in SQL commands.
5. After configuration, click “Done” and save the settings via the ribbon bar to permanently enable multi tenancy.
Important Notes After Activation
Important Notes After Activation
Job and Client Monitor
Jobs that have already run may no longer be displayed. This is because the display is filtered by tenant—you will now only see the jobs for the tenant you are logged in to.
Select a Tenant
If you would like to view specific jobs again, simply select the appropriate tenant when logging in.
Networks
Here you can define the networks for the containers' network status.
First, specify whether the networks are mobile/VPN or local. This setting will later classify the Clients as “local” or “mobile/VPN.”
Once you have made your selection, click the Add button to add a new network. Enter the IP address and the subnet mask.

Edit Network Address
This information is saved by clicking the OK button and displayed in the overview. To edit the information, select the corresponding entry and click Edit. An input form with the default data will reappear. To delete an entry, select it and click Delete.

System settings (Networks)
In the lower section, you can specify trusted web servers, as well as edit and delete existing items. Specifying a trusted web server is important if you have licensed the Helpdesk Web Interface and installed it on a server other than the ACMP Server. The IP address of the ACMP Server is already entered during installation. You do not need to enter it again.
Server proxy configuration
The ACMP Server requires Internet access for some modules. If you are using a proxy to provide Internet access, you will need to make some configuration changes.
The Setup Checklist section lists all the hosts you need for the connection between the ACMP Server and the respective modules..
Check the box next to Use these proxy settings instead of the Active Update proxy settings if this applies to your work. Then select one of the available options from the drop-down menu: Do not use a proxy, Use the system's proxy settings, or Use manual proxy settings. Only if you select the last option can you specify a proxy and port in the fields below.
Enable the Use proxy authentication checkbox to enter a username and password there. Otherwise, these rows will remain grayed out. Save your changes by clicking the “Save” button in the ribbon bar.

ACMP Server proxy settings
SICS connection
After installing the AESB, you must enable the SICS (Smart Infrastructure Communication Service) connection. To do this, navigate to System > Settings > ACMP Server > SICS connection.

Establish a SICS connection
First, check the checkbox to enable the connection. Then enter the host and port, as well as the username and password for the operator. You specified the relevant operator during the AESB installation; you must enter that name here as well. Specify whether the system should attempt to establish an unencrypted connection if SSL/TLS fails. To verify your entries, you can test the connection while still in the server settings. Click the button with the same name, and the test will begin. A small window will display the result, indicating whether the connection was successful or not.
Additional connection information is listed below the SICS connection credentials. If you have not yet entered any connection details, the status will be Disconnected. Only after a successful connection is established will the status change, and the routing key and virtual router will be automatically populated. You cannot manually edit these last two fields.
Public API Access Rights
You can specify whether you want to grant SICS users access to ACMP’s public API. By default, the checkbox Grant Access is not selected. However, if you wish to grant access, enable the corresponding checkbox.
Public API Response
Here, you can specify the maximum number of elements to be returned in a public API response. If you leave the value at 0, no limit is set. The maximum number of elements to be sent in a public API response is 1,000 by default when ACMP is delivered. Define your own range of values that best suits your needs.
QR Code for App Login
In this section, you can generate a QR code to simplify login for the ACMP Mobile App. If the SICS connection is activated, a corresponding menu item in the system menu is also available for this purpose. You can also specify alternative connection information. To do so, enable the checkbox and enter the alternative hostname and SICS port. The information you provide is required to start generating the QR code.
Virtualization
Guest Settings
First, specify the criterion to be used for uniquely identifying Hyper-V and vSphere guests. You can choose between the MAC address and the computer name.
Block Lists for Computer Names
Here, you can add Clients that have either Hyper-V or vSphere installed and that should be ignored by one of the virtualization scanners. This means that no mapping between the host and the VM will take place.
Clients can be added to the block list using a dynamic filter or statically via a Query. The filter supports the wildcards * (any character sequence) and ? (one character).
If you add a computer name to the block list via a Query or manually, any existing host-VM relations will be deleted afterward. In this case, you must manually remove the client itself from the database.
The Hyper-V or vSphere server will still be entered into the database even if it is on the block list.
All clients entered into the database consume a license.
ACMP vSphere scanner
If the PowerCLI tools are not installed on your system or are not installed in the system context, follow these steps:
1. Open a CMD window with administrative privileges.
2. Enter the following Command:
powershell
3. Immediately afterward, execute the following Command, which will install the PowerCLI tools:
Install-Module -Name VMware.PowerCLI -Scope AllUsers -Force -SkipPublisherCheck -AllowClobber

CMD with the appropriate Commands
Only after you have installed the tools can you specify the Server(s) and allow ACMP to scan the virtual Clients correctly. Additionally, you must ensure that the installed vSphere PowerCLI tools are compatible with the installed vSphere Server.
Next, create a vSphere server. Proceed as follows:
First, click Add and, in the new window, enter the display name, the server (DNS or IP), as well as a username and password. You can also optionally enter a description.
Once you have entered all the values, you can click Test to verify that the specified server is reachable and that the user has sufficient permissions. If the test is successful, confirm your entries by clicking OK.
You can edit or delete existing vSphere servers using the corresponding buttons. If you have changed your configuration in any way, you can also run a connection test afterward.
After you have entered all necessary servers, you can specify below the list whether systems that are turned off should be ignored. To do this, you must enable the checkbox.
After you have entered your vSphere servers, go to Scheduled Server Tasks in the settings and configure the VMware vSphere Scanner there.

