문제 해결 Adobe Experience Manager 데스크탑 앱 v1.x troubleshoot-aem-desktop-app

AEM 데스크탑 앱 문제를 해결하여 설치, 업그레이드, 구성 등과 관련하여 가끔 발생하는 문제를 해결합니다.

Adobe Experience Manager 데스크탑 앱에는 AEM Assets 저장소를 데스크탑의 네트워크 공유(Mac OS의 SMB 공유)로 매핑하는 데 도움이 되는 유틸리티가 포함되어 있습니다. 네트워크 공유는 원격 소스를 컴퓨터의 로컬 파일 시스템의 일부인 것처럼 처리할 수 있는 운영 체제 기술입니다. 데스크탑 앱의 경우 원격 AEM 인스턴스의 DAM(디지털 에셋 관리) 저장소 구조가 원격 파일 소스로 타깃팅됩니다. 다음 다이어그램은 데스크탑 앱 토폴로지에 대해 설명합니다.

데스크탑 앱 다이어그램

이 아키텍처를 사용하면 데스크탑 앱에서 마운트된 네트워크 공유에 대한 파일 시스템 호출(열기, 닫기, 읽기, 쓰기 등)을 가로채고 AEM 서버에 대한 기본 AEM HTTP 호출로 변환합니다. 파일은 로컬에서 캐시됩니다. 자세한 내용은 AEM 데스크탑 앱 v1.x 사용.

AEM 데스크탑 앱 구성 요소 개요 desktop-app-component-overview

데스크탑 앱에는 다음 구성 요소가 포함되어 있습니다.

  • 데스크탑 애플리케이션: 애플리케이션에서 DAM을 원격 파일 시스템으로 마운트 또는 마운트 해제하고 로컬로 마운트된 네트워크 공유와 연결된 원격 AEM 인스턴스 간의 파일 시스템 호출을 변환합니다.
  • 운영 체제 WebDAV/SMB 클라이언트: Windows 탐색기/Finder와 데스크탑 앱 간의 통신을 처리합니다. 파일을 검색, 생성, 수정, 삭제, 이동 또는 복사하는 경우 OS(운영 체제) WebDAV/SMB 클라이언트는 이 작업을 데스크탑 앱에 전달합니다. 통신을 수신하면 데스크탑 앱은 이를 기본 AEM 원격 API 호출로 변환합니다. 예를 들어 사용자가 마운트된 디렉터리에 파일을 만들면 WebDAV/SMB 클라이언트가 요청을 시작하며, 이 요청은 데스크탑 앱에서 DAM에 파일을 만드는 HTTP 요청으로 변환됩니다. WebDAV/SMB 클라이언트는 OS의 기본 구성 요소입니다. 어떤 식으로든 데스크탑 앱, AEM 또는 Adobe과 제휴되지 않습니다.
  • Adobe Experience Manager 인스턴스: AEM Assets DAM 저장소에 저장된 에셋에 대한 액세스 권한을 제공합니다. 또한 탑재된 네트워크 공유와 상호 작용하는 로컬 데스크탑 애플리케이션을 대신하여 데스크탑 앱에서 요청한 작업을 수행합니다. 대상 AEM 인스턴스는 AEM 버전 6.1 이상을 실행해야 합니다. 이전 AEM 버전을 실행하는 AEM 인스턴스가 제대로 작동하려면 추가 기능 팩과 핫픽스가 설치되어 있어야 할 수 있습니다.

AEM 데스크탑 앱에 대한 의도된 사용 사례 intended-use-cases-for-aem-desktop-app

AEM 데스크탑 앱은 네트워크 공유 기술을 사용하여 원격 AEM 저장소를 로컬 데스크탑에 매핑합니다. 그러나 사용자가 로컬 데스크탑에서 직접 디지털 에셋 관리 작업을 수행하는 네트워크 공유 에셋을 대체하는 것은 아닙니다. 이러한 작업에는 여러 파일을 이동 또는 복사하거나 큰 폴더 구조를 Finder/Explorer에서 직접 AEM Assets 네트워크 공유로 드래그하는 작업이 포함됩니다.

AEM 데스크탑 앱에서는 AEM Assets Touch UI와 로컬 데스크탑 간에 DAM 에셋에 액세스(열기)하고 편집(저장)하는 편리한 방법을 제공합니다. AEM Assets 서버의 에셋을 데스크탑 기반 워크플로우와 연결합니다.

다음 사용 사례는 AEM Desktop의 사용 방법을 보여줍니다.

  • 사용자가 AEM에 로그인하고 웹 UI를 사용하여 에셋을 찾습니다.
  • AEM 웹 UI의 데스크탑 작업 기능을 사용하여 사용자는 필요에 따라 데스크탑에서 자산을 열거나, 표시하거나, 편집합니다.
  • AEM Desktop은 에셋의 파일 유형에 대한 기본 편집기에서 에셋을 엽니다.
  • 사용자가 에셋을 원하는 대로 변경합니다.
  • 파일이 수정되면 사용자는 AEM Desktop의 백그라운드 동기화 상태 창을 사용하여 파일의 동기화 상태를 볼 수 있습니다.
  • AEM Desktop의 컨텍스트 메뉴를 사용하여 사용자는 에셋을 체크 인/아웃하거나 DAM 사용자 인터페이스로 돌아갑니다.
  • 파일에 대한 변경 사항을 완료한 후 사용자는 AEM 웹 UI로 돌아갑니다

이 사용 사례만 있는 것은 아닙니다. 그러나 AEM Desktop이 로컬에서 에셋에 액세스/편집하는 편리한 메커니즘인 방법을 보여 줍니다. DAM 웹 UI는 더 나은 경험을 제공하므로 가능한 한 많이 사용하는 것이 좋습니다. 고객의 요구 사항을 충족하기 위해 Adobe에게 보다 많은 유연성을 제공합니다.

제한 사항 limitations

WebDAV/SMB1 네트워크 공유는 Explorer/Finder 창에서 파일 작업을 편리하게 해 줍니다. 그러나 Explorer/Finder와 AEM은 특정 제한 사항이 있는 네트워크 연결을 통해 통신합니다. 예를 들어 마운트된 WebDAV/SMB 디렉토리에 1GB 파일을 복사하는 데 걸리는 시간은 웹 브라우저를 사용하여 웹 사이트에 1GB 파일을 업로드하는 데 필요한 시간과 거의 동일합니다. 실제로 전자의 경우 WebDAV/SMB 프로토콜과 OS의 WebDAV/SMB 클라이언트(특히, Mac OS X)의 비효율성으로 인해 지속 시간이 더 길어질 수 있다.

마운트된 디렉토리에서 수행할 수 있는 작업 유형에는 제한이 있습니다. 일반적으로 특히 낮은/높은 지연 시간/낮은 대역폭 네트워크 연결에서 대용량 파일을 사용하는 작업은 특히 대형 파일을 편집할 때 어려울 수 있습니다.

Adobe은 특정 유형의 파일을 마운트된 디렉토리에서 바로 효율적으로 편집할 수 있도록 클라이언트에 커밋하기 전에 사용 사례 테스트를 수행할 것을 권장합니다.

AEM Desktop은 다음을 포함하는 집중적인 파일 시스템 조작을 수행하는 데 적합하지 않습니다.

  • 파일 및 디렉터리 이동 또는 복사
  • AEM에 많은 에셋 추가
  • 폴더 검색을 제외하고 파일 시스템을 통해 파일 검색 및 열기
  • 파일 아카이브 압축 또는 압축 해제

운영 체제의 제한으로 인해 Windows의 파일 크기는 4,294,967,295바이트(약 4.29GB)로 제한됩니다. 네트워크 공유에서 파일의 크기를 정의하는 레지스트리 설정 때문입니다. 레지스트리 설정의 값은 최대 크기가 참조된 숫자와 같은 DWORD입니다.

Experience Manager 데스크탑 앱에는 간의 연결을 끊는 구성 가능한 시간 초과 값이 없습니다. Experience Manager 고정된 시간 간격 후의 서버 및 데스크탑 앱. 큰 에셋을 업로드할 때 잠시 후 연결이 시간 초과되면 앱은 업로드 시간 초과를 늘려 에셋 업로드를 몇 번 다시 시도합니다. 기본 시간 초과 설정을 변경하는 권장 방법은 없습니다.

