Cette section vous explique comment résoudre les problèmes occasionnels pouvant affecter, notamment, l’installation, la mise à niveau et la configuration de l’appli de bureau AEM.
L’appli de bureau Adobe Experience Manager s’accompagne d’utilitaires qui vous aident à mapper le référentiel AEM Assets en tant que partage réseau sur le poste de travail (partage SMB sous Mac OS). Le partage réseau est une technologie du système d’exploitation qui permet aux sources distantes d’être traitées comme si elles faisaient partie du système de fichiers local d’un ordinateur. Dans le cas de l’appli de bureau AEM, la structure du référentiel de Gestion des actifs numériques (DAM) d’une instance AEM distante est ciblée comme source de fichier distante. Le schéma suivant décrit la topologie de l’appli de bureau AEM :
Avec cette architecture, l’application intercepte les appels du système de fichiers (ouvrir, fermer, lire, écrire, etc.) vers le partage réseau monté et les convertit en appels HTTP AEM natifs vers le serveur AEM. Les fichiers sont mis en cache localement. Pour plus d’informations, voir Utilisation de l’appli de bureau AEM v1.x.
L’appli de bureau AEM comprend les composants suivants :
L’appli de bureau AEM utilise la technologie de partage réseau pour mapper un référentiel AEM distant sur un ordinateur local. Cependant, elle n’est pas conçue pour remplacer un partage réseau contenant des ressources, sur lequel des utilisateurs effectuent des opérations de gestion des actifs numériques à partir de leur ordinateur local. Ces opérations sont notamment le déplacement ou la copie de plusieurs fichiers, ou encore le déplacement de structures de dossiers volumineuses vers le partage réseau d’AEM Assets directement dans le Finder/l’Explorateur.
L’appli de bureau AEM fournit une méthode pratique pour accéder à des ressources DAM (ouverture) et les modifier (enregistrement) entre l’interface utilisateur tactile d’AEM Assets et le poste de travail local. L’application lie les ressources stockées sur le serveur AEM Assets à vos workflows de bureau.
Le scénario suivant illustre l’utilisation de l’appli de bureau AEM :
Il ne s’agit pas du seul cas d’utilisation. Toutefois, il illustre à quel point l’appli de bureau AEM constitue un mécanisme pratique pour modifier des ressources et y accéder en local. Dans la mesure du possible, vous êtes invité à utiliser l’interface utilisateur de la gestion des actifs numériques (DAM), car elle garantit une meilleure expérience. Elle confère à Adobe une souplesse accrue pour répondre aux besoins des clients.
Le partage réseau WebDAV/SMB1 offre la possibilité de traiter des fichiers dans une fenêtre de l’Explorateur ou du Finder. Cependant, l’Explorateur/le Finder et AEM communiquent sur une connexion réseau qui présente certaines limites. Par exemple, le temps nécessaire pour copier un fichier de 1 Go sur le répertoire WebDAV/SMB monté est approximativement le même que celui qui est nécessaire pour transférer un fichier de 1 Go vers un site web à l’aide d’un navigateur web. En fait, dans le premier cas, cette opération peut s’avérer plus longue en raison du manque d’efficacité du protocole WebDAV/SMB et des clients WebDAV/SMB du système d’exploitation (en particulier sous Mac OS X).
Il existe certaines restrictions quant aux types de tâches qui peuvent être effectuées à partir d’un répertoire monté. En règle générale, utiliser des fichiers volumineux, en particulier sur une connexion réseau de mauvaise qualité/à latence élevée/à faible bande passante, peut se révéler difficile, surtout si vous effectuez des opérations de modification.
Adobe vous conseille d’effectuer quelques tests avant de confirmer au client que certains types de fichiers peuvent être modifiés efficacement de manière statique à partir du répertoire monté.
L’appli de bureau AEM n’est pas adaptée aux manipulations intensives sur le système de fichiers, notamment :
En raison de restrictions au niveau du système d’exploitation, la taille de fichier est limitée à 4 294 967 295 octets (environ 4,29 Go) sous Windows. Cela est dû à un paramètre du Registre qui définit la taille maximale d’un fichier sur un partage réseau. La valeur du paramètre de Registre est un DWORD avec une taille maximale équivalant au nombre référencé.
L’appli de bureau Experience Manager ne dispose pas d’une valeur de délai d’expiration configurable qui déconnecte l’appli de bureau du serveur Experience Manager après un intervalle de temps fixe. Lors du chargement de ressources volumineuses, si la connexion expire au bout d’un certain temps, l’application tente à nouveau de charger la ressource plusieurs fois en augmentant le délai d’expiration du chargement. Il n’existe aucun moyen recommandé de modifier les paramètres de délai d’expiration par défaut.
L’appli de bureau AEM fournit des fonctions de chargement en arrière-plan et de mise en cache interne afin d’améliorer l’expérience de l’utilisateur final. Lorsque vous enregistrez un fichier volumineux, il est d’abord enregistré en local pour que vous puissiez continuer à travailler. Après un moment (30 secondes actuellement), le fichier est envoyé au serveur AEM en arrière-plan.
Contrairement à Creative Cloud Desktop ou à d’autres solutions de synchronisation de fichiers, telles que Microsoft One Drive, l’appli de bureau AEM n’est pas un client de synchronisation de bureau complet. En effet, cette application permet d’accéder au référentiel AEM Assets dans son intégralité, lequel peut être extrêmement volumineux (de l’ordre de plusieurs centaines de gigaoctets ou de téraoctets) pour une synchronisation complète.
La mise en cache offre la possibilité de limiter la surcharge de stockage/réseau à un sous-ensemble de ressources pertinentes pour l’utilisateur.
Adobe recommande de désactiver la génération de miniatures pour accélérer la navigation. Si vous activez les aperçus d’icônes, l’application met en cache les ressources numériques lorsque vous parcourez le dossier monté. L’application télécharge également des ressources dont l’utilisateur n’a peut-être pas l’utilité, ce qui augmente la charge sur le serveur, et consomme la bande passante ainsi que l’espace disque de l’utilisateur.
Pour effectuer la mise en cache, l’appli de bureau AEM procède comme suit :
Toutes les opérations ne sont pas mises en cache localement. Les éléments suivants sont immédiatement transmis au serveur AEM sans mise en cache locale :
Pour résoudre des problèmes de performances affectant les utilisateurs individuels, consultez d’abord la section Restrictions de l’appli. Les sections suivantes contiennent des suggestions visant à améliorer les performances pour les utilisateurs individuels.
La bande passante dont dispose un utilisateur joue un rôle essentiel dans les performances du client WebDAV/SMB.
Adobe recommande une vitesse de transfert proche de 10 Mbit/s pour un seul utilisateur. Dans le cas des connexions sans fil, la bande passante est souvent partagée entre plusieurs utilisateurs. Si plusieurs utilisateurs effectuent simultanément des tâches qui utilisent la bande passante du réseau, les performances peuvent se dégrader encore plus. Pour éviter ce type de problème, utilisez une connexion câblée.
Lorsque vous interagissez avec un fichier en local, l’appli de bureau AEM vérifie si une version plus récente du fichier est disponible dans AEM. Si tel est le cas, l’application télécharge une nouvelle copie du fichier dans le cache local. Toutefois, l’appli de bureau AEM n’écrase pas un fichier mis en cache localement s’il a été modifié. Cette fonctionnalité empêche tout écrasement accidentel de votre travail.
Lorsqu’un même fichier est modifié en local et dans AEM, la version modifiée en local écrase celle qui est stockée dans AEM. Dans ce cas, la version précédente est disponible dans la chronologie de la ressource. Vous pouvez vérifier les deux versions et résoudre les éventuels conflits.
Si un fichier local est en conflit avec la version disponible sur le serveur, la boîte de dialogue d’état du transfert en arrière-plan vous en informe. Pour résoudre ce problème, ouvrez le fichier à l’origine du conflit et enregistrez-le. L’enregistrement du fichier force l’appli de bureau AEM à synchroniser vos dernières modifications locales avec AEM. Vous pouvez afficher les versions précédentes de la ressource dans la chronologie et résoudre les éventuels conflits.
Vous devez tenir compte d’autres facteurs lorsque plusieurs utilisateurs essaient de travailler dans des répertoires montés distincts ciblant la même instance AEM. Les facteurs suivants sont particulièrement importants :
En cas de dégradation significative des performances WebDAV/SMB lorsque plusieurs utilisateurs travaillent simultanément, vous pouvez configurer quelques éléments dans AEM, ce qui permet d’optimiser les performances.
Vous pouvez améliorer les performances du côté AEM en activant les workflows transitoires pour le workflow Ressources de mise à jour de gestion des actifs numériques (DAM). L’activation de workflows transitoires réduit la puissance de traitement requise pour mettre à jour des ressources lors de leur création ou de leur modification dans AEM.
/miscadmin
dans l’instance Experience Manager (https://[aem_server]:[port]/miscadmin
).Pour améliorer les performances d’AEM, une autre méthode consiste à configurer le nombre maximum de tâches en parallèle pour la file d’attente des workflows transitoires Granite. La valeur recommandée équivaut approximativement à la moitié du nombre de processeurs disponibles avec le serveur. Pour régler la valeur, procédez comme suit :
/system/console/configMgr
dans l’instance AEM à configurer (par exemple, https://[aem_server]:[port]/system/console/configMgr
).QueueConfiguration
, puis cliquez pour ouvrir chaque tâche jusqu’à ce que vous ayez trouvé la tâche Granite Transient Workflow Queue et cliquez sur Modifier.Maximum Parallel Jobs
(Nombre maximum de tâches en parallèle), puis cliquez sur Enregistrer.En raison des limites de bande passante du réseau de WebDAV/SMB, une dégradation des performances est possible lorsque plusieurs utilisateurs travaillent simultanément. Adobe recommande d’augmenter la taille de l’instance AWS pour une instance AEM cible qui s’exécute sur AWS afin d’améliorer les performances de WebDAV/SMB.
Cette mesure augmente en particulier la quantité de bande passante réseau disponible pour le serveur. Voici quelques informations détaillées :
Il existe quelques restrictions connues quant à la façon dont vous pouvez interagir avec les fichiers extraits par le biais de l’Explorateur ou du Finder. Si un fichier est extrait, il doit être en lecture seule pour tous les utilisateurs, à l’exception de celui qui l’a extrait. La mise en œuvre du protocole WebDAV/SMB1 dans AEM applique cette règle. Cependant, dans le cas des clients WebDAV/SMB du système d’exploitation, il apparaît que l’interaction avec les fichiers extraits est rarement appropriée. Certaines anomalies sont décrites ci-dessous.
Si vous écrivez dans un fichier extrait, le verrouillage n’est appliqué que dans l’implémentation WebDAV d’AEM. Par conséquent, le verrouillage n’est appliqué que par les clients qui utilisent WebDAV, comme l’appli de bureau. Le verrouillage n’est pas appliqué par le biais de l’interface web AEM. L’interface AEM affiche simplement une icône de verrou dans le mode Carte pour les ressources qui sont extraites. Cette icône est purement décorative et n’a aucun effet sur le comportement d’AEM.
En règle générale, les clients WebDAV ne se comportent pas toujours comme prévu. Il peut y avoir d’autres problèmes. Cependant, l’actualisation ou la vérification de la ressource dans AEM est un bon moyen de s’assurer qu’elle est en cours de modification. Ce comportement est typique des clients WebDAV du système d’exploitation, ce qui échappe au contrôle d’Adobe.
La suppression d’un fichier semble réussir, dans la mesure où il n’apparaît plus dans l’Explorateur de fichiers de Windows. Cependant, l’actualisation du répertoire et la vérification des ressources AEM indiquent que le fichier est toujours présent. En outre, la modification des fichiers semble réussir (aucune boîte de dialogue d’avertissement ni message d’erreur n’est affiché). Toutefois, la réouverture du fichier ou la vérification des ressources AEM fait apparaître que le fichier n’a pas été modifié.
Aucun message d’erreur ni d’avertissement ne s’affiche lors du remplacement d’un fichier, mais la vérification de la ressource dans AEM fait apparaître qu’elle n’a pas été modifiée. Actualisez ou vérifiez la ressource dans AEM pour vous assurer qu’elle n’est pas en cours de modification.
Une fois que vous avez installé l’appli de bureau AEM, l’icône de menu de l’application s’affiche dans la barre de menus. Si cette icône n’apparaît pas, procédez comme suit pour remédier au problème :
Ouvrez la fenêtre de terminal du système d’exploitation.
Saisissez la commande suivante à l’invite de commande et appuyez ensuite sur la touche Entrée :
cd ../Library/Caches.
Saisissez la commande suivante et appuyez ensuite sur la touche Entrée :
rm -r com.adobe.aem.assetscompanion
Saisissez la commande suivante et appuyez ensuite sur la touche Entrée :
cd ~/Library/Preferences
Saisissez la commande suivante et appuyez ensuite sur la touche Entrée :
rm com.adobe.aem.assetscompanion.plist
Saisissez la commande suivante et appuyez ensuite sur la touche Entrée :
rm ~/Library/Group\ Containers/group.com.adobe.aem.desktop/*
Redémarrez le système.
L’appli de bureau AEM tente de synchroniser un fichier donné à trois reprises. Si la troisième tentative de synchronisation du fichier échoue, l’appli de bureau AEM considère que le fichier est en conflit et vous en informe par le biais de la fenêtre de statut des transferts en arrière-plan. Un statut de conflit indique que vos dernières modifications sont toujours disponibles en local, mais qu’elles ne sont plus resynchronisées avec AEM. L’appli de bureau AEM ne tente plus de se synchroniser.
Pour remédier à ce problème, la méthode la plus simple consiste à ouvrir le fichier à l’origine du conflit et à le réenregistrer. De cette manière, l’appli de bureau AEM est forcée d’effectuer trois tentatives de synchronisation supplémentaires. Si la synchronisation du fichier échoue encore, consultez les sections ci-dessous pour obtenir une aide supplémentaire.
L’effacement du cache de l’appli de bureau AEM est une tâche de dépannage préliminaire qui permet de résoudre plusieurs problèmes liés à l’application.
Vous pouvez effacer le cache en supprimant le répertoire de cache de l’application aux emplacements suivants.
Sous Windows, %LocalAppData%\Adobe\AssetsCompanion\Cache\
Sous Mac, ~/Library/Group/Containers/group.com.adobe.aem.desktop/cache/
Toutefois, l’emplacement peut varier en fonction du point de terminaison AEM configuré de l’appli de bureau AEM. La valeur est une version codée de l’URL ciblée. Par exemple, si l’application cible est http://localhost:4502
, le nom du répertoire est http%3A%2F%2Flocalhost%3A4502%2F
.
Pour effacer le cache, supprimez le répertoire <Point de terminaison AEM codé>.
Si vous effacez le cache de l’appli de bureau AEM, les modifications de fichier locales qui ne sont pas synchronisées avec AEM seront perdues.
À compter de la version 1.5 de l’appli de bureau AEM, une option disponible dans l’interface utilisateur de l’application permet d’effacer le cache.
La procédure de vérification de la version de l’appli de bureau AEM est la même sous Windows et macOS.
Cliquez sur l’icône de l’appli de bureau AEM, puis sélectionnez About (À propos). Le numéro de version est affiché à l’écran.
Des problèmes peuvent parfois survenir lors de la mise à niveau de l’appli de bureau AEM sous macOS. Cela est dû au dossier système hérité de l’appli de bureau AEM qui empêche le chargement correct des nouvelles versions de l’application. Pour y remédier, les dossiers et fichiers suivants peuvent être supprimés manuellement.
Avant d’exécuter les étapes ci-dessous, faites glisser « Appli de bureau Adobe Experience Manager » du dossier Applications de macOS vers la Corbeille. Ouvrez ensuite le terminal et exécutez la commande suivante en saisissant votre mot de passe lorsque vous y êtes invité.
sudo rm -rf ~/Library/Application\ Support/com.adobe.aem.desktop
sudo rm -rf ~/Library/Preferences/com.adobe.aem.desktop.plist
sudo rm -rf ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop
sudo find /var/folders -type d -name "com.adobe.aem.desktop" | xargs rm -rf
sudo find /var/folders -type d -name "com.adobe.aem.desktop.finderintegration-plugin" | xargs rm -rf
En raison des limites techniques du système d’exploitation, les utilisateurs ne peuvent pas bénéficier d’une expérience cohérente lorsqu’ils tentent de remplacer un fichier extrait par d’autres utilisateurs. Cela varie, en effet, suivant l’application utilisée pour modifier le fichier extrait. Dans certains cas, l’application affiche soit un message d’erreur indiquant un échec d’écriture sur le disque, soit une erreur générique ou sans lien apparent avec le problème. Dans d’autres, aucun message d’erreur n’est affiché et l’opération semble réussir.
Dans ce cas, la fermeture et la réouverture du fichier peut indiquer que le contenu n’a pas été modifié. Toutefois, certaines applications peuvent stocker une sauvegarde du fichier, de sorte que vos modifications puissent être appliquées.
Quel que soit le comportement, le fichier reste inchangé lorsque vous l’archivez. Même si une version différente du fichier est affichée, les modifications ne sont pas synchronisées avec AEM.
Dans le cas de l’API serveur, la transmission d’en-têtes supplémentaires, X-Destination, X-Depth et X-Overwrite, est nécessaire pour garantir le fonctionnement des opérations de déplacement et de copie. Le Dispatcher ne transmet pas ces en-têtes par défaut, ce qui entraîne l’échec de ces opérations. Pour plus d’informations, voir Connexion à AEM derrière un Dispatcher.
Dans la majorité des cas, les problèmes de connexion de l’appli de bureau AEM à votre instance AEM compatible SSO (SAML) sont dus au fait que le processus SAML n’effectue pas de redirection vers le chemin demandé initialement. Sinon, la connexion peut être redirigée vers un hôte qui n’est pas configuré dans l’appli de bureau AEM. Procédez comme suit pour vérifier le processus de connexion :
/content/dam.json
.https://localhost:4502/content/dam.json
./content/dam.json
correspondent à la valeur AEM configurée dans l’appli de bureau AEM.Les bibliothèques utilisées par l’appli de bureau AEM pour les communications HTTP appliquent le protocole SSL de manière stricte. Parfois, une connexion peut réussir en utilisant un navigateur, mais échouer avec l’appli de bureau AEM. Pour configurer SSL convenablement, installez le certificat intermédiaire manquant dans Apache. Voir Comment installer un certificat d’autorité de certification intermédiaire dans Apache.
L’appli de bureau AEM fonctionne avec des déploiements situés derrière un Dispatcher ; il s’agit de la configuration par défaut, recommandée pour les serveurs AEM. En règle générale, les Dispatchers AEM situés devant les environnements de création AEM sont configurés pour ignorer la mise en cache des ressources DAM. Par conséquent, ils ne fournissent pas de mise en cache supplémentaire du point de vue de l’appli de bureau AEM. Assurez-vous que la configuration du Dispatcher a été adaptée pour fonctionner avec l’appli de bureau AEM. Pour plus d’informations, voir Connexion à AEM derrière un Dispatcher.
En fonction de votre système d’exploitation, les fichiers journaux de l’appli de bureau AEM se situent aux emplacements suivants :
%LocalAppData%\Adobe\AssetsCompanion\Logs
~/Library/Logs/Adobe\ Experience\ Manager\ Desktop