Solucione problemas AEM aplicativo de desktop para resolver problemas ocasionais relacionados à instalação, atualização, configuração e assim por diante.
Adobe Experience Manager o aplicativo desktop inclui utilitários que ajudam a mapear o repositório AEM Assets como um compartilhamento de rede no desktop (compartilhamento SMB no Mac OS). O compartilhamento de rede é uma tecnologia de sistema operacional que permite que fontes remotas sejam tratadas como se fossem parte de um sistema de arquivos local do computador. No caso de aplicativos de desktop, a estrutura de repositório DAM (digital asset management, gerenciamento de ativos digitais) de uma instância remota AEM é direcionada como a fonte de arquivos remotos. O diagrama a seguir descreve a topologia do aplicativo de desktop:
Com essa arquitetura, o aplicativo desktop intercepta chamadas do sistema de arquivos (abrir, fechar, ler, gravar e assim por diante) para o compartilhamento de rede montado e as converte em chamadas HTTP nativas AEM para o servidor AEM. Os arquivos são armazenados em cache localmente. Para obter mais detalhes, consulte Usar AEM aplicativo de desktop v1.x.
o aplicativo desktop inclui os seguintes componentes:
AEM aplicativo desktop usa a tecnologia de compartilhamento de rede para mapear um repositório AEM remoto para um desktop local. No entanto, não se destina a substituir um compartilhamento de rede que contém ativos, onde os usuários executam operações de gerenciamento de ativos digitais diretamente de seu desktop local. Isso inclui mover ou copiar vários arquivos, ou arrastar estruturas de pastas grandes para o compartilhamento de rede da AEM Assets diretamente no Finder/Explorer.
AEM aplicativo para desktop fornece uma maneira conveniente de acessar (abrir) e editar (salvar) ativos DAM entre a interface do usuário AEM Assets Touch e a área de trabalho local. Ele vincula ativos no servidor AEM Assets aos workflows baseados em desktop.
O exemplo de uso a seguir ilustra como AEM Desktop deve ser usada:
Este não é o único caso de uso. No entanto, ele ilustra como AEM Desktop é um mecanismo conveniente para acessar/editar ativos localmente. É recomendável usar a interface do usuário da Web do DAM o máximo possível, pois ela fornece uma experiência melhor. Ele oferece Adobe maior flexibilidade para atender às necessidades do cliente.
O compartilhamento de rede WebDAV/SMB1 oferece a conveniência de trabalhar com arquivos em uma janela do Explorer/Finder. No entanto, o Explorer/Finder e AEM se comunicam por uma conexão de rede que tem certas limitações. Por exemplo, o tempo gasto para copiar um arquivo de 1 GB para o diretório WebDAV/SMB montado é aproximadamente o mesmo que o tempo necessário para carregar um arquivo de 1 GB para um site usando um navegador da Web. Na verdade, no primeiro caso, a duração pode ser mais longa devido às ineficiências do protocolo WebDAV/SMB e dos clientes WebDAV/SMB do SO (especialmente Mac OS X).
Há limitações para os tipos de tarefas que podem ser executadas a partir de um diretório montado. Em geral, trabalhar com arquivos grandes, especialmente em uma conexão de rede de baixa/alta latência/largura de banda baixa, pode ser um desafio, especialmente ao editar arquivos grandes.
O Adobe recomenda que você execute alguns testes de caso de uso antes de confirmar para um cliente que certos tipos de arquivos podem ser editados no local com eficiência a partir do diretório montado.
AEM desktop não é adequado para a manipulação intensiva do sistema de arquivos, incluindo, mas não se limitando a:
Devido a limitações no sistema operacional, o Windows tem uma limitação de tamanho de arquivo de 4.294.967.295 bytes (aproximadamente 4,29 GB). É devido a uma configuração de registro que define o tamanho de um arquivo em um compartilhamento de rede. O valor da configuração do Registro é um DWORD com um tamanho máximo igual ao número referenciado.
Experience Manager o aplicativo de desktop não tem um valor de tempo limite configurável que desconecta a conexão entre o Experience Manager servidor e o aplicativo de desktop após um intervalo de tempo fixo. Ao fazer upload de ativos grandes, se a conexão expirar depois de algum tempo, o aplicativo tentativas fazer upload do ativo algumas vezes aumentando o tempo limite de upload. Não há uma maneira recomendada de alterar as configurações de tempo limite padrão.
AEM aplicativo desktop fornece recursos internos de cache e upload em segundo plano para melhorar a experiência do usuário final. Quando você salva um arquivo grande, ele é salvo localmente pela primeira vez para permitir que você continue trabalhando. Depois de algum tempo (atualmente 30 segundos), o arquivo é enviado para o servidor AEM em segundo plano.
Diferentemente das soluções de sincronização de arquivos ou Creative Cloud Desktop, como Microsoft One Drive, AEM aplicativo de desktop não é um cliente de sincronização de desktop completo. Isso acontece porque ele fornece acesso a todo o repositório AEM Assets, que pode ser extremamente grande (centenas de gigabytes ou terabytes) para uma sincronização completa.
O armazenamento em cache oferece a capacidade de limitar a sobrecarga da rede/armazenamento somente a um subconjunto de ativos relevantes para o usuário.
O Adobe recomenda desativar a geração de miniaturas para agilizar a navegação. Se você ativar pré-visualizações de ícones, o aplicativo armazenará em cache os ativos digitais quando você navegar pela pasta montada. O aplicativo também baixa ativos com os quais o usuário pode não se importar, o que adiciona carga ao servidor, consome a largura de banda do usuário e usa mais espaço em disco do usuário.
Veja como AEM aplicativo desktop executa o cache:
Todas as operações não são armazenadas em cache localmente. Os itens a seguir são transmitidos ao servidor AEM imediatamente sem o cache local:
Ao solucionar problemas de desempenho sub-otimizado para usuários individuais, consulte primeiro Limitações. As seções subsequentes incluem sugestões para melhorar o desempenho de usuários individuais.
A largura de banda disponível para um usuário individual desempenha um papel fundamental no desempenho do cliente WebDAV/SMB.
A Adobe recomenda que a velocidade de upload de um usuário individual esteja próxima a 10 Mbps. Para conexões sem fio, a largura de banda é frequentemente compartilhada entre vários usuários. Se vários usuários executarem simultaneamente tarefas que consomem largura de banda da rede, o desempenho pode diminuir ainda mais. Para evitar esses problemas, use uma conexão com fio.
Se você executar AEM no Windows, poderá configurar o Windows para melhorar o desempenho do cliente WebDAV. Para obter mais informações, acesse https://support.microsoft.com/en-us/kb/2445570.
No Windows 7, a modificação das configurações do IE pode melhorar o desempenho do WebDAV. Para obter detalhes, consulte como corrigir o desempenho lento do WebDAV no Windows 7.
Quando você interage com um arquivo localmente, AEM Desktop verifica se uma versão mais recente do arquivo está disponível no AEM. Se uma nova versão estiver disponível, o aplicativo baixa uma cópia atualizada do arquivo no cache local. No entanto, AEM desktop não substitui um arquivo em cache local se ele tiver sido modificado. Este recurso impede que seu trabalho seja substituído inadvertidamente.
Quando o mesmo arquivo é modificado localmente e no AEM, a versão modificada localmente substitui a versão no AEM. Nesse caso, a versão anterior está disponível na linha do tempo do ativo. Você pode verificar ambas as versões e resolver conflitos.
Se um arquivo local for inconsistente com a versão disponível no servidor, a caixa de diálogo de status do upload em segundo plano notificará você sobre o conflito. Para resolver o problema, abra o arquivo em conflito e salve-o. Salvar o arquivo força a área de trabalho AEM sincronizar as alterações locais mais recentes em AEM. Você pode visualização versões anteriores do ativo na linha do tempo e resolver conflitos.
Você deve levar em conta fatores adicionais quando vários usuários tentarem trabalhar em diretórios montados separados direcionando a mesma instância AEM. Em particular, são importantes os seguintes fatores:
Se o desempenho do WebDAV/SMB diminuir drasticamente quando vários usuários trabalham simultaneamente, você pode configurar algumas coisas no AEM, o que pode ajudar a melhorar o desempenho.
Você pode melhorar o desempenho no lado da AEM, habilitando workflows transitórios para o fluxo de trabalho do Ativo de atualização do DAM. Habilitar workflows transitórios reduz o poder de processamento necessário para atualizar ativos quando eles são criados ou modificados em AEM.
/miscadmin
na instância AEM a ser configurada (por exemplo, http://[Server]:[Port]/miscadmin
).Outro método para melhorar o desempenho AEM é configurar o valor máximo de trabalhos paralelos para o trabalho da Fila de Fluxo de Trabalho Transitório Granite. O valor recomendado é aproximadamente a metade do número da CPU disponível com o servidor. Para ajustar o valor, execute estas etapas:
http://[aem_server]:[port]/system/console/configMgr
).Devido às limitações de largura de banda da rede, o desempenho do WebDAV/SMB pode diminuir quando vários usuários trabalham simultaneamente. O Adobe recomenda aumentar o tamanho da instância AWS para uma instância de AEM de público alvo executada no AWS para melhorar o desempenho do WebDAV/SMB.
Essa medida aumenta especificamente a quantidade de largura de banda de rede disponível para o servidor. Estes são alguns detalhes:
Há algumas limitações conhecidas na maneira como você pode interagir com arquivos com check-out por meio do Explorer/Finder. Se for dada saída de um arquivo, ele deverá ser somente leitura para qualquer pessoa, exceto o usuário que tiver feito check-out do arquivo. A implementação do protocolo WebDAV/SMB1 no AEM aplica esta regra. No entanto, os clientes WebDAV/SMB do SO geralmente não interagem normalmente com arquivos com check-out. Algumas esquisitices estão descritas abaixo.
Ao gravar em um arquivo com check-out, o bloqueio é aplicado somente AEM implementação WebDAV. Consequentemente, o bloqueio só é imposto por clientes que usam o WebDAV, como o aplicativo de desktop. O bloqueio não é imposto por meio AEM interface da Web. A interface AEM apenas exibe um ícone de cadeado na visualização do cartão para os ativos com check-out. O ícone é cosmético e não tem efeito no comportamento da AEM.
Em geral, os clientes WebDAV nem sempre se comportam como esperado. Pode haver outros problemas. No entanto, atualizar ou verificar o ativo em AEM é uma maneira sólida de verificar se um ativo não está sendo modificado. Esse comportamento é típico do OS WebDAV, que não está sob controle do Adobe.
A exclusão de um arquivo parece ter êxito porque ele desaparece do explorador de arquivos no Windows. No entanto, atualizar o diretório e fazer check-in AEM ativos mostra que o arquivo ainda está presente. Além disso, a edição de arquivos parece ter êxito (nenhuma caixa de diálogo de aviso ou mensagem de erro é exibida). No entanto, reabrir o arquivo ou fazer check-in AEM ativos revela que o arquivo permanece inalterado.
A substituição de um arquivo não exibe um aviso ou erro, mas a verificação do ativo no AEM revela que ele permanece inalterado. Atualize ou verifique o ativo no AEM para verificar se ele não está sendo modificado.
Depois de instalar o aplicativo de desktop, o ícone de menu do aplicativo de desktop aparece na barra de menus. Se o ícone não for exibido, execute estas etapas para resolver o problema:
Abra a janela do terminal do sistema operacional.
Digite o seguinte comando no prompt de comando e pressione Enter:
cd ../Library/Caches.
Digite o seguinte comando e pressione Enter:
rm -r com.adobe.aem.assetscompanion
Digite o seguinte comando e pressione Enter:
cd ~/Library/Preferences
Digite o seguinte comando e pressione Enter:
rm com.adobe.aem.assetscompanion.plist
Digite o seguinte comando e pressione Enter:
rm ~/Library/Group\ Containers/group.com.adobe.aem.desktop/*
Reinicie o sistema.
AEM desktop tenta sincronizar qualquer arquivo três vezes. Se o arquivo falhar na sincronização após a terceira tentativa, AEM Desktop considerará o arquivo em conflito e o notificará por meio da janela de status do upload em segundo plano. Um estado de conflito indica que suas alterações mais recentes ainda estão disponíveis localmente, mas não são sincronizadas de volta para AEM. AEM aplicativo de desktop não tenta mais sincronizar.
A maneira mais simples de corrigir essa situação é abrir o arquivo em conflito e salvá-lo novamente. Ela força AEM desktop a tentar a sincronização por mais três ocasiões. Se o arquivo ainda falhar na sincronização, consulte as seções abaixo para obter mais ajuda.
Limpar AEM cache da área de trabalho é uma tarefa preliminar de solução de problemas que pode resolver vários problemas AEM da área de trabalho.
Você pode limpar o cache excluindo o diretório de cache do aplicativo nos seguintes locais.
No Windows, %LocalAppData%\Adobe\AssetsCompanion\Cache\
No Mac, ~/Library/Group/Containers/group.com.adobe.aem.desktop/cache/
No entanto, o local pode mudar dependendo do ponto final AEM da área de trabalho configurado AEM. O valor é uma versão codificada do URL direcionado. Por exemplo, se o aplicativo estiver direcionando http://localhost:4502
, o nome do diretório será http%3A%2F%2Flocalhost%3A4502%2F
.
Para limpar o cache, exclua o diretório <Encoded AEM Endpoint>.
Se você limpar AEM cache da área de trabalho, as alterações de arquivo local que não são sincronizadas com AEM serão perdidas.
A partir AEM aplicativo de desktop versão 1.5, há uma opção na interface do usuário do aplicativo de desktop para limpar o cache.
O procedimento para determinar a versão da área de trabalho AEM é o mesmo para Windows e Mac OS.
Clique no ícone AEM área de trabalho e escolha Sobre. O número da versão é exibido na tela.
Ocasionalmente, podem ocorrer problemas ao atualizar AEM aplicativo desktop no macOS. Isso é causado pela pasta herdada do sistema para AEM aplicativo de desktop que impede que novas versões AEM desktop sejam carregadas corretamente. Para resolver esse problema, as pastas e os arquivos a seguir podem ser removidos manualmente.
Antes de executar as etapas abaixo, arraste o aplicativo "Adobe Experience Manager Desktop" da pasta Aplicativos macOS para a lixeira. Em seguida, abra o terminal e execute o seguinte comando, fornecendo sua senha quando solicitado.
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
As limitações técnicas do sistema operacional impedem que os usuários tenham uma experiência consistente ao tentar substituir um arquivo cujo check-out foi feito por outras pessoas. A experiência varia dependendo do aplicativo usado para editar o arquivo com check-out. Às vezes, o aplicativo exibe uma mensagem de erro indicando uma falha de gravação de disco ou um erro aparentemente não relacionado ou genérico. Em outras ocasiões, nenhuma mensagem de erro é exibida e a operação parece ter êxito.
Nesse caso, fechar e reabrir o arquivo pode revelar que o conteúdo não é alterado. No entanto, alguns aplicativos podem armazenar um backup do arquivo para que suas alterações possam ser aplicadas.
Independentemente do comportamento, o arquivo permanece inalterado quando você faz o check-in. Mesmo se uma versão diferente do arquivo for exibida, as alterações não serão sincronizadas para AEM.
A API do servidor requer cabeçalhos adicionais, Destino X, Profundidade X e Substituição X para que as operações de movimentação e cópia funcionem. O dispatcher não passa esses cabeçalhos por padrão, o que resulta em falha dessas operações. Para obter mais informações, consulte Conexão com AEM atrás de um Dispatcher.
O motivo mais comum para problemas com a área de trabalho AEM se conectando à sua instância de AEM ativada por SSO (SAML) é que o processo SAML não redireciona para o caminho solicitado originalmente. Como alternativa, a conexão pode ser redirecionada para um host que não está configurado AEM área de trabalho. Execute estas etapas para verificar o processo de logon:
/content/dam.json
.http://localhost:4502/content/dam.json
./content/dam.json
corresponde ao valor AEM do público alvo configurado na área de trabalho AEM.As bibliotecas que AEM aplicativo de desktop usa para comunicação HTTP utilizam imposição rigorosa de SSL. Às vezes, uma conexão pode ser bem-sucedida usando um navegador, mas falha ao usar AEM aplicativo de desktop. Para configurar o SSL adequadamente, instale o certificado intermediário ausente no Apache. Consulte Como instalar um certificado CA intermediário no Apache.
AEM desktop trabalha com implantações AEM atrás de um dispatcher, que é uma configuração padrão e recomendada para AEM servidores. AEM despachantes na frente dos ambientes de criação AEM geralmente são configurados para ignorar o armazenamento em cache de ativos DAM. Portanto, os despachantes não fornecem armazenamento em cache adicional do ponto de vista da área de trabalho AEM. Verifique se a configuração do dispatcher está ajustada para funcionar AEM desktop. Para obter mais detalhes, consulte Ligar a AEM atrás de um dispatcher.
Dependendo do sistema operacional, você pode encontrar os arquivos de registro para AEM desktop nos seguintes locais:
%LocalAppData%\Adobe\AssetsCompanion\Logs
~/Library/Logs/Adobe\ Experience\ Manager\ Desktop