Problemen oplossen Adobe Experience Manager desktop app v1.x troubleshoot-aem-desktop-app

Los AEM Desktop app problemen op om af en toe de kwesties met betrekking tot installatie, verbetering, configuratie, etc. op te lossen.

Adobe Experience Manager desktop-app bevat hulpprogramma's waarmee u de AEM Assets-opslagplaats kunt toewijzen als een gedeelde netwerksite op een desktopcomputer (SMB-share op Mac OS). Het aandeel van het netwerk is een werkend systeemtechnologie die verre bronnen toelaat worden behandeld alsof zij deel van het lokale dossiersysteem van een computer maakten. In het geval van een bureaubladtoepassing wordt de DAM-opslagstructuur (Digital Asset Management) van een externe AEM-instantie aangewezen als externe bestandsbron. In het volgende diagram wordt de topologie van de bureaubladtoepassing beschreven:

Met deze architectuur, onderschept de Desktop toepassing dossiersysteemvraag (open, dicht, lees, schrijf, etc.) aan het opgezette netwerkaandeel, en zet hen in inheemse AEM vraag van HTTP aan de AEM server om. Bestanden worden lokaal in cache geplaatst. Zie voor meer informatie AEM desktop app v1.x gebruiken.

Overzicht van de bureaubladtoepassing desktop-app-component-overview

desktop-app bevat de volgende componenten:

Beoogde gebruiksgevallen voor AEM bureaubladtoepassing intended-use-cases-for-aem-desktop-app

AEM desktop app gebruikt de netwerkshare technologie om een externe AEM opslagplaats toe te wijzen aan een lokale desktop. Het is echter niet bedoeld als vervanging voor een netwerkshare-holding-assets, waarbij gebruikers digitale middelenbeheerbewerkingen rechtstreeks vanaf hun lokale bureaublad uitvoeren. Dit zijn onder andere het verplaatsen of kopiëren van meerdere bestanden of het rechtstreeks slepen van grote mapstructuren naar het AEM Assets-netwerkaandeel in Finder/Explorer.

AEM bureaubladtoepassing biedt een handige manier om toegang te krijgen tot DAM-middelen (openen) en deze te bewerken (opslaan) tussen de AEM Assets Touch-gebruikersinterface en het lokale bureaublad. Elementen op de AEM Assets-server worden gekoppeld aan workflows op uw bureaublad.

In het volgende voorbeeld ziet u hoe AEM Desktop moet worden gebruikt:

Dit is niet het enige gebruiksgeval. Het toont echter aan hoe AEM Desktop een handig mechanisme is om elementen lokaal te openen/bewerken. U wordt aangemoedigd om de DAM-webinterface zoveel mogelijk te gebruiken, omdat deze een betere ervaring biedt. Het verstrekt Adobe meer flexibiliteit om aan klantenvereisten te voldoen.

Beperkingen limitations

WebDAV/SMB1 netwerkaandeel verstrekt het gemak om met dossiers in een venster van de Ontdekkingsreiziger/van de Vinder te werken. Nochtans, de Ontdekkingsreiziger/de Vinder en AEM communiceren over een netwerkverbinding die bepaalde beperkingen heeft. De tijd die bijvoorbeeld nodig is om een 1-GB-bestand naar de gekoppelde WebDAV/SMB-map te kopiëren, is ongeveer gelijk aan de tijd die nodig is om een 1-GB-bestand met een webbrowser naar een website te uploaden. In het eerste geval kan de duur langer zijn vanwege inefficiënties van het WebDAV/SMB-protocol en de WebDAV/SMB-clients van het besturingssysteem (met name Mac OS X).

Er zijn beperkingen aan de typen taken die vanuit een gekoppelde map kunnen worden uitgevoerd. Over het algemeen kan het lastig zijn om met grote bestanden te werken, met name via een slechte/hoge latentie/lage bandbreedte-netwerkverbinding, vooral wanneer u grote bestanden bewerkt.

