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: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: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: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

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.

83

84

85

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.

86

87

88

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"]]

93

94

95

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.

100

101

102

[[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"]]

103

104

105

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.

115

116

117

=== Encrypted connection to SQL Server ===

118

119

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.

120

121

== Select ACMP installation path ==

122

123

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

124

125

126

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:63_Erstinstallation_Installationspfad_776.png||data-xwiki-image-style-alignment="center"]]

131

132

133

Select ACMP installation path

== **Configure ACMP Network** ==

138

139

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.

140

141

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.

142

143

144

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

[[image:63_Erstinstallation_Kommunikationspfad_766.png||data-xwiki-image-style-alignment="center"]]

149

150

151

Configure ACMP Network

== Select ACMP administrator password ==

156

157

Set a secure password for your ACMP administrator account.

158

159

160

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

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

165

166

167

Select ACMP administrator password

== OS Deployment configuration ==

172

173

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

174

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.

175

176

* 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.

177

* 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.

178

179

180

[[image:63_Erstinstallation_OS Deployment Konfiguration_778.png||data-xwiki-image-style-alignment="center"]]

181

182

183

OS Deployment configuration

== Summary ==

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

190

191

192

[[image:63_Erstinstallation_Zusammenfassung_780.png||data-xwiki-image-style-alignment="center"]]

193

194

195

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.

201

202

203

== Installing ACMP Server and Console ==

204

205

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.

206

207

208

[[image:63_Erstinstallation_Abschluss_783.png||data-xwiki-image-style-alignment="center"]]

ACMP Installation

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

216

217

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.

218

219

220

[[image:63_Erstinstallation_Abschluss_780.png||data-xwiki-image-style-alignment="center"]]

221

222

223

Finish of the installation

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: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: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: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.infobox}}
		78	If you are unable to connect, check that you have entered the server instance correctly.
		79	{{/aagon.infobox}}
		80
		81	{{aagon.infobox}}
		82	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.
		83	{{/aagon.infobox}}
		84
		85	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.
		86
		87	{{aagon.infobox}}
		88	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//.
		89	{{/aagon.infobox}}
		90
		91	{{figure}}
		92	[[image:63_ACMP_Installation_ACMP_SQLServer(Funktionsauswahl)_1714.png\|\|data-xwiki-image-style-alignment="center" height="678" width="800"]]
		93
		94	{{figureCaption}}
		95	Function selection during manual installation of an SQL Server
		96	{{/figureCaption}}
		97	{{/figure}}
		98
		99	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.
		100
		101	{{figure}}
		102	[[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"]]
		103
		104	{{figureCaption}}
		105	Authentication mode during server configuration
		106	{{/figureCaption}}
		107	{{/figure}}
		108
		109	{{aagon.warnungsbox}}
		110	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.
		111	{{/aagon.warnungsbox}}
		112
		113	{{aagon.warnungsbox}}
		114	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.
		115	{{/aagon.warnungsbox}}
		116
		117	=== Encrypted connection to SQL Server ===
		118
		119	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.
		120
		121	== Select ACMP installation path ==
		122
		123	Specify the destination directory for the installation. You can enter the path manually or select it using the //Browse// button.
		124
		125	{{aagon.infobox}}
		126	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.
		127	{{/aagon.infobox}}
		128
		129	{{figure}}
		130	[[image:63_Erstinstallation_Installationspfad_776.png\|\|data-xwiki-image-style-alignment="center"]]
		131
		132	{{figureCaption}}
		133	Select ACMP installation path
		134	{{/figureCaption}}
		135	{{/figure}}
		136
		137	== Configure ACMP Network ==
		138
		139	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.
		140
		141	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.
		142
		143	{{aagon.infobox}}
		144	The Computer Browser service must be started from an operating system >= Windows Server 2012.
		145	{{/aagon.infobox}}
		146
		147	{{figure}}
		148	[[image:63_Erstinstallation_Kommunikationspfad_766.png\|\|data-xwiki-image-style-alignment="center"]]
		149
		150	{{figureCaption}}
		151	Configure ACMP Network
		152	{{/figureCaption}}
		153	{{/figure}}
		154
		155	== Select ACMP administrator password ==
		156
		157	Set a secure password for your ACMP administrator account.
		158
		159	{{aagon.warnungsbox}}
		160	You will need the password later to log in to the ACMP console.
		161	{{/aagon.warnungsbox}}
		162
		163	{{figure}}
		164	[[image:63_Erstinstallation_ACMP Administrator Passwort_755.png\|\|data-xwiki-image-style-alignment="center"]]
		165
		166	{{figureCaption}}
		167	Select ACMP administrator password
		168	{{/figureCaption}}
		169	{{/figure}}
		170
		171	== OS Deployment configuration ==
		172
		173	To use OS Deployment in ACMP, you need a File Repository (with connection type "UNC") and a Network Boot Service.
		174	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.
		175
		176	* 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.
		177	* 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.
		178
		179	{{figure}}
		180	[[image:63_Erstinstallation_OS Deployment Konfiguration_778.png\|\|data-xwiki-image-style-alignment="center"]]
		181
		182	{{figureCaption}}
		183	OS Deployment configuration
		184	{{/figureCaption}}
		185	{{/figure}}
		186
		187	== Summary ==
		188
		189	The summary shows the most important information about the installation, which you can review at this point.
		190
		191	{{figure}}
		192	[[image:63_Erstinstallation_Zusammenfassung_780.png\|\|data-xwiki-image-style-alignment="center"]]
		193
		194	{{figureCaption}}
		195	Summary of the installation
		196	{{/figureCaption}}
		197	{{/figure}}
		198
		199	{{aagon.infobox}}
		200	You can also copy the information here and save it in a .txt file, for example, so that it is not lost.
		201	{{/aagon.infobox}}
		202
		203	== Installing ACMP Server and Console ==
		204
		205	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.
		206
		207	{{figure}}
		208	[[image:63_Erstinstallation_Abschluss_783.png\|\|data-xwiki-image-style-alignment="center"]]
		209
		210	{{figureCaption}}
		211	ACMP Installation
		212	{{/figureCaption}}
		213	{{/figure}}
		214
		215	== Finish (Completing the ACMP Setup Wizard) ==
		216
		217	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.
		218
		219	{{figure}}
		220	[[image:63_Erstinstallation_Abschluss_780.png\|\|data-xwiki-image-style-alignment="center"]]
		221
		222	{{figureCaption}}
		223	Finish of the installation
		224	{{/figureCaption}}
		225	{{/figure}}
		226
		227

Wiki source code of ACMP Server installieren