Starting the installation of the server

1

2

1

= Starting the installation of the server =

10

11

You can install the ACMP server using an .iso file provided by Aagon. Navigate to this file in your resources directory and place the ISO in a virtual drive or unpack the ISO with e.g. 7-Zip. Then open the dvdstart.exe from the virtual drive or the unzipped directory with a double click.

12

13

14

[[image:image-2025-03-26-09-25-36-652.png||alt="63_ACMP_Installation_ACMP_Setup_754.png" data-xwiki-image-style-alignment="center"]]

ACMP Setup

Start the ACMP setup with a mouse click. A wizard will guide you through the installation step by step. First select the language in which the installation will be performed. Please note that this is only the installation language and not the language in which ACMP can be opened afterwards.

22

23

== License agreement ==

24

25

Read and accept the licence agreement for the installation of the ACMP server. If you do not accept it, the installation cannot continue and must be cancelled.

26

27

== Database installation ==

28

29

There are three options for setting up a database:

30

31

|**Type of database**|**Description**

32

|„Use existing Microsoft SQL Server: Existing database“|(((

33

If you have previously created a database on your SQL Server (e.g. using Management Studio) and want to use it, you can use this database for the ACMP installation.

34

35

36

For technical reasons, ACMP deletes all existing tables in the database during a new installation and creates the tables required for ACMP. In order to be able to use the old data again later, you must back it up before a new installation. Contact support for information on how to restore your data without risk.

37

38

)))

39

|„Use existing Microsoft SQL Server: Create new database“|With this option a new database will be created by the ACMP setup. In order for the database to be created, you must specify a user with sufficient rights. This user will also create a new database user that is specific to the ACMP, so that this user does not have broad rights, but only access to the ACMP database. To learn how to create a database correctly, see the related white paper.

40

|„Install Microsoft SQL Server 2019 express locally“|(((

41

The SQL Server is installed directly in the background by the setup, which means that subsequent configuration is not mandatory.

)))

Please note that SQL Server Express can only cover a limited number of devices. We recommend that you only install it locally if you have between 250 and a maximum of 500 devices.

When installing the database, also pay explicit attention to the sorting. The sorting of the database must match the sorting of the database instance. If the instance is, for example, ‘SQL_Latin1_General_CP1_CI_AS’, then the database cannot take on a different one. We generally recommend the ‘Latin1_General_CI_AS’ sorting.

[[image:68_ACMP Installation_Datenbank installieren_755.png||alt="63_Erstinstallation_Datenbank installieren_767.png" data-xwiki-image-style-alignment="center"]]

55

56

57

Database installation

Select the appropriate option for your environment. If the Native Client is not installed, it will be installed automatically for all options.

62

63

== Configure database ==

64

65

Enter the connection parameters for the database so that it can be successfully set up and used later.

66

67

68

[[image:68_ACMP Installation_Neue Datenbank anlegen_755.png||alt="63_Erstinstallation_Neue Datenbank anlegen_767.png" data-xwiki-image-style-alignment="center"]]

69

70

71

Create a new database

Enter the MS SQL Server (in the notation <Server>\<instance>), where you can specify the server name or IP address. If you want to find existing servers on your network, click on the [[image:image-20220819082915-1.png]]icon and load one of the existing databases into the field.

76

77

78

With version 6.8.0 an Azure database can be used for a new ACMP installation. Please note that the installation may take a few minutes.

If you are unable to connect, check that you have entered the server instance correctly.

Please note that [[multi tenancy>>doc:ACMP.67.ACMP-Solutions.System.Mandanten.WebHome||anchor="HMandantenfE4higkeit"]] is only supported by MS SQL Server 2016 SP1 or higher. If you are using a lower version (< 13.0.4001.0 (2016 SP1)), some features in ACMP will not be supported.

87

88

89

