本页概述了AEM 6.4的升级过程。如果您有部署到应用程序服务器的安装,请参阅应用程序服务器安装的升级步骤。
在执行升级之前,必须完成几个步骤。 有关详细信息,请参阅升级代码和自定义和升级前维护任务。 此外,确保您的系统满足新版AEM的要求。 了解模式检测器如何帮助您评估升级的复杂性,另请参阅计划升级的升级范围和要求部分以了解详细信息。
最低要求的Java版 本:迁移工具仅适用于Java版本7及更高版本。请注意,对于AEM 6.3和更高版本,Oracle的JRE 8和IBM的JRE 7和8是唯一受支持的版本。
升级实 例:如果从5. 6以前的版本升级,请确保按照升级文档6.0版中描述的过程,执行了到AEM 6.0的就地升级。
如果实例正在运行,则停止该实例。
下载新的AEM jar文件,并使用它替换crx-quickstart
文件夹外的旧文件。
通过运行以下命令解压新快速启动程序jar:
java -Xmx4096m -jar aem-quickstart.jar -unpack
如果您从AEM 6.3升级,则不需要进行此迁移。对于6.3以前的版本,Adobe提供了一个工具,可用于将存储库迁移到AEM 6.3中存在的Oak区段Tar的新版本。它作为快速启动包的一部分提供,对于将使用TarMK的任何升级都是强制性的。 对于使用MongoMK的环境,升级不需要存储库迁移。 有关新的Segment Tar格式的优点的更多信息,请参见迁移到Oak Segment Tar常见问题解答。
实际迁移是使用标准的AEM quickstart 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 | 细分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,请在-Xmx
参数后添加-XX:MaxPermSize=2048m
参数。
有关使用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安装目录中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:
删除crx-quickstart/install
下与S3连接器的早期版本关联的所有jar。
从https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/下载1.8.x S3连接器的最新版本
将包解压缩到临时文件夹,并将jcr_root/libs/system/install
的内容复制到crx-quickstart/install
文件夹。
要执行升级,开始AEM必须使用jar文件来调出实例。 要升级到6.4,另请参阅懒惰内容迁移中的其他内容重组和迁移选项,您可以使用升级命令进行选择。
请注意,从开始脚本启动AEM不会开始升级。 大多数客户使用开始脚本开始AEM,并已自定义此开始脚本,以包括内存设置、安全证书等环境配置的交换机。 因此,我们建议按照以下过程确定正确的升级命令:
在正在运行的AEM实例上,从命令行执行以下操作:
ps -ef | grep java
寻找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
通过将现有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.4.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
这将确保应用所有正确的内存设置、自定义运行模式和其他环境参数进行升级。 升级完成后,将来启动时可从开始脚本启动实例。
完成就地升级过程后,应部署更新的代码库。 有关更新AEM目标版本中使用的代码库的步骤,请参阅升级代码和自定义页面。
请参阅升级后检查和疑难解答。