Solucionar problemas do Adobe Experience Manager aplicativo de desktop v1.x

Solucione problemas do aplicativo de desktop do AEM para resolver problemas ocasionais relacionados à instalação, atualização, configuração e assim por diante.

Adobe Experience Manager o aplicativo de desktop inclui utilitários que ajudam a mapear o repositório do 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 fizessem parte de um sistema de arquivos local do computador. No caso de um aplicativo de desktop, a estrutura de repositório DAM (Digital Asset Management, gerenciamento de ativos digitais) de uma instância remota do AEM é direcionada como a fonte de arquivos remota. O diagrama a seguir descreve a topologia do aplicativo de desktop:

Com essa arquitetura, o aplicativo de desktop intercepta chamadas do sistema de arquivos (abrir, fechar, ler, gravar e assim por diante) para o compartilhamento de rede montado e as transforma em chamadas HTTP AEM nativas para o servidor AEM. Os arquivos são armazenados em cache localmente. Para obter mais detalhes, consulte Usar o aplicativo de desktop do AEM v1.x.

Visão geral do componente de aplicativo de desktop do AEM

o aplicativo de desktop inclui os seguintes componentes:

• O aplicativo de desktop: O aplicativo monta ou desmonta o DAM como um sistema de arquivos remoto e traduz chamadas do sistema de arquivos entre o compartilhamento de rede montado localmente e a instância remota do AEM à qual ele se conecta.
• Sistema operacional Cliente WebDAV/SMB: Gerencia a comunicação entre o Windows Explorer/Finder e o aplicativo de desktop. Se um arquivo for recuperado, criado, modificado, excluído, movido ou copiado, o cliente WebDAV/SMB do sistema operacional (OS) comunicará essa operação ao aplicativo de desktop. Depois de receber a comunicação, o aplicativo de desktop a converte em chamadas de API remotas do AEM nativas. Por exemplo, se um usuário cria um arquivo no diretório montado, o cliente WebDAV/SMB inicia uma solicitação, que o aplicativo de desktop converte em uma solicitação HTTP que cria o arquivo no DAM. O cliente WebDAV/SMB é um componente incorporado do SO. Ele não é afiliado a aplicativos de desktop, AEM ou Adobe de nenhuma maneira.
• Instância do Adobe Experience Manager: Fornece acesso aos ativos armazenados no repositório DAM do AEM Assets. Além disso, ele executa ações solicitadas pelo aplicativo de desktop em nome dos aplicativos de desktop locais que interagem com o compartilhamento de rede montado. A instância do AEM de destino deve executar o AEM versão 6.1 ou superior. As instâncias do AEM que executam versões anteriores do AEM podem exigir pacotes de recursos extras e hotfixes instalados para se tornarem totalmente funcionais.

Casos de uso pretendidos para o aplicativo de desktop do AEM

O aplicativo de desktop do AEM usa a tecnologia de compartilhamento de rede para mapear um repositório remoto do AEM para um desktop local. No entanto, não se destina a substituir um compartilhamento de rede que contém ativos, no qual os usuários executam operações de gerenciamento de ativos digitais diretamente do desktop local. Isso inclui mover ou copiar vários arquivos ou arrastar grandes estruturas de pasta para o compartilhamento de rede do AEM Assets diretamente no Finder/Explorer.

O aplicativo de desktop do AEM fornece uma maneira conveniente de acessar (abrir) e editar (salvar) ativos DAM entre a interface do usuário de toque do AEM Assets e o desktop local. Ele vincula ativos no servidor do AEM Assets aos fluxos de trabalho baseados em desktop.

O exemplo de uso a seguir ilustra como o AEM Desktop deve ser usado:

