Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- edpweb3:faq [18.11.2024 12:05] – [Kein Drag & Drop Effekt] Pascal Niklaus
+++ edpweb3:faq [29.09.2026 18:16] (aktuell) – Florian Karlstedt
@@ Zeile 1: / Zeile 1: @@
-====== Häufige Probleme / Fragen  ======
+====== 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 =====
+Der Drag & Drop Effekt in **edp:**web funktioniert nicht.
+**Ursache**
+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.
+**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:
+<code nginx>
+proxy_http_version 1.1;
+proxy_set_header Upgrade $http_upgrade;
+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" />
+</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**
+Einer der Proxy-Server vor **edp:**web begrenzt die zulässige Länge der URL. Dafür kommen zwei Stellen in Frage.
+**Lösung**
+  * **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]].
+  * **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]].