Assets Repository Restructuring in AEM 6.5

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.

/libs/settings/dam/notification

/apps/settings/dam/notification

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 original e-mail template exists under /libs/settings/notification/email/default as part of AEM 4 install.

/libs/settings/wcm/designs/assetshare

/apps/settings/wcm/designs/assetshare

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.

/libs/settings/dam/workflownotification/email/downloadasset

/apps/settings/dam/workflownotification/email/downloadasset

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.

/libs/settings/dam/adhocassetshare

/apps/settings/dam/adhocassetshare

If the e-mail template was modified by the customer, then to align with the new repository structure:

1. The updated e-mail template should be copied from /etc/dam/adhocassetshare to /apps/settings/dam/adhocassetshare
   1. Because the destination is in /apps this change should be persisted in SCM.
2. Remove the folder: /etc/dam/adhocassetshare 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 original e-mail template exists under /libs/settings/dam/adhocassetshare as part of AEM 6.4 install.

/libs/settings/dam/indesign

/apps/settings/dam/indesign

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.5
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.

/libs/settings/dam/video

/apps/settings/dam/video

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

/libs/settings/dam/dm/presets/viewer

/conf/global/settings/dam/dm/presets/viewer

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.

/etc/clientlibs/foundation/asseteditor

/etc/clientlibs/foundation/assetshare

/etc/clientlibs/foundation/assetinsights

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/