Configuration de Dynamic Media – mode hybride

Dynamic Media : l’option hybride doit être activée et configurée pour être utilisée. Selon l’utilisation que vous souhaitez en faire, Dynamic Media prend en charge plusieurs configurations.

REMARQUE

Si vous envisagez de configurer et d’exécuter Dynamic Media en mode d’exécution Scene7, voir Configuration de Dynamic Media – mode Scene7.

Si vous envisagez de configurer et d’exécuter Dynamic Media en mode d’exécution hybride, suivez les instructions sur cette page.

En savoir plus sur l’utilisation des vidéos dans Dynamic Media.

Si Adobe Experience Manager est configuré dans des environnements différents, tels que le développement, l’évaluation et la production, vous devez configurer Dynamic Media Cloud Services pour chacun de ces environnements.

Si vous rencontrez des problèmes lors de la configuration de Dynamic Media, veillez à prêter une attention particulière aux fichiers journaux spécifiques à Dynamic Media. Ces fichiers sont installés automatiquement lorsque vous activez Dynamic Media :

  • s7access.log
  • ImageServing.log

Elles sont documentées dans Surveillance et maintenance de votre instance AEM.

La diffusion de contenus et la publication hybride est une fonctionnalité clé lorsque vous ajoutez Dynamic Media à Adobe Experience Manager. La publication hybride vous permet de diffuser des ressources Dynamic Media, telles que des images, des visionneuses et des vidéos, à partir du cloud plutôt que depuis les noeuds de publication AEM.

D’autres contenus, comme les visionneuses Dynamic Media, les pages de site et le contenu statique, restent diffusés depuis les nœuds de publication AEM.

Si vous êtes client de Dynamic Media, vous devez utiliser la diffusion hybride comme mécanisme de diffusion pour tout le contenu Dynamic Media.

Architecture de publication hybride des vidéos

chlimage_1-506

Architecture de publication hybride pour les images

chlimage_1-507

Configurations Dynamic Media prises en charge

Les tâches de configuration suivantes font référence aux termes suivants :

Terme Dynamic Media activé Description
AEM noeud Auteur Coche blanche dans un cercle vert Noeud de création que vous déployez sur On-Premise ou via Managed Services.
AEM noeud de publication "X" blanc dans un carré rouge. Noeud de publication que vous déployez sur On-Premise ou via Managed Services.
Noeud de publication Image Service Coche blanche en cercle vert. Noeud de publication que vous exécutez sur les centres de données gérés par Adobe. Renvoie à l’URL du service d’images.

Vous pouvez choisir d’implémenter Dynamic Media uniquement pour les images, uniquement pour les vidéos ou à la fois pour les images et les vidéos. Pour déterminer les étapes à suivre pour configurer Dynamic Media pour votre scénario, reportez-vous au tableau suivant.

Scénario Fonctionnement Étapes de configuration
Livraison des images en production UNIQUEMENT Les images sont livrées par les serveurs des data centers Adobe du monde entier, puis mises en cache par un réseau de diffusion de contenu pour une portée internationale et des performances évolutives.
  1. Sur le nœud auteur d’AEM, activez Dynamic Media.
  2. Configurez l’imagerie dans Dynamic Media Cloud Services.
  3. Configurez la réplication de l’image.
  4. Répliquez les paramètres du catalogue.
  5. Répliquez les paramètres de la visionneuse.
  6. Utilisez les filtres de ressource par défaut pour la réplication.
  7. Configurez les paramètres du serveur d’images Dynamic Media.
  8. Livrez les ressources.
Livraison des images en préproduction UNIQUEMENT (développement, évaluation de la qualité, zone de transit, etc.) Les images sont livrées via le nœud de publication d’AEM. Dans ce scénario, puisque le trafic est minimal, il n’est pas nécessaire d’envoyer les images vers le centre données d’Adobe. Un autre avantage est que cela permet un aperçu sécurisé du contenu avant le lancement de la production.
  1. Sur le nœud auteur d’AEM, activez Dynamic Media.
  2. Sur AEM noeud publish, activez Dynamic Media.
  3. Répliquez les paramètres de la visionneuse.
  4. Configurez le filtre de ressources pour les images qui ne sont pas en production.
  5. Configurez les paramètres du serveur d’images Dynamic Media.
  6. Livrez les ressources.
Livraison de la vidéo UNIQUEMENT dans n’importe quel environnement (production, développement, évaluation de la qualité, zone de transit, etc.) Les vidéos sont livrées et mises en cache par un réseau de diffusion de contenu pour des performances extensibles et une portée globale. L’image d’affiche de la vidéo (la miniature de la vidéo qui s’affiche avant le début de la lecture) sera livrée par l’instance de publication d’AEM.
  1. Sur le nœud auteur d’AEM, activez Dynamic Media.
  2. Sur le nœud de publication d’AEM, activez Dynamic Media (l’instance de publication envoie l’image d’affiche de la vidéo et fournit les métadonnées pour la lecture de la vidéo).
  3. Configurez la vidéo dans Dynamic Media Cloud Services.
  4. Répliquez les paramètres de la visionneuse.
  5. Configurez le filtre actif pour la vidéo uniquement.
  6. Livrez les ressources.
Livraison À LA FOIS des images et de la vidéo en production

Les vidéos sont livrées et mises en cache par un réseau de diffusion de contenu pour des performances extensibles et une portée globale. Les images et les images d’affiches de vidéos sont livrées par les serveurs des data centers Adobe du monde entier, puis mises en cache par un réseau de diffusion de contenu pour une portée internationale et des performances évolutives.

Reportez-vous aux sections précédentes pour configurer les images ou les vidéos en préproduction.

  1. Sur le nœud auteur d’AEM, activez Dynamic Media.
  2. Configurez la vidéo dans Dynamic Media Cloud Services.
  3. Configurez l’imagerie dans Dynamic Media Cloud Services.
  4. Configurez la réplication de l’image.
  5. Répliquez les paramètres du catalogue.
  6. Répliquez les paramètres de la visionneuse.
  7. Utilisez les filtres de ressource par défaut pour la réplication.
  8. Configurez les paramètres du serveur d’images Dynamic Media.
  9. Livrez les ressources.

Activation de Dynamic Media

Dynamic Media est désactivé par défaut. Pour tirer parti des fonctionnalités de Dynamic Media, vous devez activer Dynamic Media en utilisant le mode d’exécution dynamicmedia comme vous le feriez par exemple pour le mode d’exécution publish . Avant l’activation, vérifiez les exigences techniques.

REMARQUE

L’activation de Dynamic Media via le mode d’exécution remplace la fonctionnalité dans AEM 6.1 et AEM 6.0 qui consistait à définir l’indicateur dynamicMediaEnabled sur true. Cet indicateur ne correspond à aucune fonctionnalité dans AEM 6.2 et versions ultérieures. Par ailleurs, vous n’avez pas besoin de redémarrer le démarrage rapide pour activer Dynamic Media.

En activant Dynamic Media, les fonctionnalités de média dynamique sont disponibles dans l’interface utilisateur et chaque ressource d’image chargée reçoit un rendu cqdam.pyramid.tiff utilisé pour la diffusion rapide des rendus d’image dynamique. Ces fichiers PTIFF présentent des avantages significatifs, notamment (1) la possibilité de gérer une seule image maître et de générer des rendus infinis à la volée sans stockage supplémentaire et (2) la possibilité d’utiliser la visualisation interactive telle que le zoom, le panoramique, la rotation, etc.

Si vous souhaitez utiliser Dynamic Media Classic dans AEM, vous ne devez pas activer Dynamic Media, sauf si vous utilisez un scénario spécifique. Dynamic Media est désactivé, sauf si vous activez Dynamic Media en mode d’exécution.

Pour activer Dynamic Media, vous devez activer le mode d’exécution Dynamic Media, soit depuis la ligne de commande, soit en modifiant le nom de fichier de démarrage rapide.

Pour activer Dynamic Media :

  1. Dans la ligne de commande, lorsque vous lancez le démarrage rapide, procédez de la façon suivante :

    • Ajoutez -r dynamicmedia à la fin de la ligne de commande lors du démarrage du fichier jar.
    java -Xmx4096m -Doak.queryLimitInMemory=500000 -Doak.queryLimitReads=500000 -jar cq-quickstart-6.4.0.jar -r dynamicmedia
    

    Si vous publiez sur s7delivery, vous devez également inclure les arguments trustStore suivants :

    -Djavax.net.ssl.trustStore=<absoluteFilePath>/customerTrustStoreFileName>
    
     -Djavax.net.ssl.trustStorePassword=<passwordForTrustStoreFile>
    
  2. Demandez http://localhost:4502/is/image et assurez-vous que le serveur d’images est en cours d’exécution.

    REMARQUE

    Pour résoudre les problèmes liés à Dynamic Media, consultez les journaux suivants dans le répertoire crx-quickstart/logs/ :

    • ImageServer-<PortId>-<yyy><mm><dd>.log - Le journal ImageServer fournit des statistiques et des informations d’analyse utilisées pour analyser le comportement du processus ImageServer interne.

    Exemple de nom de fichier journal du serveur d’images : ImageServer-57346-2019-07-25.log

    • s7access-<yyy><mm><dd>.log - Le journal s7access enregistre chaque demande envoyée à Dynamic Media par /is/image et /is/content.

    Ces journaux sont utilisés uniquement lorsque Dynamic Media est activé. Ils ne sont pas inclus dans le package Télécharger complet généré à partir de la page system/console/status-Bundlelist ; lorsque vous appelez le service clientèle si vous rencontrez un problème Dynamic Media, ajoutez ces deux journaux au problème.

Si vous avez installé AEM sur un port ou un chemin d’accès au contexte différent…

Si vous déployez AEM sur un serveur d’applications et que Dynamic Media est activé, vous devez configurer le domaine self dans l’externaliseur. Dans le cas contraire, la fonctionnalité de génération de miniature pour les ressources ne fonctionnera pas correctement pour les ressources de média dynamique.

En outre, si vous exécutez le démarrage rapide sur un port ou un chemin d’accès au contexte différent, vous devez également changer le domaine self.

Lorsque Dynamic Media est activé, les rendus de miniature statiques pour les ressources images sont générés à l’aide de Dynamic Media. Pour que la génération de miniature fonctionne correctement pour le contenu multimédia dynamique, AEM doit s’envoyer une requête d’URL et doit connaître à la fois le numéro de port et le chemin d’accès au contexte.

Dans AEM :

  • Le domaine self du service Externalizer est utilisé pour récupérer à la fois le numéro de port et le chemin d’accès au contexte.
  • Si aucun domaine self n’est configuré, le numéro de port et le chemin d’accès au contexte sont récupérés à partir du service HTTP Jetty.

Dans un déploiement WAR QuickStart AEM, le numéro de port et le chemin d’accès au contexte ne peuvent pas être dérivés. Vous devez donc configurer un domaine self. Reportez-vous à la section de la documentation sur le service Externalizer relative à la configuration du domaine self.

REMARQUE

Dans un déploiement autonome Quickstart AEM, un domaine self n’a généralement pas besoin d’être configuré, car le numéro de port et le chemin d’accès au contexte peuvent s’autoconfigurer. Si toutefois toutes les interfaces réseau sont désactivées, vous devez configurer le domaine self.

Désactivation de Dynamic Media

Dynamic Media est désactivé par défaut. Toutefois, si vous l’avez activé, vous voudrez peut-être le désactiver.

Pour désactiver Dynamic Media après l’avoir activé, supprimez l’indicateur du mode d’exécution -r dynamicmedia .

Pour désactiver Dynamic Media après son activation :

  1. Dans la ligne de commande, lorsque vous lancez le démarrage rapide, vous pouvez procéder de l’une des façons suivantes :

    • N’ajoutez pas -r dynamicmedia à la ligne de commande lors du démarrage du fichier JAR.
    java -Xmx4096m -Doak.queryLimitInMemory=500000 -Doak.queryLimitReads=500000 -jar cq-quickstart-6.4.0.jar
    
  2. Requête http://localhost:4502/is/image. Vous recevez un message indiquant que Dynamic Media est désactivé.

    REMARQUE

    Une fois le mode d’exécution Dynamic Media désactivé, l’étape de workflow qui génère le rendu qdam.pyramid.tiff est automatiquement ignorée. La prise en charge du rendu dynamique est également désactivée, ainsi que d’autres fonctionnalités Dynamic Media.
    Notez également que lorsque le mode d’exécution Dynamic Media est désactivé après configuration du serveur AEM, tous les actifs qui ont été téléchargés sous ce mode d’exécution son alors invalides.

(Facultatif) Migration des paramètres prédéfinis et des configurations Dynamic Media de 6.3 à 6.4 sans interruption

Si vous effectuez une mise à niveau AEM Dynamic Media de la version 6.3 vers la version 6.4, qui inclut désormais la possibilité de réaliser des déploiements sans interruption (également appelés "Opt-in"), vous devez exécuter la commande curl suivante pour migrer tous vos paramètres prédéfinis et configurations de /etc vers /conf en CRXDE Lite.

Remarque : Si vous exécutez votre instance AEM en mode de compatibilité (c’est-à-dire que le package de compatibilité est installé), il n’est pas nécessaire d’exécuter ces commandes.

Pour migrer vos paramètres prédéfinis et configurations personnalisés de /etc vers /conf, exécutez la commande curl Linux suivante :

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

Pour toutes les mises à niveau, avec ou sans le module de compatibilité, vous pouvez copier les paramètres prédéfinis de la visionneuse prête à l’emploi en exécutant la commande suivante :

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

Configuration de la réplication d’images

La diffusion d’images Dynamic Media fonctionne en publiant des ressources d’image, y compris des miniatures vidéo, à partir de l’auteur AEM et en les répliquant vers le service de réplication à la demande de l’Adobe (l’URL du service de réplication). Les ressources sont ensuite diffusées via le service de diffusion d’images à la demande (URL du service d’images).

Procédez de la façon suivante :

  1. Définissez une authentification.
  2. Configurez l’agent de réplication.

L’agent de réplication publie des ressources Dynamic Media telles que des images, des métadonnées vidéo et des visionneuses sur le service d’images hébergé par Adobe. L’agent de réplication n’est pas activé par défaut.

Après avoir configuré l’agent de réplication, vous devez valider et tester que la configuration a bien été effectuée. La section suivante décrit ces procédures.

REMARQUE

La limite par défaut de la mémoire pour la création de fichiers PTIFF est de 3 Go pour tous les workflow. Par exemple, vous pouvez traiter une image qui nécessite 3 Go de mémoire si les autres workflow sont en pause, ou vous pouvez traiter 10 images en parallèle qui nécessitent chacune 300 Mo de mémoire.
La limite de la mémoire peut être configurée et doit s’adapter en fonction de la disponibilité des ressources du système et du type de contenu d’image traité. Si vous avez plusieurs ressources très volumineuses et que vous avez suffisamment de mémoire dans le système, vous pouvez augmenter cette limite pour être certain de pouvoir traiter les images en parallèle.
Une image nécessitant plus de mémoire que la limite maximale prévue sera rejetée.
Pour modifier la limite de mémoire pour la création d’images PTIFF, accédez à Outils > Opérations > Console web > Adobe CQ Scene7 PTiffManager et modifiez la valeur maxMemory.

Configuration de l’authentification

Vous devez configurer l’authentification de la réplication sur l’auteur afin de pouvoir répliquer les images vers le service de diffusion d’images Dynamic Media. Pour ce faire, vous devez obtenir un KeyStore, puis l’enregistrer sous l’utilisateur dynamic-media-replication et le configurer. L’administrateur de votre société doit avoir reçu un courriel de bienvenue contenant le fichier KeyStore et les informations d’identification nécessaires au cours du processus de provisionnement. Si vous ne l’avez pas reçu, contactez le service clientèle.

Pour configurer l’authentification :

  1. Contactez le service clientèle pour obtenir votre fichier KeyStore et votre mot de passe si vous ne possédez pas déjà ce fichier. Cela fait partie du provisionnement et vous permettra d’associer les clés à votre compte.

  2. Dans AEM, appuyez sur le logo AEM pour accéder à la console de navigation globale, puis appuyez sur Outils > Sécurité > Utilisateurs.

  3. Sur la page Gestion des utilisateurs, accédez à l’utilisateur dynamic-media-replication, puis appuyez pour ouvrir.

    dm-replication

  4. Dans la page Modifier les paramètres utilisateur pour la réplication Dynamic Media, appuyez sur l’onglet Keystore, puis sur Créer KeyStore.

    dm-replication-keystore

  5. Saisissez un mot de passe, puis confirmez-le dans la boîte de dialogue Définir le mot de passe d’accès KeyStore.

    REMARQUE

    Veillez à ne pas oublier le mot de passe saisi. Vous devrez le saisir à nouveau lorsque vous configurerez ultérieurement l’agent de réplication.

    chlimage_1-508

  6. Sur la page Modifier les paramètres utilisateurs pour la réplication Dynamic Media, développer l’espace Ajouter une clé privée depuis le fichier KeyStore et ajoutez les éléments suivants (voir image suivante) :

    • Dans le champ Nouvel alias , saisissez le nom d’un alias que vous utiliserez ultérieurement dans la configuration de réplication. par exemple, réplication.
    • Appuyez sur KeyStore File. Accédez au fichier KeyStore fourni par Adobe, sélectionnez-le puis appuyez sur Ouvrir.
    • Dans le champ Mot de passe du fichier KeyStore, saisissez le mot de passe du fichier KeyStore. Il s’agit non du mot de passe KeyStore que vous avez créé à l’étape 5, mais de l’Adobe du mot de passe du fichier KeyStore fourni dans le courriel de bienvenue qui vous a été envoyé lors de la mise en service. Contactez le service clientèle d’Adobe si vous n’avez pas reçu de mot de passe de fichier KeyStore.
    • Dans le champ Mot de passe de la clé privée, entrez le mot de passe de la clé privée (ce peut être le même mot de passe de clé privée que celui fourni à l’étape précédente). Adobe vous fournit ce mot de passe de clé privée dans le courriel de bienvenue qui vous est envoyé pendant le provisionnement. Contactez le service clientèle d’Adobe si vous n’avez pas reçu de mot de passe de clé privée.
    • Dans le champ Alias de la clé privée, saisissez l’alias de la clé privée. Par exemple, companyname-alias. Adobe vous fournit cet alias de clé privée dans le courriel de bienvenue qui vous est envoyé pendant le provisionnement. Contactez le service clientèle d’Adobe si vous n’avez pas reçu d’alias de clé privée.

    edit_settings_fordynamic-media-replication2

  7. Appuyez sur Enregistrer et fermer pour enregistrer vos modifications pour cet utilisateur.

    Vous devez ensuite configurer l’agent de réplication.

