Wiki source code of Agenteninstallation

Last modified by Sabrina V. on 2026/07/29 12:53
Show last authors
1 {{aagon.floatingbox/}}
2
3 {{aagon.infobox}}
4 See the chapter[[ Installing ACMP Agents>>doc:ACMP.610.ACMP installieren.ACMP Agenten installieren.WebHome]] for instructions on how to perform a manual installation using the MSI file.
5 {{/aagon.infobox}}
6
7
8 (% class="wikigeneratedid" id="HUmdenACMPAgenteninIhremNetzwerkzuinstallieren2CkF6nnenSieentwederA0ausderConsoleA0herausdieInstallationanstossenoderdieseA0FCberdasNetzwerkA0initiieren." %)
9 To install the ACMP Agent on your network, you can either start the installation from the console or initiate it over the network.
10
11 ====== ======
12
13 = Installation via the console =
14
15 Open the Agent Installation in Client Management. Here, all domains and workgroups, along with the machines they contain, are displayed. The legend on the right explains the different icons.
16
17 |(((
18 [[image:XWiki.Images.WebHome@client_pushpossible.png||alt="Client_PushPossible" data-xwiki-image-style-alignment="center" height="32" width="32"]]
19 )))|(((
20 The ACMP Agent can be installed on this machine.
21 )))
22 |(((
23 [[image:XWiki.Images.WebHome@norights.png||alt="NoRights" data-xwiki-image-style-alignment="center" height="32" width="32"]]
24 )))|(((
25 It has not yet been verified whether the ACMP Agent can be installed on this machine.
26 )))
27 |(((
28 [[image:XWiki.Images.WebHome@client_pushnotpossible.png||alt="Client_PushNotPossible" data-xwiki-image-style-alignment="center" height="32" width="32"]]
29 )))|(((
30 The ACMP Agent cannot be installed on this machine.
31 )))
32 |(((
33 [[image:XWiki.Images.WebHome@client_installing.png||alt="Client_Installing" data-xwiki-image-style-alignment="center" height="32" width="32"]]
34 )))|(((
35 Installation is possible, but has not yet been carried out.
36 )))
37 |(((
38 [[image:XWiki.Images.WebHome@install.png||alt="Client_Progress_Check" data-xwiki-image-style-alignment="center" height="32" width="32"]]
39 )))|(((
40 The ACMP Agent is currently being installed.
41 )))
42 |(((
43 [[image:XWiki.Aagon Versionierungsbox.WebHome@Client_WaitForData.ico||alt="Client_WaitForData" data-xwiki-image-style-alignment="center" height="32" width="32"]]
44 )))|(((
45 The ACMP Console is currently waiting for data from the machine.
46 )))
47 |(((
48 [[image:XWiki.Images.WebHome@clientinstallation_failed.png||alt="ClientInstallation_Failed" data-xwiki-image-style-alignment="center" height="32" width="32"]]
49 )))|(((
50 The installation could not be finished successfully.
51 )))
52
53 {{aagon.infobox}}
54 If the ACMP Server is running on Windows Server 2012, please make sure that the “Computer Browser” service is running. Also, be sure to specify a user under //System //> //Settings //> //Agent Settings// who has the right to scan the network.
55 {{/aagon.infobox}}
56
57 This page is divided into three tabs. The [[Network>>doc:.Netzwerk.WebHome]] tab allows you to install the ACMP Agent. This tab is displayed by default. The second tab, [[Installation Rules>>doc:.Installationsregeln.WebHome]], allows you to add custom installation rules. On the third tab, [[Configuration>>doc:.Konfiguration.WebHome]], you can define custom scan sources.
58
59 = Installation via network =
60
61 Access the ACMP network share via the network environment where the ACMP Server is installed. There you will find a subdirectory named “Client.” In this subdirectory, you will find the file “Launcher.exe,” which you can simply run to install the client. This process can be executed, for example, using a login script.
62
63
64 [[image:XWiki.Images.WebHome@hmfile_hash_397bfc4c.png||alt="Client per Netzwerk installieren" data-xwiki-image-style-alignment="center" height="194" width="820"]]
65
66 = Manual Agent Installation via Launcher.exe =
67
68 You can execute Launcher.exe in the “C:\Program Files (x86)\Aagon\ACMP Server\Clients\Client” directory or the corresponding network share to start the installation.
69 No additional information is required, as all settings are automatically retrieved from the Settings.ini file (C:\Program Files (x86)\Aagon\ACMP Server\Clients\).
70
71 **Note regarding missing administrator rights:**
72
73 If you do not have administrator rights to execute the agent installation, Launcher.exe will contact the Server and initiate a server-side push process, provided this has been configured accordingly.
74
75 **Note for installation outside the internal company network on agents that are to connect via the ACMP Gateway:**
76
77 The shared directory can be copied to a USB drive, as long as the settings.ini file is present alongside the client directory. Launcher.exe can be executed as usual in this manner. If there is a ZIP file within the Launcher.exe directory that has the same name as the machine on which Launcher.exe is to be executed, the existing gateway certificate will also be installed on that machine. Make sure that a certificate has already been created for the machine in advance.
78
79 == Customize the Launcher.exe parameters ==
80
81 Below is a list of some parameters that you can customize for Launcher.exe. Unless the parameter explicitly states that it launches the installation mechanism, the program should execute only that specific command. Note that the parameters are not case-sensitive.
82
83 {{aagon.infobox}}
84 The parameters listed are checked in the order shown here. This means that the first parameter found is processed first. The /MAKENEWCLIENTID parameter is an exception, as the check continues after it because it merely sets a flag.
85 {{/aagon.infobox}}
86
87 |**Parameter**|**Description**
88 |/MAKENEWCLIENTID|(((
89 Sets the flag to //Force a new ClientID// for the installation mechanism.
90
91 * Continuing checks are being performed on additional parameters.{{aagon.infobox}}This parameter is only taken into account when used with /FORCEREINSTALLATION or in connection with a complete new installation.{{/aagon.infobox}}
92 )))
93 |/RESTART|The logic from /TERMINATE (1) and the normal installation mechanism (as in (No Parameter)) (2) are invoked.
94 |/FORCEREINSTALLATION|(((
95 The logic from /TERMINATE (1) and “UnInst.exe /SILENT /VERYSILENT” (2) are executed. The normal installation process is then initiated, as in the case of (No Parameter) (3).
96
97 * The /MAKENEWCLIENTID option is taken into account.
98 )))
99 |/MARKFORPOSTDEPLOYMENT|The server request with the updated Rollout Status “Post Deployment” is sent.
100 |/PREPAREPOSTDEPLOYMENT|(((
101 The execution of the logic from /MARKFORPOSTDEPLOYMENT (1) and /RESTART (2) takes place.
102
103 * This parameter is required during the Rollout because the FirstLogonCommands are not processed sequentially.
104
105 (((
106 {{aagon.versionierungsbox}}
107 This parameter is available only in ACMP version 5.3 and later.
108 {{/aagon.versionierungsbox}}
109 )))
110 )))
111 |(No Parameter)|The standard installation process will begin.
112
113
114 **Passing Gateway Certificates via Launcher.exe**
115
116 If you want to transfer ACMP Gateway Certificates via Launcher.exe, you must place the %MACHINE_NAME%.zip file in the folder containing Launcher.exe. This file contains all the relevant files required for the ACMP Gateway. Execute Launcher.exe as an administrator.
© Aagon GmbH 2026
Besuchen Sie unsere aagon-Community