AEM Easy Content Upgrade (AECU)

AECU simplifies content migrations by executing migration scripts during package installation. It is built on top of Groovy Console.

Features:

• GUI to run scripts and see history of runs
• Run mode support
• Fallback scripts in case of errors
• Extension of Groovy Console bindings
• Service API
• Health Checks

Requirements

AECU requires Java 8 and AEM 6.3 or above. Groovy Console can be installed manually if bundle install is not used.

Installation

TODO

Bundle Installation

To simplify installation we provide a bundle package that already includes the Groovy Console. This makes sure there are no compatibility issues.

TODO

Execution of Migration Scripts

TODO

History of Past Runs

TODO

Extension to Groovy Console

TODO

JMX Interface

AECU provides JMX methods for executing scripts and reading the history. You can also check the version here.

Execute

This will execute the given script or folder. If a folder is specified then all files (incl. any subfolders) are executed. AECU will respect runmodes during execution.

Parameters:

• Path: file or folder to execute

GetHistory

Prints the history of the specified last runs.

Parameters:

• Start index: starts with 0 (= latest history entry)
• Count: number of entries to print

GetFiles

This will print all files that are executable for a given path. You can use this to check which scripts of a given folder would be executed.

Parameters:

• Path: file or folder to check

Health Checks

Health checks show you the status of AECU itself and the last migration run. You can access them on the status page. For the status of older runs use AECU's history page.

License

The AC Tool is licensed under the GNU GENERAL PUBLIC LICENSE - v 3.