Fehlerbehebung für das Adobe Experience Manager-Desktop-Programm, v1.x troubleshoot-aem-desktop-app

Fehlerbehebung im AEM-Desktop-Programm, um gelegentliche Probleme im Zusammenhang mit Installation, Upgrade, Konfiguration usw. zu beheben.

Die Adobe Experience Manager-Desktop-App enthält Dienstprogramme, mit denen Sie das AEM Assets-Repository als Netzwerkfreigabe auf dem Desktop zuordnen können (SMB-Freigabe auf macOS). Bei der Netzwerkfreigabe handelt es sich um eine Betriebssystemtechnologie, mit deren Hilfe Remote-Quellen so behandelt werden können, als würden sie zum lokalen Dateisystem eines Computers gehören. Für das -Desktop-Programm ist die Remote-Dateiquelle die DAM-Repository-Struktur (Digital Asset Management) einer Remote-AEM-Instanz. In der folgenden Abbildung wird die Topologie des Desktop-Programms beschrieben:

Mit dieser Architektur fängt die Desktop-App Dateisystemaufrufe (Öffnen, Schließen, Lesen, Schreiben usw.) an die gemountete Netzwerkfreigabe ab und übersetzt sie in native AEM-HTTP-Aufrufe an den AEM-Server. Dateien werden lokal zwischengespeichert. Weitere Informationen finden Sie unter Verwenden des AEM Desktop-Programms, Version 1.x.

Übersicht über die Komponenten des AEM-Desktop-Programms desktop-app-component-overview

Das -Desktop-Programm enthält die folgenden Komponenten:

Vorgesehene Anwendungsfälle für das AEM-Desktop-Programm intended-use-cases-for-aem-desktop-app

Das AEM-Desktop-Programm verwendet die Netzwerkfreigabetechnologie, um ein Remote-AEM-Repository einem lokalen Desktop zuzuordnen. Sie ist jedoch nicht als Ersatz für eine Netzwerkfreigabe mit Assets vorgesehen, bei der die Benutzer direkt auf ihrem lokalen Desktop Digital Asset Management-Vorgänge ausführen. Dazu zählen das Verschieben oder Kopieren mehrerer Dateien oder das Ziehen umfangreicher Ordnerstrukturen zu der AEM Assets-Netzwerkfreigabe direkt im Finder/Explorer.

Das AEM-Desktop-Programm bietet eine bequeme Möglichkeit, zwischen der AEM Assets Touch-Benutzeroberfläche und dem lokalen Desktop auf DAM-Assets zuzugreifen (sie zu öffnen) und sie zu bearbeiten (zu speichern). Sie verknüpft Assets auf dem AEM Assets-Server mit Ihren Desktop-basierten Workflows.

Der folgende Beispielanwendungsfall veranschaulicht, wie AEM Desktop verwendet werden sollte:

Dieses Szenario ist nicht der einzige Anwendungsfall. Er veranschaulicht jedoch die bequeme Methode zum lokalen Zugreifen auf/Bearbeiten von Assets über AEM Desktop. Sie sollten die DAM-Web-Benutzeroberfläche so oft wie möglich verwenden, da sie ein besseres Erlebnis bietet. Sie ermöglicht Adobe mehr Flexibilität beim Erfüllen der Kundenanforderungen.

Beschränkungen limitations

Die WebDAV/SMB1-Netzwerkfreigabe bietet den Komfort, in einem Explorer/Finder-Fenster mit Dateien arbeiten zu können. Explorer/Finder und AEM kommunizieren jedoch über eine Netzwerkverbindung, die gewissen Einschränkungen unterliegt. Die zum Kopieren einer 1 GB großen Datei in das bereitgestellte WebDAV/SMB-Verzeichnis benötigte Zeit ist beispielsweise identisch mit dem Zeitaufwand zum Hochladen einer 1 GB großen Datei auf eine Website mit einem Webbrowser. Im ersten Fall kann die Dauer aufgrund von Ineffizienzen des WebDAV/SMB-Protokolls und der WebDAV/SMB-Clients des Betriebssystems (insbesondere macOS X) länger sein.

Die mit einem bereitgestellten Verzeichnis ausführbaren Aufgaben sind beschränkt. Grundsätzlich gestaltet sich die Arbeit mit größeren Dateien in Netzwerken mit unzureichender Verbindungsqualität, hoher Latenz oder geringer Bandbreite schwierig, was insbesondere für die Dateibearbeitung gilt.

Adobe empfiehlt, einige Anwendungsfälle zu testen, bevor Sie einem Kunden bestätigen, dass bestimmte Dateitypen über das bereitgestellte Verzeichnis effizient bearbeitet werden können.

