在JBoss EAP 8上升级AEM 6.5 LTS (Windows)

Last update: Fri Apr 10 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

适用对象：
Experience Manager 6.5 LTS

概述

本指南提供了使用JDK 21将现有Adobe Experience Manager (AEM) 6.5 LTS安装从Windows上的JBoss EAP 7.4升级到JBoss EAP 8的分步说明。

升级路径： JBoss EAP 7.4 (JDK 11) → JBoss EAP 8 (JDK 21)

重要注意事项

NOTE

这是一个关键的升级过程。始终首先在非生产环境中执行此升级，并维护完整的备份。

先决条件：在继续之前，必须完成系统备份和制定有文档记录的回滚计划。

升级前要求

系统要求

组件

要求

操作系统

Windows Server 2016或更高版本（64位）

Source环境

带有AEM 6.5 LTS的JBoss EAP 7.4

目标环境

JBoss EAP 8.x

Java开发工具包

JDK 21（Oracle或OpenJDK）

AEM 版本

AEM 6.5 Service Pack（最新推荐版本）

磁盘空间

升级过程的最小可用空间为50 GB

所需下载

在开始升级之前，请获取以下内容：

JBoss EAP 8.0分发
下载自：https://developers.redhat.com/products/eap/download
JDK 21安装程序
下载Oracle JDK 21或OpenJDK 21 for Windows（64位）
AEM 6.5 LTS WAR文件
从AEM Software Distribution获取最新的Adobe 6.5 Service Pack WAR

步骤1：创建完整备份

IMPORTANT

请在继续之前执行全面的备份。

备份核对清单

[ ]现有JBoss EAP 7.4安装目录的完整备份
[ ]文件夹的crx-repository备份
[ ]文件夹的crx-quickstart备份
[ ]导出所有自定义配置
[ ]数据库备份（如果使用外部数据库）
[ ]记录当前系统状态和配置

创建备份

# Example backup location
C:\AEM-Backups\Pre-Upgrade-<date>

# Copy entire JBoss 7.4 directory
xcopy "C:\jboss-eap-7.4" "C:\AEM-Backups\Pre-Upgrade-<date>\jboss-eap-7.4" /E /I /H

建议：将备份存储在单独的驱动器或网络位置。

步骤2：安装JBoss EAP 8

提取JBoss EAP 8

将JBoss EAP 8 ZIP分发解压缩到目标安装目录：

code language-none
`C:\jboss-eap-8.0`

请将此目录路径记为<JBOSS_HOME>，以便在本指南中使用。

复制目录结构

确保新的JBoss EAP 8安装与以前的JBoss EAP 7.4安装具有相同的自定义目录结构，特别是：

自定义部署目录
外部配置文件夹
日志文件位置
任何自定义模块或库

步骤3：迁移存储库数据

复制CRX存储库

导航到现有的JBoss EAP 7.4安装：

code language-none
`<OLD_JBOSS_HOME>\bin\crx-repository`

将整个crx-repository文件夹复制到新的JBoss EAP 8安装：

code language-cmd
`xcopy "C:\jboss-eap-7.4\bin\crx-repository" "C:\jboss-eap-8.0\bin\crx-repository" /E /I /H`

重要信息：此文件夹包含您的内容存储库，必须完全传输。

验证存储库副本

复制后，验证存储库的大小和结构与源是否匹配：

dir "C:\jboss-eap-8.0\bin\crx-repository" /s

步骤4：停止AEM实例

在进行任何更改之前，请确保已完全停止AEM。

通过Windows服务停止

打开服务（运行： services.msc）
找到您的AEM/JBoss服务
右键单击并选择停止
等待服务完全停止

通过命令行停止

如果AEM是手动启动的：

转到JBoss控制台窗口
按Ctrl+C
等待正常关机完成

验证关机

确保Java进程不再运行：

tasklist | findstr java

步骤5：清理旧版AEM文件

从crx-quickstart目录中删除过时的文件以确保进行干净升级。

CAUTION

仅删除下面列出的特定文件和文件夹。请勿删除任何其他配置文件、自定义代码或存储库数据。

5.1删除Launchpad启动文件夹

位置：

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\startup

操作：

rd /s /q "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\startup"

用途：此文件夹包含将在升级期间重新生成的旧OSGi包。

5.2删除基本JAR文件

位置：

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\org.apache.sling.launchpad.base.jar

操作：

del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\org.apache.sling.launchpad.base.jar"

用途：此JAR将被新WAR文件中的版本替换。

5.3删除Bootstrap命令文件

位置：

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\felix\bundle0\BootstrapCommandFile_*.txt

操作：

del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\felix\bundle0\BootstrapCommandFile_*.txt"

用途：将为新环境重新生成Bootstrap命令。

5.4删除sling.options文件

位置：

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\felix\sling.options.file

操作：

del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\felix\sling.options.file"

