Installing an ACMP Agent

1

2

160

= Manual Agent installation via MSI =

8

9

In addition to the ACMP Console, you can also install the ACMP Agent manually using an MSI file. This is located under the following path by default and can be accessed via the directory:

10

11

|(% style="width:208px" %)**MSI.exe**|(% style="width:1636px" %)**Path**

12

|(% style="width:208px" %)ACMP Agent.msi|(% style="width:1636px" %)C:\Program Files (x86)\Aagon\ACMP Server\Clients\Client

13

14

A special feature is the ACMP Agent Installation, where you can also use the Launcher.exe instead of the ACMP Agent.msi. The Launcher.exe executes the installation automatically and obtains the parameters from the Client.ini file. Alternatively, you can also enter and execute the necessary parameters within a silent installation and let it run in the background.

15

16

17

If you decide in favour of installation via the MSI file, a wizard will guide you step by step.

18

19

== ACMP Agent Installer MSI ==

20

21

To install the agent manually on your computer, open //ACMP Agent.msi// in the folder path mentioned above. A wizard will open to assist you with the setup. Click //Next //to start the installation.

22

23

Enter the ACMP Server / Gateway details on the first page. This includes the address, the port number, the Server ID (can be called up via the Settings.ini of the Server (path of the ACMP Server)) and the path to the ACMP Server certification file. Then click on //Next//.

24

25

26

(% style="text-align:center" %)

27

[[image:66_Update Mechanismus_ACMP Agent Setup Wizard 2_495.png]]

28

29

30

ACMP Server and Gateway settings

On the next page you need to specify where you want to install the ACMP Agent. Use the radio buttons to choose between two paths and the port to use. If required, check the //Enable debug logging //and //Create a new ClientID for this Client //checkboxes and click //Next //again.

35

36

37

(% style="text-align:center" %)

38

[[image:66_Update Mechanismus_ACMP Agent Setup Wizard 3_495.png]]

39

40

41

Setting up the ACMP Agent

Optionally, enable the checkbox on the next page if you can enter the paths to your Gateway certificate files.

46

47

48

(% style="text-align:center" %)

49

[[image:66_Update Mechanismus_ACMP Agent Setup Wizard 4_495.png]]

50

51

52

Store Gateway certificates

Finish the wizard by clicking Install on the last page. The installation will start and you can check its progress in the status and loading bars. Finally, click Finish to complete the installation wizard.

57

58

59

If you cancel the installation, the wizard will inform you. The system will not be altered in this case.

60

61

62

== Parameters of the ACMP Agent Installer MSI ==

63

64

Below are some parameters you can set for the Launcher.exe if you want to run the ACMP Agent setup as a silent installation. Please note that these parameters are not sensitive.

65

66

67

The listed parameters are checked in the order they are listed here. This means that the first one found will be processed first.

68

69

70

|**Parameters**|**Description**

71

|CLIENTPORT|Enter the client port here. If you do not enter a different value, 2108 will be inserted here.

72

|DEBUGENABLED|Debugging can be enabled (1) or disabled (0). If no enter is made, it remains disabled and the value (0) is inserted.

73

|CLTDEFLOC|Specify where the default storage location of the Clients (Client Default Location) should be. With the value (0) it is C:\ACMPClient and with the value (1) %ProgramFiles(x86)%\ACMPClient. If you do not make any entries, the value (1) is used.

74

|SERVERNAME|Insert the server name of the ACMP Agent here.

75

|SERVERCERTIFICATE|Optional parameters, //Trust On First Use// is specified if nothing else is inserted.

76

|SERVERID|Enter the Server ID.

77

|SERVERPORT|Enter the server port. If you do not enter a different value, 2106 is used here.

78

|MAKENEWCLIENTID|Does not force a new Client ID with the value (0) (default value), with the value (1) a new Client ID is forced for the installation mechanism.

79

|GATEWAYCERTIFICATE|Enter your Gateway certificate.

80

|GATEWAYKEY|Enter your Gateway key.

81