Das AEM-Desktop-Programm ist für intensive Manipulationen des Dateisystems nicht geeignet. Dazu zählen unter anderem die folgenden Vorgänge:

Aufgrund der Beschränkungen des Betriebssystems gilt für Windows eine Dateigrößenbeschränkung von 4.294.967.295 Byte (ca. 4,29 GB). Der Grund dafür ist eine Registrierungseinstellung, die definiert, wie groß eine Datei auf einer Netzwerkfreigabe sein darf. Der Wert der Registrierungseinstellung ist ein DWORD-Ausdruck mit einer maximalen Größe, die der referenzierten Zahl entspricht.

Das Experience Manager-Desktop-Programm verfügt über keinen konfigurierbaren Zeitüberschreitungswert, der die Verbindung zwischen dem Experience Manager-Server und dem Desktop-Programm nach einem festen Zeitintervall trennt. Wenn beim Hochladen großer Assets nach einiger Zeit ein Verbindungs-Timeout eintritt, versucht das Programm, das Asset einige Male hochzuladen, indem es den Timeout-Wert für den Upload erhöht. Es gibt keine empfohlene Vorgehensweise, um die Standardeinstellungen für den Timeout zu ändern.

Caching und Kommunikation mit AEM caching-and-communication-with-aem

Das AEM-Desktop-Programm bietet interne Caching- und Hintergrund-Upload-Funktionen zur Verbesserung des Endbenutzererlebnisses. Wenn Sie eine große Datei speichern, wird sie zuerst lokal gespeichert, sodass Sie Ihre Arbeit fortsetzen können. Nach einer gewissen Zeit (momentan 30 Sekunden) wird die Datei dann im Hintergrund an den AEM-Server gesendet.

Im Gegensatz zum Creative Cloud-Desktop oder anderen Dateisynchronisierungslösungen wie Microsoft One Drive ist das AEM-Desktop-Programm kein vollständiger Desktop-Synchronisierungs-Client. Der Grund dafür liegt darin, dass sie Zugriff auf das gesamte AEM Assets-Repository bietet, das für eine vollständige Synchronisierung extrem umfangreich sein kann (mehrere hunderte Gigabyte oder Terabyte).

Das Caching bietet die Möglichkeit, den Mehraufwand bezüglich des Netzwerks/Speichers auf eine Teilmenge von Assets zu beschränken, die für den Benutzer relevant sind.

So führt die AEM-Desktop-App das Caching durch:

Es wird nicht jeder Vorgang lokal zwischengespeichert. Folgendes wird sofort ohne lokales Caching an den AEM-Server gesendet:

Individuelle Vorgänge individual-operations

Wenn Sie eine Fehlerbehebung bei für einzelne Benutzer suboptimierten Leistungsdaten durchführen, lesen Sie zunächst Anwendungsbeschränkungen. Die folgenden Abschnitte umfassen Vorschläge zur Verbesserung der Performance für einzelne Benutzer.

Bandbreitenempfehlungen bandwidth-recommendations

Die für einen einzelnen Benutzer verfügbare Bandbreite spielt eine entscheidende Rolle bei der Performance des WebDAV/SMB-Clients.

Adobe empfiehlt, dass die Upload-Geschwindigkeit eines einzelnen Benutzers bei fast 10 Mbit/s liegt. Bei drahtlosen Verbindungen wird die Bandbreite oftmals zwischen mehreren Benutzern aufgeteilt. Wenn mehrere Benutzer gleichzeitig Aufgaben durchführen, die Netzwerkbandbreite verbrauchen, kann sich die Performance weiter verschlechtern. Verwenden Sie eine kabelgebundene Verbindung, um derartige Probleme zu vermeiden.

Gleichzeitig ausgeführte Vorgänge concurrent-operations

Wenn Sie lokal mit einer Datei interagieren, überprüft AEM Desktop, ob in AEM eine neuere Version der Datei verfügbar ist. Wenn eine neue Version verfügbar ist, lädt das Programm eine neue Kopie der Datei in den lokalen Cache herunter. AEM Desktop überschreibt jedoch eine lokal zwischengespeicherte Datei nicht, wenn sie geändert wurde. Diese Funktion verhindert, dass Ihre Arbeit unbeabsichtigt überschrieben wird.

Wenn dieselbe Datei sowohl lokal als auch in AEM geändert wird, überschreibt die lokal geänderte Version die Version in AEM. In diesem Fall ist die vorherige Version in der Zeitleiste des Assets verfügbar. Sie können beide Versionen überprüfen und Konflikte lösen.

