应用程序服务器安装

本节介绍如何通过应用程序服务器安装Adobe Experience Manager (AEM)。 请参阅 支持的平台 部分以了解为各个应用程序服务器提供的特定支持级别。

以下应用程序服务器的安装步骤已说明：

• WebSphere
• Jboss
• oracleWebLogic 12.1.3/12.2
• Tomcat 8/8.5

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

常规描述

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

AEM作为单个war文件来部署。

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

• 运行模式为 author

• 实例（存储库、Felix OSGI环境、捆绑包等）安装在中 ${user.dir}/crx-quickstart位置 ${user.dir} 是当前工作目录，将调用crx-quickstart的此路径 sling.home

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

配置

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

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

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

• 上下文根目录：重命名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文件，使其名称不同。 例如，一个重命名为aemauthor.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®服务器的全局管理安全性，要实现此目的：转到“安全性”>“全局安全性”，然后取消选中“启用管理安全性”复选框，保存并重新启动服务器。

• 设置 "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®服务器

在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

在部署之前阅读 常规描述 以上。

该配置使用仅具有管理服务器的简单服务器布局。

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

• 在中创建 ${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服务器

  • 增加VM内存设置：

    • 在 bin/catalina.bat (响应 catalina.sh 在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应用程序

  • 如果您使用管理器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 文件。

    <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

疑难解答

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

• 疑难解答