Index Converter is a utility developed to migrate a customer’s Index Definitions in preparation for the move to AEM as a Cloud Service.
The Index Converter allows AEM developers to migrate existing Custom Oak Index Definitions to AEM as a Cloud Service compatible Custom Oak Index Definitions.
Index Converter only transforms lucene type Custom Oak Index Definitions which are present under /apps
or /oak:index
. It does not transform lucene type indexes which are created for nt:base
.
There are two ways to create Custom Oak Index Definitions:
under /apps
(through any custom content package)/oak:index
pathIf Ensure Oak Index was used, please note that Ensure Definitions are not supported on AEM as a Cloud Service, and hence they need to be converted to Oak Index Definitions first and then need to be migrated to Custom Oak Index Definitions that are compatible with AEM as a Cloud Service as per below guidelines:
true
, ignore or skip the Ensure Definitionjcr:primaryType
to oak:QueryIndexDefinition
/facets/jcr:content
from Ensure DefinitionVia Adobe I/O CLI : It is recommended to use the Index Converter via aio-cli-plugin-aem-cloud-service-migration
(AEM as a Cloud Service code refactoring plugin for the Adobe I/O CLI).
Refer to Git Resource: aio-cli-plugin-aem-cloud-service-migration to learn how to install and use the plugin.
As a standalone utility : The Index Converter can also be executed as a standalone utility.
Refer to Git Resource: aem-cs-source-migration-index-converter to learn how to use this tool.