Felsök Adobe Experience Manager-datorprogrammet v1.x troubleshoot-aem-desktop-app

Felsök AEM datorprogram för att lösa tillfälliga problem som rör installation, uppgradering, konfiguration och så vidare.

Skrivbordsappen Adobe Experience Manager innehåller verktyg som hjälper dig att mappa AEM Assets-databasen som en nätverksresurs på skrivbordet (SMB-resurs på macOS). Nätverksresursen är en operativsystemsteknik som gör att fjärrkällor kan hanteras som om de var en del av en dators lokala filsystem. För skrivbordsprogrammet är fjärrfilskällan DAM-databasstrukturen (Digital Asset Management) för en AEM fjärrinstans. I följande diagram beskrivs skrivbordsappens topologi:

Med den här arkitekturen fångar skrivbordsappen upp filsystemanrop (öppna, stänga, läsa, skriva osv.) till den monterade nätverksresursen och översätter dem till interna AEM HTTP-anrop till AEM. Filerna cachelagras lokalt. Mer information finns i Använd AEM datorprogram v1.x.

Översikt över komponenten AEM datorprogram desktop-app-component-overview

Datorprogrammet innehåller följande komponenter:

Användningsexempel för AEM datorprogram intended-use-cases-for-aem-desktop-app

Det AEM datorprogrammet använder nätverksdelningstekniken för att mappa en AEM till ett lokalt skrivbord. Den är dock inte avsedd som ersättning för en nätverksresurs som innehåller resurser, där användarna utför digitala resurshanteringsåtgärder direkt från sin lokala dator. Det kan vara att flytta eller kopiera flera filer eller dra stora mappstrukturer till AEM Assets-nätverksresursen direkt i Finder/Utforskaren.

Det AEM datorprogrammet är ett bekvämt sätt att komma åt (öppna) och redigera (spara) DAM-resurser mellan AEM Assets Touch-gränssnittet och det lokala skrivbordet. Den länkar resurser på AEM Assets-servern till skrivbordsbaserade arbetsflöden.

Följande exempel visar hur AEM Desktop ska användas:

Detta scenario är inte det enda användningsfallet. Det visar dock hur AEM Desktop är en praktisk metod för att få åtkomst till och redigera resurser lokalt. Du uppmanas att använda DAM-webbgränssnittet så mycket som möjligt eftersom det ger en bättre upplevelse. Det ger Adobe större flexibilitet för att uppfylla kundernas krav.

Begränsningar limitations

Nätverksresursen WebDAV/SMB1 gör det enkelt att arbeta med filer i Utforskaren/Finder-fönstret. Utforskaren/Finder och AEM kommunicera via en nätverksanslutning som har vissa begränsningar. Den tid det tar att kopiera en fil på 1 GB till den monterade WebDAV/SMB-katalogen är ungefär densamma som den tid som krävs för att överföra en fil på 1 GB till en webbplats med en webbläsare. I det tidigare fallet kan varaktigheten vara längre på grund av ineffektivitet i WebDAV/SMB-protokollet och operativsystemets WebDAV/SMB-klienter (särskilt macOS X).

Det finns begränsningar för de typer av uppgifter som kan utföras från en monterad katalog. I allmänhet kan det vara svårt att arbeta med stora filer, särskilt när det gäller nätverksanslutningar med låg/hög fördröjning/låg bandbredd, särskilt när du redigerar stora filer.

Adobe rekommenderar att du utför vissa falltester innan du implementerar vissa typer av filer på en klient, så att de kan redigeras på plats från den monterade katalogen.

AEM Desktop lämpar sig inte för intensiv bearbetning av filsystem, inklusive, men inte begränsat till:

På grund av begränsningar i operativsystemet har Windows en filstorleksbegränsning på 4 294 967 295 byte (cirka 4,29 GB). Det beror på en registerinställning som definierar hur stor en fil på en nätverksresurs kan vara. Registerinställningens värde är ett DWORD med en maximal storlek som är lika med det refererade talet.

