Résolution des problèmes liés à l’appli de bureau Adobe Experience Manager v1.x troubleshoot-aem-desktop-app

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.

Vue d’ensemble des composants de l’appli de bureau AEM desktop-app-component-overview

L’appli de bureau AEM comprend les composants suivants :

Cas d’utilisation prévus pour l’appli de bureau AEM intended-use-cases-for-aem-desktop-app

L’appli de bureau AEM utilise la technologie de partage réseau pour mapper un référentiel AEM distant sur un ordinateur local. Toutefois, elle n’est pas conçue comme se substituant à un partage réseau contenant des ressources, où les utilisateurs et utilisatrices effectuent des opérations de gestion des ressources numériques directement depuis leur bureau local. Elle permet 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 :

Ce n’est pas le 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. Nous vous recommandons d’utiliser autant que possible l’interface utilisateur web de la gestion des ressources numériques, car elle offre une meilleure expérience. Elle offre à Adobe une plus grande flexibilité pour répondre aux besoins des clients et des clientes.

Restrictions limitations

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 charger 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.

Mise en cache et communication avec AEM caching-and-communication-with-aem

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é localement pour vous permettre de continuer à travailler. Au bout d’un certain temps (actuellement 30 secondes), le fichier est alors 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.

Pour effectuer la mise en cache, l’appli de bureau AEM procède comme suit :

Chaque opération n’est pas mise en cache localement. Les éléments suivants sont transmis immédiatement au serveur AEM, sans mise en cache locale :

Opérations distinctes individual-operations

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.

Recommandations en termes de bande passante bandwidth-recommendations

La bande passante disponible pour une seule personne joue un rôle essentiel dans les performances du client WebDAV/SMB.

Adobe recommande que la vitesse de chargement d’une personne unique soit proche de 10 Mbit/s. Pour les connexions sans fil, la bande passante est souvent partagée entre plusieurs personnes. Si plusieurs utilisateurs et utilisatrices effectuent simultanément des tâches qui consomment de la bande passante du réseau, les performances peuvent se dégrader davantage encore. Pour éviter de tels problèmes, utilisez une connexion câblée.

Opérations simultanées concurrent-operations

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 une nouvelle version est disponible, 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.

Lorsque le même fichier est modifié localement et dans AEM, la version modifiée localement remplace la version dans AEM. Dans ce cas, la version précédente est disponible dans le journal de la ressource. Vous pouvez vérifier les deux versions et résoudre les conflits.

Si un fichier local n’est pas cohérent avec la version disponible sur le serveur, la boîte de dialogue de statut du chargement en arrière-plan vous informe du conflit. Pour résoudre le problème, ouvrez le fichier en 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 le journal et résoudre les conflits.

Vous devez tenir compte de facteurs supplémentaires lorsque plusieurs personnes tentent de travailler dans des répertoires montés distincts ciblant la même instance AEM. En particulier, les facteurs suivants sont importants :

Configurations AEM supplémentaires additional-aem-configurations

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.

Mise à jour des workflows transitoires de ressources update-asset-transient-workflows

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.

Ajuster la file d’attente des workflows transitoires Granite adjust-granite-transient-workflow-queue

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 :

Configuration AWS aws-configuration

En raison des limitations de bande passante du réseau, les performances de WebDAV/SMB peuvent se dégrader lorsque plusieurs personnes 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 spécifiquement la bande passante du réseau disponible pour le serveur. Voici quelques détails :

Restrictions liées aux fichiers extraits checked-out-file-limitations

Il existe quelques limites connues dans la manière dont vous pouvez interagir avec les fichiers extraits via l’Explorateur/le Finder. Si un fichier est extrait, il doit être en lecture seule pour toute personne, à l’exception de celle qui l’a extrait. La mise en œuvre du protocole WebDAV/SMB1 dans AEM applique cette règle. Toutefois, les clients WebDAV/SMB du système d’exploitation interagissent souvent mal avec les fichiers extraits. Certains de ces faits étranges sont décrits ci-dessous.

