Troubleshoot Dynamic Media - Scene7 mode troubleshooting-dynamic-media-scene-mode
The following document describes troubleshooting for Dynamic Media running dynamicmedia_scene7 run mode.
Setup and Configuration setup-and-configuration
Ensure that Dynamic Media has been set up properly by doing the following:
-
Start up command contains the
-r dynamicmedia_scene7
run mode argument. -
Any Adobe Experience Manager 6.4 cumulative fix packs (CFPs) have been installed first before any available Dynamic Media Feature Packs.
-
Optional Feature Pack 18912 is installed.
This optional feature pack is for FTP support or if you are migrating assets to Dynamic Media from Dynamic Media Classic.
-
Navigate to the Cloud Services user interface and confirm that the provisioned account appears under Available Configurations.
-
Ensure that the
Dynamic Media Asset Activation (scene7)
replication agent is enabled.This replication agent is found under Agents on Author.
General (All Assets) general-all-assets
The following are some general tips and tricks for all assets.
Asset Synchronization Status Properties asset-synchronization-status-properties
The following asset properties can be reviewed in CRXDE Lite to confirm the successful synchronization of the asset from Experience Manager to Dynamic Media:
<object_node>/jcr:content/metadata/dam:scene7ID
a|364266
<object_node>/jcr:content/metadata/dam:scene7FileStatus
<object_node>/jcr:content/metadata/dam:scene7File
<object_node>/jcr:content/dam:lastSyncStatus
<error text>
Synchronization Logging synchronization-logging
Synchronization errors and issues are logged in error.log
(Experience Manager server directory /crx-quickstart/logs/
). Sufficient logging is available to determine the root cause of most issues, however you can increase the logging to DEBUG on the com.adobe.cq.dam.ips
package through the Sling Console (https://localhost:4502/system/console/slinglog) to gather more information.
Move, Copy, Delete move-copy-delete
Before performing a Move, Copy, or Delete operation, do the following:
- For images and videos, confirm that a
<object_node>/jcr:content/metadata/dam:scene7ID
value exists before performing move, copy, or delete operations. - For image and viewer presets, confirm that an
https://<server>/crx/de/index.jsp#/etc/dam/presets/viewer/testpreset/jcr%3Acontent/metadata
value exists before performing move, copy, or delete operations. - If above metadata value is missing, you must reupload assets before move, copy, or delete operations.
Version Control version-control
When replacing an existing Dynamic Media asset (same name and location), you can keep both assets or replace/create a version:
-
Keeping both creates an asset with a unique name for the published asset URL. For example,
image.jpg
is the original asset andimage1.jpg
is the newly uploaded asset. -
Creating a version is not supported in Dynamic Media - Scene7 mode delivery. The new version replaces the existing asset in delivery.
Images and Sets images-and-sets
If you are having issues with images and sets, see the following troubleshooting guidance.
Video video
If you are having issues with video, see the following troubleshooting guidance.
Viewers viewers
If you are having issues with viewers, see the following troubleshooting guidance.
Issue: Viewer presets are not published viewers-not-published
How to debug
-
Proceed to sample manager diagnostic page:
https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html
. -
Observe computed values. When operating correctly, you see the following:
_DMSAMPLE status: 0 unsyced assets - activation not necessary _OOTB status: 0 unsyced assets - 0 unactivated assets
.note note NOTE It can take about 10 minutes after configuration of Dynamic Media cloud settings for the viewer assets to sync. -
If unactivated assets remain, select either of the List all Unactivated Assets buttons to see details.
Solution
- Navigate to viewer preset list in admin tools:
https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html
- Select all viewer presets, then select Publish.
- Navigate back to sample manager and observe that unactivated asset count is now zero.
Issue: Viewer preset artwork returns 404 from Preview in asset details or Copy URL/Embed code viewer-preset-404
How to debug
In CRXDE Lite do the following:
-
Navigate to
<sync-folder>/_CSS/_OOTB
folder within your Dynamic Media sync folder (for example,/content/dam/_CSS/_OOTB
). -
Find the metadata node of the problematic asset (for example,
<sync-folder>/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png/jcr:content/metadata/
). -
Check for the presence of
dam:scene7*
properties. If the asset was successfully synced and published, you see thedam:scene7FileStatus
set is to PublishComplete. -
Attempt to request the artwork directly from Dynasmic Media by concatenating the values of the following properties and string literals:
dam:scene7Domain
"is/content"
dam:scene7Folder
<asset-name>
Example:https://<server>/is/content/myfolder/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png
Solution
If the sample assets or viewer preset artwork has not synced or published, restart the entire copy/sync process:
- Navigate to CRXDE Lite.
- Delete
<sync-folder>/_CSS/_OOTB
. - Navigate to the CRX Package Manager:
https://localhost:4502/crx/packmgr/
. - Search for viewer package in the list; it starts with
cq-dam-scene7-viewers-content
. - Select Reinstall.
- Under Cloud Services, navigate to the Dynamic Media Configuration page, then open the configuration dialog box for your Dynamic Media - S7 configuration.
- Make no changes, select Save.
This save action triggers the logic again to create and sync the sample assets, viewer preset CSS, and artwork.
Issue: Image Preview is not loading in Viewer presets authoring image-preview-not-loading
Solution
-
In Experience Manager, select the Experience Manager logo to access the global navigation console, then navigate to Tools > General > CRXDE Lite.
-
In the left rail, navigate to the sample content folder at the following location:
/content/dam/_DMSAMPLE
-
Delete the
_DMSAMPLE
folder. -
In the left rail, navigate to the presets folder at the following location:
/conf/global/settings/dam/dm/presets/viewer
-
Delete the
viewer
folder. -
Near the upper-left corner of the CRXDE Lite page, select Save All.
-
In the upper-left corner of the CRXDE Lite page, select the Back Home icon.
-
Re-create a Dynamic Media Configuration in Cloud Services.