Skrivbordsappen Experience Manager har inget konfigurerbart timeout-värde som kopplar från anslutningen mellan servern Experience Manager och skrivbordsappen efter ett fast tidsintervall. När du överför stora resurser, och anslutningen får timeout efter en stund, försöker programmet överföra resursen några gånger genom att öka tidsgränsen för överföring. Det finns inget rekommenderat sätt att ändra standardinställningarna för timeout.

Cachning och kommunikation med AEM caching-and-communication-with-aem

Det AEM datorprogrammet har funktioner för intern cachelagring och bakgrundsuppladdning som förbättrar slutanvändarens upplevelse. När du sparar en stor fil sparas den först lokalt så att du kan fortsätta arbeta. Efter en stund (för närvarande 30 sekunder) skickas filen sedan till AEM i bakgrunden.

Till skillnad från Creative Cloud Desktop eller andra filsynkroniseringslösningar, som Microsoft One Drive, är AEM inte en fullständig klient för synkronisering av stationära datorer. Orsaken till detta är att det ger tillgång till hela AEM Assets-databasen, som kan vara mycket stor (hundratals gigabyte eller terabyte) för en fullständig synkronisering.

Cachelagring ger möjlighet att begränsa nätverks-/lagringskostnaderna till endast en delmängd av resurserna som är relevanta för användaren.

Så här utför AEM datorprogram cachelagring:

Alla åtgärder cachelagras inte lokalt. Följande överförs direkt till AEM Server utan lokal cachelagring:

Individuella åtgärder individual-operations

När du felsöker deloptimerade prestanda för enskilda användare ska du först granska appbegränsningarna. De följande avsnitten innehåller förslag på hur du kan förbättra prestandan för enskilda användare.

Bandbreddsrekommendationer bandwidth-recommendations

Den bandbredd som är tillgänglig för en enskild användare spelar en avgörande roll för WebDAV/SMB-klientens prestanda.

Adobe rekommenderar att en enskild användares överföringshastighet är nästan 10 Mbit/s. För trådlösa anslutningar delas bandbredd ofta mellan flera användare. Om flera användare samtidigt utför uppgifter som förbrukar nätverksbandbredd kan prestandan försämras ytterligare. Undvik sådana problem genom att använda en kabelanslutning.

Samtidiga åtgärder concurrent-operations

När du interagerar med en fil lokalt kontrollerar AEM om det finns en senare version av filen i AEM. Om det finns en ny version hämtar programmet en ny kopia av filen till det lokala cacheminnet. AEM Skrivbordet skriver dock inte över en lokalt cachelagrad fil om den har ändrats. Den här funktionen förhindrar att ditt arbete skrivs över av misstag.

När samma fil ändras både lokalt och i AEM skrivs versionen över i AEM av den lokalt ändrade versionen. I det här fallet är den tidigare versionen tillgänglig på resursens tidslinje. Du kan verifiera båda versionerna och lösa eventuella konflikter.

Om en lokal fil inte är kompatibel med den version som finns på servern visas ett meddelande om konflikten i dialogrutan för bakgrundsstatus. Lös problemet genom att öppna filen som är i konflikt och spara den. Om du sparar filen måste AEM Skrivbord synkronisera dina senaste lokala ändringar till AEM. Du kan visa tidigare versioner av resursen på tidslinjen och lösa eventuella konflikter.

Ta hänsyn till ytterligare faktorer när flera användare försöker arbeta i separata monterade kataloger som har samma AEM som mål. Bland annat är följande faktorer viktiga:

Ytterligare AEM konfigurationer additional-aem-configurations

Om WebDAV-/SMB-prestanda försämras drastiskt när flera användare arbetar samtidigt kan du konfigurera några saker i AEM, vilket kan förbättra prestandan.

Uppdatera resursövergående arbetsflöden update-asset-transient-workflows

Du kan förbättra AEM prestanda genom att aktivera tillfälliga arbetsflöden för arbetsflödet DAM Update Asset. Om du aktiverar tillfälliga arbetsflöden minskas den processorkraft som krävs för att uppdatera resurser när de skapas eller ändras i AEM.

Justera Granska övergående arbetsflödeskö adjust-granite-transient-workflow-queue