AEM과의 캐싱 및 통신 caching-and-communication-with-aem

AEM 데스크탑 앱은 내부 캐싱 및 백그라운드 업로드 기능을 제공하여 최종 사용자 경험을 향상시킵니다. 대용량 파일을 저장하면 작업을 계속할 수 있도록 먼저 로컬에 저장됩니다. 잠시 후(현재 30초) 백그라운드에 있는 AEM 서버로 파일이 전송됩니다.

Microsoft One Drive와 같은 Creative Cloud 데스크톱 또는 기타 파일 동기화 솔루션과 달리 AEM 데스크톱 앱은 전체 데스크톱 동기화 클라이언트가 아닙니다. 그 이유는 전체 동기화를 위해 매우 클 수 있는(수백 기가바이트 또는 테라바이트) AEM Assets 저장소 전체에 대한 액세스를 제공하기 때문입니다.

캐싱은 네트워크/스토리지 오버헤드를 사용자와 관련된 자산의 하위 집합으로만 제한하는 기능을 제공합니다.

CAUTION
Adobe은 더 빠르게 탐색할 수 있도록 썸네일 생성을 비활성화하는 것을 권장합니다. 아이콘 미리 보기를 활성화하면 마운트된 폴더를 탐색할 때 앱이 디지털 에셋을 캐시합니다. 이 앱은 또한 사용자가 신경 쓰지 않을 수 있는 에셋을 다운로드하므로 서버에 부하를 추가하고 사용자의 대역폭을 소비하며 사용자의 디스크 공간을 더 많이 사용합니다.

AEM 데스크탑 앱에서 캐싱을 수행하는 방법은 다음과 같습니다.

  • 파인더에서 폴더를 열고 파일의 축소판/미리보기가 표시되거나 애플리케이션에서 파일을 열면 데스크탑 앱에서 파일 바이너리를 캐시합니다.
  • Finder 또는 기타 데스크톱 애플리케이션을 통해 파일을 저장하면 파일이 먼저 로컬에 저장되고(캐시됨) 운영 체제에 알림이 표시됩니다. 그런 다음 백그라운드에서 서버에 업로드하기 위해 파일이 대기열에 추가되고 결국 네트워크를 통해 업로드됩니다. 네트워크 오류가 발생한 경우 데스크탑 앱은 최대 3회 전체 파일 업로드를 다시 시도합니다. 세 번 다시 시도한 후에도 업로드가 실패하면 파일이 충돌하는 파일로 표시되고 백그라운드 업로드 큐 상태 창을 통해 상태가 표시됩니다. 데스크탑 앱은 더 이상 파일 업데이트를 시도하지 않습니다. 연결이 복원된 후 파일을 업데이트하고 다시 업로드해야 합니다

모든 작업은 로컬로 캐시되지 않습니다. 다음 내용은 로컬 캐싱 없이 AEM Server로 즉시 전송됩니다.

  • 폴더의 모든 작업(예: 만들기, 삭제 등)
  • 버전 1.4에 도입된 폴더 업로드 기능은 로컬에 파일을 캐시하지 않고 로컬 폴더 계층 구조를 업로드합니다.

개별 작업 individual-operations

개별 사용자에 대해 하위 최적화된 성능 문제를 해결할 때 먼저 다음을 검토하십시오. 앱 제한 사항. 다음 섹션에는 개별 사용자의 성능을 개선하기 위한 제안 사항이 포함되어 있습니다.

대역폭 권장 사항 bandwidth-recommendations

개별 사용자가 사용할 수 있는 대역폭은 WebDAV/SMB 클라이언트의 성능에 중요한 역할을 합니다.

Adobe은 개별 사용자의 업로드 속도가 10Mbps에 가깝도록 권장합니다. 무선 연결의 경우 대역폭은 여러 사용자 간에 공유됩니다. 여러 사용자가 동시에 네트워크 대역폭을 사용하는 작업을 수행하는 경우 성능이 더욱 저하될 수 있습니다. 이러한 문제를 방지하려면 유선 연결을 사용하십시오.

동시 작업 concurrent-operations

로컬에서 파일과 상호 작용할 때 AEM Desktop은 AEM에서 최신 버전의 파일을 사용할 수 있는지 확인합니다. 새 버전을 사용할 수 있는 경우 애플리케이션은 파일의 새 복사본을 로컬 캐시에 다운로드합니다. 그러나 AEM Desktop은 로컬로 캐시된 파일이 수정된 경우에는 덮어쓰지 않습니다. 이 기능을 사용하면 실수로 작업을 덮어쓰는 것을 방지할 수 있습니다.

동일한 파일이 로컬과 AEM 모두에서 수정되면 로컬에서 수정된 버전이 AEM의 버전을 덮어씁니다. 이 경우 자산의 타임라인에서 이전 버전을 사용할 수 있습니다. 두 버전을 모두 확인하고 충돌을 해결할 수 있습니다.

로컬 파일이 서버에서 사용할 수 있는 버전과 일치하지 않으면 백그라운드 업로드 상태 대화 상자에서 충돌에 대해 알립니다. 이 문제를 해결하려면 충돌하는 파일을 열고 저장합니다. 파일을 저장하면 AEM Desktop이 최신 로컬 변경 사항을 AEM에 동기화합니다. 타임라인에서 자산의 이전 버전을 보고 충돌을 해결할 수 있습니다.

여러 사용자가 동일한 AEM 인스턴스를 대상으로 하는 별도의 마운트된 디렉토리에서 작업을 시도할 때 추가 요소를 고려해야 합니다. 특히 다음과 같은 요소가 중요합니다.

  • 사용자의 원래 네트워크에서 사용할 수 있는 대역폭의 양
  • 원래 네트워크의 방화벽 또는 프록시 등 네트워크 구성
  • 대상 AEM 인스턴스의 네트워크에서 사용할 수 있는 대역폭 양
  • Dispatcher가 대상 AEM 인스턴스 앞에 있는지 여부
  • 대상 AEM 인스턴스의 현재 로드

추가 AEM 구성 additional-aem-configurations

여러 사용자가 동시에 작업할 때 WebDAV/SMB 성능이 크게 저하되면 AEM에서 몇 가지 사항을 구성할 수 있으므로 성능 향상에 도움이 됩니다.

자산 임시 워크플로우 업데이트 update-asset-transient-workflows

