Changes for page acmp Agent

Last modified by Sabrina V. on 2026/10/06 10:49

From version 3.1
edited by Sabrina V.
on 2026/07/27 09:12
Change comment: There is no comment for this version
To version 6.1
edited by Sabrina V.
on 2026/10/06 10:49
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -ACMP Agent
1 +acmp Agent
Content
... ... @@ -1,18 +1,18 @@
1 1  {{aagon.floatingbox/}}
2 2  
3 -The agent is deployed to the network clients directly from the ACMP Console. It is required to send Client Commands directly to a client and to maintain continuous communication between the client and the server.
3 +The agent is deployed to the network clients directly from the acmp Console. It is required to send Client Commands directly to a client and to maintain continuous communication between the client and the server.
4 4  
5 -= ACMP Kiosk =
5 += acmp Kiosk =
6 6  
7 -On this page, you can configure the ACMP Kiosk.
7 +On this page, you can configure the acmp Kiosk.
8 8  
9 -[[Settings (ACMP Kiosk)>>image:ACMP Settings.png||alt="Einstellungen: ACMP Kiosk"]]
9 +[[Settings (acmp Kiosk)>>image:ACMP Settings.png||alt="Einstellungen: ACMP Kiosk" data-cmp-info="10"]]
10 10  
11 11  In the //General// section, you specify the icon properties. You have the following three options:
12 12  
13 13  |(% style="width:253px" %)**Option**|(% style="width:1111px" %)**Description**
14 -|(% style="width:253px" %)Do not display a tray icon|(% style="width:1111px" %)As a result, your users will not see a tray icon for either the ACMP Kiosk or the Command Launcher
15 -|(% style="width:253px" %)Display ACMP Kiosk Tray Icon|(% style="width:1111px" %)This causes the ACMP Kiosk tray icon to be displayed, replacing the Command Launcher.
14 +|(% style="width:253px" %)Do not display a tray icon|(% style="width:1111px" %)As a result, your users will not see a tray icon for either the acmp Kiosk or the Command Launcher
15 +|(% style="width:253px" %)Display acmp Kiosk Tray Icon|(% style="width:1111px" %)This causes the acmp Kiosk tray icon to be displayed, replacing the Command Launcher.
16 16  
17 17  = Agent Task =
18 18  
... ... @@ -22,7 +22,7 @@
22 22  
23 23  The software scanner assists you in using [[Licence Management>>doc:ACMP.610.ACMP-Solutions.Lizenzmanagement.WebHome]].
24 24  
25 -You can specify whether the software scanner should ignore updates and system components during the scan. This will reduce the number of results accordingly. You can also specify whether to enable the search for user-specific setup and uninstallation paths. This option is disabled by default. Once activated, the uninstall string will be displayed in the [[Client Details>>doc:ACMP.610.ACMP-Solutions.Client-Management.Abfrageverwaltung.Abfragen auswerten.WebHome||anchor="HClientDetailsanzeigenlassen"]].
25 +You can specify whether the software scanner should ignore updates and system components during the scan. This will reduce the number of results accordingly. You can also specify whether to enable the search for user-specific setup and uninstallation paths. This option is disabled by default. Once activated, the uninstall string will be displayed in the [[Client Details>>doc:ACMP.610.ACMP-Solutions.Client-Management.Abfrageverwaltung.Abfragen auswerten.WebHome||anchor="HOpenandworkwithClientDetails"]].
26 26  
27 27  == **File Scanner** ==
28 28  
... ... @@ -52,12 +52,12 @@
52 52  
53 53  On this page, you first specify the agent installation and network identification account. Here, you can access existing global accounts, create new ones, or specify a specific account. To do so, enter the username and corresponding password in the appropriate fields.
54 54  
55 -[[System settings (Agent)>>image:68_System_ACMP Agent_Allgemein.png||alt="Systemeinstellungen: ACMP Agent"]]
55 +[[System settings (Agent)>>image:68_System_ACMP Agent_Allgemein.png||alt="Systemeinstellungen: ACMP Agent" data-cmp-info="10"]]
56 56  
57 57  You can specify that the system first check whether the specified account has sufficient rights for installation on all computers found on the network. To do this, select the “Check rights on target computers” checkbox.
58 58  
59 59  {{aagon.infobox}}
60 -If the ACMP Server is installed on an operating system newer than Windows Server 2003, the specified account is also used for network discovery. This account must therefore have sufficient rights for RPC and for scanning the network.
60 +If the acmp Server is installed on an operating system newer than Windows Server 2003, the specified account is also used for network discovery. This account must therefore have sufficient rights for RPC and for scanning the network.
61 61  {{/aagon.infobox}}
62 62  
63 63  
... ... @@ -64,11 +64,11 @@
64 64  
65 65  == **Agent Installation Folder** ==
66 66  
67 -Specify the storage location for the ACMP Agent files. After installation, this is also where you’ll find CommandLauncher.exe, which you can use to launch the Client Command Launcher and execute Client Commands as an alternative to the tray icon.
67 +Specify the storage location for the acmp Agent files. After installation, this is also where you’ll find CommandLauncher.exe, which you can use to launch the Client Command Launcher and execute Client Commands as an alternative to the tray icon.
68 68  
69 69  == **Client Settings** ==
70 70  
71 -To uniquely identify computers on the network, ACMP offers various options for Windows and Unix clients. Select the value that is unique on your network.
71 +To uniquely identify computers on the network, acmp offers various options for Windows and Unix clients. Select the value that is unique on your network.
72 72  
73 73  * Windows Clients:
74 74  ** Computer SID
... ... @@ -84,13 +84,11 @@
84 84  If the selected value is ambiguous, scan data from another Client will be overwritten, and your database will become corrupted.
85 85  {{/aagon.warnungsbox}}
86 86  
87 -
88 -
89 89  == **Online Status** ==
90 90  
91 -The online status feature allows you to define a time period for all client-based queries, which is displayed in the Query Management interface. Here, you can specify the number of minutes after which the client’s last contact with the ACMP Server is no longer considered online. The default value is 60 minutes. Active Clients that are displayed as online in the Query are marked with a green dot; Offline Clients are displayed with a gray icon. Manual Clients, OSC, etc., are not considered online Clients and are displayed without an icon.
89 +The online status feature allows you to define a time period for all client-based queries, which is displayed in the Query Management interface. Here, you can specify the number of minutes after which the client’s last contact with the acmp Server is no longer considered online. The default value is 60 minutes. Active Clients that are displayed as online in the Query are marked with a green dot; Offline Clients are displayed with a gray icon. Manual Clients, OSC, etc., are not considered online Clients and are displayed without an icon.
92 92  
93 -If you want to verify the Clients’ online status, you must enable the corresponding checkbox. Only then will the ACMP Agent contact the ACMP Server at the interval you specified.
91 +If you want to verify the Clients’ online status, you must enable the corresponding checkbox. Only then will the acmp Agent contact the acmp Server at the interval you specified.
94 94  
95 95  == Job Execution Mode ==
96 96  
... ... @@ -100,7 +100,7 @@
100 100  |Always|In this mode, the job always runs as soon as the start condition for that job is met. A Job Log is always generated.|A Managed Software job will not make any changes on a client if the same version of the software included in the Managed Software job is already installed. The job log created for this simply indicates that the job ran but that no changes were made.
101 101  |Only when changes are applied|With this option enabled, the job is executed, and a Job Log is created only if the job also performed an update (either for Managed Software or a Windows Update).|With this configuration, there will be no Job Log, since no “actual execution” took place—the software did not need to be updated.
102 102  
103 -[[Job Execution Mode for the Start Conditions>>image:69_Einstellungen ACMP Agent_Job-Ausführungsmodus_749.png]]
101 +[[Job Execution Mode for the Start Conditions>>image:69_Einstellungen ACMP Agent_Job-Ausführungsmodus_749.png||data-cmp-info="10"]]
104 104  
105 105  
106 106  
... ... @@ -114,13 +114,13 @@
114 114  Please note that to view the login history, you need a user who has the appropriate right. You can assign and enable this right via [[User Management>>doc:ACMP.610.ACMP-Solutions.System.Benutzerverwaltung.WebHome]] (//Rights of User// > //Client Management// > Query Management > Client Details > Open Client Details > “View Client Login History”).
115 115  {{/aagon.infobox}}
116 116  
117 -[[Required rights in user management for using the sign-in history>>image:68_Benutzerverwaltung_Rechte des Benutzers Anmeldeverlauf_988.png]]
115 +[[Required rights in user management for using the sign-in history>>image:68_Benutzerverwaltung_Rechte des Benutzers Anmeldeverlauf_988.png||data-cmp-info="10"]]
118 118  
119 119  
120 120  
121 121  == Manually Designating a Primary User ==
122 122  
123 -You can manually designate a primary user in the Client Details. To do this, you must first open a client using a Query and then [[display the Client Details>>doc:ACMP.610.ACMP-Solutions.Client-Management.Abfrageverwaltung.Abfragen auswerten.WebHome||anchor="HClientDetailsanzeigenlassen"]].
121 +You can manually designate a primary user in the Client Details. To do this, you must first open a client using a Query and then [[display the Client Details>>doc:ACMP.610.ACMP-Solutions.Client-Management.Abfrageverwaltung.Abfragen auswerten.WebHome||anchor="HOpenandworkwithClientDetails"]].
124 124  
125 125  Within the Client Details, navigate to the //Linked Contacts// entry. There, all contacts currently linked to the client are displayed. The following functions are available in the detail view of the linked contacts:
126 126  
... ... @@ -131,23 +131,21 @@
131 131  
132 132  You can now select which of the linked contacts should be the client's primary user. To do so, check the checkbox in the //Primary User// column next to the specific contact.
133 133  
134 -[[Manually Setting the Primary User in Client Details>>image:68_System_ACMP Agent_Manueller Hauptbenutzer.png||alt="Manuelle Festlegung des Hauptbenutzers in den Client Details"]]
132 +[[Manually Setting the Primary User in Client Details>>image:68_System_ACMP Agent_Manueller Hauptbenutzer.png||alt="Manuelle Festlegung des Hauptbenutzers in den Client Details" data-cmp-info="10"]]
135 135  
136 136  
137 137  
138 138  == Automatic Primary User Detection ==
139 139  
140 -With automatic primary user detection, it is possible to automatically and dynamically determine a client’s primary user based on logins to that client. To do this, there are two linked functions in the ACMP Console’s system settings—“Login History” and “Primary User”—that must be enabled for automatic primary user detection.
138 +With automatic primary user detection, it is possible to automatically and dynamically determine a client’s primary user based on logins to that client. To do this, there are two linked functions in the acmp Console’s system settings—“Login History” and “Primary User”—that must be enabled for automatic primary user detection.
141 141  
142 142  (% class="box infomessage" %)
143 143  (((
144 -[[image:https://doc.aagon.com/bin/download/XWiki/Aagon Infobox/WebHome/Information.svg||alt="Hinweis" height="32" width="32"]] **Hinweis: **
142 +[[image:https://doc.aagon.com/bin/download/XWiki/Aagon Infobox/WebHome/Information.svg||alt="Hinweis" data-cmp-info="10" height="32" width="32"]] **Hinweis: **
145 145  
146 146  Both functions are disabled by default for privacy reasons.
147 147  )))
148 148  
149 -
150 -
151 151  === Enable Login History Tracking ===
152 152  
153 153  By enabling the first function, //Scan Login History//, logins can be tracked and saved. Only “real” logins are counted - that is, Windows logins in which a full session is established. Both RDP sessions and local logins are tracked.
... ... @@ -157,19 +157,24 @@
157 157  **Example**: For example, it is not considered a login when a user logs back into the Client after the screen has been locked.
158 158  )))
159 159  
160 -After activation, you can view the client's login history in the Client Details under the //Software //> //Operating System //folder in the //Login History //entry. Please note that the data for the login history is retrieved via the System Scanner. This means that the login history can only be stored for clients that were detected via the ACMP Agent or the OneScanClient.
156 +After activation, you can view the client's login history in the Client Details under the //Software //> //Operating System //folder in the //Login History //entry. Please note that the data for the login history is retrieved via the System Scanner. This means that the login history can only be stored for clients that were detected via the acmp Agent or the OneScanClient.
161 161  
162 -[[A Client's Login Process>>image:Anmeldeverlauf_Hauptbenutzer.png||alt="Anmeldeverlauf eines Clients"]]
158 +[[A Client's Login Process>>image:Anmeldeverlauf_Hauptbenutzer.png||alt="Anmeldeverlauf eines Clients" data-cmp-info="10"]]
163 163  
164 164  For all clients that were added in other ways, a login history cannot be generated. Accordingly, the primary user must still be set manually, even if the clients are not explicitly on the blacklist. 
165 165  You can also specify in the settings how many days after they are created the recorded login histories should be deleted by a server job.
166 166  
167 167  {{aagon.infobox}}
164 +Information that has already been deleted from the login history cannot be restored or added later.
165 +
166 +Example: If data is deleted after 90 days by default and the settings are temporarily changed to 30 days, the data that has already been deleted as a result will not be restored if the 90-day retention period is subsequently reinstated.
167 +In this case, it will take up to 60 days for the data set to return to the intended retention period.
168 +{{/aagon.infobox}}
169 +
170 +{{aagon.infobox}}
168 168  If you have many clients and your system retains login histories for a long time, large amounts of data may accumulate, which can slow down your system. Therefore, you should not set the number of days before login histories are deleted to be too high.
169 169  {{/aagon.infobox}}
170 170  
171 -
172 -
173 173  === Enable Setting the Primary User ===
174 174  
175 175  The activation of the second function, //Automatically Set Primary User//, automatically designates a user as the primary user after a specified number of consecutive logins. You can set the number of consecutive logins required in the settings.
... ... @@ -184,7 +184,7 @@
184 184  Login history tracking is also activated even if the client is excluded from automatic primary user detection due to blacklisting.
185 185  {{/aagon.infobox}}
186 186  
187 -[[Enable Automatic Primary User Detection>>image:68_System_ACMP Agent_Haupbenutzer automatischen setzen.png||alt="Automatische Hauptbenutzererkennung aktivieren"]]
188 +[[Enable Automatic Primary User Detection>>image:68_System_ACMP Agent_Haupbenutzer automatischen setzen.png||alt="Automatische Hauptbenutzererkennung aktivieren" data-cmp-info="10"]]
188 188  
189 189  Once you have enabled automatic primary user detection, the //Linked Contacts// entry in the Client Details will display a banner at the bottom of the window indicating that the primary user for the selected client is set automatically. The client also detects and remembers the user type. If the user is an Active Directory user, the user’s contact is automatically listed as a linked contact and set as the primary user.
190 190  
... ... @@ -192,18 +192,16 @@
192 192  Automatic contact linking works only for AD users. Other user types are not linked.
193 193  {{/aagon.infobox}}
194 194  
195 -[[Display of the automatically linked primary user in the Client Details>>image:68_System_ACMP Agent_Hauptbenutzer_verknüpft.png||alt="Anzeige des automatisch verknüpften Hauptbenutzers in den Client Details"]]
196 +[[Display of the automatically linked primary user in the Client Details>>image:68_System_ACMP Agent_Hauptbenutzer_verknüpft.png||alt="Anzeige des automatisch verknüpften Hauptbenutzers in den Client Details" data-cmp-info="10"]]
196 196  
197 197  Once automatic primary user detection is enabled, you can no longer reset or manually change the primary user. You can still manually add new Shortcuts and delete manually added Shortcuts, provided that the linked contact is not the primary user.
198 198  
199 -
200 -
201 201  = Remote Desktop Services =
202 202  
203 203  Here you can define how data collected from Remote Desktop connections is handled.
204 204  
205 205  {{figure}}
206 -[[image:68_System_Einstellungen_RemotedesktopDienste_1327.png||alt="Remotedeskotp Dienste.PNG" data-xwiki-image-style-alignment="center"]]
205 +[[image:68_System_Einstellungen_RemotedesktopDienste_1327.png||alt="Remotedeskotp Dienste.PNG" data-cmp-info="10" data-xwiki-image-style-alignment="center"]]
207 207  
208 208  {{figureCaption}}
209 209  Remote Desktop Services settings
... ... @@ -214,11 +214,11 @@
214 214  
215 215  == **Cleaning Up Collected Data** ==
216 216  
217 -By default, data collected by the ACMP Agent via Remote Desktop connections is deleted after 180 days.
216 +By default, data collected by the acmp Agent via Remote Desktop connections is deleted after 180 days.
218 218  
219 219  == **Data Collection Methods** ==
220 220  
221 -When the ACMP Agent logs in via Remote Desktop, you can choose which method to use for data collection. You can select one of the following three options:
220 +When the acmp Agent logs in via Remote Desktop, you can choose which method to use for data collection. You can select one of the following three options:
222 222  
223 223  * Never send collected data
224 224  * Send only if the client has Remote Desktop Services installed
© Aagon GmbH 2026
Besuchen Sie unsere aagon-Community