Configuration de l’agent de réplication

  1. Dans AEM, appuyez sur le logo AEM pour accéder à la console de navigation globale, puis appuyez sur Outils > Déploiement > Réplication > Agents sur l’auteur.

  2. Dans la page Agents sur l’auteur, appuyez ou cliquez sur Réplication des images hybrides Dynamic Media (s7delivery).

  3. Appuyez sur Modifier.

  4. Appuyez sur l’onglet Paramètres, puis saisissez ce qui suit :

    • Activé: cochez cette option pour activer l’agent de réplication.
    • Région : définissez sur la région appropriée : Amérique du Nord, Europe ou Asie
    • ID de tenant : cette valeur est le nom de votre société/client qui publie sur le service de réplication. Cette valeur correspond à l’identifiant du tenant fourni par Adobe dans le courriel de bienvenue qui vous a été envoyé lors de la mise en service. Si vous ne l’avez pas reçu, contactez le service clientèle d’Adobe.
    • Alias du magasin de clés : cette valeur est identique à la valeur Nouvel alias définie lors de la génération de la clé dans Configuration de l’authentification ; par exemple, replication. (Voir l’étape 7 de Configuration de l’authentification.)
    • Mot de passe du magasin de clés : il s’agit du mot de passe du KeyStore qui a été créé lorsque vous avez appuyé sur Créer le KeyStore. Adobe ne fournit pas ce mot de passe. Voir l’étape 5 de Configuration de l’authentification.

    L’image suivante montre l’agent de réplication avec des exemples de données :

    chlimage_1-509

  5. Appuyez sur OK.

Validation de l’agent de réplication pour Dynamic Media

Pour valider l’agent de réplication pour Dynamic Media, procédez comme suit :

Appuyez sur Tester la connexion. Voici un exemple de résultat :

11.03.2016 10:57:55 - Transferring content for ReplicationAction{type=TEST, path[0]='/content/dam', time=1457722675402, userId='admin', revision='null'}
11.03.2016 10:57:55 - * Auth User: replication-receiver
11.03.2016 10:57:55 - * HTTP Version: 1.1
11.03.2016 10:57:55 - * Using OAuth 2.0 Authorization Grants
11.03.2016 10:57:55 - * OAuth 2.0 User: dynamic-media-replication
11.03.2016 10:57:55 - * OAuth 2.0 Token: '*****' initialized
11.03.2016 10:57:55 - Publishing: POST[https://replicate-na.assetsadobe.com:8580/is-publish/publish-receiver?Cmd=Test&RootId=xfpuu-6613]
11.03.2016 10:57:55 - Publish response: OK[]
11.03.2016 10:57:55 - Transfer succeeded in 141 ms for ReplicationAction{type=TEST, path[0]='/content/dam', time=1457722675402, userId='admin', revision='null'}
-------------------------------------------------------------------------------------------------------------------------------
Replication test succeeded
REMARQUE

Vous pouvez aussi procéder de l’une des manières suivantes :

  • Vérifiez les journaux de réplication pour vous assurer que la ressource a été répliquée.
  • Publiez une image. Appuyez sur l’image et sélectionnez Visionneuses dans le menu déroulant. Sélectionnez un paramètre prédéfini de visionneuse, puis appuyez sur URL et copiez et collez l’URL dans le navigateur pour vérifier que vous pouvez voir l’image.

Résolution des problèmes d’authentification

Lors de la configuration de l’authentification, voici certains problèmes que vous pourriez rencontrer, ainsi que leurs solutions. Avant de commencer, vérifiez que vous avez configuré la réplication.

Problème : Code d’état HTTP 401 avec message - Autorisation requise

Ce problème peut être dû à l’échec de la configuration du KeyStore pour l’utilisateur dynamic-media-replication.

Replication test to s7delivery:https://s7bern.macromedia.com:8580/is-publish/
17.06.2016 18:54:43 - Transferring content for ReplicationAction{type=TEST, path[0]='/content/dam', time=1466214883309, userId='admin', revision='null'}
17.06.2016 18:54:43 - * Auth User: replication-receiver
17.06.2016 18:54:43 - * HTTP Version: 1.1
17.06.2016 18:54:43 - * Using OAuth 2.0 Authorization Grants
17.06.2016 18:54:43 - * OAuth 2.0 User: dynamic-media-replication
17.06.2016 18:54:43 - No OAuth token available. OAuth not initialized
17.06.2016 18:54:43 - * Using Client Auth SSL alias - replication-alias *
17.06.2016 18:54:43 - Publishing: POST[https://<localhost>:8580/is-publish//publish-receiver?Cmd=Test&RootId=brough]
17.06.2016 18:54:43 - Transfer failed for ReplicationAction{type=TEST, path[0]='/content/dam', time=1466214883309, userId='admin', revision='null'}. java.io.IOException: Failed to execute request
'https://<localhost>:8580/is-publish//publish-receiver?Cmd=Test&RootId=brough':
 Server returned status code 401 with message: Authorization required.
17.06.2016 18:54:43 - Error while replicating: com.day.cq.replication.ReplicationException: Transfer failed for ReplicationAction{type=TEST, path[0]='/content/dam', time=1466214883309,
 userId='admin', revision='null'}. java.io.IOException: Failed to execute request
'https://<localhost>:8580/is-publish//publish-receiver?Cmd=Test&RootId=brough':
 Server returned status code 401 with message: Authorization required.

Solution : Vérifiez que le KeyStore est enregistré dans dynamic-media- replicationuser et qu’il contient le mot de passe correct.

Problème : Impossible de déchiffrer la clé - Impossible de déchiffrer les données

Replication test to s7delivery:https://<localhost>:8580/is-publish/
17.06.2016 19:00:16 - Transferring content for ReplicationAction{type=TEST, path[0]='/content/dam', time=1466215216662, userId='admin', revision='null'}
17.06.2016 19:00:16 - * Auth User: replication-receiver
17.06.2016 19:00:16 - * HTTP Version: 1.1
17.06.2016 19:00:16 - * Using OAuth 2.0 Authorization Grants
17.06.2016 19:00:16 - * OAuth 2.0 User: dynamic-media-replication
17.06.2016 19:00:16 - No OAuth token available. OAuth not initialized
17.06.2016 19:00:16 - * Using Client Auth SSL alias - replication-alias *
17.06.2016 19:00:16 - Transfer failed for ReplicationAction{type=TEST, path[0]='/content/dam', time=1466215216662, userId='admin', revision='null'}. java.lang.SecurityException: java.security.UnrecoverableKeyException: Could not decrypt key: Could not decrypt data.

Solution : vérifiez le mot de passe. Le mot de passe enregistré dans l’agent de réplication n’est pas le même mot de passe que celui utilisé pour créer le KeyStore.

Problème : InvalidAlgorithmParameterException

Ce problème est causé par une erreur de configuration dans votre instance Auteur AEM. Le javax.net.ssl.trustStore obtenu par le processus java sur l’auteur n’est pas correct. L’erreur est visible dans le journal de réplication :

14.04.2016 09:37:43 - Transfer failed for ReplicationAction{type=TEST, path[0]='/content/dam', time=1460651862089, userId='admin', revision='null'}. java.io.IOException: Failed to execute request 'https://<localhost>:8580/is-publish/publish-receiver?Cmd=Test&RootId=rbrough-osx2': java.lang.RuntimeException: Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty
14.04.2016 09:37:43 - Error while replicating: com.day.cq.replication.ReplicationException: Transfer failed for ReplicationAction{type=TEST, path[0]='/content/dam', time=1460651862089, userId='admin', revision='null'}. java.io.IOException: Failed to execute request 'https://<localhost>:8580/is-publish/publish-receiver?Cmd=Test&RootId=rbrough-osx2': java.lang.RuntimeException: Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty

Ou dans le journal des erreurs :

07.25.2019 12:00:59.893 *ERROR* [sling-threadpool-db2763bb-bc50-4bb5-bb64-10a09f432712-(apache-sling-job-thread-pool)-90-com_day_cq_replication_job_s7delivery(com/day/cq/replication/job/s7delivery)] com.day.cq.replication.Agent.s7delivery.queue Error during processing of replication.
 
java.io.IOException: Failed to execute request 'https://replicate-na.assetsadobe.com:8580/is-publish/publish-receiver?Cmd=Test&RootId=rbrough-osx': java.lang.RuntimeException: Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty
        at com.scene7.is.catalog.service.publish.atomic.PublishingServiceHttp.executePost(PublishingServiceHttp.scala:195)

Solution : Assurez-vous que la propriété système -Djavax.net.ssl.trustStore= du processus Java sur l’auteur AEM est définie sur un TrustStore valide.

Problème : Le KeyStore n’est pas configuré ou n’a pas été initialisé

Ce problème peut être dû à un correctif ou à un pack de fonctionnalités qui remplace le noeud dynamic-media-user ou keystore.

Exemple de journal de réplication :

Replication test to s7delivery:https://replicate-na.assetsadobe.com/is-publish
02.08.2016 14:37:44 - Transferring content for ReplicationAction{type=TEST, path[0]='/content/dam', time=1470173864834, userId='admin', revision='null'}
02.08.2016 14:37:44 - * Auth User: replication-receiver
02.08.2016 14:37:44 - * HTTP Version: 1.1
02.08.2016 14:37:44 - * Using OAuth 2.0 Authorization Grants
02.08.2016 14:37:44 - * OAuth 2.0 User: dynamic-media-replication
02.08.2016 14:37:44 - Transfer failed for ReplicationAction{type=TEST, path[0]='/content/dam', time=1470173864834, userId='admin', revision='null'}. com.adobe.granite.keystore.KeyStoreNotInitialisedException: Uninitialised key store for user dynamic-media-replication

Solution :

  1. Accédez à la page Gestion utilisateur :

    localhost:4502/libs/granite/security/content/useradmin.html

  2. Sur la page Gestion utilisateur, accédez à l’utilisateur dynamic-media-replication, puis appuyez pour ouvrir.

  3. Appuyez sur l’onglet KeyStore . Si le bouton Créer KeyStore apparaît, il vous faut alors répéter les étapes décrites précédemment sous Configuration de l’authentification.

  4. Si vous deviez rétablir la configuration de KeyStore, vous devrez peut-être également effectuer la configuration de l’agent de réplication.

    Reconfigurez l’agent de réplication s7delivery.

    localhost:4502/etc/replication/agents.author/s7delivery.html

  5. Appuyez sur Tester la connexion pour vous assurer que la configuration est valide.

Problème : L’agent de publication utilise SSL à la place d’OAuth

Le problème peut être dû à un correctif ou à un Feature Pack qui ne s’est pas installé correctement ou qui a écrasé les paramètres.

Exemple de journal de réplication :

01.08.2016 18:42:59 - Transferring content for ReplicationAction{type=TEST, path[0]='/content/dam', time=1470073379634, userId='admin', revision='null'}
01.08.2016 18:42:59 - * Auth User: replication-receiver
01.08.2016 18:42:59 - * HTTP Version: 1.1
01.08.2016 18:42:59 - * Using Client Auth SSL alias - replication-receiver *
01.08.2016 18:42:59 - Publishing: POST[https://replicate-eu.assetsadobe2.com:443/is-publish/publish-receiver?Cmd=Test&RootId=altayerstaging]
01.08.2016 18:42:59 - Transfer failed for ReplicationAction{type=TEST, path[0]='/content/dam', time=1470073379634, userId='admin', revision='null'}. java.io.IOException: Failed to execute request 'https://replicate-eu.assetsadobe2.com:443/is-publish/publish-receiver?Cmd=Test&RootId=rbroughstaging': Server returned status code 401 with message: Authorization required.
01.08.2016 18:42:59 - Error while replicating: com.day.cq.replication.ReplicationException: Transfer failed for ReplicationAction{type=TEST, path[0]='/content/dam', time=1470073379634, userId='admin', revision='null'}. java.io.IOException: Failed to execute request 'https://replicate-eu.assetsadobe2.com:443/is-publish/publish-receiver?Cmd=Test&RootId=rbroughstaging': Server returned status code 401 with message: Authorization required.

Solution:

  1. Dans AEM, appuyez sur Outils > Général > CRXDE Lite.

    localhost:4502/crx/de/index.jsp

  2. Accédez au noeud s7delivery Replication Agent .

    localhost:4502/crx/de/index.jsp#/etc/replication/agents.author/s7delivery/jcr:content

  3. Ajoutez ce paramètre à l’agent de réplication (Booléen avec la valeur True) :

    enableOauth=true

  4. Dans le coin supérieur gauche de la page, appuyez sur Enregistrer tout.

Test de votre configuration

Adobe vous recommande d’effectuer un test complet de la configuration :

Assurez-vous d’avoir déjà effectué les étapes suivantes avant de commencer ce test :

  • Ajouter les paramètres d’image prédéfinis.
  • Configurez la configuration Dynamic Media (version antérieure à 6.3)sous Services cloud. L’URL du service d’images est obligatoire pour ce test

Pour tester votre configuration :

  1. Téléchargez une ressource image. (Dans Assets, appuyez sur Créer > Fichiers et sélectionnez le fichier.)

  2. Patientez jusqu’à la fin du workflow.

  3. Publiez la ressource image. (Sélectionnez la ressource et appuyez sur Publication rapide.)

  4. Accédez aux rendus de cette image en ouvrant l’image, puis appuyez sur Rendus.

    chlimage_1-510

  5. Sélectionnez n’importe quel rendu dynamique.

  6. Appuyez sur URL pour obtenir l’URL de cette ressource.

  7. Naviguez vers l’URL sélectionnée et vérifiez si l’image se comporte comme prévu.

Une autre façon de vérifier que vos ressources ont bien été diffusées est d’ajouter req=exists à votre URL.

Configuration de Dynamic Media Cloud Services

Dynamic Media Cloud Services fournit la prise en charge des services cloud comme la publication hybride et la diffusion d’images et de vidéos, d’analyses vidéo, d’encodage vidéo, etc.

Lors de la configuration, vous devez entrer un ID d’enregistrement, l’URL du service vidéo, l’URL du service d’images, l’URL du service de réplication et configurer l’authentification. Vous devez avoir reçu toutes ces informations dans le cadre du processus de configuration du compte. Si vous n’avez pas reçu ces informations, contactez votre administrateur Adobe Experience Manager ou votre support technique d’Adobe pour obtenir ces informations.

REMARQUE

Avant de configurer des Cloud Services Dynamic Media, assurez-vous que votre instance de publication est configurée. Vous devez également configurer la réplication avant de configurer les Cloud Services Dynamic Media.

Pour configurer les services cloud Dynamic Media :

  1. Dans AEM, appuyez sur le logo AEM pour accéder à la console de navigation globale, puis appuyez sur Outils > Cloud Services > Configuration Dynamic Media (Pre-6.3).

  2. Sur la page Navigateur de configuration de Dynamic Media, dans le volet de gauche, sélectionnez global, puis appuyez sur Créer.

  3. Dans la boîte de dialogue Configuration de Dynamic Media, dans le champ Titre, tapez un titre.

  4. Si vous configurez Dynamic Media pour la vidéo,

    • dans le champ ID d’enregistrement, entrez votre ID d’enregistrement.
    • Dans le champ URL du service vidéo, entrez l’URL du service vidéo pour la passerelle Dynamic Media.
  5. Si vous configurez Dynamic Media pour les images, dans le champ URL du service d’images, saisissez l’URL du service d’images pour la passerelle Dynamic Media.

  6. Appuyez sur Enregistrer pour revenir à la page Navigateur de configuration Dynamic Media.

  7. Appuyez sur le logo AEM pour accéder à la console de navigation globale.

Configuration des rapports vidéo

Vous pouvez configurer les rapports vidéo pour plusieurs installations d’AEM à l’aide du mode hybride de Dynamic Media.

Quand utiliser : au moment de la configuration de Dynamic Media (version antérieure à 6.3), de nombreuses fonctionnalités sont lancées, notamment les rapports vidéo. La configuration crée une suite de rapports dans une entreprise Analytics régionale. Si vous configurez plusieurs nœuds Auteur, vous créez une suite de rapport séparée pour chacun. Par conséquent, les données de rapport sont incohérentes entre les installations. En outre, si chaque nœud Auteur se réfère au même serveur Hybrid Publish, la dernière installation Auteur modifie la suite de rapports de destination pour tous les rapports vidéo. Le problème surcharge le système d’analyses avec de trop nombreuses suites de rapports.

Commencer : configurez les rapports vidéo en effectuant les trois tâches suivantes.

  1. Créez un Video Analytics module prédéfini après avoir configuré la configuration de Dynamic Media (version antérieure à 6.3) sur le premier noeud Auteur. Cette première tâche est importante car elle permet à une nouvelle configuration de continuer à utiliser la même suite de rapports.

  2. Installez le module Video Analytics prédéfini sur tout nouveau noeud d’auteur avant de configurer la configuration de Dynamic Media (version antérieure à 6.3).

  3. Vérifiez et déboguez l’installation du module.

Création d’un package de paramètres prédéfinis Video Analytics après la configuration du premier noeud Auteur

Une fois cette tâche terminée, vous disposez d’un fichier de module contenant les paramètres prédéfinis Video Analytics. Ces paramètres prédéfinis comportent une suite de rapports, le serveur de suivi, les espaces de nom de suivi et l’ID d’organisation Marketing Cloud, le cas échéant.

  1. Si vous ne l’avez pas déjà fait, configurez la configuration de Dynamic Media (version antérieure à 6.3).

  2. (Facultatif) Affichez et copiez l’identifiant de suite de rapports (vous devez avoir accès au JCR). Bien que l’identifiant de suite de rapports ne soit pas obligatoire, la validation est plus facile.

  3. Créez un package à l’aide de Package Manager.

  4. Modifiez le module pour inclure un filtre.

    Dans AEM: /conf/global/settings/dam/dm/presets/analytics/jcr:content/userdata

  5. Créez le module.

  6. Téléchargez ou partagez le module Video Analytics prédéfini afin qu’il puisse être partagé avec les nouveaux noeuds d’auteur suivants.

Installation du package de paramètres prédéfinis Video Analytics avant de configurer des noeuds d’auteur supplémentaires

Assurez-vous d’avoir effectué cette tâche avantde configurer Configuration Dynamic Media (version antérieure à 6.3). Sinon, une autre suite de rapports inutilisée est créée. En outre, même si les rapports vidéo continueront à fonctionner correctement, la collecte des données n’est pas optimisée.

Assurez-vous que le module Video Analytics prédéfini du premier noeud Auteur est accessible sur le nouveau noeud Auteur.

  1. Téléchargez le module de paramètre prédéfini Video Analytics que vous avez créé précédemment dans Package Manager.
  2. Installez le module Video Analytics prédéfini.
  3. Configuration de Dynamic Media (version antérieure à 6.3).

Vérification et débogage de l’installation du module

  1. Effectuez l’une des actions suivantes et, si nécessaire, déboguez l’installation du module :

    • Vérifiez le Video Analytics paramètre prédéfini au moyen du
      JCRTpour vérifier le Video Analytics paramètre prédéfini au moyen du JCR. Vous devez avoir accès au CRXDE Lite.

      AEM - Dans CRXDE Lite, accédez à /conf/global/settings/dam/dm/presets/analytics/jcr:content/userdata

      C’est http://localhost:4502/crx/de/index.jsp#/conf/global/settings/dam/dm/presets/analytics/jcr%3Acontent/userdata

      Si vous n’avez pas accès à CRXDE Lite sur le noeud Auteur, vous pouvez vérifier le paramètre prédéfini via le serveur de publication.

    • Vérification du Video Analytics paramètre prédéfini via le serveur d’images

      Vous pouvez valider le paramètre prédéfini Video Analytics directement en effectuant une requête de serveur d’images req=userdata.

      Par exemple, pour afficher le paramètre prédéfini Video Analytics sur le noeud Auteur, vous pouvez effectuer la requête suivante :

      http://localhost:4502/is/image/conf/global/settings/dam/dm/presets/analytics?req=userdata

      Pour valider le paramètre prédéfini sur les serveurs de publication, vous pouvez adresser une requête directe similaire au serveur de publication. La réponse est la même sur les nœuds d’auteur et de publication. La réponse ressemble à ce qui suit :

      marketingCloudOrgId=0FC4E86B573F99CC7F000101
       reportSuite=aemaem6397618-2018-05-23
       trackingNamespace=aemvideodal
       trackingServer=aemvideodal.d2.sc.omtrdc.net
      
    • Vérifiez le Video Analytics paramètre prédéfini à l’aide de l’outil de création de rapports vidéo dans AEM

      Appuyez sur Outils > Ressources > Rapports vidéo http://localhost:4502/mnt/overlay/dam/gui/content/s7dam/videoreports/videoreport.html

      Si le message d’erreur suivant s’affiche, la suite de rapports est disponible, mais non renseignée. Cette erreur est correcte -et voulue- dans une nouvelle installation, avant que le système ne collecte des données.

      screen_shot_2018-05-23at52254pm
      Pour générer des données de rapport, téléchargez et publiez une vidéo. Utilisez Copier l’URL et exécutez la vidéo au moins une fois.

    Gardez à l’esprit que cela peut prendre jusqu’à 12 h pour que les données de rapport soient remplies depuis l’utilisation de la visionneuse vidéo.

    Si une erreur survient et que la suite de rapports n’est pas configurée correctement, l’avertissement suivant s’affiche.

    screen_shot_2018-05-23at52612pm

    Cette erreur s’affiche également si la création de rapports vidéo est exécutée avant de configurer les services Configuration Dynamic Media (version antérieure à 6.3).

Dépannage de la configuration de rapport vidéo

  • Pendant l’installation, les connexions au serveur API Analytics expirent. L’installation effectue 20 nouvelles tentatives de connexion, mais elles échouent. Dans ce cas, le fichier journal enregistre plusieurs erreurs. Recherchez SiteCatalystReportService.
  • Si vous n’installez pas d’abord le module Video Analytics prédéfini, il se peut qu’une nouvelle suite de rapports soit créée.
  • La mise à niveau d’AEM 6.3 vers AEM 6.4 ou 6.4.1, puis la configuration de Configuration de Dynamic Media (version antérieure à 6.3), crée toujours une suite de rapports. Ce problème est connu et sa réparation est prévue pour AEM 6.4.2.

À propos du paramètre prédéfini Video Analytics

Le paramètre prédéfini Video Analytics, parfois appelé simplement paramètre prédéfini d’analyse, est stocké en regard des paramètres prédéfinis de la visionneuse dans Dynamic Media. Il s’agit presque de la même chose que les paramètres prédéfinis de la visionneuse mais avec des informations utilisées pour configurer les rapports AppMeasurement et Video Heartbeat.

Les propriétés des paramètres prédéfinis sont les suivantes :

  • reportSuite
  • trackingServer
  • trackingNamespace
  • marketingCloudOrgId (non présent dans les anciennes versions AEM)

AEM 6.4 et les versions plus récentes enregistrent ce paramètre prédéfini à /conf/global/settings/dam/dm/presets/analytics/jcr:content/userdata

Réplication des paramètres de catalogue

Vous devez publier vos propres paramètres de catalogue par défaut lors du processus de configuration via le JCR. Pour répliquer les paramètres de catalogue :

  1. Dans la fenêtre de terminal, exécutez les opérations suivantes :

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

  2. Dans AEM, accédez à l’emplacement suivant dans CRXDE Lite (nécessite des privilèges d’administrateur) :

    https://<server>:<port>/crx/de/index.jsp#/conf/global/settings/dam/dm/imageserver/

  3. Appuyez sur l’onglet Réplication.

  4. Appuyez sur Répliquer.

Réplication des paramètres prédéfinis de la visionneuse

Pour diffuser une ressource avec un paramètre prédéfini de visionneuse, vous devez répliquer/publier le paramètre prédéfini de visionneuse. (Tous les paramètres prédéfinis de visionneuse doivent être activés et répliqués pour obtenir l’URL ou le code intégré d’une ressource.) Reportez-vous à la section Publication des paramètres prédéfinis de la visionneuse pour plus d’informations.

REMARQUE

Par défaut, le système affiche divers rendus lorsque vous sélectionnez Rendus et divers paramètres prédéfinis de visionneuse lorsque vous sélectionnez Visionneuses dans la vue détaillée de la ressource. Vous pouvez augmenter ou diminuer le nombre indiqué. Voir Augmentation du nombre de paramètres d’image prédéfinis qui s’affichent ou Augmentation du nombre de paramètres de visionneuse prédéfinis qui s’affichent.

Filtrage des ressources pour la réplication

Dans les déploiements autres que Dynamic Media, vous répliquez toutes les ressources (images et vidéo) de votre environnement de création AEM au noeud de publication AEM. Ce workflow est nécessaire, car les serveurs de publication AEM diffusent également les ressources.

Toutefois, dans les déploiements Dynamic Media, dans la mesure où les ressources sont diffusées par le biais du cloud, il n’est pas nécessaire de répliquer ces mêmes ressources sur AEM noeuds de publication. Un tel workflow de "publication hybride" évite des coûts de stockage supplémentaires et des temps de traitement plus longs pour répliquer les ressources. D’autres contenus, comme les visionneuses Dynamic Media, les pages de site et le contenu statique, restent diffusés depuis les nœuds de publication AEM.

Outre la réplication des ressources, les autres ressources suivantes sont également répliquées :

  • Configuration de diffusion Dynamic Media : /conf/global/settings/dam/dm/imageserver/configuration/jcr:content/settings
  • Paramètres d’image prédéfinis: /conf/global/settings/dam/dm/presets/macros
  • Paramètres prédéfinis de la visionneuse: /conf/global/settings/dam/dm/presets/viewer

Les filtres vous permettent d’empêcher que les ressources ne soient répliquées vers le nœud de publication AEM.

Utilisation des filtres de ressources par défaut pour la réplication

Si vous utilisez Dynamic Media pour 1) l’imagerie en production ou 2) l’imagerie et la vidéo, vous pouvez utiliser les filtres par défaut que nous fournissons en l’état. Les filtres suivants sont activés par défaut :

Filtrer Type de MIME Rendus
Diffusion d’images Dynamic Media

filter-images

filter-sets

Commence par image/

Contient application/ et se termine par set.

Les "filter-images" d’usine (s’applique aux ressources d’images uniques, y compris aux images interactives) et les "filter-sets" (s’applique aux visionneuses à 360°, aux visionneuses de supports variés et aux visionneuses de carrousel) :
  • Insérez des images et des métadonnées PTIFF pour la réplication (tout rendu commençant par cqdam).
  • Suppriment de la réplication l’image d’origine et les rendus d’image statiques.
Diffusion vidéo Dynamic Media filter-video Commence par video/ La "filter-video" d’usine :
  • Incluez des rendus vidéo proxy, des images miniatures/d’affiche vidéo, des métadonnées (à la fois pour les rendus vidéo et vidéo parents) pour la réplication (tout rendu commençant par cqdam).
  • Excluez de la réplication la vidéo d’origine et les rendus de miniatures statiques.

    Remarque : Les rendus vidéo proxy ne contiennent pas de fichiers binaires, mais sont simplement des propriétés de noeud. Ils n’affectent donc pas la taille du référentiel de l’éditeur.
Intégration Dynamic Media Classic

filter-images

filter-sets

filter-video

Commence par image/

Contient application/ et se termine par set.

Commence par video/

Vous configurez l’URI de transport pour qu’il pointe vers votre serveur de publication AEM au lieu de l’URL du service de réplication cloud Dynamic Media Adobe. La configuration de ce filtre permet à Dynamic Media Classic de diffuser les ressources à la place de l’instance de publication AEM.

Les "filter-images", "filter-sets" et "filter-video" prêts à l’emploi consistent à :

  • Incluez des images PTIFF, des rendus vidéo proxy et des métadonnées pour la réplication. Toutefois, dans la mesure où ils n’existent pas dans JCR, ces filtres n’ont aucun effet pour ceux qui exécutent l’intégration de Dynamic Media Classic d’AEM.
  • Suppriment de la réplication l’image d’origine et les rendus d’image statiques, les vidéos d’origine et les rendus de miniature statiques. À la place, Dynamic Media Classic diffuse les ressources image et vidéo.
REMARQUE

Les filtres s’appliquent aux types MIME et ne peuvent pas être spécifiques à un chemin.

Configuration des filtres de ressources pour les déploiements vidéo uniquement

Si vous utilisez Dynamic Media pour la vidéo uniquement, suivez les étapes suivantes pour configurer les filtres de ressource pour la réplication :

  1. Dans AEM, appuyez sur le logo AEM pour accéder à la console de navigation globale, puis appuyez sur Outils > Déploiement > Réplication > Agents sur l’auteur.
  2. Dans la page Agents sur l’auteur, appuyez sur Agent par défaut (publication).
  3. Appuyez sur Modifier.
  4. Dans la boîte de dialogue Paramètres de l’agent, dans l’onglet Paramètres, cochez Activé pour activer l’agent.
  5. Appuyez sur OK.
  6. Dans AEM, appuyez sur Outils > Général > CRXDE Lite.
  7. Dans l’arborescence de gauche, accédez à /etc/replication/agents.author/dynamic_media_replication/jcr:content/damRenditionFilters
  8. Localisez filter-video, cliquez dessus avec le bouton droit de la souris et sélectionnez Copier.
  9. Dans l’arborescence de gauche, accédez à /etc/replication/agents.author/publish
  10. Localisez jcr:content, cliquez dessus avec le bouton droit de la souris et sélectionnez Coller.

Cette opération permet de configurer l’instance de publication AEM pour qu’elle fournisse l’image d’affiche et les métadonnées de la vidéo, qui sont nécessaires pour la lecture, tandis que la vidéo elle-même est fournie par le service cloud Dynamic Media. Le filtre exclut également de la réplication la vidéo originale et les rendus de miniature statiques, qui ne sont pas nécessaires sur l’instance de publication.

Configuration des filtres de ressources pour l’imagerie dans les déploiements hors production

Si vous utilisez Dynamic Media pour les images dans des déploiements hors production, suivez les étapes suivantes pour configurer les filtres de ressource pour la réplication :

  1. Dans AEM, appuyez sur le logo AEM pour accéder à la console de navigation globale, puis appuyez sur Outils > Déploiement > Réplication > Agents sur l’auteur.

  2. Dans la page Agents sur l’auteur, appuyez sur Agent par défaut (publication).

  3. Appuyez sur Modifier.

  4. Dans la boîte de dialogue Paramètres de l’agent, dans l’onglet Paramètres, cochez Activé pour activer l’agent.

  5. Appuyez sur OK.

  6. Dans AEM, appuyez sur Outils > Général > CRXDE Lite.

  7. Dans l’arborescence de gauche, accédez à /etc/replication/agents.author/dynamic_media_replication/jcr:content/damRenditionFilters

    image-2018-01-16-10-22-40-410

  8. Localisez filter-images, cliquez dessus avec le bouton droit de la souris et sélectionnez Copier.

  9. Dans l’arborescence de gauche, accédez à /etc/replication/agents.author/publish

  10. Recherchez jcr:content, cliquez dessus avec le bouton droit et sélectionnez Créer > Créer un noeud. Saisissez le nom damRenditionFilters de type nt:unstructured.

  11. Recherchez damRenditionFilters, cliquez dessus avec le bouton droit et sélectionnez Coller.

Cette opération permet de configurer l’instance de publication AEM pour qu’elle fournisse les images à votre environnement hors production. Le filtre exclut également de la réplication l’image originale et les rendus statiques, qui ne sont pas nécessaires sur l’instance de publication.

REMARQUE

S’il existe de nombreux filtres dans un auteur, chaque agent nécessite qu’un autre utilisateur lui soit attribué. Le code Granite impose le modèle d’un filtre par utilisateur. Ayez toujours un utilisateur différent pour chaque filtre configuré.
Si vous utilisez plusieurs filtres sur un serveur (par exemple, un filtre pour la réplication à publier et un second filtre pour s7delivery), vous devez vous assurer que ces deux filtres ont un userId différent qui leur est affecté dans le noeud jcr:content. Voir l’image suivante :

image-2018-01-16-10-26-28-465

Personnalisation des filtres de ressources pour la réplication

Pour personnaliser les filtres de ressources pour la réplication (facultatif) :

  1. Dans AEM, appuyez sur le logo AEM pour accéder à la console de navigation globale, puis appuyez sur Outils > Général > CRXDE Lite.

  2. Dans l’arborescence de gauche, accédez à /etc/replication/agents.author/dynamic_media_replication/jcr:content/damRenditionFilters pour consulter les filtres.

    chlimage_1-511

  3. Pour définir le type MIME du filtre, vous pouvez localiser le type MIME comme suit :

    Dans le rail de gauche, développez content > dam > "a1/> > jcr:content > metadata, puis, dans le tableau, localisez dc:format.locate_your_asset

    L’illustration ci-dessous est un exemple de chemin d’une ressource vers dc:format.

    chlimage_1-512

    Notez que la valeur dc:format de la ressource Fiji Red.jpg est image/jpeg.

    Pour que ce filtre s’applique à toutes les images, quel que soit leur format, définissez la valeur sur image/** est une expression régulière appliquée à toutes les images de n’importe quel format.

    Pour que le filtre s'applique uniquement aux images de type JPEG, saisissez la valeur image/jpeg.

  4. Définissez les rendus que vous souhaitez inclure ou exclure de la réplication.

    Voici des exemples de caractères que vous pouvez utiliser afin de filtrer la réplication :

Caractère à utiliser Filtrage des ressources pour la réplication
* Caractère générique
+ Inclut des ressources pour la réplication.
- Exclut les ressources de la réplication.

Accéder à content/dam/<locate_your_asset>/jcr:content/renditions.

L’illustration ci-dessous est un exemple de rendu d’une ressource.

chlimage_1-513

En reprenant l’exemple ci-dessus, si vous souhaitez uniquement répliquer le PTIFF (TIFF Pyramid), vous devez saisir +cqdam,* qui inclut tous les rendus commençant par cqdam. Dans l’exemple, ce rendu est cqdam.pyramid.tiff.

Si vous ne souhaitez répliquer que l’original, saisissez +original.

Configuration des paramètres du serveur d’images Dynamic Media

Pour configurer le serveur d’images Dynamic Media, vous devez modifier les lots Adobe CQ Scene7 ImageServer et Adobe CQ Scene7 PlatformServer.

REMARQUE

Dynamic Media est prêt à l’emploi après avoir été activé. Cependant, vous pouvez choisir d’affiner l’installation en configurant le serveur d’images Dynamic Media.

Condition préalable requise : __ Avant de configurer Dynamic Media Image Server, assurez-vous que votre machine virtuelle Windows comprend une installation des bibliothèques Visual C++ Microsoft. Les bibliothèques sont nécessaires pour exécuter le serveur d’images Dynamic Media. Vous pouvez télécharger le module Microsoft Visual C++ 2010 Redistributable (x64) ici.

Pour configurer les paramètres du serveur d’images Dynamic Media :

  1. Dans le coin supérieur gauche de l’AEM, appuyez sur Adobe Experience Manager pour accéder à la console de navigation globale, puis appuyez sur Outils > Opérations > Console web.

  2. Sur la page Configuration de la console web Adobe Experience Manager , appuyez sur OSGi > Configuration pour répertorier tous les lots en cours d’exécution dans AEM.

    Les serveurs de diffusion Dynamic Media se trouvent sous les noms suivants dans la liste :

    • Adobe CQ Scene7 ImageServer
    • Adobe CQ Scene7 PlatformServer
  3. Dans la liste des lots, à droite de Adobe CQ Scene7 ImageServer, appuyez sur l’icône Modifier.

  4. Dans la boîte de dialogue Adobe CQ Scene7 ImageServer, définissez les valeurs de configuration suivantes :

    REMARQUE

    Dans la plupart des cas, il n’est pas nécessaire de modifier les valeurs par défaut. Cependant, si vous modifiez les valeurs par défaut, vous devez redémarrer le lot pour que les modifications soient prises en compte.

Propriété Valeur par défaut Description
TcpPort.name empty Numéro de port à utiliser pour la communication avec le processus ImageServer. Le port disponible par défaut est automatiquement détecté.
AllowRemoteAccess.name empty

Autoriser ou refuser l’accès à distance au processus ImageServer. Si la valeur est false, le serveur d’images écoute uniquement sur localhost.

Les paramètres par défaut du service Externalizer qui pointe vers le localhost doivent spécifier le domaine ou l’adresse IP de l’instance VM spécifique. La raison en est que le localhost peut pointer vers le système parent de la machine virtuelle.

Les domaines ou les adresses IP de la machine virtuelle ont donc peut-être besoin d’une entrée de fichier hôte pour être résolus.

MaxRenderRgnPixels 16 mégapixels Taille maximale en mégapixels restitués.
MaxMessageSize 16 Mo Taille maximale du message envoyé en mégaoctets.
RandomAccessUrlTimeout 20 Délai d’expiration correspondant au nombre de secondes durant lesquelles le serveur d’images attend le JCR pour répondre à une requête de plage de mosaïque.
WorkerThreads 10 Nombre de threads Worker.
  1. Appuyez sur Enregistrer.

  2. Dans la liste des lots, à droite de Adobe CQ Scene7 PlatformServer, appuyez sur l’icône Modifier.

  3. Dans la boîte de dialogue Adobe CQ Scene7 PlatformServer, définissez les options de valeur par défaut suivantes :

    REMARQUE

    Le serveur d’images Dynamic Media utilise son propre cache sur disque pour mettre les réponses en mémoire cache. Le cache HTTP AEM et le Dispatcher ne peuvent pas être utilisés pour la mise en mémoire cache des réponses provenant du serveur d’images Dynamic Media.

    Propriété Valeur par défaut Description
    Cache enabled Cochée Indique si le cache de réponse est activé…
    Cache roots cache Un ou plusieurs chemins vers les dossiers de cache de réponse. Les chemins relatifs sont résolus par rapport au dossier du lot s7imaging interne.
    Cache Max Size 200 000 000 Taille maximale du cache de réponse en octets.
    Cache Max Entries 100 000 Nombre maximal d’entrées autorisées dans le cache.

Paramètres du manifeste par défaut

Le manifeste par défaut vous permet de configurer les valeurs par défaut qui sont utilisées pour générer les réponses du service de diffusion Dynamic Media. Vous pouvez affiner la qualité (qualité du JPEG, résolution, mode de rééchantillonnage), la mise en cache (expiration) et empêcher le rendu des images trop volumineuses (defaultpix, defaultthumbpix, maxpix).

La localisation de la configuration du manifeste par défaut est basée sur la valeur par défaut de Catalog root du lot Adobe CQ Scene7 PlatformServer. Par défaut, cette valeur se trouve à l’emplacement suivant dans Outils > Général > CRXDE Lite :

/conf/global/settings/dam/dm/imageserver/

configimageservercrxdelite

Vous pouvez modifier les valeurs des propriétés décrites dans le tableau ci-dessous en saisissant de nouvelles valeurs.

Lorsque vous avez terminé d’apporter des modifications au manifeste par défaut, dans le coin supérieur gauche de la page, appuyez sur Enregistrer tout.

Veillez à appuyer sur l’onglet Contrôle d’accès (à droite de l’onglet Propriétés), puis à définir les privilèges de contrôle d’accès sur jcr:read pour tous les utilisateurs et les utilisateurs de la réplication Dynamic Media.

configimageservercrxdeliteAccoltab

Tableau des paramètres du manifeste et leurs valeurs par défaut :

Propriété Valeur par défaut Description
bkgcolor FFFFFF

Couleur d’arrière-plan par défaut. La valeur RVB est utilisée pour remplir toutes les zones d’une image de réponse qui ne contiennent aucune donnée d’image actuelle.

Voir également BkgColor dans l’API du service d’images.

defaultpix 300,300

Taille d’affichage par défaut. Le serveur oblige les images de réponse à ne pas dépasser ces valeurs, si la requête ne précise pas la taille d’affichage explicitement à l’aide des commandes wid=, hei= ou scl=.

Spécifiée sous la forme de deux nombres entiers de valeur supérieure ou égale à zéro, séparés par une virgule. Largeur et hauteur en pixels. Les deux valeurs, ou une seule, peuvent être définies sur 0 pour ne pas les limiter. Ne s’applique pas aux requêtes imbriquées/intégrées.

Voir également DefaultPix dans l’API du service d’images.

Habituellement, cependant, vous utilisez un paramètre de visionneuse ou d’image prédéfini pour fournir la ressource. Defaultpix ne s’applique qu’à une ressource qui n’utilise pas de paramètre de visionneuse ou d’image prédéfini.

defaultthumbpix 100,100

Taille de miniature par défaut. Utilisé à la place d’attribute::DefaultPix pour les requêtes de miniature (req=tmb).

Le serveur oblige les images de réponse à ne pas dépasser ces valeurs, si la requête de miniature (req=tmb) ne précise pas la taille d’affichage explicitement à l’aide des commandes wid=, hei= ou scl=.

Spécifiée sous la forme de deux nombres entiers de valeur supérieure ou égale à zéro, séparés par une virgule. Largeur et hauteur en pixels. Les deux valeurs, ou une seule, peuvent être définies sur 0 pour ne pas les limiter.

Ne s’applique pas aux requêtes imbriquées/intégrées.

Voir aussi DefaultThumbPix dans l’API du service d’images.

expiration 36 000 000

Délai d’expiration par défaut du cache client. Indique un délai d’expiration par défaut dans l’éventualité où un enregistrement de catalogue spécifique ne contiendrait aucune valeur catalog::Expiration valide.

Nombre réel, supérieur ou égal à zéro. Nombre de millisecondes jusqu’à l’expiration, depuis la génération des données de réponse. Définissez la valeur sur zéro pour que l’image de réponse expire immédiatement, ce qui permet de désactiver efficacement la mise en cache de client. Par défaut, la valeur est définie sur 10 heures, ce qui signifie que si une nouvelle image est publiée, il faudra 10 heures aux anciennes images pour quitter le cache de l’utilisateur. Contactez le service à la clientèle si vous avez besoin que le cache soit effacé plus tôt.

Voir également Expiration dans l’API du service d’images.

jpegquality 80

Attributs d’encodage JPEG par défaut. Indique l’attribut par défaut des images de réponse au format JPEG.

Nombre entier et indicateur, séparés par une virgule. La première valeur est comprise dans la plage 1..100 et définit la qualité. La seconde valeur peut être égale à 0 par défaut, ou à 1 pour désactiver la réduction de la résolution chromatique RVB généralement utilisée par les encodeurs JPEG.

Voir également JpegQuality dans l’API du service d’images.

maxpix 2000,2000

Limite de taille de l’image de réponse. Largeur et hauteur maximales de l’image de réponse fournie au client.

Le serveur renvoie une erreur si une requête provoque une image de réponse dont la largeur ou la hauteur est supérieure à l’attribut::MaxPix.

Voir également MaxPix dans l’API du service d’images.

resmode NET2

Mode de rééchantillonnage par défaut. Indique les attributs de rééchantillonnage et d’interpolation à appliquer par défaut lors du redimensionnement de données d’images.

Utilisé quand resMode= n’est pas indiqué dans une requête.

Les valeurs autorisées sont les suivantes : BILIN, BICUB ou SHARP2.

Enum. Défini sur 2 pour bilin, 3 pour bicub ou 4 pour le mode d’interpolation sharp2. Utilisez sharp2 pour obtenir de meilleurs résultats.

Voir également ResMode dans l’API du service d’images.

resolution 72

Résolution d’objet par défaut. Indique une résolution d’objet par défaut dans l’éventualité où un enregistrement de catalogue spécifique ne contiendrait aucune valeur catalog::Resolution valide.

Nombre réel, supérieur à 0. Généralement exprimé en pixels par pouce, mais peut également être exprimé dans d’autres unités, comme les pixels par mètre.

Voir également Résolution dans l’API du service d’images.

thumbnailtime 1 %, 11 %, 21 %, 31 %, 41 %, 51 %, 61 %, 71 %, 81 %, 91 % Ces valeurs représentent un instantané du temps de lecture vidéo et sont transmises à encoding.com. Reportez-vous à la section À propos des miniatures vidéo pour plus d’informations.

Configuration de la gestion des couleurs Dynamic Media

La gestion des couleurs Dynamic Media vous permet de corriger les couleurs des ressources pour leur prévisualisation.

Avec la correction des couleurs, les ressources intégrées conservent leur espace colorimétrique (RVB, CMJN, niveaux de gris) et le profil de couleurs intégré dans le rendu TIFF pyramidal générique. Lorsque vous demandez un rendu dynamique, la couleur de l’image est corrigée en fonction de l’espace colorimétrique cible. Vous configurez le profil de couleurs cible dans les paramètres de publication Dynamic Media dans le JCR.

La gestion des couleurs Adobe utilise les profils ICC, un format défini par l’ICC (International Color Consortium).

Vous pouvez configurer la gestion des couleurs Dynamic Media et les paramètres d’image prédéfinis à l’aide des sorties RVB, CMJN et de niveaux de gris. Reportez-vous à la section Configuration des paramètres d’image prédéfinis.

Les cas d’utilisation avancés peuvent utiliser un modificateur de configuration manuel icc= pour sélectionner explicitement un profil de couleurs cible :

REMARQUE

L’ensemble standard de profils de couleurs d’Adobe n’est disponible que si Feature Pack 12445 de Distribution logicielle est installé. Tous les Feature Packs et Service Packs sont disponibles à l’adresse Distribution logicielle. Le Feature Pack 12445 fournit les profils de couleurs Adobe.

Installation du Feature Pack 12445

Vous devez installer un Feature Pack 12445 pour utiliser les fonctionnalités de gestion des couleurs Dynamic Media.

Pour installer le Feature Pack 12445 :

  1. Accédez à Distribution logicielle et téléchargez cq-6.3.0-featurepack-12445.

    Voir Comment utiliser les packages pour plus d’informations sur l’utilisation des packages dans Adobe Experience Manager.

  2. Installez le Feature Pack.

Configuration des profils de couleurs par défaut

Une fois que vous avez installé le Feature Pack, vous devez configurer les profils de couleurs par défaut appropriés pour activer la correction de couleurs lors de l’appel des données d’image RVB ou CMJN.

Pour configurer les profils de couleurs par défaut :

  1. Dans Outils > Général > CRXDE Lite, accédez à /conf/global/settings/dam/dm/imageserver/configuration/settings qui contient les profils Adobe Color par défaut.

    chlimage_1-514

  2. Ajoutez une propriété de correction des couleurs en faisant défiler l’écran jusqu’au bas de l’onglet Propriétés et en saisissant manuellement le nom, le type et la valeur de la propriété, qui sont décrits dans les tableaux suivants. Après avoir saisi les valeurs, appuyez sur Ajouter, puis sur Enregistrer tout pour enregistrer vos valeurs.

    Les propriétés de correction des couleurs sont répertoriées dans le tableau des propriétés de correction des couleurs. Les valeurs que vous pouvez attribuer à ces propriétés sont disponibles dans le tableau des profils de couleurs.

    Par exemple, dans Nom, ajoutez iccprofilecmyk, sélectionnez Type String et ajoutez WebCoated en tant que Valeur. Appuyez sur Ajouter, puis sur Enregistrer tout pour enregistrer vos valeurs.

    chlimage_1-515

    Tableau des propriétés de corrections des couleurs

    Propriété Type Valeur par défaut Description
    iccprofilergb Chaîne <empty> Nom du profil colorimétrique RVB par défaut.
    iccprofilecmyk Chaîne <empty> Nom du profil colorimétrique CMJN par défaut.
    iccprofilegray Chaîne <empty> Nom du profil colorimétrique de niveaux de gris par défaut.
    iccprofilesrcrgb Chaîne <empty> Nom du profil colorimétrique de RGB par défaut utilisé pour les images de RGB qui n’ont pas de profil colorimétrique intégré
    iccprofilesrccmyk Chaîne <empty> Nom du profil colorimétrique CMJN par défaut utilisé pour les images CMJN qui n’ont pas de profil colorimétrique incorporé.
    iccprofilesrcgray Chaîne <empty> Nom du profil colorimétrique de niveaux de gris par défaut utilisé pour les images CMJN qui n’ont pas de profil colorimétrique incorporé.
    iccblackpointcompensation Booléen True Indique si la compensation du point noir doit être effectuée lors de la correction des couleurs. Adobe recommande d’activer cette propriété.
    iccdither Booléen False Indique si le tramage doit être effectué lors de la correction des couleurs.
    iccrenderintent Chaîne relative

    Indique le mode de rendu. Les valeurs possibles sont les suivantes : perception, relative, saturation, absolu. Adobe recommande d’utiliser colorimétrie relative comme valeur par défaut.

    REMARQUE

    Les noms des propriétés sont sensibles à la casse et doivent être en minuscules.

    Tableau des profils de couleurs

    Les profils de couleurs installés sont les suivants :

    Nom

    Espace colorimétrique

    Description

    AdobeRGB RVB Adobe RGB (1998)
    AppleRGB RVB Apple RGB
    CIERGB RVB RGB CIE
    CoatedFogra27 CMJN FOGRA27 (ISO 12647-2:2004) enrobé
    CoatedFogra39 CMJN FOGRA39 (ISO 12647-2:2004) enrobé
    CoatedGraCol CMJN Coated GRACoL 2006 (ISO 12647-2:2004)
    ColorMatchRGB RVB RGB ColorMatch
    EuropeISOCoated CMJN Europe ISO Coated FOGRA27
    EuroscaleCoated CMJN Euroscale Coated v2
    EuroscaleUncoul CMJN Euroscale Uncoute v2
    JapanColorCoated CMJN Japan Color 2001 Coated
    JapanColorNewspaper CMJN Journal Japan Color 2002
    JapanColorUnfill CMJN Japan Color 2001 Unfill
    JapanColorWebCoated CMJN Japan Color 2003 Web Coated
    JapanWebCoated CMJN Japan Web Coated (Ad)
    NewsprintSNA2007 CMJN Journal des États-Unis (SNA 2007)
    NTSC RVB NTSC (1953)
    PAL RVB PAL/SECAM
    ProPhoto RVB ProPhoto RGB
    PS4Default CMJN Photoshop 4 CMJN par défaut
    PS5Default CMJN Photoshop 5 CMJN par défaut
    SheetfedCoated CMJN U.S. Sheetfed Coated v2
    SheetfedUnPAW CMJN U.S. Sheetfed Non Couché v2
    SMPTE RVB SMPTE-C
    sRVB RVB sRVB IEC61966-2.1
    UncondamnésFogra29 CMJN FOGRA29 non couché (ISO 12647-2:2004)
    WebCoated CMJN U.S. Web Coated (SWOP) v2
    WebCoatedFogra28 CMJN FOGRA Web Coated 28 (ISO 12647-2:2004)
    WebCoatedClass3 CMJN Document SWOP 2006 de qualité 3 sur support Web
    WebCoatedClass5 CMJN Papier de qualité 5 SWOP 2006 à couverture Web
    WebUnCouché CMJN U.S. Web Non couché v2
    WideGamutRGB RVB RGB Gamme large
  3. Appuyez sur Enregistrer tout.

Par exemple, vous pouvez définir iccprofilergb sur sRGB et iccprofilecmyk sur WebCoated. Cela aura les effets suivants :

  • Active la correction des couleurs pour les images RVB et CMJN.
  • Les images de RGB qui n’ont pas de profil colorimétrique sont supposées se trouver dans l’espace colorimétrique sRGB.
  • Les images CMJN qui n’ont pas de profil colorimétrique sont considérées comme se trouvant dans l’espace colorimétrique WebCoated.
  • Les rendus dynamiques qui renvoient une sortie de RGB la renvoient dans l’espace colorimétrique sRGB.
  • Les rendus dynamiques qui renvoient une sortie CMJN, la renvoient dans l’espace colorimétrique WebCoated.

Diffusion des ressources

Une fois toutes les tâches ci-dessus terminées, les ressources Dynamic Media activées sont diffusées à partir du service d’image ou vidéo. Dans AEM, cette fonctionnalité apparaît dans une balise Copier l’URL de l’image, Copier l’URL de la visionneuse, Intégrer le code de la visionneuse et dans la gestion de contenu web.

Reportez-vous à la section Diffusion de ressources Dynamic Media.

Lorsque vous... Résultat
Copiez l’URL d’une image

La boîte de dialogue Copier l’URL affiche une URL similaire à celle-ci (l’URL est utilisée à des fins de démonstration uniquement) :

https://IMAGESERVICEPUBLISHNODE/is/image/content/dam/path/to/Image.jpg?$preset$

IMAGESERVICEPUBLISHNODE fait référence à l’URL du service d’images.

Voir aussi Diffusion des ressources Dynamic Media.

Copiez l’URL d’une visionneuse

La boîte de dialogue Copier l’URL affiche une URL similaire à celle-ci (l’URL est utilisée à des fins de démonstration uniquement) :

https://PUBLISHNODE/etc/dam/viewers/s7viewers/html5/BasicZoomViewer.html?asset=/content/dam/path/to/Image.jpg&config=/conf/global/settings/dam/dm/presets/viewer/Zoom_dark&serverUrl=https://IMAGESERVICEPUBLISHNODE/is/image/&contentRoot=%2F

PUBLISHNODE désigne le nœud de publication standard d’AEM et IMAGESERVICEPUBLISHNODE fait référence à l’URL du service d’images.

Voir aussi Diffusion des ressources Dynamic Media.

Copiez le code intégré d’une visionneuse

La boîte de dialogue Copier le code incorporé affiche un fragment de code similaire à ce qui suit (l’exemple de code est fourni à des fins de démonstration uniquement) :

<style type="text/css"> ​#s7basiczoom_div.s7basiczoomviewer{ width:100%; height:auto; } </style> <script type="text/javascript" src="https://PUBLISHNODE/etc/dam/viewers/s7viewers/html5/js/BasicZoomViewer.js"></script> <div id="s7basiczoom_div"></div> <script type="text/javascript"> var s7basiczoomviewer = new s7viewers.BasicZoomViewer({ "containerId" : "s7basiczoom_div", "params" : { "serverurl" : "https://IMAGESERVICEPUBLISHNODE/is/image/", "contenturl" : "https://PUBLISHNODE/", "config" : "/conf/global/settings/dam/dm/presets/viewer/Zoom_dark", "asset" : "/content/dam/path/to/Image.jpg" } }).init(); </script>

PUBLISHNODE désigne le nœud de publication standard d’AEM et IMAGESERVICEPUBLISHNODE fait référence à l’URL du service d’images.

Voir aussi Diffusion des ressources Dynamic Media.

Composants de médias interactifs et composants Dynamic Media de gestion de contenu web

Les pages de gestion du contenu web qui mentionnent les composants de médias interactifs et Dynamic Media mentionnent également le service de diffusion de contenu.

Sur cette page