Depending on each site's topology and features, the following actions may be necessary when upgrading to AEM 6.2 Communities or installing the latest feature pack.
This section is specific to Communities and supplements the information provided in Upgrading to AEM 6.2 (platform).
As of AEM 6.2 Communities feature pack 3, the enablement features no longer store reporting information in MySQL. The MySQL dependency is only there for tracking SCORM content.
Please contact customer care for assistance in migrating content from Enablement 1.0.
If the upgraded site was configured to use Adobe cloud storage, then it may appear (incorrectly) as if all UGC has been lost as the SRP methods will be unable to locate the pre-existing UGC in the old location.
Thus, there is the ability to instruct ASRP to use AEM 6.0 compatability-mode to access UGC.
For all AEM 6.2 author and publish instances
- sign in with administrator privileges
- configure ASRP
- follow these steps to make pre-existing UGC visible :
- browse to the web console
- for example, http://<host>:<port>/system/console/configMgr
- locate AEM Communities Utilities configuration
- select to expand config panel
- uncheck Cloud Storage
- select Save
- browse to the web console
If the upgraded site did not use cloud storage, any pre-existing UGC must be converted to conform to the new structure introduced in AEM 6.1 Communities in support of the common store.
For this purpose, an open source migration tool is available on GitHub :
AEM Communities UGC Migration Tool
When upgrading from AEM 6.0 social communities to AEM 6.2 Communities, be aware that many APIs have been reorganized into different packages. Most should be easily resolved when using an IDE for customization of Communities features.
For details on the deprecated SocialUtils package, visit SocialUtils Refactoring.
See also Using Maven for Communities.
In AEM 6.0, the JSP components remained alongside the new HBS framework components in the same location, with the HBS components typically located in subfolders named "hbs".
As of AEM 6.1, the JSP components were completely removed. For Communities, it is recommended to replace all use of JSP components with SCF components.
The AEM Communities UGC Migration Tool is an open source migration tool, available on GitHub, that can be customized to export UGC from earlier versions of AEM social communities and import into AEM Communities 6.1 or later.
In additin to moving UGC from earlier versions, it is also possible to use the tool to move UGC from one SRP to another, such as from MSRP to DSRP.
Upgrading from an AEM version older than AEM 6.0 requires contacting customer care for assistance.
Conceptually, there are three generations of communities components :
Gen 1 : roughly CQ 5.4 through AEM 5.6.0 - these are the collab components which stored UGC in the local repository using replication as a means of synchronizing UGC across platforms. Other differences involve the implementation using Java Server Pages (JSP) as well as the blog feature consisting of authoring only in the author environment.
Gen 2 : from AEM 5.6.1 through AEM 6.1 - this is a mix of collab and social components. AEM 6.0 introduced the new social component framework (SCF) and AEM 6.2 introduced a common UGC store where UGC is accessed using a storage resource provider (SRP).
Gen 3 : from AEM 6.2 forward, there are only social components, implemented in SCF as Handlebars (HBS) components requiring a choice of SRP for UGC.