About configuring Dynamic Media Cloud Service

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

Architecture diagram of Dynamic Media

The following architecture diagram describes how Dynamic Media works.

With the new architecture, Experience Manager is responsible for primary source assets and syncs with Dynamic Media for asset processing and publishing:

  1. When the primary source asset is uploaded to Adobe Experience Manager as a Cloud Service, 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, Experience Manager as a Cloud Service can securely access and preview the remote Dynamic Media renditions (no binaries are sent back to the Experience Manager as a Cloud Service instance).
  3. After content is ready to publish and approve, it triggers the Dynamic Media service to push content to delivery servers and cache content at the CDN (Content Delivery Network).

chlimage_1-550

NOTE

The following list of features requires you to use the out-of-the-box CDN that is bundled with Adobe Experience Manager - Dynamic Media. Any other custom CDN is not supported with these features.

Create a Dynamic Media Configuration in Cloud Services

  1. In Experience Manager as a Cloud Service, select the Experience Manager as a Cloud Service logo to access the global navigation console.

  2. On the left of the console, select the Tools icon, then go to Cloud Services > Dynamic Media Configuration.

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

  4. On the Create Dynamic Media Configuration page, enter a title, the Dynamic Media account email address, password, then select your region. This information is provided to you by Adobe in the provisioning email. Contact Adobe Customer Care if you did not receive this email.

  5. Select 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: # $ & . - _ : { }

    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 selecting the password eye icon to reveal the password. Select the icon again to hide the password.

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

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

    If you selected Cancel in the Change Password dialog box, you must still enter a new password when you save the newly created Dynamic Media configuration.

    See also Change 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 that you have multiple Dynamic Media accounts for different subbrands, divisions, or 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.
    On Activation - You must explicitly publish the asset first before a URL/Embed link is provided.
    Selective Publish - Assets are auto published for secure preview only. They can also be explicitly published to Experience Manager as a Cloud Service without publishing to DMS7 for delivery in the public domain. In the future, this option intends to publish assets to Experience Manager as a Cloud Service 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 Experience Manager as a Cloud Service 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, Experience Manager as a Cloud Service can securely access and preview the remote Dynamic Media renditions (no binaries are sent back to the Experience Manager as a Cloud Service instance).
    Unless you have a special arrangement to use your own company’s server or a special server, Adobe 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 in the toolbar, select Properties. On the Details tab, in the Dynamic Media sync mode drop-down list, choose from the following three options. When you are done, select Save. Remember: these three options are not available if you selected Sync all content earlier. See also Work 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 tooltip.
    Enable for subfolders - Include everything in this subtree for sync to Dynamic Media. The folder-specific settings override the default mode in the cloud configuration.
    Disabled for subfolders - Exclude everything in this subtree 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. Select Save. The new Dynamic Media password and configuration is saved. If you selected Cancel instead, no password update occurs.

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

    IMPORTANT

    When the new Dynamic Media configuration finishes its setup, you receive a status notification within Experience Manager as a Cloud Service’s Inbox.

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

  11. To securely preview Dynamic Media content before it gets published, Experience Manager as a Cloud Service uses token based validation by default. However, you can also “allowlist” more IPs to provide users access to securely preview content. To set up this action, do the following:

    • Open the Dynamic Media Classic desktop application, then sign in to your account. Your credentials and sign-in details were provided by Adobe at the time of provisioning. If you do not have this information, contact Adobe Customer Care.
    • On the navigation bar near the upper right corner of the page, go to 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, select Add.
    • To enable (turn on) the address, select the check box, then enter the IP address of the Experience Manager Author instance (not Dispatcher IP).
    • Select 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 Configure Advanced Settings in Dynamic Media.

Troubleshoot a new Dynamic Media configuration

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

Experience Manager Inbox success

Experience Manager Inbox failure

See also Your Inbox.

To troubleshoot a new Dynamic Media configuration:

  1. Near the upper-right corner of the Experience Manager as a Cloud Service page, select the bell icon, then select View All.

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

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

    Dynamic Media setup failed

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

    Dynamic Media Set up page

