Show Menu
TOPICS×

Assets Repository Restructuring in AEM 6.4

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 Assets 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

Misc

Previous location /etc/dam/jobs
New location(s) /var/dam/jobs
Restructuring guidance
If any custom code is dependent on this location (ie. the code explicitly relies on this path) then the code must be updated to use the new location prior to upgrade; Ideally Java APIs are used when available to reduce dependencies on any specific path in the JCR.
Temp location to hold zip file for client to download. There is no need to update since when the client requests to download the asset. It will generate file in the new location.
Notes N/A

Prior to 6.5 Upgrade

Asset/Collection Event E-mail Notification Template

Previous location /etc/notification/email/default
New location(s)
/libs/settings/dam/notification
/apps/settings/dam/notification
Restructuring guidance
If the e-mail templates were modified by the customer, then perform the following actions in order to align with the new repository structure:
  1. The /libs/settings/dam/notification e-mail template should be copied from /etc/notification/email/default to /apps/settings/notification/email/default
    1. Because the destination is in /apps this change should be persisted in SCM.
  2. Remove the folder: /etc/dam/notification/email/default after the e-mail templates within it have been moved.
    1. If no updates were made to the e-mail template under /etc/notification/email/default , the folder can be removed as the orginal e-mail template exists under /libs/settings/notification/email/default as part of AEM 6.4 install.
Notes N/A

Classic Asset Share Designs

Previous location /etc/designs/assetshare
New location(s)
/libs/settings/wcm/designs/assetshare
/apps/settings/wcm/designs/assetshare
Restructuring guidance
For any Designs that are managed in SCM, and not written to at run-time via Design Dialogs, perform the following actions to align to the latest model:
  1. Copy the designs from the Previous Location to the New Location under /apps .
  2. Convert any CSS, JavaScript and static resources in the Design to a Client Library with allowProxy = true .
  3. Update references to the Previous Location in the cq:designPath property via AEM > DAM Admin > Asset Share Page > Page Properties > Advanced Tab > Design Field .
  4. Update any Pages referencing the Previous Location to use the new Client Library category. This requires updating Page implementation code.
  5. Update the Dispatcher rules to allow serving of Client Libraries via the /etc.clientlibs/ proxy servlet.
For any Designs that are not managed in SCM, and modified run-time via Design Dialogs, do not move authorable designs out of /etc .
Notes N/A

Download Asset E-mail Notification Template

Previous location /etc/dam/workflow/notification/email/downloadasset
New location(s)
/libs/settings/dam/workflownotification/email/downloadasset
/apps/settings/dam/workflownotification/email/downloadasset
Restructuring guidance
If the e-mail templates ( downloadasset or transientworkflowcompleted ) have been modified, then follow the below procedure in order to align to the new structure:
  1. The updated e-mail template should be copied from /etc/dam/workflow/notification/email/downloadasset to /apps/settings/dam/workflow/notification/email/downloadasset
    1. Because the destination is in /apps this change should be persisted in SCM.
  2. Remove the folder: /etc/dam/workflow/notification/email/downloadasset after the e-mail templates within it have been moved.
    1. If no updates were made to the e-mail template under /etc , the folder can be removed as the orginal e-mail template exists under /libs/settings/dam/workflownotification/email/downloadasset as part of AEM 6.4 install.
Notes While /conf/global/settings/dam/workflownotification/email/downloadasset is technically supported for look-up (takes precedence before /apps via usual Sling CAConfig lookup, but after /etc ) the template could be placed in /conf/global/settings/dam/workflownotification/email/downloadasset . However, this is not recommended as there is no runtime UI to facilitate the editting of the e-mail template.

Example DRM Licenses

Previous location
/etc/dam/drm/licenses/
New location(s)
/libs/settings/dam/drm
Restructuring guidance
N/A
Notes
N/A

InDesign Workflow Scripts

Previous location /etc/dam/indesign/scripts
New location(s)
/libs/settings/dam/indesign
/apps/settings/dam/indesign
Restructuring guidance
To Align with the new repository structure:
  1. Copy all custom or modified scripts from /etc/dam/indesign/scripts to /apps/settings/dam/indesign/scripts
    1. Only copy new or modified scripts as unmodified scripts provided by AEM will be available via /libs/settings in AEM 6.4
  2. Locate all Workflow Models that use the Media Extraction Process WF Step and
    1. For each instance of the Workflow Step, update the paths in config to point explicitly at the proper scripts under /apps/settings/dam/indesign/scripts or /libs/settings/dam/indesign/scripts as appropriate.
  3. Remove /etc/dam/indesign/scripts entirely.
Notes It is recommended customized scripts be stored under /apps , since that is the location where code should be stored.

Video Transcoding Configurations

Previous location /etc/dam/video
New location(s)
/libs/settings/dam/video
/apps/settings/dam/video
Restructuring guidance
Project level customizations need to be cut and pasted under equivalent /apps or /conf paths as applicable.
To align with the AEM 6.4 repository structure:
  1. Copy any modified video configurations from /etc/dam/video to /apps/settings/dam/video
  2. Remove /etc/dam/video
Notes N/A

Viewer Preset Configurations

Previous location /etc/dam/presets/viewer
New location(s)
/libs/settings/dam/dm/presets/viewer
/conf/global/settings/dam/dm/presets/viewer
Restructuring guidance
For the out of the box Viewer Preset, it will only available in the new location.
For the Custom Viewer preset:
  • you will have to run a migration script to move the node from /etc to /conf . The script is located at https://serveraddress:serverport/libs/settings/dam/dm/presets.migratedmcontent.json
  • or you can edit the configuration and they will be auto-saved to the new location.
Note that you do not have to adjust their copyURL/embed code to point to /conf . The existing request to /etc will be re-routed to the correct content from /conf .
Notes N/A

Misc

Previous location
/etc/clientlibs/foundation/asseteditor
/etc/clientlibs/foundation/assetshare
/etc/clientlibs/foundation/assetinsights
New location(s) /libs/dam/clientlibs
Restructuring guidance
Adjust any references to point to the new resources under /libs using the /etc.clientlibs/ allow proxy prefix.
Finally, clean up by removing the folders for the migrated clientlibs from /etc/clientlibs/foundation/
Notes N/A