使用CRX2Oak迁移工具

简介

CRX2Oak是一款用于在不同存储库之间迁移数据的工具。

它可用于将基于Apache Jackrabbit 2的旧版CQ数据迁移到Oak，还可用于在Oak存储库之间复制数据。

您可以从以下位置的公共Adobe存储库下载最新版本的crx2oak:
https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

最新版本的更改和修复列表可在CRX2Oak发行说明中找到。

注意

有关Apache Oak和AEM持久性的主要概念的更多信息，请参阅AEM Platform简介。

迁移用例

该工具可用于：

  • 从旧版CQ 5迁移到AEM 6
  • 在多个Oak存储库之间复制数据
  • 在不同Oak MicroKernel实施之间转换数据。

以不同的组合提供了对使用外部Blob存储区（通常称为数据存储区）迁移存储库的支持。 一个可能的迁移路径是从使用外部FileDataStore的CRX2存储库到使用S3DataStore的Oak存储库。

下图说明了CRX2Oak支持的所有可能迁移组合：

chlimage_1-151

功能

在AEM升级期间，会调用CRX2Oak，用户可以在该方式中指定一个预定义的迁移配置文件，以自动重新配置持久性模式。 这称为快速启动模式。

它还可以单独运行，以防需要更多自定义。 但是，请注意，在此模式下，仅对存储库进行更改，需要手动执行AEM的任何其他重新配置。 这称为独立模式。

另一点需要注意的是，在独立模式下使用默认设置时，将只迁移节点存储，并且新存储库将重新使用旧的二进制存储。

自动快速启动模式

自AEM 6.3起，CRX2Oak能够处理用户定义的迁移配置文件，这些迁移配置文件可以配置所有已可用的迁移选项。 这样既具有更高的灵活性，又能够自动配置AEM，这些功能在独立模式下使用时不可用。

要将CRX2Oak切换为快速启动模式，您需要通过以下操作系统环境变量定义AEM安装目录中crx-quickstart文件夹的路径：

对于基于UNIX的系统和macOS:

export SLING_HOME="/path/to/crx-quickstart"

对于Windows:

SET "SLING_HOME=/path/to/crx-quickstart"

恢复支持

迁移可以随时中断，随后可以恢复。

可自定义的升级逻辑

自定义Java逻辑，也可使用CommitHooks实施。 可以实施自定义RepositoryInitializer类，以便使用自定义值初始化存储库。

支持内存映射操作

默认情况下，CRX2Oak还支持内存映射操作。 内存映射可显着提高性能，应尽可能使用。

注意

但请注意，Windows平台不支持内存映射操作。 因此，在Windows上执行迁移时，建议添加​**—disable-mmap**​参数。

内容的选择性迁移

默认情况下，该工具会在"/"路径下迁移整个存储库。 但是，您可以完全控制应迁移的内容。

如果新实例上的内容中有任何部分不是必需的，则可以使用--exclude-path参数排除内容并优化升级过程。

路径合并

如果需要在两个存储库之间复制数据，并且这两个存储库的内容路径不同，则可以在--merge-path参数中定义该数据。 完成此操作后，CRX2Oak将仅将新节点复制到目标存储库，并保留旧节点。

chlimage_1-152

版本支持

默认情况下，AEM将创建每个被修改的节点或页面的版本，并将其存储在存储库中。 然后，可以使用这些版本将页面恢复到较早状态。

但是，即使删除了原始页面，这些版本也永远不会被清除。 在处理已运行很长时间的存储库时，迁移可能需要处理由孤立版本导致的大量冗余数据。

对于这些类型的情况，一个有用的功能是添加--copy-versions参数。 它可用于在迁移或复制存储库期间跳过版本节点。

您还可以通过添加--copy-orphaned-versions=true来选择是否复制孤立的版本。

这两个参数还支持YYYY-MM-DD日期格式，如果您希望在特定日期之前复制版本，则可以使用这两个参数。

chlimage_1-153

开源版本

CRX2Oak的开源版本以oak-upgrade的形式提供。 它支持除以下项之外的所有功能：

  • CRX2支持
  • 迁移配置文件支持
  • 支持自动重新配置AEM

有关更多信息，请参阅Apache文档。

参数

节点存储选项

  • --cache:缓存大小(MB)(默认为 256)

  • --mmap:为区段存储启用内存映射的文件访问

  • --src-password: 源RDB数据库的密码

  • --src-user: 源RDB的用户

  • --user:目标RDB的用户

  • --password:目标RDB的密码。

迁移选项

  • --early-shutdown:在复制节点后和应用提交挂接之前关闭源JCR2存储库

  • --fail-on-error:如果无法从源存储库读取节点，则强制执行迁移失败。

  • --ldap:将LDAP用户从CQ 5.x实例迁移到基于Oak的实例。要使其正常工作，Oak配置中的身份提供程序需要命名为ldap。 有关更多信息，请参阅LDAP文档。

  • --ldap-config: 将此参数与使用多 --ldap 个LDAP服务器进行身份验证的CQ 5.x存储库的参数结合使用。您可以使用它指向CQ 5.x ldap_login.conf或jaas.conf配置文件。 格式为--ldapconfig=path/to/ldap_login.conf。

版本存储选项

  • --copy-orphaned-versions:跳过复制孤立版本。支持的参数包括：true、false和yyyy-mm-dd。 默认为 true.

  • --copy-versions: 复制版本存储。参数：true、false、yyyy-mm-dd。 默认为 true.

路径选项

  • --include-paths: 在复制过程中要包含的路径列表（以逗号分隔）
  • --merge-paths:复制过程中要合并的路径列表（以逗号分隔）
  • --exclude-paths: 在复制过程中要排除的路径列表（以逗号分隔）。

源Blob存储选项

  • --src-datastore: 用作源的数据存储目录 FileDataStore

  • --src-fileblobstore:用作源的数据存储目录 FileBlobStore

  • --src-s3datastore:要用于源的数据存储目录 S3DataStore

  • --src-s3config:源的配置文 S3DataStore件。

目标BlobStore选项

  • --datastore: 用作目标的数据存储目录 FileDataStore

  • --fileblobstore: 用作目标的数据存储目录 FileBlobStore

  • --s3datastore:用于目标的数据存储目录 S3DataStore

  • --s3config:目标的配置文 S3DataStore件。

帮助选项

  • -?, -h, --help: 显示帮助信息。

调试

您还可以为迁移过程启用调试信息，以便对可能在该过程中出现的任何问题进行故障诊断。 根据您希望在以下位置运行工具的模式，您可以以不同方式执行此操作：

CRX2Oak模式 操作
快速启动模式 运行CRX2Oak时，可以将—log-levelTRACE或—log-level DEBUG 选项添加到命令行中。 在此模式下，日志会自动重定向到upgrade.log文件。
独立模式

将—trace选项添加到CRX2Oak命令行，以在标准输出中显示TRACE事件(您需要使用重定向字符自行重定向日志：“>”或“tee”命令以供以后检查)。

其他注意事项

迁移到MongoDB复制副本集时，请确保在与Mongo数据库的所有连接上将WriteConcern参数设置为2。

为此，可以在连接字符串的末尾添加w=2参数，如下所示：

java -Xmx4092m -XX:MaxPermSize=1024m -jar crx2oak.jar crx-quickstart/repository/ mongodb://localhost:27017/aem-author?replicaset=replica1&w=2
注意

有关详细信息，请参阅写关注事项上的MongoDB连接字符串文档。

在此页面上