Adobe Dynamic Media Classic is a hosted solution for managing, enhancing, publishing, and delivering rich media assets to Web, mobile, email, and Internet-connected displays and print.
To use Dynamic Media Classic, you need to configure the cloud configuration so that Dynamic Media Classic and AEM Assets can interact with one another. This document describes how to configure AEM and Dynamic Media Classic.
For information on using all the Dynamic Media Classic components on a page and working with video, see Using Dynamic Media Classic.
AEM users have a choice between two solutions to work with dynamic media: Either integrating their instance of AEM with Dynamic Media Classic or using the Dynamic Media solution that is integrated into AEM.
Use the following criteria to determine which solution to choose:
If you are an existing Dynamic Media Classic customer whose rich media assets reside in Dynamic Media Classic for publishing and delivery, but you want to integrate those assets with Sites (WCM) authoring and/or AEM Assets for management, then use the AEM/Dynamic Media Classic point-to-point integration described in this document.
If you are a new AEM customer who has rich media delivery needs, select the Dynamic Media option. This option makes the most sense if you do not have an existing S7 account and many assets stored in that system.
In certain cases, you may want to use both solutions. The dual-use scenario describes that scenario.
When you work with assets in this solution, you do one of the following:
The components you use for this integration are found in the Dynamic Media Classic component area in Design mode.
AEM Dynamic Media is the unification of Dynamic Media Classic features directly within the AEM platform.
When you work with assets in this solution, you follow this workflow:
The components you use for Dynamic Media are found in the Dynamic Media component area in Design mode. They include the following:
Dynamic Media - The Dynamic Media component is smart - depending on whether you add an image or a video, you have various options. The component supports image presets, image-based viewers such as image sets, spin sets, mixed media sets, and video. In addition, the viewer is responsive - the size of the screen changes automatically based on screen size. All viewers are HTML5 viewers.
Interactive Media - The Interactive Media component is for those assets, such as carousel banners, interactive images, and interactive video, that have interactivity on them such hotspots or image maps. This component is smart - depending on whether you add an image or a video, you have various options. In addition, the viewer is responsive - the size of the screen changes automatically based on screen size. All viewers are HTML5 viewers.
Out of the box, you can use both Dynamic Media and Dynamic Media Classic integration features of AEM simultaneously. The following use cases table describes when you turn certain areas on and off.
To use Dynamic Media and Dynamic Media Classic simultaneously:
Configure Dynamic Media Classic in cloud services.
Follow the specific instructions particular to your use case:
Dynamic Media | Dynamic Media Classic Integration | ||||
If you are ... | Use Case Workflow | Imaging/Video | Dynamic Media Component | S7 Content Browser and Components | Automatic Upload from Assets to S7 |
New to Sites and Dynamic Media | Upload assets to AEM and use AEM Dynamic Media component to author assets on Sites pages | On (See step 3) |
On | Off | Off |
In retail and are new to Sites and Dynamic Media | Upload NON-product assets to AEM for management and delivery. Upload PRODUCT assets to Dynamic Media Classic and use Dynamic Media Classic content browser in AEM and component to author Product Detail Pages on Sites. | On (See step 3) |
On | On | Off |
New to Assets and Dynamic Media | Upload assets to AEM Assets and use published URL/embed code from Dynamic Media | On (See step 3) |
Off | Off | Off |
New to Dynamic Media and Templating | Use Dynamic Media for imaging and video. Author image templates in Dynamic Media Classic and use Dynamic Media Classic content finder to include templates in Sites pages. | On (See step 3) |
On | On | Off |
An existing Dynamic Media Classic customer and are new to Sites | Upload assets to Dynamic Media Classic and use AEM Dynamic Media Classic content browser to search and author assets on Sites pages | Off | Off | On | Off |
An existing Dynamic Media Classic customer and are new to Sites and Assets | Upload assets to DAM and automatically publish to Dynamic Media Classic for delivery. Use AEM Dynamic Media Classic content browser to search and author assets on Sites pages. | Off | Off | On | (See step 4) |
Existing Dynamic Media Classic customer and new to Assets | Upload assets to AEM and use Dynamic Media to generate renditions for download/share. Automatically publish AEM assets to Dynamic Media Classic for delivery. Important: Incurs duplicate processing and renditions generated in AEM will not be synchronized to Dynamic Media Classic |
On (See step 3) |
Off | Off | (See step 4) |
(Optional; see use case table) - Set up the Dynamic Media cloud configuration and enable the Dynamic Media server.
(Optional; see use case table) - If you choose to enable Automatic Upload from Assets to Dynamic Media Classic, then you need to add the following:
https://<server>:<host>/cf#/etc/workflow/models/dam/update_asset.html)
When you have both Dynamic Media Classic and Dynamic Media enabled, there are the following limitations:
When integrating Dynamic Media Classic with AEM, there are some important best practices that need to be observed in the following areas:
See known limitations.
Adobe recommends that you test-drive your integration by having your root folder pointing to a subfolder only rather than an entire company.
Importing assets from an existing Dynamic Media Classic company account may take a long time to show in AEM. Ensure that you designate a folder in Dynamic Media Classic that does not have too many assets (for example, the root folder will often have too many assets and may crash your system).
You can upload assets either by using the Assets (digital asset management) functionality or by accessing Dynamic Media Classic directly in AEM by way of the Dynamic Media Classic content browser. Which one you choose depends on the following factors:
Dynamic Media Classic asset types that AEM Assets does not yet support have to be added to an AEM website from Dynamic Media Classic directly, by way of the Dynamic Media Classic content browser, for example, image templates.
For asset types that are supported by both AEM Assets and Dynamic Media Classic, deciding how to upload them depends on the following:
If the assets are already in Dynamic Media Classic and managing them in a common repository is not as important, then exporting them to AEM Assets only to sync them back to Dynamic Media Classic for delivery would be an unnecessary roundtrip. Otherwise, keeping assets in a single repository and syncing to Dynamic Media Classic only for delivery may be preferable.
You can configure AEM to upload assets to Dynamic Media Classic. Assets from a CQ target folder can be uploaded (automatically or manually) from AEM to a Dynamic Media Classic company account.
Adobe recommends that you use only the designated target folder for importing Dynamic Media Classic assets. Digital assets that reside outside of the target folder can only be used in Dynamic Media Classic components on pages where the Dynamic Media Classic configuration has been enabled. In addition, they are placed in an ad hoc folder in Dynamic Media Classic. The adhoc folder is not synchronized with AEM (but assets are discoverable in the Dynamic Media Classic content browser).
To configure Dynamic Media Classic to integrate with AEM, you need to complete the following steps:
This section covers how to perform all of these steps and lists important limitations.
When setting up AEM Assets and Dynamic Media Classic synchronization, it is important to understand the following:
AEM embeds all the metadata as XMP before uploading it to Dynamic Media Classic, so all properties on the metadata node are available in Dynamic Media Classic as XMP.
With the synchronization between AEM Assets and Dynamic Media Classic, there are currently the following limitations/design implications:
Limitation/design implication | Description |
One designated synchronization (target) folder | You can only have one designated folder per company in AEM for Dynamic Media Classic uploads. You can create multiple configurations if you need to have access to more than one company account in Dynamic Media Classic. |
Folder structure | If you delete a synced folder with assets, all Dynamic Media Classic remote assets are deleted but the folder remains. |
Ad-hoc folder | Assets that reside outside the target folder that are manually uploaded to Dynamic Media Classic in WCM are automatically placed in a separate ad-hoc folder on Dynamic Media Classic. You configure this in the cloud configuration in AEM. |
Mixed media | Mixed media sets appear in AEM although they are not supported in AEM. |
PDFs | Generated PDFs from eCatalogs in Dynamic Media Classic get imported into the CQ target folder. |
UI refreshing | When synchronizing between AEM and Dynamic Media Classic, be sure to refresh the user interface to view changes. |
Video thumbnails | If uploading a video to AEM Assets for encoding via Dynamic Media Classic, the video thumbnails and encoded videos may take some time to be available in AEM Assets, depending on video processing time. |
Target subfolders | If you are using subfolders within the target folder, ensure that you either use unique names for each asset (regardless of location) or you configure Dynamic Media Classic (in the Setup area) to not overwrite assets regardless of location. Otherwise, assets with the same name that are uploaded to a Dynamic Media Classic target subfolder are uploaded, but the same-named asset in the target folder is deleted. |
If you run AEM behind a proxy or have special firewall settings, you may need to explicitly enable the hosts of the different regions. Servers are managed in content in /etc/cloudservices/scene7/endpoints
and can be customized as required. Tap a URL and then edit to change the URL, if necessary. In previous versions of AEM, these values were hard-coded.
If you navigate to /etc/cloudservices/scene7/endpoints.html
, you see the servers listed (and can edit them by clicking on the URL):
A cloud configuration defines the mapping between a Dynamic Media Classic folder and an AEM Assets folder. It needs to be configured to synchronize AEM Assets with Dynamic Media Classic. See How Synchronization Works for more information.
Importing assets from an existing Dynamic Media Classic company account may take a long time to show in AEM. Ensure that you designate a folder in Dynamic Media Classic that does not have too many assets (for example, the root folder will often have too many assets).
If you would like to test drive the integration, you may want to have the root folder point to a subfolder only, instead of the entire company.
You can have multiple configurations: one cloud configuration represents one user at a Dynamic Media Classic company. If you want to access other Dynamic Media Classic companies or users, you need to create multiple configurations.
To configure AEM to be able to publish assets to Dynamic Media Classic:
Tap the AEM icon and navigate to Deployment > Cloud Services to access Adobe Dynamic Media Classic.
Tap Configure now.
In the Title field, and optionally in the Name field, enter the appropriate information. Tap Create.
When creating additional configurations, the parent configuration field displays.
Do not change the parent configuration. Changing the parent configuration can break the integration.
Enter the email address, password, and region of your Dynamic Media Classic account and tap Connect to Dynamic Media Classic. You are connected to the Dynamic Media Classic server and the dialog expands with more options.
Enter the Company name and Root Path (this is the published server name together with any path you want to specify; if you do not know the published server name, in Dynamic Media Classic, go to Setup > Application Setup.)
The Dynamic Media Classic root path is the Dynamic Media Classic folder AEM connects to. It can be narrowed down to a specific folder.
Depending on the size of the Dynamic Media Classic folder, importing a root folder can take a long time. In addition, Dynamic Media Classic data could exceed the AEM storage. Ensure you are importing the correct folder. Importing too much data can stop your system.
Click OK. AEM saves your configuration.
If you are reconnecting:
You must enable the Adobe CQ Dynamic Media Classic Dam Listener, which is disabled by default.
To enable it:
Tap the Tools icon, then navigate to Operations > Web Console. The Web console opens.
Navigate to Adobe CQ Dynamic Media Classic Dam Listener and select the Enabled check box.
Tap Save.
When an AEM instance is configured to handle video encoding through Dynamic Media Classic, by default, there is a 35-minute timeout on any upload job. To accommodate potentailly longer-running video encoding jobs, you can configure this setting:
Navigate to http://localhost:4502/system/console/configMgr/com.day.cq.dam.scene7.impl.Scene7UploadServiceImpl.
Change the number as desired in the Active job timeout field. Any non-negative number is accepted with the unit of measure in seconds. By default, this is set to 2100.
Best practice: Most assets are ingested within minutes at most (for example, images). But in certain instances - larger videos for example - the timeout value should be increased to 7200 seconds (2 hours) to accommodate long processing time. Otherwise, this Dynamic Media Classic upload job is marked as UploadFailed in the JCR metadata.
Tap Save.
Beginning with AEM 6.3.2, AEM Assets is now configured for you so that any digital assets that you upload to the digital asset manager are automatically updated to Dynamic Media Classic if the assets are in a CQ target folder.
When an asset is added into AEM Assets, it is automatically uploaded and published to Dynamic Media Classic.
The maximum file size for automatic uploading from AEM Assets to Dynamic Media Classic is 500 MB.
To configure autouploading from AEM Assets:
Tap the AEM icon and navigate to Deployment > Cloud Services then, under the Dynamic Media heading, under Available Configurations, tap dms7 (Dynamic Media)
Tap the Advanced tab, select the Enable Automatic Upload check box, then tap OK. You now need to configure the DAM Asset workflow to include uploading to Dynamic Media Classic.
See Configuring the state (published/unpublished) of assets pushed to Dynamic Media Classic for information on pushing assets to Dynamic Media Classic in an unpublished state.
Navigate back to the AEM welcome page and tap Workflows. Double-click the DAM Update Asset workflow to open it.
In the sidekick, navigate to the Workflow components, and select Dynamic Media Classic. Drag Dynamic Media Classic to the workflow and tap Save. Assets added to AEM Assets in the target folder will automatically be uploaded to Dynamic Media Classic.
If you are pushing assets from AEM Assets to Dynamic Media Classic, you can either publish them automatically (default behavior) or push them to Dynamic Media Classic in an unpublished state.
You may not want to publish assets immediately on Dynamic Media Classic if you want to test them in a staging environment before going live. You can use AEM with Dynamic Media Classic’s Secure Test environment to push assets directly from Assets into Dynamic Media Classic in an unpublished state.
Dynamic Media Classic assets remain available via secure preview. Only when assets are published within AEM do the Dynamic Media Classic assets also go live in production.
If you want to publish assets immediately when pushing them to Dynamic Media Classic, you do not need to configure any options. This is the default behavior.
However, if you do not want assets pushed to Dynamic Media Classic to publish automatically, this section describes how to configure AEM and Dynamic Media Classic to do this.
Before you can push assets to Dynamic Media Classic without publishing them, you must set up the following:
These are the same steps you would follow to create any secure test setup in Dynamic Media Classic.
If your installation environment is a Unix 64-bit operating system, see https://helpx.adobe.com/experience-manager/kb/enable-xmp-write-back-64-bit-redhat.html regarding additional configuration options you need to set.
If you use this feature, please note the following limitations:
If you want to publish assets instantly, best practice is to keep Enable Secure Preview set to Immediately and use the Enable Automatic Upload feature.
If a user publishes the asset in AEM, it automatically triggers the S7 asset to the production/live asset (the asset will no longer be in secure preview/unpublished).
To set the state of assets pushed to Dynamic Media Classic as unpublished:
Tap the AEM icon and navigate to Deployment > Cloud Services, tap Dynamic Media Classic, and select your configuration in Dynamic Media Classic.
Tap the Advanced tab. In the Enable Secure View drop-down menu, select Upon AEM Publish Activation to push assets to Dynamic Media Classic without publishing. (By default, this value is set to Immediately, where Dynamic Media Classic assets are published immediately.)
See Dynamic Media Classic documentation for more information on testing assets before making them public.
Tap OK.
Enabling Secure View means that your assets are pushed to the secure preview server unpublished.
You can check this by navigating to a Dynamic Media Classic component on a page in AEM and tapping Edit. The asset will have the secure preview server listed in the URL. After publishing in AEM, the server domain in the file reference gets updated from the preview URL to the production URL.
Enabling Dynamic Media Classic for WCM is required for two reasons:
When enabling Dynamic Media Classic for the WCM, note that as with other configurations, inheritance rules apply. You can enable Dynamic Media Classic for WCM in either the touch-optimized or classic user interface.
To enable Dynamic Media Classic for WCM in the touch-optimized UI:
Tap the AEM icon and navigate to Sites and then the root page of your web site (not language specific).
In the toolbar, select the settings icon and tap Open Properties.
Tap Cloud Services and tap Add Configuration and select Dynamic Media Classic.
In the Adobe Dynamic Media Classic drop-down list, select the desired configuration and tap OK.
Video presets from that configuration of Dynamic Media Classic are available for use in AEM with the Dynamic Media Classic video component on that page and child pages.
To enable Dynamic Media Classic for WCM in the classic UI:
In AEM, tap Websites and navigate to the root page of your web site (not language specific).
In the sidekick, tap the Page icon and tap Page Properties.
Tap Cloud Services > Add services > Dynamic Media Classic.
In the Adobe Dynamic Media Classic drop-down list, select the desired configuration and tap OK.
Video presets from that configuration of Dynamic Media Classic are available for use in AEM with the Dynamic Media Classic video component on that page and child pages.
If you have multiple Dynamic Media Classic configurations, you can specify one of them as the default for the Dynamic Media Classic content browser.
Only one Dynamic Media Classic configuration can be marked as default at a given moment. The default configuration is the company assets that display by default in the Dynamic Media Classic Content Browser.
To configure the default configuration:
Tap the AEM icon and navigate to Deployment > Cloud Services, tap Dynamic Media Classic, and select your configuration in Dynamic Media Classic.
Tap Edit to open the configuration.
In the General tab, select the Default Configuration check box to make this the default company and root path that appears in the Dynamic Media Classic content browser.
If there is only one configuration, selecting the Default Configuration check box has no effect.
You can configure the folder that assets are uploaded to in Dynamic Media Classic when the asset is not located in the CQ target folder. See Publishing assets from outside the CQ target folder.
To configure the adhoc folder:
Tap the AEM icon and navigate to Deployment > Cloud Services, tap Dynamic Media Classic, and select your configuration in Dynamic Media Classic.
Tap Edit to open the configuration.
Tap the Advanced tab. In the Ad-hoc Folder field, you can modify the Ad-hoc folder. By default, it is the name_of_the_company/CQ5_adhoc.
To configure Universal Presets for the video component, see Video.
You can enable configurable Dynamic Media Classic upload jobs parameters that are triggered by the synchronization of Digital Asset Manager/Dynamic Media Classic assets.
Specifically, you configure the accepted file format by MIME type in the OSGi (Open Service Gateway initiative) area of the AEM Web Console Configuration panel. Then, you can customize the individual upload job parameters that are used for each MIME type in the JCR (Java Content Repository).
To enable MIME type-based assets:
Tap the AEM icon and navigate to Tools > Operations > Web Console.
In the Adobe Experience Manager Web Console Configuration panel, on the OSGi menu, tap Configuration.
Under the Name column, find and tap Adobe CQ Dynamic Media Classic Asset MIME type Service to edit the configuration.
In the Mime Type Mapping area, tap any plus sign (+) to add a MIME type.
See Supported MIME types.
In the text field, type the new MIME type name.
For example, you would type a <file_extension>=<mime_type>
as in EPS=application/postscript
OR PSD=image/vnd.adobe.photoshop
.
In the lower-right corner of the configuration window, tap Save.
Return to AEM and in the left rail, tap CRXDE Lite.
On the CRXDE Lite page, in the left rail, navigate to /etc/cloudservices/scene7/<environment>
(substitute <environment>
for the actual name).
Expand <environment>
(substitute <environment>
for the actual name) to reveal the mimeTypes
node.
Tap the mimeType that you just added.
For example, mimeTypes > application_postscript
OR mimeTypes > image_vnd.adobe.photoshop
.
On the right side of the CRXDE Lite page, tap the Properties tab.
Specify a Dynamic Media Classic upload job parameter in the jobParam value field.
For example, psprocess="rasterize"&psresolution=120
.
See the Adobe Dynamic Media Classic Image Production System API for additional upload job parameters you can use.
If you are uploading PSD files, and you want to process them as templates with layer extractions, enter the following in the jobParam value field:
process=MaintainLayers&createTemplate=true
Be sure that your PSD file has “layers.” If it is strictly one image or an image with mask, it is processed as an image because there are no layers to process.
In the upper-left corner of the CRXDE Lite page, tap Save All.
If you are having trouble integrating AEM with Dynamic Media Classic, see the following scenarios for solutions.
If your digital asset publishing to Dynamic Media Classic fails:
Check thattheasset you are trying to upload is in the CQ target folder (you specify this folder in the Dynamic Media Classic cloud configuration).
If it is not, you need to configure the cloud configuration in Page Properties for that page to allow uploading to the CQ adhoc folder.
Check the logs for any information.
If your video presets do not appear:
If your video assets do not play in AEM:
If new or modified assets in AEM do not automatically upload to Dynamic Media Classic:
Ensure that the assets are in the CQ target folder. Only assets that are in the CQ target folder are automatically updated (provided you configured AEM Assets to automatically upload assets).
Ensure that you have configured the Cloud Services configuration to Enable Automatic Uploading and that you have updated and saved the DAM Asset workflow to include Dynamic Media Classic uploading.
When uploading an image into a subfolder of the Dynamic Media Classic target folder, ensure you do one of the following:
If your deleted assets or folders are not synchronized between Dynamic Media Classic and AEM:
If video upload fails
Importing assets from an existing Dynamic Media Classic company account may take a long time to show in AEM. Ensure that you designate a folder in Dynamic Media Classic that does not have too many assets (for example, the root folder will often have too many assets).
If you would like to test drive the integration, you may want to have the root folder point to a subfolder only, instead of the entire company.