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:

Zorgen voor voldoende schijfruimte ensure-sufficient-disk-space

Bij het uitvoeren van de upgrade moet, naast de activiteiten voor het upgraden van de inhoud en code, een migratie naar de opslagplaats worden uitgevoerd. Tijdens de migratie wordt een kopie van de opslagplaats gemaakt in de nieuwe indeling Segment Tar. Hierdoor hebt u voldoende schijfruimte nodig om een tweede, mogelijk grotere versie van uw opslagplaats te behouden.

Volledige back-up AEM 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. Zie voor meer informatie over het maken van back-ups en het herstellen van een AEM Back-up en herstel.

Back-up maken van wijzigingen in /etc backup-changes-etc

Het verbeteringsproces doet een goede baan om bestaande inhoud en configuraties van onder te handhaven en samen te voegen /apps en /libs paden in de repository. Voor wijzigingen in de /etc De weg, met inbegrip van de configuraties van de Hub van de Context, is het vaak noodzakelijk om deze veranderingen na de verbetering opnieuw toe te passen. Terwijl de upgrade een reservekopie maakt van alle wijzigingen die de upgrade niet kan samenvoegen /varAdobe raadt u aan om vóór de upgrade handmatig een back-up van deze wijzigingen te maken.

Het bestand quickstart.properties genereren generate-quickstart-properties

Wanneer AEM wordt gestart vanuit het jar-bestand, wordt een quickstart.properties bestand wordt 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 vanaf 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 de 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. Documentatie voor het configureren van taken voor werkstroomzuivering vindt u op Workflowinstanties beheren en de configuratie van de de onderhoudstaak van het controlelogboek kan worden gevonden bij Onderhoud controlelogbestand in AEM 6.

Voor werkstroom- en auditlogbestandzuivering op CQ 5.6 en controle van logboeken op AEM 6.0 raadpleegt u Werkstroom en controleknooppunten wissen.

De taken vóór de upgrade installeren, configureren en uitvoeren install-configure-run-pre-upgrade-tasks

Vanwege de mate van aanpassing die AEM toestaat, passen omgevingen gewoonlijk niet op dezelfde manier upgrades uit. Als zodanig is het moeilijk om een gestandaardiseerde procedure voor upgrades in te voeren.

In vorige versies was het ook moeilijk voor AEM upgrades die zijn gestopt of die niet veilig zijn hervat. Dit leidde tot situaties waarin het opnieuw opstarten van de volledige upgradeprocedure noodzakelijk was of waarin defecte upgrades werden uitgevoerd zonder dat dit tot waarschuwingen leidde.

Om deze kwesties te behandelen, heeft de Adobe verscheidene verhogingen aan het verbeteringsproces toegevoegd, die het veerkrachtiger en gebruikersvriendelijker maken. De onderhoudstaken die vóór de upgrade moesten worden uitgevoerd, worden geoptimaliseerd en geautomatiseerd. Ook zijn er ná de upgrade-rapporten toegevoegd, zodat het proces volledig kan worden onderzocht in de hoop dat eventuele problemen gemakkelijker kunnen worden gevonden.

Onderhoudstaken vóór de upgrade worden momenteel verspreid over verschillende interfaces die gedeeltelijk of volledig handmatig worden uitgevoerd. De pre-verbeterings onderhoudsoptimalisering die in AEM 6.3 wordt geïntroduceerd laat een verenigde manier toe om deze taken teweeg te brengen en hun resultaat op bestelling te kunnen inspecteren.

Alle taken die zijn opgenomen in de optimaliseringsstap vóór de upgrade zijn compatibel met alle versies vanaf AEM 6.0.

Procedure voor instellen how-to-set-it-up

In AEM 6.3 en later worden de optimalisatietaken voor het onderhoud van de upgrade opgenomen in de snelstartjar.

Hoe wordt het gebruikt how-to-use-it

De PreUpgradeTasksMBean De component OSGI komt vooraf gevormd met een lijst van pre-verbeterings onderhoudstaken die allen in één keer kunnen worden in werking gesteld. U kunt de taken vormen door de hieronder procedure te volgen:

  1. Ga naar de webconsole door naar https://serveraddress:serverport/system/console/configMgr

  2. Zoeken naar "preupgradetoestellen", klikt u op de eerste overeenkomende component. De volledige naam van de component is com.adobe.aem.upgrade.prechecks.mbean.impl.PreUpgradeTasksMBeanImpl

  3. Wijzig de lijst met onderhoudstaken die moet worden uitgevoerd zoals hieronder wordt weergegeven:

    1487758925984

De takenlijst verschilt afhankelijk van de uitvoeringsmodus die wordt gebruikt om de instantie te starten. Hieronder volgt een beschrijving van de uitvoeringsmodus waarvoor elke onderhoudstaak is ontworpen.

Taak
Run-modus
Notities
TarIndexMergeTask
crx2
DataStoreGarbageCollectionTask
crx2
Voert markering en vegen uit. Voor gedeelde datastores verwijdert u deze stap en voert u deze uit
exemplaren handmatig of op de juiste manier voorbereiden voordat deze worden uitgevoerd.
ConsistencyCheckTask
crx2
WorkflowPurgeTask
crx2/crx3
Moet de Configuratie OSGi van de Opschoonmachine van de Werkstroom van de Adobe vormen Granite alvorens te lopen.
GenerateBundlesListFileTask
crx2/crx3
RevisionCleanupTask
crx3
Voor instanties TarMK op AEM 6.0 tot 6.2, stel in plaats daarvan manueel Off-line de Correctie van de Revisie in werking.
com.day.cq.audit.impl.AuditLogMaintenanceTask
crx3
Moet de configuratie vormen van OSGi van de Planner van de Woorden van het Logboek van de Controle alvorens in werking te stellen.
CAUTION
De DataStoreGarbageCollectionTask roept een verrichting van de Inzameling van de Schrapping Datastore met het teken en de slagfase indien gebruikt. Voor plaatsingen die een gedeelde datastore gebruiken, zorg ervoor of het behoorlijk opnieuw vormt of de instantie voorbereidt om schrapping van punten te vermijden die door een andere instantie van verwijzingen worden voorzien. Voor dit proces kan het nodig zijn de markeringsfase handmatig op alle instanties uit te voeren voordat deze pre-upgradetaak wordt geactiveerd.

Standaardconfiguratie van de health checks vóór de upgrade default-configuration-of-the-pre-upgrade-health-checks

De PreUpgradeTasksMBeanImpl De component OSGI wordt vooraf geconfigureerd met een lijst van labels voor de health check die vóór de upgrade moeten worden uitgevoerd wanneer de component runAllPreUpgradeHealthChecks methode wordt aangeroepen:

  • systeem - het label dat wordt gebruikt bij de gezondheidscontroles van het granietonderhoud

  • pre-upgrade - een aangepaste tag die kan worden toegevoegd aan alle gezondheidscontroles die u kunt instellen voor uitvoering vóór een upgrade

De lijst kan worden bewerkt. U kunt de plus gebruiken (+) en minus (-) naast de tags om meer aangepaste tags toe te voegen of om de standaardtags te verwijderen.

MBean-methoden

De beheerde boonfunctionaliteit kan worden betreden gebruikend JMX-console.

U kunt tot MBeans toegang hebben door:

  1. Ga naar de JMX-console op https://serveraddress:serverport/system/console/jmx

  2. Zoeken naar PreUpgradeTasks en klik op het resultaat

  3. Selecteer een methode in het menu Bewerkingen en selecteert u Invoeden in het volgende venster.

Hieronder volgt een lijst met alle beschikbare methoden die PreUpgradeTasksMBeanImpl wordt getoond:

Naam methode
Type
Beschrijving
getAvailablePreUpgradeTasksNames()
INFO
Hiermee geeft u de lijst met beschikbare namen voor preupgradeonderhoudstaken weer.
getAvailablePreUpgradeHealthChecksTagNames()
INFO
Hiermee geeft u de lijst met labelnamen voor aan de upgrade voorafgaande gezondheidscontroles weer.
runAllPreUpgradeTasks()
ACTIE
Voert alle preupgradeonderhoudstaken in de lijst uit.
runPreUpgradeTask(preUpgradeTaskName)
ACTIE
Hiermee wordt de onderhoudstaak vóór de upgrade uitgevoerd met de naam die als parameter is opgegeven.
isRunAllPreUpgradeTaskRunning()
ACTION_INFO
Controleert of de runAllPreUpgradeTasksmaintenance taak wordt uitgevoerd.
getAnyPreUpgradeTaskRunning()
ACTION_INFO
Controleert of een preupgrade-onderhoudstaak wordt uitgevoerd en
retourneert een array die de namen bevat van taken die momenteel worden uitgevoerd.
getPreUpgradeTaskLastRunTime(preUpgradeTaskName)
ACTIE
Toont de nauwkeurige lopende tijd van de pre-verbeterings onderhoudstaak met de naam die als parameter wordt gegeven.
getPreUpgradeTaskLastRunState(preUpgradeTaskName)
ACTIE
Toont de laatste lopende staat van de pre-verbeterings onderhoudstaak met de naam die als parameter wordt gegeven.
runAllPreUpgradeHealthChecks(shutDownOnSuccess)
ACTIE

Voert alle controles van de pre-verbeteringsgezondheid uit en bewaart hun status in een dossier genoemd preUpgradeHCStatus.properties dat ligt in het sling home path . Als de shutDownOnSuccess parameter is ingesteld op true, wordt de AEM afgesloten, maar alleen als alle gezondheidscontroles vóór de upgrade de status OK hebben.

Het eigenschappenbestand wordt gebruikt als voorwaarde voor een toekomstige upgrade
en het upgradeproces wordt gestopt als de health check vóór de upgrade wordt uitgevoerd
uitvoering is mislukt. Als u het resultaat van de upgrade wilt negeren
controles op de gezondheid en de upgrade toch starten, kunt u het bestand verwijderen.

detectUsageOfUnavailableAPI(aemVersion)
ACTIE
Hiermee geeft u alle geïmporteerde pakketten weer die niet meer tevreden zijn wanneer
upgrade uitvoeren naar de opgegeven AEM. De AEM versie moet
gegeven als parameter.
NOTE
De methodes MBean kunnen worden aangehaald via:
  • De JMX-console
  • Een externe toepassing die verbinding maakt met JMX
  • cURL

Aangepaste aanmeldingsmodules uitschakelen disable-custom-login-modules

NOTE
Deze stap is alleen vereist als u een upgrade uitvoert vanaf een versie van AEM 5. Het kan volledig voor verbeteringen van oudere AEM 6 versies worden overgeslagen.

De manier van aanpassen LoginModules zijn geconfigureerd voor verificatie op het niveau van de gegevensopslagruimte is fundamenteel gewijzigd in Apache Oak.

In AEM versies die de configuratie gebruiken CRX2 werd geplaatst in repository.xml bestand, terwijl vanaf AEM 6 dit gebeurt in de service Configuratie van Apache Felix JAAS via de webconsole.

Daarom moeten bestaande configuraties na de upgrade worden uitgeschakeld en opnieuw worden gemaakt voor Apache Oak.

Om de douanemodules onbruikbaar te maken die in de configuratie JAAS van repository.xml, moet u de configuratie uitgeven om het gebrek te gebruiken LoginModule, zoals in het volgende voorbeeld:

<Security >
             ....
          <!--
                 Use LoginModule authenticating against repository itself
                 -->
                 <LoginModule class = "com.day.crx.core.CRXLoginModule" >
                     <param name = "anonymousId" value = "anonymous" />
                     <param name = "adminId" value ="admin" />
                     <param name = "disableNTLMAuth" value = "true" />
                     <param name = "tokenExpiration" value = "43200000" />
                     <!-- param name="trust_credentials_attribute" value="d5b9167e95dad6e7d3b5d6fa8df48af8"/
                -->
                 </LoginModule >
         </ Security>
NOTE
Zie voor meer informatie Verificatie met de externe aanmeldingsmodule.
Voor een voorbeeld van LoginModule configuratie in AEM 6, zie LDAP configureren met AEM 6.

Updates verwijderen uit de map /install remove-updates-install-directory

NOTE
Verwijder alleen pakketten uit de map crx-quickstart/install NA het afsluiten van de AEM. Deze stap is één van het laatste alvorens de op zijn plaats verbeteringsprocedure te beginnen.

Verwijder om het even welke de dienstpakken, eigenschapspakken, of hotfixes die door crx-quickstart/install op het lokale bestandssysteem. Hierdoor wordt voorkomen dat oude hotfixes en servicepacks onbedoeld boven op de nieuwe AEM 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

NOTE
Deze stap is alleen nodig voor TarMK-installaties

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 over het uitvoeren van Offline Revision Cleanup raadpleegt u Offline revisie opschonen uitvoeren.

Verzameling van afval uit datastore uitvoeren execute-datastore-garbage-collection

NOTE
Deze stap is alleen nodig voor instanties met crx3

Na het runnen van revisie schoonmaakbeurt op CRX3 instanties, zou u de Inzameling van het huisvuil van de Datastore moeten in werking stellen om het even welke niet referenced vlekken in de gegevensopslag te verwijderen. Zie de documentatie over Opruimverzameling gegevensopslag.

Upgrade het databaseschema indien nodig upgrade-the-database-schema-if-needed

Gewoonlijk zorgt de onderliggende Apache Oak-stapel die AEM gebruikt voor persistentie ervoor dat het databaseschema wordt bijgewerkt, indien nodig.

Er kunnen zich echter gevallen voordoen wanneer het schema niet automatisch kan worden bijgewerkt. Dergelijke gevallen zijn meestal omgevingen met hoge beveiliging waarin de database wordt uitgevoerd onder een gebruiker met beperkte rechten. Als een dergelijke situatie voorkomt, blijft AEM het oude schema gebruiken.

Om zulk een scenario te verhinderen te gebeuren, bevorder het schema door het volgende te doen:

  1. Sluit de AEM instantie die moet worden bijgewerkt.

  2. Upgrade het databaseschema. Raadpleeg de documentatie bij het databasetype om te zien welke gereedschappen nodig zijn om het resultaat te bereiken.

    Voor meer informatie over hoe het Eak schemaverbeteringen behandelt, zie deze pagina op de Apache-website.

  3. Ga verder met het upgraden van AEM.

Gebruikers verwijderen die de upgrade mogelijk kunnen blokkeren delete-users-that-might-hinder-the-upgrade

NOTE
Deze onderhoudstaak voorafgaand aan de upgrade is alleen nodig als:
  • U voert een upgrade uit vanaf AEM oudere versies dan AEM 6.3
  • Tijdens de upgrade worden de hieronder vermelde fouten aangetroffen.

In uitzonderlijke gevallen kunnen servicegebruikers in een oudere versie van AEM niet correct zijn gecodeerd als normale gebruikers.

Als een dergelijke situatie gebeurt, ontbreekt de verbetering met een bericht als het volgende:

ERROR [Apache Sling Repository Startup Thread] com.adobe.granite.repository.impl.SlingRepositoryManager Exception in a SlingRepositoryInitializer, SlingRepository service registration aborted
java.lang.RuntimeException: Unable to create service user [communities-utility-reader]:java.lang.RuntimeException: Existing user communities-utility-reader is not a service user.

U kunt dit probleem omzeilen door het volgende te doen:

  1. De instantie loskoppelen van het productieverkeer

  2. Maak een back-up van een of meer gebruikers die het probleem veroorzaken. U kunt deze taak uitvoeren via Package Manager. Zie voor meer informatie Hoe te met Pakketten werken.

  3. Verwijder een of meer gebruikers die het probleem veroorzaken. Hieronder volgt een lijst met gebruikers die mogelijk onder deze categorie vallen:

    1. dynamic-media-replication
    2. communities-ugc-writer
    3. communities-utility-reader
    4. communities-user-admin
    5. oauthservice
    6. sling-scripting

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.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2