Change 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 selecting the password eye icon to reveal the password. Select the icon again to hide the password.

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

  1. In Experience Manager as a Cloud Service, select the Experience Manager as a Cloud Service logo to access the global navigation console.

  2. On the left of the console, select the Tools icon, then go to Cloud Services > Dynamic Media Configuration.

  3. On the Dynamic Media Configuration Browser page, in the left pane, select global. Do not select the folder icon to the left of global. Then, select Edit.

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

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

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

      The Current Password field is intentionally pre-filled and hidden from interaction.

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

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

(Optional) Configure Advanced Settings in Dynamic Media

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 change your Dynamic Media settings.

Some of the tasks above require that you open the Dynamic Media Classic desktop application, then sign in to your account.

Setup and configuration tasks include the following:

Publish 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, go to 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.

Configure application general settings

To open the Application General Settings page, in Dynamic Media Classic Global Navigation bar, go to 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 website 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 Experience Manager as a Cloud Service 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 different from the original or assets with a different file extension from the original.
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 it has the same file extension as the original. If these requirements are not met, a duplicate is created. To maintain consistency with Experience Manager as a Cloud Service, 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 file 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 file 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 Configure 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 Increase or decrease the number of image presets that display or Increase or decrease the number of viewer presets that display.

Configure 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 Configure Image Presets.

To configure the default color properties for enabling color correction when requesting images:

  1. Open the Dynamic Media Classic desktop application, then sign in to your account using credentials provided during provisioning.

  2. Go to Setup > Application Setup.

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

  4. Scroll to the property you must 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.
    Grayscale 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.
  5. Select 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 are assumed to be in the sRGB color space.
  • CMYK images that do not have a color profile are assumed to be in WebCoated color space.
  • Dynamic renditions that return RGB output, return it in the sRGB color space.
  • Dynamic renditions that return CMYK output, return it in the WebCoated color space.

Edit 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 Image Profiles can be used to define processing of videos and images, respectively.

See Upload assets.

To edit MIME types for supported formats:

  1. In Experience Manager as a Cloud Service, select the Experience Manager as a Cloud Service logo to access the global navigation console, then go to General > CRXDE Lite.

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

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

    MIME types

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

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

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

    • Double-tap 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 more MIME types.
    • On the menu bar of the CRXDE Lite page, select Save All.
  6. In the upper-left corner of the page, select CRXDE Lite to return to Experience Manager as a Cloud Service.

Add MIME types for unsupported formats

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

To add MIME types for unsupported formats:

  1. From Experience Manager as a Cloud Service, go to 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, select any plus sign icon <+>. The location in the table where you select 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.

    The DWG=image/vnd.dwg MIME type is for sample 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, select 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 Experience Manager as a Cloud Service console.

  8. From Experience Manager as a Cloud Service, go to 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-tap the value. The Value drop-down list is opened.

  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, select Save All.

(Optional) Tune 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.

Update 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 upload 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 appears as follows: process=None&createTemplate=false.

In case you do want to turn on template creation, use the following parameters: process=MaintainLayers&layerNaming=AppendName&createTemplate=true.

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=AppendName&anchor=Center&createTemplate=false&extractText=false&extendLayers=false

To update any of these parameters, see Editing MIME types for supported formats.

See also Adding MIME types for unsupported formats.

Update 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 depends on hardware capacity. In certain scenarios, such as 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) can have negative effects on other concurrent activities. As such, test and adjust the value based on your particular use case.

chlimage_1

  1. Select Save.

Update the Granite Workflow queue

The Granite Workflow queue is used for non-transient workflows. In Dynamic Media, it used 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 two worker threads. (A value between 0.0 and 1.0 is ratio-based, or any numbers greater than one assigns the number of worker threads.)

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

    chlimage_1-1

  3. Select Save.

Update the Scene7 upload connection

The Scene7 Upload Connection setting synchronizes Experience Manager 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, or the Active job timeout field, or both, change the number as desired.

    The Number of connections setting controls the maximum number of HTTP connections allowed for Experience Manager to Dynamic Media upload. Typically, the predefined value of ten 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. Select Save.

On this page