部署社群 deploying-communities
必備條件 prerequisites
-
AEM Communities授權
-
可選許可:
安裝檢查清單 installation-checklist
若 社群功能
最新發行 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資料庫:
必須單獨獲得並安裝MySQL連接器。
必要步驟為:
-
從下載ZIP封存 https://dev.mysql.com/downloads/connector/j/
- 版本必須>= 5.1.38
-
提取mysql-connector-java-<version>-bin.jar(套件)
-
使用Web控制台來安裝和啟動套件:
- 例如, http://localhost:4502/system/console/bundles
- 選取
Install/Update
- 瀏覽……以選取從下載的ZIP封存擷取的套件組合
- 檢查 Oracle公司的MySQLcom.mysql.jdbc JDBC驅動程式 處於作用中狀態,若非則啟動(或檢查記錄)
-
如果在配置JDBC後在現有部署上進行安裝,則從Web控制台中重新保存JDBC配置,將JDBC重新綁定到新連接器:
- 例如, http://localhost:4502/system/console/configMgr
- 找出
Day Commons JDBC Connections Pool
配置 - 選擇以開啟
- 選取
Save
-
在所有製作和發佈執行個體上重複步驟3和4
有關安裝套件的詳細資訊,請參閱 Web主控台 頁面。
範例:已安裝的MySQL連接器套件組合 example-installed-mysql-connector-bundle
SCORM套件 scorm-package
共用內容物件參考模型(SCORM)是數位學習的標準與規格的集合。 SCORM也定義了如何將內容封裝成可傳輸的ZIP檔案。
AEM Communities SCORM引擎是 啟用 功能。 AEM Communities 6.4版支援的Scorm套件包括:
-
cq-social-scorm-package,1.2.11版. 所有AEM 6.4 Communities版本均支援此SCORM套件。
-
cq -social-scorm -package,版本2.2.2 包括 SCORM 2017.1 引擎。 AEM 6.4.2.x以上支援此SCORM套件。
若為新安裝的SCORM引擎,則包含 SCORM 2017.1 (其中 cq -social-scorm -package,版本2.2.2)。 以便您能播放SCORM 2017支援的學習資源。
首次安裝SCORM包
- 安裝 cq-social-scorm-package,2.2版.
- 下載
/libs/social/config/scorm/database_scormengine_data.sql
從cq實例並在mysql伺服器中執行該實例,以建立升級的scormEngineDB架構。 - 新增
/content/communities/scorm/RecordResults
在CSRF篩選器的「排除的路徑」屬性中,從https://<hostname>;:<port>/system/console/configMgr
發佈商。
現有的SCORM安裝可升級為 cq-social-scorm-package,2.2版 (使用 SCORM 2017.1),如果製作的課程內容需要SCORM 2017.1。
升級SCORM引擎版本
-
備份ScormEngineDB架構。
-
從下載套件
/libs/social/config/scorm/ScormEngine.zip
並提取相同的。 -
前往 安裝程式 已提取目錄的資料夾。
-
更新
SystemDatabaseConnectionString
與scorm db connection url
檔案 EngineInstall.xml. -
使用以下命令在Installer資料夾中運行mysql架構升級工具:
java -Dlogback.configurationFile=logback.xml -cp "lib/*" RusticiSoftware.ScormContentPlayer.Logic.Upgrade.ConsoleApp EngineInstall.xml
-
監視
engine_upgrade.log
檔案,以了解任何錯誤和架構升級狀態。 -
新增
/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.
關於封裝共用的連結 about-links-to-package-share
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
核取方塊。
對於發佈伺服器陣列中的所有其他(次要)發佈執行個體:
-
以管理員權限登入
-
存取 Web主控台
-
找出
AEM Communities Publisher Configuration
-
選取編輯圖示
-
取消核取 主要發行者 box
-
選擇 儲存
製作上的復寫代理 replication-agents-on-author
復寫適用於在發佈環境中建立的網站內容,例如社群群組,以及使用 隧道服務.
對於主要發佈者,請確定 複製代理配置 正確識別發佈伺服器和授權使用者。 預設授權用戶, admin,
已具有適當的權限(是 Communities Administrators
)。
為了讓某些其他使用者擁有適當的權限,他們必須新增為 administrators
使用者群組(也是 Communities Administrators
)。
製作環境中有兩個復寫代理需要正確設定傳輸設定。
-
在作者上存取復寫主控台
- 從全局導航: 「工具」>「部署」>「復寫」>「作者上的代理」
-
請對兩個代理執行相同的步驟:
-
預設代理(發佈)
-
反向復寫代理(發佈反向)
- 選擇代理
- 選擇 編輯
- 選取 運輸 標籤
- 如果不是埠
4503
,編輯 URI 要指定正確的埠 - 如果不是用戶
admin
,編輯 使用者 和 密碼 指定administrators
使用者群組
-
下圖顯示了埠從4503更改為6103的結果:
預設代理(發佈) default-agent-publish
反向復寫代理(發佈反向) reverse-replication-agent-publish-reverse
作者的通道服務 tunnel-service-on-author
將製作環境用於 建立網站, 修改站點屬性 或 管理社群成員,則必須存取在發佈環境中註冊的成員(使用者),而非在作者上註冊的使用者。
隧道服務使用製作上的復寫代理提供此存取。
要啟用通道服務,請執行以下操作:
複製加密密鑰 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
-
貼上先前複製的2個檔案
-
有必要 重新整理Granite加密套件 如果target AEM例項目前執行中
-
存放庫復寫 repository-replication
如同AEM 6.2及更舊版本一樣,將關鍵資料儲存在儲存庫中,可在每個AEM執行個體首次啟動時(會建立初始存放庫)指定下列系統屬性,以保留:
-Dcom.adobe.granite.crypto.file.disable=true
將密鑰資料儲存在儲存庫中後,將加密密鑰從作者複製到其他實例的方式如下:
使用 CRXDE Lite:
-
選取
/etc/key
-
open
Replication
標籤 -
選取
Replicate
重新整理Granite加密套件組合 refresh-the-granite-crypto-bundle
-
在每個發佈例項上,存取 Web主控台
-
找出
Adobe Granite Crypto Support
套件組合(com.adobe.granite.crypto) -
選擇 重新整理
-
過了一會兒, 成功 對話方塊中顯示:
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元件。