部署社群 deploying-communities

CAUTION
AEM 6.4已結束延伸支援,本檔案不再更新。 如需詳細資訊,請參閱 技術支援期. 尋找支援的版本 此處.

必備條件 prerequisites

安裝檢查清單 installation-checklist

AEM platform

社群功能

最新發行 latest-releases

AEM 6.4 Communities GA包含Communities套件。 了解AEM 6.4的更新 社群,請參閱 AEM 6.4發行說明.

AEM 6.4更新 aem-updates

自AEM 6.3開始,Communities的更新會隨AEM Cumulative Fix Pack和Service Pack一併提供。

如需AEM 6.4的最新更新,請務必檢查 Adobe Experience Manager 6.4 Cumulative Fix Pack和Service Pack.

版本記錄 version-history

如同AEM 6.4及更新版本,AEM Communities功能和Hotfix是AEM Communities Cumulative Fix Pack和Service Pack的一部分。 因此,沒有單獨的功能套件。

MySQL的JDBC驅動程式 jdbc-driver-for-mysql

兩個Communities功能使用MySQL資料庫:

  • 針對 啟用:記錄SCORM活動和學習者
  • 針對 DSRP:儲存用戶生成的內容(UGC)

必須單獨獲得並安裝MySQL連接器。

必要步驟為:

  1. 從下載ZIP封存 https://dev.mysql.com/downloads/connector/j/

    • 版本必須>= 5.1.38
  2. 提取mysql-connector-java-<version>-bin.jar(套件)

  3. 使用Web控制台來安裝和啟動套件:

    • 例如, http://localhost:4502/system/console/bundles
    • 選取 Install/Update
    • 瀏覽……以選取從下載的ZIP封存擷取的套件組合
    • 檢查 Oracle公司的MySQLcom.mysql.jdbc JDBC驅動程式 處於作用中狀態,若非則啟動(或檢查記錄)
  4. 如果在配置JDBC後在現有部署上進行安裝,則從Web控制台中重新保存JDBC配置,將JDBC重新綁定到新連接器:

    • 例如, http://localhost:4502/system/console/configMgr
    • 找出 Day Commons JDBC Connections Pool 配置
    • 選擇以開啟
    • 選取 Save
  5. 在所有製作和發佈執行個體上重複步驟3和4

有關安裝套件的詳細資訊,請參閱 Web主控台 頁面。

範例:已安裝的MySQL連接器套件組合 example-installed-mysql-connector-bundle

chlimage_1-410

SCORM套件 scorm-package

共用內容物件參考模型(SCORM)是數位學習的標準與規格的集合。 SCORM也定義了如何將內容封裝成可傳輸的ZIP檔案。

AEM Communities SCORM引擎是 啟用 功能。 AEM Communities 6.4版支援的Scorm套件包括:

若為新安裝的SCORM引擎,則包含 SCORM 2017.1 (其中 cq -social-scorm -package,版本2.2.2)。 以便您能播放SCORM 2017支援的學習資源。

首次安裝SCORM包

  1. 安裝 cq-social-scorm-package,2.2版.
  2. 下載 /libs/social/config/scorm/database_scormengine_data.sql 從cq實例並在mysql伺服器中執行該實例,以建立升級的scormEngineDB架構。
  3. 新增 /content/communities/scorm/RecordResults 在CSRF篩選器的「排除的路徑」屬性中,從 https://<hostname>;:<port>/system/console/configMgr 發佈商。

現有的SCORM安裝可升級為 cq-social-scorm-package,2.2版 (使用 SCORM 2017.1),如果製作的課程內容需要SCORM 2017.1。

NOTE
升級至SCORM 2017.1套件需要遷移現有資料庫(如進一步說明)。

升級SCORM引擎版本

  1. 備份ScormEngineDB架構。

  2. 安裝 cq-social-scorm-package,2.2版.

  3. 從下載套件 /libs/social/config/scorm/ScormEngine.zip 並提取相同的。

  4. 前往 安裝程式 已提取目錄的資料夾。

  5. 更新 SystemDatabaseConnectionStringscorm db connection url 檔案 EngineInstall.xml.

  6. 使用以下命令在Installer資料夾中運行mysql架構升級工具:

    java -Dlogback.configurationFile=logback.xml -cp "lib/*" RusticiSoftware.ScormContentPlayer.Logic.Upgrade.ConsoleApp EngineInstall.xml

  7. 監視 engine_upgrade.log 檔案,以了解任何錯誤和架構升級狀態。

  8. 新增 /content/communities/scorm/RecordResults in 排除的路徑 CSRF濾波器中的屬性 https://<hostname>:<port>/system/console/configMgr 發佈商。

SCORM記錄 scorm-logging

安裝後,所有啟用活動都會正確記錄到系統主控台。

如有需要,可將 RusticiSoftware.* 包。

如需使用記錄檔的相關資訊,請參閱 使用審核記錄和日誌檔案.

AEM進階MLS aem-advanced-mls

為了支援進階多語言搜尋(MLS),SRP集合(MSRP或DSRP)除了自訂結構和Solr組態外,還需要新的Solr外掛程式。 所有必要項目都封裝成可下載的zip檔案。

您可從Adobe存放庫取得進階MLS下載(也稱為「phasetwo」):

  • AEM-SOLR-MLS-phasetwo

    若要取得進階MLS套件,請參閱 AEM進階MLS (在說明檔案的部署區段中)。

    • 1.2.40版,2016年4月6日
    • 下載AEM-SOLR-MLS-phasetwo-1.2.40.zip

如需詳細資訊和安裝資訊,請造訪 Solr配置 SRP.

AdobeAEM Cloud中可見的套件

此頁面上的套件連結不需要執行任何AEM例項,因為它們要在上封裝共用 adobeaemcloud.com. 當可檢視套件時, Install按鈕,將套件安裝至Adobe托管網站。 如果要安裝在本機AEM執行個體,請選取 Install會導致錯誤。

如何在本機AEM執行個體上安裝

若要安裝中可見的套件 adobeaemcloud.com 在本機AEM執行個體上,必須先將套件下載至本機磁碟:

  • 選取 資產 標籤
  • 選擇 下載到磁碟

在本機AEM例項上,使用套件管理器(例如 http://localhost:4502/crx/packmgr/),上傳至本機AEM套件存放庫。

或者,從本機AEM例項使用套件共用來存取套件(例如 http://localhost:4502/crx/packageshare/), Download按鈕會下載至本機AEM例項的套件存放庫。

進入本機AEM例項的套件存放庫後,請使用套件管理器來安裝套件。

如需詳細資訊,請造訪 如何使用套件.

建議的部署 recommended-deployments

在AEM Communities中,通用存放區用於儲存使用者產生的內容(UGC),通常稱為 儲存資源提供程式(SRP). 建議的部署中心是為通用商店選擇SRP選項。

通用商店支援在發佈環境中協調和分析UGC,同時不需要 複製 UGC的。

升級 upgrading

從舊版AEM升級至AEM 6.4平台時,請務必閱讀升級至AEM 6.4。

除了升級平台外,請閱讀 升級至AEM Communities 6.4 了解社群變更。

設定 configurations

主要發行者 primary-publisher

當選擇的部署為 發佈農場,則必須將一個AEM發佈例項識別為 primary publisher 適用於不應發生在所有例項的活動,例如依賴的功能 通知Adobe Analytics.

依預設, AEM Communities Publisher Configuration OSGi設定是使用 Primary Publisher 核取方塊,使發佈伺服器陣列中的所有發佈執行個體都能自行識別為主要。

因此,有必要 在所有次要發佈執行個體上編輯設定 取消選中 Primary Publisher 核取方塊。

chlimage_1-411

對於發佈伺服器陣列中的所有其他(次要)發佈執行個體:

製作上的復寫代理 replication-agents-on-author

復寫適用於在發佈環境中建立的網站內容,例如社群群組,以及使用 隧道服務.

對於主要發佈者,請確定 複製代理配置 正確識別發佈伺服器和授權使用者。 預設授權用戶, admin, 已具有適當的權限(是 Communities Administrators)。

為了讓某些其他使用者擁有適當的權限,他們必須新增為 administrators 使用者群組(也是 Communities Administrators)。

製作環境中有兩個復寫代理需要正確設定傳輸設定。

  • 在作者上存取復寫主控台

    • 從全局導航: 「工具」>「部署」>「復寫」>「作者上的代理」
  • 請對兩個代理執行相同的步驟:

    • 預設代理(發佈)

    • 反向復寫代理(發佈反向)

      1. 選擇代理
      2. 選擇 編輯
      3. 選取 運輸 標籤
      4. 如果不是埠 4503,編輯 URI 要指定正確的埠
      5. 如果不是用戶 admin,編輯 使用者密碼 指定 administrators 使用者群組

下圖顯示了埠從4503更改為6103的結果:

預設代理(發佈) default-agent-publish

chlimage_1-412

反向復寫代理(發佈反向) reverse-replication-agent-publish-reverse

chlimage_1-413

作者的通道服務 tunnel-service-on-author

將製作環境用於 建立網站, 修改站點屬性管理社群成員,則必須存取在發佈環境中註冊的成員(使用者),而非在作者上註冊的使用者。

隧道服務使用製作上的復寫代理提供此存取。

要啟用通道服務,請執行以下操作:

chlimage_1-414

複製加密密鑰 replicate-the-crypto-key

AEM Communities有兩項功能需要所有AEM伺服器執行個體使用相同的加密金鑰。 這些是 AnalyticsASRP.

自AEM 6.3起,重要資料會儲存在檔案系統中,而不再儲存在存放庫中。

為了將關鍵材料從作者複製到所有其他實例,必須:

  • 存取AEM例項,通常為製作例項,其中包含要複製的重要資料

    • 找出 com.adobe.granite.crypto.file 本地檔案系統中的綁定

      例如,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • bundle.info 檔案將識別套件組合
    • 導覽至資料夾

      例如,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • 複製hmac和主節點檔案

  • 針對每個目標AEM例項

    • 導覽至資料夾

      例如,

      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • 貼上先前複製的2個檔案

    • 有必要 重新整理Granite加密套件 如果target AEM例項目前執行中

CAUTION
如果已基於加密密鑰配置了另一個安全功能,則複製加密密鑰可能會損壞配置。 為了協助, 聯絡客戶服務.

存放庫復寫 repository-replication

如同AEM 6.2及更舊版本一樣,將關鍵資料儲存在儲存庫中,可在每個AEM執行個體首次啟動時(會建立初始存放庫)指定下列系統屬性,以保留:

  • -Dcom.adobe.granite.crypto.file.disable=true
NOTE
請務必確認 製作時的復寫代理 已正確設定。

將密鑰資料儲存在儲存庫中後,將加密密鑰從作者複製到其他實例的方式如下:

使用 CRXDE Lite:

chlimage_1-415

重新整理Granite加密套件組合 refresh-the-granite-crypto-bundle

chlimage_1-416

  • 過了一會兒, 成功 對話方塊中顯示:

    Operation completed successfully.

Apache HTTP Server apache-http-server

如果使用Apache HTTP伺服器,請確保對所有相關條目使用正確的伺服器名稱。

尤其是,請小心使用正確的伺服器名稱,而非 localhost,在 RedirectMatch.

httpd.conf範例 httpd-conf-sample

<IfModule alias_module>
     # XAMPP does not have a favicon; this prevents any 404 errors which may arise.
     Redirect 404 /favicon.ico
     <Location /favicon.ico>
         ErrorDocument 404 "No favicon"
     </Location>

    # Return from "Sign Out" generates response header directing you to "/", generating a 404 error
    # The RedirectMatch resolves it correctly when modified for the target Community Site:
    RedirectMatch ^/$ https://[server name]/content/sites/engage/en.html
 ...
 </IfModule>

Dispatcher dispatcher

如果使用Dispatcher,請參閱:

相關社群檔案 related-communities-documentation

  • 瀏覽 管理社群網站 了解如何建立社群網站、設定社群網站範本、協調社群內容、管理成員及設定訊息。

  • 瀏覽 開發社區 了解社交元件架構(SCF)和自訂社群元件和功能。

  • 瀏覽 編寫Communities元件 了解如何使用和設定Communities元件。

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6