文件AEM 6.5使用手冊

應用程式伺服器安裝 application-server-install

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員
NOTE
JAR和WAR是Adobe Experience Manager (AEM)發行所在的檔案型別。 這些格式正在進行品質保證，以符合Adobe所承諾的支援等級。

本節將說明如何使用應用程式伺服器安裝Adobe Experience Manager (AEM)。 請參閱支援平台區段，瞭解個別應用程式伺服器提供的特定支援等級。

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

請參閱適當的應用程式伺服器檔案，以取得有關安裝Web應用程式、伺服器設定以及如何啟動和停止伺服器的詳細資訊。

NOTE
如果您在WAR部署中使用Dynamic Media，請參閱Dynamic Media檔案。

一般說明 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

您可以透過下列方式變更預設行為：

  • 執行模式：部署前在AEM war檔案的WEB-INF/web.xml檔案中設定sling.run.modes引數

  • sling.home：在部署前設定AEM war檔案的WEB-INF/web.xml檔案中的sling.home引數

  • 內容根目錄：重新命名AEM war檔案

Publish安裝 publish-installation

若要部署發佈執行個體，您必須將執行模式設定為發佈：

  • 從AEM war檔案中解壓縮WEB-INF/web.xml
  • 將sling.run.modes引數變更為發佈
  • 將web.xml檔案重新封裝成AEM war檔案
  • 部署AEM war檔案

安裝檢查 installation-check

若要檢查是否已安裝all，您可以：

  • 追蹤error.log檔案以檢視是否已安裝所有內容
  • 檢視/system/console所有套件組合均已安裝

同一應用程式伺服器上的兩個執行個體 two-instances-on-the-same-application-server

為了示範，將製作和發佈例項安裝在一個應用程式伺服器上可能是適當的。 為此，請執行以下操作：

  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. 部署兩個網頁應用程式。
  9. 部署後，請停止兩個Web應用程式。
  10. 在製作和發佈執行個體中，都會確保在sling.properties檔案中，屬性felix.service.urlhandlers=false設為false （預設為設為true）。
  11. 再次啟動兩個網頁應用程式。

應用程式伺服器的安裝程式 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網頁應用程式

JBoss® EAP 6.3.0/6.4.0 jboss-eap

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

準備JBoss®伺服器

在您的conf檔案中設定記憶體引數（例如，standalone.conf）

  • JAVA_OPTS="-Xms64m -Xmx2048m"

如果您使用部署 — 掃描器來安裝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網頁應用程式。

oracleWebLogic 12.1.3/12.2 oracle-weblogic

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

這會使用僅含管理伺服器的簡單伺服器配置。

WebLogic伺服器準備

  • 在${myDomain}/config/config.xml中，新增至安全性設定區段：

  • 增加VM記憶體設定：

    • 開啟${myDomain}/bin/setDomainEnv.cmd (resp .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 /console中Web應用程式的[組態]索引標籤中變更內容根目錄

Tomcat 8/8.5 tomcat

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

  • 準備Tomcat伺服器

    • 增加VM記憶體設定：

      • 在bin/catalina.bat (UNIX®上代表catalina.sh)中新增下列設定：
      • 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 Webapp的內容根目錄：

      • 停止和取消部署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，請參閱下列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檔案部署為根Web應用程式，請將它重新命名為ROOT.war。 如果要將aemauthor重新命名為內容根目錄，請將其重新命名為aemauthor.war。

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

    • 請等待AEM安裝完成。

疑難排解 troubleshooting

如需有關處理安裝期間可能出現問題的資訊，請參閱：

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2