DocumentationAEM 6.4Assets Guide

Configuring Dynamic Media - Scene7 mode configuring-dynamic-media-scene-mode

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
  • User
  • Developer
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

If you use Adobe Experience Manager set up for different environments, such development, staging, and live production, you must configure Dynamic Media Cloud Services for each environment.

Architecture diagram of Dynamic Media - Scene7 mode architecture-diagram-of-dynamic-media-scene-mode

The following architecture diagram describes how Dynamic Media - Scene7 mode works.

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

  1. When the primary asset is uploaded to Experience Manager, 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 can securely access and preview the remote Dynamic Media renditions (no binaries are sent back to the Experience Manager 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

Enabling Dynamic Media in Scene7 mode enabling-dynamic-media-in-scene-mode

Dynamic Media is disabled by default. To take advantage of Dynamic Media features, you must enable it.

WARNING
Dynamic Media - Scene7 mode is for the Experience Manager Author instance only. As such, configure runmode=dynamicmedia_scene7on the Experience Manager Author instance, not the Experience Manager Publish instance.

To enable Dynamic Media, you must start Experience Manager using the dynamicmedia_scene7 run mode from the command line by entering the following in a terminal window (example port used is 4502):

java -Xms4096m -Xmx4096m -Doak.queryLimitInMemory=500000 -Doak.queryLimitReads=500000 -jar cq-quickstart-6.4.0.jar -gui -r author,dynamicmedia_scene7 -p 4502

(Optional) Migrating Dynamic Media presets and configurations from 6.3 to 6.4 Zero Downtime optional-migrating-dynamic-media-presets-and-configurations-from-to-zero-downtime

If you upgrade Experience Manager Dynamic Media from 6.3 to 6.4 (which includes the ability for zero downtime deployments), run the following curl command to migrate all your presets and configurations from /etc to /conf in CRXDE Lite.

NOTE
If you run your Experience Manager instance in compatibility mode - that is, you have the compatibility packaged installed - you do not need to run these commands.

To migrate your custom presets and configurations from /etc to /conf, run the following Linux® curl command:

curl -u admin:admin http://localhost:4502/libs/settings/dam/dm/presets.migratedmcontent.json

For all upgrades, either with or without the compatibility package, you can copy the out-of-the-box viewer presets by running the following command:

curl -u admin:admin http://localhost:4502/libs/settings/dam/dm/presets/viewer.pushviewerpresets

(Optional) Installing feature pack 18912 for bulk asset migration installing-feature-pack

Feature pack 18912 lets you either bulk ingest assets by way of FTP, or migrate assets from either Dynamic Media - Hybrid mode or Dynamic Media Classic into Dynamic Media - Scene7 mode on Experience Manager. It is available from Adobe Professional Services.

See Installing feature pack 18912 for bulk asset migration for more information.

Configuring Dynamic Media Cloud Services configuring-dynamic-media-cloud-services

Change the password, before you configure Dynamic Media Cloud Services. After you receive your provisioning email with Dynamic Media credentials, you must sign in to Dynamic Media Classic desktop application to change your password. The password provided in the provisioning email is system-generated and intended to be a temporary password only. It is important that you update the password so that Dynamic Media Cloud Service is set up with the correct credentials.

NOTE
By default, the configuration path for Cloud Services is /content/dam. Any other configuration path is not support by Dynamic Media - Scene7 mode.

To configure Dynamic Media Cloud Services:

  1. In your Experience Manager Author instance, tap the Experience Manager logo to access the global navigation console and tap the Tools icon, then tap Cloud Services > Dynamic Media Configuration.

  2. On the Dynamic Media Configuration Browser page, in the left pane, tap global and tap Create. Do not tap or select the folder icon to the left of global.

  3. On the Create Dynamic Media Configuration page, enter a title, the Dynamic Media account email address, and password. Select your region. This information is provided to you by Adobe in your provisioning email. Contact Adobe Customer Support if you did not receive the email.

    Tap Connect to Dynamic Media.

    note note
    NOTE
    After you receive your provisioning email with Dynamic Media credentials, open the Dynamic Media Classic desktop application, then sign in to your company account to change your password. The password provided in the provisioning email is system-generated and intended to be a temporary password only. It is important that you update the password so that the Dynamic Media Cloud Service is set up with the correct credentials.

  4. If the connection is successful, you can also set the following:

    • Company - the name of the Dynamic Media account.

      note important
      IMPORTANT
      Only one Dynamic Media Configuration in Cloud Services is supported on an instance of Experience Manager; do not add more than one configuration. Multiple Dynamic Media Configurations on an Experience Manager instance is not supported or recommended by Adobe.

      * **Company Root Folder Path** - Your company’s root folder path.

    • Publishing Assets - the option Immediately means that when assets are uploaded, the system ingests the assets and provides the URL/Embed instantly. There is no user intervention necessary to publish assets. The option Upon Activation means that you must explicitly publish the asset first before a URL/Embed link is provided.

    • Secure Preview Server - lets you specify the URL path to your secure renditions preview server. That is, after renditions are generated, Experience Manager can securely access and preview the remote Dynamic Media renditions (no binaries are sent back to the Experience Manager instance).

      Unless you have a special arrangement to use your own company’s server or a special server, Adobe recommends that you use the default setting.

    note note
    NOTE
    There is no support for versioning in DMS7. 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

  5. Tap Save.

  6. To securely preview Dynamic Media content before it gets published, you must “allowlist” the Experience Manager Author instance to connect to Dynamic Media:

    • 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 Technical Support.
    • On the navigation bar near the top right of the page, tap 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.
    • To enable (turn on) the address, select the check box. Enter the IP address of the Experience Manager Author instance (not Dispatcher IP).
    • Tap Save.

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

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

(Optional) Configuring Advanced Settings in Dynamic Media - Scene7 mode optional-configuring-advanced-settings-in-dynamic-media-scene-mode

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

(Optional) Setup and configuration of Dynamic Media - Scene7 mode settingsoptional-setup-and-configuration-of-dynamic-media-scene-mode-settings-p

When you are in dynamicmedia_scene7 run mode, you 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 are:

Publishing setup for Image Server 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, tap Setup > Application Setup > Publish Setup > Image Server.

The Image Server screen establishes default settings for delivering images. See the user interface for a 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 Important considerations when implementing localization support.

Configuring application general settings configuring-application-general-settings

To open the Application General Settings page, in Dynamic Media Classic Global Navigation bar, tap 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 Experience Manager 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 fulfilled, a duplicate is created.
NOTE
To maintain consistency with Experience Manager, select 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 replaces chair.jpg and 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.

NOTE
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 the number of image presets that display or Increasing the number of viewer presets that display.

Configuring color management 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. Open the Dynamic Media Classic desktop application, then sign in to your account 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 that you must change. For example, a property in the Color Management Attributes area.

    You can set the following color correction properties:

    • 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. The acceptable values are perceptual, relative colometric, saturation, and 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 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, returns it in the sRGB color space.
  • Dynamic renditions that return CMYK output, returns it in the WebCoated color space.

Editing MIME types for supported formats 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 mime types for supported formats:

  1. In Experience Manager, tap the Experience Manager logo to access the global navigation console, then tap the Tools (hammer) icon and navigate to 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 are 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 that 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, tap Save All.

  6. In the upper-left corner of the page, tap CRXDE Lite to return to Experience Manager.

Adding custom MIME types for unsupported formats adding-custom-mime-types-for-unsupported-formats

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

To add custom MIME types for unsupported formats:

  1. From Experience Manager, click Tools > Operations > Web Console.

    Web Console

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

    Experience Manager Web Console configuration

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

    Edit the configuration values

  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.

    Plus sign icon

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

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

    Example mime type addition

  6. In the lower-right corner of the page, click 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 console.

  8. From Experience Manager, click Tools > General > CRXDE Lite.

    CRXDE Lite page

  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.

    Drag mime type

  11. With the mime type image_vnd.dwg still selected in the tree, 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).

    False value

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