Général general

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 verrouillage dans le mode Carte pour les ressources extraites. L’icône est simplement visuelle et n’a aucun effet sur le comportement d’AEM.

En général, les clients WebDAV ne se comportent pas toujours comme prévu. Il peut y avoir d’autres problèmes. Toutefois, l’actualisation ou la vérification de la ressource dans AEM est un bon moyen de vérifier qu’elle n’est pas en cours de modification. Ce comportement est typique des clients OS WebDAV, qui ne sont pas contrôlés par Adobe.

Windows windows

La suppression d’un fichier semble réussir, car le fichier disparaît de l’explorateur de fichiers sous Windows. Toutefois, l’actualisation du répertoire et l’archivage dans AEM Assets indique que le fichier est toujours présent. En outre, la modification des fichiers semble réussir (aucune boîte de dialogue d’avertissement ou message d’erreur ne s’affiche). Toutefois, la réouverture du fichier ou l’archivage dans AEM Assets révèle que le fichier reste inchangé.

Mac OS X mac-os-x

Le remplacement d’un fichier n’affiche pas d’avertissement ou d’erreur, mais l’archivage de la ressource dans AEM révèle qu’elle reste inchangée. Actualisez ou vérifiez la ressource dans AEM pour vous assurer qu’elle n’est pas en cours de modification.

Résolution des problèmes d’icône de l’appli de bureau AEM (Mac OS X) troubleshooting-desktop-app-icon-issues-mac-os-x

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 l’icône n’apparaît pas, procédez comme suit pour résoudre le problè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 chargements 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.

Effacement du cache de l’appli de bureau AEM clearing-aem-desktop-cache

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 d’entrée 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 <Encoded AEM Endpoint>.

Recherche de la version de l’appli de bureau AEM finding-the-aem-desktop-version

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 s’affiche à l’écran.

Mise à niveau de l’appli de bureau AEM sous macOS upgrading-aem-desktop-app-on-macos

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

Enregistrement d’un fichier extrait par d’autres utilisateurs saving-a-file-checked-out-by-others

Les limitations techniques du système d’exploitation empêchent les utilisateurs et utilisatrices d’avoir une expérience cohérente lorsqu’ils tentent de remplacer un fichier extrait par d’autres personnes. L’expérience varie en fonction de l’application utilisée pour modifier le fichier extrait. Parfois, l’application affiche un message d’erreur indiquant une erreur d’écriture de disque ou affiche une erreur apparemment sans rapport ou générique. Dans d’autres cas, aucun message d’erreur ne s’affiche 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é. Cependant, certaines applications peuvent stocker une sauvegarde du fichier afin que vos modifications puissent être appliquées.

Quel que soit le comportement, le fichier reste inchangé lorsque vous l’archivez. Même si une autre version du fichier s’affiche, les modifications ne sont pas synchronisées avec AEM.

Résolution des problèmes liés au déplacement de fichiers troubleshooting-problems-around-moving-files

L’API du serveur requiert la transmission d’en-têtes supplémentaires, X-Destination, X-Depth et X-Overwrite, pour que les opérations de déplacement et de copie fonctionnent. 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.

Résolution des problèmes de connexion de l’appli de bureau AEM troubleshooting-aem-desktop-connection-issues

Problème de redirection SAML saml-redirect-issue

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. Effectuez les étapes suivantes pour vérifier le processus de connexion :

Problème de configuration SSL ssl-configuration-issue

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 de manière appropriée, installez le certificat intermédiaire manquant dans Apache. Voir Comment installer un certificat d’autorité de certification intermédiaire dans Apache.

Utilisation de l’appli de bureau AEM avec le Dispatcher using-aem-desktop-with-dispatcher

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. Les Dispatchers AEM situés devant les environnements de création d’AEM sont généralement configurés de sorte à 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.

Recherche des fichiers journaux checking-for-log-files

En fonction de votre système d’exploitation, les fichiers journaux de l’appli de bureau AEM se situent aux emplacements suivants :