Fehlerbehebung bei der Mediensynchronisierung
Diese Seite richtet sich an Administratoren und technisches Personal für Portalserver, Bereitstellung und Netzwerk. Einrichtung und tägliche Verwendung: Automatische Mediensynchronisierung.
Mit dem Business-Central-Log beginnen
Öffnen Sie Business Portals - Log im ausführenden Unternehmen, filtern Sie Source nach Portal media synchronization und lesen Sie Einzelmeldungen sowie Zusammenfassung. Notieren Sie Zeitpunkt, Ziel-URL oder Portalreferenz, Vorgang und HTTP-Status. Vergleichen Sie dies mit dem Serverlog (Hostingprotokolle können UTC verwenden). Der Jobwarteschlangenverlauf kann Success zeigen, obwohl ein Portal fehlschlug.
Fügen Sie Media Sync keys, verschlüsselte Konfigurationswerte, Signaturen oder vollständige Konfigurationsdateien niemals Supporttickets hinzu.
Portal konfigurieren
Der Endpunkt ist <portal-base>/MediaSync.ashx. Stellen Sie Handler und Bibliothek gemeinsam mit der kompatiblen Business-Central-Erweiterung bereit. Installieren Sie den kopierten Schlüssel als MediaSyncKey in der aktiven Konfigurationsdatei:
| Portalversion | Aktive Datei |
|---|---|
| Version 2.7.x.x und höher | Auth.config |
| Ältere Konfiguration | CustomSettings.config |
Aufgelistete Portale prüfen PortalReference gegen den Portaldatensatz. Der ausgewählte Setup-Endpoint verwendet eigenständige Authentifizierung und benötigt keine zusätzliche Referenz. Verwaltete Portale erhalten Schlüsselupdates über die Veröffentlichungsverbindung; selbst gehostete Portale benötigen eine manuelle Installation. Update Media Sync Key on Portals wiederholt fehlgeschlagene verwaltete Updates.
Warning
ENC:v1-Werte sind vom Portal entschlüsselbar und müssen wie Zugangsdaten geschützt werden. Veröffentlichen Sie sie nicht in browserseitigen Einstellungen oder Logs.
Häufige Meldungen und HTTP-Antworten
| Meldung/Status | Prüfung und nächste Schritte |
|---|---|
| Keine Portale aktualisiert/unterstützt/fehlgeschlagen | URLs in der Portalliste und URL des ausgewählten Setup-Endpoints prüfen. |
| Invalid URL | Basisadresse ohne Seitenname, Zugangsdaten, Query, Fragment, Satzzeichen oder Leerzeichen verwenden. Standard ist HTTPS. |
| Transportfehler | Allow HttpClient Requests, DNS, Firewall, Zertifikatsvertrauen und Erreichbarkeit vom Business-Central-Server prüfen. Browserzugriff vom PC genügt nicht. |
| HTTP 400 | Vorgang und Portalmeldung prüfen. HTTP wird abgelehnt, sofern Allow HTTP Media Sync nicht signiert aktiviert ist; IIS kann ungültige Hostnamen ebenfalls ablehnen. |
| HTTP 401 | Aktiven MediaSyncKey, gegebenenfalls Portalreferenz und Uhrzeitsynchronisierung prüfen. |
| HTTP 403 | IIS-, Hosting-, Proxy- und Zugriffsbeschränkungen für MediaSync.ashx prüfen. |
| HTTP 404/410 | Aktualisierten Handler und Bibliothek im konfigurierten Basispfad bereitstellen. Fehlender Endpunkt wird übersprungen und bedeutet keine Aktualisierung. |
| HTTP 409 | Eine andere Aktualisierung könnte zuerst veröffentlicht haben oder die Anfrage wurde wiederholt/außer Reihenfolge gesendet. Nächsten Lauf abwarten oder nach Abschluss konkurrierender Updates erneut versuchen. |
| HTTP 413 | Anfragegrößenlimits von Server und Proxy prüfen; Protokollmaximum ist 1 MiB. |
| HTTP 500 | Portaldiagnose, Dateisystemberechtigungen, Konvertierungsfehler und Speicherplatz prüfen; aktuellen Cache erhalten. |
| HTTP 502 über Tunnel/Proxy | Proxyfehler und Upstream prüfen; lokalen Dienst, Port und Schema bestätigen. 502 allein beweist keine Drosselung. |
| Ungültige Synchronisierungsantwort | Auf Loginseite, HTML-Fehler, Weiterleitung oder inkompatible Antwort prüfen; Proxyregeln und Version kontrollieren. |
Portaldiagnose lesen
Der Handler protokolliert Authentifizierungs- und Synchronisierungsfehler über die Trace-Protokollierung der Anwendung. Aktivieren Sie Fehlerprotokollierung auf dem Host und reproduzieren Sie einen Lauf. Unter Azure App Service für Windows: Application logging (Filesystem) auf Error, danach Log stream oder LogFiles/Application über Kudu prüfen. Dies ist getrennt vom IIS-Zugriffslog. Suchen Sie nach Media synchronization authentication failed oder Media synchronization failed. Die Diagnose nennt fehlgeschlagene Prüfungen, protokolliert aber weder Geheimnis noch Signatur. Eine Zeitabweichung von mehr als fünf Minuten weist auf UTC-Uhr- oder Senderprobleme hin.
Lokale Portale, Tunnel und HTTPS
Business Central Online erreicht das localhost eines PCs nicht. Verwenden Sie einen erreichbaren Tunnel oder gehostetes Portal. Ein HTTPS-Tunnel kann zu einem HTTP-Upstream weiterleiten; das Portal sieht dann die HTTP-Verbindung. Verwenden Sie vertrauenswürdiges lokales HTTPS oder aktivieren Sie Allow HTTP Media Sync. Die Option ist signiert; ein manuell hinzugefügter Header authentifiziert nicht. Aktualisieren Sie beide Seiten vor dem Test. Prüfen Sie bei Invalid Hostname IIS-Express-Bindung und Host-Header; bei Gatewayfehlern Upstream-Code und laufenden lokalen Dienst. Untersuchen Sie immer den jeweiligen Logeintrag.
Speicher und Bereinigung verstehen
Pfade relativ zum Website-Stamm:
| Pfad | Zweck |
|---|---|
temp/img, temp/video |
Ursprüngliche Medien bis zur ersten Veröffentlichung. |
temp/media-cache/<guid>/img und /video |
Vollständige Mediengenerationen. |
App_Data/media-sync/current |
Aktuell veröffentlichte Generation. |
App_Data/media-sync/previous |
Vorherige Generation zur Wiederherstellung; keine automatische Wiederherstellung. |
App_Data/media-sync/<guid>/ |
Upload-Batches, Status oder temporäre manuelle Daten. |
App_Data/media-sync/<guid>.retired |
Ablösezeit über Änderungszeitpunkt der Datei. |
App_Data/media-sync/*.nonce |
Schutz vor wiederholten authentifizierten Anfragen. |
App_Data/media-sync/cleanup.timestamp |
Koordination des Bereinigungslaufs. |
URLs unter /temp/img/... und /temp/video/... werden intern auf die aktuelle Generation umgeschrieben. IIS muss verwaltete Module für statische Anfragen ausführen (runAllManagedModulesForAllRequests="true"). Fehlende Dateien der aktuellen Generation fallen nicht auf alte Kopien zurück. Aktuelle und vorherige Generation sind geschützt; ältere können 15 Minuten nach Ablösung bereinigt werden. Ursprüngliche Ordner können 15 Minuten nach der ersten Veröffentlichung vollständig gelöscht werden, einschließlich zusätzlicher dort abgelegter Dateien.
Erfolgreiche automatische Läufe entfernen Batchdateien; manuelle Läufe bereinigen ihren Zwischenordner. Inaktive Zwischenstände werden nach zwei Stunden, Nonce-Dateien nach 15 Minuten bereinigbar. Bereinigung läuft nur bei späteren authentifizierten Anfragen oder manuellen Updates, höchstens einmal pro Minute. Prüfen Sie bei Restdateien Zeiger, Ablösezeitpunkte, weitere Aktivität, Sperren und Berechtigungen. Warnungen erfordern Warnungsprotokollierung.
Warning
Löschen Sie nicht routinemäßig die aktuelle Generation oder Zeigerdateien. Für Aktualisierungen wird zusätzlicher Speicher benötigt; es gibt kein festes Speicherlimit. Überwachen Sie den freien Speicherplatz.
Hosting und Wiederherstellung
Ein Portal benötigt gemeinsam beschreibbaren Speicher für App_Data/media-sync und temp/media-cache; Sperren, Dateiersetzung und Verzeichnisverschiebungen müssen auf demselben Volume funktionieren. Die Anwendungsidentität braucht Erstell-, Lese-, Verschiebe- und Löschrechte. Große Auswahlmengen müssen in Zeit-, Speicher- und Datenträgerlimits des Hosts passen.
Bei Fehler vor Veröffentlichung bleiben aktuelle Medien verfügbar. Bei Timeout nach Veröffentlichung kann Business Central einen Fehler melden, obwohl das Portal bereits umgeschaltet hat. Prüfen Sie Zeiger und sichtbare Medien; eine spätere vollständige Aktualisierung ist sicher.