Onderhoudstaken vóór upgrade pre-upgrade-maintenance-tasks
Voordat u begint met de upgrade, is het belangrijk dat u de volgende onderhoudstaken uitvoert om ervoor te zorgen dat het systeem klaar is en kan worden teruggedraaid als zich problemen voordoen:
- Indexdefinities
- Zorgen voor voldoende schijfruimte
- Volledige back-up van AEM maken
- Het bestand quickstart.properties genereren
- Werkstroom- en controlelogbestanden leegmaken configureren
- De taken vóór de upgrade installeren, configureren en uitvoeren
- Updates verwijderen uit de map /install
- Koude stand-byinstanties stoppen
- Aangepaste geplande taken uitschakelen
- Offline revisie opschonen uitvoeren
- Verzameling van afval uit datastore uitvoeren
- Upgrade het databaseschema indien nodig
- Logbestanden roteren
Indexdefinities index-definitions
Controleer of u de vereiste indexdefinities hebt geïnstalleerd die zijn vrijgegeven met de nieuwste AEM 6.5 Service Pack. (Verwijs naar AEM 6.5 de nota's van de servicepack versievoor meer informatie).
Zorgen voor voldoende schijfruimte ensure-sufficient-disk-space
Zorg dat er voldoende schijfruimte is wanneer u de upgrade uitvoert.
Volledige back-up van AEM maken fully-back-up-aem
Er moet een volledige back-up van AEM worden gemaakt voordat de upgrade wordt gestart. Maak indien van toepassing een back-up van de opslagplaats, de installatie van de toepassing, de datastore en de Mongo-exemplaren. Voor meer informatie bij het steunen van en het herstellen van een instantie van AEM, zie Steun en herstel.
Het bestand quickstart.properties genereren generate-quickstart-properties
Wanneer u AEM start vanuit het jar-bestand, wordt een quickstart.properties
-bestand gegenereerd onder crx-quickstart/conf
. Als AEM in het verleden alleen met het beginscript is gestart, is dit bestand niet aanwezig en mislukt de upgrade. Controleer of dit bestand bestaat en start AEM opnieuw vanuit het jar-bestand als dit niet aanwezig is.
Werkstroom- en controlelogbestanden leegmaken configureren configure-wf-audit-purging
De WorkflowPurgeTask
en com.day.cq.audit.impl.AuditLogMaintenanceTask
taken vereisen afzonderlijke configuraties OSGi en kunnen niet zonder hen werken. Als ze tijdens de uitvoering van een pre-upgrade-taak mislukken, is het ontbreken van configuraties de meest waarschijnlijke reden. Daarom zorg ervoor om configuraties OSGi voor deze taken toe te voegen of hen volledig te verwijderen uit de lijst van pre-verbeteringstaken als u niet wenst om hen in werking te stellen. De documentatie voor het vormen werkschemazuiveringstaken kan bij het Beheer de Instanties van het Werkschemaen de configuratie van de de onderhoudstaak van het controlelogboek kunnen bij het Onderhoud van het Logboek van de Controle in AEM 6worden gevonden.
De taken vóór de upgrade installeren, configureren en uitvoeren install-configure-run-pre-upgrade-tasks
De onderhoudstaken die vóór de upgrade moesten worden uitgevoerd, worden geoptimaliseerd en geautomatiseerd. De optimalisering van het pre-verbeteringsonderhoud laat een verenigde manier toe om deze taken teweeg te brengen en hun resultaat op bestelling te kunnen inspecteren.
Hoe wordt het gebruikt how-to-use-it
De PreUpgradeTasksMBean
component OSGI wordt vooraf geconfigureerd met een lijst van pre-upgrade onderhoudstaken die allemaal tegelijk kunnen worden uitgevoerd. U kunt de taken vormen door de hieronder procedure te volgen:
-
Ga naar de Console van het Web door aan https://serveraddress:serverport/system/console/configMgr te doorbladeren
-
Onderzoek naar "preupgradetasks", dan klik de eerste passende component. De volledige naam van de component is
com.adobe.aem.upgrade.prechecks.mbean.impl.PreUpgradeTasksMBeanImpl
-
Wijzig de lijst met onderhoudstaken die moet worden uitgevoerd zoals hieronder wordt weergegeven:
Hieronder volgt een beschrijving van de uitvoeringsmodus waarvoor elke onderhoudstaak is ontworpen.
Standaardconfiguratie van de health checks vóór de upgrade default-configuration-of-the-pre-upgrade-health-checks
De PreUpgradeTasksMBeanImpl
OSGI-component wordt vooraf geconfigureerd met een lijst met tags die voorafgaand aan de upgrade moeten worden uitgevoerd wanneer de runAllPreUpgradeHealthChecks
-methode wordt aangeroepen:
-
systeem - de markering die door de granietcontroles van de onderhoudsgezondheid wordt gebruikt
-
pre-verbetering - een douanetag die aan alle gezondheidscontroles kon worden toegevoegd die u kunt plaatsen om vóór een verbetering te lopen
MBean Methods
De beheerde boonfunctionaliteit kan worden betreden gebruikend de Console JMX.
U kunt tot MBeans toegang hebben door:
-
Ga naar de Console JMX in https://serveraddress:serverport/system/console/jmx
-
Onderzoek naar PreUpgradeTasks en klik het resultaat
-
Selecteer om het even welke methode van de sectie van Verrichtingen en selecteer aanhalen in het volgende venster.
Hieronder vindt u een lijst met alle beschikbare methoden die door de PreUpgradeTasksMBeanImpl
worden beschreven:
- De JMX-console
- Een externe toepassing die verbinding maakt met JMX
- cURL
Updates verwijderen uit de map /install remove-updates-install-directory
Verwijder alle servicepacks, functiepakketten of hotfixes die via de map crx-quickstart/install
in het lokale bestandssysteem zijn geïmplementeerd. Hierdoor wordt voorkomen dat oude hotfixes en servicepacks onbedoeld boven op de nieuwe AEM-versie worden geïnstalleerd nadat de update is voltooid.
Koude stand-byinstanties stoppen stop-tarmk-coldstandby-instance
Als u TarMK koude stand-by gebruikt, moet u eventuele koude stand-byinstanties stoppen. Dit garandeert een efficiënte manier om online terug te keren als er problemen zijn in de upgrade. Nadat de verbetering met succes heeft voltooid, moeten de koude standby instanties van de promotieprimaire instanties worden herbouwd.
Aangepaste geplande taken uitschakelen disable-custom-scheduled-jobs
Schakel geplande OSGi-taken uit die in uw toepassingscode zijn opgenomen.
Offline revisie opschonen uitvoeren execute-offline-revision-cleanup
Als u TarMK gebruikt, moet u de functie Offline revisie opschonen uitvoeren voordat u de upgrade uitvoert. Hierdoor worden de migratie naar de opslagplaats en de daarop volgende upgradetaken veel sneller uitgevoerd en wordt ervoor gezorgd dat Online revisie-opschoning met succes kan worden uitgevoerd nadat de upgrade is voltooid. Voor informatie bij het in werking stellen van de Opruiming van de Off-line Revisie, zie het Uitvoeren van de Opruiming van de Offline Revisie.
Verzameling van afval uit datastore uitvoeren execute-datastore-garbage-collection
Nadat u de revisie hebt opgeschoond op CRX3-instanties, moet u de afvalverzameling van de datastore uitvoeren om eventuele niet-gerefereerde balken in de gegevensopslag te verwijderen. Voor instructies, zie de documentatie op de Inzameling van het huisvuil van de Opslag van Gegevens.
Logbestanden roteren rotate-log-files
Adobe raadt u aan uw huidige logbestanden te archiveren voordat u begint met de upgrade. Zo kunt u logbestanden tijdens en na de upgrade gemakkelijker controleren en scannen om eventuele problemen op te sporen en op te lossen.