文档AEM 6.5Communities 指南

部署社区

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：
  • 社区

创建对象：

  • 管理员

先决条件

  • AEM 6.5平台

  • AEM Communities许可证

  • 可选许可证：

    • Adobe Analytics for Communities功能
    • MongoDB for MSRP
    • ASRP的Adobe云

安装核对清单

针对AEM平台​的

  • 安装最新的AEM 6.5更新

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

  • 复制加密密钥

  • 如果支持全球化，请设置自动翻译
    （为开发提供了示例设置）

针对Communities功能​的

  • 如果部署发布场，则标识主发布者

  • 启用通道服务

  • 启用社交登录

  • 配置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

最新版本

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驱动程序

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

  • 对于DSRP：存储UGC

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

必需的步骤包括：

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

    • 版本必须>= 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连接器捆绑包

连接器包

AEM高级MLS

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

高级MLS下载（也称为phasetwo）可从Adobe存储库中获取：

  • AEM-SOLR-MLS-phasetwo

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

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

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

关于指向包共享的链接

在AdobeAEM Cloud中可见的​ 包

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

如何在本地AEM实例上安装

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

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

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

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

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

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

建议的部署

在AEM Communities中，公用存储用于存储UGC，通常称为存储资源提供程序(SRP)。 建议的部署重点是为公用存储选择SRP选项。

公用存储支持在发布环境中审核UGC并对其进行分析，同时消除了UGC的复制的需要。

  • 社区内容存储 ：讨论AEM Communities的SRP存储选项

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

升级

从以前版本的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 ​复选框。

primary-publisher

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

  • 使用管理员权限登录

  • 访问Web控制台

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

  • 找到AEM Communities Publisher Configuration

  • 选择编辑图标

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

  • 选择​ 保存

创作实例上的复制代理

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

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

对于其他某个用户而言，要拥有相应的权限，必须将其添加为administrators用户组（也是Communities Administrators的成员）的成员。

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

  • 访问作者的“复制”控制台

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

  • 对两个代理均遵循相同的过程：

    • 默认代理（发布）

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

      1. 选择代理

      2. 选择​ 编辑

      3. 选择​ 传输 ​选项卡

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

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

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

默认代理（发布）

default-agent-publish

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

reverse-replication-agent

作者上的通道服务

使用作者环境创建站点、修改站点属性或管理社区成员时，必须访问在发布环境中注册的成员（用户），而不是在作者中注册的用户。

通道服务使用创作实例上的复制代理提供此访问权限。

启用通道服务：

  • 使用作者实例上的管理权限登录。

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

  • 访问Web控制台

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

  • 找到AEM Communities Publish Tunnel Service

  • 选择编辑图标

  • 选中​ 启用 ​框

  • 选择​ 保存

    通道服务

复制加密密钥

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

    • 粘贴之前复制的两个文件

    • 如果目标AEM实例正在运行，则必须刷新Granite加密包

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

存储库复制

将关键资料存储在存储库中(如AEM 6.2及更早版本)可以保留。 在每个AEM实例首次启动时指定系统属性-Dcom.adobe.granite.crypto.file.disable=true（这将创建初始存储库）。

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

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

使用CRXDE Lite：

  • 浏览至https://<服务器>：<端口>/crx/de

  • 选择/etc/key

  • 打开Replication选项卡

  • 选择Replicate

  • 刷新Granite加密包

    replicare-repository

刷新Granite加密包

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

    • 例如，https://<服务器>：<端口>/system/console/bundles

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

  • 选择​ 刷新

    granite-crypto

  • 片刻后，应该会显示​ 成功 ​对话框：
    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)和自定义社区组件和功能。

  • 访问创作社区组件，您可以在其中了解如何使用及配置社区组件。

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791