部署社區

必備條件

安裝檢查清單

適用於 AEM平台

針對社 群功能

最新版本

AEM 6.4 Communities GA包含Communities套件。 若要瞭解AEM 6.4 Communities的更新,請參閱AEM 6.4發行說明

AEM 6.4更新

從AEM 6.3開始,「社群」的更新會以AEM Cumulative Fix Pack和Service Pack的一部份提供。

如需AEM 6.4的最新更新,請務必勾選Adobe Experience Manager 6.4 Cumulative Fix Pack和Service Packs

版本歷史記錄

和AEM 6.4及更新版本一樣,AEM Communities功能和修補程式是AEM Communities累積修補程式套件和服務套件的一部分。 因此,沒有單獨的功能套件。

MySQL的JDBC驅動程式

兩個社區功能使用MySQL資料庫:

  • 對於enablement:錄制SCORM活動和學員
  • 對於DSRP:儲存使用者產生的內容(UGC)

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

必要的步驟包括:

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

    • 版本必須>= 5.1.38
  2. 從存檔檔案中提取mysql-connector-java-<version>-bin.jar(bundle)

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

    • 例如,http://localhost:4502/system/console/bundles
    • 選取 Install/Update
    • 瀏覽……若要選取從下載的ZIP封存解壓縮的套件
    • 檢查​Oracle Corporation的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連接器包

chlimage_1-410

SCORM包

可分享的內容物件參考模型(SCORM)是數位學習的標準與規格集合。 SCORM也定義如何將內容封裝在可轉讓的ZIP檔案中。

enablement功能需要AEM Communities SCORM引擎。 AEM Communities 6.4版本支援的Scorm套件包括:

對於新安裝的SCORM引擎,應使用包含SCORM 2017.1(即 cq -social- scorm -package, version 2.2)的套件。 如此,您就可以播放SCORM 2017支援的學習資源。

首次安裝SCORM套件

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

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

注意

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

若要升級SCORM引擎版本

  1. 備份ScormEngineDB架構。

  2. 安裝​cq-social-scorm-package,2.2.2版。

  3. /libs/social/config/scorm/ScormEngine.zip下載套件並解壓相同。

  4. 轉至解壓目錄的​Installer​資料夾。

  5. 在檔案​EngineInstall.xml​中使用scorm db connection url更新SystemDatabaseConnectionString

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

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

  7. 監視engine_upgrade.log檔案中是否有任何錯誤和模式升級狀態。

  8. 在發佈商的https://<hostname>:<port>/system/console/configMgrCSRF篩選器中,在​排除的路徑​屬性中新增/content/communities/scorm/RecordResults

SCORM記錄

在安裝後,所有啟用活動都會詳盡記錄到系統控制台。

如果需要,可將RusticiSoftware.*包的日誌級別設定為WARN。

有關使用日誌的資訊,請參閱使用審計記錄和日誌檔案

AEM Advanced MLS

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

進階MLS下載(也稱為'phasetwo')可從Adobe儲存庫取得:

有關詳細資訊和安裝資訊,請訪問Solr Configuration for SRP。

Adobe AEM Cloud中可見的套件

此頁面上的封裝連結不需要執行AEM例項,因為它們要在adobeaemcloud.com上封裝共用。 雖然可以檢視封裝,但Install按鈕是用來將封裝安裝至Adobe代管網站。 如果想要安裝在本機AEM例項上,選取Install將會產生錯誤。

如何安裝在本機AEM例項

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

  • 選擇​Assets​標籤
  • 選擇​下載到磁碟

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

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

在本機AEM例項的套件儲存庫中,使用套件管理器安裝套件。

有關詳細資訊,請訪問如何使用包

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

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

升級

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

除了升級平台外,請閱讀「升級至AEM Communities 6.4](upgrade.md)」以瞭解社群變更。[

設定

主要發行者

當選擇的部署是publish farm時,對於不應發生在所有例項上的活動,例如依賴​通知​或​Adobe Analytics​的功能,必須將一個AEM發佈例項識別為​primary publisher

預設情況下,AEM Communities Publisher Configuration OSGi配置已選中​Primary Publisher​複選框,這樣發佈群中的所有發佈實例都將自標識為主實例。

因此,必須​編輯所有次要發佈實例的配置 ,以取消選中​Primary Publisher​複選框。

chlimage_1-411

對於發佈群中的所有其他(次要)發佈例項:

作者上的複製代理

複製用於在發佈環境中建立的站點內容,如社區組,以及使用tunnel service從作者環境管理成員和成員組。

對於主發佈者,請確保複製代理配置正確標識發佈伺服器和授權用戶。 預設授權用戶admin,已具有相應的權限(是Communities Administrators的成員)。

為了讓某些其他用戶擁有相應的權限,必須將其作為成員添加到administrators用戶組(也是Communities Administrators的成員)。

作者環境中有兩個複製代理需要正確配置傳輸配置。

  • 在作者上訪問複製控制台

    • 從全域導覽:工具>部署>複製>作者上的代理
  • 對於兩個代理,請遵循相同的流程:

    • 預設代理(發佈)

    • 反向複製代理(發佈反向)

      1. 選擇代理
      2. 選擇​edit
      3. 選擇​Transport​頁籤
      4. 如果不是埠4503,請編輯​URI​以指定正確的埠
      5. 如果不是用戶admin,請編輯​User​和​Password​以指定administrators用戶組的成員

以下影像顯示將埠從4503更改為6103的結果:

預設代理(發佈)

chlimage_1-412

反向複製代理(發佈反向)

chlimage_1-413

作者上的隧道服務

使用作者環境建立站點](sites-console.md)、修改站點屬性管理社區成員時,必須訪問在發佈環境中註冊的成員(用戶),而不是在作者上註冊的用戶。[

隧道服務使用作者上的複製代理提供此訪問。

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

chlimage_1-414

複製加密密鑰

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個檔案

    • 如果目標AEM實例當前正在運行,則需要刷新Granite Crypto bundle

注意

如果已經配置了基於加密密鑰的其他安全功能,則複製加密密鑰可能會損壞配置。 如需協助,請聯絡客戶服務](https://helpx.adobe.com/tw/marketing-cloud/contact-support.html)。[

儲存庫複製

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

  • -Dcom.adobe.granite.crypto.file.disable=true
注意

請務必驗證author](#replication-agents-on-author)上的[複製代理是否正確配置。

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

使用CRXDE Lite:

chlimage_1-415

刷新Granite加密包

chlimage_1-416

  • 稍後,應出現​Success​對話方塊:

    Operation completed successfully.

Apache HTTP Server

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

請特別留意使用RedirectMatch中正確的伺服器名稱,而非localhost

httpd.conf示例

<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,請參閱:

  • 請造訪管理社群網站,以瞭解如何建立社群網站、設定社群網站範本、協調社群內容、管理成員以及設定訊息。

  • 請造訪開發社群以瞭解社交元件架構(SCF)和自訂社群元件和功能。

  • 請造訪編寫社群元件,以瞭解如何編寫和設定社群元件。

本頁內容