Een op locatie uitgevoerde upgrade uitvoeren performing-an-in-place-upgrade
Stappen voor upgrade pre-upgrade-steps
Voordat u de upgrade uitvoert, moeten verschillende stappen worden uitgevoerd. Zie Code en aanpassingen bijwerken en Onderhoudstaken vóór upgrade voor meer informatie . Zorg er bovendien voor dat uw systeem voldoet aan de vereisten voor de nieuwe versie van AEM. Zie hoe u de complexiteit van uw upgrade kunt inschatten met behulp van Patroondetector en ook de sectie Upgradebereik en -vereisten van Uw upgrade plannen voor meer informatie .
Migratievereisten migration-prerequisites
-
Minimale vereiste Java-versie: Het migratiehulpprogramma werkt alleen met Java versies 7 en hoger. Voor AEM 6.3 en hoger zijn JRE 8 en IBM JRE 7 en 8 van Oracle de enige ondersteunde versies.
-
Bijgewerkte instantie: Als u een upgrade uitvoert vanaf een versie ouder dan 5,6, zorg ervoor dat u een op zijn plaats verbetering aan AEM 6.0 door de procedure te volgen hebt uitgevoerd die in versie 6.0 van de documentatie van de Verbetering wordt beschreven.
Voorbereiding van het AEM QuickStart-jar-bestand prep-quickstart-file
-
Stop de instantie als deze wordt uitgevoerd.
-
Download het nieuwe AEM jar-bestand en gebruik dit om het oude bestand buiten de
crx-quickstart
map. -
Pak de nieuwe QuickStart-jar uit door deze uit te voeren:
code language-shell java -Xmx4096m -jar aem-quickstart.jar -unpack
Migratie van opslagplaats voor inhoud content-repository-migration
Deze migratie is niet vereist als u een upgrade uitvoert vanaf AEM 6.3. Voor versies ouder dan 6.3, verstrekt Adobe een hulpmiddel dat kan worden gebruikt om de bewaarplaats aan de nieuwe versie van de Tar van het Segment van het Eak in AEM 6.3 te migreren. Deze wordt geleverd als onderdeel van het pakket quickstart en is verplicht voor alle upgrades die TarMK zullen gebruiken. Voor upgrades voor omgevingen die gebruikmaken van MongoMK is geen migratie naar opslagplaats vereist. Voor meer informatie over wat de voordelen van het nieuwe formaat van de Tar van het Segment zijn, zie Veelgestelde vragen over migreren naar eikensegment.
De werkelijke migratie wordt uitgevoerd met het standaard AEM quickstart jar-bestand, uitgevoerd met een nieuw -x crx2oak
die het crx2oak-gereedschap uitvoert om de upgrade te vereenvoudigen en robuuster te maken.
--promote-runmode nosamplecontent
Gebruik de volgende opdracht om te bepalen welke opdracht u moet uitvoeren:
java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>
Wanneer <<YOUR_PROFILE>>
en <<ADDITIONAL_FLAGS>>
worden vervangen door het profiel en de markeringen in de volgende tabel:
Waar:
-
mongo-host
is de IP van de MongoDB-server (bijvoorbeeld 127.0.0.1) -
mongo-port
is de MongoDB-serverpoort (bijvoorbeeld: (27017) -
mongo-database-name
vertegenwoordigt de naam van de database (bijvoorbeeld: auteur)
U kunt extra schakelaars voor de volgende scenario's ook vereisen:
-
Als u de upgrade uitvoert op een Windows-systeem waar Java-geheugentoewijzing niet correct wordt verwerkt, voegt u de opdracht
--disable-mmap
aan het bevel. -
Als u Java 7 gebruikt, voegt u de opdracht
-XX:MaxPermSize=2048m
parameter net na de-Xmx
parameter.
Voor meer instructies over het gebruik van het crx2oak-gereedschap raadpleegt u het dialoogvenster CRX2Oak-migratiehulpmiddel. U kunt indien nodig handmatig een upgrade uitvoeren van de crx2oak-hulplijn door deze handmatig te vervangen door nieuwere versies nadat u de snelstart hebt uitgenomen. De installatiemap van AEM bevindt zich op de volgende locatie: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar
. De nieuwste versie van het CRX2Oak-migratiehulpprogramma kan worden gedownload van de Adobe Repository op: https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/
Als de migratie is voltooid, wordt het gereedschap afgesloten met de afsluitcode nul. Controleer bovendien op WAARSCHUWING- en FOUTberichten in het dialoogvenster upgrade.log
bestand, zich onder crx-quickstart/logs
in de AEM installatiemap, aangezien deze kunnen wijzen op niet-fatale fouten die zich tijdens de migratie hebben voorgedaan.
Controleer de onderstaande configuratiebestanden crx-quickstart/install
map. Als er een migratie nodig was, worden deze aangepast aan de doelopslagplaats.
FileDataStore
is het nieuwe gebrek voor AEM 6.3 installaties, wordt het gebruiken van een externe datastore niet vereist. Terwijl het gebruiken van een externe datastore als beste praktijken voor productielokaties wordt geadviseerd, is het geen eerste vereiste om te bevorderen. Vanwege de complexiteit die al aanwezig is bij de upgrade van AEM, raden we u aan de upgrade uit te voeren zonder een datastore-migratie uit te voeren. Indien gewenst, kan een datastore migratie achteraf als afzonderlijke inspanning worden uitgevoerd.Problemen met migratie oplossen troubleshooting-migration-issues
Sla deze sectie over als u een upgrade uitvoert vanaf 6.3. Hoewel de aangeboden crx2oak-profielen aan de behoeften van de meeste klanten moeten voldoen, zijn er momenten waarop extra parameters nodig zullen zijn. Als u tijdens de migratie een fout tegenkomt, is het mogelijk dat er aspecten van uw omgeving zijn waarvoor aanvullende configuratieopties moeten worden opgegeven. Als dat het geval is, treedt waarschijnlijk de volgende fout op:
Controlepunten worden niet gekopieerd omdat er geen externe datastore is opgegeven. Dit zal ertoe leiden dat de volledige opslagplaats opnieuw aan de eerste start wordt onderworpen. Gebruik —skip-checkpoints om de migratie te dwingen of https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration voor meer informatie te zien.
Om een of andere reden heeft het migratieproces toegang tot binaire bestanden in de datastore nodig en kan het proces niet vinden. Neem de volgende markeringen op in het dialoogvenster <<ADDITIONAL_FLAGS>>
gedeelte van uw migratieopdracht:
Voor S3-datastores:
--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore
Wanneer /path/to/SharedS3DataStore.config
vertegenwoordigt de weg aan uw S3 datastore configuratiedossier en /path/to/datastore
vertegenwoordigt de weg aan uw S3 datastore.
Voor datastores van bestand:
--src-datastore=/path/to/datastore
Wanneer /path/to/datastore
geeft het pad naar uw gegevensopslagruimte voor bestanden aan.
De upgrade uitvoeren performing-the-upgrade
Bij gebruik van S3:
-
Eventuele onderliggende potten verwijderen
crx-quickstart/install
gekoppeld aan een eerdere versie van de S3-connector. -
Download de recentste versie van de 1.8.x S3 schakelaar van https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/
-
Extraheer het pakket naar een tijdelijke map en kopieer de inhoud van
jcr_root/libs/system/install
aan decrx-quickstart/install
map.
Bepaal het correcte bevel van het verbeteringsbegin determining-the-correct-upgrade-start-command
Als u de upgrade wilt uitvoeren, is het belangrijk dat u AEM het jar-bestand gaat gebruiken om de instantie op te roepen. Voor een upgrade naar 6.4 kunt u ook andere opties voor inhoudsherstructurering en migratie bekijken in Lazy Content Migration die u met het verbeteringsbevel kunt kiezen.
Merk op dat het beginnen van AEM van het beginmanuscript niet de verbetering zal beginnen. De meeste klanten beginnen AEM het beginmanuscript te gebruiken en hebben dit beginmanuscript aangepast om schakelaars voor omgevingsconfiguraties zoals geheugenmontages, veiligheidscertificaten, enz. te omvatten. Om deze reden, adviseren wij na deze procedure om het juiste verbeteringsbevel te bepalen:
-
Voer bij een actieve AEM de volgende handelingen uit vanaf de opdrachtregel:
code language-shell ps -ef | grep java
-
Zoek het AEM. Het zal er ongeveer als volgt uitzien:
code language-shell /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties
-
Wijzig het bevel door de weg aan het bestaande kruis te vervangen (
crx-quickstart/app/aem-quickstart*.jar
in dit geval ) met de nieuwe jar die een zusterbeweging is van decrx-quickstart
map. Gebruikend ons vorige bevel als voorbeeld, zou ons bevel zijn:code language-shell /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.4.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
Hierdoor worden alle juiste geheugeninstellingen, aangepaste runmodi en andere omgevingsparameters voor de upgrade toegepast. Nadat de upgrade is voltooid, kan de instantie met het beginscript worden gestart in de toekomst.
Bijgewerkte Codebase implementeren deploy-upgraded-codebase
Zodra het op zijn plaats verbeteringsproces is voltooid, zou de bijgewerkte codebasis moeten worden opgesteld. De stappen voor het bijwerken van de codebasis om in de doelversie van AEM te werken kunnen in Pagina Code en aanpassingen bijwerken.
Controles achteraf en probleemoplossing uitvoeren perform-post-upgrade-check-troubleshooting
Zie Controles en probleemoplossing na upgrade.