Migrating content deltas using ACS Commons Query Packager
When upgrading or migrating Adobe Experience Manager (AEM), you might need to move only the content that’s changed—like updated tags, assets, or pages. The ACS Commons Query Packager tool helps you package and transfer just those deltas from one AEM instance to another. This guide walks you through the steps to do that efficiently.
Description description
Environment
Adobe Experience Manager (AEM) Managed Services, v6.x
Issue/Symptoms
You need to migrate only the modified content (tags, assets, and pages) between AEM instances—typically during upgrades or final migration steps. Doing this manually is time-consuming and error-prone.
Resolution resolution
-
Install ACS Commons on the source AEM instance.
-
Create a Query Packager page by following the official ACS Commons guide.
-
Set up three separate Query Packager pages using XPath queries—one each for tags, assets, and pages:
code language-none ``` //element(*, cq:Tag)[ @jcr:created > xs:dateTime('YYYY-MM-DDTHH:MM:SS.SSS±HH:MM')] ``` ``` //element(*, dam:AssetContent)[ @jcr:lastModified > xs:dateTime('YYYY-MM-DDTHH:MM:SS.SSS±HH:MM')] ``` ``` //element(*, cq:PageContent)[ @cq:lastModified >= xs:dateTime('YYYY-MM-DDTHH:MM:SS.SSS±HH:MM')] ```
Replace the date and time in each query with the timestamp from which you want to capture content changes.
4. Build the packages in this order: tags first, then assets, and finally pages.
5. Download the packages from the source AEM instance.
6. Upload and install the packages on the target AEM instance in the same order: tags, assets, then pages.