Zum Inhalt

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.