For the 'Database Server Login', enter a user who has the right to create databases and users. Define the name of the new database for ACMP under "Create new database". The "ACMP Database Login" user (here~:// ACMPDBUser//) is created on your SQL Server and configured so that it only has rights for the ACMP database. This user will then be used by the ACMP Server to connect to the SQL Server or the database.

90

91

92

If you are performing a manual SQL Server installation, you must have enabled //the Database Engine Services //instance function in the //Function Selection //menu. If you also want to use Ticket Management, you must also select //Full Text Extraction and Semantic Extraction for the search//.

[[image:63_ACMP_Installation_ACMP_SQLServer(Funktionsauswahl)_1714.png||data-xwiki-image-style-alignment="center" height="678" width="800"]]

97

98

99

Function selection during manual installation of an SQL Server

Also make sure that the correct authentication mode is selected. This can be found under //Database Engine Configuration//. Select //Mixed Mode// for the installation, which allows SQL Server and Windows authentication.

104

105

106

[[image:63_ACMP_Installation_ACMP_GemischterModus_806.png||alt="63_ACMP_Installation_ACMP_MixedMode_606.png" data-xwiki-image-style-alignment="center" height="558" width="740"]]

107

108

109

Authentication mode during server configuration

If you selected Named Instance when installing SQL Server, you must also use the specified instance name when setting up the ACMP database. If you selected Default Instance, specify only the server when setting up the ACMP database.

For technical reasons, ACMP deletes all existing tables in the database during a new installation and creates the tables required for ACMP. In order to be able to use the old data later, you must back it up before a new installation. Contact support for information on how to restore your data without risk.

119

120

121

=== Encrypted connection to SQL Server ===

122

123

You can establish an encrypted connection between the ACMP Server and the SQL Server either by using Transport Layer Security (TLS) or by creating an IPSec tunnel and routing the communication data through it. The aim is to encrypt the transport data. Read here how the two [[options>>doc:ACMP.67.ACMP installieren.ACMP Server installieren.Verbindung vom ACMP Server zum SQL Server einrichten.WebHome]] work.

124

125

== Select ACMP installation path ==

126

127

Specify the destination directory for the installation. You can enter the path manually or select it using the //Browse// button.

128

129

130

You can decide on which of your partitions you want to save the installation. The only important thing is that you have enough free space.

[[image:68_ACMP Installation_Installationspfad auswählen_755.png||alt="63_Erstinstallation_Installationspfad_776.png" data-xwiki-image-style-alignment="center"]]

135

136

137

Select ACMP installation path

== **Configure ACMP Network** ==

142

143

Specify the ports through which the ACMP clients and the ACMP server will communicate with each other. By default, the setup provides default values for the two communication ports (server port: 2106 and client port: 2108). However, these can be changed by you. If these port numbers are already being used by other programs, change the numbers so that ACMP is the only user of the ports. Also make sure that the ports for the server and the clients are different and not blocked by a firewall.

144

145

You can also create an Agent Installation and Network Discovery account that will be used to deploy the ACMP Agent to the machines on your network. The Network Discovery account is effective from a newer operating system than Windows Server 2003. It is recommended that this account has sufficient RPC and network browsing permissions.

146

147

148

The Computer Browser service must be started from an operating system >= Windows Server 2012.

[[image:68_ACMP Installation_Netzwerk einrichten_755.png||alt="63_Erstinstallation_Kommunikationspfad_766.png" data-xwiki-image-style-alignment="center"]]

153

154

155

Configure ACMP Network

== Select ACMP administrator password ==

160

161

Set a secure password for your ACMP administrator account.

162

163

164

You will need the password later to log in to the ACMP console.

[[image:68_ACMP Installation_Administratoren Passwort_755.png||alt="63_Erstinstallation_ACMP Administrator Passwort_755.png" data-xwiki-image-style-alignment="center"]]

169

170

171

Select ACMP administrator password

== OS Deployment configuration ==

176

177

To use OS Deployment in ACMP, you need a File Repository (with connection type "UNC") and a Network Boot Service.

178

You can select these two options during the initial installation, or configure them at a later time. This may be necessary, for example, if a company has multiple sites and you want to perform rollouts or install Windows at these sites.

179

180

* Create a file repository for OS Deployment: If you select this option, a network share will be created in the ACMP Server installation directory. A shared file repository with content type 'OSD' and connection type 'UNC' will also be created to store OS Deployment data.

181

* Install the Network Boot Service: The Network Boot Service is installed on the machine. This will allow you to install Clients over the network later.

182

183

184

[[image:68_ACMP Installation_OS Deployment konfigurieren_755.png||alt="63_Erstinstallation_OS Deployment Konfiguration_778.png" data-xwiki-image-style-alignment="center"]]

185

186

187

OS Deployment configuration

== Summary ==

The summary shows the most important information about the installation, which you can review at this point.

194

195

196

[[image:68_ACMP Installation_Zusammenfassung der Installation_755.png||alt="63_Erstinstallation_Zusammenfassung_780.png" data-xwiki-image-style-alignment="center"]]

197

198

199

Summary of the installation

You can also copy the information here and save it in a .txt file, for example, so that it is not lost.

205

206

207

== Installing ACMP Server and Console ==

208

209

When the installation is started, the ACMP server, the network boot service (depending on the selected settings) and the ACMP console are set up. You can follow the progress of the installation.

210

211

212

[[image:68_ACMP Installation_ACMP Installation_755.png||alt="63_Erstinstallation_Abschluss_783.png" data-xwiki-image-style-alignment="center"]]

ACMP Installation

== Finish (Completing the ACMP Setup Wizard) ==

220

221

On the last page you have the option to start the ACMP Console directly after the installation or to install the SQL Server Management Studio additionally. Click //Finish// to complete the installation.

222

223

224

[[image:68_ACMP Installation_Abschluss der ACMP Installation_755.png||alt="63_Erstinstallation_Abschluss_780.png" data-xwiki-image-style-alignment="center"]]

225

226

227

Finish of the installation

Wiki source code of ACMP Server installieren

Navigation

author	version	line-number	content
		1	{{aagon.priorisierung}}
		2	1
		3	{{/aagon.priorisierung}}
		4
		5	{{aagon.floatingbox title="Inhalt"}}
		6	{{toc numbered="true" depth="3"/}}
		7	{{/aagon.floatingbox}}
		8
		9	= Starting the installation of the server =
		10
		11	You can install the ACMP server using an .iso file provided by Aagon. Navigate to this file in your resources directory and place the ISO in a virtual drive or unpack the ISO with e.g. 7-Zip. Then open the dvdstart.exe from the virtual drive or the unzipped directory with a double click.
		12
		13	{{figure}}
		14	[[image:image-2025-03-26-09-25-36-652.png\|\|alt="63_ACMP_Installation_ACMP_Setup_754.png" data-xwiki-image-style-alignment="center"]]
		15
		16	{{figureCaption}}
		17	ACMP Setup
		18	{{/figureCaption}}
		19	{{/figure}}
		20
		21	Start the ACMP setup with a mouse click. A wizard will guide you through the installation step by step. First select the language in which the installation will be performed. Please note that this is only the installation language and not the language in which ACMP can be opened afterwards.
		22
		23	== License agreement ==
		24
		25	Read and accept the licence agreement for the installation of the ACMP server. If you do not accept it, the installation cannot continue and must be cancelled.
		26
		27	== Database installation ==
		28
		29	There are three options for setting up a database:
		30
		31	\|Type of database\|Description
		32	\|„Use existing Microsoft SQL Server: Existing database“\|(((
		33	If you have previously created a database on your SQL Server (e.g. using Management Studio) and want to use it, you can use this database for the ACMP installation.
		34
		35	{{aagon.warnungsbox}}
		36	For technical reasons, ACMP deletes all existing tables in the database during a new installation and creates the tables required for ACMP. In order to be able to use the old data again later, you must back it up before a new installation. Contact support for information on how to restore your data without risk.
		37	{{/aagon.warnungsbox}}
		38	)))
		39	\|„Use existing Microsoft SQL Server: Create new database“\|With this option a new database will be created by the ACMP setup. In order for the database to be created, you must specify a user with sufficient rights. This user will also create a new database user that is specific to the ACMP, so that this user does not have broad rights, but only access to the ACMP database. To learn how to create a database correctly, see the related white paper.
		40	\|„Install Microsoft SQL Server 2019 express locally“\|(((
		41	The SQL Server is installed directly in the background by the setup, which means that subsequent configuration is not mandatory.
		42
		43	)))
		44
		45	{{aagon.infobox}}
		46	Please note that SQL Server Express can only cover a limited number of devices. We recommend that you only install it locally if you have between 250 and a maximum of 500 devices.
		47	{{/aagon.infobox}}
		48
		49	{{aagon.infobox}}
		50	When installing the database, also pay explicit attention to the sorting. The sorting of the database must match the sorting of the database instance. If the instance is, for example, ‘SQL_Latin1_General_CP1_CI_AS’, then the database cannot take on a different one. We generally recommend the ‘Latin1_General_CI_AS’ sorting.
		51	{{/aagon.infobox}}
		52
		53	{{figure}}
		54	[[image:68_ACMP Installation_Datenbank installieren_755.png\|\|alt="63_Erstinstallation_Datenbank installieren_767.png" data-xwiki-image-style-alignment="center"]]
		55
		56	{{figureCaption}}
		57	Database installation
		58	{{/figureCaption}}
		59	{{/figure}}
		60
		61	Select the appropriate option for your environment. If the Native Client is not installed, it will be installed automatically for all options.
		62
		63	== Configure database ==
		64
		65	Enter the connection parameters for the database so that it can be successfully set up and used later.
		66
		67	{{figure}}
		68	[[image:68_ACMP Installation_Neue Datenbank anlegen_755.png\|\|alt="63_Erstinstallation_Neue Datenbank anlegen_767.png" data-xwiki-image-style-alignment="center"]]
		69
		70	{{figureCaption}}
		71	Create a new database
		72	{{/figureCaption}}
		73	{{/figure}}
		74
		75	Enter the MS SQL Server (in the notation <Server>\<instance>), where you can specify the server name or IP address. If you want to find existing servers on your network, click on the [[image:image-20220819082915-1.png]]icon and load one of the existing databases into the field.
		76
		77	{{aagon.versionierungsbox}}
		78	With version 6.8.0 an Azure database can be used for a new ACMP installation. Please note that the installation may take a few minutes.
		79	{{/aagon.versionierungsbox}}
		80
		81	{{aagon.infobox}}
		82	If you are unable to connect, check that you have entered the server instance correctly.
		83	{{/aagon.infobox}}
		84
		85	{{aagon.infobox}}
		86	Please note that [[multi tenancy>>doc:ACMP.67.ACMP-Solutions.System.Mandanten.WebHome\|\|anchor="HMandantenfE4higkeit"]] is only supported by MS SQL Server 2016 SP1 or higher. If you are using a lower version (< 13.0.4001.0 (2016 SP1)), some features in ACMP will not be supported.
		87	{{/aagon.infobox}}
		88
		89	For the 'Database Server Login', enter a user who has the right to create databases and users. Define the name of the new database for ACMP under "Create new database". The "ACMP Database Login" user (here~:// ACMPDBUser//) is created on your SQL Server and configured so that it only has rights for the ACMP database. This user will then be used by the ACMP Server to connect to the SQL Server or the database.
		90
		91	{{aagon.infobox}}
		92	If you are performing a manual SQL Server installation, you must have enabled //the Database Engine Services //instance function in the //Function Selection //menu. If you also want to use Ticket Management, you must also select //Full Text Extraction and Semantic Extraction for the search//.
		93	{{/aagon.infobox}}
		94
		95	{{figure}}
		96	[[image:63_ACMP_Installation_ACMP_SQLServer(Funktionsauswahl)_1714.png\|\|data-xwiki-image-style-alignment="center" height="678" width="800"]]
		97
		98	{{figureCaption}}
		99	Function selection during manual installation of an SQL Server
		100	{{/figureCaption}}
		101	{{/figure}}
		102
		103	Also make sure that the correct authentication mode is selected. This can be found under //Database Engine Configuration//. Select //Mixed Mode// for the installation, which allows SQL Server and Windows authentication.
		104
		105	{{figure}}
		106	[[image:63_ACMP_Installation_ACMP_GemischterModus_806.png\|\|alt="63_ACMP_Installation_ACMP_MixedMode_606.png" data-xwiki-image-style-alignment="center" height="558" width="740"]]
		107
		108	{{figureCaption}}
		109	Authentication mode during server configuration
		110	{{/figureCaption}}
		111	{{/figure}}
		112
		113	{{aagon.warnungsbox}}
		114	If you selected Named Instance when installing SQL Server, you must also use the specified instance name when setting up the ACMP database. If you selected Default Instance, specify only the server when setting up the ACMP database.
		115	{{/aagon.warnungsbox}}
		116
		117	{{aagon.warnungsbox}}
		118	For technical reasons, ACMP deletes all existing tables in the database during a new installation and creates the tables required for ACMP. In order to be able to use the old data later, you must back it up before a new installation. Contact support for information on how to restore your data without risk.
		119	{{/aagon.warnungsbox}}
		120
		121	=== Encrypted connection to SQL Server ===
		122
		123	You can establish an encrypted connection between the ACMP Server and the SQL Server either by using Transport Layer Security (TLS) or by creating an IPSec tunnel and routing the communication data through it. The aim is to encrypt the transport data. Read here how the two [[options>>doc:ACMP.67.ACMP installieren.ACMP Server installieren.Verbindung vom ACMP Server zum SQL Server einrichten.WebHome]] work.
		124
		125	== Select ACMP installation path ==
		126
		127	Specify the destination directory for the installation. You can enter the path manually or select it using the //Browse// button.
		128
		129	{{aagon.infobox}}
		130	You can decide on which of your partitions you want to save the installation. The only important thing is that you have enough free space.
		131	{{/aagon.infobox}}
		132
		133	{{figure}}
		134	[[image:68_ACMP Installation_Installationspfad auswählen_755.png\|\|alt="63_Erstinstallation_Installationspfad_776.png" data-xwiki-image-style-alignment="center"]]
		135
		136	{{figureCaption}}
		137	Select ACMP installation path
		138	{{/figureCaption}}
		139	{{/figure}}
		140
		141	== Configure ACMP Network ==
		142
		143	Specify the ports through which the ACMP clients and the ACMP server will communicate with each other. By default, the setup provides default values for the two communication ports (server port: 2106 and client port: 2108). However, these can be changed by you. If these port numbers are already being used by other programs, change the numbers so that ACMP is the only user of the ports. Also make sure that the ports for the server and the clients are different and not blocked by a firewall.
		144
		145	You can also create an Agent Installation and Network Discovery account that will be used to deploy the ACMP Agent to the machines on your network. The Network Discovery account is effective from a newer operating system than Windows Server 2003. It is recommended that this account has sufficient RPC and network browsing permissions.
		146
		147	{{aagon.infobox}}
		148	The Computer Browser service must be started from an operating system >= Windows Server 2012.
		149	{{/aagon.infobox}}
		150
		151	{{figure}}
		152	[[image:68_ACMP Installation_Netzwerk einrichten_755.png\|\|alt="63_Erstinstallation_Kommunikationspfad_766.png" data-xwiki-image-style-alignment="center"]]
		153
		154	{{figureCaption}}
		155	Configure ACMP Network
		156	{{/figureCaption}}
		157	{{/figure}}
		158
		159	== Select ACMP administrator password ==
		160
		161	Set a secure password for your ACMP administrator account.
		162
		163	{{aagon.warnungsbox}}
		164	You will need the password later to log in to the ACMP console.
		165	{{/aagon.warnungsbox}}
		166
		167	{{figure}}
		168	[[image:68_ACMP Installation_Administratoren Passwort_755.png\|\|alt="63_Erstinstallation_ACMP Administrator Passwort_755.png" data-xwiki-image-style-alignment="center"]]
		169
		170	{{figureCaption}}
		171	Select ACMP administrator password
		172	{{/figureCaption}}
		173	{{/figure}}
		174
		175	== OS Deployment configuration ==
		176
		177	To use OS Deployment in ACMP, you need a File Repository (with connection type "UNC") and a Network Boot Service.
		178	You can select these two options during the initial installation, or configure them at a later time. This may be necessary, for example, if a company has multiple sites and you want to perform rollouts or install Windows at these sites.
		179
		180	* Create a file repository for OS Deployment: If you select this option, a network share will be created in the ACMP Server installation directory. A shared file repository with content type 'OSD' and connection type 'UNC' will also be created to store OS Deployment data.
		181	* Install the Network Boot Service: The Network Boot Service is installed on the machine. This will allow you to install Clients over the network later.
		182
		183	{{figure}}
		184	[[image:68_ACMP Installation_OS Deployment konfigurieren_755.png\|\|alt="63_Erstinstallation_OS Deployment Konfiguration_778.png" data-xwiki-image-style-alignment="center"]]
		185
		186	{{figureCaption}}
		187	OS Deployment configuration
		188	{{/figureCaption}}
		189	{{/figure}}
		190
		191	== Summary ==
		192
		193	The summary shows the most important information about the installation, which you can review at this point.
		194
		195	{{figure}}
		196	[[image:68_ACMP Installation_Zusammenfassung der Installation_755.png\|\|alt="63_Erstinstallation_Zusammenfassung_780.png" data-xwiki-image-style-alignment="center"]]
		197
		198	{{figureCaption}}
		199	Summary of the installation
		200	{{/figureCaption}}
		201	{{/figure}}
		202
		203	{{aagon.infobox}}
		204	You can also copy the information here and save it in a .txt file, for example, so that it is not lost.
		205	{{/aagon.infobox}}
		206
		207	== Installing ACMP Server and Console ==
		208
		209	When the installation is started, the ACMP server, the network boot service (depending on the selected settings) and the ACMP console are set up. You can follow the progress of the installation.
		210
		211	{{figure}}
		212	[[image:68_ACMP Installation_ACMP Installation_755.png\|\|alt="63_Erstinstallation_Abschluss_783.png" data-xwiki-image-style-alignment="center"]]
		213
		214	{{figureCaption}}
		215	ACMP Installation
		216	{{/figureCaption}}
		217	{{/figure}}
		218
		219	== Finish (Completing the ACMP Setup Wizard) ==
		220
		221	On the last page you have the option to start the ACMP Console directly after the installation or to install the SQL Server Management Studio additionally. Click //Finish// to complete the installation.
		222
		223	{{figure}}
		224	[[image:68_ACMP Installation_Abschluss der ACMP Installation_755.png\|\|alt="63_Erstinstallation_Abschluss_780.png" data-xwiki-image-style-alignment="center"]]
		225
		226	{{figureCaption}}
		227	Finish of the installation
		228	{{/figureCaption}}
		229	{{/figure}}
		230
		231