DokumentationAEM GuidesDokumentation om AEM Guides

Uppgradera Adobe Experience Manager Guides id224MBE0M0XA

Last update: Wed Nov 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Erfaren
  • Administratör
NOTE
Följ uppgraderingsinstruktionerna för den licensierade versionen av din produkt.

Du kan uppgradera din nuvarande version av Experience Manager Guides till version 4.6.0 Service Pack 1:

  • Om du använder version 4.6.0 kan du uppgradera direkt till 4.6.0 Service Pack 1.
  • Om du använder version 4.4, 4.3.1 eller 4.3.0 måste du uppgradera till version 4.6.0 innan du uppgraderar till 4.6.0 Service Pack 1.
  • Om du använder version 4.2, 4.2.1 (programfix 4.2.1.3), 4.1 eller 4.1.x måste du uppgradera till version 4.4 innan du uppgraderar till version 4.6.0.
  • Om du använder version 4.0 måste du uppgradera till version 4.2 innan du uppgraderar till version 4.3.x.
  • Om du använder version 3.8.5 måste du uppgradera till version 4.0 innan du uppgraderar till version 4.2.
  • Om du har en tidigare version än 3.8.5 kan du läsa mer i avsnittet Uppgradera Experience Manager Guides i den produktspecifika installationsguiden som finns i Adobe Experience Manager Guides Help PDF archive.
NOTE
Du måste installera AEM Service Pack innan du uppgraderar Experience Manager Guides-versionen.

Mer information finns i följande procedurer:

IMPORTANT
Innan du börjar uppgradera bör du göra en fullständig säkerhetskopiering av systemet för att undvika dataförluster.

Uppgradera från version 3.8.5 till version 4.0 id2256DK003E1

Om du använder Experience Manager Guides version 3.8.5 kan du uppgradera till version 4.0 av Experience Manager Guides. Med uppgraderingsfunktionen behöver du inte avinstallera den tidigare versionen av Experience Manager Guides.

Innan du kör processen måste du slutföra vissa uppgifter. I följande delavsnitt får du hjälp att igenom förutsättningarna, skapa rapporter och migreringsprocessen. När du har installerat Experience Manager Guides version 4.0 kan du dessutom anpassa olika konfigurationer enligt kundinställningarna.

NOTE
Denna uppgraderingsprocess gäller endast från version 3.8.5 till version 4.0. Information om hur du uppgraderar från version 3.4 eller senare till 3.8.5 finns i avsnittet Uppgradera Experience Manager Guides i den produktspecifika installationshandboken som finns i Adobe Experience Manager Guides Help PDF archive.

​ ​Förutsättningar​ ​

Innan du påbörjar uppgraderingen av Experience Manager Guides bör du kontrollera att du har:

  1. Granskningskommentarerna i ämnen som är öppna för granskning har importerats.
  2. Alla aktiva granskningar stängdes.
  3. Alla översättningsuppgifter stängdes.
  4. Avinstallera eventuella Experience Manager Guides-snabbkorrigeringar som installerats ovanpå den tidigare versionen (större version eller korrigeringsversion) av Experience Manager Guides.

Innan du installerar version 4.0

Utför följande steg innan du installerar version 4.0:

  1. Kontrollera att Experience Manager Guides är i version 3.8.5.
  2. Hämta uppgraderingsskriptpaketet. Om du vill göra det söker du efter"XML Documentation solution 4.0 Upgrade Package" på Adobe Software Distribution Portal som hämtar en zip-fil.
  3. Överför det här paketet till AEM via Package Manager och installera det här paketet.
  4. När uppgraderingspaketet har installerats kör du skripten nedan i samma ordning och följer instruktionerna:

Kontrollera API:t för uppgraderingskompatibilitet

Detta API är utformat för att utvärdera den aktuella systemstatusen och rapportera om uppgraderingen är möjlig eller inte. Om du vill köra det här skriptet utlöser du slutpunkten nedan:

Slutpunkt
/bin/dxml/upgrade/3xto4x/report
Typ av begäran
GET Du kan använda en webbläsare, där du är inloggad som administratör för AEM.
Förväntat svar
- Om alla nödvändiga noder kan flyttas får du en kontroll som du godkänt.
- Om det finns en nod på målplatsen får du ett relevant fel. Rensa databasen (delete node /var/dxml) och installera om uppgraderingspaketet och utlösa sedan den här slutpunkten igen.
Obs! Detta är inte ett vanligt fel eftersom målplatsen inte används tidigare av 3.x Experience Manager Guides.
- Om det här manuset inte lyckas ska du inte fortsätta och rapportera till ditt kundframgångsteam.

API för systemdatamigrering

Detta API är utformat för att migrera systemdata enligt avsnittet Migreringsmappning.

  1. Kör inte det här skriptet om API:t för kontroll av kompatibilitet misslyckas (fortsätt inte).
  2. När API:t för kontroll av uppgraderingskompatibilitet returneras kan du köra uppgraderingsskriptet.
Slutpunkt
/bin/dxml/upgrade/3xto4x
Typ av begäran
POST Det här skriptet är en POST-förfrågan och ska därför köras via agenter som Postman.
Förväntat svar
- När migreringen är klar kan du installera XML Documentation-lösningen version 4.0.
- Om fel uppstår återställer du till den senaste kontrollpunkten och delar felloggarna med API-utdata till kundens framgångsgrupp.

Migreringsmappning: Ovanstående API migrerar alla data under källplatsen till målplatsen.

Source
Mål
/content/fmdita
/var/dxml
/content/dxml
/var/dxml
/etc/fmdita
/libs/fmdita

Installera version 4.0 id23598G006XA

  1. Installera endast version 4.0 om uppgraderingsstegen lyckades.

  2. Hämta versionspaket 4.0 från Adobe Software Distribution Portal:

    • Om du använder en UUID-version av programvara söker du efter"4.0 UID Release for XML Documentation solution for AEM 6.5".
    • Om du använder en icke-UID-version av programvara söker du efter"4.0 Non-UUID Release for XML Documentation solution for AEM 6.5".
      Överför paketet till den befintliga AEM med CRX Package Manager och installera det.
    note note
    NOTE
    Vänta tills alla systemkomponenter har startats.

  3. Rensa webbläsarcachen när paketet har installerats.

  4. Om en dispatcher har konfigurerats AEM Author-instansen utför du följande steg:

    • Kontrollera att följande hanteras i dispatcherregler:
    • URL-mönstret /home/users/*/preferences är vitlistat.
    • URL-mönstret /libs/cq/security/userinfo.json är inte cachelagrat.

  5. Rensa dispatchercachen (för att rensa alla clientlibs cachelagrade).

Uppgradera till version 4.2 id22A3F500SXA

Uppgradering till version 4.2 beror på vilken version av Experience Manager Guides som är aktuell.

Om du använder version 4.0, 4.1 eller 4.1.x kan du uppgradera direkt till version 4.2.

​ ​Förutsättningar​ ​

Innan du startar uppgraderingsprocessen för Experience Manager Guides 4.2 bör du kontrollera att du har:

  1. Uppgraderat till Experience Manager Guides version 4.0, 4.1 eller 4.1.x.
  2. Alla översättningsuppgifter stängdes.
  3. Loggnivån har ändrats till INFO för klassen com.adobe.fmdita.translationservices.TranslationMapUpgradeScript och loggarna läggs till i en ny loggfil, till exempel logs/translation_upgrade.log.
NOTE
Du bör stänga alla aktiva granskningar. Om granskningsuppgifterna inte stängs när du uppgraderar till 4.2 fortsätter de äldre pågående granskningsuppgifterna att ta användare på de äldre granskningssidorna, och de granskningsuppgifter som skapas efter uppgraderingen visar de senaste uppdateringarna i funktionen.

Installera version 4.2 id2245IK0E0EV

  1. Hämta versionspaket 4.2 från Adobe Software Distribution Portal.

  2. Installera paket för version 4.2.

  3. När du har slutfört paketinstallationen väntar du på följande meddelanden i loggarna:

    Completed the post deployment setup script

    Ovanstående meddelande anger att alla installationssteg är slutförda.

    Om du råkar ut för något av följande felkorrigeringar ska du rapportera dem till ditt kundteam:

    • Fel i installationsskript efter distribution
    • Undantag vid portering av översättnings-MAP
    • Det går inte att portera översättningskarta från v1 till v2 för egenskap

  4. Uppgradera plugin-programmet för syreanslutning som släppts med version 4.2 (vid behov).

  5. Rensa webbläsarcachen när paketet har installerats.

  6. Fortsätt uppgradera anpassningarna enligt anvisningarna i nästa avsnitt.

Efter installationen av version 4.2 id2326F02004K

IMPORTANT
Hi-tech-mallar visas inte på uppgraderad server. Om du vill inkludera hi-tech-mallen på servern kan du kopiera den: Source: /libs/fmdita/pdf/Hi-Tech Destination: /content/dam/dita-templates/pdf

När du har installerat Experience Manager Guides kan du sammanfoga de olika konfigurationer som gäller från den nyinstallerade versionen till din installation.

NOTE
Modellen för dam-update-asset kan anpassas. Om några anpassningar har gjorts måste vi synkronisera anpassningarna och Experience Manager Guides i arbetskopian av modellen.

  1. DAM-uppdateringsarbetsflöde för resurs (Efterbehandlingsändringar):

  2. Öppna URL:

    code language-http 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Välj DAM-uppdateringsarbetsflöde.

  4. Klicka på Redigera.

  5. Om komponenten DXML Post Process Initiator finns kontrollerar du att anpassningarna är synkroniserade.

  6. Om komponenten DXML Post Process Initiator inte finns utför du följande steg för att infoga den:

  7. Klicka på Infoga komponent (Ansvarig för efterbearbetning av Experience Manager Guides som det sista steget i processen).

  8. Konfigurera processsteget med information nedan:

    fliken Allmänt

    Titel: DXML Post Process Initiator

    Beskrivning: Steg för initiering av DXML-efterbearbetning av den ändrade/skapade resursen som utlöser ett snedjobb för DXML-efterbearbetning

    Fliken Process

    • Välj DXML Post Process Initiator i listrutan Process

    • Välj Handler Advance

    • Välj Klar

  9. Klicka på Synkronisera överst till höger när du har slutfört ändringarna. Du får ett meddelande om att åtgärden lyckades.

    note note
    NOTE
    Uppdatera och verifiera att anpassade ändringar och Experience Manager Guides efterbearbetningssteg finns i den slutliga arbetsflödesmodellen.

  10. När DAM-uppdateringsarbetsflödet har validerats kontrollerar du motsvarande startkonfigurationer. Gå till AEM Workflow interface och öppna startkartor.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Sök efter och ändra (om det behövs) till följande två startprogram (som ska vara aktiva) som motsvarar DAM Update Asset workflow:

  11. Startprogrammet för noden har skapats för arbetsflödet DAM Update Asset - för villkoret "jcr:content/jcr:mimeType!=video" ska värdet Globbing vara:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".
    • Startprogram för Nod ändrad för DAM Update Asset workflow - för villkoret jcr:content/jcr:mimeType!=video,
    • Globbing-värdet ska vara:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".

  12. När uppgraderingen är klar kontrollerar du att alla anpassningar/övertäckningar har validerats och uppdaterats så att de matchar den nya programkoden. Nedan följer några exempel:

    • Alla komponenter som överlappas av/libs/fmditor/libsska jämföras med den nya produktkoden och uppdateringar ska göras i överlagrade filer under/i appar.
    • Alla kategorier av klientlib som används från produkten bör granskas för ändringar. Alla åsidosatta konfigurationer (exempel nedan) bör jämföras med de senaste för att få de senaste funktionerna:
    • elementmapping.xml
    • ui_config.json(kan ha angetts i mappprofiler)
    • ändrade com.adobe.fmdita.config.ConfigManager
    • Kontrollera om någon av de anpassade koderna använde några gamla sökvägar (som nämns i avsnittet Migreringsmappning) - ska uppdateras till de nya sökvägarna så att anpassningarna också fungerar som förväntat.

  13. Läs om nya konfigurationer som ingår i den aktuella versionen (kontrollera Versionsinformation) och se om någon funktion påverkas genom att vidta lämpliga åtgärder. Ett exempel kan vara att använda"Förbättrad fil- och versionshantering" som introducerades i version 4.0, som du måste aktivera en konfiguration för.

Steg för att indexera befintligt innehåll så att det använder den nya funktionen för att söka och ersätta:

Utför följande steg för att indexera det befintliga innehållet och använd den nya sök- och ersätt-texten på mappningsnivå:

  • Kör en POST-förfrågan till servern (med korrekt autentisering) - http://<server:port\>/bin/guides/map-find/indexing. (Valfritt: Du kan skicka specifika banor för mappningarna för att indexera dem. Som standard indexeras alla mappningar || Till exempel: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt -

http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(Exempel: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • När jobbet är klart kommer ovanstående GET-förfrågan att svara och ange om några kartor misslyckades. De korrekt indexerade mappningarna kan bekräftas från serverloggarna.

Om uppgraderingsjobbet misslyckas och följande fel visas i felloggen:

"frågan läste eller gick igenom fler än 100000 noder. Bearbetningen avbröts för att undvika att andra uppgifter påverkas."

Detta kan inträffa eftersom indexet inte är korrekt konfigurerat för frågan som används i uppgraderingen. Du kan prova följande lösning:

  1. Lägg till den booleska egenskapen indexNodeName som true i noden i index för damAssetLucene-eken.
    /oak:index/damAssetLucene/indexRules/dam:Asset

  2. Lägg till en ny nod med utdraget name under noden.

    /oak:index/damAssetLucene/indexRules/dam:Asset/properties
    och ange följande egenskaper i noden:

    code language-none 
    name - rep:excerpt
propertyIndex - {Boolean}true
notNullCheckEnabled - {Boolean}true

    Strukturen för damAssetLucene ska se ut ungefär så här:

    code language-none 
    <damAssetLucene compatVersion="{Long}2" async="async, nrt" jcr:primaryType="oak:QueryIndexDefinition" evaluatePathRestrictions="{Boolean}true" type="lucene">
<indexRules jcr:primaryType="nt:unstructured">
  <dam:Asset indexNodeName="{Boolean}true" jcr:primaryType="nt:unstructured">
    <properties jcr:primaryType="nt:unstructured">
      <excerpt name="rep:excerpt" propertyIndex="{Boolean}true" jcr:primaryType="nt:unstructured" notNullCheckEnabled="{Boolean}true"/>
    </properties>
    </dam:Asset>
  </indexRules>
</damAssetLucene>

    (tillsammans med andra befintliga noder och egenskaper)

  3. Indexera om indexvärdet damAssetLucene (genom att ange omindexeringsflaggan som true under
    och vänta tills den är false igen (detta anger att omindexeringen är klar). Observera att det kan ta några timmar beroende på storleken på indexet.

  4. Kör indexeringsskriptet igen genom att utföra föregående steg.

Uppgradera till version 4.2.1 upgrade-version-4-2-1

TIP
Vi rekommenderar att du installerar programfix 4.2.1.3 utöver version 4.2.1.

Uppgradering till version 4.2.1 beror på vilken version av Experience Manager Guides som är aktuell. Om du använder version 4.1, 4.1.x eller 4.2 kan du uppgradera direkt till version 4.2.1.

NOTE
Efterbearbetningen och indexeringen kan ta några timmar. Vi rekommenderar att du startar uppgraderingsprocessen under lågtider.

​ ​Förutsättningar​ ​

Innan du startar uppgraderingsprocessen för Experience Manager Guides 4.2.1 bör du kontrollera att du har:

  1. Uppgraderat till Experience Manager Guides version 4.1, 4.1.x eller 4.2.
  2. Alla översättningsuppgifter stängdes.
  3. Loggnivån har ändrats till INFO för klassen com.adobe.fmdita.translationservices.TranslationMapUpgradeScript och loggarna läggs till i en ny loggfil, till exempel logs/translation_upgrade.log.
NOTE
Du bör stänga alla aktiva granskningar. Om granskningsuppgifterna inte stängs när du uppgraderar till 4.2 fortsätter de äldre pågående granskningsuppgifterna att ta användare på de äldre granskningssidorna, och de granskningsuppgifter som skapas efter uppgraderingen visar de senaste uppdateringarna i funktionen.

Installera version 4.2.1

  1. Hämta versionspaketet 4.2.1 från Adobe Software Distribution Portal.

  2. Installera paket för version 4.2.1.

  3. Du kan välja att HIT-aktivera utlösaren för att starta uppgraderingsjobbet för översättningskartan. Mer information finns i Aktivera utlösare för skript via en server.

  4. När du har slutfört paketinstallationen väntar du på följande meddelanden i loggarna:

    Completed the post deployment setup script

    Ovanstående meddelande anger att alla installationssteg är slutförda.

    Om du råkar ut för något av följande felkorrigeringar ska du rapportera dem till ditt kundteam:

    • Fel i installationsskript efter distribution
    • Undantag vid portering av översättnings-MAP
    • Det går inte att portera översättningskarta från v1 till v2 för egenskap

  5. Uppgradera plugin-programmet för syreanslutning som släppts med version 4.2 (vid behov).

  6. Rensa webbläsarcachen när paketet har installerats.

  7. Fortsätt uppgradera anpassningarna enligt anvisningarna i nästa avsnitt.

Aktivera utlösare för skript via en serverenhet enable-trigger-serverlet

POST:

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

Svar:

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

I ovanstående svar-JSON innehåller nyckeln lockNodePath sökvägen till noden som skapades i databasen som pekar på jobbet som skickats. Den tas automatiskt bort när jobbet är klart, tills dess kan du referera till den här noden för aktuell status för jobbet.

Exempellogg:
Här följer ett exempel på loggar som visas i loggfilen när du har utlöst skriptet.

04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2

Sök efter com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 och com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 innan du fortsätter till nästa steg.

Efter installationen av version 4.2.1

IMPORTANT
Hi-tech-mallar visas inte på uppgraderad server. Om du vill inkludera hi-tech-mallen på servern kan du kopiera den: Source: /libs/fmdita/pdf/Hi-Tech Destination: /content/dam/dita-templates/pdf

När du har installerat Experience Manager Guides kan du sammanfoga de olika konfigurationer som gäller från den nyinstallerade versionen till din installation.

NOTE
Modellen för dam-update-asset kan anpassas. Om några anpassningar har gjorts måste vi synkronisera anpassningarna och Experience Manager Guides i arbetskopian av modellen.

  1. DAM-uppdateringsarbetsflöde för resurs (Efterbehandlingsändringar):

  2. Öppna URL:

    code language-http 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Välj DAM-uppdateringsarbetsflöde.

  4. Klicka på Redigera.

  5. Om komponenten DXML Post Process Initiator finns kontrollerar du att anpassningarna är synkroniserade.

  6. Om komponenten DXML Post Process Initiator inte finns utför du följande steg för att infoga den:

  7. Klicka på Infoga komponent (Ansvarig för efterbearbetning av Experience Manager Guides som det sista steget i processen).

  8. Konfigurera processsteget med information nedan:

    fliken Allmänt

    Titel: DXML Post Process Initiator

    Beskrivning: Steg för initiering av DXML-efterbearbetning av den ändrade/skapade resursen som utlöser ett snedjobb för DXML-efterbearbetning

    Fliken Process

    • Välj DXML Post Process Initiator i listrutan Process

    • Välj Handler Advance

    • Välj Klar

  9. Klicka på Synkronisera överst till höger när du har slutfört ändringarna. Du får ett meddelande om att åtgärden lyckades.

    note note
    NOTE
    Uppdatera och verifiera att anpassade ändringar och Experience Manager Guides efterbearbetningssteg finns i den slutliga arbetsflödesmodellen.

  10. När DAM-uppdateringsarbetsflödet har validerats kontrollerar du motsvarande startkonfigurationer. Gå till AEM Workflow interface och öppna startkartor.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Sök efter och ändra (om det behövs) till följande två startprogram (som ska vara aktiva) som motsvarar DAM Update Asset workflow:

  11. Startprogrammet för noden har skapats för arbetsflödet DAM Update Asset - för villkoret "jcr:content/jcr:mimeType!=video" ska värdet Globbing vara:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".
    • Startfunktionen för Nod ändrad för DAM Update Asset workflow - för villkoret jcr:content/jcr:mimeType!=video. Värdet Globbing ska vara:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".

  12. När uppgraderingen är klar kontrollerar du att alla anpassningar/övertäckningar har validerats och uppdaterats så att de matchar den nya programkoden. Nedan följer några exempel:

    • Alla komponenter som överlappas av/libs/fmditor/libsska jämföras med den nya produktkoden och uppdateringar ska göras i överlagrade filer under/i appar.
    • Alla kategorier av klientlib som används från produkten bör granskas för ändringar. Alla åsidosatta konfigurationer (exempel nedan) bör jämföras med de senaste för att få de senaste funktionerna:
    • elementmapping.xml
    • ui_config.json(kan ha angetts i mappprofiler)
    • ändrade com.adobe.fmdita.config.ConfigManager
    • Kontrollera om någon av de anpassade koderna använde några gamla sökvägar (som nämns i avsnittet Migreringsmappning) - ska uppdateras till de nya sökvägarna så att anpassningarna också fungerar som förväntat.

  13. Läs om nya konfigurationer som ingår i den aktuella versionen (kontrollera Versionsinformation) och se om någon funktion påverkas genom att vidta lämpliga åtgärder. Ett exempel kan vara att använda"Förbättrad fil- och versionshantering" som introducerades i version 4.0, som du måste aktivera en konfiguration för.

Steg för att indexera befintligt innehåll så att det använder den nya funktionen för att söka och ersätta:

Utför följande steg för att indexera det befintliga innehållet och använd den nya sök- och ersätt-texten på mappningsnivå:

  • Kontrollera att indexeringen av damAssetLucene har slutförts. Det kan ta upp till några timmar, beroende på mängden data som finns på servern. Du kan bekräfta att omindexeringen har slutförts genom att kontrollera att fältet för omindexering har värdet false i
    http://<server:port>/oak:index/damAssetLucene. Om du har lagt till anpassningar i damAssetLucene kan du behöva tillämpa dem igen.

  • Kör en POST-förfrågan till servern (med korrekt autentisering) - http://<server:port\>/bin/guides/map-find/indexing. (Valfritt: Du kan skicka specifika banor för mappningarna för att indexera dem. Som standard indexeras alla mappningar || Till exempel: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • Du kan också skicka en rotmapp för att indexera DITA-mappningarna för en viss mapp (och dess undermappar). Exempel: http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test. Observera, att om både sökvägsparametern och rotparametern skickas, beaktas bara sökvägsparametern.

  • API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt - http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(Exempel: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • När jobbet är klart kommer ovanstående GET-förfrågan att svara och ange om några kartor misslyckades. De korrekt indexerade mappningarna kan bekräftas från serverloggarna.

Uppgradera till version 4.3.0 upgrade-version-4-3

Uppgradering till version 4.3.0 beror på vilken version av Experience Manager Guides du har. Om du använder version 4.2 eller 4.2.x kan du uppgradera direkt till version 4.3.0.

NOTE
Efterbearbetningen och indexeringen kan ta några timmar. Vi rekommenderar att du startar uppgraderingsprocessen under lågtider.

​ ​Förutsättningar​ ​

Innan du startar uppgraderingsprocessen för Experience Manager Guides 4.3.0 bör du kontrollera att du har:

  1. Uppgraderat till Experience Manager Guides version 4.2 eller 4.2.x och slutfört respektive installationssteg.
  2. Alla översättningsuppgifter stängdes.

Installera version 4.3.0

  1. Hämta versionspaket 4.3.0 från Adobe Software Distribution Portal.
  2. Installera paket för version 4.3.0.
  3. Rensa webbläsarcachen när paketet har installerats.
  4. Uppgradera filen ui_config.json från fliken XML-redigerarkonfiguration i mappprofilen.

Efter installationen av version 4.3.0

När du har installerat Experience Manager Guides kan du sammanfoga de olika konfigurationer som gäller från den nyinstallerade versionen till din installation.

Steg för att bokföra det befintliga innehållet så att det använder den brutna länkrapporten

Utför följande steg för att efterbearbeta befintligt innehåll och använda den nya brutna länkrapporten:

  1. (Valfritt) Om det finns fler än 100 000 dita-filer i systemet uppdaterar du queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService till ett större värde (vilket värde som helst som är större än antalet resurser, till exempel 200 000) och distribuerar sedan om.

    table 0-row-3 1-row-3
    PID Egenskapsnyckel Egenskapsvärde
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Värde: 200000
    standardvärde: 100000

  2. Kör följande API:er för efterbearbetning av alla filer:

    table 0-row-2 1-row-2 2-row-2
    Slutpunkt /bin/guides/reports/upgrade
    Typ av begäran POST Det här skriptet är en POST-förfrågan och ska därför köras via agenter som Postman.
    Förväntat svar API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt.
    Exempel-URL: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    Slutpunkt /bin/guides/reports/upgrade
    Typ av begäran GET
    Param jobId: Skicka det jobId som togs emot från föregående post-begäran.
    Förväntat svar - När jobbet är klart svarar GET-förfrågan med framgång.
    - Om det uppstår fel kan du dela felloggarna tillsammans med API-utdata med kundens framgångsgrupp.
    Exempel-URL: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  3. Återgå till standardvärdet eller det tidigare befintliga värdet queryLimitReads om du har ändrat det i steg 1.

Uppgradera till version 4.3.1 upgrade-version-4-3-1

Uppgradering till version 4.3.1 beror på vilken version av Experience Manager Guides som är aktuell. Om du använder version 4.3.0, 4.2 eller 4.2.1 kan du uppgradera direkt till version 4.3.1.

NOTE
Efterbearbetningen och indexeringen kan ta några timmar. Vi rekommenderar att du startar uppgraderingsprocessen under lågtider.

​ ​Förutsättningar​ ​

Innan du startar uppgraderingsprocessen för Experience Manager Guides 4.3.1 bör du kontrollera att du har:

  1. Uppgraderat till Experience Manager Guides version 4.3.0, 4.2 eller 4.2.1 och slutfört respektive installationssteg.
  2. (Valfritt) Avslutade alla översättningsuppgifter.
  3. Loggnivån har ändrats till INFO för klassen com.adobe.fmdita.translationservices.TranslationMapUpgradeScript och loggarna läggs till i en ny loggfil, till exempel logs/translation_upgrade.log.

Installera version 4.3.1

  1. Hämta versionspaketet 4.3.1 från Adobe Software Distribution Portal.

  2. Installera paket för version 4.3.1.

  3. Du kan välja att HIT-aktivera utlösaren för att starta uppgraderingsjobbet för översättningskartan. Mer information finns i Aktivera utlösare för skript via en server.

  4. När du har slutfört paketinstallationen väntar du på följande meddelanden i loggarna:

    Completed the post deployment setup script

    Ovanstående meddelande anger att alla installationssteg är slutförda.

    Om du råkar ut för något av följande felkorrigeringar ska du rapportera dem till ditt kundteam:

    • Fel i installationsskript efter distribution
    • Undantag vid portering av översättnings-MAP
    • Det går inte att portera översättningskarta från v1 till v2 för egenskap

  5. Uppgradera plugin-programmet för syreanslutning som släppts med version 4.2 (vid behov).

  6. Rensa webbläsarcachen när paketet har installerats.

  7. Fortsätt uppgradera anpassningarna enligt anvisningarna i nästa avsnitt.

Aktivera utlösare för skript via en serverenhet enable-trigger-serverlet-4-3-1

POST:

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

Svar:

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

I ovanstående svar-JSON innehåller nyckeln lockNodePath sökvägen till noden som skapades i databasen som pekar på jobbet som skickats. Den tas automatiskt bort när jobbet är klart, tills dess kan du referera till den här noden för aktuell status för jobbet.

Exempellogg:
Här följer ett exempel på loggar som visas i loggfilen när du har utlöst skriptet.

04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2

Sök efter com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 och com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 innan du fortsätter till nästa steg.

Efter installationen av version 4.3.1

När du har installerat Experience Manager Guides kan du sammanfoga de olika konfigurationer som gäller från den nyinstallerade versionen till din installation.

NOTE
Modellen för dam-update-asset kan anpassas. Om några anpassningar har gjorts måste vi synkronisera anpassningarna och Experience Manager Guides i arbetskopian av modellen.

  1. DAM-uppdateringsarbetsflöde för resurs (Efterbehandlingsändringar):

  2. Öppna URL:

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Välj DAM-uppdateringsarbetsflöde.

  4. Klicka på Redigera.

  5. Om komponenten DXML Post Process Initiator finns kontrollerar du att anpassningarna är synkroniserade.

  6. Om komponenten DXML Post Process Initiator inte finns utför du följande steg för att infoga den:

  7. Klicka på Infoga komponent (Ansvarig för efterbearbetning av Experience Manager Guides som det sista steget i processen).

  8. Konfigurera processsteget med information nedan:

    fliken Allmänt

    Titel: DXML Post Process Initiator

    Beskrivning: Steg för initiering av DXML-efterbearbetning av den ändrade/skapade resursen som utlöser ett snedjobb för DXML-efterbearbetning

    Fliken Process

    • Välj DXML Post Process Initiator i listrutan Process

    • Välj Handler Advance

    • Välj Klar

  9. Klicka på Synkronisera överst till höger när du har slutfört ändringarna. Du får ett meddelande om att åtgärden lyckades.

    note note
    NOTE
    Uppdatera och verifiera att anpassade ändringar och Experience Manager Guides efterbearbetningssteg finns i den slutliga arbetsflödesmodellen.

  10. När DAM-uppdateringsarbetsflödet har validerats kontrollerar du motsvarande startkonfigurationer. Gå till AEM Workflow interface och öppna startkartor.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Sök efter och ändra (om det behövs) till följande två startprogram (som ska vara aktiva) som motsvarar DAM Update Asset workflow:

  11. Startprogrammet för noden har skapats för arbetsflödet DAM Update Asset - för villkoret "jcr:content/jcr:mimeType!=video" ska värdet Globbing vara:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".
    • Startfunktionen för Nod ändrad för DAM Update Asset workflow - för villkoret jcr:content/jcr:mimeType!=video. Värdet Globbing ska vara:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".

  12. När uppgraderingen är klar kontrollerar du att alla anpassningar/övertäckningar har validerats och uppdaterats så att de matchar den nya programkoden. Nedan följer några exempel:

    • Alla komponenter som överlappas av/libs/fmditor/libsska jämföras med den nya produktkoden och uppdateringar ska göras i överlagrade filer under/i appar.
    • Alla kategorier av klientlib som används från produkten bör granskas för ändringar. Alla åsidosatta konfigurationer (exempel nedan) bör jämföras med de senaste för att få de senaste funktionerna:
    • elementmapping.xml
    • ui_config.json(kan ha angetts i mappprofiler)
    • ändrade com.adobe.fmdita.config.ConfigManager

Steg för indexering av befintligt innehåll

NOTE
Du behöver inte utföra dessa steg om du uppgraderar från 4.3.0 eller 4.2.1.

Utför följande steg för att indexera det befintliga innehållet och använd den nya sök- och ersätt-texten på mappningsnivå:

  • Kör en POST-förfrågan till servern (med korrekt autentisering) - http://<server:port\>/bin/guides/map-find/indexing. (Valfritt: Du kan skicka specifika banor för mappningarna för att indexera dem. Som standard indexeras alla mappningar || Till exempel: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt - http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(Exempel: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • När jobbet är klart kommer ovanstående GET-förfrågan att svara och ange om några kartor misslyckades. De korrekt indexerade mappningarna kan bekräftas från serverloggarna.

Steg för att bokföra det befintliga innehållet så att det använder den brutna länkrapporten

NOTE
Du behöver inte utföra de här stegen om du uppgraderar från 4.3.0

Utför följande steg för att efterbearbeta befintligt innehåll och använda den nya brutna länkrapporten:

  1. (Valfritt) Om det finns fler än 100 000 dita-filer i systemet uppdaterar du queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService till ett större värde (vilket värde som helst som är större än antalet resurser, till exempel 200 000) och distribuerar sedan om.

    table 0-row-3 1-row-3
    PID Egenskapsnyckel Egenskapsvärde
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Värde: 200000
    standardvärde: 100000

  2. Kör följande API:er för efterbearbetning av alla filer:

    table 0-row-2 1-row-2 2-row-2
    Slutpunkt /bin/guides/reports/upgrade
    Typ av begäran POST Det här skriptet är en POST-förfrågan och ska därför köras via agenter som Postman.
    Förväntat svar API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt.
    Exempel-URL: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    Slutpunkt /bin/guides/reports/upgrade
    Typ av begäran GET
    Param jobId: Skicka det jobId som togs emot från föregående post-begäran.
    Förväntat svar - När jobbet är klart svarar GET-förfrågan med framgång.
    - Om det uppstår fel kan du dela felloggarna tillsammans med API-utdata med kundens framgångsgrupp.
    Exempel-URL: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  3. Återgå till standardvärdet eller det tidigare befintliga värdet queryLimitReads om du har ändrat det i steg 1.

Uppgradera till version 4.3.1.5 upgrade-version-4-3-1-5

Uppgradering till version 4.3.1.5 beror på vilken version av Experience Manager Guides som är aktuell. Om du använder version 4.3.1 kan du uppgradera direkt till version 4.3.1.5.

Installera version 4.3.1.5

  1. Hämta versionspaketet 4.3.1.5 från Adobe Software Distribution Portal.

  2. Installera paket för version 4.3.1.5.

  3. Vänta tills installationsprocessen har slutförts.

  4. Fortsätt uppgradera anpassningarna enligt anvisningarna i nästa avsnitt.

Efter installationen av version 4.3.1.5

NOTE
Om du vill använda paketet org.apache.velocity utför du följande steg innan du överför paketet:
  1. Gå till <server>:<port>/system/console/bundles.
  2. Sök efter org.apache.speed.
  3. Avinstallera det sökta paketet.
  4. Installera det hastighetspaket som krävs.

  1. När uppgraderingen är klar kontrollerar du att alla anpassningar/övertäckningar har validerats och uppdaterats så att de matchar den nya programkoden. Nedan följer några exempel:

    • Alla komponenter som överlappas från /libs/fmdita eller /libs ska jämföras med den nya produktkoden och uppdateringar ska göras i överlagrade filer under /apps .
    • Alla kategorier av klientlib som används från produkten bör granskas för ändringar. Alla åsidosatta konfigurationer (exempel nedan) bör jämföras med de senaste för att få de senaste funktionerna:
    • elementmapping.xml
    • ui\_config.json\ (kan ha angetts i mappprofiler)
    • ändrade com.adobe.fmdita.config.ConfigManager

Uppgradera till version 4.4.0 upgrade-version-4-4-0

Uppgradering till version 4.4.0 beror på vilken version av Experience Manager Guides som är aktuell. Om du använder version 4.3.1, 4.3.0, 4.2 eller 4.2.1 (programfix 4.2.1.3) kan du uppgradera direkt till version 4.4.0

NOTE
Efterbearbetningen och indexeringen kan ta några timmar. Vi rekommenderar att du startar uppgraderingsprocessen under lågtider.

​ ​Förutsättningar​ ​

Innan du startar uppgraderingsprocessen för Experience Manager Guides 4.4.0 bör du kontrollera att du har:

  1. Uppgraderad till Experience Manager Guides version 4.3.1, 4.3.0 eller 4.2.1 (programfix 4.2.1.3) och slutförde respektive installationssteg.
  2. (Valfritt) Avslutade alla översättningsuppgifter.
  3. Loggnivån har ändrats till INFO för klassen com.adobe.fmdita.translationservices.TranslationMapUpgradeScript och loggarna läggs till i en ny loggfil, till exempel logs/translation_upgrade.log.

Installera version 4.4.0

  1. Hämta versionspaketet 4.4.0 från Adobe Software Distribution Portal.

  2. Installera paket för version 4.4.0.

  3. Du kan välja att HIT-aktivera utlösaren för att starta uppgraderingsjobbet för översättningskartan. Mer information finns i Aktivera utlösare för skript via en server.

  4. När du har slutfört paketinstallationen väntar du på följande meddelanden i loggarna:

    Completed the post deployment setup script

    Ovanstående meddelande anger att alla installationssteg är slutförda.

    Om du råkar ut för något av följande felkorrigeringar ska du rapportera dem till ditt kundteam:

    • Fel i installationsskript efter distribution
    • Undantag vid portering av översättnings-MAP
    • Det går inte att portera översättningskarta från v1 till v2 för egenskap

  5. Uppgradera plugin-programmet för syreanslutning som släppts med version 4.4.0 (vid behov).

  6. Rensa webbläsarcachen när paketet har installerats.

  7. Fortsätt uppgradera anpassningarna enligt anvisningarna i nästa avsnitt.

Efter installationen av version 4.4.0

När du har installerat Experience Manager Guides kan du sammanfoga de olika konfigurationer som gäller från den nyinstallerade versionen till din installation.

NOTE
Modellen för dam-update-asset kan anpassas. Om några anpassningar har gjorts måste vi synkronisera anpassningarna och Experience Manager Guides i arbetskopian av modellen.

  1. DAM-uppdateringsarbetsflöde för resurs (Efterbehandlingsändringar):

  2. Öppna URL:

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Välj DAM-uppdateringsarbetsflöde.

  4. Klicka på Redigera.

  5. Om komponenten DXML Post Process Initiator finns kontrollerar du att anpassningarna är synkroniserade.

  6. Om komponenten DXML Post Process Initiator inte finns utför du följande steg för att infoga den:

  7. Klicka på Infoga komponent (Ansvarig för efterbearbetning av Experience Manager Guides som det sista steget i processen).

  8. Konfigurera processsteget med information nedan:

    fliken Allmänt

    Titel: DXML Post Process Initiator

    Beskrivning: Steg för initiering av DXML-efterbearbetning av den ändrade/skapade resursen som utlöser ett snedjobb för DXML-efterbearbetning

    Fliken Process

    • Välj DXML Post Process Initiator i listrutan Process

    • Välj Handler Advance

    • Välj Klar

  9. Klicka på Synkronisera överst till höger när du har slutfört ändringarna. Du får ett meddelande om att åtgärden lyckades.

    note note
    NOTE
    Uppdatera och verifiera att anpassade ändringar och Experience Manager Guides efterbearbetningssteg finns i den slutliga arbetsflödesmodellen.

  10. När DAM-uppdateringsarbetsflödet har validerats kontrollerar du motsvarande startkonfigurationer. Gå till AEM Workflow interface och öppna startkartor.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Sök efter och ändra (om det behövs) till följande två startprogram (som ska vara aktiva) som motsvarar DAM Update Asset workflow:

  11. Startprogrammet för noden har skapats för arbetsflödet DAM Update Asset - för villkoret "jcr:content/jcr:mimeType!=video" ska värdet Globbing vara:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".
    • Startfunktionen för Nod ändrad för DAM Update Asset workflow - för villkoret jcr:content/jcr:mimeType!=video. Värdet Globbing ska vara:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".

  12. När uppgraderingen är klar kontrollerar du att alla anpassningar/övertäckningar har validerats och uppdaterats så att de matchar den nya programkoden. Nedan följer några exempel:

    • Alla komponenter som överlappas av/libs/fmditor/libsska jämföras med den nya produktkoden och uppdateringar ska göras i överlagrade filer under/i appar.
    • Alla kategorier av klientlib som används från produkten bör granskas för ändringar. Alla åsidosatta konfigurationer (exempel nedan) bör jämföras med de senaste för att få de senaste funktionerna:
    • elementmapping.xml
    • ui_config.json(kan ha angetts i mappprofiler)
    • ändrade com.adobe.fmdita.config.ConfigManager

  13. Om du har lagt till anpassningar i damAssetLucene kan du behöva använda dem igen. När du har gjort ändringarna anger du reindex som true. Detta indexerar om alla befintliga noder med anpassningarna. När du är klar anges omindexeringsflaggan till false igen. Detta kan ta några timmar beroende på antalet resurser i systemet.

Steg för indexering av befintligt innehåll

NOTE
Du behöver inte utföra dessa steg om du uppgraderar från 4.3.0 eller 4.3.1.

Utför följande steg för att indexera det befintliga innehållet och använd den nya sök- och ersätt-texten på mappningsnivå:

  • Kör en POST-förfrågan till servern (med korrekt autentisering) - http://<server:port\>/bin/guides/map-find/indexing. (Valfritt: Du kan skicka specifika banor för mappningarna för att indexera dem. Som standard indexeras alla mappningar || Till exempel: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt - http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(Exempel: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • När jobbet är klart kommer ovanstående GET-förfrågan att svara och ange om några kartor misslyckades. De korrekt indexerade mappningarna kan bekräftas från serverloggarna.

Steg för att bokföra det befintliga innehållet så att det använder den brutna länkrapporten

NOTE
Du behöver inte utföra dessa steg om du uppgraderar från 4.3.0 eller 4.3.1.

Utför följande steg för att efterbearbeta befintligt innehåll och använda den nya brutna länkrapporten:

  1. (Valfritt) Om det finns fler än 100 000 dita-filer i systemet uppdaterar du queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService till ett större värde (vilket värde som helst som är större än antalet resurser, till exempel 200 000) och distribuerar sedan om.

    table 0-row-3 1-row-3
    PID Egenskapsnyckel Egenskapsvärde
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Värde: 200000
    standardvärde: 100000

  2. Kör följande API:er för efterbearbetning av alla filer:

    table 0-row-2 1-row-2 2-row-2
    Slutpunkt /bin/guides/reports/upgrade
    Typ av begäran POST Det här skriptet är en POST-förfrågan och ska därför köras via agenter som Postman.
    Förväntat svar API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt.
    Exempel-URL: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    Slutpunkt /bin/guides/reports/upgrade
    Typ av begäran GET
    Param jobId: Skicka det jobId som togs emot från föregående post-begäran.
    Förväntat svar - När jobbet är klart svarar GET-förfrågan med framgång.
    - Om det uppstår fel kan du dela felloggarna tillsammans med API-utdata med kundens framgångsgrupp.
    Exempel-URL: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  3. Återgå till standardvärdet eller det tidigare befintliga värdet queryLimitReads om du har ändrat det i steg 1.

Aktivera utlösare för skript via en serverenhet enable-trigger-serverlet-4-4-0

NOTE
Du behöver inte utföra dessa steg om du uppgraderar från 4.3.0 eller 4.3.1.

POST:

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

Svar:

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

I ovanstående svar-JSON innehåller nyckeln lockNodePath sökvägen till noden som skapades i databasen som pekar på jobbet som skickats. Den tas automatiskt bort när jobbet är klart, tills dess kan du referera till den här noden för aktuell status för jobbet.

Sök efter com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 och com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 innan du fortsätter till nästa steg.

NOTE
Du bör kontrollera om noden fortfarande finns och jobbens status.

GET: http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json

Steg som ska hantera 'fmdita rewriter'-konflikten

Experience Manager Guides har en anpassad omskrivarmodul för hantering av länkar som genereras vid korsmappningar (länkar mellan ämnen på två olika kartor).

Om du har en annan anpassad återskrivningsskrivare i kodbasen använder du ett 'order'-värde som är större än 50, eftersom Experience Manager Guides återskrivningsprogram använder 'order' 50. Om du vill åsidosätta detta måste du ange ett värde > 50. Mer information finns i Skriva om utdata.

Under den här uppgraderingen måste du, eftersom värdet 'order' ändras från 1 000 till 50, sammanfoga den befintliga anpassade omskrivaren, om sådan finns, med 'fmdita-rewriter'.

Överordnat ämne: ​ Hämta och installera

Uppgradera till version 4.6.0 upgrade-version-4-6-0

TIP
Vi rekommenderar att du installerar 4.6.0 Service Pack 1 ovanpå version 4.6.0. Uppgraderingsprocessen för version 4.6.0 Service Pack 1 följer samma steg som för version 4.6.0.

Uppgradering till version 4.6.0 beror på vilken version av Experience Manager Guides du har. Om du använder version 4.4.0, 4.3.1, 4.3.0, 4.2 eller 4.2.1 (programfix 4.2.1.3) kan du uppgradera direkt till version 4.6.0.

NOTE
Efterbearbetningen och indexeringen kan ta några timmar. Vi rekommenderar att du startar uppgraderingsprocessen under lågtider.

​ ​Förutsättningar​ ​

Innan du startar uppgraderingsprocessen för Experience Manager Guides 4.6.0 bör du kontrollera att du har:

  1. Uppgraderad till Experience Manager Guides version 4.3.1, 4.3.0 eller 4.2.1 (programfix 4.2.1.3) och slutförde respektive installationssteg.
  2. (Valfritt) Avslutade alla översättningsuppgifter.
  3. Loggnivån har ändrats till INFO för klassen com.adobe.fmdita.translationservices.TranslationMapUpgradeScript och loggarna läggs till i en ny loggfil, till exempel logs/translation_upgrade.log.

Installera version 4.6.0

  1. Hämta versionspaket 4.6.0 från Adobe Software Distribution Portal.

  2. Installera paket för version 4.6.0.

  3. Du kan välja att HIT-aktivera utlösaren för att starta uppgraderingsjobbet för översättningskartan. Mer information finns i Aktivera utlösare för skript via en server.

  4. När du har slutfört paketinstallationen väntar du på följande meddelanden i loggarna:

    Completed the post deployment setup script

    Ovanstående meddelande anger att alla installationssteg är slutförda.

    Om du råkar ut för något av följande felkorrigeringar ska du rapportera dem till ditt kundteam:

    • Fel i installationsskript efter distribution
    • Undantag vid portering av översättnings-MAP
    • Det går inte att portera översättningskarta från v1 till v2 för egenskap

  5. Uppgradera plugin-programmet för syreanslutning som släppts med version 4.6.0 (vid behov).

  6. Rensa webbläsarcachen när paketet har installerats.

Efter installationen av version 4.6.0

När du har installerat Experience Manager Guides kan du sammanfoga de olika konfigurationer som gäller från den nyinstallerade versionen till din installation.

NOTE
Modellen för dam-update-asset kan anpassas. Om några anpassningar har gjorts måste vi synkronisera anpassningarna och Experience Manager Guides i arbetskopian av modellen.

  1. DAM-uppdateringsarbetsflöde för resurs (Efterbehandlingsändringar):

  2. Öppna URL:

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Välj DAM-uppdateringsarbetsflöde.

  4. Klicka på Redigera.

  5. Om komponenten DXML Post Process Initiator finns kontrollerar du att anpassningarna är synkroniserade.

  6. Om komponenten DXML Post Process Initiator inte finns utför du följande steg för att infoga den:

  7. Klicka på Infoga komponent (Ansvarig för efterbearbetning av Experience Manager Guides som det sista steget i processen).

  8. Konfigurera processsteget med information nedan:

    fliken Allmänt

    Titel: DXML Post Process Initiator

    Beskrivning: Steg för initiering av DXML-efterbearbetning av den ändrade/skapade resursen som utlöser ett snedjobb för DXML-efterbearbetning

    Fliken Process

    • Välj DXML Post Process Initiator i listrutan Process

    • Välj Handler Advance

    • Välj Klar

  9. Klicka på Synkronisera överst till höger när du har slutfört ändringarna. Du får ett meddelande om att åtgärden lyckades.

    note note
    NOTE
    Uppdatera och verifiera att anpassade ändringar och Experience Manager Guides efterbearbetningssteg finns i den slutliga arbetsflödesmodellen.

  10. När DAM-uppdateringsarbetsflödet har validerats kontrollerar du motsvarande startkonfigurationer. Gå till AEM Workflow interface och öppna startkartor.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Sök efter och ändra (om det behövs) till följande två startprogram (som ska vara aktiva) som motsvarar DAM Update Asset workflow:

  11. Startprogrammet för noden har skapats för arbetsflödet DAM Update Asset - för villkoret "jcr:content/jcr:mimeType!=video" ska värdet Globbing vara:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".
    • Startfunktionen för Nod ändrad för DAM Update Asset workflow - för villkoret jcr:content/jcr:mimeType!=video. Värdet Globbing ska vara:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList ska ha "event-user-data:changedByWorkflowProcess".

  12. När uppgraderingen är klar kontrollerar du att alla anpassningar/övertäckningar har validerats och uppdaterats så att de matchar den nya programkoden. Nedan följer några exempel:

    • Alla komponenter som överlappas av/libs/fmditor/libsska jämföras med den nya produktkoden och uppdateringar ska göras i överlagrade filer under/i appar.
    • Alla kategorier av klientlib som används från produkten bör granskas för ändringar. Alla åsidosatta konfigurationer (exempel nedan) bör jämföras med de senaste för att få de senaste funktionerna:
    • elementmapping.xml
    • ui_config.json(kan ha angetts i mappprofiler)
    • ändrade com.adobe.fmdita.config.ConfigManager

  13. Om du har lagt till anpassningar i damAssetLucene kan du behöva använda dem igen. När du har gjort ändringarna anger du reindex som true. Detta indexerar om alla befintliga noder med anpassningarna. När du är klar anges omindexeringsflaggan till false igen. Detta kan ta några timmar beroende på antalet resurser i systemet.

Steg för att indexera om Experience Manager Guides-index

  1. Öppna crx/de och navigera till indexsökvägen: /oak:index/guidesAssetProperties

  2. Ange egenskapen reindex som true (false som standard) och klicka på Spara alla.

  3. När omindexeringen är klar ställs egenskapen reindex in på false igen och antalet omindexeringar ökas med 1.

    note note
    NOTE
    Detta kan ta några minuter, beroende på mängden data som finns.

    4. Följ samma steg för andra tillagda eller ändrade index: `guidesBulkActivation`, `guidesPeerLinkIndex` och `guidesKonnectTemplateIndex`.

Steg för indexering av befintligt innehåll

Utför följande steg för att indexera det befintliga innehållet:

  • Kör en POST-förfrågan till servern (med korrekt autentisering) - http://<server:port\>/bin/guides/map-find/indexing. (Valfritt: Du kan skicka specifika sökvägar för mappningarna för att indexera dem. Som standard indexeras alla mappningar || Exempel: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt - http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(till exempel: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678)

  • När jobbet är klart kommer ovanstående GET-förfrågan att svara och ange om några kartor misslyckades. De korrekt indexerade mappningarna kan bekräftas från serverloggarna.

NOTE
Om du använder det anpassade schemat måste du definiera sökvägen för de anpassade DTD- och XSD-filerna catalog.xml i AEM i alternativet Integrera kataloger.

Steg som ska hantera 'fmdita rewriter'-konflikten

Experience Manager Guides har en anpassad omskrivarmodul för hantering av länkar som genereras vid korsmappningar (länkar mellan ämnen på två olika kartor).

Om du har en annan anpassad återskrivningsskrivare i kodbasen använder du ett 'order'-värde som är större än 50, eftersom Experience Manager Guides återskrivningsprogram använder 'order' 50. Om du vill åsidosätta detta måste du ange ett värde > 50. Mer information finns i Skriva om utdata.

Under den här uppgraderingen måste du, eftersom värdet 'order' ändras från 1 000 till 50, sammanfoga den befintliga anpassade omskrivaren, om sådan finns, med 'fmdita-rewriter'.

Överordnat ämne: Hämta och installera

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178