DAM 자산 업데이트 워크플로우에 대한 임시 워크플로우를 활성화하여 AEM 측의 성능을 향상시킬 수 있습니다. 임시 워크플로우를 활성화하면 AEM에서 에셋을 만들거나 수정할 때 에셋을 업데이트하는 데 필요한 처리 능력을 줄일 수 있습니다.

  1. 다음으로 이동 /miscadmin Experience Manager 인스턴스(https://[aem_server]:[port]/miscadmin).
  2. From the navigation tree, expand Tools > Workflow > Models > dam.
  3. 두 번 클릭 DAM 자산 업데이트.
  4. 부동 도구 패널에서 페이지 tab을 누른 다음 페이지 속성.
  5. 다음 항목 선택 임시 워크플로우 확인란을 선택하고 확인.

Granite Transient 워크플로 큐 조정 adjust-granite-transient-workflow-queue

AEM 성능을 개선하기 위한 또 다른 방법은 Granite Transient 워크플로 큐 작업에 대한 최대 병렬 작업의 값을 구성하는 것입니다. 권장 값은 서버에서 사용할 수 있는 CPU 수의 약 절반입니다. 값을 조정하려면 다음 단계를 수행하십시오.

  1. 다음으로 이동 /system/console/configMgr 구성할 AEM 인스턴스(예: https://[aem_server]:[port]/system/console/configMgr).
  2. 검색 대상 QueueConfiguration를 클릭하고 다음을 찾을 때까지 각 작업을 엽니다. Granite Transient 워크플로 큐 작업 및 클릭 편집.
  3. 변경 Maximum Parallel Jobs 값 및 클릭 저장.

AWS 구성 aws-configuration

네트워크 대역폭 제한으로 인해 여러 사용자가 동시에 작업할 때 WebDAV/SMB의 성능이 저하될 수 있습니다. Adobe은 WebDAV/SMB의 성능을 향상시키기 위해 AWS에서 실행되는 대상 AEM 인스턴스의 AWS 인스턴스 크기를 늘릴 것을 권장합니다.

이 조치는 서버에서 사용할 수 있는 네트워크 대역폭의 양을 구체적으로 증가시킵니다. 다음은 몇 가지 세부 정보입니다.

  • AWS 인스턴스 전용 네트워크 대역폭의 양은 인스턴스 크기가 증가할수록 증가합니다. 각 인스턴스 크기에 사용할 수 있는 대역폭에 대한 자세한 내용은 AWS 설명서.
  • 대규모 클라이언트에 대한 문제 해결 시 Adobe은 AEM 인스턴스의 크기를 기본적으로 제공되는 전용 대역폭 4000Mbps에 대해 c4.8xlarge로 구성했습니다.
  • AEM 인스턴스 앞에 Dispatcher가 있는 경우 적절한 크기인지 확인하십시오. AEM 인스턴스가 4000Mbps를 제공하지만 Dispatcher가 500Mbps만 제공하는 경우 유효 대역폭은 500Mbps에 불과합니다. Dispatcher가 네트워크 병목 현상을 만들기 때문입니다.

체크 아웃된 파일 제한 사항 checked-out-file-limitations

Explorer/Finder를 통해 체크 아웃된 파일과 상호 작용하는 방법에는 몇 가지 알려진 제한 사항이 있습니다. 파일을 체크 아웃한 경우 파일을 체크 아웃한 사용자를 제외한 모든 사용자가 읽기 전용으로 설정해야 합니다. AEM에서 WebDAV/SMB1 프로토콜을 구현하면 이 규칙이 적용됩니다. 그러나 OS WebDAV/SMB 클라이언트는 체크 아웃된 파일과 정상적으로 상호 작용하지 않는 경우가 많습니다. 몇 가지 이상한 점은 아래에 설명되어 있습니다.

일반 general

체크 아웃된 파일에 쓸 때 잠금은 AEM WebDAV 구현 내에서만 적용됩니다. 따라서 잠금은 데스크톱 앱과 같이 WebDAV를 사용하는 클라이언트에서만 적용됩니다. 잠금은 AEM 웹 인터페이스를 통해 강제 적용되지 않습니다. AEM 인터페이스는 체크 아웃된 에셋에 대한 카드 보기에 잠금 아이콘을 표시할 뿐입니다. 아이콘은 표시용이며 AEM의 비헤이비어에 영향을 주지 않습니다.

일반적으로 WebDAV 클라이언트가 항상 예상대로 동작하지 않습니다. 추가 문제가 있을 수 있습니다. 그러나 AEM에서 에셋을 새로 고치거나 확인하는 것은 에셋이 수정되고 있지 않은지 확인하는 좋은 방법입니다. 이 동작은 일반적으로 Adobe이 제어하지 않는 OS WebDAV 클라이언트입니다.

Windows windows

Windows의 파일 탐색기에서 파일이 사라지므로 파일을 삭제하면 성공한 것으로 나타납니다. 그러나 디렉터리를 새로 고치고 AEM assets를 체크인하면 파일이 여전히 있음을 보여 줍니다. 또한 파일을 편집해도 문제가 없는 것으로 나타납니다(경고 대화 상자나 오류 메시지가 표시되지 않음). 그러나 파일을 다시 열거나 AEM assets에서 체크인하면 파일이 변경되지 않은 것으로 표시됩니다.

Mac mac-os-x

파일을 바꾸면 경고나 오류가 표시되지 않지만 AEM에서 에셋을 확인하면 변경되지 않은 상태로 유지됩니다. AEM에서 자산을 새로 고치거나 확인하여 수정되지 않았는지 확인합니다.

데스크탑 앱 아이콘 문제 해결(Mac OS X) troubleshooting-desktop-app-icon-issues-mac-os-x

데스크탑 앱을 설치하면 메뉴 모음에 데스크탑 앱 메뉴 아이콘이 나타납니다. 아이콘이 나타나지 않으면 다음 단계를 수행하여 문제를 해결합니다.

  1. 운영 체제 터미널 창을 엽니다.

  2. 명령 프롬프트에서 다음 명령을 입력한 다음 Enter 키를 누릅니다.

    code language-shell
     cd ../Library/Caches.
    
  3. 다음 명령을 입력하고 Enter 키를 누릅니다.

    code language-shell
    rm -r com.adobe.aem.assetscompanion
    
  4. 다음 명령을 입력하고 Enter 키를 누릅니다.

    code language-shell
    cd ~/Library/Preferences
    
  5. 다음 명령을 입력하고 Enter 키를 누릅니다.

    code language-shell
    rm com.adobe.aem.assetscompanion.plist
    
  6. 다음 명령을 입력하고 Enter 키를 누릅니다.

    code language-shell
    rm ~/Library/Group\ Containers/group.com.adobe.aem.desktop/*
    
  7. 시스템을 다시 시작합니다.

AEM Desktop은 주어진 파일을 세 번 동기화하려고 시도합니다. 세 번째 시도 후 파일이 동기화되지 않으면 AEM Desktop은 파일이 충돌하는 것으로 간주하고 백그라운드 업로드 상태 창을 통해 사용자에게 알립니다. 충돌 상태는 최신 변경 사항을 로컬에서 계속 사용할 수 있지만 AEM에 다시 동기화되지 않음을 나타냅니다. AEM 데스크탑 앱은 더 이상 동기화를 시도하지 않습니다.

이 상황을 해결하는 가장 간단한 방법은 충돌하는 파일을 열고 다시 저장하는 것입니다. AEM Desktop이 추가로 세 번 동기화를 시도하도록 합니다. 파일이 여전히 동기화되지 않는 경우 아래 섹션에서 자세한 내용을 참조하십시오.

AEM 데스크톱 캐시를 지우는 중 clearing-aem-desktop-cache

AEM Desktop의 캐시 지우기는 몇 가지 AEM Desktop 문제를 해결할 수 있는 사전 문제 해결 작업입니다.

다음 위치에서 응용 프로그램의 캐시 디렉터리를 삭제하여 캐시를 지울 수 있습니다.
Windows에서는 %LocalAppData%\Adobe\AssetsCompanion\Cache\

Mac, ~/Library/Group/Containers/group.com.adobe.aem.desktop/cache/

그러나 AEM Desktop의 구성된 AEM 끝점에 따라 위치가 변경될 수 있습니다. 값은 타겟팅된 URL의 인코딩된 버전입니다. 예를 들어 애플리케이션이 타겟팅하는 경우 http://localhost:4502, 디렉터리 이름은 입니다. http%3A%2F%2Flocalhost%3A4502%2F.

캐시를 지우려면 <encoded aem="" endpoint=""> 디렉토리.

NOTE
AEM Desktop 캐시를 지우면 AEM에 동기화되지 않은 로컬 파일 변경 내용이 손실됩니다.
NOTE
AEM 데스크탑 앱 버전 1.5부터 데스크탑 앱 UI에는 캐시를 지우는 옵션이 있습니다.

AEM Desktop 버전 찾기 finding-the-aem-desktop-version

AEM Desktop 버전을 확인하는 절차는 Windows 및 Mac OS에서 동일합니다.

AEM Desktop 아이콘을 클릭한 다음 정보. 버전 번호가 화면에 표시됩니다.

macOS에서 AEM 데스크탑 앱 업그레이드 upgrading-aem-desktop-app-on-macos

macOS에서 AEM 데스크탑 앱을 업그레이드할 때 가끔 문제가 발생할 수 있습니다. 이는 AEM Desktop 앱용 레거시 시스템 폴더로 인해 새 버전의 AEM Desktop이 올바르게 로드되지 않았기 때문입니다. 이 문제를 해결하기 위해 다음 폴더 및 파일을 수동으로 제거할 수 있습니다.

아래 단계를 실행하기 전에 "Adobe Experience Manager 데스크탑" 애플리케이션을 macOS 애플리케이션 폴더에서 휴지통으로 드래그합니다. 그런 다음 터미널을 열고 다음 명령을 실행하여 메시지가 표시되면 암호를 제공합니다.

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

다른 사용자가 체크 아웃한 파일 저장 saving-a-file-checked-out-by-others

운영 체제의 기술적 한계로 인해 다른 사용자가 체크 아웃한 파일을 덮어쓰려고 할 때 사용자가 일관된 경험을 하지 못할 수 있습니다. 경험은 체크 아웃된 파일을 편집하는 데 사용되는 애플리케이션에 따라 달라집니다. 때때로 애플리케이션은 디스크 쓰기 실패를 나타내는 오류 메시지를 표시하거나 관련이 없는 것처럼 보이거나 일반적인 오류를 표시합니다. 다른 경우에는 오류 메시지가 표시되지 않고 작업이 성공한 것으로 나타납니다.

이 경우 파일을 닫았다가 다시 열면 콘텐츠가 변경되지 않음을 나타낼 수 있습니다. 그러나 일부 애플리케이션은 변경 사항을 적용할 수 있도록 파일의 백업을 저장할 수 있습니다.

동작에 관계없이 파일을 체크 인할 때 변경되지 않은 상태로 유지됩니다. 다른 버전의 파일이 표시되더라도 변경 사항이 AEM에 동기화되지 않습니다.

파일 이동 관련 문제 해결 troubleshooting-problems-around-moving-files

서버 API를 사용하려면 이동 및 복사 작업이 작동하도록 추가 헤더 X-Destination, X-Depth 및 X-Overwrite가 전달되어야 합니다. Dispatcher는 기본적으로 이러한 헤더를 전달하지 않으므로 이러한 작업이 실패합니다. 자세한 내용은 Dispatcher 뒤에 있는 AEM에 연결.

AEM Desktop 연결 문제 해결 troubleshooting-aem-desktop-connection-issues

SAML 리디렉션 문제 saml-redirect-issue

SSO 지원(SAML) AEM 인스턴스에 연결하는 AEM Desktop에 문제가 발생하는 가장 일반적인 이유는 SAML 프로세스가 원래 요청된 경로로 다시 리디렉션되지 않기 때문입니다. 또는 AEM 데스크탑에 구성되지 않은 호스트로 연결이 리디렉션될 수 있습니다. 다음 단계를 수행하여 로그인 프로세스를 확인합니다.

  1. 웹 브라우저를 엽니다.
  2. 주소 표시줄에서 URL을 지정합니다 /content/dam.json.
  3. URL을 대상 AEM 인스턴스로 바꿉니다. 예: https://localhost:4502/content/dam.json.
  4. AEM에 로그온합니다.
  5. 로그인 후 주소 표시줄에서 브라우저의 현재 주소를 확인합니다. 처음에 입력한 URL과 일치해야 합니다.
  6. 이전에 모든 항목 확인 /content/dam.json AEM Desktop에 구성된 target AEM 값과 일치합니다.

SSL 구성 문제 ssl-configuration-issue

AEM 데스크탑 앱이 HTTP 통신에 사용하는 라이브러리는 엄격한 SSL 적용을 사용합니다. 연결이 브라우저를 사용하여 성공할 수도 있지만, AEM 데스크탑 앱을 사용하여 실패하는 경우가 있습니다. SSL을 적절하게 구성하려면 Apache에 누락된 중간 인증서를 설치합니다. 다음을 참조하십시오 Apache에 중간 CA 인증서를 설치하는 방법.

Dispatcher에 AEM Desktop 사용 using-aem-desktop-with-dispatcher

AEM Desktop은 AEM 서버의 기본 및 권장 구성인 dispatcher 뒤에서 AEM 배포와 작동합니다. AEM 작성 환경 앞의 AEM dispatcher는 일반적으로 DAM 에셋 캐싱을 건너뛸 수 있도록 구성됩니다. 따라서 Dispatcher는 AEM Desktop 관점에서 추가 캐싱을 제공하지 않습니다. Dispatcher 구성이 AEM Desktop에서 작동하도록 조정되었는지 확인합니다. 자세한 내용은 Dispatcher 뒤에 있는 AEM에 연결.

로그 파일 확인 checking-for-log-files

운영 체제에 따라 다음 위치에서 AEM Desktop에 대한 로그 파일을 찾을 수 있습니다.

  • Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs
  • Mac: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop
recommendation-more-help
d27c3dc5-a94a-4e63-a6d5-c47555beb65d