About configuring Dynamic Media Cloud Service

If you use Adobe Experience Manager set up for different environments, such as one for development, one for staging, and one for live production, you need to configure Dynamic Media Cloud Services for each one of those environments.

Architecture diagram of Dynamic Media

The following architecture diagram describes how Dynamic Media works.

With the new architecture, AEM is responsible for primary source assets and synchs with Dynamic Media for asset processing and publishing:

  1. When the primary source asset is uploaded to AEM, it is replicated to Dynamic Media. At that point, Dynamic Media handles all asset processing and rendition generation, such as video encoding and dynamic variants of an image.
  2. After the renditions are generated, AEM can securely access and preview the remote Dynamic Media renditions (no binaries are sent back to the AEM instance).
  3. After content is ready to be published and approved, it triggers the Dynamic Media service to push content out to delivery servers and cache content at the CDN.

chlimage_1-550

Creating a new Dynamic Media Configuration in Cloud Services

  1. In AEM, tap the AEM logo to access the global navigation console.

  2. On the left side of the console, tap the Tools icon, then tap Cloud Services > Dynamic Media Configuration.

  3. On the Dynamic Media Configuration Browser page, in the left pane, tap global (do not tap or select the folder icon to the left of global), then tap Create.

  4. On the Create Dynamic Media Configuration page, enter a title, the Dynamic Media account email address, password, then select your region. These are provided to you by Adobe in the provisioning email. Please contact support if you did not receive this.

  5. Click Connect to Dynamic Media.

  6. In the Change Password dialog box, in the New Password field, enter a new password that consists of 8-25 characters. The password must contain at least one of each of the following:

    • Uppercase letter
    • Lowercase letter
    • Number
    • Special character: # $ & . - _ : { }

    Note that the Current Password field is intentionally pre-filled and hidden from interaction.

    If necessary, you can check the spelling of a password you have typed or retyped by tapping the password eye icon to reveal the password. Tap the icon again to hide the password.

  7. In the Repeat Password field, retype the new password, then tap Done.

    The new password is saved when you tap Save in the upper-right corner of the Create Dynamic Media Configuration page.

    If you tapped Cancel in the Change Password dialog box, you are still required to enter a new password when you tap Save to save the newly created Dynamic Media configuration.

    See also Changing the password to Dynamic Media.

  8. When the connection is successful, you can set the following:

    Property Description
    Company The name of the Dynamic Media account. It is possible you may have multiple Dynamic Media accounts for different sub-brands, divisions, or different staging/production environments.
    Company Root Folder Path Your company’s root folder path.
    Publishing Assets You can choose from the following three options:
    Immediately: When assets are uploaded, the system ingests the assets and provides the URL/Embed instantly. There is no user intervention necessary to publish assets.
    Upon Activation: You need to explicitly publish the asset first before a URL/Embed link is provided.
    Selective Publish: Assets are auto published for secure preview only and can be explicitly published to AEM without publishing to DMS7 for delivery in the public domain. In the future, Adobe will enhance this option to publish assets to AEM and publish assets to Dynamic Media, mutually exclusive of each other. That is, you can publish assets to DMS7 so you can use features such a Smart Crop or dynamic renditions. Or, you can publish assets exclusively in AEM for previewing; those same assets are not published in DMS7 for delivery in the public domain.
    Secure Preview Server Lets you specify the URL path to your secure renditions preview server. That is, after renditions are generated, AEM can securely access and preview the remote Dynamic Media renditions (no binaries are sent back to the AEM instance).
    Unless you have a special arrangment to use your own company’s server or a special server, Adobe Systems recommends that you leave this setting as specified.
    Sync all content Selected by default. Deselect this option if you want to selectively include or exclude assets from the sync to Dynamic Media. Deselecting this option lets you can choose from the following two Dynamic Media sync modes:
    Dynamic Media sync mode
    Enable by default: The configuration is applied to all folders by default unless you mark a folder specifically for exclusion.
    Disabled by default: The configuration is not applied to any folder until you explicitly mark a selected folder for sync to Dynamic Media.
    To mark a selected folder for sync to Dynamic Media, select an asset folder, then on the toolbar, tap Properties. On the Details tab, in the Dynamic Media sync mode drop-down list, choose from the following three options. When you are done, tap Save. Remember: these three options are not available if you selected Sync all content earlier. See also Working with Selective Publish at the folder level in Dynamic Media.
    Inherited: No explicit sync value on the folder; instead, the folder inherits the sync value from one of its ancestor folders or the default mode in the cloud configuration. The detailed status for inherited shows by way of a tool tip.
    Enable for sub-folders: Include everything in this sub-tree for sync to Dynamic Media. The folder-specific settings override the default mode in the cloud configuration.
    Disabled for sub-folders: Exclude everything in this sub-tree from syncing to Dynamic Media.
    NOTE

    There is no support for versioning in Dynamic Media. Also, delayed activation applies only if Publish Assets in the Edit Dynamic Media Configuration page is set to Upon Activation, and then only until the first time the asset is activated.

    After an asset is activated, any updates are immediately published live to S7 Delivery.

    dynamicmediaconfiguration2updated

  9. Tap Save. The new Dynamic Media password and configuration is saved. If you tapped Cancel instead, no password update occurs.

  10. In the Configuring Dynamic Media dialog box, tap OK to begin the configuration.

    IMPORTANT

    When the new Dynamic Media configuration finishes its setup, you will receive a status notification within AEM’s Inbox.

    This Inbox notification informs you if the configuration was either successful or not.
    See Troubleshooting a new Dynamic Media configuration and Your Inbox for more information.

  11. To securely preview Dynamic Media content before it gets published, you need to “allowlist” the AEM author instance to connect to Dynamic Media. To set this up, do the following:

    • Log on to your Dynamic Media Classic account: https://www.adobe.com/marketing-cloud/experience-manager/scene7-login.html. Your credentials and logon were provided by Adobe at the time of provisioning. If you do not have this information, contact Technical Support.

    • On the navigation bar near the top right of the page, click Setup > Application Setup > Publish Setup > Image Server.

    • On the Image Server Publish page, in the Publish Context drop-down list, select Test Image Serving.

    • For the Client Address Filter, tap Add.

    • Select the check box to enable (turn on) the address, and then enter the IP address of the AEM Author instance (not Dispatcher IP).

    • Click Save.