5.5删除sling_bootstrap.txt文件

位置：

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\sling_bootstrap.txt

操作：

del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\sling_bootstrap.txt"

5.6备份和删除sling.properties文件

此文件包含特定于环境的配置，可能需要稍后合并。

位置：

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\conf\sling.properties

操作：

创建备份：

code language-cmd
`copy "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\conf\sling.properties" "C:\AEM-Backups\sling.properties.backup"`

删除原始文件：

code language-cmd
`del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\conf\sling.properties"`

用途：将生成新的sling.properties。检查您的备份，以便在升级后恢复任何自定义配置。

步骤6：安装和配置JDK 21

安装JDK 21

运行Windows版JDK 21安装程序
安装到标准位置（例如，C:\Program Files\Java\jdk-21）
完成安装向导

配置环境变量

设置JAVA_HOME

打开系统属性 → 高级 → 环境变量
在 系统变量 下，单击新建
已设置：
- 变量名称： JAVA_HOME
- 变量值： C:\Program Files\Java\jdk-21
单击确定

更新路径变量

在 系统变量 中，选择Path并单击编辑

添加新条目：

code language-none
`%JAVA_HOME%\bin`

将此条目移至列表顶部以确保JDK 21优先
在所有对话框中单击确定

验证Java安装

打开新命令提示符（以加载更新的环境变量）

验证Java版本：

code language-cmd
`java -version`

预期输出：

code language-none
`java version "21.0.x" Java(TM) SE Runtime Environment (build 21.0.x+...) Java HotSpot(TM) 64-Bit Server VM (build 21.0.x+..., mixed mode, sharing)`

验证JAVA_HOME：

code language-cmd
`echo %JAVA_HOME%`

步骤7：配置JVM设置

在部署AEM之前，请配置适当的JVM内存设置以供生产使用。

编辑standalone.conf.bat

导航至：

code language-none
`<JBOSS_HOME>\bin`

在文本编辑器中打开standalone.conf.bat（以管理员身份）

找到或添加JAVA_OPTS配置：

code language-batch

code language-batch
`rem # AEM Production JVM Settings set "JAVA_OPTS=-Xms4096m -Xmx4096m -XX:MaxMetaspaceSize=768m" set "JAVA_OPTS=%JAVA_OPTS% -Djava.net.preferIPv4Stack=true" set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8" set "JAVA_OPTS=%JAVA_OPTS% -server"`

rem # AEM Production JVM Settings
set "JAVA_OPTS=-Xms4096m -Xmx4096m -XX:MaxMetaspaceSize=768m"
set "JAVA_OPTS=%JAVA_OPTS% -Djava.net.preferIPv4Stack=true"
set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8"
set "JAVA_OPTS=%JAVA_OPTS% -server"

保存并关闭文件

建议的设置：

参数

建议值

描述

-Xms

40.96亿 — 8.192亿

初始栈大小

-Xmx

40.96亿 — 8.192亿

最大栈大小

-XX:MaxMetaspaceSize

7.68亿 — 1.024亿

元空间限制

注意：根据服务器的可用内存和工作负载要求调整值。

步骤8：部署AEM 6.5 LTS WAR

准备WAR文件

确保按照部署指南正确配置您的AEM WAR文件：

jboss-deployment-structure.xml存在
web.xml包含多部分配置设置
如果进行了任何修改，WAR将重新打包

部署到JBoss

将AEM 6.5 LTS WAR文件复制到部署目录：

code language-cmd
`copy "C:\AEM-Downloads\cq-quickstart-6.5.xx.war" "C:\jboss-eap-8.0\standalone\deployments\cq-quickstart.war"`

重要信息：请确保WAR文件名与所需的URL上下文路径相匹配。

步骤9：使用AEM启动JBoss EAP 8

启动服务器

以 管理员 的身份打开命令提示符

导航到JBoss bin目录：

code language-cmd
`cd C:\jboss-eap-8.0\bin`

启动JBoss EAP 8：

code language-cmd
`standalone.bat -b 0.0.0.0 -bmanagement 0.0.0.0`

监视初始启动

观看控制台输出：

WAR部署：

code language-none
`Deployed "cq-quickstart.war" (runtime-name : "cq-quickstart.war")`

AEM初始化消息：

code language-none
`Apache Sling Application Launcher Sling Home: crx-repository/crx-quickstart`

存储库升级（如果适用）：

code language-none
`Performing repository migration...`

预计启动时间： 5-15分钟，具体取决于存储库大小和系统资源。

步骤10：验证升级是否成功

查看AEM启动

监视JBoss控制台以查看最终启动消息：

**** AEM started successfully ****

访问AEM界面

打开Web浏览器

导航至：

code language-none
`http://localhost:8080/cq-quickstart`

使用管理员凭据登录：
- 用户名： admin
- 密码： admin（或您的自定义密码）

验证系统信息

