Changes for page Helpdesk Web Interface installieren

Summary

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

Details

Page properties

Content

...	...	@@ -1,122 +1,130 @@
1	1	{{aagon.floatingbox/}}
2	2
3	3	(% class="wikigeneratedid" %)
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.
	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	5
6		-= Installationsvoraussetzung =
	6	+= Installation requirements =
7	7
8		-Stellen Sie sicher, dass folgende Komponenten bei Ihnen installiert sind. Sollte das noch nicht der Fall sein, holen Sie dies nach.
	8	+Ensure that the following components are installed on your system. If this is not yet the case, please install them.
9	9
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.
	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	13
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.
	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	15
16		-== Installation unter Windows Server 2016, 2019 oder 2022 ==
	16	+== Installation under Windows Server 2016, 2019 or 2022 ==
17	17
18		-Beginnen Sie damit, dass Sie den Server Manager auf Ihrem System öffnen.
	18	+Start by opening Server Manager on your system.
19	19
20	20	[[Server Manager>>image:69_Helpdesk Web Interface installieren Server Manager_896.png]]
21	21
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:
	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	27
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
	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	36	|(% style="width:422px" %) |(% style="width:1270px" %)ASP.NET 4.7
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)
	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	41
42		-[[Serverrollen auswählen>>image:1695733411358-461.png]]
	42	+[[Select Server roles>>image:1695733411358-461.png]]
43	43
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.
	44	+6. Click //Continuing//.
	45	+7. On the next page, leave the features checked and then click //Install//. Only then will IIS installed.
46	46
47	47	(((
48	48
49	49
50		-= Installation des Web Interfaces =
	50	+= Installing the Web Interfaces =
51	51
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.
	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	53
54		-== Installation des Internet Information Services (IIS) ==
	54	+== Installation of Internet Information Services (IIS) ==
55	55
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		-)))
	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.
59	59
60		-= Konfigurationen in der ACMP Console =
61	61
62		-Folgen Sie den Schritten, um die Konfiguration für den Einsatz des Web Interface in der ACMP Console abzuschließen.
	59	+= Configurations in the ACMP Console =
63	63
64		-== 1. IP-Adresse als vertrauenswürdig einstufen ==
	61	+Follow the steps to complete the configuration for using the Web Interface in the ACMP Console.
	62	+)))
65	65
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.
	64	+== 1. Classify IP address as trusted ==
67	67
	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.
68	68
69		-[[IP-Adresse als vertrauenswürdigen Server eintragen>>image:69_Helpdesk Web Interface Vertrauenswürdige Webserver_746.png]]
70	70
	69	+[[Enter IP address as trusted server>>image:69_Helpdesk Web Interface Vertrauenswürdige Webserver_746.png]]
	70	+
71	71	{{aagon.warnungsbox}}
72		-Alle eingehenden Web Interface Anfragen von einem hier nicht aufgelisteten Server werden abgelehnt.
	72	+All incoming Web Interface requests from a server not listed here will be dismissed.
73	73	{{/aagon.warnungsbox}}
74	74
75		-== 2. Web Interface aktivieren ==
76	76
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.
78	78
79		-[[Web Interface aktivieren>>image:69_Helpdesk Web Interface installieren aktivieren_583.png]]
	77	+== 2. Enable Web Interface ==
80	80
81		-== 3. Zugriff auf das Web Interface ==
	79	+In the settings, open //Web Interface// > //General//. Enable the checkbox //Helpdesk Web Interface is active// and save the configuration via the ribbon bar.
82	82
83		-Es stehen Ihnen drei Möglichkeiten zur Verfügung, wie Sie auf das Web Interface zugreifen können:
84	84
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.
	82	+[[Activate Web Interface>>image:69_Helpdesk Web Interface installieren aktivieren_583.png]]
89	89
90		-= Update der Web Interfaces =
	84	+== 3. Accessing the Web Interface ==
91	91
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.
	86	+There are three ways to access the Web Interface:
93	93
94		-== Vorgehensweise für eine erneute Installation des Web Interfaces ==
	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.
95	95
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.
97	97
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.
99	99
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.
	95	+= Updating the web interfaces =
101	101
102		-[[Installationswizard des Web Interface>>image:69_ACMP Web Interface Installer_495.png]]
	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/]].
103	103
	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	+
104	104	{{aagon.infobox}}
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!
	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!
106	106	{{/aagon.infobox}}
107	107
108	108	{{aagon.infobox}}
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.
	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.
110	110	{{/aagon.infobox}}
111	111
112		-[[Werte der settings.ini>>image:69_Web Interface settings.ini_468.png]]
	120	+[[Values in settings.ini>>image:69_Web Interface settings.ini_468.png]]
113	113
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:
	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:
115	115
116	116	|Web.config (Helpdesk Web Interface)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\Helpdesk Webinterface//
117	117	|web.config (SSO)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\SSO//
118	118
119		-Prüfen Sie in beiden Dateien folgende Zeilen bzw. kontrollieren Sie, dass die Werte für die Server IP und Serverport korrekt sind:
	127	+Check the following rows in both files and ensure that the values for the server IP and server port are correct:
120	120
121	121	{{code}}
122	122	<add key="ServerIP" value="127.0.0.1" />
...	...	@@ -124,19 +124,21 @@
124	124
125	125	{{/code}}
126	126
127		-== Sonderfall in der Web.config (Helpdesk Web Interface Config-Datei) ==
128	128
129		-In der „Web.config“ (siehe oben) ist zusätzlich folgende Einstellung verfügbar:
130	130
	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	+
131	131	{{code}}
132	132	<add key="HttpsHyperlinkCustomFieldsPrefix" value="true"/> - Default: True
133	133	{{/code}}
134	134
135		-Sollte diese Zeile nicht angezeigt werden, können Sie diese unter <appSettings> einfügen.
	145	+If this row is not displayed, you can insert it under <appSettings>.
136	136
137		-[[Eingefügte Zeile>>image:69_Web Interface_Sonderfall Config Datei_758.png]]
	147	+[[Inserted row>>image:69_Web Interface_Sonderfall Config Datei_758.png]]
138	138
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:
	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:
140	140
141	141	{{code}}
142	142	CustomField Value = aagon.de
...	...	@@ -144,7 +144,7 @@
144	144
145	145	{{/code}}
146	146
147		- Im Falle von „False“ ist das Verhalten wie in älteren Versionen und der Hyperlink erweitert die aktuelle Adresse.
	157	+If “False”, the behaviour is the same as in older versions and the hyperlink advances the current address.
148	148
149	149	{{code}}
150	150	CustomField Value = aagon.de
...	...	@@ -152,8 +152,8 @@
152	152
153	153	{{/code}}
154	154
155		- Das Update ist damit durchgeführt.
	165	+The update is now complete.
156	156
157	157	{{aagon.infobox}}
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!
	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!
159	159	{{/aagon.infobox}}