You are now finished with the basic configuration; you are ready to use Dynamic Media.

If you want to further customize your configuration, you can optionally complete any of the tasks under Configuring Advanced Settings in Dynamic Media.

Troubleshooting a new Dynamic Media Configuration

When a new Dynamic Media configuration finishes its setup, you will receive a status notification within AEM’s Inbox. This notification informs you if the configuration was either successful or not, as seen in the following respective images from the Inbox.

aeminboxsuccess

aeminboxfailure

See also Your Inbox.

To troubleshoot a new Dynamic Media configuration

  1. Near the upper-right corner of the AEM page, tap the bell icon, then tap View All.

  2. On the Inbox page, tap the success notification to read an overview of the status and logs of the configuration.

    If the configuration failed, tap the failure notification similar to the following screenshot.

    dmsetupfailed

  3. On the DMSETUP page, review the configuration details that describe the failure. In particular, take note of any error messages or error codes. You will need to contact Adobe Care with this information.

    dmsetuppage

Changing the password to Dynamic Media

Password expiration in Dynamic Media is set to 100 years from the current system date.

The password must contain at least one of each of the following:

  • Uppercase letter
  • Lowercase letter
  • Number
  • Special character: # $ & . - _ : { }

If necessary, you can check the spelling of a password you have typed or retyped by tapping the password eye icon to reveal the password. Tap the icon again to hide the password.

The changed password is saved when you tap Save in the upper-right corner of the Edit Dynamic Media Configuration page.

  1. In AEM, tap the AEM logo to access the global navigation console.

  2. On the left side of the console, tap the Tools icon, then tap Cloud Services > Dynamic Media Configuration.

  3. On the Dynamic Media Configuration Browser page, in the left pane, tap global (do not tap or select the folder icon to the left of global), then tap Edit.

  4. On the Edit Dynamic Media Configuration page, directly below the Password field, tap Change Password.

  5. In the Change Password dialog box, do the following:

    • In the New Password field, enter a new password.

      Note that the Current Password field is intentionally pre-filled and hidden from interaction.

    • In the Repeat Password field, retype the new password, then tap Done.

  6. In the upper-right corner of the Edit Dynamic Media Configuration page, tap Save, then tap OK.

(Optional) Configuring Advanced Settings in Dynamic Media

If you want to further customize the configuration and setup of Dynamic Media, or optimize its performance, you can complete one or more of the following optional tasks:

(Optional) Setup and configuration of Dynamic Media settings

Use the Dynamic Media Classic user interface to make changes to your Dynamic Media settings.

Some of the tasks above require that you log into Dynamic Media Classic here: https://www.adobe.com/marketing-cloud/experience-manager/scene7-login.html

Setup and configuration tasks include the following:

Publishing setup for Image Server

The Publish Setup settings determine how assets are delivered by default from Dynamic Media. If no setting is specified, Dynamic Media delivers an asset according to the default settings defined in Publish Setup. For example, a request to deliver an image that does not include a resolution attribute yields an image with the Default Object Resolution setting.

To configure Publish Setup: in Dynamic Media Classic, click Setup > Application Setup > Publish Setup > Image Server.

The Image Server screen establishes default settings for delivering images. See the UI screen for description of each setting.

Request Attributes - These settings impose limits on images that can be delivered from the server.
Default Request Attributes - These settings pertain to the default appearance of images.
Common Thumbnail Attributes - These settings pertain to the default appearance of thumbnail images.
Defaults for Catalog Fields- These settings pertain to the resolution and default thumbnail type of images.
Color Management Attributes - These settings determine which ICC color profiles are used.
Compatibility Attributes - This setting enables leading and trailing paragraphs in text layers to be treated as they were in version 3.6 for backwards compatibility.
Localization Support - These settings let you manage multiple locale attributes. It also lets you specify a locale map string so you can define which languages you want to support for the various tooltips in Viewers. For more information about setting up Localization Support, see Considerations when setting up localization of assets.

Configuring application general settings

To open the Application General Settings page, in Dynamic Media Classic Global Navigation bar, click Setup > Application Setup > General Settings.

Servers - On account provisioning, Dynamic Media automatically provides the assigned servers for your company. These servers are used to construct URL strings for your web site and applications. These URL calls are specific to your account. Do not change any of the server names unless explicitly instructed to do so by AEM support.
Overwrite Images - Dynamic Media does not allow two files to have the same name. Each item’s URL ID (the filename minus the extension) must be unique. These options specify how replacement assets are uploaded: whether they replace the original or become duplicate. Duplicate assets are renamed with a “-1” (for example, chair.tif is renamed chair-1.tif). These options affect assets uploaded to a different folder than the original or assets with a different filename extension from the original (such as JPG, TIF, or PNG).
Overwrite in current folder, same base image name/extension - This option is the strictest rule for replacement. It requires that you upload the replacement image to the same folder as the original, and that the replacement image has the same filename extension as the original. If these requirements are not met, a duplicate is created. To maintain consistency with AEM, always choose Overwrite in current folder, same base image name/extension.
Overwrite in any folder, same base asset name/extension - Requires that the replacement image has the same filename extension as the original image (for example, chair.jpg must replace chair.jpg, not chair.tif). However, you can upload the replacement image to a different folder than the original. The updated image resides in the new folder; the file can no longer be found in its original location.
Overwrite in any folder, same base asset name regardless of extension - This option is the most inclusive replacement rule. You can upload a replacement image to a different folder than the original, upload a file with a different filename extension, and replace the original file. If the original file is in a different folder, the replacement image resides in the new folder to which it was uploaded.
Default Color Profiles - See Configuring Color Management for additional information. By default, the system shows 15 renditions when you select Renditions and 15 viewer presets when you select Viewers in the asset’s detail view. You can increase this limit. See Increasing or decreasing the number of image presets that display or Increasing or decreasing the number of viewer presets that display.

Configuring color management

Dynamic media color management lets you color correct assets. With color correction, ingested assets retain their color space (RGB, CMYK, Gray) and embedded color profile. When you request a dynamic rendition, the image color is corrected into the target color space using CMYK, RGB, or Gray output. See Configuring Image Presets.

To configure the default color properties to enable color correction when requesting images:

  1. Log into Dynamic Media Classic using credentials provided during provisioning. Navigate to Setup > Application Setup.

  2. Expand the Publish Setup area and select Image Server. Set Publish Context to Image Serving when setting defaults for publish instances.

  3. Scroll to the property you need to change, for example a property in the Color Management Attributes area.
    You can set the following color correction properties:

    Property Description
    CMYK Default Color Space Name of the default CMYK color profile.
    Gray-Scale Default Color Space Name of the default Gray color profile.
    RGB Default Color Space Name of the default RGB color profile.
    Color Conversion Rendering Intent Specifies the render intent. Acceptable values are: perceptual, relative colometric, saturation, absolute colometric. Adobe recommends relative as the default.
  4. Tap Save.

For example, you could set the RGB Default Color Space to sRGB, and CMYK Default Color Space to WebCoated.

Doing so would do the following:

  • Enables color correction for RGB and CMYK images.
  • RGB images that do not have a color profile will be assumed to be in the sRGB color space.
  • CMYK images that do not have a color profile will be assumed to be in WebCoated color space.
  • Dynamic renditions that return RGB output, will return it in the sRGB color space.
  • Dynamic renditions that return CMYK output, will return it in the WebCoated color space.

Editing MIME types for supported formats

You can define which asset types are processed by Dynamic Media and customize advanced asset processing parameters. For example, you can specify asset processing parameters to do the following:

  • Convert an Adobe PDF to an eCatalog asset.
  • Convert an Adobe Photoshop Document (.PSD) to a banner template asset for personalization.
  • Rasterize an Adobe Illustrator file (.AI) or an Adobe Photoshop Encapsulated Postscript file (.EPS).
  • Video Profiles and Imaging Profiles can be used to define processing of videos and images, respectively.

See Uploading Assets.

To edit the MIME types for supported formats

  1. In AEM, click the AEM logo to access the global navigation console, then click General > CRXDE Lite.

  2. In the left rail, navigate to the following:

    /conf/global/settings/cloudconfigs/dmscene7/jcr:content/mimeTypes

    mimetypes

  3. Under the mimeTypes folder, select a mime type.

  4. On the right side of the CRXDE Lite page, in the lower portion:

    • Double-click the enabled field. By default all asset mime types are enabled (set to true), which means the assets will be synched to Dynamic Media for processing. If you want to exclude this asset mime type from being processed, change this setting to false.

    • Double-click jobParam to open its associated text field. See Supported Mime Types for a list of permitted processing parameter values you can use for a given mime type.

  5. Do one of the following:

    • Repeat steps 3-4 to edit additional mime types.
    • On the menu bar of the CRXDE Lite page, click Save All.
  6. In the upper-left corner of the page, tap CRXDE Lite to return to AEM.

Adding MIME types for unsupported formats

You can add custom MIME types for unsupported formats in AEM Assets. To ensure that any new node you add in CRXDE Lite is not deleted by AEM, you must ensure that you move the MIME type before image_ and its enabled value is set to false.

To add MIME types for unsupported formats

  1. From AEM, tap Tools > Operations > Web Console.

    2019-08-02_16-13-14

  2. A new browser tab opens to the Adobe Experience Manager Web Console Configuration page.

    2019-08-02_16-17-29

  3. On the page, scroll down to the name Adobe CQ Scene7 Asset MIME type Service as seen the following screenshot. To the right of the name, tap the Edit the configuration values (pencil icon).

    2019-08-02_16-44-56

  4. On the Adobe CQ Scene7 Asset MIME type Service page, click any plus sign icon <+>. The location in the table where you click the plus sign to add the new mime type is trivial.

    2019-08-02_16-27-27

  5. Type DWG=image/vnd.dwg in the empty text field that you just added.

    Note that the example DWG=image/vnd.dwg is for illustration purposes only. The MIME type that you add here can be any other unsupported format.

    2019-08-02_16-36-36

  6. In the lower-right corner of the page, tap Save.

    At this point, you can close the browser tab that has the open Adobe Experience Manager Web Console Configuration page.

  7. Return to the browser tab that has your open AEM console.

  8. From AEM, tap Tools > General > CRXDE Lite.

    2019-08-02_16-55-41

  9. In the left rail, navigate to the following:

    conf/global/settings/cloudconfigs/dmscene7/jcr:content/mimeTypes

  10. Drag the mime type image_vnd.dwg and drop it directly above image_ in the tree as seen in the following screenshot.

    crxdelite_cqdoc-14627

  11. With the mime type image_vnd.dwg still selected, from the Properties tab, in the enabled row, under the Value column header, double-click the value to open the Value drop-down list.

  12. Type false in the field (or select false from the drop-down list).

    2019-08-02_16-60-30

  13. Near the upper-left corner of the CRXDE Lite page, click Save All.

(Optional) Tuning the performance of Dynamic Media

To keep Dynamic Media running smoothly, Adobe recommends the following synchronization performance/scalability fine-tuning tips:

  • Updating the predefined Job parameters for processing of different file formats.
  • Updating the predefined Granite workflow (video assets) queue worker threads.
  • Updating the predefined Granite transient workflow (images and non-video assets) queue worker threads.
  • Updating the maximum upload connections to the Dynamic Media Classic server.

Updating the predefined Job parameters for processing of different file formats

You can tune job parameters for faster processing when you upload files. For example, if you are uploading PSD files, but do not want to process them as templates, you can set layer extraction to false (off). In such case, the tuned job parameter would appear as process=None&createTemplate=false.

Adobe recommends using the following “tuned” job parameters for PDF, Postscript, and PSD files:

File type Recommended job parameters
PDF pdfprocess=Rasterize&resolution=150&colorspace=Auto&pdfbrochure=false&keywords=false&links=false
Postscript psprocess=Rasterize&psresolution=150&pscolorspace=Auto&psalpha=false&psextractsearchwords=false&aiprocess=Rasterize&airesolution=150&aicolorspace=Auto&aialpha=false
PSD process=None&layerNaming=Layername&anchor=Center&createTemplate=false&extractText=false&extendLayers=false

Updating the Granite Transient Workflow queue

The Granite Transit Workflow queue is used for the DAM Update Asset workflow. In Dynamic Media, it is used for image ingestion and processing.

To update the Granite Transient Workflow queue

  1. Navigate to https://<server>/system/console/configMgr and search for Queue: Granite Transient Workflow Queue.

    NOTE

    A text search is necessary instead of a direct URL because the OSGi PID is dynamically generated.

  2. In the Maximum Parallel Jobs field, change the number to the desired value.

    You can increase Maximum Parallel Jobs to adequately support heavy upload of files to Dynamic Media. The exact value is dependent on hardware capacity. In certain scenarios–that is, an initial migration or a one-time bulk upload–you can use a large value. Be aware, however, that using a large value (such as two times the number of cores) may have negative effects on other concurrent activities. As such, you should test and adjust the value based on your particular use case.

chlimage_1

  1. Tap Save.

Updating the Granite Workflow queue

The Granite Workflow queue is used for non-transient workflows. In Dynamic Media, it used to to process video with the Dynamic Media Encode Video workflow.

To update the Granite Workflow queue:

  1. Navigate to https://<server>/system/console/configMgr and search for Queue: Granite Workflow Queue.

    NOTE

    A text search is necessary instead of a direct URL because the OSGi PID is dynamically generated.

  2. In the Maximum Parallel Jobs field, change the number to the desired value.

    By default, the maximum number of parallel jobs depends on the number of available CPU cores. For example, on a 4-core server, it assigns 2 worker threads. (A value between 0.0 and 1.0 is ratio based, or any numbers greater than 1 will assign the number of worker threads.)

    For most use cases, the 0.5 default setting is sufficient.

    chlimage_1-1

  3. Tap Save.

Updating the Scene7 upload connection

The Scene7 Upload Connection setting synchronizes AEM assets to Dynamic Media Classic servers.

To update the Scene7 upload connection:

  1. Navigate to https://<server>/system/console/configMgr/com.day.cq.dam.scene7.impl.Scene7UploadServiceImpl

  2. In the Number of connections field and/or the Active job timeout field, change the number as desired.

    The Number of connections setting controls the maximum number of HTTP connections allowed for AEM to Dynamic Media upload; typically, the predefined value of 10 connections is sufficient.

    The Active job timeout setting determines the wait time for uploaded Dynamic Media assets to be published in delivery server. This value is 2100 seconds or 35 minutes by default.

    For most use cases, the setting of 2100 is sufficient.

    chlimage_1-2

  3. Tap Save.

On this page