部署社区 deploying-communities

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

前提条件 prerequisites

安装核对清单 installation-checklist

对于 AEM平台

对于 社区功能

最新版本 latest-releases

AEM 6.4 Communities GA包含Communities包。 了解AEM 6.4更新 社区,请参阅 AEM 6.4发行说明.

AEM 6.4更新 aem-updates

从AEM 6.3开始,对Communities的更新将作为AEM累积修补程序包和Service Pack的一部分提供。

有关AEM 6.4的最新更新,请务必检查 Adobe Experience Manager 6.4累积修补程序包和Service Pack.

版本历史记录 version-history

与AEM 6.4及更高版本一样,AEM Communities功能和修补程序是AEM Communities累积修补程序包和Service Pack的一部分。 因此,没有单独的功能包。

MySQL的JDBC驱动程序 jdbc-driver-for-mysql

“两个社区”功能使用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.
  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.2 (使用 SCORM 2017.1),如果创作的课程内容需要SCORM 2017.1。

NOTE
升级到SCORM 2017.1包需要迁移现有数据库(如进一步说明)。

升级SCORM引擎版本

  1. 备份ScormEngineDB架构。

  2. 安装 cq-social-scorm-package,版本2.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 Advanced MLS aem-advanced-mls

为了支持高级多语言搜索(MLS),SRP集合(MSRP或DSRP)除了自定义架构和Solr配置外,还需要新的Solr插件。 所有必需项目都打包到一个可下载的zip文件中。

高级MLS下载(也称为“第二阶段”)可从Adobe存储库中获取:

  • AEM-SOLR-MLS-phasetwo

    要获取高级MLS包,请参阅 AEM Advanced 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加密包 目标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)和自定义社区组件和功能。

  • 访问 创作社区组件 了解如何使用和配置社区组件进行创作。

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