• Um usuário faz logon no AEM e usa a interface do usuário da Web para localizar um ativo.
• Usando os recursos de ação da área de trabalho da interface do usuário da Web do AEM, o usuário abre, exibe ou edita o ativo na área de trabalho, conforme necessário.
• O AEM Desktop abre o ativo no editor padrão para o tipo de arquivo do ativo.
• O usuário faz as alterações desejadas no ativo.
• Depois que um arquivo é modificado, o usuário pode exibir o status de sincronização do arquivo usando a janela de status de sincronização em segundo plano do AEM Desktop.
• Usando o menu de contexto do AEM Desktop, o usuário faz o check-in/out do ativo ou retorna à interface do usuário do DAM.
• Após concluir as alterações no arquivo, o usuário retorna à interface do usuário da Web do AEM

Esse não é o único caso de uso. No entanto, isso ilustra como o AEM Desktop é um mecanismo conveniente para acessar/editar ativos localmente. Você é incentivado a usar a interface do usuário da Web do DAM o máximo possível, pois ela fornece uma experiência melhor. Ela oferece à Adobe mais flexibilidade para atender às necessidades do cliente.

Limitações

O compartilhamento de rede WebDAV/SMB1 oferece a conveniência de trabalhar com arquivos em uma janela Explorer/Finder. No entanto, o Explorer/Finder e o AEM se comunicam por meio de uma conexão de rede que tem determinadas 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 em um site usando um navegador da Web. Na verdade, no primeiro caso, a duração pode ser maior devido às ineficiências do protocolo WebDAV/SMB e dos clientes WebDAV/SMB do sistema operacional (especialmente Mac OS X).

Existem 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 por uma conexão de rede de baixa/alta latência/largura de banda baixa, pode ser um desafio, especialmente ao editar arquivos grandes.

A Adobe recomenda que você execute algum teste 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.

O AEM Desktop não é adequado para executar a manipulação intensiva do sistema de arquivos, incluindo, mas não se limita a:

• Mover ou copiar arquivos e diretórios
• Adicionar muitos ativos ao AEM
• Procurando e abrindo arquivos pelo sistema de arquivos, exceto por pastas de navegação
• Compactação ou descompactação de arquivos

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 que um arquivo em um compartilhamento de rede pode ter. O valor da configuração do Registro é um DWORD com um tamanho máximo que é 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 um tempo, o aplicativo tenta 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.

Armazenamento em cache e comunicação com o AEM

O aplicativo de desktop do AEM fornece recursos internos de cache e upload em segundo plano para melhorar a experiência do usuário final. Ao salvar 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 ao servidor AEM em segundo plano.

Ao contrário da Creative Cloud Desktop ou de outras soluções de sincronização de arquivos, como Microsoft One Drive, o aplicativo de desktop AEM não é um cliente completo de Sincronização de desktop. O motivo é que ele fornece acesso a todo o repositório do AEM Assets, que pode ser extremamente grande (centenas de gigabytes ou terabytes) para uma sincronização completa.

O armazenamento em cache fornece a capacidade de limitar a sobrecarga da rede/armazenamento somente a um subconjunto de ativos relevantes para o usuário.

Veja como o aplicativo de desktop do AEM executa o cache:

• Quando você abre uma pasta no Finder e miniaturas/visualizações de arquivos são exibidas, ou quando você abre um arquivo em um aplicativo, o aplicativo de desktop armazena em cache o binário de arquivo.
• Ao armazenar arquivos por meio do Finder ou de outros aplicativos de desktop, o arquivo é armazenado localmente primeiro (em cache) e o sistema operacional é notificado. O arquivo é então colocado na fila para upload no servidor em segundo plano e, eventualmente, carregado pela rede. No caso de um erro de rede, o aplicativo de desktop tenta fazer upload do arquivo inteiro por no máximo três vezes. Se ocorrer uma falha no upload após três tentativas, o arquivo é marcado como um arquivo em conflito e o status é exibido por meio da janela Status da fila de upload em segundo plano . o aplicativo de desktop não tenta mais atualizar o arquivo. O usuário deve atualizar o arquivo e fazer o upload novamente após a restauração da conectividade

