Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- edpweb3:faq [18.06.2026 13:56] – Jannis Baudisch
+++ edpweb3:faq [29.09.2026 18:16] (aktuell) – Florian Karlstedt
@@ Zeile 1: / Zeile 1: @@
-==== Häufige Probleme / Fragen zu edp:web3  ====
+====== Häufige Probleme und Fragen zu edp:web3 ======
-=== Kein Drag & Drop Effekt ===
+Hier sind Fehlerbilder gesammelt, die bei Installationen von **edp:**web immer wieder vorkommen. Die Ursache liegt dabei selten in **edp:**web selbst, meistens in der Umgebung davor, also im Reverse-Proxy oder in den Einstellungen des Betriebssystems. Jeder Abschnitt ist gleich aufgebaut: woran Sie das Problem erkennen, woher es kommt und wie Sie es beheben.
-Wenn der Drag & Drop Effekt nicht funktioniert, könnte es daran liegen, dass WebSockets in Reverse-Proxy nicht aktiviert sind. Um dies zu beheben, muss in der Konfiguration der Upgrade-Header gesetzt und die HTTP-Version 1.1 aktiviert werden, damit WebSocket-Verbindungen korrekt weitergeleitet werden.
+===== Drag & Drop funktioniert nicht =====
-=== Lageführung wird trotz Aktivierung in den Einstellungen nicht angezeigt ===
+Der Drag & Drop Effekt in **edp:**web funktioniert nicht.
-Beim Start von **edp:**web wird geprüft, ob die Lizenzerweiterung für die Lageführung (**edp:**command) vorhanden ist. Wenn dies nicht der Fall ist, wird innerhalb der Einstellungen von **edp:**web automatisch die Anzeige der Lageführung deaktiviert.
-D.h., wenn nach einem Neustart die Lageführung trotz Aktivierung innerhalb der Einstellungen nicht angezeigt wird, liegt dies daran, dass die entsprechende Lizenz nicht vorhanden ist.
+**Ursache**
-Sollte die Lizenz aber inklusive der Lageführung ausgestellt worden sein, so liegt die Ursache für das fehlende Erkennen der Freischaltung der Lageführung darin, dass die Ländereinstellungen des Betriebssystems für den Systembenutzer, unter dem der Dienst "edpweb" ausgeführt wird, nicht auf Deutsch stehen. In diesem Fall befolgen Sie bitte die hier verlinkte Anleitung und starten danach das Betriebssystem einmal neu.:
+Für diese Funktion braucht **edp:**web eine WebSocket-Verbindung. Ist im vorgeschalteten Reverse-Proxy die Weiterleitung von WebSockets nicht eingerichtet, kommt diese Verbindung nicht zustande.
-https://eifert-systems.de/dokuwiki2023/doku.php?id=server:haeufigefehler:laendereinstellungen
-Bitte beachten Sie hierbei auch, dass die Dienste unter dem Systembenutzer ausgeführt werden und für diesen andere Einstellungen als für das angemeldete Benutzerkonto gelten können. D.h. auch wenn alle Datumsformate in der Anzeige korrekt dargestellt werden, kann unter dem Systembenutzer eine andere Einstellung aktiv sein.
+**Lösung**
+In der Konfiguration des Reverse-Proxys den Upgrade-Header setzen und für die Weiterleitung HTTP/1.1 aktivieren. Beispiel für nginx:
-=== Taktische Zeichen werden nicht angezeigt (Fehler 404.11) ===
+<code nginx>
-Wenn der IIS als Reverse-Proxy genutzt wird, kann es vorkommen, dass URLs mit einem Pluszeichen (+) abgewiesen werden – typischerweise mit dem HTTP-Fehler 404.11. Der IIS interpretiert das Pluszeichen standardmäßig als Versuch des „Double Escaping" und blockiert die Anfrage, bevor sie an das Backend weitergeleitet wird.
+proxy_http_version 1.1;
-Das hat folgende Auswirkungen in **edp:**web: Taktische Zeichen werden nicht angezeigt.
+proxy_set_header Upgrade $http_upgrade;
-Lösung: Fügen Sie in der Datei web.config innerhalb des Bereichs <system.webServer> folgenden Block ein:
+proxy_set_header Connection "upgrade";
+</code>
+Beim IIS muss zusätzlich das Windows-Feature "WebSocket-Protokoll" installiert sein.
+===== Lageführung wird trotz Aktivierung nicht angezeigt =====
+Die Lageführung ist in den Einstellungen von **edp:**web aktiviert, wird nach einem Neustart aber nicht angezeigt.
+**Ursache**
+Beim Start prüft **edp:**web, ob die Lizenzerweiterung für die Lageführung (**edp:**command) vorhanden ist. Fehlt sie, wird die Anzeige der Lageführung in den Einstellungen automatisch deaktiviert. In den meisten Fällen fehlt also schlicht die Lizenz.
+Wurde die Lizenz nachweislich inklusive Lageführung ausgestellt, liegt es fast immer an den Ländereinstellungen. Steht der Systembenutzer, unter dem der Dienst ''edpweb'' läuft, nicht auf Deutsch, wird die Freischaltung nicht erkannt.
+**Lösung**
+Zuerst prüfen, ob die Lizenz die Lageführung enthält. Ist das der Fall, die Ländereinstellungen für den Systembenutzer nach der Anleitung [[server:haeufigefehler:laendereinstellungen|Ländereinstellungen anpassen]] auf Deutsch umstellen und danach das Betriebssystem einmal neu starten.
+> **Hinweis:** Die Dienste laufen unter dem Systembenutzer, und für den können andere Ländereinstellungen gelten als für das angemeldete Benutzerkonto. Auch wenn am Bildschirm alle Datumsformate korrekt aussehen, kann für den Dienst eine andere Einstellung aktiv sein.
+===== Taktische Zeichen werden nicht angezeigt (Fehler 404.11) =====
+Taktische Zeichen fehlen in **edp:**web, im Browser oder im IIS-Log taucht der HTTP-Fehler 404.11 auf.
+**Ursache**
+Wird der IIS als Reverse-Proxy genutzt, weist er URLs mit einem Pluszeichen (+) standardmäßig ab. Er wertet das Pluszeichen als Versuch des "Double Escaping" und blockiert die Anfrage, bevor sie an **edp:**web weitergeleitet wird. Die URLs der taktischen Zeichen enthalten solche Pluszeichen.
+**Lösung**
+In der Datei ''web.config'' innerhalb von ''<system.webServer>'' folgenden Block einfügen:
+<code xml web.config>
 <security>