Wenn eine lokale Datei mit der auf dem Server verfügbaren Version inkompatibel ist, werden Sie über das Dialogfeld mit dem Status für den Upload im Hintergrund über den Konflikt benachrichtigt. Öffnen Sie zum Beheben des Problems die in Konflikt stehende Datei und speichern Sie sie. Das Speichern der Datei zwingt AEM Desktop zur Synchronisierung Ihrer letzten Änderungen in AEM. Sie können die vorherigen Versionen des Assets in der Zeitachse anzeigen und jegliche Konflikte auflösen.

Berücksichtigen Sie zusätzliche Faktoren, wenn mehrere Benutzende versuchen, in separaten bereitgestellten Verzeichnissen zu arbeiten, die auf dieselbe AEM-Instanz abzielen. Insbesondere sind die folgenden Faktoren wichtig:

Zusätzliche AEM-Konfigurationen additional-aem-configurations

Wenn sich die WebDAV/SMB-Leistung drastisch vermindert, wenn mehrere Benutzer gleichzeitig arbeiten, können Sie in AEM einige Einstellungen konfigurieren, um die Leistung zu verbessern.

Aktualisieren des Übergangs-Workflows für Assets update-asset-transient-workflows

Sie können die AEM-Leistung verbessern, indem Sie Übergangs-Workflows für den Workflow DAM-Update-Asset aktivieren. Durch die Aktivierung von Übergangs-Workflows wird die zum Aktualisieren von Assets erforderliche Leistung reduziert, wenn sie in AEM erstellt oder aktualisiert werden.

Anpassen der Warteschlange für die Granite-Übergangs-Workflows adjust-granite-transient-workflow-queue

Eine weitere Methode zum Verbessern der AEM-Leistung besteht darin, den Wert der maximal zulässigen parallelen Aufträge für die Warteschlange für Granite-Übergangs-Workflows zu konfigurieren. Der empfohlene Wert ist etwa die Hälfte der Anzahl der verfügbaren CPUs mit dem Server. Führen Sie die folgenden Schritte aus, um den Wert anzupassen:

AWS-Konfiguration aws-configuration

Aufgrund der Netzwerk-Bandbreitenbeschränkungen kann sich die Leistung von WebDAV/SMB verschlechtern, wenn mehrere Benutzer gleichzeitig arbeiten. Adobe empfiehlt, die Größe der AWS-Instanz für eine AEM-Zielinstanz zu erhöhen, die in AWS ausgeführt wird, um die WebDAV/SMB-Leistung zu verbessern.

Durch diese Maßnahme wird insbesondere die für den Server verfügbare Netzwerkbandbreite erhöht. Im Folgenden finden Sie einige Details dazu:

Beschränkungen für ausgecheckte Dateien checked-out-file-limitations

Es gibt einige bekannte Einschränkungen bei der Interaktion mit ausgecheckten Dateien über den Explorer/Finder. Wenn eine Datei ausgecheckt ist, sollte sie mit Ausnahme des Benutzers, der sie auscheckt, für alle Personen schreibgeschützt sein. Diese Regel wird durch die Implementierung des WebDAV/SMB1-Protokolls in AEM erzwungen. Die WebDAV/SMB-Clients des Betriebssystems interagieren jedoch häufig nicht perfekt mit ausgecheckten Dateien. Einige Eigenheiten werden im Folgenden beschrieben.

Allgemein general

Beim Schreiben in eine ausgecheckte Datei wird die Sperre nur innerhalb der AEM-WebDAV-Implementierung erzwungen. Daher erzwingen Clients, die WebDAV verwenden, z. B. das Desktop-Programm, nur die Sperre. Die Sperre wird nicht über die AEM-Web-Oberfläche erzwungen. In der AEM-Oberfläche wird lediglich für ausgecheckte Assets ein Schloss-Symbol in der Kartenansicht angezeigt. Das Symbol hat nur kosmetischen Charakter und keine Auswirkung auf das AEM-Verhalten.

Die WebDAV-Clients verhalten sich nicht immer erwartungsgemäß. Es können weitere Probleme auftreten. Eine Aktualisierung oder Überprüfung des Assets in AEM ist jedoch eine geeignete Methode, um sicherzustellen, dass ein Asset nicht im Moment bearbeitet wird. Dieses Verhalten ist typisch für WebDAV-Clients des Betriebssystems. Adobe hat keinen Einfluss darauf.

Windows windows