|/qn|(((

82

A complete silent installation is carried out without the possibility of making changes in the UI.

83

84

85

The usual parameters of the common MSI commands are used here, which you can read about on the [[Microsoft >>https://learn.microsoft.com/de-de/windows-server/administration/windows-commands/msiexec#parameters-1]] page.

)))

Enter the parameters and then carry out the silent installation of the ACMP Agent.

Wiki source code of ACMP Agenten installieren

Navigation

author	version	line-number	content
		1	{{aagon.priorisierung}}
		2	160
		3	{{/aagon.priorisierung}}
		4
		5	{{aagon.floatingbox/}}
		6
		7	= Manual Agent installation via MSI =
		8
		9	In addition to the ACMP Console, you can also install the ACMP Agent manually using an MSI file. This is located under the following path by default and can be accessed via the directory:
		10
		11	\|(% style="width:208px" %)MSI.exe\|(% style="width:1636px" %)Path
		12	\|(% style="width:208px" %)ACMP Agent.msi\|(% style="width:1636px" %)C:\Program Files (x86)\Aagon\ACMP Server\Clients\Client
		13
		14	A special feature is the ACMP Agent Installation, where you can also use the Launcher.exe instead of the ACMP Agent.msi. The Launcher.exe executes the installation automatically and obtains the parameters from the Client.ini file. Alternatively, you can also enter and execute the necessary parameters within a silent installation and let it run in the background.
		15
		16
		17	If you decide in favour of installation via the MSI file, a wizard will guide you step by step.
		18
		19	== ACMP Agent Installer MSI ==
		20
		21	To install the agent manually on your computer, open //ACMP Agent.msi// in the folder path mentioned above. A wizard will open to assist you with the setup. Click //Next //to start the installation.
		22
		23	Enter the ACMP Server / Gateway details on the first page. This includes the address, the port number, the Server ID (can be called up via the Settings.ini of the Server (path of the ACMP Server)) and the path to the ACMP Server certification file. Then click on //Next//.
		24
		25	{{figure}}
		26	(% style="text-align:center" %)
		27	[[image:66_Update Mechanismus_ACMP Agent Setup Wizard 2_495.png]]
		28
		29	{{figureCaption}}
		30	ACMP Server and Gateway settings
		31	{{/figureCaption}}
		32	{{/figure}}
		33
		34	On the next page you need to specify where you want to install the ACMP Agent. Use the radio buttons to choose between two paths and the port to use. If required, check the //Enable debug logging //and //Create a new ClientID for this Client //checkboxes and click //Next //again.
		35
		36	{{figure}}
		37	(% style="text-align:center" %)
		38	[[image:66_Update Mechanismus_ACMP Agent Setup Wizard 3_495.png]]
		39
		40	{{figureCaption}}
		41	Setting up the ACMP Agent
		42	{{/figureCaption}}
		43	{{/figure}}
		44
		45	Optionally, enable the checkbox on the next page if you can enter the paths to your Gateway certificate files.
		46
		47	{{figure}}
		48	(% style="text-align:center" %)
		49	[[image:66_Update Mechanismus_ACMP Agent Setup Wizard 4_495.png]]
		50
		51	{{figureCaption}}
		52	Store Gateway certificates
		53	{{/figureCaption}}
		54	{{/figure}}
		55
		56	Finish the wizard by clicking Install on the last page. The installation will start and you can check its progress in the status and loading bars. Finally, click Finish to complete the installation wizard.
		57
		58	{{aagon.infobox}}
		59	If you cancel the installation, the wizard will inform you. The system will not be altered in this case.
		60	{{/aagon.infobox}}
		61
		62	== Parameters of the ACMP Agent Installer MSI ==
		63
		64	Below are some parameters you can set for the Launcher.exe if you want to run the ACMP Agent setup as a silent installation. Please note that these parameters are not sensitive.
		65
		66	{{aagon.infobox}}
		67	The listed parameters are checked in the order they are listed here. This means that the first one found will be processed first.
		68	{{/aagon.infobox}}
		69
		70	\|Parameters\|Description
		71	\|CLIENTPORT\|Enter the client port here. If you do not enter a different value, 2108 will be inserted here.
		72	\|DEBUGENABLED\|Debugging can be enabled (1) or disabled (0). If no enter is made, it remains disabled and the value (0) is inserted.
		73	\|CLTDEFLOC\|Specify where the default storage location of the Clients (Client Default Location) should be. With the value (0) it is C:\ACMPClient and with the value (1) %ProgramFiles(x86)%\ACMPClient. If you do not make any entries, the value (1) is used.
		74	\|SERVERNAME\|Insert the server name of the ACMP Agent here.
		75	\|SERVERCERTIFICATE\|Optional parameters, //Trust On First Use// is specified if nothing else is inserted.
		76	\|SERVERID\|Enter the Server ID.
		77	\|SERVERPORT\|Enter the server port. If you do not enter a different value, 2106 is used here.
		78	\|MAKENEWCLIENTID\|Does not force a new Client ID with the value (0) (default value), with the value (1) a new Client ID is forced for the installation mechanism.
		79	\|GATEWAYCERTIFICATE\|Enter your Gateway certificate.
		80	\|GATEWAYKEY\|Enter your Gateway key.
		81	\|/qn\|(((
		82	A complete silent installation is carried out without the possibility of making changes in the UI.
		83
		84	{{aagon.infobox}}
		85	The usual parameters of the common MSI commands are used here, which you can read about on the [[Microsoft >>https://learn.microsoft.com/de-de/windows-server/administration/windows-commands/msiexec#parameters-1]] page.
		86	{{/aagon.infobox}}
		87	)))
		88
		89	Enter the parameters and then carry out the silent installation of the ACMP Agent.