Adobe raadt u aan een aantal tests in het gebruiksgeval uit te voeren voordat u een client bindt, zodat bepaalde bestandstypen op een efficiënte manier op hun plaats vanuit de gekoppelde map kunnen worden bewerkt.

AEM Desktop is niet geschikt voor intensieve manipulatie van bestandssystemen, waaronder, maar niet beperkt tot:

Vanwege beperkingen in het besturingssysteem geldt voor Windows een maximale bestandsgrootte van 4.294.967.295 bytes (ongeveer 4,29 GB). Dit is te wijten aan een registerinstelling die bepaalt hoe groot een bestand op een netwerkshare kan zijn. De waarde van de registratie het plaatsen is DWORD met een maximumgrootte die het referenced aantal evenaart.

Experience Manager desktop-app heeft geen configureerbare time-outwaarde die de verbinding verbreekt tussen Experience Manager de server en de Desktop app na een vast tijdinterval. Wanneer u grote middelen uploadt en de verbinding na een tijdje wordt verbroken, probeert de toepassing het element een paar keer te uploaden door de time-out van het uploaden te verhogen. Er is geen aanbevolen manier om de standaardtime-outinstellingen te wijzigen.

Caching en communicatie met AEM caching-and-communication-with-aem

AEM bureaubladtoepassing biedt interne caching- en achtergrondlaadmogelijkheden om de gebruikerservaring te verbeteren. Wanneer u een groot bestand opslaat, wordt het eerst lokaal opgeslagen zodat u kunt doorgaan met werken. Na enige tijd (momenteel 30 seconden) wordt het bestand op de achtergrond naar de AEM server verzonden.

In tegenstelling tot Creative Cloud Desktop- of andere oplossingen voor bestandssynchronisatie, zoals Microsoft One Drive, is de desktop-app geen volledige Desktop Sync client. De reden hiervoor is dat het toegang biedt tot de gehele AEM Assets-opslagplaats, die zeer groot kan zijn (honderden gigabytes of terabytes) voor een volledige synchronisatie.

Caching verstrekt de capaciteit om de netwerk/opslagoverheadkosten tot slechts een ondergroep van activa te beperken die voor de gebruiker relevant zijn.

Hieronder wordt beschreven hoe AEM bureaubladtoepassing caching uitvoert:

Elke bewerking wordt niet lokaal in het cachegeheugen opgeslagen. Het volgende wordt onmiddellijk naar de AEM-server verzonden zonder lokale caching:

Individuele verrichtingen individual-operations

Wanneer het oplossen van problemen sub-geoptimaliseerde prestaties voor de individuele gebruikers, eerste overzicht de toepassingsbeperkingen. De volgende secties bevatten suggesties om de prestaties voor de afzonderlijke gebruikers te verbeteren.

Aanbevelingen voor bandbreedte bandwidth-recommendations

De bandbreedte beschikbaar aan een individuele gebruiker speelt een kritieke rol in de prestaties van de cliënt WebDAV/SMB.

Adobe raadt aan dat de uploadsnelheid van een individuele gebruiker dicht bij 10 Mbps is. Voor draadloze verbindingen, wordt de bandbreedte vaak gedeeld tussen veelvoudige gebruikers. Als de veelvoudige gebruikers tegelijkertijd taken uitvoeren die netwerkbandbreedte verbruiken, kunnen de prestaties nog verder degraderen. Gebruik een bekabelde verbinding om dergelijke problemen te voorkomen.

Gelijktijdige bewerkingen concurrent-operations

Wanneer u lokaal met een bestand werkt, controleert AEM Desktop of een nieuwere versie van het bestand beschikbaar is in AEM. Als er een nieuwe versie beschikbaar is, downloadt de toepassing een nieuwe kopie van het bestand naar de lokale cache. AEM Desktop overschrijft een lokaal in de cache opgeslagen bestand echter niet als het is gewijzigd. Met deze functie voorkomt u dat uw werk per ongeluk wordt overschreven.

Wanneer hetzelfde bestand zowel lokaal als in AEM wordt gewijzigd, overschrijft de lokaal gewijzigde versie de versie in AEM. In dit geval is de vorige versie beschikbaar in de tijdlijn van het element. U kunt beide versies controleren en eventuele conflicten oplossen.

Als een lokaal bestand niet overeenkomt met de versie die beschikbaar is op de server, wordt in het statusdialoogvenster voor uploaden op de achtergrond melding gemaakt van het conflict. Open het conflicterende bestand en sla het op om het probleem op te lossen. Als u het bestand opslaat, worden de bestanden AEM Desktop geforceerd om de meest recente lokale wijzigingen in AEM te synchroniseren. U kunt vorige versies van het element in de tijdlijn bekijken en eventuele conflicten oplossen.

U zou met extra factoren rekening moeten houden wanneer de veelvoudige gebruikers proberen om in afzonderlijke opgezette folders te werken die het zelfde AEM instantie richten. De volgende factoren zijn met name van belang:

Aanvullende AEM additional-aem-configurations

Als de WebDAV/SMB prestaties drastisch degraderen wanneer de veelvoudige gebruikers gelijktijdig werken, kunt u een paar dingen in AEM vormen, die kunnen helpen prestaties verbeteren.

Workflows voor middelentransitie bijwerken update-asset-transient-workflows

U kunt de prestaties aan de AEM kant verbeteren door tijdelijke workflows voor de DAM Update Asset-workflow in te schakelen. Als u tijdelijke workflows inschakelt, neemt de verwerkingscapaciteit af die nodig is om elementen bij te werken wanneer deze worden gemaakt of gewijzigd in AEM.

De tijdelijke Granite-workflowwachtrij aanpassen adjust-granite-transient-workflow-queue

Een andere methode om AEM prestaties te verbeteren is de waarde van de maximumparallelle banen voor de Granite Transient baan van de Rij van het Werkschema te vormen. De aanbevolen waarde is ongeveer de helft van het aantal CPU's dat beschikbaar is op de server. Voer de volgende stappen uit om de waarde aan te passen:

AWS-configuratie aws-configuration

Vanwege de beperkingen van de netwerkbandbreedte kunnen de prestaties van WebDAV/SMB afnemen wanneer meerdere gebruikers gelijktijdig werken. Adobe raadt aan de AWS-instantie groter te maken voor een AEM die op AWS wordt uitgevoerd om de prestaties van WebDAV/SMB te verbeteren.

Deze maatregel verhoogt specifiek de hoeveelheid netwerkbandbreedte beschikbaar aan de server. Hier volgen enkele details:

Beperkingen van uitgecheckte bestanden checked-out-file-limitations

Er zijn een paar bekende beperkingen in de manier u met uitgecheckte dossiers door Ontdekkingsreiziger/Vinder kunt in wisselwerking staan. Als een bestand is uitgecheckt, moet het alleen-lezen zijn voor iedereen behalve de gebruiker die het bestand heeft uitgecheckt. De implementatie van het WebDAV/SMB1 protocol in AEM dwingt deze regel af. Maar WebDAV/SMB-clients van het besturingssysteem communiceren vaak niet netjes met uitgecheckte bestanden. Enkele oddities worden hieronder beschreven.

Algemeen general

Bij het schrijven naar een uitgecheckt bestand wordt de vergrendeling alleen afgedwongen binnen AEM WebDAV-implementatie. Dit betekent dat de vergrendeling alleen wordt afgedwongen door clients die WebDAV gebruiken, zoals de bureaubladtoepassing. Het slot wordt niet afgedwongen door AEM webinterface. In de AEM-interface wordt alleen een vergrendelingspictogram weergegeven in de kaartweergave voor elementen die zijn uitgecheckt. Het pictogram is cosmetisch en heeft geen effect op het gedrag van AEM.

