Underhållsaktiviteter före uppgraderingen pre-upgrade-maintenance-tasks

Innan du påbörjar uppgraderingen är det viktigt att du följer dessa underhållsåtgärder för att vara säker på att systemet är klart och kan återställas om det skulle uppstå problem:

Indexdefinitioner index-definitions

Kontrollera att du har installerat de indexdefinitioner som krävs och som släppts med senaste AEM 6.5 Service Pack. (Mer information finns i Versionsinformation för AEM 6.5 Service Pack).

Se till att det finns tillräckligt med diskutrymme ensure-sufficient-disk-space

Kontrollera att det finns tillräckligt med diskutrymme när du kör uppgraderingen.

Fullständig säkerhetskopiering av AEM fully-back-up-aem

AEM bör säkerhetskopieras fullständigt innan uppgraderingen påbörjas. Säkerhetskopiera databasen, programinstallationen, datalagret och Mongo-instanserna om tillämpligt. Mer information om säkerhetskopiering och återställning av en AEM-instans finns i Säkerhetskopiering och återställning.

Generera filen quickstart.properties generate-quickstart-properties

När AEM startas från jar-filen skapas en quickstart.properties-fil under crx-quickstart/conf. Om AEM endast har startats med det tidigare startskriptet finns inte den här filen och uppgraderingen misslyckas. Kontrollera att filen finns och starta om AEM från filen jar om den inte finns.

Konfigurera rensning av arbetsflöde och granskningslogg configure-wf-audit-purging

Aktiviteterna WorkflowPurgeTask och com.day.cq.audit.impl.AuditLogMaintenanceTask kräver separata OSGi-konfigurationer och kan inte fungera utan dem. Om de inte fungerar när en uppgift körs före uppgraderingen är det mest troligt att konfigurationer saknas. Se därför till att du lägger till OSGi-konfigurationer för dessa uppgifter eller tar bort dem helt och hållet från listan över uppgifter som ska optimeras före uppgraderingen om du inte vill köra dem. Dokumentation om hur du konfigurerar rensningsaktiviteter för arbetsflöden finns på Administrera arbetsflödesinstanser och konfigurationen av underhållsaktiviteter för granskningsloggar finns på Underhåll för granskningslogg i AEM 6.

Installera, konfigurera och köra uppgifter före uppgradering install-configure-run-pre-upgrade-tasks

Underhållsuppgifter före uppgradering som tidigare skulle utföras manuellt optimeras och automatiseras. Tack vare underhållsoptimeringen före uppgraderingen kan dessa uppgifter utlösas på ett enhetligt sätt och resultaten kan kontrolleras vid behov.

Så här använder du den how-to-use-it

OSGI-komponenten PreUpgradeTasksMBean levereras förkonfigurerad med en lista över underhållsuppgifter som kan köras alla på en gång. Du kan konfigurera uppgifterna genom att följa proceduren nedan:

Nedan visas en beskrivning av det körläge som varje underhållsåtgärd är avsedd för.

Standardkonfiguration för hälsokontroller före uppgradering default-configuration-of-the-pre-upgrade-health-checks

OSGI-komponenten PreUpgradeTasksMBeanImpl levereras förkonfigurerad med en lista över hälsokontrollstaggar som ska köras före uppgraderingen när runAllPreUpgradeHealthChecks -metoden anropas:

MBean-metoder

Du kan komma åt funktionen för hanterade bönor med hjälp av JMX-konsolen.

Du kan komma åt MBeans genom att:

Nedan visas en lista med alla tillgängliga metoder som PreUpgradeTasksMBeanImpl visar:

Ta bort uppdateringar från katalogen /install remove-updates-install-directory

Ta bort alla Service Pack, funktionspaket eller snabbkorrigeringar som har distribuerats via katalogen crx-quickstart/install i det lokala filsystemet. Detta förhindrar oavsiktlig installation av gamla snabbkorrigeringar och servicepaket ovanpå den nya AEM-versionen när uppdateringen har slutförts.

Stoppa alla väntelägesförekomster i kallt läge stop-tarmk-coldstandby-instance

Om du använder kallstart för TjäraMK ska du stoppa alla kalliga standby-instanser. Detta garanterar ett effektivt sätt att återansluta till Internet om det uppstår problem i uppgraderingen. När uppgraderingen har slutförts måste instanserna i kallt vänteläge återskapas från de uppgraderade primära instanserna.

Inaktivera anpassade schemalagda jobb disable-custom-scheduled-jobs

Inaktivera alla schemalagda OSGi-jobb som ingår i programkoden.

Kör rensning av offlineredigering execute-offline-revision-cleanup

Om du använder tarMK bör du köra Revision Cleanup offline innan du uppgraderar. Detta gör att databasmigreringssteget och efterföljande uppgraderingsuppgifter körs mycket snabbare och hjälper till att säkerställa att rensning av onlineändringar kan utföras korrekt när uppgraderingen har slutförts. Information om hur du kör rensning av offlineredigering finns i Utför rensning av offlineredigering.

Kör skräpinsamling för datastore execute-datastore-garbage-collection

När du har kört revisionsrensning på CRX3-instanser bör du köra Datastore Garbage Collection för att ta bort alla blobbar som inte refereras i datalagret. Instruktioner finns i dokumentationen om skräpinsamlingen för datalagret.

Rotera loggfiler rotate-log-files

Adobe rekommenderar att du arkiverar dina aktuella loggfiler innan du påbörjar uppgraderingen. På så sätt blir det enklare att övervaka och skanna loggfilerna under och efter uppgraderingen för att identifiera och lösa eventuella problem som kan uppstå.