-<requestFiltering allowDoubleEscaping="true" />
+  <requestFiltering allowDoubleEscaping="true" />
 </security>
+</code>
+Danach reicht der IIS die URLs unverändert an **edp:**web weiter und die taktischen Zeichen werden geladen.
+> **Hinweis:** Gibt es in der ''web.config'' bereits einen Bereich ''<security>'', nur das Attribut ''allowDoubleEscaping'' im vorhandenen ''<requestFiltering>'' ergänzen.
+===== Lange URLs werden nicht geladen (Fehler 400) =====
+Inhalte mit sehr langen URLs werden nicht angezeigt, vor allem taktische Zeichen von Sirenen oder POIs. Der Server antwortet mit Fehler 400.
+**Ursache**
-Damit reicht der IIS-Proxy die URLs unverändert an **edp:**web weiter, und taktische Zeichen werden korrekt geladen.
+Einer der Proxy-Server vor **edp:**web begrenzt die zulässige Länge der URL. Dafür kommen zwei Stellen in Frage.
-=== Lange URLs (insbesondere Taktische Zeichen von Sirenen oder POIs) werden nicht angezeigt (Fehler 400) ===
+**Lösung**
-Dies kann an einem der vor dem **edp:**web liegenden Proxy Server liegen.
-Mögliche Ursachen:
+  * **Http.sys:** Der Registrierungswert ''UrlSegmentMaxLength'' ist zu niedrig (Standard sind 260 Zeichen). Unter ''HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Parameters'' den Wert ''UrlSegmentMaxLength'' (''DWORD 32bit'') anlegen bzw. anpassen, z.B. auf ''1024''. Damit Http.sys den Wert übernimmt, den Server anschließend neu starten. Details in der [[https://learn.microsoft.com/de-de/troubleshoot/developer/webapps/iis/health-diagnostic-performance/httpsys-registry-windows|Microsoft-Dokumentation zu Http.sys]].
-  * Http.sys: Registrierungseinstellung ''UrlSegmentMaxLength'' ist zu niedrig (Standardwert ist 260 Zeichen). Hier kann es ggf. notwendig sein den Wert ''UrlSegmentMaxLength'' (''DWORD 32bit'') in ''HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Parameters'' auf bspw. ''1024'' zu setzen. Mehr Infos in der Microsoft Dokumentation: [[https://learn.microsoft.com/de-de/troubleshoot/developer/webapps/iis/health-diagnostic-performance/httpsys-registry-windows|learn.microsoft.com]]
+  * **IIS:** Ist "Request Filtering" aktiv, kann ''maxUrl'' zu kurz eingestellt sein (Standard sind 4096 Zeichen). Der Wert wird in der ''web.config'' im Element ''<requestLimits>'' innerhalb von ''<requestFiltering>'' gesetzt. Details in der [[https://learn.microsoft.com/en-us/iis/configuration/system.webserver/security/requestfiltering/requestlimits/|Microsoft-Dokumentation zu requestLimits]].
-  * IIS: Falls auf dem System "Request Filtering" aktiviert ist, kann es sein, dass hier die ''maxUrl'' zu kurz konfiguriert ist. Mehr Infos in der Microsoft Dokumentation: [[https://learn.microsoft.com/en-us/iis/configuration/system.webserver/security/requestfiltering/requestlimits/|learn.microsoft.com]]