导航到工具 → 操作 → Web控制台

code language-none
`http://localhost:8080/cq-quickstart/system/console`

单击系统信息
验证：
- JVM版本：应显示Java 21
- JBoss版本：应显示EAP 8.x
- AEM版本：应显示6.5.xx

检查系统运行状况

导航到工具 → 操作 → 诊断以运行运行状况检查：

捆绑包状态：所有捆绑包都应处于“活动”状态
资源分辨率：应显示正常状态
查询性能：检查是否存在任何性能下降

升级后任务

恢复自定义配置

查看已备份的sling.properties文件

将任何自定义运行模式或配置还原到新文件：

code language-none
`<JBOSS_HOME>\bin\crx-repository\crx-quickstart\conf\sling.properties`

如果配置已更改，请重新启动AEM

更新复制代理

导航到作者上的工具 → 部署 → 复制 → 代理
查看和测试所有复制代理
更新对旧服务器路径的任何硬编码引用

测试关键功能

[ ]内容创作和发布
[ ]资源上传和处理
[ ]工作流执行
[ ]用户身份验证
[ ]集成端点
[ ]自定义组件和模板

性能优化

查看和清除任何临时缓存
在初始使用期间监视系统性能
如果需要，根据实际使用模式调整JVM设置

疑难解答

常见问题

问题

可能的原因

解决方案

AEM无法启动

Java版本不正确

验证JAVA_HOME指向JDK 21

存储库损坏错误

存储库复制不完整

从备份中恢复并重新复制存储库

内存不足错误

栈内存不足

在-Xmx中增加standalone.conf.bat

处于“已安装”状态的包

缺少依赖项

在Web控制台中检查捆绑包依赖关系

端口8080已在使用中

使用端口的其他服务

停止冲突的服务或更改JBoss端口

日志文件位置

JBoss服务器日志：
<JBOSS_HOME>\standalone\log\server.log
AEM错误日志：
<JBOSS_HOME>\bin\crx-repository\crx-quickstart\logs\error.log
AEM访问日志：
<JBOSS_HOME>\bin\crx-repository\crx-quickstart\logs\access.log

回滚过程

如果升级失败且无法解析：

停止JBoss EAP 8
恢复JBoss EAP 7.4的完整备份
还原crx-repository文件夹
验证JAVA_HOME是否指向JDK 11（如果回滚）
启动上一个环境

最佳做法

生产部署之前

[ ]在开发环境中测试完整的升级过程
[ 在暂存环境中使用类似生产的数据进行]测试
[ ]记录所有自定义配置和集成
[ ]创建详细的回滚计划
[ ]计划在维护时段升级
[ ]通知所有利益相关者计划内停机时间

成功升级后

[ ]监控系统日志48-72小时
[ ]执行负载测试以确定性能问题
[ ]更新系统文档
[ ]培训团队了解任何JBoss EAP 8差异
[ ]存档所有升级文档和备份

文档信息

字段

值

文档版本

1.0

上次更新时间

2026年2月

AEM 版本

6.5 LTS

Source平台

JBoss EAP 7.4 / JDK 11

Target平台

JBoss EAP 8.x / JDK 21

操作系统

Windows Server

法律声明： Adobe、Adobe Experience Manager和AEM是Adobe Inc.的注册商标。JBoss和Red Hat是Red Hat， Inc.的注册商标。

recommendation-more-help

51c6a92d-a39d-46d7-8e3e-2db9a31c06a2

在JBoss EAP 8上升级AEM 6.5 LTS (Windows)

概述

重要注意事项

升级前要求

系统要求

所需下载

步骤1：创建完整备份

备份核对清单

创建备份

步骤2：安装JBoss EAP 8

提取JBoss EAP 8

复制目录结构

步骤3：迁移存储库数据

复制CRX存储库

验证存储库副本

步骤4：停止AEM实例

通过Windows服务停止

通过命令行停止

验证关机

步骤5：清理旧版AEM文件

5.1删除Launchpad启动文件夹

5.2删除基本JAR文件

5.3删除Bootstrap命令文件

5.4删除sling.options文件

5.5删除sling_bootstrap.txt文件

5.6备份和删除sling.properties文件

步骤6：安装和配置JDK 21

安装JDK 21

配置环境变量

设置JAVA_HOME

更新路径变量

验证Java安装

步骤7：配置JVM设置

编辑standalone.conf.bat

步骤8：部署AEM 6.5 LTS WAR

准备WAR文件

部署到JBoss

步骤9：使用AEM启动JBoss EAP 8

启动服务器

监视初始启动

步骤10：验证升级是否成功

查看AEM启动

访问AEM界面

验证系统信息

检查系统运行状况

升级后任务

恢复自定义配置

更新复制代理

测试关键功能

性能优化

疑难解答

常见问题

日志文件位置

回滚过程

最佳做法

生产部署之前

成功升级后

相关文档

文档信息