Das Löschen einer Datei scheint erfolgreich zu sein, da die Datei nicht mehr im Datei-Explorer von Windows angezeigt wird. Beim Aktualisieren des Verzeichnisses und Einchecken in AEM Assets wird jedoch angezeigt, dass die Datei noch vorhanden ist. Darüber hinaus scheint das Bearbeiten von Dateien erfolgreich zu verlaufen (es werden keine Warnungsdialogfelder oder Fehlermeldungen angezeigt). Beim erneuten Öffnen der Datei oder Einchecken in AEM Assets wird jedoch angezeigt, dass die Datei unverändert ist.

MACOS X mac-os-x

Beim Ersetzen einer Datei wird keine Warnung und kein Fehler angezeigt, aber bei der Überprüfung des Assets in AEM wird deutlich, dass es unverändert ist. Aktualisieren oder überprüfen Sie das Asset in AEM, um sicherzustellen, dass es nicht geändert wird.

Fehlerbehebung bei Problemen mit dem Symbol des Desktop-Programms (macOS X) troubleshooting-desktop-app-icon-issues-mac-os-x

Nach der Installation des -Desktop-Programms wird das Menüsymbol des -Desktop-Programms in der Menüleiste angezeigt. Wenn das Symbol nicht angezeigt wird, führen Sie die folgenden Schritte aus, um das Problem zu beheben:

AEM-Desktop unternimmt für beliebige Dateien drei Synchronisierungsversuche. Wenn die Synchronisierung der Datei nach dem dritten Mal fehlschlägt, geht das AEM-Desktop-Programm davon aus, dass für die Datei ein Konflikt vorliegt, und Sie werden über das Statusfenster für den Upload im Hintergrund darüber benachrichtigt. Ein Konfliktzustand gibt an, dass Ihre letzten Änderungen weiterhin lokal verfügbar sind, sie jedoch nicht wieder mit AEM synchronisiert werden. Die AEM-Desktop-App versucht nicht mehr, zu synchronisieren.

Die einfachste Methode zum Beheben dieser Situation besteht darin, die in Konflikt stehende Datei zu öffnen und erneut zu speichern. Dadurch wird AEM gezwungen, drei weitere Synchronisierungsversuche zu unternehmen. Wenn das Synchronisieren der Datei weiterhin fehlschlägt, lesen Sie für weitere Hilfe die Abschnitte unten.

Löschen des AEM-Desktop-Caches clearing-aem-desktop-cache

Beim Löschen des Caches von AEM Desktop handelt es sich um eine vorläufige Aufgabe zur Fehlerbehebung, durch die verschiedene Probleme mit AEM Desktop gelöst werden können.

Sie können den Cache löschen, indem Sie das Cache-Verzeichnis des Programms an den folgenden Speicherorten löschen.
Unter Windows: %LocalAppData%\Adobe\AssetsCompanion\Cache\

Unter Mac OS: ~/Library/Group/Containers/group.com.adobe.aem.desktop/cache/

Das Verzeichnis kann sich jedoch in Abhängigkeit vom konfigurierten AEM-Endpunkt des AEM-Desktop-Programms ändern. Der Wert ist eine codierte Version der Ziel-URL. Wenn das Ziel des Programms beispielsweise http://localhost:4502 ist, lautet der Verzeichnisname http%3A%2F%2Flocalhost%3A4502%2F.

Wenn Sie den Cache löschen möchten, löschen Sie das Verzeichnis <Encoded AEM Endpoint>.

Ermitteln der AEM-Desktop-Version finding-the-aem-desktop-version

Die Vorgehensweise zum Ermitteln der AEM-Desktopversion ist sowohl für Windows als auch für macOS identisch.

Klicken Sie auf das AEM Desktop-Symbol und wählen Sie dann About (Info) aus. Daraufhin wird die Versionsnummer auf dem Bildschirm angezeigt.

Aktualisieren des AEM-Desktop-Programms auf macOS upgrading-aem-desktop-app-on-macos

Beim Aktualisieren des AEM-Desktop-Programms auf macOS können gelegentlich Probleme auftreten. Diese Probleme werden durch ältere Systemordner für das AEM-Desktop-Programm verursacht. Dadurch wird verhindert, dass neue Versionen von AEM Desktop korrekt geladen werden. Zur Behebung dieses Problems können die folgenden Ordner und Dateien manuell entfernt werden.

Bevor Sie die unten aufgeführten Schritte durchführen, ziehen Sie das Programm „Adobe Experience Manager Desktop“ vom Ordner „macOS-Applikationen“ in den Papierkorb. Öffnen Sie dann das Terminal und führen Sie den folgenden Befehl aus, wobei Sie bei Aufforderung Ihr Kennwort angeben.

sudo rm -rf ~/Library/Application\ Support/com.adobe.aem.desktop
sudo rm -rf ~/Library/Preferences/com.adobe.aem.desktop.plist
sudo rm -rf ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

sudo find /var/folders -type d -name "com.adobe.aem.desktop" | xargs rm -rf
sudo find /var/folders -type d -name "com.adobe.aem.desktop.finderintegration-plugin" | xargs rm -rf

Speichern einer von anderen Benutzern ausgecheckten Datei saving-a-file-checked-out-by-others

Technische Einschränkungen des Betriebssystems verhindern, dass Benutzer eine konsistente Erfahrung haben, wenn sie versuchen, eine Datei zu überschreiben, die andere ausgecheckt haben. Das Erlebnis variiert je nach Programm, das zum Bearbeiten der ausgecheckten Datei verwendet wird. Mitunter zeigt das Programm eine Fehlermeldung mit dem Hinweis an, dass ein Fehler beim Schreiben auf das Laufwerk aufgetreten ist, oder es wird ein scheinbar nicht relevanter oder allgemeiner Fehler angezeigt. Es kann auch sein, dass gar keine Fehlermeldung angezeigt und der Vorgang scheinbar erfolgreich ausgeführt wird.

In diesem Fall können Sie durch Schließen und erneutes Öffnen der Datei feststellen, dass die Inhalte unverändert sind. Bei einigen Programmen wird jedoch möglicherweise eine Sicherung der Datei gespeichert, sodass Ihre Änderungen übernommen werden können.

Unabhängig vom Verhalten bleibt die Datei unverändert, wenn Sie sie einchecken. Selbst wenn eine andere Version der Datei angezeigt wird, erfolgt keine Synchronisierung der Änderungen mit AEM.

Beheben von Problemen beim Verschieben von Dateien troubleshooting-problems-around-moving-files

Für die Server-API müssen zusätzliche Header und Werte für X-Ziel, X-Tiefe und X-Überschreiben übergeben werden, damit die Verschiebungs- und Kopiervorgänge funktionieren. Die Dispatcher übergibt diese Kopfzeilen standardmäßig nicht, was dazu führt, dass diese Vorgänge fehlschlagen. Weitere Informationen finden Sie unter Herstellen einer Verbindung zu AEM hinter einem Dispatcher.

Beheben von AEM Desktop-Verbindungsproblemen troubleshooting-aem-desktop-connection-issues

Problem bei SAML-Umleitung saml-redirect-issue

Die häufigste Ursache für Probleme beim Herstellen einer Verbindung zwischen AEM Desktop und Ihrer SSO-fähigen (SAML) AEM-Instanz ist die Tatsache, dass der SAML-Prozess keine Zurückleitung zum ursprünglich angeforderten Pfad durchführt. Alternativ kann die Verbindung zu einem Host umgeleitet werden, der nicht in der AEM-Desktop-App konfiguriert ist. Führen Sie die folgenden Schritte durch, um den Anmeldungsprozess zu überprüfen:

Problem bei der SSL-Konfiguration ssl-configuration-issue

Die Bibliotheken, die die AEM-Desktop-App für die HTTP-Kommunikation verwendet, verwenden eine strikte SSL-Durchsetzung. Manchmal kann eine Verbindung über einen Browser erfolgreich sein, aber die AEM-Desktop-App kann nicht verwendet werden. Installieren Sie für eine ordnungsgemäße SSL-Konfiguration das fehlende Zwischenzertifikat in Apache. Siehe How to install an Intermediate CA cert in Apache (nur auf Englisch verfügbar).

Verwenden von AEM Desktop mit Dispatcher using-aem-desktop-with-dispatcher

AEM Desktop funktioniert mit AEM-Bereitstellungen hinter einem Dispatcher. Dies ist eine standardmäßige und empfohlene Konfiguration für AEM-Server. AEM-Dispatcher vor AEM-Autorenumgebungen werden normalerweise so konfiguriert, dass das Caching von DAM-Assets übersprungen wird. Deshalb stellen Dispatcher aus Sicht von AEM Desktop kein zusätzliches Caching bereit. Stellen Sie sicher, dass die Dispatcher-Konfiguration so angepasst ist, dass sie für AEM Desktop funktioniert. Weitere Informationen finden Sie unter Herstellen einer Verbindung zu AEM mit einer Dispatcher.

Überprüfen auf Protokolldateien checking-for-log-files

Je nach Betriebssystem befinden sich die Protokolldateien für das AEM-Desktop-Programm in den folgenden Verzeichnissen: