部署社区 deploying-communities

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined

先决条件 prerequisites

安装核对清单 installation-checklist

针对AEM平台的

安装最新的AEM 6.5更新
如果不使用默认端口(4502、4503)，则配置复制代理
复制加密密钥
如果支持全球化，请设置自动翻译
（为开发提供了示例设置）

针对Communities功能的

如果部署发布场，则标识主发布者
启用通道服务
启用社交登录
配置Adobe Analytics
设置默认电子邮件服务
识别共享UGC存储 (SRP)的选择
- 如果MongoDB SRP (MSRP)
- 如果关系数据库SRP (DSRP)
- 如果AdobeSRP (ASRP)
  - 与您的客户代表合作进行配置
  - 选择ASRP
- 如果JCR SRP (JSRP)
  - 不是共享的UGC（用户生成的内容）存储：
    - 从不复制UGC
    - UGC仅在输入它的AEM实例或群集中可见
    - 默认值为JSRP

建议的部署 recommended-deployments

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

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

社区内容存储：讨论AEM Communities的SRP存储选项
推荐的拓扑：根据用例和SRP选择讨论要使用的拓扑

升级 upgrading

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

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

配置 configurations

主要发布者 primary-publisher

如果选择的部署是发布场，则必须将一个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
选择编辑图标
取消选中 主发布者 框
选择保存

创作实例上的复制代理 replication-agents-on-author

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

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

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

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

访问作者的“复制”控制台
- 从全局导航中，导航到工具 > 部署 > 复制 > 作者代理
对两个代理均遵循相同的过程：
- 默认代理（发布）
- 反向复制代理（发布反向）
  1. 选择代理
  2. 选择编辑
  3. 选择传输选项卡
  4. 如果它不是端口4503，请编辑 URI 以指定正确的端口
  5. 如果不是用户admin，请编辑用户和密码以指定administrators用户组的成员

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

默认代理（发布） default-agent-publish

default-agent-publish

反向复制代理（反向发布） reverse-replication-agent-publish-reverse

reverse-replication-agent

作者上的通道服务 tunnel-service-on-author

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

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

启用通道服务：

使用作者实例上的管理权限登录。
如果发布者不是localhost：4503或传输用户不是admin，
然后配置复制代理
访问Web控制台
- 例如，https://localhost:4502/system/console/configMgr
找到AEM Communities Publish Tunnel Service
选择编辑图标
选中启用框
选择保存

复制加密密钥 replicate-the-crypto-key

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

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

存储库复制 repository-replication

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

NOTE

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

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

使用CRXDE Lite：

浏览至https://<服务器>：<端口>/crx/de
选择/etc/key
打开Replication选项卡
选择Replicate
刷新Granite加密包

刷新Granite加密包 refresh-the-granite-crypto-bundle

在每个发布实例上，访问Web控制台
- 例如，https://<服务器>：<端口>/system/console/bundles
找到Adobe Granite Crypto Support包(com.adobe.granite.crypto)
选择刷新
片刻后，应该会显示成功对话框：
Operation completed successfully.

Apache HTTP Server apache-http-server

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

特别是，在RedirectMatch中使用正确的服务器名称，而不是localhost。

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，请参阅：

部署社区 deploying-communities

先决条件 prerequisites

安装核对清单 installation-checklist

最新版本 latest-releases

AEM 6.5更新 aem-updates

版本历史记录 version-history

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

示例：已安装MySQL连接器捆绑包 example-installed-mysql-connector-bundle

AEM高级MLS aem-advanced-mls

建议的部署 recommended-deployments

升级 upgrading