Show Menu
主题×

执行就地升级

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

升级前步骤

执行升级之前,必须完成几个步骤。 有关 详细信息,请参阅升级代码 、自 定义和升级前维护任务 。 此外,请确保您的系统符合新版AEM的要求。 了解Pattern Detector如何帮助您评估升级的复杂性,并查看计划升级的升级范围和要求部分以了 解更多信息

迁移先决条件

  • 最低要求的Java版本:该迁移工具仅适用于Java版本7及更高版本。 请注意,对于AEM 6.3及更高版本,Oracle的JRE 8和IBM的JRE 7和8是唯一支持的版本。
  • 升级实例:如果您是从5.6 以前的版本升级 ,请确保您按照升级文档6.0版中描述的过程执行了对AEM 6.0的就地升级。

准备AEM Quickstart jar文件

  1. 如果实例正在运行,则停止该实例。
  2. 下载新的AEM jar文件,然后使用它替换文件夹外的旧 crx-quickstart 文件。
  3. 通过运行以下命令解压新快速入门程序:
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    
    

内容存储库迁移

如果从AEM 6.3升级,则不需要进行此迁移。对于6.3以前的版本,Adobe提供了一个工具,可用于将存储库迁移到AEM 6.3中存在的Oak区段Tar的新版本。它作为快速启动包的一部分提供,对于将使用TarMK的任何升级,它都是强制性的。 使用MongoMK的环境的升级不需要存储库迁移。 For more information on what the benefits of the new Segment Tar format are, see the Migrating to Oak Segment Tar FAQ .
实际迁移是使用标准AEM快速入门jar文件执行的,该文件使用新选项执行crx2oak工具,以简化升级并使其更加健壮。 -x crx2oak
如果您使用CRX2Oak Quickstart扩展执行TarMK存储库内容迁移,则可以通过向迁移命令行添加以下内容来删除 samplecontent runmode:
  • --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)
在以下情况下,您可能还需要其他交换机:
  • 如果在Java内存映射处理不正确的Windows系统上执行升级,请将该参 --disable-mmap 数添加到命令。
  • 如果您使用的是Java 7,请在该 -XX:MaxPermSize=2048m 参数之后添加该 -Xmx 参数。
有关使用crx2oak工具的其他说明,请参阅使用 CRX2Oak迁移工具 。 crx2oak帮助程序JAR可根据需要手动升级,方法是在解压快速启动后手动将其替换为较新版本。 它在AEM安装文件夹中的位置是: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar . CRX2Oak迁移工具的最新版本可从Adobe存储库下载: https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/
如果迁移成功完成,该工具将退出,退出代码为零。 此外,检查AEM安装目录下的文 upgrade.log``crx-quickstart/logs 件中的“警告”和“错误”消息,因为这些消息可能指示迁移期间发生的非致命错误。
检查文件夹下的配置 crx-quickstart/install 文件。 如果需要迁移,则会更新这些迁移以反映目标存储库。
关于数据存储的注释:
FileDataStore 然是AEM 6.3安装的新默认值,但不需要使用外部数据存储。 虽然建议将外部数据存储作为生产部署的最佳实践,但升级不是先决条件。 由于升级AEM时已存在复杂性,我们建议在不进行数据存储迁移的情况下执行升级。 如果需要,可以随后作为单独的努力执行数据存储迁移。

迁移问题疑难解答

如果您是从6.3升级,请跳过此部分。虽然提供的crx2oak配置文件应能满足大多数客户的需求,但有时需要额外的参数。 如果您在迁移过程中遇到错误,可能环境的某些方面需要提供额外的配置选项。 如果是,您可能会遇到以下错误:
不会复制检查点,因为未指定外部数据存储。 这将导致在第一次启动时重新构建完整的存储库索引。 使用—skip-checktoips强制迁移,或参阅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.8.x S3连接器的最新版
  3. 将包解压缩到临时文件夹,并将其内容复 jcr_root/libs/system/install 制到该文 crx-quickstart/install 件夹。

确定正确的升级开始命令

要执行升级,请务必使用jar文件启动AEM以调出实例。 要升级到6.5,另请参阅“延迟内容迁移”中的其他内容重组和迁移选项 延迟内容迁移 ,您可以使用升级命令进行选择。
请注意,从开始脚本启动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 )替换为新jar(该文件夹的同级)来修改该命 crx-quickstart 令。 以我们以前的命令为例,我们的命令将是:
    /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目标版本中工作的步骤,请参阅升级代码和 自定义页面

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