En annan metod för att förbättra AEM prestanda är att konfigurera värdet för det maximala antalet parallella jobb för jobbet Beviljit Transient Workflow Queue. Det rekommenderade värdet är ungefär hälften av antalet tillgängliga processorer med servern. Så här justerar du värdet:

AWS-konfiguration aws-configuration

På grund av begränsningar i nätverkets bandbredd kan WebDAV/SMB-prestanda försämras när flera användare arbetar samtidigt. Adobe rekommenderar att storleken på AWS-instansen ökas för en AEM som körs på AWS för att förbättra prestandan för WebDAV/SMB.

Den här åtgärden ökar specifikt mängden nätverksbandbredd som är tillgänglig för servern. Här är några detaljer:

Utcheckade filbegränsningar checked-out-file-limitations

Det finns några kända begränsningar för hur du kan interagera med utcheckade filer via Utforskaren/Finder. Om en fil är utcheckad bör den vara skrivskyddad för alla förutom den användare som har filen utcheckad. Implementeringen av WebDAV/SMB1-protokollet i AEM verkställer den här regeln. Operativsystemets WebDAV-/SMB-klienter samverkar dock ofta inte på ett bra sätt med utcheckade filer. Nedan beskrivs några uddpunkter.

Allmänt general

När du skriver till en utcheckad fil används låset bara i AEM WebDAV-implementering. Detta innebär att klienter som använder WebDAV, till exempel skrivbordsappen, bara använder låset. Låset används inte via AEM webbgränssnitt. I AEM visas bara en låsikon i kortvyn för resurser som är utcheckade. Ikonen är kosmetisk och påverkar inte AEM beteende.

I allmänhet fungerar inte WebDAV-klienterna som förväntat. Det kan finnas ytterligare problem. Att uppdatera eller kontrollera mediefilen i AEM är dock ett bra sätt att verifiera att en mediefil inte ändras. Detta beteende är typiskt för operativsystemets WebDAV-klienter, som inte styrs av Adobe.

Windows windows

Det verkar som om det går att ta bort en fil eftersom den försvinner från filutforskaren i Windows. När du uppdaterar katalogen och checkar in AEM Assets visas dock att filen fortfarande finns. Dessutom verkar redigeringen av filer lyckas (inga varningsmeddelanden eller felmeddelanden visas). Om du öppnar filen på nytt eller checkar in AEM Assets ser du dock att filen inte ändras.

MACOS X mac-os-x

Om du ersätter en fil visas inte en varning eller ett fel, men om du markerar resursen i AEM visas att den inte ändras. Uppdatera eller kontrollera resursen i AEM för att bekräfta att den inte ändras.

Felsöka problem med ikoner för datorprogram (macOS X) troubleshooting-desktop-app-icon-issues-mac-os-x

När du har installerat skrivbordsappen visas menyikonen för skrivbordsappen på menyraden. Om ikonen inte visas utför du följande steg för att lösa problemet:

AEM försöker synkronisera en given fil tre gånger. Om filen inte kan synkroniseras efter det tredje försöket tolkar AEM Desktop filen som i konflikt och meddelar dig via statusfönstret för bakgrundsuppladdningen. Ett konfliktläge indikerar att dina senaste ändringar fortfarande är tillgängliga lokalt, men de synkroniseras inte tillbaka till AEM. Det AEM datorprogrammet försöker inte längre synkronisera.

Det enklaste sättet att åtgärda detta är att öppna filen som är i konflikt och spara den igen. Det tvingar AEM att försöka synkronisera ytterligare tre gånger. Om filen fortfarande inte kan synkroniseras finns mer hjälp i avsnitten nedan.

Rensar AEM Skrivbordscache clearing-aem-desktop-cache

Att radera AEM Skrivbordscache är en preliminär felsökningsåtgärd som kan lösa flera AEM problem med skrivbordet.

Du kan rensa cacheminnet genom att ta bort programmets cachekatalog på följande platser.
I Windows: %LocalAppData%\Adobe\AssetsCompanion\Cache\

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

Platsen kan dock ändras beroende på AEM datorns konfigurerade AEM. Värdet är en kodad version av mål-URL:en. Om programmet till exempel har http://localhost:4502 som mål är katalognamnet http%3A%2F%2Flocalhost%3A4502%2F.

Ta bort katalogen <Encoded AEM Endpoint> om du vill rensa cacheminnet.

Söker efter den AEM datorversionen finding-the-aem-desktop-version

Du använder samma procedur för att kontrollera vilken version AEM är för både Windows och macOS.

Klicka på ikonen AEM Skrivbord och välj sedan Om. Versionsnumret visas på skärmen.

Uppgradera AEM på macOS upgrading-aem-desktop-app-on-macos

Ibland kan problem uppstå när du uppgraderar AEM på macOS. Äldre systemmappar för AEM datorprogram orsakar dessa problem. Det förhindrar att nya versioner av AEM läses in korrekt. Följande mappar och filer kan tas bort manuellt för att åtgärda problemet.

Innan du utför stegen nedan drar du Adobe Experience Manager Desktop-programmet från macOS-programmappen till papperskorgen. Öppna sedan terminalen och kör följande kommando för att ange ditt lösenord när du uppmanas till det.

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

Spara en fil som har checkats ut av andra saving-a-file-checked-out-by-others

Operativsystemets tekniska begränsningar förhindrar att användare får en konsekvent upplevelse när de försöker skriva över en fil som andra har checkat ut. Hur det ser ut varierar beroende på vilket program som används för att redigera den utcheckade filen. Ibland visas ett felmeddelande i programmet som indikerar ett skrivfel eller ett syntaktiskt eller allmänt fel visas. I andra fall visas inget felmeddelande och åtgärden verkar lyckas.

I så fall kan det hända att innehållet inte ändras när du stänger och öppnar filen igen. I vissa program kan dock en säkerhetskopia av filen sparas så att ändringarna kan tillämpas.

Oavsett hur filen fungerar ändras den inte när du checkar in den. Även om en annan version av filen visas synkroniseras inte ändringarna till AEM.

Felsöka problem med att flytta filer troubleshooting-problems-around-moving-files

Server-API:t kräver att ytterligare rubriker, X-Destination, X-Depth och X-Overwrite, skickas för att flytt- och kopieringsåtgärderna ska fungera. Dispatcher skickar inte dessa rubriker som standard, vilket gör att dessa åtgärder misslyckas. Mer information finns i Ansluta till AEM bakom en Dispatcher.

Felsökning AEM anslutningsproblem med stationära datorer troubleshooting-aem-desktop-connection-issues

Omdirigeringsproblem för SAML saml-redirect-issue

Den vanligaste orsaken till problem med AEM Skrivbord som ansluter till en SAML-AEM (SSO-enabled) är att SAML-processen inte dirigerar tillbaka till den ursprungligen begärda sökvägen. Alternativt kan anslutningen dirigeras om till en värd som inte är konfigurerad i AEM skrivbordsapp. Så här verifierar du inloggningsprocessen:

SSL-konfigurationsproblem ssl-configuration-issue

De bibliotek som AEM datorprogrammet använder för HTTP-kommunikation använder strikta SSL-regler. Ibland kan en anslutning fungera med en webbläsare, men det går inte att använda AEM datorprogram. Installera det saknade mellanliggande certifikatet i Apache om du vill konfigurera SSL korrekt. Se Så här installerar du ett mellanliggande CA-certifikat i Apache.

Använda AEM Desktop med Dispatcher using-aem-desktop-with-dispatcher

AEM Desktop fungerar med AEM driftsättningar bakom en Dispatcher, som är standardkonfiguration och som rekommenderas för AEM servrar. AEM som skickas framför AEM redigeringsmiljöer är vanligtvis konfigurerade att hoppa över cachelagring av DAM-resurser. Det innebär att avsändare inte kan tillhandahålla ytterligare cachning från AEM Skrivbord. Se till att Dispatcher-konfigurationen är anpassad för att fungera för AEM skrivbord. Mer information finns i Ansluta till AEM med en Dispatcher.

Söker efter loggfiler checking-for-log-files

Beroende på vilket operativsystem du har kan du hitta loggfilerna för AEM skrivbord på följande platser: