Changes for page Helpdesk Web Interface installieren

Last modified by Sabrina V. on 2026/06/01 11:48

From 3.1 to 2.1 From 4.2 to 4.1

From version 4.1

edited by Sabrina V.
on 2025/12/16 07:17

Change comment: There is no comment for this version

To version 3.1

edited by Steffi F
on 2025/08/22 05:35

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.SV
++XWiki.SF

Content

@@ -1,159 +1,224 @@
++{{aagon.priorisierung}}
++100
++{{/aagon.priorisierung}}
++
  {{aagon.floatingbox/}}
--(% class="wikigeneratedid" %)
--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.
++= Installation requirements =
--= Installationsvoraussetzung =
++* The Internet Information Service (IIS) must be installed or be in the process of being installed.
++* The.NET Framework 4.7.1 is already installed or will be installed with the IIS.
++* Port 80 or the port set in the IIS settings must be accessible.
--Stellen Sie sicher, dass folgende Komponenten bei Ihnen installiert sind. Sollte das noch nicht der Fall sein, holen Sie dies nach.
++To be able to use the Helpdesk to its full extent, first install the IIS and the.NET Framework. After that, configurations must be made in the ACMP Console.
--* Der Internet Information Service (IIS) muss installiert sein
--* Das .NET-Framework 4.6.2 ist bereits installiert oder wird bei der Installation des Internet Information Service mit installiert
--* Der Port 80 bzw. der in den IIS-Einstellungen gesetzte Port muss erreichbar sein.
++This is how you proceed:
--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.
--== Installation unter Windows Server 2016, 2019 oder 2022 ==
++= Installation of Internet Information Services (IIS) =
--Beginnen Sie damit, dass Sie den Server Manager auf Ihrem System öffnen.
++IIS is supplied as standard from Windows XP as an additional Windows component; however, it must be installed in advance in order to use it. Since the newer Windows versions also come with newer IIS versions, this chapter explains the installation of IIS for the various Windows server versions. In each case, it is the IIS version that is provided by the corresponding Windows version by default:
--[[Server Manager>>image:69_Helpdesk Web Interface installieren Server Manager_896.png]]
++IIS 10: Windows Server 2016 / Windows Server 2019 / Windows Server 2022
--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.
--1. Wählen Sie unter //Installationstyp// die //Rollenbasierte oder featurebasierte Installation //aus.
--1. Unter //Serverauswahl //wählen Sie dann den Zielserver aus, auf dem der IIS installiert werden soll.
--1. Navigieren Sie unter //Serverrollen //anschließend zum Punkt //Webserver (IIS)//.
--1. Unter //Webserver //und //Verwaltungsprogramme //aktivieren Sie zusätzlich folgende Rollen, indem Sie einen Haken setzen:
++== Installation on Windows Server 2016 ==
--|(% style="width:422px" %)**Webserver**|(% style="width:1270px" %)**Anzuhakende Rolle**
--|(% style="width:422px" %)Allgemeine HTTP-Features|(% style="width:1270px" %)Statischer Inhalt (Installiert)
--|(% style="width:422px" %)Leistung|(% style="width:1270px" %)Komprimierung statischer Inhalte (Installiert)
--|(% style="width:422px" %)Sicherheit|(% style="width:1270px" %)Anforderungsfilterung (Installiert)
--|(% style="width:422px" %) |(% style="width:1270px" %)Windows-Authentifizierung (Installiert)
--|(% style="width:422px" %)Systemzustand und Diagnose|(% style="width:1270px" %)HTTP-Protokollierung (Installiert)
--|(% style="width:422px" %) |(% style="width:1270px" %)Anforderungsüberwachung (Installiert)
--|(% style="width:422px" %)Anwendungsentwicklung|(% style="width:1270px" %).NET-Erweiterbarkeit 4.7
--|(% style="width:422px" %) |(% style="width:1270px" %)ASP.NET 4.7
--|(% style="width:422px" %)**Verwaltungsprogramme**|(% style="width:1270px" %)
--|(% style="width:422px" %) |(% style="width:1270px" %)IIS-Verwaltungskonsole
--|(% style="width:422px" %)Kompatibilität mit der IIS6-Verwaltung|(% style="width:1270px" %)IIS6-Metakompatiblität (Installiert)
--|(% style="width:422px" %)Verwaltungsdienst (Installiert)|(% style="width:1270px" %)Verwaltungsdienst (Installiert)
++~1. Open Server Manager and go to //Manage// > //Add Roles and Features//. This opens the Add Roles and Features Wizard.
++2. Under //Installation type//, select //Role-based or feature-based installation//.
++3. Under //Server selection//, select the target server on which IIS is to be installed.
++4. Under //Server roles//, navigate to //Web Server (IIS).//
++//5. Under Web Server //and //Administration Tools,// activate the following roles by ticking the box:
--[[Serverrollen auswählen>>image:1695733411358-461.png]]
++(% style="width:666.778px" %)
++|**Web server**|**Hooking role**
++|General HTTP Features|Static content (installed)
++|Performance|Compression of static content (installed)
++|Security|Requirement filtering (installed)
++| |Windows Authentication (Installed)
++|System status and diagnostics|HTTP logging (installed)
++| |Requirements monitoring (installed)
++|Application development|.NET extensibility 4.7
++| |ASP.NET 4.7
++|**Management programmes**|
++| |IIS Management Console
++|Compatibility with IIS6 administration|IIS6 meta compatibility (installed)
++|Administrative service (installed)|Administrative service (installed)
--   6. Klicken Sie auf //Weiter//.
--   7. Belassen Sie auf der nächsten Seite die angehakten Features und klicken Sie dann auf //Installieren//. Erst dann installiert sich der IIS.
++{{figure}}
++[[image:1695733411358-461.png]]
--(((
--
++{{figureCaption}}
++Server Manager for Windows Server 2016
++{{/figureCaption}}
++{{/figure}}
--= Installation des Web Interfaces =
++6. Click //Next//.
++7. On the next page, leave the ticked features as they are and then click //Install//. Only then will IIS be installed.
--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.
++== Installation under Windows Server 2019 ==
--== Installation des Internet Information Services (IIS) ==
++~1. Open the Server Manager and go to //Manage// > //Add Roles and Features//. This opens the Add Roles and Features Wizard.
++2. Under //Installation Type//, select //Role-based or feature-based installation//.
++3. Under //Select Server//, select the target server on which IIS is to be installed.
++4. Under //Server Roles//, go to //Web Server (IIS). Under Web Server //and //Administrative Tools,// activate the following roles by checking the box:
--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
--
--)))
++(% style="width:666.778px" %)
++|**Web server**|**Hooking role**
++|General HTTP Features|Static content (installed)
++|Performance|Compression of static content (installed)
++|Security|Requirement filtering (installed)
++| |Windows Authentication (Installed)
++|System status and diagnostics|HTTP logging (installed)
++| |Requirements monitoring (installed)
++|Application development|.NET extensibility 4.7
++| |ASP.NET 4.7
++|**Management programmes**|
++| |IIS Management Console
++|Compatibility with IIS6 administration|IIS6 meta compatibility (installed)
++|Administrative service (installed)|Administrative service (installed)
--= Konfigurationen in der ACMP Console =
++{{figure}}
++[[image:Server-Manager 2022.PNG||data-xwiki-image-style-alignment="center" height="750" width="810"]]
--Folgen Sie den Schritten, um die Konfiguration für den Einsatz des Web Interface in der ACMP Console abzuschließen.
++{{figureCaption}}
++Server Manager for Windows Server 2019
++{{/figureCaption}}
++{{/figure}}
--== 1. IP-Adresse als vertrauenswürdig einstufen ==
++6. Click //Next//.
++7. On the next page, leave the ticked features as they are and then click //Install//. Only then will IIS be installed.
--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.
++== Installation under Windows Server 2022 ==
++~1. Open the Server Manager and go to //Manage// > //Add Roles and Features//. An assistant for adding roles and features will open.
++2. Under //Installation type//, select //Role-based or feature-based installation//.
++3. Under //Server selection//, select the target server on which IIS is to be installed.
++4. Under //Server Roles//, go to //Web Server (IIS). Under Web Server //and //Administration Tools,// also enable the following roles by checking the box:
--[[IP-Adresse als vertrauenswürdigen Server eintragen>>image:69_Helpdesk Web Interface Vertrauenswürdige Webserver_746.png]]
++(% style="width:666.778px" %)
++|**Web server**|**Hooking role**
++|General HTTP Features|Static content (installed)
++|Performance|Compression of static content (installed)
++|Security|Requirement filtering (installed)
++| |Windows Authentication (Installed)
++|System status and diagnostics|HTTP logging (installed)
++| |Requirements monitoring (installed)
++|Application development|.NET extensibility 4.7
++| |ASP.NET 4.7
++|**Management programmes**|
++| |IIS Management Console
++|Compatibility with IIS6 administration|IIS6 meta compatibility (installed)
++|Administrative service (installed)|Administrative service (installed)
--{{aagon.warnungsbox}}
--Alle eingehenden Web Interface Anfragen von einem hier nicht aufgelisteten Server werden abgelehnt.
--{{/aagon.warnungsbox}}
++{{figure}}
++[[image:Server-Manager 2022.PNG||data-xwiki-image-style-alignment="center" height="750" width="810"]]
--== 2. Web Interface aktivieren ==
++{{figureCaption}}
++Server Manager for Windows Server 2022
++{{/figureCaption}}
++{{/figure}}
--Ö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.
++6. Click //Next//.
++7. On the next page, leave the ticked features as they are and then click //Install//. Only then will IIS be installed.
--[[Web Interface aktivieren>>image:69_Helpdesk Web Interface installieren aktivieren_583.png]]
++= Installing the Web Interface =
--== 3. Zugriff auf das Web Interface ==
++The installation file for the web interfaces can be found under the path //%programfiles%\Aagon\ACMP Server\Clients\WebInterfaceSetup//. Execute the file WebSetups.msi to install both web interfaces 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//.
--Es stehen Ihnen drei Möglichkeiten zur Verfügung, wie Sie auf das Web Interface zugreifen können:
++= Configuration in the ACMP Console =
--|(% style="width:147px" %)**Zugriff**|(% style="width:270px" %)**Aufruf**|(% style="width:1276px" %)**Beschreibung**
--|(% 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).
--|(% 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.
--|(% 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.
++To allow any requests from the Web Interface, the IP address of the web server must be trusted. The IP address is entered in the ACMP Console.
--= Update der Web Interfaces =
++In the ACMP Console, navigate to //System > Settings > ACMP Server > Networks.// The server on which the web interface is installed and whose requests are to be allowed is specified in the area under //Trusted web servers//.
--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.
++{{aagon.infobox}}
++All incoming web interface requests from a server not listed here will be rejected!
++{{/aagon.infobox}}
--== Vorgehensweise für eine erneute Installation des Web Interfaces ==
++{{figure}}
++[[image:vertrauenswürdige webserver.png||data-xwiki-image-style-alignment="center" height="420" width="800"]]
--~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.
++{{figureCaption}}
++Enter trusted web severs
++{{/figureCaption}}
++{{/figure}}
--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.
++If the web interface is installed on the same machine as the ACMP Server, it is already entered with the address 127.0.0.1. If this is not the case, then add the IP address of the server via //Add//.
--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.
++== Activate Web Interfaces ==
--[[Installationswizard des Web Interface>>image:69_ACMP Web Interface Installer_495.png]]
++To use the web interface, it must first be activated via the ACMP Console. In the ACMP Console, go to //System > Settings > Web Interface > General settings//. Then enable the option //Helpdesk Web Interface is active.//
--{{aagon.infobox}}
--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!
--{{/aagon.infobox}}
++{{figure}}
++[[image:Web Interfaces aktivieren.png||data-xwiki-image-style-alignment="center" height="361" width="800"]]
--{{aagon.infobox}}
--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.
--{{/aagon.infobox}}
++{{figureCaption}}
++Enabling the Helpdesk Web Interface
++{{/figureCaption}}
++{{/figure}}
--[[Werte der settings.ini>>image:69_Web Interface settings.ini_468.png]]
++== Accessing Web Interface ==
--Ö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:
++To access the web interfaces, you have the following three options:
--|Web.config (Helpdesk Web Interface)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\Helpdesk Webinterface//
--|web.config (SSO)|//C:\Program Files (x86)\Aagon\ACMP Web Interfaces\SSO//
++=== Self Service ===
--Prüfen Sie in beiden Dateien folgende Zeilen bzw. kontrollieren Sie, dass die Werte für die Server IP und Serverport korrekt sind:
++The Self Service web interface allows employees to submit tickets that can be processed by Helpdesk staff. To access the Self Service web interface, a user account must be created in the ACMP Console.
--{{code}}
--<add key="ServerIP" value="127.0.0.1" />
--<add key="ServerPort" value="2106" />
++The call is made via the following link: http:~/~/[Server IP]/Self-Service/
--{{/code}}
++=== Self Service SSO ===
--== Sonderfall in der Web.config (Helpdesk Web Interface Config-Datei) ==
++You can activate a single sign-on for the Self Service web interface. To do this, the user must be logged on to an Active Directory. In addition, the AD authentication must be activated in the ACMP Console.
--In der „Web.config“ (siehe oben) ist zusätzlich folgende Einstellung verfügbar:
++The call is made via the following link: http:~/~/[Server IP]/Self-Service/SSO
--{{code}}
--<add key="HttpsHyperlinkCustomFieldsPrefix" value="true"/> - Default: True
--{{/code}}
++=== Helpdesk ===
--Sollte diese Zeile nicht angezeigt werden, können Sie diese unter <appSettings> einfügen.
++As a Helpdesk employee, you can access the tickets assigned to you via the Helpdesk Web Interface and edit them as you would in the ACMP Console.
--[[Eingefügte Zeile>>image:69_Web Interface_Sonderfall Config Datei_758.png]]
++The ACMP Helpdesk Web Interface can be accessed via the following link: http:~/~/[Server-IP]/Helpdesk/
--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:
++= Updating the Web Interfaces =
--{{code}}
--CustomField Value = aagon.de
--Webinterface CustomField Value = https://aagon.de
++After installing an ACMP Updates, it may be necessary to update the Helpdesk Web Interface. Normally, when ACMP is patched to a new version, all the solutions you have installed are patched. One exception is the Web Interface, because it is a standalone application. Therefore, if an ACMP update affects the Web Interface, it must also be updated. If the Web Interface is affected by an Update, you will be informed via the Release Notes.
--{{/code}}
++If you need to reinstall the Web Interface, please follow these steps:
-- Im Falle von „False“ ist das Verhalten wie in älteren Versionen und der Hyperlink erweitert die aktuelle Adresse.
++~1. Navigate to //%programfiles%\Aagon\ACMP Server\Clients //in the //WebInterfaceSetup// folder. Execute the //WebSetups.msi //file to install the web interfaces on the IIS.
++2. Go through the installation wizard. To install the web interfaces in the directory you have selected, select //Install//. The installation of the update will now begin.
++3. After the update, check whether the correct port and the correct IP address of the ACMP Server are entered in the configuration files:
--{{code}}
--CustomField Value = aagon.de
--Webinterface CustomField Value = https://helpdesk.example.de/Self-Service/Pages/aagon.de
++{{aagon.infobox}}
++Usually when installing or updating the web interface, the server port is not taken over if it was changed during the installation of the ACMP Server. Therefore you have to check the values in this step and change them if necessary!
++{{/aagon.infobox}}
--{{/code}}
++{{aagon.infobox}}
++If you are not sure about the server name and the server port, you can look up the values in the Settings.ini file on the ACMP network share in the //ACMP Server > Clients// directory. Otherwise you can skip tot he next step.
++{{/aagon.infobox}}
-- Das Update ist damit durchgeführt.
++{{figure}}
++[[image:settings.ini.png||data-xwiki-image-style-alignment="center"]]
++{{figureCaption}}
++Reading the values in settings.ini
++{{/figureCaption}}
++{{/figure}}
++
++Open the web interface configuration file via //C:\Program Files (x86)\Aagon\ACMP Web Interfaces\Helpdesk Webinterface\Web.config// and the second configuration file via //C:\Program Files (x86)\Aagon\ACMP Web Interfaces\SSO\web.config//.
++
++The following values may need to be changed in both files:
++
++{{figure}}
++[[image:webconfig.png||data-xwiki-image-style-alignment="center"]]
++
++{{figureCaption}}
++Customizing the values
++{{/figureCaption}}
++{{/figure}}
++
++The Update is then complete.
++
  {{aagon.infobox}}
--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!
++The settings and configurations in web.config are retained during an update. To secure all continuing individual settings of the Web Interfaces, such as customised and modified graphics or texts, you must make a backup of these and import them after the update of the Web Interfaces!
  {{/aagon.infobox}}