How to choose appropriate crx2oak jar

[this-that-the-otter]

Is there a way to determine which crx2oak-<version>.jar is appropriate for a particular migration?

For example,

if my CRX is: Apache Jackrabbit Oak 1.2.16,

or: Apache Jackrabbit Oak 1.2.31,

or something else, and I want to migrate

out of: everything in tar files

to: blobs in datastore

and destination is the same AEM 6.1 instance - which crx2oak-<version>.jar is best?

I've been using 1.4.6 - but wonder if 1.4.10 or higher provides any benefit?

If I was migrating to 6.2 or 6.3, does this affect the choice?

Is there a method to figure this out?

If so, does the same method also apply to determining which oak-run-<version>.jar file is appropriate for a particular Apache Jackrabbit Oak version?

Thanks!

[Asutosh_Jena_ · Accepted solution]

Hi @this-that-the-otter 

You should always download the latest version and then use it for migration.

Here is the link which talks about the CRX2Oak and the release notes:

https://experienceleague.adobe.com/docs/experience-manager-65/deploying/upgrading/using-crx2oak.html...

https://experienceleague.adobe.com/docs/experience-manager-64/release-notes/crx2oak.html?lang=en

Note: You cannot download any JAR now from public Adobe repository as it'd down from last 2 weeks.

Thanks!

[Vijayalakshmi_S]

Hi @this-that-the-otter,

For oak-run tool, we need to use the version same as that of the oak version of our AEM instance - https://jackrabbit.apache.org/oak/docs/command_line.html

For CRX2OAK tool (tool from Adobe), there is no explicit mention along these lines. You can use the next highest version as that of your Oak version if there is no exact equivalent.

Available list of CRX2OAK versions - https://mvnrepository.com/artifact/com.adobe.granite/crx2oak (which you can download once the Adobe repo is up)

[this-that-the-otter]

@Asutosh_Jena_@Vijayalakshmi_S 

Thank you both for the info and help.The Oak documentation provided by asutosh_jena seems to answer the question about which oak-run-<version>.jar to use - i.e. it should match the Oak version.

My Oak version is 1.2.x (1.2.16, 1.2.26, or 1.2.27). Which is the appropriate crx2oak-<version>.jar?

From what asutosh_jena suggests, it would be crx2oak-1.3.8.jar ...

Vijayalakshmi_S suggests the highest crx2oak-<version>.jar - which looks to be crx2oak-1.10.0.jar ...

The doc linked to by Vijayalakshmi_S  (referring to recent crx2oak versions) appears to suggest it can be used from all prior versions to the most current:

"The tool can be used for:

Migrating from older CQ 5 versions to AEM 6"

I've been using crx2oak-1.4.6.jar based on a ticket with Adobe from 2017(!) when my Oak version was 1.2.26 (highest crx2oak version at the time was crx2oak-1.6.x.jar). This seems to align more closely with what asutosh_jena suggests as far as which crx2oak-<version>.jar to use, though not completely, as the next highest crx2oak-<version>.jar would be crx2oak-1.3.8.jar?

crx2oak-1.4.6.jar seems to work with my current Oak 1.2.27, and I will likely stick with it for now. I'm still testing, but I believe I was able to successfully migrate out of an everything-in-tar-files repo to a tar file + blob (filesystem) datastore repo.