应用程序服务器安装 application-server-install
JAR
和 WAR
Adobe Experience Manager (AEM)是在中发布的文件类型。 这些格式正在进行质量保证,以满足Adobe承诺的支持级别。本节介绍如何通过应用程序服务器安装Adobe Experience Manager (AEM)。 请参阅 支持的平台 部分以了解为各个应用程序服务器提供的特定支持级别。
以下应用程序服务器的安装步骤已说明:
有关安装Web应用程序、服务器配置以及如何启动和停止服务器的详细信息,请参阅相应的应用程序服务器文档。
常规描述 general-description
在应用程序服务器中安装AEM时的默认行为 default-behaviour-when-installing-aem-in-an-application-server
AEM作为单个war文件来部署。
如果部署,则默认情况下会发生以下情况:
-
运行模式为
author
-
实例(存储库、Felix OSGI环境、捆绑包等)安装在中
${user.dir}/crx-quickstart
位置${user.dir}
是当前工作目录,将调用crx-quickstart的此路径sling.home
-
上下文根目录是war文件名,例如,
aem-6
配置 configuration
您可以通过以下方式更改默认行为:
-
运行模式:配置
sling.run.modes
中的参数WEB-INF/web.xml
部署前的AEM war文件 -
sling.home:配置
sling.home
中的参数WEB-INF/web.xml
部署前的AEM war文件 -
上下文根目录:重命名AEM war文件
发布安装 publish-installation
要部署发布实例,您需要将运行模式设置为发布:
- 从AEM war文件中解压缩WEB-INF/web.xml
- 将sling.run.modes参数更改为发布
- 将web.xml文件重新打包到AEM war文件中
- 部署AEM war文件
安装检查 installation-check
要检查是否已安装所有组件,您可以:
- 跟踪
error.log
文件以查看是否已安装所有内容 - 查看
/system/console
已安装所有包
同一应用程序服务器上的两个实例 two-instances-on-the-same-application-server
出于演示目的,可以将创作实例和发布实例安装在一个应用程序服务器中。 为此,请执行以下操作:
- 更改发布实例的sling.home变量和sling.run.modes变量。
- 从AEM war文件中解压缩WEB-INF/web.xml文件。
- 将sling.home参数更改为其他路径(可以使用绝对路径和相对路径)。
- 将sling.run.modes更改为发布实例的发布。
- 重新打包web.xml文件。
- 请重命名war文件,使其名称不同。 例如,一个重命名为aemauthor.war,另一个重命名为aempublish.war。
- 使用更高的内存设置。 例如,默认AEM实例使用
-Xmx3072m
- 部署两个Web应用程序。
- 部署后,停止两个Web应用程序。
- 在创作实例和发布实例中,均确保在sling.properties文件中,属性felix.service.urlhandlers=false设置为false(默认设置为true)。
- 再次启动两个Web应用程序。
应用服务器的安装过程 application-servers-installation-procedures
WebSphere® 8.5 websphere
在部署之前阅读 常规描述 以上。
服务器准备
-
让基本身份验证标头通过:
- 允许AEM对用户进行身份验证的一种方法是禁用WebSphere®服务器的全局管理安全性,要实现此目的:转到“安全性”>“全局安全性”,然后取消选中“启用管理安全性”复选框,保存并重新启动服务器。
-
设置
"JAVA_OPTS= -Xmx2048m"
-
如果要使用上下文根= /安装AEM,请更改现有默认Web应用程序的上下文根。
部署AEM Web应用程序
-
下载AEM war文件
-
如果需要,在web.xml中进行配置(请参阅上面的“一般说明”)
- 解压缩WEB-INF/web.xml文件
- 将sling.run.modes参数更改为发布
- 取消对sling.home初始参数的注释并根据需要设置此路径
- 重新打包web.xml文件
-
部署AEM war文件
- 选择上下文根目录(如果要设置Sling运行模式,则需要选择部署向导的详细步骤,然后在向导的步骤6中指定它)
-
启动AEM Web应用程序
JBoss® EAP 6.3.0/6.4.0 jboss-eap
在部署之前阅读 常规描述 以上。
准备JBoss®服务器
在conf文件中设置内存参数(例如, standalone.conf
)
- JAVA_OPTS="-Xms64m -Xmx2048m"
如果您使用部署扫描程序来安装AEM Web应用程序,则增加 deployment-timeout,
对于该集 deployment-timeout
属性(例如, configuration/standalone.xml)
:
<subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1">
<deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" deployment-timeout="1000"/>
</subsystem>
部署AEM Web应用程序
-
在JBoss®管理控制台中上传AEM Web应用程序。
-
启用AEM Web应用程序。
oracleWebLogic 12.1.3/12.2 oracle-weblogic
在部署之前阅读 常规描述 以上。
该配置使用仅具有管理服务器的简单服务器布局。
WebLogic服务器准备
-
在
${myDomain}/config/config.xml
将添加到security-configuration部分:<enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials>
查看日期 https://xmlns.oracle.com/weblogic/domain/1.0/domain.xsd 正确的位置(默认情况下,将其定位在部分的末尾是ok)
-
增加VM内存设置:
- open
${myDomain}/bin/setDomainEnv.cmd
(表示.sh)搜索WLS_MEM_ARGS,设置例如,设置WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
- 重新启动WebLogic Server
- open
-
在中创建
${myDomain}
包文件夹,位于cq文件夹内和计划文件夹中
部署AEM Web应用程序
-
下载AEM war文件
-
将AEM war文件放入${myDomain}/packages/cq文件夹
-
在中进行配置
WEB-INF/web.xml
如有需要(请参阅上面的“一般说明”)- 解包
WEB-INF/web.xml
文件 - 将sling.run.modes参数更改为发布
- 取消对sling.home初始参数的注释,并根据需要设置此路径(请参阅常规描述)
- 重新打包web.xml文件
- 解包
-
将AEM war文件部署为应用程序(对于其他设置,使用默认设置)
-
安装可能需要一些时间……
-
检查安装是否已完成,如常规描述中所述(例如,跟踪error.log)
-
可以在WebLogic中Web应用程序的“配置”选项卡中更改上下文根目录
/console
Tomcat 8/8.5 tomcat
在部署之前阅读 常规描述 以上。
-
准备Tomcat服务器
-
增加VM内存设置:
- 在
bin/catalina.bat
(响应catalina.sh
在UNIX®上)添加以下设置: set "JAVA_OPTS= -Xmx2048m
- 在
-
在安装时,Tomcat不启用管理员或管理员访问权限。 因此,您必须手动编辑
tomcat-users.xml
要允许这些帐户访问,请执行以下操作:-
编辑
tomcat-users.xml
以包含管理员和经理的访问权限。 该配置应类似于以下示例:code language-xml <?xml version='1.0' encoding='utf-8'?> <tomcat-users> role rolename="manager"/> role rolename="tomcat"/> <role rolename="admin"/> <role rolename="role1"/> <role rolename="manager-gui"/> <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="tomcat" password="tomcat" roles="tomcat"/> <user username="admin" password="admin" roles="admin,manager-gui"/> <user username="role1" password="tomcat" roles="role1"/> </tomcat-users>
-
-
如果要使用上下文根“/”部署AEM,则必须更改现有ROOT Web应用程序的上下文根:
- 停止并取消部署ROOT Web应用程序
- 重命名tomcat webapps文件夹中的ROOT.war文件夹
- 再次启动Web应用程序
-
如果您使用管理器gui安装AEM Web应用程序,则需要增加已上传文件的最大大小,因为默认仅允许50 MB的上传大小。 对于打开管理器Web应用程序的Web.xml,
webapps/manager/WEB-INF/web.xml
并将max-file-size和max-request-size增加到至少500MB,请参见以下内容
multipart-config
示例web.xml
文件。code language-xml <multipart-config> <!-- 500MB max --> <max-file-size>524288000</max-file-size> <max-request-size>524288000</max-request-size> <file-size-threshold>0</file-size-threshold> </multipart-config>
-
-
部署AEM Web应用程序
-
下载AEM war文件
-
如果需要,在web.xml中进行配置(请参阅上面的“一般说明”)
- 解压缩WEB-INF/web.xml文件
- 将sling.run.modes参数更改为发布
- 取消对sling.home初始参数的注释并根据需要设置此路径
- 重新打包web.xml文件
-
将AEM war文件重命名为ROOT.war(如果您要将其部署为根Web应用程序),请将其重命名为,例如,如果您要将aemauthor作为上下文根,请将其重命名为aemauthor.war
-
将其复制到tomcat的webapps文件夹中
-
等待安装AEM
-
疑难解答 troubleshooting
有关处理安装过程中可能出现的问题信息,请参阅: