部署社群

必備條件

• AEM 6.5平台

• AEM Communities授權

• 可選許可：

  • Adobe Analytics for Communities功能
  • MSRP適用的MongoDB
  • 適用於ASRP的Adobe雲

安裝檢查清單

針對 AEM平台

• 安裝最新AEM 6.5更新

• 如果未使用預設埠(4502、4503)，則配置複製代理

• 複製加密密鑰

• 如果支援全球化，請設定自動翻譯
  （提供開發用的範例設定）

Communities功 能

• 如果部署publish farm,將標識主發佈伺服器

• 啟用通道服務

• 啟用社交登入

• 設定Adobe Analytics

• 設定預設電子郵件服務

• 確定共用UGC儲存的選擇(SRP)

  • 如果MongoDB SRP (MSRP)

    • 安裝和配置MongoDB
    • 配置Solr
    • 選擇MSRP

  • 如果關係資料庫SRP (DSRP)

    • 安裝MySQL的JDBC驅動程式
    • 安裝和配置DSRP適用的MySQL
    • 配置Solr
    • 選擇DSRP

  • 如果AdobeSRP (ASRP)

    • 與您的帳戶代表合作以進行布建
    • 選擇ASRP

  • 如果JCR SRP (JSRP)

    • 非共用UGC存放區：

      • UGC從未複製

      • UGC僅顯示在輸入UGC的AEM例項或叢集上

      • 預設為JSRP

  針對​啟用功能

  • 安裝和配置FFmpeg
  • 安裝MySQL的JDBC驅動程式
  • 安裝AEM Communities SCORM引擎
  • 安裝並配置MySQL以啟用

最新發行

AEM 6.5 Communities GA包含Communities套件。 若要了解AEM 6.5 Communities的更新，請參閱AEM 6.5發行說明。

AEM 6.5更新

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

如需AEM 6.5的最新更新，請參閱Adobe Experience Manager 6.4 Cumulative Fix Pack和Service Pack。

版本記錄

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

MySQL的JDBC驅動程式

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

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

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

必要步驟為：

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

   • 版本必須>= 5.1.38

2. 從封存中擷取mysql-connector-java-<version>-bin.jar（套件組合）

3. 使用Web主控台來安裝和啟動套件組合：

   • 例如， https://localhost:4502/system/console/bundles
   • 選取 Install/Update
   • 瀏覽……以選取從下載的ZIP封存擷取的套件組合
   • 檢查​Oracle公司的MySQLcom.mysql.jdbc JDBC驅動程式是否處於活動狀態，如果未活動，則啟動它（或檢查日誌）

4. 如果在配置JDBC後在現有部署上進行安裝，則從Web控制台中重新保存JDBC配置，將JDBC重新綁定到新連接器：

   • 例如， https://localhost:4502/system/console/configMgr
   • 找到Day Commons JDBC Connections Pool配置
   • 選擇以開啟
   • 選取 Save

5. 在所有製作和發佈執行個體上重複步驟3和4

有關安裝套件的詳細資訊，請參見Web控制台頁。

範例：已安裝的MySQL連接器套件組合

SCORM套件

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

enablement功能需要AEM Communities SCORM引擎。 AEM 6.5社群支援的Scorm套件：

• cq-social-scorm-package,2.3.7版 ，包含 SCORM 2017.1 引擎。

安裝SCORM包

1. 從「封裝共用」安裝cq-social-scorm-package，版本2.3.7。
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記錄

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

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

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

AEM進階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

有關詳細資訊和安裝資訊，請訪問SRP的Solr配置。

關於封裝共用的連結

AdobeAEM Cloud中可見的套件

此頁面上的套件連結不需要AEM的執行個體，因為它們要在adobeaemcloud.com上套件共用。 在可查看包時，Install按鈕用於將包安裝到托管Adobe的站點中。 如果想要安裝在本機AEM執行個體上，選取Install將會導致錯誤。

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

若要在本機AEM執行個體上安裝顯示於adobeaemcloud.com的套件，必須先將套件下載至本機磁碟：

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

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

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

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

如需詳細資訊，請造訪如何使用套件。

建議的部署

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

公用存放區支援在發佈環境中協調UGC並啟用分析，同時不需要UGC的復寫。

• 社群內容商店 :討論AEM社群的SRP儲存選項

• 建議的拓撲 :根據使用案例和SRP選擇討論要使用的拓撲

升級

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

除了升級平台，請閱讀升級至AEM Communities 6.5以了解Communities的變更。

設定

主要發行者

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

預設情況下， AEM Communities Publisher Configuration OSGi設定會勾選「Primary Publisher 」核取方塊，使發佈伺服器陣列中的所有發佈執行個體都能自行識別為主要。

因此，必須​編輯所有次要發佈執行個體​上的設定，以取消勾選​Primary Publisher​核取方塊。

對於發佈伺服器陣列中的所有其他（次要）發佈執行個體：

• 具有管理員權限的登入

• 訪問Web控制台

  • 例如， https://localhost:4503/system/console/configMgr

• 找到AEM Communities Publisher Configuration

• 選取編輯圖示

• 取消選中​Primary Publisher​框

• 選擇​保存

製作上的復寫代理

復寫用於在發佈環境中建立的網站內容，例如社群群組，以及使用tunnel service管理製作環境中的成員和成員群組。

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

為了讓某些其他用戶擁有相應的權限，他們必須作為成員添加到administrators用戶組（也是Communities Administrators的成員）。

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

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

  • 從全局導航，導航到​工具 > 部署 > 複製 > 作者上的代理

• 請對兩個代理執行相同的程式：

  • 預設代理（發佈）

  • 反向復寫代理（發佈反向）

    1. 選擇代理

    2. 選擇​edit

    3. 選擇​Transport​頁簽

    4. 如果沒有埠4503，請編輯​URI​以指定正確的埠

    5. 如果不是用戶admin，請編輯​用戶​和​密碼​以指定administrators用戶組的成員

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

預設代理（發佈）

反向復寫代理（發佈反向）

作者的通道服務

使用製作環境建立網站🔗、修改網站屬性或管理社群成員時，必須存取在發佈環境中註冊的成員（使用者），而非在作者上註冊的使用者。

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

要啟用通道服務，請執行以下操作：

• 以管理權限登入您的製作執行個體。

• 如果發佈者不是localhost:4503或傳輸使用者不是admin,
  然後配置複製代理

• 訪問Web控制台

  • 例如， https://localhost:4502/system/console/configMgr

• 找到AEM Communities Publish Tunnel Service

• 選取編輯圖示

• 勾選​enable​方塊

• 選擇​保存

  

複製加密密鑰

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

從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加密套件組合

存放庫復寫

如同AEM 6.2及更舊版本一樣，將關鍵資料儲存在儲存庫中，可借由在每個AEM例項（會建立初始存放庫）首次啟動時指定下列系統屬性來保留：

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

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

使用CRXDE Lite:

• 瀏覽至https://<server>:<port>/crx/de

• 選取 /etc/key

• 開啟Replication標籤

• 選取 Replicate

• 重新整理Granite加密套件組合

  

重新整理Granite加密套件組合

• 在每個發佈實例上，訪問Web控制台

  • 例如， https://<server>:<port>/system/console/bundles

• 找到Adobe Granite Crypto Support套件組合(com.adobe.granite.crypto)

• 選擇​刷新

  

• 稍後，應該會出現​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，請參閱：

• AEM Dispatcher檔案
• 安裝 Dispatcher
• 為社群設定Dispatcher
• 已知問題

相關社群檔案

• 請訪問管理社區站點了解如何建立社區站點、配置社區站點模板、協調社區內容、管理成員和配置消息。

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

• 請造訪編寫社群元件，了解如何使用和設定社群元件。