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

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

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

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

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

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

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

제한 사항 limitations

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

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

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

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

운영 체제의 제한으로 인해 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 저장소 전체에 대한 액세스를 제공하기 때문입니다.

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

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

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

개별 작업 individual-operations

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

대역폭 권장 사항 bandwidth-recommendations

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

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

동시 작업 concurrent-operations

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

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

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

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

추가 AEM 구성 additional-aem-configurations

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

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

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

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

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

AWS 구성 aws-configuration

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

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

체크 아웃된 파일 제한 사항 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에서 체크인하면 파일이 변경되지 않은 것으로 표시됩니다.

macOS mac-os-x

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

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

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

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입니다.

캐시를 지우려면 <인코딩된 AEM Endpoint> 디렉터리를 삭제합니다.

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

AEM Desktop 버전을 확인하는 절차는 Windows와 macOS 모두에서 동일합니다.

AEM 바탕 화면 아이콘을 클릭한 다음 정보 ​를 선택합니다. 버전 번호가 화면에 표시됩니다.

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

macOS에서 AEM 데스크탑 앱을 업그레이드할 때 문제가 발생하는 경우가 있습니다. AEM 데스크톱 앱의 레거시 시스템 폴더로 인해 이러한 문제가 발생합니다. 새 버전의 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 데스크탑 앱에 구성되지 않은 호스트로 연결이 리디렉션될 수 있습니다. 다음 단계를 수행하여 로그인 프로세스를 확인합니다.

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에 대한 로그 파일을 찾을 수 있습니다.