Repository Restructuring for AEM Communities in 6.4 repository-restructuring-for-aem-communities-in

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

As described on the parent Repository Restructuring in AEM 6.4 page, customers upgrading to AEM 6.4 should use this page to assess the work effort associated with repository changes impacting the AEM Communities Solution. Some changes require work effort during the AEM 6.4 upgrade process, while others can be deferred until a 6.5 upgrade.

With 6.4 Upgrade

Prior to 6.5 Upgrade

With 6.4 Upgrade with-upgrade

E-mail Notification Templates e-mail-notification-templates

Previous location
/etc/community/notifications
New location(s)
/libs/settings/community/notifications
Restructuring guidance

Manual migration ia needed if you want to move to new path under "/apps/settings". You can use the Granite Configuration Manager to perform the migration.

You can perform the migration by setting the property mergeList to true on the "/libs/settings/community/subscriptions" node and add an nt:unstructured child node.

Notes
N/A

Subscription Configurations subscription-configurations

Previous location
/etc/community/subscriptions
New location(s)
/libs/settings/community/subscriptions
Restructuring guidance

Manual migration ia needed if you want to move to new path under "/apps/settings". You can use the Granite Configuration Manager to perform the migration.

You can perform the migration by setting the property mergeList to true on the "/libs/settings/community/subscriptions" node and add an nt:unstructured child node.

Notes
N/A

Watchwords Configurations watchwords-configurations

Previous location
/etc/watchwords
New location(s)
/libs/community/watchwords
Restructuring guidance

A Lazy Migration task is available to clean up the Communities Configurations.

The Task moves watchwords from /etc/watchwords to /conf/global/settings/community/watchwords.

If customized watchwords are stored in SCM, then they should be deployed to /apps/settings/... and you must ensure that there is not an overlaying /conf/global/settings/... configuration that would take precedence.

Migration task removes /etc locations.

Notes
N/A

Prior to 6.5 Upgrade prior-to-upgrade

Badging Configurations badging-configurations

Previous location
/etc/community/badging
New location(s)

Badge Rules:

/libs/settings/community/badging

Badge Images:

For default images: /etc/community/badging/images are moved to /libs/community/badging/images

For custom images: /content/community/badging/images

Restructuring guidance

Manual Migration is required.

If your instance has customized the badging/scoring rules, there is no automated way to place all the rules under a bucket. Need customer inputs on which conf bucket (global or sitespecific) you want to use for your site.

No UI available to configure the badging and scoring for a site.

To align with new repository structure:

  1. Create a site context bucket using the Configuration Browser under Tools
  2. Go to the Site root
  3. Set cq:confproperty to the bucket path where you want to store all your settings. The same can be set via the site Edit Wizard - Set cloud config input.
  4. Move relevant badging rules and scoring rules from /etc/community/* to the site context bucket created in the previous step.
  5. Adjust badging Rules and scoring Rules properties on site root to have relative references to new rule locations.
    1. For example, if the poperty for cq:conf = /conf/we-retail, then badgingRules [] = community/badging/rules if rules are now moved to this new bucket.
  6. Similarly, adjust the references to scoring rules in a badging rule node to have a relativepath.

Finally, clean up by removing the resource /etc/community/badging

Notes
N/A

Classic Communities Console Designs classic-communities-console-designs

Previous location
/etc/designs/social/console
New location(s)

/libs/settings/wcm/designs/social/console

/apps/settings/wcm/designs/social/console

Restructuring guidance
N/A
Notes
N/A

Facebook Social Login Configurations facebook-social-login-configurations

Previous location
/etc/cloudservices/facebookconnect
New location(s)

/conf/global/settings/cloudconfigs/facebookconnect

/conf/<tenant>/settings/cloudconfigs/facebookconnect

Restructuring guidance

Any new Facebook Cloud Configurations must be migrated to the New Location.

  1. Migrate existing configurations in the Previous Location to the New Location.

    1. Manually recreate new Facebook Social Login Configurations via the AEM authoring UI at Tools > Cloud Services > Facebook Social Login Configuration.
      or
    2. Copy any new Facebook Cloud Configurations from Previous Location to the appropriate New Location, under /conf/global or /conf/<tenant>.
  2. Update any AEM Communities Site root to reference the new Facebook Social Login Configuration by setting the [cq:Page]/jcr:content@cq:conf property to the absolute path in the New Location.

  3. Disassociate the legacy Facebook Connect Cloud Service from any AEM Communities site roots updated to reference the New Location.

Notes
N/A

Language Options Configurations language-options-configurations

Previous location
/etc/social/config/languageOpts
New location(s)
/libs/social/translation/languageOpts
Restructuring guidance
N/A
Notes
N/A

Pinterest Social Login Configurations pinterest-social-login-configurations

Previous location
/etc/cloudservices/pinterestconnect
New location(s)

/conf/global/settings/cloudconfigs/pinterestconnect

/conf/<tenant>/settings/cloudconfigs/pinterestconnect

Restructuring guidance

Any new Pinterest Cloud Configurations must be migrated to the New Location.

  1. Migrate existing configurations in the Previous Location to the New Location.

    1. Manually recreate new Pinterest Social Login Configurations via the AEM authoring UI at Tools > Cloud Services > Pinterest Social Login Configuration.
      or
    2. Copy any new Pinterest Cloud Configurations from Previous Location to the appropriate New Location under /conf/global or /conf/<tenant>.
  2. Update any AEM Communities Site root to reference the new Pinterest Social Login Configuration by settings the [cq:Page]/jcr:content@cq:conf property to the absolute path in the New Location.

  3. Disassociate the legacy Pinterest Connect Cloud Service from any AEM Communities site roots updated to reference the New Location.

Notes
N/A

Scoring Configurations scoring-configurations

Previous location
/etc/community/scoring
New location(s)
/libs/settings/community/scoring
Restructuring guidance

To align with new repository structure, scoring rules can be stored in /apps/settings/ or /conf/.../settings

  1. For /apps/settings, this would act as global or default rules managed in SCM.

Create context-aware configs in /conf/ by using CRXDELite:

  1. Create the configs in the desired /conf/.../settings location
  2. Communities site must have the cq:conf property property set.
    1. If no cq:conf is set, scoring rules would be directly read from the given path for property 'scoringRules' at the site's root node, for example: /content/we-retail/us/en/community/jcr:content

Cleanup: Remove the resource /etc/community/scoring

Notes
N/A

Twitter Social Login Configurations twitter-social-login-configurations

Previous location
/etc/cloudservices/twitterconnect
New location(s)

/conf/global/settings/cloudconfigs/twitterconnect

/conf/<tenant>/settings/cloudconfigs/twitterconnect

Restructuring guidance

Any new Twitter Cloud Configurations must be migrated to the New Location.

  1. Migrate existing configurations in the Previous Location to the New Location.

    1. Manually recreate new Twitter Social Login Configurations via the AEM authoring UI at Tools > Cloud Services > Twitter Social Login Configuration.
      or
    2. Copy any new Twitter Cloud Configurations from Previous Location to the appropriate New Location, under /conf/global or /conf/<tenant>.
  2. Update any AEM Communities Site root to reference the new Twitter Social Login Configuration by setting the [cq:Page]/jcr:content@cq:conf property to the absolute path in the New Location.

  3. Disassociate the legacy Twitter Connect Cloud Service from any AEM Communities site roots updated to reference the New Location.

Notes
N/A

Misc misc

Previous location
/etc/community/templates
New location(s)
/libs/settings/community/templates
Restructuring guidance

Adobe has provided a migration utility at:

https://github.com/Adobe-Marketing-Cloud/aem-communities-ugc-migration/tree/master/bundles/communities-template-migration

Notes
The existing custom templates would move to /conf/global/settings/community/template/<groups/sites/functions>
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56