Changes for page Helpdesk Web Interface installieren

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,130 +1,122 @@
1	1	{{aagon.floatingbox/}}
2	2
3	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.
	4	+Um das Helpdesk Web Interface installieren zu können, müssen einige Vorbereitungen getroffen werden. Hierzu gehört u.a. die Erfüllung aller Installationsvoraussetzungen sowie die Komptabilität mit Ihrem System. Nachfolgend werden Sie Schritt-für-Schritt durch den Prozess geführt.
5	5
6		-= Installation requirements =
	6	+= Installationsvoraussetzung =
7	7
8		-Ensure that the following components are installed on your system. If this is not yet the case, please install them.
	8	+Stellen Sie sicher, dass folgende Komponenten bei Ihnen installiert sind. Sollte das noch nicht der Fall sein, holen Sie dies nach.
9	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.
	10	+* Der Internet Information Service (IIS) muss installiert sein
	11	+* Das .NET-Framework 4.6.2 ist bereits installiert oder wird bei der Installation des Internet Information Service mit installiert
	12	+* Der Port 80 bzw. der in den IIS-Einstellungen gesetzte Port muss erreichbar sein.
13	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.
	14	+Um das Helpdesk vollumfänglich nutzen zu können, installieren Sie vorab als erstes den IIS und das .NET-Framework. Erst danach sollten Sie die notwendigen Konfigurationen in der ACMP Console hinterlegen.
15	15
16		-== Installation under Windows Server 2016, 2019 or 2022 ==
	16	+== Installation unter Windows Server 2016, 2019 oder 2022 ==
17	17
18		-Start by opening Server Manager on your system.
	18	+Beginnen Sie damit, dass Sie den Server Manager auf Ihrem System öffnen.
19	19
20	20	[[Server Manager>>image:69_Helpdesk Web Interface installieren Server Manager_896.png]]
21	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:
	22	+1. Navigieren Sie zu //Schnellstart// > //Rollen und Features hinzufügen//. Es öffnet sich ein Assistent, in dem Sie die Rollen und Features einfügen müssen.
	23	+1. Wählen Sie unter //Installationstyp// die //Rollenbasierte oder featurebasierte Installation //aus.
	24	+1. Unter //Serverauswahl //wählen Sie dann den Zielserver aus, auf dem der IIS installiert werden soll.
	25	+1. Navigieren Sie unter //Serverrollen //anschließend zum Punkt //Webserver (IIS)//.
	26	+1. Unter //Webserver //und //Verwaltungsprogramme //aktivieren Sie zusätzlich folgende Rollen, indem Sie einen Haken setzen:
27	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
	28	+|(% style="width:422px" %)**Webserver**|(% style="width:1270px" %)**Anzuhakende Rolle**
	29	+|(% style="width:422px" %)Allgemeine HTTP-Features|(% style="width:1270px" %)Statischer Inhalt (Installiert)
	30	+|(% style="width:422px" %)Leistung|(% style="width:1270px" %)Komprimierung statischer Inhalte (Installiert)
	31	+|(% style="width:422px" %)Sicherheit|(% style="width:1270px" %)Anforderungsfilterung (Installiert)
	32	+|(% style="width:422px" %) |(% style="width:1270px" %)Windows-Authentifizierung (Installiert)
	33	+|(% style="width:422px" %)Systemzustand und Diagnose|(% style="width:1270px" %)HTTP-Protokollierung (Installiert)
	34	+|(% style="width:422px" %) |(% style="width:1270px" %)Anforderungsüberwachung (Installiert)
	35	+|(% style="width:422px" %)Anwendungsentwicklung|(% style="width:1270px" %).NET-Erweiterbarkeit 4.7
36	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)
	37	+|(% style="width:422px" %)**Verwaltungsprogramme**|(% style="width:1270px" %)
	38	+|(% style="width:422px" %) |(% style="width:1270px" %)IIS-Verwaltungskonsole
	39	+|(% style="width:422px" %)Kompatibilität mit der IIS6-Verwaltung|(% style="width:1270px" %)IIS6-Metakompatiblität (Installiert)
	40	+|(% style="width:422px" %)Verwaltungsdienst (Installiert)|(% style="width:1270px" %)Verwaltungsdienst (Installiert)
41	41
42		-[[Select Server roles>>image:1695733411358-461.png]]
	42	+[[Serverrollen auswählen>>image:1695733411358-461.png]]
43	43
44		-6. Click //Continuing//.
45		-7. On the next page, leave the features checked and then click //Install//. Only then will IIS installed.
	44	+ 6. Klicken Sie auf //Weiter//.
	45	+ 7. Belassen Sie auf der nächsten Seite die angehakten Features und klicken Sie dann auf //Installieren//. Erst dann installiert sich der IIS.
46	46
47	47	(((
48	48
49	49
50		-= Installing the Web Interfaces =
	50	+= Installation des Web Interfaces =
51	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//.
	52	+Die Installationsdatei für die Web Interfaces finden Sie unter dem Pfad %ACMPServerInstallationsverzeichnis%\//Clients\WebInterfaceSetup. //Führen Sie die Datei „WebSetups.msi“ aus, um beide Web Interfaces (Self Service und Self Service SSO) auf einem IIS zu installieren. Folgen Sie den Installationsanweisungen, um die Installation abzuschließen. Die Web Interfaces werden nun in das Verzeichnis //%programfiles%\Aagon\ACMP Web Interfaces// installiert.
53	53
54		-== Installation of Internet Information Services (IIS) ==
	54	+== Installation des Internet Information Services (IIS) ==
55	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.
	56	+Der IIS wird standardmäßig als zusätzliche Windows-Komponente mitgeliefert, muss allerdings zur Nutzung vorab installiert werden. Im folgenden Abschnitt wird daher die Installation des IIS für die folgenden Windows Server-Versionen erläutert: IIS 10: Windows Server 2016, Windows Server 2019 und Windows Server 2022
	57	+
	58	+)))
57	57
	60	+= Konfigurationen in der ACMP Console =
58	58
59		-= Configurations in the ACMP Console =
	62	+Folgen Sie den Schritten, um die Konfiguration für den Einsatz des Web Interface in der ACMP Console abzuschließen.
60	60
61		-Follow the steps to complete the configuration for using the Web Interface in the ACMP Console.
62		-)))
	64	+== 1. IP-Adresse als vertrauenswürdig einstufen ==
63	63
64		-== 1. Classify IP address as trusted ==
	66	+Navigieren Sie in der ACMP Console zu //System// > //Einstellungen// > //ACMP// //Server// > //Netzwerke//. Um jegliche Anfragen des Web Interfaces zuzulassen, müssen Sie zunächst die IP-Adresse des Webservers als vertrauenswürdig einstufen. Fügen Sie unter //Vertrauenswürdige Webserver //den Server ein, auf dem der Web Interface installiert ist und dessen Anfragen zugelassen werden sollen. Ist das Web Interface auf dem selben Computer wie der ACMP Server installiert, ist dieser schon mit der Adresse 127.0.0.1 eingetragen. Sollte das nicht der Fall sein, müssen Sie manuell die Netzwerkadresse eintragen. Klicken Sie hierfür auf //Hinzufügen //und geben Sie dort die Netzwerkadresse ein und klicken Sie anschließend auf //OK//. Die IP-Adresse erscheint nun unterhalb der vertrauenswürdigen Webserver.
65	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	67
	69	+[[IP-Adresse als vertrauenswürdigen Server eintragen>>image:69_Helpdesk Web Interface Vertrauenswürdige Webserver_746.png]]
68	68
69		-[[Enter IP address as trusted server>>image:69_Helpdesk Web Interface Vertrauenswürdige Webserver_746.png]]
70		-
71	71	{{aagon.warnungsbox}}
72		-All incoming Web Interface requests from a server not listed here will be dismissed.
	72	+Alle eingehenden Web Interface Anfragen von einem hier nicht aufgelisteten Server werden abgelehnt.
73	73	{{/aagon.warnungsbox}}
74	74
	75	+== 2. Web Interface aktivieren ==
75	75
	77	+Öffnen Sie in den Einstellungen nun //Web Interface// > //Allgemein//. Aktivieren Sie die Checkbox //Helpdesk Web Interface ist aktiv //und speichern Sie die Konfiguration über die Ribbonleiste.
76	76
77		-== 2. Enable Web Interface ==
	79	+[[Web Interface aktivieren>>image:69_Helpdesk Web Interface installieren aktivieren_583.png]]
78	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.
	81	+== 3. Zugriff auf das Web Interface ==
80	80
	83	+Es stehen Ihnen drei Möglichkeiten zur Verfügung, wie Sie auf das Web Interface zugreifen können:
81	81
82		-[[Activate Web Interface>>image:69_Helpdesk Web Interface installieren aktivieren_583.png]]
	85	+|(% style="width:147px" %)**Zugriff**|(% style="width:270px" %)**Aufruf**|(% style="width:1276px" %)**Beschreibung**
	86	+|(% style="width:147px" %)Self Service|(% style="width:270px" %)http:~/~/[Server-IP]/Self-Service/|(% style="width:1276px" %)Das Self Service Web Interface ermöglicht es Mitarbeitern Tickets zu erstellen, die dann von Helpdesk-Mitarbeitern bearbeitet werden können. Für den Zugriff auf das Self Service Web Interface muss ein Benutzeraccount in der ACMP Console angelegt werden (siehe Benutzerverwaltung).
	87	+|(% style="width:147px" %)Self Service SSO|(% style="width:270px" %)http:~/~/[Server-IP]/Self-Service/SSO|(% style="width:1276px" %)Für das Self Service Web Interface können Sie ein Single Sign-On aktivieren. Hierzu muss der Benutzer an einem [[Active Directory>>doc:ACMP.69.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HActiveDirectory"]] angemeldet sein und es muss zusätzlich die [[AD-Authentifizierung>>doc:ACMP.69.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HActiveDirectory"]] in der ACMP Console aktiviert werden.
	88	+|(% style="width:147px" %)Helpdesk|(% style="width:270px" %)http:~/~/[Server-IP]/Helpdesk/|(% style="width:1276px" %)Als Helpdesk Mitarbeiter haben Sie Zugriff auf das Helpdesk sowie auf die Ihnen zugewiesenen Tickets, die Sie ebenfalls bearbeiten können.
83	83
84		-== 3. Accessing the Web Interface ==
	90	+= Update der Web Interfaces =
85	85
86		-There are three ways to access the Web Interface:
	92	+Nach der Installation eines ACMP Updates kann es vorkommen, dass eine Aktualisierung des Web Interfaces für das Helpdesk erforderlich ist. In der Regel werden beim Patchen auf eine neue ACMP Version alle Solutions aktualisiert und hochgestuft, die Sie installiert haben. Eine Ausnahme bildet unter anderem das Web Interface, da es eine eigenständige Anwendung darstellt. Daher muss bei einem ACMP Update, welches das Web Interface mit betrifft, ebenfalls aktualisiert werden. Ob eine Aktualisierung erforderlich und notwendig ist, können Sie den jeweiligen [[Release Notes>>https://www.aagon.com/produkte/ueberblick/release-notes-acmp/]] entnehmen.
87	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.
	94	+== Vorgehensweise für eine erneute Installation des Web Interfaces ==
92	92
	96	+~1. Öffnen Sie den Windows Explorer //C:\Program Files (x86)\Aagon\ACMP Server\Clients\WebInterfaceSetup// , in der die Datei //WebSetups.msi// liegt. Führen Sie diese Datei aus, um die Web Interfaces auf dem IIS zu installieren.
93	93
	98	+2. Durchlaufen Sie den Installationswizard. Um die Web Interfaces in das von Ihnen gewählte Verzeichnis zu installieren, wählen Sie abschließend //Install //oder geben Sie einen anderen Installationspfad an. Die Installation beginnt.
94	94
95		-= Updating the web interfaces =
	100	+3. Überprüfen Sie nach nach dem Update, ob der richtige Port und die korrekte IP-Adresse vom ACMP Server in die Config.-Dateien eingetragen wurden.
96	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/]].
	102	+[[Installationswizard des Web Interface>>image:69_ACMP Web Interface Installer_495.png]]
98	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	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!
	105	+Standardmäßig wird bei einer Installation oder bei einem Update des Web Interfaces der Serverport nicht übernommen, sofern dieser bei der ACMP Server Installation geändert wurde. Deshalb müssen die Werte in diesem Schritt kontrolliert und ggf. angepasst werden!
114	114	{{/aagon.infobox}}
115	115
116	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.
	109	+Falls eine Unsicherheit hinsichtlich des Servernamens und des Serverports besteht, können Sie die [[//Werte in der Settings.ini//>>doc:ACMP.69.Arbeiten mit der ACMP Console.Globale Elemente und Funktionen.Aufbau und Konfiguration der settings\.ini.WebHome]] in der ACMP Freigabe im Ordner ACMP Server > Clients ablesen. Ansonsten können Sie den nächsten Schritt direkt durchführen.
118	118	{{/aagon.infobox}}
119	119
120		-[[Values in settings.ini>>image:69_Web Interface settings.ini_468.png]]
	112	+[[Werte der settings.ini>>image:69_Web Interface settings.ini_468.png]]
121	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:
	114	+Öffnen Sie anschließend die Config-Datei des Web Interfaces (Web.config) und des SSO (web.config). Diese sind standardmäßig über folgende Pfade erreichbar:
123	123
124	124	|Web.config (Helpdesk Web Interface)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\Helpdesk Webinterface//
125	125	|web.config (SSO)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\SSO//
126	126
127		-Check the following rows in both files and ensure that the values for the server IP and server port are correct:
	119	+Prüfen Sie in beiden Dateien folgende Zeilen bzw. kontrollieren Sie, dass die Werte für die Server IP und Serverport korrekt sind:
128	128
129	129	{{code}}
130	130	<add key="ServerIP" value="127.0.0.1" />
...	...	@@ -132,21 +132,19 @@
132	132
133	133	{{/code}}
134	134
	127	+== Sonderfall in der Web.config (Helpdesk Web Interface Config-Datei) ==
135	135
	129	+In der „Web.config“ (siehe oben) ist zusätzlich folgende Einstellung verfügbar:
136	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	141	{{code}}
142	142	<add key="HttpsHyperlinkCustomFieldsPrefix" value="true"/> - Default: True
143	143	{{/code}}
144	144
145		-If this row is not displayed, you can insert it under <appSettings>.
	135	+Sollte diese Zeile nicht angezeigt werden, können Sie diese unter <appSettings> einfügen.
146	146
147		-[[Inserted row>>image:69_Web Interface_Sonderfall Config Datei_758.png]]
	137	+[[Eingefügte Zeile>>image:69_Web Interface_Sonderfall Config Datei_758.png]]
148	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:
	139	+Ist die Option auf „True“ gesetzt, werden die Hyperlink Adressen der CustomFields des Typens //Hyperlink //die keinen HTTP oder HTTPS Präfix haben, im Web Interface automatisch mit HTTPS versehen, sodass diese aufrufbar ist:
150	150
151	151	{{code}}
152	152	CustomField Value = aagon.de
...	...	@@ -154,7 +154,7 @@
154	154
155	155	{{/code}}
156	156
157		-If “False”, the behaviour is the same as in older versions and the hyperlink advances the current address.
	147	+ Im Falle von „False“ ist das Verhalten wie in älteren Versionen und der Hyperlink erweitert die aktuelle Adresse.
158	158
159	159	{{code}}
160	160	CustomField Value = aagon.de
...	...	@@ -162,8 +162,8 @@
162	162
163	163	{{/code}}
164	164
165		-The update is now complete.
	155	+ Das Update ist damit durchgeführt.
166	166
167	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!
	158	+Die Einstellungen und Konfigurationen der web.config bleiben bei einem Update erhalten. Um alle weiteren individuellen Einstellungen des Web Interfaces, wie z.B. angepasste und veränderte Grafiken oder Texte zu sichern, müssen Sie davon ein Backup durchführen und diese nach der Aktualisierung des Web Interfaces einspielen!
169	169	{{/aagon.infobox}}