應用程式伺服器安裝

本節會告訴您如何與應用程式伺服器一起安裝Adobe Experience Manager(AEM)。 請參閱支援的平台一節，瞭解個別應用程式伺服器的特定支援等級。

說明下列應用程式伺服器的安裝步驟：

• WebSphere 8.5
• JBoss EAP 6.3.0/6.4.0
• Oracle WebLogic 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

• context root is the war file name efe: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. 變更publish例項的sling.home變數和sling.run.modes變數。
2. 從AEM war檔案解壓縮WEB-INF/web.xml檔案。
3. 將sling.home參數變更為不同的路徑（可能有絕對和相對路徑）。
4. 將sling.run.modes變更為publish執行個體的發佈。
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伺服器的全域管理安全性，以執行下列動作：轉至「Security -> Global Security」（安全性->全域安全性），並取消選中「Enable administrative security」（啟用管理安全性）複選框，保存並重新啟動伺服器。

• set "JAVA_OPTS= -Xmx2048m"

• 如果您想使用內容根目錄= /安裝AEM，則必須先變更現有預設Web應用程式的內容根目錄

部署AEM網頁應用程式

• 下載AEM war檔案

• 視需要在web.xml中進行設定（請參閱上述一般說明）

  • 解壓縮WEB-INF/web.xml檔案
  • change sling.run.modes參數以發佈
  • uncomment sling.home初始參數，並視需要設定此路徑
  • Repack 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網頁應用程式

• 在JBoss管理控制台中上傳AEM網頁應用程式。

• 啟用AEM網頁應用程式。

Oracle WebLogic 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.g set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
  • 重新啟動WebLogic Server

• 在${myDomain}中建立包資料夾，在cq資料夾內建立Plan資料夾

部署AEM網頁應用程式

• 下載AEM war檔案

• 將AEM war檔案放入${myDomain}/packages/cq檔案夾

• 視需要在WEB-INF/web.xml中進行配置（請參閱上面的「一般說明」）

  • 解壓縮WEB-INF/web.xml檔案
  • change sling.run.modes參數以發佈
  • uncomment sling.home初始參數，並視需要設定此路徑（請參閱一般說明）
  • Repack web.xml檔案

• 將AEM war檔案部署為「應用程式」（對於其他設定，請使用預設設定）

• 安裝可能需要時間……

• 檢查「General Description（一般說明）」中的上述安裝是否已完成（例如，跟蹤error.log）

• 您可以在WebLogic /console中更改Web應用程式的「配置」頁籤中的上下文根

Tomcat 8/8.5

部署前，請閱讀上述一般說明。

• 準備Tomcat伺服器

  • 增加虛擬機記憶體設定：

    • 在bin/catalina.bat（在unix上為catalina.sh）中添加以下設定：
    • 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網頁應用程式的內容根目錄：

    • 停止和取消部署ROOT Webapp
    • 在tomcat的Webapps資料夾中更名ROOT.war資料夾
    • 再次啟動網頁應用程式

  • 如果您使用Manager-gui安裝AEM Web應用程式，則需要增加上傳檔案的最大大小，因為預設僅允許50MB的上傳大小。 若要開啟管理器網頁應用程式的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網頁應用程式

  • 下載AEM war檔案

  • 視需要在web.xml中進行設定（請參閱上述一般說明）

    • 解壓縮WEB-INF/web.xml檔案
    • change sling.run.modes參數以發佈
    • uncomment sling.home初始參數，並視需要設定此路徑
    • Repack web.xml檔案

  • 如果您想要將AEM war檔案部署為根網路應用程式，請將它重新命名為ROOT.war，如果您想要讓aemauthor做為內容根目錄，請將它重新命名為eamouthor.war

  • 將其複製到tomcat的webapps資料夾

  • 等到安裝AEM為止

疑難排解

有關處理安裝過程中可能出現的問題的資訊，請參見：

• 疑難排解