Installing ACMP Gateway

The installation resource //ACMP Gateway.msi// can be found under //C:\Program Files (x86)\Aagon\ACMP Server\Installers\Gateway,// if you want to use the Gateway as a Windows service.

15

16

= Select one of two installation options =

17

18

You have 2 options for the ACMP Gateway installation, depending on the intended use:

19

20

(% style="width:1019.48px" %)

21

|=(% style="width: 504px;" %)Intended use|=(% style="width: 514px;" %)Possible installation method

22

|(% style="width:504px" %)You want to use the Gateway as a Windows service |(% style="width:514px" %)Via the MSI file

23

|(% style="width:504px" %)You already have several AESB products in use, have installed the Supervisor on a Windows machine in a DMZ and would like to use the Gateway as a microservice|(% style="width:514px" %)Via the microservice package for the AESB

24

25

Before using one of the two installation methods, you should ensure that you have two pre-configurations in both cases:

26

27

**Setting the console port**

28

29

For additional security of the gateway, you can separate the console port from the client port. To do this, go to the ACMP console via //System > Settings > ACMP Server > General//.

30

31

Under// Port settings// you can specify the port for the console.

32

33

Then restart the console so that you can enter the new port when logging in. Then select the check box //Block ACMP Console connections on the default port//. This checkbox will not be enabled until you have rebooted and entered the new ports.

34

35

36

[[image:1694079973033-940.png||data-xwiki-image-style-alignment="center"]]

37

38

39

Port settings in the ACMP Console

**Make server entries in Settings.ini**

44

45

Before or after installing setup, make sure that the ACMP agents are configured to connect to the gateway. Basically, a configuration file is used for this, in which you can enter the addresses of one or more ACMP servers.

46

47

This configuration file can be found in the installation directory of the ACMP Server via //ACMP Server > Client > Settings.ini//.

48

49

~1. Single server configuration

50

51

You can enter a single server here, but you have to make sure that

52

53

* The server name can be resolved internally to a local IP address of the ACMP server.

54

* The server name can be resolved externally to a public IP address of the gateway.

55

56

57

Note that in this case, both the ACMP server and the ACMP gateway must later use the same port assignment.

[[image:1694080751386-763.png||data-xwiki-image-style-alignment="center"]]

62

63

64

Example of a Settings.ini with a server entry

2. Configuration with two server entries (one for the ACMP Server/one for the ACMP Gateway)

69

70

As an alternative to the first version, you can also make several entries: one entry for the ACMP Server and one entry for the ACMP Gateway. The respective IP address can also be entered directly as the server name.

71

72

73

[[image:1694081233056-501.png||data-xwiki-image-style-alignment="center"]]

74

75

76

Example of a Settings.ini with two server entries

Note that the maximum number of servers under [Servers] max= corresponds to the server entries. Please also note that the count starts at 0. The number of the highest server entry is therefore specified (see example for a Settings.ini with two server entries).

82

83

84

Once you have completed these two pre-configurations, you can continue with the Gateway installation.

85

86

You can find out how to install the ACMP Gateway via the MSI [[here>>doc:ACMP.67.Use Cases.ACMP Gateway.Use Case\: ACMP Gateway über die MSI installieren.WebHome]].

87

88

You can find out how to install the ACMP Gateway via the AESB[[ here>>doc:ACMP.67.Use Cases.ACMP Gateway.Use Case\: ACMP Gateway über AESB installieren.WebHome]].

author	version	line-number	content
		1	{{aagon.priorisierung}}
		2	20
		3	{{/aagon.priorisierung}}
		4
		5	{{aagon.floatingbox/}}
		6
		7	= Installation requirements =
		8
		9	* Firewall does not block the free ports for the Gateway
		10	* AESB version 1.5 is the minimum requirement for Gateway installation via the AESB
		11	* In the DMZ, the host for the Gateway should have at least the Windows version Server 2012 R2 or Windows 8.1
		12
		13	(% class="wikigeneratedid" %)
		14	The installation resource //ACMP Gateway.msi// can be found under //C:\Program Files (x86)\Aagon\ACMP Server\Installers\Gateway,// if you want to use the Gateway as a Windows service.
		15
		16	= Select one of two installation options =
		17
		18	You have 2 options for the ACMP Gateway installation, depending on the intended use:
		19
		20	(% style="width:1019.48px" %)
		21	\|=(% style="width: 504px;" %)Intended use\|=(% style="width: 514px;" %)Possible installation method
		22	\|(% style="width:504px" %)You want to use the Gateway as a Windows service \|(% style="width:514px" %)Via the MSI file
		23	\|(% style="width:504px" %)You already have several AESB products in use, have installed the Supervisor on a Windows machine in a DMZ and would like to use the Gateway as a microservice\|(% style="width:514px" %)Via the microservice package for the AESB
		24
		25	Before using one of the two installation methods, you should ensure that you have two pre-configurations in both cases:
		26
		27	Setting the console port
		28
		29	For additional security of the gateway, you can separate the console port from the client port. To do this, go to the ACMP console via //System > Settings > ACMP Server > General//.
		30
		31	Under// Port settings// you can specify the port for the console.
		32
		33	Then restart the console so that you can enter the new port when logging in. Then select the check box //Block ACMP Console connections on the default port//. This checkbox will not be enabled until you have rebooted and entered the new ports.
		34
		35	{{figure}}
		36	[[image:1694079973033-940.png\|\|data-xwiki-image-style-alignment="center"]]
		37
		38	{{figureCaption}}
		39	Port settings in the ACMP Console
		40	{{/figureCaption}}
		41	{{/figure}}
		42
		43	Make server entries in Settings.ini
		44
		45	Before or after installing setup, make sure that the ACMP agents are configured to connect to the gateway. Basically, a configuration file is used for this, in which you can enter the addresses of one or more ACMP servers.
		46
		47	This configuration file can be found in the installation directory of the ACMP Server via //ACMP Server > Client > Settings.ini//.
		48
		49	~1. Single server configuration
		50
		51	You can enter a single server here, but you have to make sure that
		52
		53	* The server name can be resolved internally to a local IP address of the ACMP server.
		54	* The server name can be resolved externally to a public IP address of the gateway.
		55
		56	{{aagon.infobox}}
		57	Note that in this case, both the ACMP server and the ACMP gateway must later use the same port assignment.
		58	{{/aagon.infobox}}
		59
		60	{{figure}}
		61	[[image:1694080751386-763.png\|\|data-xwiki-image-style-alignment="center"]]
		62
		63	{{figureCaption}}
		64	Example of a Settings.ini with a server entry
		65	{{/figureCaption}}
		66	{{/figure}}
		67
		68	2. Configuration with two server entries (one for the ACMP Server/one for the ACMP Gateway)
		69
		70	As an alternative to the first version, you can also make several entries: one entry for the ACMP Server and one entry for the ACMP Gateway. The respective IP address can also be entered directly as the server name.
		71
		72	{{figure}}
		73	[[image:1694081233056-501.png\|\|data-xwiki-image-style-alignment="center"]]
		74
		75	{{figureCaption}}
		76	Example of a Settings.ini with two server entries
		77	{{/figureCaption}}
		78	{{/figure}}
		79
		80	{{aagon.infobox}}
		81	Note that the maximum number of servers under [Servers] max= corresponds to the server entries. Please also note that the count starts at 0. The number of the highest server entry is therefore specified (see example for a Settings.ini with two server entries).
		82	{{/aagon.infobox}}
		83
		84	Once you have completed these two pre-configurations, you can continue with the Gateway installation.
		85
		86	You can find out how to install the ACMP Gateway via the MSI [[here>>doc:ACMP.67.Use Cases.ACMP Gateway.Use Case\: ACMP Gateway über die MSI installieren.WebHome]].
		87
		88	You can find out how to install the ACMP Gateway via the AESB[[ here>>doc:ACMP.67.Use Cases.ACMP Gateway.Use Case\: ACMP Gateway über AESB installieren.WebHome]].

Wiki source code of ACMP Gateway installieren