部署社区 deploying-communities
先决条件 prerequisites
-
AEM Communities许可证
-
可选许可证:
安装核对清单 installation-checklist
针对AEM平台的
最新版本 latest-releases
AEM 6.5 Communities GA包含Communities包。 要了解有关AEM 6.5 社区更新的更多信息,请参阅AEM 6.5发行说明。
AEM 6.5更新 aem-updates
从AEM 6.4开始,对Communities的更新作为AEM累积修补程序包和Service Pack的一部分提供。
有关AEM 6.5的最新更新,请参阅Adobe Experience Manager 6.4累积修补程序包和Service Pack。
版本历史记录 version-history
与AEM 6.4及更高版本一样,AEM Communities功能和修补程序是AEM Communities累积修补程序包和Service Pack的一部分。 因此,没有单独的功能包。
用于MySQL的JDBC驱动程序 jdbc-driver-for-mysql
一个Communities功能使用MySQL数据库:
- 对于DSRP:存储UGC
必须单独获取和安装MySQL连接器。
必需的步骤包括:
-
从https://dev.mysql.com/downloads/connector/j/下载ZIP存档
- 版本必须>= 5.1.38
-
从存档中提取mysql-connector-java-<version>-bin.jar(捆绑)
-
使用Web控制台安装和启动捆绑包:
- 例如, https://localhost:4502/system/console/bundles
- 选择
Install/Update
- 浏览……以选择从下载的ZIP存档提取的包
- 检查 Oracle公司用于MySQLcom.mysql.jdbc 的JDBC驱动程序是否处于活动状态,如果未处于活动状态,则启动它(或检查日志)
-
如果在配置JDBC后在现有部署上进行安装,则通过从Web控制台重新保存JDBC配置将JDBC重新绑定到新连接器:
- 例如, https://localhost:4502/system/console/configMgr
- 找到
Day Commons JDBC Connections Pool
配置 - 选择以打开
- 选择
Save
-
对所有创作和发布实例重复步骤3和4
有关安装捆绑包的更多信息,请访问Web控制台页面。
示例:已安装MySQL连接器捆绑包 example-installed-mysql-connector-bundle
AEM高级MLS aem-advanced-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配置。
关于指向包共享的链接 about-links-to-package-share
在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实例的包存储库后,使用包管理器安装包。
有关详细信息,请访问如何使用包。
建议的部署 recommended-deployments
在AEM Communities中,公用存储用于存储UGC,通常称为存储资源提供程序(SRP)。 建议的部署重点是为公用存储选择SRP选项。
公用存储支持在发布环境中审核UGC并对其进行分析,同时消除了UGC的复制的需要。
升级 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
复选框。
对于发布场中的所有其他(辅助)发布实例:
-
使用管理员权限登录
-
访问Web控制台
-
找到
AEM Communities Publisher Configuration
-
选择编辑图标
-
取消选中 主发布者 框
-
选择 保存
创作实例上的复制代理 replication-agents-on-author
复制用于发布环境中创建的站点内容,如社区组,并使用通道服务从创作环境中管理成员和成员组。
对于主要发布者,请确保复制代理配置正确标识发布服务器和授权用户。 默认授权用户admin,
已具有相应的权限(是Communities Administrators
的成员)。
对于其他某个用户而言,要拥有相应的权限,必须将其添加为administrators
用户组(也是Communities Administrators
的成员)的成员。
创作环境中有两个复制代理需要正确配置传输配置。
-
访问作者的“复制”控制台
- 从全局导航中,导航到 工具 > 部署 > 复制 > 作者代理
-
对两个代理均遵循相同的过程:
-
默认代理(发布)
-
反向复制代理(发布反向)
-
选择代理
-
选择 编辑
-
选择 传输 选项卡
-
如果它不是端口
4503
,请编辑 URI 以指定正确的端口 -
如果不是用户
admin
,请编辑 用户 和 密码 以指定administrators
用户组的成员
-
-
下图显示了将端口从4503更改为6103的结果:
默认代理(发布) default-agent-publish
反向复制代理(反向发布) reverse-replication-agent-publish-reverse
作者上的通道服务 tunnel-service-on-author
使用作者环境创建站点、修改站点属性或管理社区成员时,必须访问在发布环境中注册的成员(用户),而不是在作者中注册的用户。
通道服务使用创作实例上的复制代理提供此访问权限。
启用通道服务:
复制加密密钥 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加密包
-
存储库复制 repository-replication
将关键资料存储在存储库中(如AEM 6.2及更早版本)可以保留。 在每个AEM实例首次启动时指定系统属性-Dcom.adobe.granite.crypto.file.disable=true
(这将创建初始存储库)。
将密钥资料存储在存储库中,将加密密钥从创作实例复制到其他实例的方式如下:
使用CRXDE Lite:
-
选择
/etc/key
-
打开
Replication
选项卡 -
选择
Replicate
-
刷新Granite加密包 refresh-the-granite-crypto-bundle
-
在每个发布实例上,访问Web控制台
-
找到
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,请参阅: