Last modified by Sabrina V. on 2025/12/16 07:47
Show last authors
1 {{aagon.floatingbox/}}
2
3 (% class="wikigeneratedid" %)
4 In order to install the Helpdesk Web Interface, some preparations must be made. This includes fulfilling all installation requirements and ensuring compatibility with your system. Below, you will be guided through the process step by step.
5
6 = Installation requirements =
7
8 Ensure that the following components are installed on your system. If this is not yet the case, please install them.
9
10 * Internet Information Service (IIS) must be installed
11 * .NET Framework 4.6.2 is already installed or will be installed when you install Internet Information Service
12 * Port 80 or the port set in the IIS settings must be accessible.
13
14 To be able to use the helpdesk to its full extent, first install IIS and the .NET Framework. Only then should you enter the necessary configurations in the ACMP Console.
15
16 == Installation under Windows Server 2016, 2019 or 2022 ==
17
18 Start by opening Server Manager on your system.
19
20 [[Server Manager>>image:69_Helpdesk Web Interface installieren Server Manager_896.png]]
21
22 1. Navigate to //Quick Launch// > //Add Roles and Features//. A wizard will open in which you must insert the roles and features.
23 1. Under //installation type//, select //Role-based or feature-based installation//.
24 1. Under //Server Selection//, select the target server on which IIS is to be installed.
25 1. Under //Server Roles//, navigate to //Web Server (IIS)//.
26 1. Under //Web Server// and //Management Tools//, enable the following roles by ticking the boxes:
27
28 |(% style="width:422px" %)**Web Server**|(% style="width:1270px" %)**Hook-on roller**
29 |(% style="width:422px" %)General HTTP features|(% style="width:1270px" %)Static content (installed)
30 |(% style="width:422px" %)Power|(% style="width:1270px" %)Compression of static content (installed)
31 |(% style="width:422px" %)Security|(% style="width:1270px" %)Requirement filtering (installed)
32 |(% style="width:422px" %) |(% style="width:1270px" %)Windows Authentication (Installed)
33 |(% style="width:422px" %)System status and diagnostics|(% style="width:1270px" %)HTTP logging (installed)
34 |(% style="width:422px" %) |(% style="width:1270px" %)Requirement monitoring (installed)
35 |(% style="width:422px" %)Application development|(% style="width:1270px" %).NET extensibility 4.7
36 |(% style="width:422px" %) |(% style="width:1270px" %)ASP.NET 4.7
37 |(% style="width:422px" %)**Administrative programmes**|(% style="width:1270px" %)
38 |(% style="width:422px" %) |(% style="width:1270px" %)IIS Management Console
39 |(% style="width:422px" %)Compatibility with IIS6 management|(% style="width:1270px" %)IIS6 meta compatibility (installed)
40 |(% style="width:422px" %)Administration service (installed)|(% style="width:1270px" %)Administration service (installed)
41
42 [[Select Server roles>>image:1695733411358-461.png]]
43
44 6. Click //Continuing//.
45 7. On the next page, leave the features checked and then click //Install//. Only then will IIS installed.
46
47 (((
48
49
50 = Installing the Web Interfaces =
51
52 The installation file for the Web Interfaces can be found at the path %ACMPServerInstallationDirectory%\//Clients\WebInterfaceSetup. //Execute the ‘WebSetups.msi’ file to install both web interfaces (Self Service and Self Service SSO) on an IIS. Follow the installation instructions to complete the installation. The Web Interfaces are now installed in the directory //%programfiles%\Aagon\ACMP Web Interfaces//.
53
54 == Installation of Internet Information Services (IIS) ==
55
56 IIS is included as an additional Windows component by default, but must be installed in advance in order to be used. The following section therefore explains the installation of IIS for the following Windows Server versions: IIS 10: Windows Server 2016, Windows Server 2019 and Windows Server 2022.
57
58
59 = Configurations in the ACMP Console =
60
61 Follow the steps to complete the configuration for using the Web Interface in the ACMP Console.
62 )))
63
64 == 1. Classify IP address as trusted ==
65
66 In the ACMP Console, navigate to //System// > //Settings// > //ACMP// //Server// > //Networks//. To allow all requests from the Web Interface, you must first classify the IP address of the web server as trusted. Under //Trusted Web Servers//, insert the server on which the Web Interface is installed and whose requests are to be allowed. If the Web Interface is installed on the same computer as the ACMP server, it is already entered with the address 127.0.0.1. If this is not the case, you must enter the network address manually. To do this, click on //Add//, enter the network address and then click on //OK//. The IP address now appears below the trusted web servers.
67
68
69 [[Enter IP address as trusted server>>image:69_Helpdesk Web Interface Vertrauenswürdige Webserver_746.png]]
70
71 {{aagon.warnungsbox}}
72 All incoming Web Interface requests from a server not listed here will be dismissed.
73 {{/aagon.warnungsbox}}
74
75
76
77 == 2. Enable Web Interface ==
78
79 In the settings, open //Web Interface// > //General//. Enable the checkbox //Helpdesk Web Interface is active// and save the configuration via the ribbon bar.
80
81
82 [[Activate Web Interface>>image:69_Helpdesk Web Interface installieren aktivieren_583.png]]
83
84 == 3. Accessing the Web Interface ==
85
86 There are three ways to access the Web Interface:
87
88 |(% style="width:147px" %)**Access**|(% style="width:270px" %)**Call**|(% style="width:1276px" %)**Description**
89 |(% style="width:147px" %)Self Service|(% style="width:270px" %)http:~/~/[Server-IP]/Self-Service/|(% style="width:1276px" %)The Self Service Web Interface enables employees to create tickets, which can then be edited by helpdesk staff. To access the Self Service Web Interface, a user account must be created in the ACMP Console (see User Management).
90 |(% style="width:147px" %)Self Service SSO|(% style="width:270px" %)http:~/~/[Server-IP]/Self-Service/SSO|(% style="width:1276px" %)You can enable Single Sign-On for the Self Service Web Interface. To do this, the user must be logged on to an [[Active Directory>>doc:ACMP.69.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HActiveDirectory"]] and [[AD authentication>>doc:ACMP.69.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HActiveDirectory"]] must also be activated in the ACMP Console.
91 |(% style="width:147px" %)Helpdesk|(% style="width:270px" %)http:~/~/[Server-IP]/Helpdesk/|(% style="width:1276px" %)As a helpdesk employee, you have access to the helpdesk and to the tickets assigned to you, which you can also edit.
92
93
94
95 = Updating the web interfaces =
96
97 After installing an ACMP update, it may be necessary to update the web interface for the helpdesk. When patching to a new ACMP version, all solutions that you have installed are usually updated and upgraded. One exception is the web interface, as it is a standalone application. Therefore, if an ACMP update affects the web interface, it must also be updated. You can find out whether an update is required and necessary in the respective [[Release Notes>>https://www.aagon.com/produkte/ueberblick/release-notes-acmp/]].
98
99
100
101 == Procedure for reinstalling the Web Interface ==
102
103 ~1. Open Windows Explorer //C:\Program Files (x86)\Aagon\ACMP Server\Clients\WebInterfaceSetup// , where the file //WebSetups.msi// is located. Execute this file to install the Web Interfaces on the IIS.
104
105 2. Run through the installation wizard. To install the web interfaces in the directory you have selected, select //Install //or specify a different installation path. The installation will begin.
106
107 3. After the update, check that the correct port and IP address have been entered in the configuration files by the ACMP Server.
108
109
110 [[Web Interface Installation Wizard>>image:69_ACMP Web Interface Installer_495.png]]
111
112 {{aagon.infobox}}
113 By default, the server port is not transferred during installation or when updating the web interface if it was changed during the ACMP server installation. Therefore, the values must be checked in this step and customized if necessary!
114 {{/aagon.infobox}}
115
116 {{aagon.infobox}}
117 If you are unsure about the Server name and Server port, you can find the [[value in settings.ini>>doc:ACMP.69.Arbeiten mit der ACMP Console.Globale Elemente und Funktionen.Aufbau und Konfiguration der settings\.ini.WebHome]] in the ACMP network share in the ACMP Server > Clients folder. Otherwise, you can proceed directly to the next step.
118 {{/aagon.infobox}}
119
120 [[Values in settings.ini>>image:69_Web Interface settings.ini_468.png]]
121
122 Then open the configuration file for the web interface (web.config) and the SSO (web.config). By default, these can be accessed via the following paths:
123
124 |Web.config (Helpdesk Web Interface)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\Helpdesk Webinterface//
125 |web.config (SSO)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\SSO//
126
127 Check the following rows in both files and ensure that the values for the server IP and server port are correct:
128
129 {{code}}
130 <add key="ServerIP" value="127.0.0.1" />
131 <add key="ServerPort" value="2106" />
132
133 {{/code}}
134
135
136
137 == Special case in web.config (helpdesk web interface configuration file) ==
138
139 The following additional setting is available in web.config (see above):
140
141 {{code}}
142 <add key="HttpsHyperlinkCustomFieldsPrefix" value="true"/> - Default: True
143 {{/code}}
144
145 If this row is not displayed, you can insert it under <appSettings>.
146
147 [[Inserted row>>image:69_Web Interface_Sonderfall Config Datei_758.png]]
148
149 If the option is set to ‘True’, the hyperlink addresses of the CustomFields of the type //Hyperlink// that do not have an HTTP or HTTPS prefix are automatically assigned HTTPS in the Web Interface so that they can be accessed:
150
151 {{code}}
152 CustomField Value = aagon.de
153 Webinterface CustomField Value = https://aagon.de
154
155 {{/code}}
156
157 If “False”, the behaviour is the same as in older versions and the hyperlink advances the current address.
158
159 {{code}}
160 CustomField Value = aagon.de
161 Webinterface CustomField Value = https://helpdesk.example.de/Self-Service/Pages/aagon.de
162
163 {{/code}}
164
165 The update is now complete.
166
167 {{aagon.infobox}}
168 The settings and configurations in web.config are retained during an update. To save all continuing individual settings of the Web Interface, such as customised and modified graphics or texts, you must create a backup and import it after updating the Web Interface!
169 {{/aagon.infobox}}
© Aagon GmbH 2026
Besuchen Sie unsere Aagon-Community