执行就地升级

注意

本页概述了AEM 6.5的升级过程。如果您的安装已部署到应用程序服务器,请参阅应用程序服务器安装的升级步骤

升级前步骤

在执行升级之前,必须完成几个步骤。 有关更多信息,请参阅升级代码和自定义升级前维护任务。 此外,请确保您的系统满足新版AEM的要求。 请参阅模式检测器如何帮助您评估升级的复杂性,并参阅规划升级中的升级范围和要求部分以了解更多信息。

迁移先决条件

  • 最低必需的Java版本: 迁移工具仅适用于Java版本7及更高版本。请注意,对于AEM 6.3及更高版本,Oracle的JRE 8和IBM的JRE 7和8是唯一受支持的版本。

  • 已升级实例: 如果您从5.6 以前的版本升级,请确保已按照升级文档6.0版中描述的过程,对AEM 6.0执行就地升级。

准备AEM快速入门Jar文件

  1. 如果实例正在运行,请停止该实例。

  2. 下载新的AEM jar文件,然后使用它替换crx-quickstart文件夹外的旧文件。

  3. 通过运行以下命令来解包新的快速入门Jar:

    java -Xmx4096m -jar aem-quickstart.jar -unpack
    

内容存储库迁移

如果您从AEM 6.3升级,则无需进行此迁移。对于低于6.3的版本,Adobe提供了一个工具,可用于将存储库迁移到AEM 6.3中存在的Oak Segment Tar的新版本。该工具作为快速启动包的一部分提供,对于将使用TarMK的任何升级而言,是强制性的。 使用MongoMK的环境的升级不需要存储库迁移。 有关新区段Tar格式的好处的更多信息,请参阅迁移到Oak区段Tar常见问题解答

实际迁移是使用标准AEM快速入门jar文件执行的,该文件使用新的-x crx2oak选项执行,该选项可执行crx2oak工具,以简化升级并使其更加稳健。

注意

如果您使用CRX2Oak快速入门扩展执行TarMK存储库内容迁移,则可以通过向迁移命令行添加以下内容来删除​samplecontent​运行模式:

  • --promote-runmode nosamplecontent

要确定应运行的命令,请使用以下命令:

java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

其中, <<YOUR_PROFILE>><<ADDITIONAL_FLAGS>>被替换为下表中列出的配置文件和标记:

源存储库 目标存储库 个人资料 其他标记
crx2或TarMK与 FileDataStore TarMK segment-fds 请参阅下面的疑难解答部分
crx2 MongoMK mongo-from-crx2 -T mongo-uri=mongo://mongo-host:mongo-port -T mongo-db=mongo-database-name
TarMK或crx2,带 S3DataStore TarMK segment-custom-ds 请参阅下面的疑难解答部分
没有数据存储的TarMK TarMK segment-no-ds
MongoMK MongoMK 无需迁移

其中:

  • mongo-host 是MongoDB服务器IP(例如,127.0.0.1)

  • mongo-port 是MongoDB服务器端口(例如:27017)

  • mongo-database-name 表示数据库的名称(例如:aem-author)

在以下情况下,您可能还需要其他交换机:

  • 如果在Windows系统中Java内存映射处理不正确,则请将--disable-mmap参数添加到命令中。

  • 如果您使用的是Java 7,请在-Xmx参数之后添加-XX:MaxPermSize=2048m参数。

有关使用crx2oak工具的其他说明,请参阅使用CRX2Oak迁移工具。 如果需要,可以手动升级crx2oak帮助程序JAR,方法是在解压缩快速启动程序后将其手动替换为较新版本。 它在AEM安装文件夹中的位置是:<aem-install>/crx-quickstart/opt/extensions/crx2oak.jar。 可以从Adobe存储库下载最新版本的CRX2Oak迁移工具,网址为:https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

如果迁移成功完成,则该工具将退出,退出代码为0。 此外,在位于AEM安装目录crx-quickstart/logs下的upgrade.log文件中检查WARN和ERROR消息,因为这些消息可能指示迁移期间发生的非致命错误。

检查crx-quickstart/install文件夹下的配置文件。 如果需要迁移,将更新这些库以反映目标存储库。

关于数据存储的说明:

虽然FileDataStore是AEM 6.3安装的新默认值,但不需要使用外部数据存储。 虽然建议将外部数据存储用作生产部署的最佳实践,但升级并非先决条件。 由于升级AEM中已存在复杂性,我们建议在不执行数据存储迁移的情况下执行升级。 如果需要,可以在之后作为单独的工作执行数据存储迁移。

迁移问题疑难解答

如果您从6.3升级,请跳过此部分。尽管提供的crx2oak配置文件应满足大多数客户的需求,但有时需要其他参数。 如果您在迁移期间遇到错误,则环境的某些方面可能需要提供其他配置选项。 如果是,您可能会遇到以下错误:

检查点将不会复制,因为未指定外部数据存储。这将导致在首次启动时重新编制完整存储库索引。 使用 — skip-checkpoints强制迁移,或查看https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration以了解更多信息。

由于某些原因,迁移过程需要访问数据存储中的二进制文件,但无法找到它。 要指定数据存储配置,请在迁移命令的<<ADDITIONAL_FLAGS>>部分中包含以下标记:

对于S3数据存储:

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

其中, /path/to/SharedS3DataStore.config表示S3数据存储配置文件的路径, /path/to/datastore表示S3数据存储的路径。

对于文件数据存储:

--src-datastore=/path/to/datastore

其中/path/to/datastore表示文件数据存储的路径。

执行升级

如果使用S3:

  1. 删除与S3连接器早期版本关联的crx-quickstart/install下的任何jar。

  2. https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/下载1.10.x S3连接器的最新版本

  3. 将包解压缩到临时文件夹,并将jcr_root/libs/system/install的内容复制到crx-quickstart/install文件夹。

确定正确的升级开始命令

要执行升级,请务必使用jar文件启动AEM以调出实例。 要升级到6.5,还请在延迟内容迁移中查看其他内容重组和迁移选项,您可以使用升级命令选择这些选项。

重要

如果您运行的是OracleJava 11(或Java的通常版本高于8),则启动AEM时,需要向命令行中添加其他开关。 有关更多信息,请参阅Java 11注意事项

请注意,从开始脚本启动AEM将不会开始升级。 大多数客户都使用开始脚本来启动AEM,并且已自定义此开始脚本,以包含用于环境配置(如内存设置、安全证书等)的交换机。 因此,我们建议遵循以下过程来确定正确的升级命令:

  1. 在运行的AEM实例上,从命令行执行以下操作:

    ps -ef | grep java
    
  2. 查找AEM流程。 它看起来像:

    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties
    
  3. 修改命令,方法是将现有jar(本例中为crx-quickstart/app/aem-quickstart*.jar)的路径替换为crx-quickstart文件夹的同级新jar。 以我们以前的命令为例,我们的命令将为:

    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.5.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
    

    这将确保为升级应用所有正确的内存设置、自定义运行模式和其他环境参数。 升级完成后,可以从将来启动的启动脚本中启动实例。

部署已升级的代码库

完成就地升级过程后,应部署更新的代码库。 有关更新代码库以在AEM目标版本中工作的步骤,请参阅升级代码和自定义页面

执行升级后检查和疑难解答

请参阅升级后检查和疑难解答

在此页面上