部署社区

前提条件

• AEM 6.5平台

• AEM Communities牌照

• 适用于以下用户的可选许可证：

  • Adobe Analytics社区功能
  • 用于MSRP的MongoDB
  • 适用于ASRP的Adobe云

安装清单

对于AEM 平台

• 安装最新的AEM 6.5更新

• 如果未使用默认端口(4502、4503)，则配置复制代理

• 复制加密密钥

• 如果支持全球化，则设置自动翻译](/docs/experience-manager-65/sites-administering/translation.html?lang=zh-Hans)
  （提供开发的示例设置）[

对于社 区功能

• 如果部署发布场,将标识主发布者

• 启用隧道服务

• 启用社交登录

• 配置Adobe Analytics

• 设置默认电子邮件服务

• 确定共享UGC存储(SRP)的选择

  • 如果MongoDB SRP (MSRP)

    • 安装和配置MongoDB
    • 配置Solr
    • 选择MSRP

  • 如果关系数据库SRP (DSRP)

    • 安装MySQL的JDBC驱动程序
    • 安装和配置MySQL for DSRP
    • 配置Solr
    • 选择DSRP

  • 如果AdobeSRP (ASRP)

    • 与您的客户代表合作进行设置
    • 选择ASRP

  • 如果JCR SRP (JSRP)

    • 不是共享的UGC存储：

      • UGC从未复制

      • UGC仅在输入它的AEM实例或群集上可见

      • 默认为JSRP

  对于​启用功能

  • 安装和配置FFmpeg
  • 安装MySQL的JDBC驱动程序
  • 安装AEM CommunitiesSCORM-Engine
  • 安装和配置MySQL以启用

最新版本

AEM 6.5 Communities GA包括Communities包。 要了解对AEM 6.5 Communities的更新，请参阅AEM 6.5发行说明。

AEM 6.5更新

从AEM 6.4开始，对Communities的更新作为AEM累积修复包和服务包的一部分提供。

有关AEM 6.5的最新更新，请参阅Adobe Experience Manager6.4累积修复包和服务包。

版本历史记录

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

MySQL的JDBC驱动程序

两个Communities功能使用MySQL数据库：

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

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

必要的步骤有：

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

   • 版本必须>= 5.1.38

2. 从存档中提取mysql-connector-java-<version>-bin.jar(bundle)

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文件中。

enablement功能需要AEM CommunitiesSCORM引擎。 AEM 6.5 Communities支持Scorm包：

• cq-social-scorm-package，版本2.3.7, 包括 SCORM 2017.1 引擎。

安装SCORM包

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

安装后，所有启用活动都将直接记录到系统控制台。

如果需要，可将RusticiSoftware.*包的日志级别设置为WARN。

有关使用日志的信息，请参阅使用审计记录和日志文件。

AEM高级MLS

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

高级MLS下载（也称为“phasetwo”）可从Adobe库中下载：

• AEM-SOLR-MLS-phasetwo

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

有关详细信息和安装信息，请访问SRP的Solr配置。

关于包共享的链接

包在AdobeAEM云中可见

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

如何在本地AEM实例上安装

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

• 选择​资产​选项卡
• 选择​下载到磁盘

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

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

进入本地AEM实例的包存储库后，使用包管理器安装包。

有关详细信息，请访问如何使用包。

建议的部署

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

通用存储支持发布环境中UGC的协调和分析，同时无需复制UGC的。

• 社区内容商店 :讨论AEM社区的SRP存储选项

• 推荐的拓扑 :根据用例和SRP选择讨论要使用的拓扑

升级

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

除了升级平台，请阅读升级到AEM Communities6.5以了解社区更改。

配置

主发布者

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

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

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

对于发布场中的所有其他（辅助）发布实例：

• 以管理员权限登录

• 访问Web控制台

  • 例如，https://localhost:4503/system/console/configMgr

• 找到AEM Communities Publisher Configuration

• 选择编辑图标

• 取消选中​主发布者​框

• 选择​保存

作者上的复制代理

复制用于在发布环境中创建的站点内容，如社区组，以及使用隧道服务从创作环境管理成员和成员组。

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

要使某些其他用户具有相应的权限，必须将他们添加为administrators用户组（也是Communities Administrators的成员）的成员。

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

• 在作者上访问复制控制台

  • 在全局导航中，导航到​工具 > 部署 > 复制 > 作者上的代理

• 对于两种代理，请遵循相同的流程：

  • 默认代理（发布）

  • 反向复制代理（发布反向）

    1. 选择代理

    2. 选择​edit

    3. 选择​传输​选项卡

    4. 如果不是端口4503，请编辑​URI​以指定正确的端口

    5. 如果不是用户admin，请编辑​用户​和​密码​以指定administrators用户组的成员

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

默认代理（发布）

反向复制代理（发布反向）

作者上的隧道服务

当使用作者环境创建站点](/docs/experience-manager-65/communities/sites-console.html?lang=zh-Hans)、修改站点属性或管理社区成员时，必须访问在发布环境中注册的成员（用户），而不是访问在作者上注册的用户。[

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

要启用隧道服务，请执行以下操作：

• 以管理权限登录您的创作实例。

• 如果发布者不是localhost:4503或传输用户不是admin,
  然后，配置复制代理

• 访问Web控制台

  • 例如，https://localhost:4502/system/console/configMgr

• 找到AEM Communities Publish Tunnel Service

• 选择编辑图标

• 选中​enable​框

• 选择​保存

  

复制加密密钥

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

  • 如果目标AEM实例当前正在运行，则必须刷新Granite Crypto bundle

存储库复制

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

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

密钥材料存储在存储库中，将加密密钥从作者复制到其他实例的方式如下：

使用CRXDE Lite:

• 浏览至https://<server>:<port>/crx/de

• 选择 /etc/key

• 打开Replication选项卡

• 选择 Replicate

• 刷新Granite加密捆绑

  

刷新Granite加密包

• 在每个发布实例上，访问Web控制台

  • 例如，https://<server>:<port>/system/console/bundles

• 找到Adobe Granite Crypto Support捆绑包(com.adobe.granite.crypto)

• 选择​刷新

  

• 稍后，将显示​Success​对话框：
  Operation completed successfully.

Apache HTTP Server

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

尤其要注意使用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，请参阅：

• AEM Dispatcher文档
• 安装 Dispatcher
• 为社区配置Dispatcher
• 已知问题

相关社区文档

• 访问管理社区站点，了解如何创建社区站点、配置社区站点模板、管理社区内容、管理成员和配置消息。

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

• 访问创作社区组件，了解如何创作和配置社区组件。