Upgrade uitvoeren van Adobe Experience Manager Guides voor versie 4.6.0 en hoger
Dit artikel bevat instructies voor het upgraden van uw Experience Manager Guides-versies voor 4.6.0 en hoger.
U kunt uw huidige versie van Experience Manager Guides upgraden naar versie 5.1.0 Service Pack 3:
- Als u versie 5.1.0 of 5.1.x gebruikt, kunt u rechtstreeks upgraden naar versie 5.1.0 Service Pack 3.
- Als u versie 4.6.0, 4.6.x, 5.0.0, of 5.0.x gebruikt, dan moet u aan versie 5.1.0 bevorderen.
- Als u op een versie voorafgaand aan 4.6.0 bent, verwijs naar Verbetering Adobe Experience Manager Guides voor versie 4.4.0 en vroeger voor gedetailleerde verbeteringsinstructies.
Raadpleeg de volgende procedures voor meer informatie:
Upgrade naar versie 5.1.0
Eerste vereisten
Voordat u het Experience Manager Guides 5.1.0-upgradeproces start, moet u controleren of:
- Bijgewerkt naar Experience Manager Guides versie 4.6.3, 4.6.4, 5.0.0 of 5.0.0 Service Pack 1.
- (Optioneel) Alle vertaaltaken zijn afgesloten.
- Veranderde het logboekniveau in INFO voor
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptklasse en voeg deze logboeken in een nieuw logboekdossier toe, bijvoorbeeld,logs/translation_upgrade.log.
installeer versie 5.1.0
Download het 5.1.0 versiepakket van het Portaal van de Distributie van de Software van Adobe en volg de instructies die in het werkschema van de Installatie en van de post-installatiedesverbetering worden verstrekt om het verbeteringsproces te voltooien.
Upgrade naar versie 5.0.0
Eerste vereisten
Voordat u het Experience Manager Guides 5.0.0-upgradeproces start, moet u controleren of:
- Bijgewerkt naar Experience Manager Guides versie 4.6.3, 4.6.1, 4.6.0 of 4.4.
- (Optioneel) Alle vertaaltaken zijn afgesloten.
- Veranderde het logboekniveau in INFO voor
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptklasse en voeg deze logboeken in een nieuw logboekdossier toe, bijvoorbeeld,logs/translation_upgrade.log.
installeer versie 5.0.0
Download het 5.0.0 versiepakket van het Portaal van de Distributie van de Software van Adobe en volg de instructies die in het werkschema van de Installatie en van de post-installatiedesverbetering worden verstrekt om het verbeteringsproces te voltooien.
Upgrade naar versie 4.6.0
De upgrade naar versie 4.6.0 is afhankelijk van de huidige versie van Experience Manager Guides. Als u versie 4.4.0, 4.3.1, 4.3.0, 4.2 of 4.2.1 (Hotfix 4.2.1.3) gebruikt, kunt u rechtstreeks upgraden naar versie 4.6.0.
Eerste vereisten
Voordat u het Experience Manager Guides 4.6.0-upgradeproces start, moet u controleren of:
- Geüpgraded naar Experience Manager Guides versie 4.3.1, 4.3.0 of 4.2.1 (Hotfix 4.2.1.3).
- (Optioneel) Alle vertaaltaken zijn afgesloten.
- Veranderde het logboekniveau in INFO voor
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptklasse en voeg deze logboeken in een nieuw logboekdossier toe, bijvoorbeeld,logs/translation_upgrade.log.
installeer versie 4.6.0
Download het 4.6.0 versiepakket van het Portaal van de Distributie van de Software van Adobe en volg de instructies die in het werkschema van de Installatie en van de post-installatiedesverbetering worden verstrekt om het verbeteringsproces te voltooien.
Workflow voor installatie en upgrade na installatie
Het versiepakket installeren
Voer de volgende stappen uit om het versiepakket te installeren:
-
Installeer het versiepakket waarop u een upgrade wilt uitvoeren.
-
U kunt ervoor kiezen om op de trigger te drukken om de upgrade-taak voor de vertaalkaart te starten. Voor details, zie trekker van manuscript via een Servlet toelaten.
-
Nadat u de pakketinstallatie hebt voltooid, wacht u op het volgende bericht in de logboeken:
Completed the post deployment setup scriptHet bovenstaande bericht geeft aan dat alle installatiestappen zijn voltooid.
Als u om het even welke volgende fouten ontmoet, rapporteer hen aan uw team van het klantensucces:
- Fout tijdens een setupscript voor implementatie na plaatsing
- Uitzondering tijdens het exporteren van de MAP voor vertaling
- Kan vertaalkaart van v1 naar v2 voor eigenschap niet importeren
-
(Optioneel) Upgrade de insteekmodule Zuurstofconnector die wordt vrijgegeven met de versie die u wilt upgraden naar.
-
Wis de browsercache nadat u het pakket hebt geïnstalleerd.
Na de installatie
Nadat u Experience Manager Guides hebt geïnstalleerd, kunt u de verschillende configuraties samenvoegen die van toepassing zijn vanaf de nieuw geïnstalleerde versie tot aan uw installatie.
DAM het werkschema van de Activa van de Update \ (veranderingen ):
-
URL openen:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html -
Selecteer DAM het werkschema van Activa van de Update.
-
Selecteer uitgeven.
-
Als de component van de Initiator van het Proces van 0} DXML {aanwezig is, zorg ervoor dat de aanpassingen worden gesynchroniseerd.
-
Als de component van de Initiator van het Proces van 0} DXML {ontbreekt, voer de volgende stappen uit om het op te nemen:
-
Selecteer component van het Tussenvoegsel \ (Verantwoordelijk voor Experience Manager Guides post-verwerking als definitieve stap in het proces ).
-
Vorm de stap van het Proces met hieronder details:
Gemeenschappelijke tabel:
-
Titel: DXML de Initiator van het Proces van het Post
-
Beschrijving: De stap van de initiator van het postproces DXML die een slingerbaan voor DXML post-verwerking van het gewijzigde/gecreeerde element zal teweegbrengen
lusje van het Proces
- Selecteer DXML de Initiator van het Proces van het Post van het Proces drop down
- Selecteer de Geavanceerde Behandeling van 0}
- Selecteer Gereed
-
-
-
Selecteer Synchronisatie op het hoogste recht na de voltooiing van de veranderingen. Je ontvangt een melding over succes.
note note NOTE Vernieuw en controleer of de aangepaste wijzigingen en de naverwerkingsstap van Experience Manager Guides aanwezig zijn in het uiteindelijke workflowmodel. -
Zodra DAM het werkschema van de Activa van de Update wordt bevestigd, controleer overeenkomstige lanceringsconfiguraties. Ga hiertoe naar de AEM Workflow-interface en open draagraketten.
code language-http http://localhost:4502/libs/cq/workflow/content/console.htmlVind en breng veranderingen \ (indien nodig ) in de volgende twee lanceerinrichtingen \ (die actief zouden moeten zijn ) die aan DAM het werkschema van de Activa van de Update beantwoorden:
-
Lanceerprogramma voor "Gemaakt Knoop"voor DAM het werkschema van de Activa van de Update - voor voorwaarde
"jcr:content/jcr:mimeType!=video", zou de "het Globaliseren"waarde moeten zijn:code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original- 'excludeList' moet
"event-user-data:changedByWorkflowProcess"hebben. - Lanceerinrichting voor "Gewijzigde Knoop"voor DAM het werkschema van de Activa van de Update - voor voorwaarde "
jcr:content/jcr:mimeType!=video", zou de "het Globaliseren"waarde moeten zijn:
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/originalexcludeListmoet"event-user-data:changedByWorkflowProcess"hebben.
- 'excludeList' moet
-
Nadat de upgrade is voltooid, zorgt u ervoor dat alle aanpassingen/overlays worden gevalideerd en bijgewerkt zodat ze overeenkomen met de nieuwe toepassingscode. Hieronder volgen enkele voorbeelden:
- Componenten die door
/libs/fmditaor/libsshouldworden overschreven, moeten met de nieuwe productcode worden vergeleken en updates moeten worden uitgevoerd in overlaybestanden onder/apps. - Alle
clientlib-categorieën die in het product worden gebruikt, moeten voor wijzigingen worden gecontroleerd. Overschreven configuraties\(examples below\)moeten worden vergeleken met de meest recente configuraties, zodat u de nieuwste functies krijgt: - elementmapping.xml
ui\_config.json\(may have been set in folder profiles\)- modified
com.adobe.fmdita.config.ConfigManager
- Componenten die door
-
Als u aanpassingen hebt toegevoegd in damAssetLucene, kan het nodig zijn deze opnieuw toe te passen. Nadat u deze wijzigingen hebt aangebracht, stelt u de index in op true. Hierdoor worden alle bestaande knooppunten opnieuw gecompileerd met de aanpassingen. Nadat de rendex-markering is voltooid, wordt deze weer op false ingesteld. Dit kan een paar uur duren, afhankelijk van het aantal elementen in het systeem.
Stappen om de Experience Manager Guides-indexen opnieuw te indexeren
-
Open
crx/deen navigeer naar het indexpad:/oak:index/guidesAssetProperties -
Plaats het herindexbezit als
true(falsedoor gebrek) en klik sparen allen. -
Zodra de redex volledig is, wordt de redex-eigenschap opnieuw ingesteld op
falseen wordt de redex-telling met 1 verhoogd.note note NOTE Dit kan een paar minuten duren, afhankelijk van de hoeveelheid gegevens die aanwezig is. 4. Voer dezelfde stappen uit voor andere toegevoegde of gewijzigde indexen: `guidesBulkActivation`, `guidesPeerLinkIndex` en `guidesKonnectTemplateIndex` .
Stappen om de bestaande inhoud te indexeren
Voer de volgende stappen uit om de bestaande inhoud te indexeren:
-
Voer een POST-aanvraag uit op de server (met correcte verificatie) -
http://<server:port\>/bin/guides/map-find/indexing. (Optioneel: u kunt specifieke paden van de kaarten doorgeven om deze te indexeren. Standaard worden alle kaarten geïndexeerd || Voorbeeld:https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>) -
De API retourneert een
jobId. Als u de status van de taak wilt controleren, kunt u een GET-aanvraag met taak-id naar hetzelfde eindpunt verzenden -http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(bijvoorbeeld:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
Zodra de taak is voltooid, reageert het bovenstaande GET-verzoek met succes en vermeldt het of kaarten zijn mislukt. De met succes geïndexeerde kaarten kunnen van de serverlogboeken worden bevestigd.
Stappen voor het afhandelen van het 'fmdita rewriter' -conflict
Experience Manager Guides heeft de module van de a douane die herschrijver voor de behandeling van de verbindingen in het geval van dwars-kaarten (verbindingen tussen de onderwerpen van twee verschillende kaarten) worden geproduceerd.
Als u nog een aangepaste schrijfbewerking voor tekenreeksen in uw codebase hebt, gebruikt u een 'order' -waarde groter dan 50, omdat Experience Manager Guides anders 'order' 50 gebruikt. Als u dit wilt overschrijven, hebt u een waarde > 50 nodig. Voor meer details, mening Output die pijplijnen herschrijft .
Aangezien de waarde van 'order' tijdens deze upgrade is gewijzigd van 1000 in 50, moet u eventueel de bestaande aangepaste rewriter samenvoegen met 'fmdita-rewriter' .
Stappen om de damAssetLucene opnieuw te indexeren
De indexdefinitie is bijgewerkt voor damAssetLucene met AEM Guides. Na bevordering aan de vereiste versie, verwijs naar dit artikel voor het opnieuw indexeren van damAssetLucene.
reindex=true en reindex-async=true for /oak:index/damAssetLucene ) tijdens het volgen van de documentatie tegelijkertijd worden bijgewerkt via de opslagbewerking.