应用程序服务器安装

注意

JARWAR 及是否在中释放文件类型AEM。这些格式正在进行质量保证,以满足Adobe承诺的支持级别。

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

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

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

注意

如果您在WAR部署中使用Dynamic Media,请参阅Dynamic Media文档

常规说明

在应用程序服务器中安装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文件,以便它们有不同的名称:例如,一个重命名为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服务器的全局管理安全性,以便这样做:转至“安全” — >“全局安全性”并取消选中“启用管理安全性”复选框,保存并重新启动服务器。
  • set "JAVA_OPTS= -Xmx2048m"

  • 如果要使用context root = /安装AEM,则必须首先更改现有Default Web应用程序的上下文根

部署AEM Web应用程序

  • 下载AEM war文件

  • 根据需要使用web.xml进行配置(请参阅上面的“常规”说明)

    • 解压缩WEB-INF/web.xml文件
    • 更改sling.run.modes参数以进行发布
    • uncomment 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属性的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应用程序。

Oracle WebLogic 12.1.3/12.2

部署之前,请阅读上面的常规说明

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

WebLogic服务器准备

  • ${myDomain}/config/config.xml中,添加到安全配置部分:

  • 增加虚拟机内存设置:

    • 打开${myDomain}/bin/setDomainEnv.cmd(resp .sh)搜索WLS_MEM_ARGS,设置如设置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文件部署为应用程序(对于其他设置,请使用默认设置)

  • 安装可能需要时间……

  • 检查安装是否已按常规说明中的上述步骤完成(例如跟踪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应用程序
    • 如果使用管理器 — 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参数以进行发布
      • uncomment sling.home初始参数,并根据需要设置此路径
      • 重复web.xml文件
    • 如果您希望将AEM war文件作为根Web应用程序部署,请将其重命名为ROOT.war,如果您希望将aemutor作为上下文根文件,则将其重命名为eamuthor.war

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

    • 等到AEM安装完毕

疑难解答

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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now