Creating batch set presets to auto-generate Image Sets and Spin Sets creating-batch-set-presets-to-auto-generate-image-sets-and-spin-sets

Use batch set presets to automate the creation of image sets or spin sets while assets are uploaded to Dynamic Media.

First, define the naming convention for how assets are grouped in a set. You can then create a batch set preset which is a uniquely named, self-contained set of instructions that defines how to construct the set using images that match the defined naming conventions in the preset recipe.

When you upload files, Dynamic Media automatically creates a set with all files that match the defined naming convention in the active presets.

Configuring default naming

Create a default naming convention that is used in any batch set preset recipe. The default naming convention selected in the batch set preset definition is likely all that your company needs for generating batch sets. A batch set preset is created to use the default naming convention that you define. You are able to create as many Batch Set presets with alternate, custom naming conventions needed for a particular set of content in cases where there is an exception to the company-defined default naming.

While setting up a default naming convention is not required to use batch set preset functionality, you can use it to define as many elements of your naming convention that you want grouped in a set. Doing so helps to streamline batch set creation.

As an alternative, you can use View Code with no form fields available. In this view, you create your naming convention definitions entirely using regular expressions.

Two elements are available for definition, Match and Base Name. These fields let you define all elements of a naming convention and identify the part of the convention used to name the set in which they are contained. A company’s individual naming convention can use one or more lines of definition for each of these elements. Use as many lines for your unique definition and group them into distinct elements. For example, Main Image, Color element, Alternate View element, and Swatch element.

To configure default naming:

  1. 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 Technical Support.

  2. On the navigation bar near the top of the page, tap Setup > Application Setup > Batch Set Presets > Default Naming.

  3. Select View Form or View Code to specify how you want to view and enter information about each element.

    You can select the View Code check box to view the regular expression value building alongside your form selections. You are able to enter or alter these values to help define the elements of the naming convention, if the form view limits you for any reason. If your values are unable to be parsed in the form view, the form fields become inactive.

    note note
    NOTE
    De-activated form fields perform no validation that your regular expressions are correct. You see results of the regular expression that you are building for each element after the Result line. The complete regular expression is visible at the bottom of the page.

  4. Expand each element as necessary and enter the naming conventions you want to use.

  5. As necessary, do any of the following:

    • Tap Add to add another naming convention for an element.
    • Tap Remove to delete a naming convention for an element.

  6. Do one of the following:

    • Tap Save As and type a name for the preset.
    • Tap Save if you are editing an existing preset.

Creating a Batch Set Preset

Dynamic Media uses batch set presets to organize assets into sets of images (alternate images, color options, 360 spin) for display in viewers. The batch set presets automatically run alongside the asset upload processes in Dynamic Media.

You can create, edit, and manage your batch set presets. There are two forms of batch set preset definitions: one for a default naming convention that you set up, and one for custom naming conventions that you create on the fly.

You can use either the form field method to define a batch set preset or the code method, which lets you use regular expressions. As in Default Naming, you can choose View Code at the same time you are defining in the Form View and use regular expressions to build your definitions. Alternately, you can uncheck either view to use one or the other exclusively.

To create a Batch Set Preset:

  1. 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 Technical Support.

  2. On the navigation bar near the top of the page, tap Setup > Application Setup > Batch Set Presets > Batch Set Preset.

    View Form, as set in the upper-right corner of the Details page, is the default view.

  3. In the Preset List panel, tap Add to activate the definition fields in the Details panel on the right-hand side of the screen.

  4. In the Details panel, in the Preset Name field, type a name for the preset.

  5. In the Batch Set Type drop-down menu, select a preset type.

  6. Do one of the following:

    • If you are using a default naming convention that you previously set up under Application Setup > Batch Set Presets > Default Naming, expand Asset Naming Conventions, and then in the File Naming drop-down list, tap Default.
    • To define a new naming convention as you set up the preset, Asset Naming Conventions, and then in the File Naming drop-down list, tap Custom.

  7. For Sequence order, define the order in which images are displayed after the set is grouped in Dynamic Media.

    By default, your assets are ordered alphanumerically. However, you can use a comma-separated list of regular expressions to define the order.

  8. For Set Naming and Creation Convention, specify the suffix or prefix to the base name you defined in the Asset Naming Convention. Also, define where the set is created within the Dynamic Media folder structure.

    If you define large numbers of sets, keep them separate from the folders that contain the assets themselves. For example, create an Image Sets folder and put generated sets here.

  9. In the Details panel, tap Save.

  10. Tap Active next to the new preset name.

    Activating the preset ensures that when you upload assets to Dynamic Media, the batch set preset is applied to generate the set.

Creating a Batch Set Preset for the auto-generation of a 2D Spin Set

You can use the Batch Set Type Multi-Axis Spin Set to create a recipe that automates the generation of 2D Spin Sets. The grouping of images uses Row and Column regular expressions so that the image assets are properly aligned in the corresponding location in the multi-dimensional array. There is no minimum or maximum number of rows or columns that you must have in a multi-axis spin set.

As an example, suppose you want to create a multi-axis spin set named spin-2dspin. You have a set of spin set images that contain three rows, with 12 images per row. The images are named as follows:

spin-01-01
 spin-01-02
 …
 spin-01-12
 spin-02-01
 …
 spin-03-12

With this information, your Batch Set Type recipe could be created as follows:

chlimage_1-1

Grouping for the shared asset name part of the spin set is added to the Match field (as highlighted). The variable part of the asset name containing the row and column is added to the Row and Column fields, respectively.

When the Spin Set is uploaded and published, you activate the name of the 2D Spin Set recipe that is listed under Batch Set Presets in the Upload Job Options dialog box.

To create a Batch Set Preset for the auto-generation of a 2D Spin Set:

  1. 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 Technical Support.

  2. On the navigation bar near the top of the page, tap Setup > Application Setup > Batch Set Presets > Batch Set Preset.

    View Form, as set in the upper-right corner of the Details page, is the default view.

  3. In the Preset List panel, tap Add to activate the definition fields in the Details panel on the right-hand side of the screen.

  4. In the Details panel, in the Preset Name field, type a name for the preset.

  5. In the Batch Set Type drop-down menu, select Asset Set.

  6. In the Sub Type drop-down list, select Multi-Axis Spin Set.

  7. Expand Asset Naming Conventions, and then in the File Naming drop-down list, tap Custom.

  8. Use the Match and, optionally, Base Name attributes to define a regular expression for the naming of image assets that make up the grouping.

    For example, your literal Match regular expression could look like the following:

    (w+)-w+-w+

  9. Expand Row Column Position, and then define the name format for the position of the image asset within the 2D Spin Set array.

    Use the parenthesis to embrace the row or column position in the file name.

    For example, for your row regular expression, it could look like the following:

    \w+-R([0-9]+)-\w+

    or

    \w+-(\d+)-\w+

    For your column regular expression, it could look like the following:

    \w+-\w+-C([0-9]+)

    or

    \w+-\w+-C(\d+)

    Remember that these expressions are examples for demonstration purposes only. You can create your regular expression however you want to suit your needs.

    note note
    NOTE
    If the combination of row and column regular expressions cannot determine the position of the asset within the multi-dimensional spin set array, then that asset is not added to the set and an error is logged.

  10. For Set Naming and Creation Convention, specify the suffix or prefix to the base name you defined in the Asset Naming Convention.

    Also, define where the spin set are created within the Dynamic Media Classic folder structure.

    If you define large numbers of sets, keep them separate from the folders that contain the assets themselves. For example, create a Spin Sets folder to place generated sets here.

  11. In the Details panel, tap Save.

  12. Tap Active next to the new preset name.

    Activating the preset ensures that when you upload assets to Dynamic Media, the batch set preset is applied to generate the set.

(Optional) Tuning the performance of Dynamic Media - Scene7 mode optional-tuning-the-performance-of-dynamic-media-scene-mode

To keep Dynamic Media - Scene7 mode 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 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=Thumbnail&resolution=150&colorspace=Auto&pdfbrochure=false&keywords=false&links=false
PostScript®
psprocess=Rasterize&psresolution=150&pscolorspace=Auto&psalpha=false&psextractsearchwords=false&aiprocess=Thumbnail&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, follow the steps in Enabling MIME type-based Assets/Dynamic Media Classic upload job parameter support.

Updating the Granite Transient Workflow queue 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 note
    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

  3. Tap Save.

Updating the Granite Workflow queue updating-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 note
    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. Tap Save.

Updating the Scene7 upload connection updating-the-scene-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 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 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. Tap Save.

(Optional) Filtering assets for replication optional-filtering-assets-for-replication

In non-Dynamic Media deployments, you replicate all assets (both images and video) from your Experience Manager Author environment to the Experience Manager Publish node. This workflow is necessary because the Experience Manager Publish servers also deliver the assets.

However, in Dynamic Media deployments, because assets are delivered by way of the Cloud Service, there is no need to replicate those same assets to Experience Manager Publish nodes. Such a “hybrid publishing” workflow avoids extra storage costs and longer processing times to replicate assets. Other content, such as Site pages, continue to be served from the Experience Manager Publish nodes.

The filters provide a way for you to exclude assets from being replicated to the Experience Manager Publish node.

Using default asset filters for replication using-default-asset-filters-for-replication

If you are using Dynamic Media for imaging, or video, or both, then you can use the default filters that Adobe provides as-is. The following filters are active by default:

Filter
Mimetype
Renditions
Dynamic Media Image Delivery

filter-images

filter-sets

Starts with image/

Contains application/ and ends with set.

The out-of-the-box "filter-images" (applies to single images assets, including interactive images) and "filter-sets" (applies to Spin Sets, Image Sets, Mixed Media Sets, and Carousel Sets) will:

  • Exclude from replication the original image and static image renditions.
Dynamic Media Video Delivery
filter-video
Starts with video/

The out-of-the-box "filter-video" will:

  • Exclude from replication the original video and static thumbnail renditions.
NOTE
Filters apply to MIME types and cannot be path-specific.

Customizing asset filters for replication customizing-asset-filters-for-replication

  1. In Experience Manager, tap the Experience Manager logo to access the global navigation console and tap the Tools icon and navigate to General > CRXDE Lite.

  2. In the left folder tree, navigate to /etc/replication/agents.author/publish/jcr:content/damRenditionFilters to review the filters.

    chlimage_1-2

  3. To define the Mime Type for the filter, you can locate the Mime Type as follows:

    In the left rail, expand content > dam > <locate_your_asset> > jcr:content > metadata, and then in the table on the right, locate dc:format.

    The following graphic is an example of an asset’s path to dc:format.

    chlimage_1-3

    Notice that the dc:format for the asset Fiji Red.jpg is image/jpeg.

    To have this filter apply to all images, regardless of their format, set the value to image/* where * is a regular expression that is applied to all images of any format.

    To have the filter apply only to images of the type JPEG, enter a value of image/jpeg.

  4. Define what renditions you want to include or exclude from replication.

    Characters that you can use to filter for replication include the following:

    table 0-row-2 1-row-2 2-row-2 3-row-2 html-authored no-header
    Character to use How it filters assets for replication
    * Wildcard character
    + Includes assets for replication.
    - Excludes assets from replication.

    Navigate to content/dam/<locate your asset>/jcr:content/renditions.

    The following graphic is an example of an asset’s renditions.

    chlimage_1-4

    If you only wanted to replicate the original, then you would enter +original.

recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad