Zuletzt geändert von Sabrina V. am 2025/11/11 13:24
Zeige letzte Bearbeiter
1 {{aagon.floatingbox/}}
2
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.
5
6 = Installationsvoraussetzung =
7
8 Stellen Sie sicher, dass folgende Komponenten bei Ihnen installiert sind. Sollte das noch nicht der Fall sein, holen Sie dies nach.
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.
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.
15
16 == Installation unter Windows Server 2016, 2019 oder 2022 ==
17
18 Beginnen Sie damit, dass Sie den Server Manager auf Ihrem System öffnen.
19
20 [[Server Manager>>image:69_Helpdesk Web Interface installieren Server Manager_896.png]]
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:
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
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)
41
42 [[Serverrollen auswählen>>image:1695733411358-461.png]]
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.
46
47 (((
48
49
50 = Installation des Web Interfaces =
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.
53
54 == Installation des Internet Information Services (IIS) ==
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 )))
59
60 = Konfigurationen in der ACMP Console =
61
62 Folgen Sie den Schritten, um die Konfiguration für den Einsatz des Web Interface in der ACMP Console abzuschließen.
63
64 == 1. IP-Adresse als vertrauenswürdig einstufen ==
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.
67
68
69 [[IP-Adresse als vertrauenswürdigen Server eintragen>>image:69_Helpdesk Web Interface Vertrauenswürdige Webserver_746.png]]
70
71 {{aagon.warnungsbox}}
72 Alle eingehenden Web Interface Anfragen von einem hier nicht aufgelisteten Server werden abgelehnt.
73 {{/aagon.warnungsbox}}
74
75 == 2. Web Interface aktivieren ==
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
79 [[Web Interface aktivieren>>image:69_Helpdesk Web Interface installieren aktivieren_583.png]]
80
81 == 3. Zugriff auf das Web Interface ==
82
83 Es stehen Ihnen drei Möglichkeiten zur Verfügung, wie Sie auf das Web Interface zugreifen können:
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.
89
90 = Update der Web Interfaces =
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.
93
94 == Vorgehensweise für eine erneute Installation des Web Interfaces ==
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
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
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.
101
102 [[Installationswizard des Web Interface>>image:69_ACMP Web Interface Installer_495.png]]
103
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!
106 {{/aagon.infobox}}
107
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.
110 {{/aagon.infobox}}
111
112 [[Werte der settings.ini>>image:69_Web Interface settings.ini_468.png]]
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:
115
116 |Web.config (Helpdesk Web Interface)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\Helpdesk Webinterface//
117 |web.config (SSO)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\SSO//
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:
120
121 {{code}}
122 <add key="ServerIP" value="127.0.0.1" />
123 <add key="ServerPort" value="2106" />
124
125 {{/code}}
126
127 == Sonderfall in der Web.config (Helpdesk Web Interface Config-Datei) ==
128
129 In der „Web.config“ (siehe oben) ist zusätzlich folgende Einstellung verfügbar:
130
131 {{code}}
132 <add key="HttpsHyperlinkCustomFieldsPrefix" value="true"/> - Default: True
133 {{/code}}
134
135 Sollte diese Zeile nicht angezeigt werden, können Sie diese unter <appSettings> einfügen.
136
137 [[Eingefügte Zeile>>image:69_Web Interface_Sonderfall Config Datei_758.png]]
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:
140
141 {{code}}
142 CustomField Value = aagon.de
143 Webinterface CustomField Value = https://aagon.de
144
145 {{/code}}
146
147 Im Falle von „False“ ist das Verhalten wie in älteren Versionen und der Hyperlink erweitert die aktuelle Adresse.
148
149 {{code}}
150 CustomField Value = aagon.de
151 Webinterface CustomField Value = https://helpdesk.example.de/Self-Service/Pages/aagon.de
152
153 {{/code}}
154
155 Das Update ist damit durchgeführt.
156
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!
159 {{/aagon.infobox}}
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community