应用程序服务器安装

本节将告诉您如何将Adobe Experience Manager(AEM)与应用程序服务器一起安装。 请查阅支持的平台部分，了解为各个应用程序服务器提供的特定支持级别。

介绍了以下应用程序服务器的安装步骤：

• WebSphere 8.5
• JBoss EAP 6.3.0/6.4.0
• OracleWebLogic 12.1.3/12.2
• Tomcat 8/8.5

有关安装Web应用程序、服务器配置以及如何开始和停止服务器的详细信息，请查阅相应的应用程序服务器文档。

一般说明

在应用程序服务器中安装AEM时的默认行为

AEM是一个要部署的战争文件。

如果部署了以下内容，则默认情况下会发生：

• 运行模式为author

• 实例(存储库、Felix OSGI环境、捆绑包等) 安装在${user.dir}/crx-quickstart中，其中${user.dir}是当前工作目录，crx-quickstart的此路径称为sling.home

• 上下文根是war文件名，例如：aem-6

配置

可以通过以下方式更改默认行为：

• 运行模式：在部署之前，在AEM war文件的WEB-INF/web.xml文件中配置sling.run.modes参数

• sling.home:在部署之前，在AEM war文件的WEB-INF/web.xml文件中配置sling.home参数

• 上下文根：重命名AEM war文件

发布安装

要部署发布实例，您需要设置要发布的运行模式：

• 从AEM war文件解压缩WEB-INF/web.xml文件
• 将sling.run.modes参数更改为发布
• 将web.xml文件重新打包到AEM war文件
• 部署AEM war文件

安装检查

要检查是否已安装全部：

• 尾随error.log文件，查看是否已安装所有内容
• 在/system/console中查看所有捆绑包的安装情况

同一应用程序服务器上的两个实例

出于演示目的，可以在一台应用程序服务器中安装作者实例和发布实例。 为此，请执行以下操作：

1. 更改发布实例的sling.home变量和sling.run.modes变量。
2. 从AEM war文件解压缩WEB-INF/web.xml文件。
3. 将sling.home参数更改为其他路径（可以使用绝对路径和相对路径）。
4. 将sling.run.modes更改为发布实例。
5. 重新打包web.xml文件。
6. 重命名war文件，使它们具有不同的名称：例如，一个重命名为aemmauthor.war，另一个重命名为aempublish.war。
7. 使用较高的内存设置，例如，对于默认AEM实例，请使用如：-Xmx3072m
8. 部署两个Web应用程序。
9. 部署后停止两个Web应用程序。
10. 在作者实例和发布实例中，确保在sling.properties文件中，属性felix.service.urlhandlers=false设置为false（默认设置为true）。
11. 再次开始两个Web应用程序。

应用程序服务器安装过程

WebSphere 8.5

部署之前，请阅读上面的一般说明。

服务器准备

• 让基本身份验证头传递：

  • 让AEM对用户进行身份验证的一种方法是禁用WebSphere服务器的全局管理安全性，这样做：转至“安全”->“全局安全”并取消选中“启用管理安全”复选框，保存并重新启动服务器。

• set "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服务器

在会议文件中设置内存参数(例如，standalone.conf

• JAVA_OPTS="-Xms64m -Xmx2048m"

如果使用deployment-scanner安装AEM web应用程序，则最好在实例的xml文件中为该设置deployment-timeout属性（如configuration/standalone.xml)）:deployment-timeout,

<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

部署之前，请阅读上面的一般说明。

它仅对管理服务器使用简单的服务器布局。

WebLogic服务器准备

• 在${myDomain}/config/config.xml中，添加到安全配置部分：

  • <enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials> 请参 阅https://xmlns.oracle.com/weblogic/domain/1.0/domain. xsdd中的正确位置（默认情况下，将其放置在部分末尾是可以的）

• 增加虚拟机内存设置：

  • 打开${myDomain}/bin/setDomainEnv.cmd(resp .sh)搜索WLS_MEM_ARGS，设置e，如设置WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
  • 重新启动WebLogic服务器

• 在${myDomain}中创建包文件夹，在cq文件夹中创建Plan文件夹

部署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文件部署为应用程序（对于其他设置，请使用默认设置）

• 安装可能需要时间……

• 检查如上“General Description（常规说明）”中所述的安装是否已完成（例如，跟踪error.log）

• 您可以在WebLogic /console中更改Web应用程序的“配置”选项卡中的上下文根

Tomcat 8/8.5

部署之前，请阅读上面的一般说明。

• 准备Tomcat服务器

  • 增加虚拟机内存设置：

    • 在bin/catalina.bat(resp catalina.sh on unix)中，添加以下设置：
    • set "JAVA_OPTS= -Xmx2048m

  • Tomcat在安装时不允许管理员和管理者访问。 因此，您必须手动编辑tomcat-users.xml才能允许访问这些帐户：

    • 编辑tomcat-users.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应用程序

  • 如果使用manager-gui安装AEM Web应用程序，则需要增加已上载文件的最大大小，因为默认情况下只允许50MB的上载大小。 要打开管理器Web应用程序的web.xml,

    webapps/manager/WEB-INF/web.xml

    并将max-file-size和max-request-size增加到至少500MB，请参阅此类web.xml文件的以下multipart-config示例：

    <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文件作为根Web应用程序部署，请将其重命名为ROOT.war，如果您希望将aemauthor作为上下文根文件，则将其重命名为eamuthor.war

  • 将其复制到tomcat的webapps文件夹中

  • 等到AEM安装完毕

疑难解答

有关处理安装过程中可能出现的问题的信息，请参阅：

• 疑难解答