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, la configuration de l’appli de bureau AEM.

L’appli de bureau Adobe Experience Manager comprend des utilitaires qui vous aident à mapper le référentiel AEM Assets en tant que partage réseau sur le bureau (partage SMB sur macOS). 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. Pour l’appli de bureau, la source de fichier distante est la structure de référentiel de gestion des ressources numériques (DAM) d’une instance d’AEM distante. Le schéma suivant décrit la topologie de l’appli de bureau AEM :

Avec cette architecture, l’appli de bureau intercepte les appels du système de fichiers (ouverture, fermeture, lecture, écriture, etc.) au partage réseau monté et les convertit en appels HTTP AEM natifs au 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 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 bureau 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 offre un moyen pratique d’accéder (ouvrir) et de modifier (enregistrer) des ressources DAM entre l’interface utilisateur tactile d’AEM Assets et l’ordinateur 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 scénario n’est pas le seul cas pratique. 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, la durée peut être plus longue en raison de l’inefficacité du protocole WebDAV/SMB et des clients WebDAV/SMB du système d’exploitation (en particulier macOS 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 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 fonctionnalités de mise en cache interne et de transfert en arrière-plan 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.

Voici comment l’appli de bureau AEM effectue la mise en cache :

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

Lors de la résolution des problèmes de performances sous-optimisées pour les utilisateurs individuels, passez d’abord en revue les limites de l’application. Les sections suivantes contiennent des suggestions visant à améliorer les performances pour les utilisateurs.

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’un utilisateur individuel 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.

Tenez compte de facteurs supplémentaires lorsque plusieurs utilisateurs 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 AEM en activant les workflows transitoires pour le workflow Ressources de mise à jour de gestion des actifs numériques. 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 est environ 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

Lors de l’écriture dans un fichier extrait, le verrouillage n’est appliqué que dans l’implémentation WebDAV AEM. Par conséquent, les clients qui utilisent WebDAV, comme l’appli de bureau, n’appliquent que le verrouillage. Le verrouillage n’est pas appliqué par le biais de l’interface web d’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 la vérification dans AEM Assets indiquent 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). Cependant, la réouverture du fichier ou l’archivage dans AEM Assets révèle que le fichier reste inchangé.

MACOS 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 (macOS X) troubleshooting-desktop-app-icon-issues-mac-os-x

Une fois l’appli de bureau installée, l’icône de menu de l’appli de bureau 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 AEM Desktop App est la même pour 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 sur macOS upgrading-aem-desktop-app-on-macos

Des problèmes peuvent parfois survenir lors de la mise à niveau de l’appli de bureau AEM sur macOS. Les dossiers système hérités de l’appli de bureau AEM entraînent ces problèmes. Cela empêche le chargement correct des nouvelles versions de AEM Desktop. 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 indiquant 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 d’avoir une expérience cohérente lorsqu’ils tentent de remplacer un fichier que d’autres ont extrait. 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. 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. Vous pouvez également rediriger la connexion 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 ne parvient pas à utiliser 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 AEM Desktop avec Dispatcher using-aem-desktop-with-dispatcher

AEM Desktop App fonctionne avec les déploiements AEM derrière un Dispatcher, qui est une configuration par défaut recommandée pour les serveurs d’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 Dispatcher est adaptée pour fonctionner avec AEM Desktop. Pour plus d’informations, voir Connexion à AEM avec 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 :