部署社区

前提条件

安装核对清单

对于 AEM平台

对于 社区功能

最新版本

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

AEM 6.5更新

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

有关AEM 6.5的最新更新,请参阅 Adobe Experience Manager 6.4累积修补程序包和Service Pack.

版本历史记录

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

MySQL的JDBC驱动程序

“两个社区”功能使用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控制台安装并启动包:

    • 例如, 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文件中。

AEM Communities SCORM引擎是 启用 功能。 AEM 6.5 Communities支持的Scorm包:

安装SCORM包

  1. 安装 cq-social-scorm-package,版本2.3.7 从包共享。
  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日志记录

安装后,所有启用活动都会被垂直记录到系统控制台。

如果需要,可将 RusticiSoftware.* 包。

有关使用日志的信息,请参阅 使用审核记录和日志文件.

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实例上,使用包管理器(例如 https://localhost:4502/crx/packmgr/)上传到本地AEM包存储库。

或者,使用包共享从本地AEM实例访问包(例如, https://localhost:4502/crx/packageshare/)、 Download 按钮将下载到本地AEM实例的包存储库。

在本地AEM实例的包存储库中,使用包管理器安装包。

有关更多信息,请访问 如何使用包.

在AEM Communities中,通用商店用于存储用户生成的内容(UGC),通常称为 存储资源提供程序(SRP). 推荐的部署中心是为公共存储选择SRP选项。

该常用商店支持在发布环境中审核UGC并对其进行分析,同时不需要 复制 UGC的。

升级

从AEM的先前版本升级到AEM 6.5平台时,请务必阅读 升级到AEM 6.5.

除了升级平台之外,请阅读 升级到AEM Communities 6.5 以了解社区更改。

配置

主发布者

当选择的部署是 发布场,则必须将一个AEM发布实例标识为 primary publisher 对于不应出现在所有实例的活动,例如依赖于 通知Adobe Analytics.

默认情况下, AEM Communities Publisher Configuration OSGi配置配置了 Primary Publisher 复选框,以便发布场中的所有发布实例都可自标识为主实例。

因此,有必要 编辑所有辅助发布实例的配置 取消选中 Primary Publisher 复选框。

主发布者

对于发布场中的所有其他(辅助)发布实例:

创作上的复制代理

复制用于在发布环境中创建的站点内容(如社区组),以及使用 隧道服务.

对于主发布者,请确保 复制代理配置 正确标识发布服务器和授权用户。 默认授权用户, admin, 已具有相应的权限(是 Communities Administrators)。

为了让其他某些用户具有相应的权限,必须将他们作为成员添加到 administrators 用户组(也是 Communities Administrators)。

创作环境中有两个复制代理需要正确配置传输配置。

  • 在创作时访问复制控制台

    • 从全局导航中,导航到 工具 > 部署 > 复制 > 作者代理
  • 对于两个代理,请遵循相同的过程:

    • 默认代理(发布)

    • 反向复制代理(发布反向)

      1. 选择代理

      2. 选择 编辑

      3. 选择 运输 选项卡

      4. 如果不是端口 4503,编辑 URI 指定正确的端口

      5. 如果不是用户 admin,编辑 用户密码 指定 administrators 用户组

下图显示了将端口从4503更改为6103的结果:

默认代理(发布)

default-agent-publish

反向复制代理(发布反向)

反向复制代理

作者的隧道服务

使用创作环境时 创建站点, 修改网站属性管理社区成员,则必须访问在发布环境中注册的成员(用户),而不是在作者中注册的用户。

隧道服务使用作者上的复制代理提供此访问。

要启用隧道服务,请执行以下操作:

复制加密密钥

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实例当前正在运行

注意

如果已配置基于加密密钥的其他安全功能,则复制加密密钥可能会损坏配置。 为了帮助, 联系客户关怀团队.

存储库复制

与AEM 6.2及更早版本一样,将关键材料存储在存储库中,可通过在每个AEM实例(创建初始存储库)的首次启动时指定以下系统属性来保留该关键材料:

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

务必验证 创作时的复制代理 已正确配置。

将密钥材料存储在存储库中后,将加密密钥从创作复制到其他实例的方式如下:

使用 CRXDE Lite:

刷新Granite加密包

Apache HTTP Server

如果使用Apache HTTP服务器,请确保对所有相关条目使用正确的服务器名称。

特别是,要小心使用正确的服务器名称,而不是 localhost,在 RedirectMatch.

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)和自定义社区组件和功能。

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

在此页面上