Felsöka Adobe Experience Manager-datorprogrammet

Adobe Experience Manager datorprogrammet ansluter till en Experience Manager distributionsdatabas för DAM (Digital Asset Management). Appen hämtar databasinformation och sökresultat på din dator, hämtar och överför filer och mappar och innehåller funktioner för att hantera konflikter med Assets-användargränssnittet.

Läs vidare för att felsöka appen, lära dig de bästa metoderna och ta reda på begränsningarna.

God praxis

Följ följande metodtips för att förebygga vissa vanliga problem och felsökning.

  • Lär dig hur datorprogrammet fungerar: Innan du börjar använda programmet bör du ägna en stund åt att veta hur programmet fungerar. Lär dig mer om att länka mellan Experience Manager webbgränssnitt och skrivbord, databasmappning, resurscachning, spara lokalt och överföra i bakgrunden. Se hur det fungerar.

  • Undvik tecken som inte stöds i mappnamn: Använd inte blanksteg eller ogiltiga tecken när du skapar eller överför mappar. Se en lista med tecken på Skapa mappar i Experience Manager Assets. Vissa Experience Manager-användningsfall kan påverkas av tecken som inte stöds i mappnamnet.

  • Bästa tillvägagångssätt för att undvika konflikter: Information om hur du undviker potentiella konflikter när du samarbetar med flera resurser finns i Undvik redigeringskonflikter.

  • Använd mappöverföring för stora, hierarkiska mappar: Använd Experience Manager skrivbordsappen för att överföra stora mappar i stället för att använda Assets-webbgränssnittet eller andra metoder. Programmet överför resurserna i bakgrunden med loggning och övervakning. Se massöverföring av resurser.

  • Använd den senaste versionen: Använd den senaste programversionen och kontrollera alltid om den är kompatibel innan du installerar en ny programversion eller innan du uppgraderar till en nyare Experience Manager version. Se versionsinformation.

  • Använd samma enhetsbeteckning: Använd samma enhetsbeteckning i en organisation för att mappa till Experience Manager DAM. Om du vill visa resurser som placerats av andra användare måste sökvägarna vara desamma. Om du använder samma enhetsbeteckning säkerställs en konstant sökväg till DAM-resurser. Resurserna förblir placerade och tas inte bort även om olika enhetsbeteckningar används av olika användare.

  • Lägg märke till nätverket: Nätverksprestanda är avgörande för Experience Manager datorprogrammets prestanda. Om du får ett långsammare svar på filöverföringar eller större åtgärder inaktiverar du de funktioner eller program som kan orsaka mycket nätverkstrafik.

  • Användningsexempel som inte stöds för datorprogrammet: Använd inte appen för Assets' migrering (den kräver planering och andra verktyg). för krävande DAM-åtgärder (som att flytta stora mappar, stora överföringar, hitta filer med avancerade metadatasökningar), och som en synkroniseringsklient (designprinciper och användningsmönster skiljer sig från synkroniserade klienter som Microsoft OneDrive eller Adobe Creative Cloud desktop sync).

  • Timeout: För närvarande har skrivbordsprogrammet inte något konfigurerbart timeout-värde som kopplar från anslutningen mellan Experience Manager servern 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.

Felsöka

Om du vill felsöka problem med skrivbordsprogram bör du känna till följande information. Ni får också möjlighet att bättre informera Adobe kundsupport om ni väljer att söka support.

Plats för loggfiler

Experience Manager loggfilerna sparas på följande platser beroende på operativsystemet:

I Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs

På Mac: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

Om det inte går att överföra vissa filer läser du i backend.log-filen för att identifiera misslyckade överföringar när du överför många resurser.

OBSERVERA

När du arbetar med Adobe kundsupport på en supportförfrågan eller ett supportärende kan du bli ombedd att dela loggfilerna för att hjälpa kundsupportteamet att förstå problemet. Arkivera hela Logs-mappen och dela den med kundsupportkontakten.

Ändra detaljnivå i loggfiler

Så här ändrar du detaljnivån i loggfiler:

  1. Kontrollera att programmet inte körs.

  2. I Windows:

    1. Öppna ett kommandofönster.

    2. Starta Adobe Experience Manager-datorprogrammet genom att köra kommandot:

    set AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe
    

    På Mac:

    1. Öppna ett terminalfönster.

    2. Starta Adobe Experience Manager-datorprogrammet genom att köra kommandot:

    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app
    

Giltiga loggnivåer är DEBUG, INFO, WARN eller ERROR. Loggarnas utförlighet är högst i DEBUG och lägst i FEL.

Aktivera felsökningsläge

Om du vill felsöka kan du aktivera felsökningsläget och få mer information i loggarna.

OBSERVERA

Giltiga loggnivåer är DEBUG, INFO, WARN och ERROR. Loggarnas utförlighet är högst i DEBUG och lägst i FEL.

Så här använder du programmet i felsökningsläge på Mac:

  1. Öppna ett terminalfönster eller en kommandotolk.

  2. Starta Experience Manager-datorprogrammet genom att köra följande kommando:

    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app.

Så här aktiverar du felsökningsläge i Windows:

  1. Öppna ett kommandofönster.

  2. Starta Experience Manager-datorprogrammet genom att köra följande kommando:

AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe.

Lär dig Adobe Experience Manager-versionen av skrivbordsappen

Så här ser du versionsnumret:

  1. Starta programmet.

  2. Klicka på ellipserna i det övre högra hörnet, hovra över Help och klicka sedan på About.

    Versionsnumret visas på den här skärmen.

Rensa cache

Utför följande steg:

  1. Starta programmet och anslut en Experience Manager-instans.

  2. Öppna programmets inställningar genom att klicka på ellipserna i det övre högra hörnet och välja Preferences.

  3. Leta reda på posten som visar Current Cache Size. Klicka på papperskorgsikonen bredvid det här elementet.

Om du vill rensa cachen manuellt fortsätter du med stegen nedan.

FÖRSIKTIGHET

Detta kan vara en destruktiv åtgärd. Om det finns lokala filändringar som inte har överförts till Adobe Experience Manager, kommer dessa ändringar att gå förlorade om du fortsätter.

Cacheminnet rensas genom att programmets cachekatalog, som finns i programmets inställningar, tas bort.

  1. Starta programmet.

  2. Öppna programmets inställningar genom att markera ellipserna i det övre högra hörnet och välja Preferences.

  3. Observera Cache Directory-värdet.

    I den här katalogen finns det underkataloger som heter efter de kodade slutpunkterna Adobe Experience Manager. Namnen är en kodad version av målwebbadressen Adobe Experience Manager. Om programmet till exempel har localhost:4502 som mål blir katalognamnet localhost_4502.

Om du vill rensa cachen tar du bort den kodade katalogen Adobe Experience Manager Endpoint. Om du tar bort hela katalogen som anges i inställningarna rensas cachen för alla instanser som har använts av programmet.

Att rensa cacheminnet för Adobe Experience Manager-datorprogrammet är en preliminär felsökningsåtgärd som kan lösa flera problem. Rensa cacheminnet från appinställningarna. Se ange inställningar. Standardplatsen för cachemappen är:

Kan inte se placerade resurser

Om du inte kan se de resurser som du eller andra kreatörer har placerat i supportfilerna (till exempel INDD-filer) ska du kontrollera följande:

  • Anslutning till servern. Smidig nätverksanslutning kan stoppa hämtningar av resurser.

  • Filstorlek. Stora resurser tar längre tid att hämta och visa.

  • Enhetliga brev. Om du eller någon annan medarbetare placerade resurserna när de mappade DAM-filen till en annan enhetsbeteckning visas inte de placerade resurserna.Experience Manager

  • Behörigheter. Om du vill kontrollera om du har behörighet att hämta de placerade resurserna kontaktar du Experience Manager-administratören.

Redigeringar av filer i skrivbordsappens användargränssnitt återspeglas inte direkt i Adobe Experience Manager

