部署社群 deploying-communities

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

主題：

建立對象：

undefined

先決條件 prerequisites

安裝檢查清單 installation-checklist

AEM平台的

安裝最新的AEM 6.5更新
如果未使用預設連線埠(4502、4503)，則設定復寫代理程式
復寫加密金鑰
如果支援全球化，設定自動化翻譯
（提供範例設定以進行開發）

針對Communities功能

如果部署發佈伺服器陣列，請識別主要發行者
啟用通道服務
啟用社交登入
設定 Adobe Analytics
設定預設電子郵件服務
識別共用UGC存放區 (SRP)的選擇
- 如果MongoDB SRP (MSRP)
- 如果關聯式資料庫SRP (DSRP)
- 如果AdobeSRP (ASRP)
  - 與您的客戶代表合作進行布建
  - 選取ASRP
- 若為JCR SRP (JSRP)
  - 不是共用的UGC （使用者產生的內容）存放區：
    - 從未復寫UGC
    - UGC只會顯示在輸入它的AEM執行個體或叢集上
    - 預設為JSRP

建議的部署 recommended-deployments

在AEM Communities中，公用存放區是用來儲存UGC，通常稱為儲存資源提供者(SRP)。建議的部署著重於為通用存放區選擇SRP選項。

通用存放區支援在發佈環境中稽核UGC以及對UGC進行分析，同時消除對UGC 復寫的需求。

社群內容存放區：討論AEM Communities的SRP儲存選項
建議的拓撲：根據使用案例和SRP選擇討論要使用的拓撲

升級 upgrading

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

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

設定 configurations

主要發行者 primary-publisher

當選擇的部署是發佈伺服器陣列時，則必須將一個AEM發佈執行個體識別為不應在所有執行個體上發生的活動的 primary publisher。例如，依賴通知或 Adobe Analytics 的功能。

根據預設，AEM Communities Publisher Configuration OSGi設定是使用 Primary Publisher 核取方塊來設定，因此發佈伺服器陣列中的所有發佈執行個體都會自行識別為主要執行個體。

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

主要發行者

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

以系統管理員許可權登入
存取網頁主控台
- 例如，https://localhost:4503/system/console/configMgr
找到AEM Communities Publisher Configuration
選取編輯圖示
取消勾選 主要發行者 方塊
選取儲存

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

復寫用於發佈環境中建立的網站內容，例如社群群組，以及使用通道服務管理作者環境中的成員與成員群組。

對於主要發行者，請確定復寫代理程式設定正確識別發行伺服器和授權使用者。預設授權使用者admin,已經擁有適當的許可權（Communities Administrators的成員）。

其他使用者若要擁有適當的許可權，必須將其新增為administrators使用者群組（也是Communities Administrators的成員）的成員。

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

存取作者上的復寫主控台
- 從全域導覽，瀏覽至工具 > 部署 > 復寫 > 作者代理程式
請對這兩個代理程式遵循相同的程式：
- 預設代理程式（發佈）
- 反向復寫代理程式（反向發佈）
  1. 選取代理程式
  2. 選取編輯
  3. 選取傳輸標籤
  4. 如果它不是連線埠4503，請編輯 URI 以指定正確的連線埠
  5. 如果不是使用者admin，請編輯 使用者 和密碼以指定administrators使用者群組的成員

下列影像顯示透過將連線埠從4503變更為6103的結果：

預設代理程式（發佈） default-agent-publish

default-agent-publish

反向復寫代理程式（反向發佈） reverse-replication-agent-publish-reverse

reverse-replication-agent

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

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

通道服務使用作者上的復寫代理程式提供此存取權。

若要啟用通道服務：

以作者執行個體的管理許可權登入。
如果發行者不是localhost：4503或傳輸使用者不是admin，
然後設定復寫代理程式
存取網頁主控台
- 例如，https://localhost:4502/system/console/configMgr
找到AEM Communities Publish Tunnel Service
選取編輯圖示
勾選啟用方塊
選取儲存

復寫加密金鑰 replicate-the-crypto-key

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
- 貼上先前複製的兩個檔案
- 如果目標AEM執行個體正在執行，則必須重新整理Granite Crypto套件

CAUTION

如果已經設定了另一個以加密金鑰為基礎的安全性功能，則複製加密金鑰可能會損壞設定。如需協助，請連絡客戶服務。

存放庫復寫 repository-replication

將關鍵資料儲存在存放庫中(例如AEM 6.2和更早版本)可以保留。在每個AEM執行個體（建立初始存放庫）第一次啟動時指定系統屬性-Dcom.adobe.granite.crypto.file.disable=true。

NOTE

驗證作者🔗上的復寫代理程式是否已正確設定。

將金鑰資料儲存在存放庫後，將密碼編譯金鑰從製作例項複製到其他例項的方式如下：

使用CRXDE Lite：

瀏覽至https://<server>：<port>/crx/de
選取/etc/key
開啟Replication索引標籤
選取Replicate
重新整理Granite加密套件組合

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

在每個發佈執行個體上，存取網頁主控台
- 例如，https://<伺服器>：<連線埠>/system/console/bundles
找到Adobe Granite Crypto Support套件(com.adobe.granite.crypto)
選取 重新整理
過了一會兒，應該會出現 Success 對話方塊：
Operation completed successfully.

Apache HTTP Server apache-http-server

如果使用Apache HTTP伺服器，請確定您對所有相關專案使用正確的伺服器名稱。

特別是，請注意在RedirectMatch中使用正確的伺服器名稱，而不是localhost。

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，請參閱：

部署社群 deploying-communities

先決條件 prerequisites

安裝檢查清單 installation-checklist

最新版本 latest-releases

AEM 6.5更新 aem-updates

版本記錄 version-history

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

範例：已安裝MySQL聯結器套件組合 example-installed-mysql-connector-bundle

AEM進階MLS aem-advanced-mls

建議的部署 recommended-deployments

升級 upgrading