Over het algemeen gedragen de WebDAV-clients zich niet altijd zoals u had verwacht. Er kunnen nog andere problemen zijn. Het vernieuwen of controleren van het element in AEM is echter een goede manier om te controleren of een element niet wordt gewijzigd. Dit gedrag is typisch van de cliënten WebDAV van OS, die niet onder Adobe controle is.

Windows windows

Het verwijderen van een bestand lijkt te zijn gelukt omdat het bestand verdwijnt uit de bestandsverkenner in Windows. Als u de map echter vernieuwt en AEM elementen controleert, ziet u dat het bestand nog steeds aanwezig is. Bovendien lijkt het bewerken van bestanden te zijn geslaagd (er worden geen waarschuwingsvensters of foutberichten weergegeven). Als u het bestand echter opnieuw opent of AEM elementen controleert, wordt duidelijk dat het bestand ongewijzigd blijft.

Mac OS X mac-os-x

Bij het vervangen van een bestand wordt geen waarschuwing of fout weergegeven, maar bij het controleren van het element in AEM wordt duidelijk dat het bestand ongewijzigd blijft. Vernieuw of controleer het middel in AEM om te verifiëren dat het niet wordt gewijzigd.

Problemen met bureaubladpictogrammen oplossen (Mac OS X) troubleshooting-desktop-app-icon-issues-mac-os-x

Nadat u de bureaubladtoepassing hebt geïnstalleerd, verschijnt het pictogram van het menu voor de bureaubladtoepassing in de menubalk. Als het pictogram niet wordt weergegeven, voert u de volgende stappen uit om het probleem op te lossen:

AEM Desktop probeert om het even welk bepaald dossier drie keer te synchroniseren. Als het bestand na de derde poging niet kan worden gesynchroniseerd, beschouwt AEM Desktop het bestand als een conflict en brengt het u op de hoogte via het statusvenster voor uploaden op de achtergrond. Een conflictstatus geeft aan dat de meest recente wijzigingen nog steeds lokaal beschikbaar zijn, maar niet naar AEM worden gesynchroniseerd. AEM bureaubladtoepassing probeert niet meer te synchroniseren.

U kunt deze situatie het eenvoudigst verhelpen door het conflicterende bestand te openen en opnieuw op te slaan. Het dwingt AEM Desktop om synchronisatie voor extra drie gelegenheden te proberen. Raadpleeg de onderstaande secties voor meer informatie als het bestand nog steeds niet kan worden gesynchroniseerd.

Cache van AEM bureaublad wissen clearing-aem-desktop-cache

Het wissen van de cache van AEM Desktop is een voorlopige taak voor het oplossen van problemen die verschillende AEM desktopproblemen kan oplossen.

U kunt de cache wissen door de cachemap van de toepassing op de volgende locaties te verwijderen.
In Windows: %LocalAppData%\Adobe\AssetsCompanion\Cache\

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

Nochtans, kan de plaats afhankelijk van AEM Desktop gevormd AEM eindpunt veranderen. De waarde is een gecodeerde versie van de beoogde URL. Als de toepassing zich bijvoorbeeld richt op http://localhost:4502, is de mapnaam http%3A%2F%2Flocalhost%3A4502%2F.

Als u de cache wilt wissen, verwijdert u de <encoded aem="" endpoint=""> directory.

De AEM desktopversie zoeken finding-the-aem-desktop-version

De procedure om de versie van de AEM Desktop te controleren is het zelfde voor zowel Vensters als Mac OS.

Klik op het pictogram AEM bureaublad en kies Info. Het versienummer wordt op het scherm weergegeven.

Een upgrade uitvoeren van AEM bureaubladtoepassing op macOS upgrading-aem-desktop-app-on-macos

Soms kunnen er problemen optreden wanneer u een upgrade uitvoert naar AEM bureaubladtoepassing op macOS. Dit wordt veroorzaakt door de oude systeemmap van AEM bureaubladtoepassing, waardoor nieuwe versies van AEM Desktop niet correct kunnen worden geladen. U kunt dit probleem verhelpen door de volgende mappen en bestanden handmatig te verwijderen.

Voordat u de onderstaande stappen uitvoert, sleept u de toepassing Adobe Experience Manager Desktop van de map macOS Applications naar de prullenmand. Open vervolgens de terminal en voer de volgende opdracht uit, waarbij u uw wachtwoord opgeeft wanneer hierom wordt gevraagd.

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

Een bestand opslaan dat door anderen is uitgecheckt saving-a-file-checked-out-by-others

De technische beperkingen van het besturingssysteem verhinderen dat gebruikers een consistente ervaring hebben bij het overschrijven van een bestand dat door anderen is uitgecheckt. De ervaring varieert afhankelijk van de toepassing die wordt gebruikt om het uitgecheckte bestand te bewerken. Soms wordt in de toepassing een foutbericht weergegeven dat een schrijffout van een schijf aangeeft of dat een schijnbaar niet-verwante of algemene fout wordt weergegeven. In andere gevallen wordt geen foutbericht weergegeven en lijkt de bewerking te zijn geslaagd.

In dat geval kan bij het sluiten en opnieuw openen van het bestand blijken dat de inhoud ongewijzigd blijft. Sommige toepassingen kunnen echter een back-up van het bestand opslaan, zodat de wijzigingen kunnen worden toegepast.

Het bestand blijft ongewijzigd wanneer u het incheckt, ongeacht het gedrag. Zelfs als een andere versie van het bestand wordt weergegeven, worden de wijzigingen niet gesynchroniseerd met AEM.

Problemen met het verplaatsen van bestanden oplossen troubleshooting-problems-around-moving-files

De server-API vereist extra kopballen, x-Bestemming, x-Diepte, en x-Overschrijf, om worden overgegaan voor de beweging en exemplaarverrichtingen om te werken. De verzender geeft deze headers standaard niet door, waardoor deze bewerkingen mislukken. Zie voor meer informatie Verbinding maken met AEM achter een Dispatcher.

Problemen met AEM bureaubladverbinding oplossen troubleshooting-aem-desktop-connection-issues

SAML-omleiding saml-redirect-issue

De gemeenschappelijkste reden voor kwesties met AEM Desktop die met uw SSO-Toegelaten (SAML) AEM instantie verbinden is dat het proces SAML niet naar de oorspronkelijk gevraagde weg opnieuw richt. De verbinding kan ook worden omgeleid naar een host die niet is geconfigureerd in AEM bureaublad. Voer de volgende stappen uit om het aanmeldingsproces te verifiëren:

Probleem met SSL-configuratie ssl-configuration-issue

De bibliotheken die AEM bureaubladtoepassing gebruikt voor HTTP-communicatie maken gebruik van strikte SSL-afgedwongen omzetting. Soms kan een verbinding met een browser slagen, maar wordt AEM bureaubladtoepassing niet gebruikt. Installeer het ontbrekende tussentijdse certificaat in Apache om SSL op de juiste wijze te configureren. Zie Hoe te om een MiddenCA cert in Apache te installeren.

Werken met AEM Desktop met dispatcher using-aem-desktop-with-dispatcher

AEM Desktop werkt met AEM implementaties achter een dispatcher. Dit is een standaard en aanbevolen configuratie voor AEM servers. AEM verzenders vóór AEM ontwerpomgevingen worden doorgaans geconfigureerd om het in cache plaatsen van DAM-middelen over te slaan. Daarom bieden de verzenders geen extra caching vanuit het standpunt van de AEM Desktop. Zorg ervoor dat de configuratie van de verzender is aangepast aan de werking van AEM Desktop. Zie voor meer informatie Verbinding maken met AEM achter een verzender.

Controleren op logbestanden checking-for-log-files

Afhankelijk van uw besturingssysteem kunt u de logbestanden voor AEM Desktop op de volgende locaties vinden: