Prerequisites
• You must have new AEM 6.X installation jar
• Create a production Server Replica with similar content and configurations to existing CQ 5.6.1 environment so that you can test the upgrade changes.
• Create a seperate new Code branch for 6.X code.
• Make performance testing scripts ready .
Steps to Upgrade
1. Repository Upgrade
AEM 6.1 doesn't support crx2 and requires content migration to Oak repository.
There are several ways to do it
Package deployment. – If repository volume is not too high (up to 30 GBs), package deployment is the most easy and simple way to migrate content.
Use crx2oak tool - Use this if content volume is high. Will cover steps for this tool in another post. For this post I'll assume that repository migration is done using packages.
2. Cleanup before starting the upgrade
• Backup and delete workflow launchers and sling Jobs - This will prevent workflows and jobs from getting triggered during the upgrade process. Deploy the backup package after the
• Remove version history - This will reduce the number of nodes that needs to be processed during the upgrade.
• Data Store garbage collection- It will reduce the disk space.
Clean up any other unused data from repository.
• Disable custom login modules
3. Java Upgrade
Upgrade to JAVA8 for optimized performance with AEM 6.X
4. Hot fixes
Find the exhaustive list of hotfixes at below links, and install required the hotfixes.
5. Code base changes
Remove deprecated APIs
Check your code base and see if you are using any APIs listed in above links and replace them with their alternative APIs.
Resource resolver API changes – Using admin resolver is deprecated in AEM 6 and we should use Service Resource Resolver API in 6.X to get the session. Below is the link which talks about getting service resource resolver in AEM 6-
6. Indexing
AEM 6 doesn't automatically index the whole content like old versions.
Logs needs to be reviewed for indexing warnings.
Use AEM explain query tool to analyze queries you are using in code base.
Comments
Post a Comment