Adobe Experience Manager när alla redigeringar av en fil är slutförda. Beroende på storleken och komplexiteten hos en fil tar det lång tid att överföra den nya versionen av en fil tillbaka till Adobe Experience Manager. Programdesignen kräver att så många gånger som en fil överförs fram och tillbaka ska minimeras, i stället för att gissa när redigeringarna är klara och överförs automatiskt. Vi rekommenderar att användaren initierar överföringen av filen tillbaka till Adobe Experience Manager genom att välja att överföra en fils ändringar.

Problem vid uppgradering till macOS

Ibland kan problem uppstå när du uppgraderar Experience Manager-datorprogrammet på macOS. Detta orsakas av att det inte går att läsa in nya versioner av Experience Manager-skrivbordsappen korrekt i den äldre systemmappen för Experience Manager. Följande mappar och filer kan tas bort manuellt för att åtgärda problemet.

Innan du utför följande steg drar du Adobe Experience Manager Desktop-programmet från macOS-programmappen till papperskorgen. Öppna sedan terminalen, kör följande kommando och 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

Kan inte överföra filer

Om du använder ett skrivbordsprogram med Experience Manager 6.5.1 eller senare uppgraderar du S3- eller Azure-anslutningen till version 1.10.4 eller senare. Det åtgärdar ett filöverföringsfel relaterat till OAK-8599. Se installationsanvisningar.

Experience Manager anslutningsproblem för skrivbordsprogram

Om du har allmänna anslutningsproblem kan du få mer information om vad Experience Manager-datorprogrammet gör.

Kontrollera begärandeloggen

Experience Manager skrivbordsappen loggar alla begäranden som skickas, tillsammans med varje begärandes svarskod, i en dedikerad loggfil.

  1. Öppna request.log i programmets loggkatalog för att se dessa begäranden.

  2. Varje rad i loggen representerar antingen en begäran eller ett svar. Förfrågningar kommer att ha ett >-tecken följt av den URL som begärdes. Svaren kommer att ha ett <-tecken följt av svarskoden och den URL som begärdes. Begäranden och svar kan matchas med varje rads GUID.

Kontrollera förfrågningar som lästs in av programmets inbäddade webbläsare

En majoritet av programmets begäranden finns i begärandeloggen. Men om det inte finns någon användbar information där kan det vara användbart att undersöka de förfrågningar som skickas av programmets inbäddade webbläsare.
Se SAML-avsnittet för instruktioner om hur du visar dessa begäranden.

SAML-inloggningsautentisering fungerar inte

Experience Manager skrivbordsappen kan inte ansluta till din SSO-aktiverade (SAML) Adobe Experience Manager distribution. Programmets design används för att anpassa variationerna och komplexiteten i SSO-anslutningar och processer. En installation kan dock kräva ytterligare felsökning.

Ibland dirigeras SAML-processen inte tillbaka till den ursprungligen begärda sökvägen, eller så dirigeras den till en annan värd än den som är konfigurerad i Adobe Experience Manager-datorprogrammet. Så här kontrollerar du att så inte är fallet:

  1. Öppna en webbläsare. Åtkomst till URL:en https://[aem_server]:[port]/content/dam.json.

  2. Logga in på Adobe Experience Manager-distributionen.

  3. När inloggningen är klar tittar du på webbläsarens aktuella adress i adressfältet. Den ska exakt matcha den URL som ursprungligen angavs.

  4. Kontrollera också att allt före /content/dam.json matchar det målvärde som konfigurerats i Adobe Experience Manager-inställningarna för skrivbordsappen.Adobe Experience Manager

SAML-inloggningsprocessen fungerar korrekt enligt ovanstående steg, men användarna kan fortfarande inte logga in

Fönstret i Adobe Experience Manager-datorprogrammet som visar inloggningsprocessen är helt enkelt en webbläsare som visar målinstansens webbanvändargränssnitt:Adobe Experience Manager

  • I Mac-versionen används en WebView.

  • I Windows-versionen används Chromium-baserad CefSharp.

Kontrollera att SAML-processen har stöd för dessa webbläsare.

Om du vill felsöka ytterligare kan du visa de exakta URL:er som webbläsaren försöker läsa in. Om du vill se den här informationen:

  1. Följ instruktionerna för att starta programmet i felsökningsläge.

  2. Återskapa inloggningsförsöket.

  3. Navigera till loggkatalogen för programmet

  4. För Windows:

    1. Öppna"aemcompanionlog.txt".

    2. Sök efter meddelanden som börjar med "Inloggningsläsarens adress ändrad till". Dessa poster innehåller även den URL som programmet har läst in.

    För Mac:

    1. com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log, där den ​ersätts med det nummer som finns i det senaste filnamnet.

    2. Sök efter meddelanden som börjar med"inläst bildruta". Dessa poster innehåller även den URL som programmet har läst in.

Om du tittar på den URL-sekvens som läses in kan det hjälpa till att felsöka i SAML:s slut för att avgöra vad som är fel.

SSL-konfigurationsproblem

Biblioteken som Experience Manager-datorprogrammet använder för HTTP-kommunikation använder strikt SSL-kontroll. Ibland kan en anslutning fungera med en webbläsare, men misslyckas med att använda Experience Manager-skrivbordsappen. Installera det saknade mellanliggande certifikatet i Apache om du vill konfigurera SSL korrekt. Se Installera ett mellanliggande CA-certifikat i Apache.

Biblioteken som Experience Manager-datorprogrammet använder för HTTP-kommunikation använder strikt SSL-kontroll. Det kan alltså finnas instanser där SSL-anslutningar som lyckas via en webbläsare misslyckas med Adobe Experience Manager-skrivbordsappen. Detta är bra eftersom det uppmuntrar till korrekt konfigurering av SSL och ökar säkerheten, men det kan vara frustrerande när programmet inte kan ansluta.

I det här fallet rekommenderar vi att du använder ett verktyg för att analysera serverns SSL-certifikat och identifiera problem så att de kan korrigeras. Det finns webbplatser som inspekterar serverns certifikat när de tillhandahåller URL:en.

Som en tillfällig åtgärd är det möjligt att inaktivera strikt SSL-tvång i Adobe Experience Manager-datorprogrammet. Detta är inte en rekommenderad långsiktig lösning eftersom den minskar säkerheten genom att dölja grundorsaken till felaktigt konfigurerad SSL. Så här inaktiverar du strikt tvingande:

  1. Använd valfri redigerare för att redigera programmets JavaScript-konfigurationsfil, som finns (som standard) på följande platser (beroende på operativsystem):

    På Mac: /Applications/Adobe Experience Manager Desktop.app/Contents/Resources/javascript/lib-smb/config.json

    I Windows: C:\Program Files (x86)\Adobe\Adobe Experience Manager Desktop\javascript\config.json

  2. Leta reda på följande avsnitt i filen:

    ...
    "assetRepository": {
        "options": {
    ...
    
  3. Ändra avsnittet genom att lägga till "strictSSL": false enligt följande:

    ...
    "assetRepository": {
        "options": {
            "strictSSL": false,
    ...
    
  4. Spara filen och starta om Adobe Experience Manager-datorprogrammet.

Inloggningsproblem vid växling till en annan server

När du har använt en Experience Manager-server och försöker ändra anslutningen till en annan server, kan inloggningsproblem uppstå. Det beror på att gamla cookies stör den nya autentiseringen. Ett alternativ på huvudmenyn till Clear Cookies hjälper. Logga ut från den aktuella sessionen i appen och välj Clear Cookies innan du fortsätter att ansluta.

Rensa cookies när du byter server

Appen svarar inte

I vissa fall kan programmet inte svara, bara visa en vit skärm eller visa ett fel längst ned i gränssnittet utan några alternativ i gränssnittet. Prova följande i den ordning du vill:

  • Högerklicka på programgränssnittet och klicka på Refresh.
  • Avsluta programmet och öppna det igen.

I båda metoderna startar programmet i rotmappen DAM.

Dölj utgångna resurser

När du bläddrar bland resurser i användargränssnittet Experience Manager visas inte de utgångna resurserna. Administratörer kan göra följande konfiguration för att förhindra att resurser som har gått ut visas, söks och hämtas när de bläddrar bland resurser från skrivbordsappen och Asset Link. Konfigurationen fungerar för alla användare, oavsett administratörsbehörighet.

På denna sida