Cada operação não é armazenada em cache localmente. Os itens a seguir são transmitidos ao AEM Server imediatamente sem armazenamento em cache local:

• Qualquer operação em pastas, por exemplo, criar, excluir e assim por diante
• O recurso Carregamento de pasta introduzido na versão 1.4 carrega uma hierarquia de pasta local, sem armazenar os arquivos em cache localmente

Operações individuais

Ao solucionar problemas de desempenho sub-otimizado para usuários individuais, revise primeiro as limitações do aplicativo. As seções subsequentes incluem sugestões para melhorar o desempenho de cada usuário.

Recomendações de largura de banda

A largura de banda disponível para um usuário individual desempenha um papel crítico no desempenho do cliente WebDAV/SMB.

A Adobe recomenda que a velocidade de upload de um usuário individual seja 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 degradar-se ainda mais. Para evitar esses problemas, use uma conexão com fio.

Configurações específicas do Windows

Se você usar o Experience Manager 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.

Operações simultâneas

Quando você interage com um arquivo localmente, o 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 baixará uma cópia nova do arquivo para o cache local. No entanto, o AEM Desktop não substitui um arquivo armazenado em cache localmente se ele tiver sido modificado. Esse 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 qualquer conflito.

Se um arquivo local estiver inconsistente com a versão disponível no servidor, a caixa de diálogo de status do upload em segundo plano o notificará sobre o conflito. Para resolver o problema, abra o arquivo em conflito e salve-o. Salvar o arquivo força o AEM Desktop a sincronizar as alterações locais mais recentes no AEM. É possível exibir versões anteriores do ativo na linha do tempo e resolver conflitos.

Você deve considerar fatores adicionais quando vários usuários tentarem trabalhar em diretórios montados separados direcionando a mesma instância do AEM. Em particular, os seguintes fatores são importantes:

• A quantidade de largura de banda disponível na rede de origem dos usuários
• Configuração de rede, como firewalls ou proxies, da rede de origem
• Quantidade de largura de banda disponível na rede da instância do AEM de destino
• Se um dispatcher está presente antes da instância do AEM de destino
• Carga atual na instância do AEM de destino

Configurações adicionais do AEM

Se o desempenho do WebDAV/SMB se degrada drasticamente quando vários usuários trabalham simultaneamente, você pode configurar algumas coisas no AEM, o que pode ajudar a melhorar o desempenho.

Atualizar fluxos de trabalho transitórios de ativos

Você pode melhorar o desempenho no lado do AEM ativando fluxos de trabalho transitórios para o fluxo de trabalho do Ativo de atualização DAM . Habilitar workflows transitórios reduz o poder de processamento necessário para atualizar ativos quando eles são criados ou modificados no AEM.

