部署社区

前提条件

安装核对清单

对于 AEM平台

用于社 区功能

最新版本

AEM 6.4 Communities GA包含Communities包。 要了解AEM 6.4 Communities的更新,请参阅AEM 6.4发行说明

AEM 6.4更新

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

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

版本历史记录

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

MySQL的JDBC驱动程序

“两个社区”功能使用MySQL数据库:

  • 对于enablement:记录SCORM活动和学习者
  • 对于DSRP:存储用户生成的内容(UGC)

必须单独获取和安装MySQL连接器。

必要步骤包括:

  1. https://dev.mysql.com/downloads/connector/j/下载ZIP存档

    • 版本必须>= 5.1.38
  2. 从存档中提取mysql-connector-java-<版本>-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连接器包

chlimage_1-410

SCORM包

可共享内容对象引用模型(SCORM)是用于电子学习的标准和规范的集合。 SCORM还定义如何将内容打包到可传输的ZIP文件中。

enablement功能需要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. 从cq实例下载​/libs/social/config/scorm/database_scormengine_data.sql​并在mysql服务器中执行该实例,以创建已升级的scormEngineDB模式。
  3. 在发布者的https://<hostname>;:<port>/system/console/configMgr筛选器中的CSRF的“排除的路径”属性中添加/content/communities/scorm/RecordResults

如果创作的课程内容需要SCORM 2017.1,则现有SCORM安装可升级为​cq-social-scorm-package,版本2.2.2(使用SCORM 2017.1)。

注意

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

升级SCORM引擎版本

  1. 备份ScormEngineDB架构。

  2. 安装​cq-social-scorm-package,版本2.2.2

  3. /libs/social/config/scorm/ScormEngine.zip下载包并解压缩该包。

  4. 转到已提取目录的​Installer​文件夹。

  5. 在文件​EngineInstall.xml​中使用scorm db connection url更新SystemDatabaseConnectionString

  6. 使用命令在Installer文件夹中运行mysql模式升级工具:

    java -Dlogback.configurationFile=logback.xml -cp "lib/*" RusticiSoftware.ScormContentPlayer.Logic.Upgrade.ConsoleApp EngineInstall.xml

  7. 监视engine_upgrade.log文件,以了解任何类型的错误和模式升级状态。

  8. 在发布者的https://<hostname>:<port>/system/console/configMgr中,在CSRF筛选器的​排除的路径​属性中添加/content/communities/scorm/RecordResults

SCORM日志记录

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

如果需要,可以将RusticiSoftware.*包的日志级别设置为“警告”。

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

AEM Advanced MLS

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

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

  • AEM-SOLR-MLS-phasetwo

    要获取高级MLS包,请参阅文档部署部分的AEM高级MLS

    • 1.2.40版,2016年4月6日
    • 下载AEM-SOLR-MLS-phasetwo-1.2.40.zip

有关详细信息和安装信息,请访问Solr Configuration for SRP。

包在AdobeAEM Cloud中可见

指向此页面上的包的链接不需要运行AEM实例,因为它们要在adobeaemcloud.com上包共享。 当可以查看包时, Install按钮用于将包安装到Adobe托管站点中。 如果打算在本地AEM实例上安装,则选择Install将导致错误。

如何在本地AEM实例上安装

要在本地AEM实例上安装adobeaemcloud.com中可见的包,必须先将该包下载到本地磁盘:

  • 选择​Assets​选项卡
  • 选择​下载到磁盘

在本地AEM实例上,使用包管理器(例如http://localhost:4502/crx/packmgr/),将包上传到本地AEM包存储库。

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

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

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

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

公共存储支持在发布环境中审核UGC并对其进行分析,同时无需复制UGC的🔗

升级

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

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

配置

主发布者

如果选择的部署是发布场,则对于不应出现在所有实例上的活动(例如依赖于​notifications​或​Adobe Analytics​的功能),必须将一个AEM发布实例标识为​primary publisher

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

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

chlimage_1-411

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

创作上的复制代理

复制用于在发布环境中创建的站点内容(如社区组),以及使用tunnel service从创作环境中管理成员和成员组。

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

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

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

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

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

    • 默认代理(发布)

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

      1. 选择代理
      2. 选择​edit
      3. 选择​传输​选项卡
      4. 如果不是端口4503,请编辑​URI​以指定正确的端口
      5. 如果不是用户admin,请编辑​User​和​Password​以指定administrators用户组的成员

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

默认代理(发布)

chlimage_1-412

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

chlimage_1-413

作者的隧道服务

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

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

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

chlimage_1-414

复制加密密钥

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个文件

    • 如果目标AEM实例当前正在运行,则需要刷新Granite Crypto包

注意

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

存储库复制

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

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

务必验证作者🔗上的复制代理是否正确配置。

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

使用CRXDE Lite:

chlimage_1-415

刷新Granite加密包

chlimage_1-416

  • 片刻后,应会显示​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,请参阅:

  • 访问管理社区站点 ,了解有关创建社区站点、配置社区站点模板、审核社区内容、管理成员和配置消息传送的信息。

  • 访问开发社区 ,了解社交组件框架(SCF)和自定义社区组件和功能。

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

在此页面上