1. Navegue até /miscadmin na instância do AEM a ser configurada (por exemplo, http://[Server]:[Port]/miscadmin).
2. Na árvore de navegação, expanda Ferramentas > Fluxo de trabalho > Modelos > dam.
3. Clique duas vezes em Ativo de atualização do DAM.
4. No painel de ferramentas flutuantes, alterne para a guia Page e clique em Page Properties.
5. Marque a caixa de seleção Transient Workflow e clique em OK.

Ajustar fila de Fluxo de trabalho transitório do Granite

Outro método para melhorar o desempenho do AEM é configurar o valor máximo de trabalhos paralelos para o trabalho da fila de fluxo de trabalho transitório do Granite. O valor recomendado é aproximadamente metade do número da CPU disponível com o servidor. Para ajustar o valor, execute estas etapas:

1. Navegue até /system/console/configMgr na instância do AEM a ser configurada (por exemplo, http://[aem_server]:[port]/system/console/configMgr).
2. Procure por QueueConfiguration e clique para abrir cada tarefa até localizar o trabalho Granite Transient Workflow Queue. Clique na opção Edit ao lado dela.
3. Altere o valor Máximo de Trabalhos Paralelos e clique em Salvar.

Configuração AWS

Devido às limitações da largura de banda da rede, o desempenho do WebDAV/SMB pode degradar-se quando vários usuários trabalham simultaneamente. A Adobe recomenda aumentar o tamanho da instância do AWS para uma instância do AEM de destino executada no AWS para aprimorar o desempenho do WebDAV/SMB.

Essa medida aumenta especificamente a quantidade de largura de banda de rede disponível para o servidor. Veja alguns detalhes:

• A quantidade de largura de banda de rede dedicada a uma instância AWS aumenta à medida que o tamanho da instância aumenta. Para obter informações sobre a largura de banda disponível para cada tamanho de instância, consulte a documentação AWS.
• Ao solucionar problemas para um cliente grande, a Adobe configurou o tamanho de sua instância do AEM para c4.8xlarge, principalmente para os 4000 Mbps de largura de banda dedicada que ela fornece.
• Se houver um dispatcher antes da instância do AEM, verifique se ele tem o tamanho apropriado. Se a instância do AEM fornece 4000 Mbps, mas o dispatcher fornece apenas 500 Mbps, a largura de banda efetiva é de apenas 500 Mbps. Isso ocorre porque o dispatcher cria um gargalo de rede.

Limitações de arquivo com check-out

Há algumas limitações conhecidas na maneira de interagir com arquivos com check-out por meio do Explorer/Finder. Se for feito check-out de um arquivo, ele deverá ser somente leitura para qualquer pessoa, exceto o usuário que tiver o arquivo com check-out. A implementação do protocolo WebDAV/SMB1 no AEM aplica essa regra. No entanto, os clientes OS WebDAV/SMB geralmente não interagem normalmente com os arquivos com check-out. Algumas chances estão descritas abaixo.

Geral

Ao gravar em um arquivo com check-out, o bloqueio é aplicado somente na implementação do AEM WebDAV. Consequentemente, o bloqueio é imposto apenas por clientes que usam o WebDAV, como aplicativos de desktop. O bloqueio não é imposto por meio da interface da Web do AEM. A interface do AEM apenas exibe um ícone de cadeado na exibição de cartão para ativos com check-out. O ícone é cosmético e não tem efeito no comportamento do AEM.

Em geral, os clientes WebDAV nem sempre se comportam como esperado. Pode haver outros problemas. No entanto, atualizar ou verificar o ativo no AEM é uma maneira sólida de verificar se um ativo não está sendo modificado. Esse comportamento é típico dos clientes do OS WebDAV, que não está sob o controle da Adobe.

Windows

A eliminação de um ficheiro parece ter êxito porque o ficheiro desaparece do explorador de ficheiros no Windows. No entanto, atualizar o diretório e verificar no AEM Assets 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 verificar os ativos AEM revela que o arquivo permanece inalterado.

Mac OS X

Substituir um arquivo não exibe um aviso ou erro, mas verificar o ativo no AEM revela que ele permanece inalterado. Atualize ou verifique o ativo no AEM para verificar se ele não está sendo modificado.

Solução de problemas do ícone do aplicativo de desktop (Mac OS X)

Depois de instalar o aplicativo de desktop, o ícone do menu do aplicativo de desktop aparece na barra de menus. Se o ícone não for exibido, execute estas etapas para resolver o problema:

1. Abra a janela do terminal do sistema operacional.

2. Digite o seguinte comando no prompt de comando e pressione Enter:

    cd ../Library/Caches.
   

3. Digite o seguinte comando e pressione Enter:

   rm -r com.adobe.aem.assetscompanion
   

4. Digite o seguinte comando e pressione Enter:

   cd ~/Library/Preferences
   

5. Digite o seguinte comando e pressione Enter:

   rm com.adobe.aem.assetscompanion.plist
   

6. Digite o seguinte comando e pressione Enter:

   rm ~/Library/Group\ Containers/group.com.adobe.aem.desktop/*
   

7. Reinicie o sistema.

O AEM Desktop tenta sincronizar qualquer arquivo específico três vezes. Se o arquivo não for sincronizado após a terceira tentativa, o 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 com o AEM. O aplicativo de desktop do AEM não tenta mais sincronizar.

A maneira mais simples de corrigir essa situação é abrir o arquivo conflitante e salvá-lo novamente. Isso força o AEM Desktop a tentar a sincronização por mais três ocasiões. Se o arquivo ainda não conseguir sincronizar, consulte as seções abaixo para obter mais ajuda.

Limpando o cache do AEM Desktop

Limpar o cache do AEM Desktop é uma tarefa preliminar de solução de problemas que pode resolver vários problemas do AEM Desktop.

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, a localização pode mudar dependendo do ponto de extremidade do AEM configurado no AEM Desktop. O valor é uma versão codificada do URL de destino. 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 <Endpoint AEM codificado>.

Encontrar a versão do AEM Desktop

O procedimento para determinar a versão do AEM Desktop é o mesmo para Windows e Mac OS.

Clique no ícone do AEM Desktop e escolha Sobre. O número da versão é exibido na tela .

Atualização do aplicativo de desktop do AEM no macOS

Ocasionalmente, podem ocorrer problemas ao atualizar o aplicativo de desktop do AEM no macOS. Isso é causado pela pasta herdada do sistema para o aplicativo de desktop do AEM, impedindo que novas versões do AEM Desktop sejam carregadas corretamente. Para solucionar 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

Salvar um arquivo com check-out por outros

As limitações técnicas do sistema operacional impedem que os usuários tenham uma experiência consistente ao tentar substituir um arquivo com check-out feito por outros. 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 exibe 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 permanece inalterado. 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 ao fazer o check-in. Mesmo que uma versão diferente do arquivo seja exibida, as alterações não serão sincronizadas com o AEM.

Solução de problemas ao mover arquivos

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 faz com que essas operações falhem. Para obter mais informações, consulte Conexão com o AEM atrás de um Dispatcher.

Solução de problemas de conexão do AEM Desktop

Problema de redirecionamento do SAML

O motivo mais comum para problemas com o AEM Desktop se conectar à instância do AEM habilitada para 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 no desktop do AEM. Execute as etapas a seguir para verificar o processo de logon:

1. Abra um navegador da Web.
2. Na barra de endereços, especifique o URL /content/dam.json.
3. Substitua o URL pela instância de destino do AEM, por exemplo http://localhost:4502/content/dam.json.
4. Faça logon no AEM.
5. Depois de fazer logon, verifique o endereço atual do navegador na barra de endereços. Deve corresponder ao URL inserido inicialmente.
6. Verifique se tudo antes de /content/dam.json corresponde ao valor do AEM de destino configurado no AEM Desktop.

Problema de configuração SSL

As bibliotecas que o aplicativo de desktop do AEM usa para comunicação HTTP usam imposição estrita do SSL. Às vezes, uma conexão pode ser bem-sucedida usando um navegador, mas falha ao usar o aplicativo de desktop do AEM. Para configurar o SSL adequadamente, instale o certificado intermediário ausente no Apache. Consulte Como instalar um certificado CA intermediário no Apache.

Uso do AEM Desktop com o dispatcher

O AEM Desktop funciona com implantações do AEM atrás de um dispatcher, que é uma configuração padrão e recomendada para servidores AEM. Os AEM Dispatchers na frente de ambientes de criação do AEM normalmente são configurados para ignorar o armazenamento em cache de ativos do DAM. Portanto, os dispatchers não fornecem armazenamento em cache adicional do ponto de vista do AEM Desktop. Verifique se a configuração do dispatcher está ajustada para funcionar no AEM Desktop. Para obter detalhes adicionais, consulte Conexão com o AEM atrás de um dispatcher.

Verificando arquivos de log

Dependendo do seu sistema operacional, você pode encontrar os arquivos de log para o AEM Desktop nos seguintes locais:

• Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs
• Mac: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop