설명서AEM데스크탑 앱 안내서

Adobe Experience Manager 데스크톱 앱 문제 해결 troubleshoot-v2

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 사용자
  • 관리자

Adobe Experience Manager 데스크톱 앱에서 Experience Manager 배포의 DAM(디지털 자산 관리) 저장소에 연결합니다. 이 앱은 컴퓨터에서 저장소 정보와 검색 결과를 가져오고, 파일과 폴더를 다운로드하고 업로드하며, Assets 사용자 인터페이스와의 충돌을 관리하는 기능을 포함합니다.

앱 문제를 해결하려면 을 읽고, 모범 사례를 배우고, 제한 사항을 확인합니다.

모범 사례 best-practices-to-prevent-troubles

몇 가지 일반적인 문제 및 문제 해결을 방지하려면 다음 모범 사례를 따르십시오.

  • 데스크톱 앱의 작동 방식을 이해합니다: 응용 프로그램 사용을 시작하기 전에 앱이 어떻게 작동하는지 알고 잠시 시간을 보내십시오. Experience Manager 웹 인터페이스와 데스크톱 간의 연결, 저장소 매핑, 에셋 캐싱, 로컬로 저장 및 백그라운드에서 업로드에 대해 알아봅니다. 작동 방법을 참조하세요.

  • 폴더 이름에 지원되지 않는 문자를 사용하지 마십시오: 폴더를 만들거나 업로드할 때 공백과 잘못된 문자를 사용하지 마십시오. 폴더 만들기 Adobe Experience Manager Assets에서 문자 목록을 확인하세요. 폴더 이름에 지원되지 않는 문자가 일부 Experience Manager개의 사용 사례에 영향을 줄 수 있습니다.

  • 충돌을 방지하는 모범 사례: 여러 에셋에 대해 공동 작업을 수행할 때 발생할 수 있는 충돌을 방지하려면 충돌을 피하려면(으)로 이동하십시오.

  • 계층 구조의 큰 폴더에 폴더를 업로드하십시오: Assets 웹 인터페이스나 다른 방법을 사용하는 대신 Experience Manager 데스크톱 앱을 사용하여 큰 폴더를 업로드하십시오. 앱이 백그라운드에 있는 에셋을 로깅 및 모니터링과 함께 업로드합니다. 자산 일괄 업로드를 참조하십시오.

  • 최신 버전 사용: 최신 앱 버전을 사용합니다. 새 앱 버전을 설치하거나 최신 Experience Manager 버전으로 업그레이드하기 전에 항상 호환성을 확인하십시오. 릴리스 정보를 참조하세요.

  • 동일한 드라이브 문자 사용: 조직 전체에서 동일한 드라이브 문자를 사용하여 Experience Manager DAM에 매핑합니다. 다른 사용자가 배치한 에셋을 보려면 경로가 동일해야 합니다. 동일한 드라이브 문자를 사용하면 DAM 에셋에 대한 경로가 일정하게 유지됩니다. 에셋은 배치된 상태로 유지되며 다른 사용자가 다른 드라이브 문자를 사용하더라도 제거되지 않습니다.

  • 네트워크 관리: 네트워크 성능은 Experience Manager 데스크톱 앱의 성능에 매우 중요합니다. 파일 전송 또는 대량 작업에 대한 응답이 느려지는 경우 많은 네트워크 트래픽을 초래할 수 있는 기능이나 앱을 끕니다.

  • 데스크톱 앱에 지원되지 않는 사용 사례: 계획 및 추가 도구가 필요하므로 자산 마이그레이션에 앱을 사용하지 마십시오. 또한 큰 폴더 이동, 큰 업로드 또는 고급 메타데이터 검색과 같은 사용량이 많은 DAM 작업에는 적합하지 않습니다. 또한 디자인 원칙 및 사용 패턴이 Microsoft OneDrive 또는 Adobe Creative Cloud 데스크톱 동기화와 같은 동기화 클라이언트와 다르므로 동기화 클라이언트로 사용하지 마십시오.

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

문제 해결 방법 troubleshooting-prep

데스크탑 앱 문제를 해결하려면 다음 정보를 참조하십시오. 또한 지원을 요청할 경우 고객 지원 Adobe에 문제를 더 잘 전달할 수 있도록 준비합니다.

로그 파일 위치 check-log-files-v2

Experience Manager 데스크톱 앱은 운영 체제에 따라 로그 파일을 다음 위치에 저장합니다.

Windows의 경우: %LocalAppData%\Adobe\AssetsCompanion\Logs

Mac에서: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

많은 에셋을 업로드할 때 일부 파일이 업로드되지 않으면 backend.log 파일을 참조하여 실패한 업로드를 확인하십시오.

NOTE
지원 요청 또는 티켓에 대해 Adobe 고객 지원 팀과 작업할 때 고객 지원 팀이 문제를 이해하는 데 도움이 되도록 로그 파일을 공유하라는 메시지가 표시될 수 있습니다. 전체 Logs 폴더를 보관하고 고객 지원 담당자에게 공유합니다.

로그 파일의 세부 정보 수준 변경 level-of-details-in-log

로그 파일의 세부 정보 수준을 변경하려면 다음을 수행합니다.

  1. 응용 프로그램이 실행되고 있지 않은지 확인합니다.

  2. Windows 시스템의 경우:

    1. 명령 창을 엽니다.

    2. 다음 명령을 실행하여 Adobe Experience Manager 데스크톱 앱을 시작합니다.

    code language-shell 
    set AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe

    Mac 시스템에서:

    1. 터미널 창을 엽니다.

    2. 다음 명령을 실행하여 Adobe Experience Manager 데스크톱 앱을 시작합니다.

    code language-shell 
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app

유효한 로그 수준은 DEBUG, INFO, WARN 또는 ERROR입니다. 로그의 자세한 내용은 DEBUG에서 가장 높고 ERROR에서 가장 낮습니다.

디버그 모드 활성화 enable-debug-mode

문제를 해결하려면 디버그 모드를 활성화하고 자세한 정보를 로그에서 확인할 수 있습니다.

NOTE
유효한 로그 수준은 DEBUG, INFO, WARN 또는 ERROR입니다. 로그의 자세한 내용은 DEBUG에서 가장 높고 ERROR에서 가장 낮습니다.

Mac에서 디버그 모드로 앱을 사용하려면 다음을 수행하십시오.

  1. 터미널 창이나 명령 프롬프트를 엽니다.

  2. 다음 명령을 실행하여 Experience Manager 데스크톱 앱을 시작합니다.

    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app

Windows에서 디버그 모드를 활성화하려면:

  1. 명령 창을 엽니다.

  2. 다음 명령을 실행하여 Experience Manager 데스크톱 앱을 시작합니다.

AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe

Adobe Experience Manager 데스크톱 앱 버전을 알 수 있습니다. know-app-version-v2

버전 번호를 보려면:

  1. 응용 프로그램을 시작합니다.

  2. 오른쪽 위 모서리의 줄임표를 클릭하고 Help 위로 마우스를 가져간 다음 About을(를) 클릭합니다.

    이 화면에 버전 번호가 나열됩니다.

캐시 지우기 clear-cache-v2

다음 단계를 수행하십시오.

  1. 응용 프로그램을 시작하고 Experience Manager의 인스턴스에 연결합니다.

  2. 오른쪽 상단의 생략 부호를 클릭하고 Preferences을(를) 선택하여 응용 프로그램의 환경 설정을 엽니다.

  3. Current Cache Size을(를) 표시하는 항목을 찾습니다. 이 요소 옆에 있는 휴지통 아이콘을 클릭합니다.

캐시를 수동으로 지우려면 다음을 수행합니다.

CAUTION
이러한 단계는 잠재적으로 파괴적인 작업입니다. Adobe Experience Manager에 업로드되지 않은 로컬 파일 변경 내용이 있으면 해당 변경 내용이 손실됩니다.

응용 프로그램의 기본 설정에 있는 응용 프로그램의 캐시 디렉터리를 삭제하여 캐시를 지웁니다.

  1. 응용 프로그램을 시작합니다.

  2. 오른쪽 상단 모서리에서 줄임표를 선택하고 Preferences을(를) 선택하여 응용 프로그램의 환경 설정을 엽니다.

  3. Cache Directory 값을 확인합니다.

    이 디렉터리에는 인코딩된 Adobe Experience Manager 끝점의 이름을 딴 하위 디렉터리가 있습니다. 이름이 대상 Adobe Experience Manager URL의 인코딩된 버전입니다. 예를 들어 응용 프로그램에서 localhost:4502을(를) 대상으로 하는 경우 디렉터리 이름은 localhost_4502입니다.

캐시를 지우려면 인코딩된 Adobe Experience Manager 끝점 디렉터리를 삭제합니다. 또는 기본 설정에 지정된 전체 디렉토리를 삭제하면 애플리케이션에서 사용한 모든 인스턴스에 대한 캐시가 지워집니다.

Adobe Experience Manager 데스크톱 앱의 캐시를 지우는 것은 몇 가지 문제를 해결할 수 있는 사전 문제 해결 작업입니다. 앱 환경 설정에서 캐시를 지웁니다. 환경 설정 지정을 참조하십시오. 캐시 폴더의 기본 위치는 다음과 같습니다.

배치된 자산을 볼 수 없음 placed-assets-missing

귀하 또는 다른 크리에이티브 전문가가 지원 파일(예: INDD 파일)에 배치한 에셋을 볼 수 없는 경우 다음을 확인하십시오.

  • 서버에 연결. 불안정한 네트워크 연결로 인해 자산 다운로드가 지연될 수 있습니다.

  • 파일 크기. 큰 에셋을 다운로드하고 표시하는 데 시간이 더 오래 걸립니다.

  • 드라이브 문자 일관성. 사용자나 다른 공동 작업자가 Experience Manager DAM을 다른 드라이브 문자에 매핑하는 동안 자산을 배치한 경우 배치된 자산이 표시되지 않습니다.

  • 권한 가져온 자산을 가져올 수 있는 권한이 있는지 확인하려면 Experience Manager 관리자에게 문의하십시오.

데스크톱 앱의 사용자 인터페이스에 있는 파일에 대한 편집이 Adobe Experience Manager에 즉시 반영되지 않습니다. changes-on-da-not-visible-on-aem

Adobe Experience Manager 데스크톱 앱에서는 사용자가 파일 편집이 모두 완료되는 시기를 결정할 수 있도록 합니다. 파일의 크기와 복잡성에 따라 새 버전의 파일을 Adobe Experience Manager (으)로 다시 전송하는 데 상당한 시간이 소요됩니다. 이 애플리케이션은 편집 완료로 추정되는 시점을 기준으로 파일을 자동으로 업로드하는 대신 파일 전송 수를 최소화하도록 설계되었습니다. 사용자가 파일의 변경 내용을 업로드하도록 선택하여 파일을 다시 Adobe Experience Manager (으)로 전송하는 것이 좋습니다.

macOS에서 업그레이드 시 문제 issues-when-upgrading-on-macos

macOS에서 Experience Manager 데스크톱 앱을 업그레이드할 때 문제가 발생하는 경우가 있습니다. Experience Manager 데스크톱 앱의 레거시 시스템 폴더로 인해 이러한 문제가 발생합니다. 폴더에서는 새 버전의 Experience Manager 데스크톱 앱을 올바르게 로드할 수 없습니다. 이 문제를 해결하기 위해 다음 폴더 및 파일을 수동으로 제거할 수 있습니다.

다음 단계를 실행하기 전에 Adobe Experience Manager Desktop 응용 프로그램을 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

파일을 업로드할 수 없음 upload-fails

데스크탑 앱을 Experience Manager 6.5.1 이상에서 사용하는 경우 S3 또는 Azure 커넥터를 버전 1.10.4 이상으로 업그레이드하십시오. OAK-8599과(와) 관련된 파일 업로드 실패 문제를 해결합니다. 설치 지침을 참조하세요.

Experience Manager 데스크톱 앱 연결 문제 connection-issues

일반적인 연결 문제가 발생하는 경우 Experience Manager 데스크톱 앱에서 수행하는 작업에 대한 자세한 정보를 얻을 수 있는 방법이 있습니다.

요청 로그 확인

Experience Manager 데스크톱 앱은 보내는 모든 요청을 각 요청의 응답 코드와 함께 전용 로그 파일에 기록합니다.

  1. 응용 프로그램의 로그 디렉터리에서 request.log을(를) 열어 이러한 요청을 확인합니다.

  2. 로그의 각 행은 요청 또는 응답을 나타냅니다. 요청의 문자 뒤에 요청된 URL이 >자로 표시됩니다. 응답에는 <자 뒤에 요청된 응답 코드와 URL이 있습니다. 요청과 응답은 각 줄의 GUID를 사용하여 일치시킬 수 있습니다.

응용 프로그램의 포함된 브라우저에서 로드한 확인 요청

애플리케이션의 요청의 대부분은 요청 로그에서 찾을 수 있습니다. 그러나 유용한 정보가 없으면 응용 프로그램의 포함된 브라우저에서 보낸 요청을 살펴보는 것이 유용할 수 있습니다.
이러한 요청을 보는 방법에 대한 지침은 SAML 섹션을 참조하세요.

SAML 로그인 인증이 작동하지 않음 da-connection-issue-with-saml-aem

Experience Manager 데스크톱 앱에서 SSO 사용(SAML) Adobe Experience Manager 배포에 연결할 수 없습니다. 애플리케이션의 디자인은 SSO 연결 및 프로세스의 변형 및 복잡성을 수용하려고 합니다. 그러나 추가 트러블슈팅이 필요할 수 있습니다.

경우에 따라 SAML 프로세스가 원래 요청된 경로로 다시 리디렉션되지 않습니다. 또는 Adobe Experience Manager 데스크톱 앱에서 구성된 것과 다른 호스트로 리디렉션합니다. 이 문제가 발생하지 않는지 확인하려면 다음을 수행하십시오.

  1. 웹 브라우저를 엽니다. https://[aem_server]:[port]/content/dam.json URL에 액세스합니다.

  2. Adobe Experience Manager 배포에 로그인합니다.

  3. 로그인이 완료되면 주소 표시줄에서 브라우저의 현재 주소를 확인합니다. 이 URL은 처음에 입력한 URL과 정확히 일치해야 합니다.

  4. 또한 /content/dam.json 이전의 모든 값이 Adobe Experience Manager 데스크톱 앱의 설정에 구성된 대상 Adobe Experience Manager 값과 일치하는지 확인하십시오.

위의 단계에 따라 로그인 SAML 프로세스가 올바르게 작동하지만 사용자가 계속 로그온할 수 없습니다

로그인 프로세스를 표시하는 Adobe Experience Manager 데스크톱 앱의 창은 단순히 대상 Adobe Experience Manager 인스턴스의 웹 사용자 인터페이스를 표시하는 웹 브라우저입니다.

  • Mac 버전은 WebView을(를) 사용합니다.

  • Windows 버전에서는 Chromium 기반 CefSharp을(를) 사용합니다.

SAML 프로세스가 이러한 브라우저를 지원하는지 확인합니다.

문제를 더 자세히 해결하려면 브라우저가 로드하려는 정확한 URL을 볼 수 있습니다. 이 정보를 보려면 다음 작업을 수행하십시오.

  1. 디버그 모드에서 응용 프로그램을 시작하는 방법에 따라 실행하십시오.

  2. 로그인 시도를 재현합니다.

  3. 응용 프로그램의 로그 디렉터리(으)로 이동합니다.

  4. Windows의 경우:

    1. "aemcompanionlog.txt"를 엽니다.

    2. "로그인 브라우저 주소가 다음으로 변경됨"으로 시작하는 메시지를 검색합니다. 이러한 항목에는 응용 프로그램이 로드한 URL도 포함됩니다.

    Mac의 경우

    1. com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log에서 최신 파일 이름에 있는 숫자는 n ​을(를) 대체합니다.

    2. 로드된 프레임으로 시작하는 메시지를 검색합니다. 이러한 항목에는 응용 프로그램이 로드한 URL도 포함됩니다.

로드 중인 URL 시퀀스를 보면 SAML의 끝에서 문제를 해결하여 무엇이 잘못되었는지 확인하는 데 도움이 될 수 있습니다.

SSL 구성 문제 ssl-config-v2

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

Experience Manager 데스크톱 앱에서 HTTP 통신에 사용하는 라이브러리는 엄격한 SSL 적용을 사용합니다. 따라서 브라우저를 통해 성공하는 SSL 연결이 Adobe Experience Manager 데스크톱 앱에서 실패하는 경우가 있을 수 있습니다. 이러한 결과는 SSL의 올바른 구성을 장려하고 보안을 강화하므로 좋지만 애플리케이션에 연결할 수 없는 경우 문제가 발생할 수 있습니다.

이 경우 서버의 SSL 인증서를 분석하고 문제를 식별하여 수정할 수 있도록 도구를 사용하는 것이 좋습니다. URL을 제공하여 서버의 인증서를 검사하는 웹 사이트가 있습니다.

임시 조치로서 Adobe Experience Manager 데스크톱 앱에서 엄격한 SSL 적용을 비활성화할 수 있습니다. 이 방법은 잘못 구성된 SSL의 근본 원인을 숨겨 보안을 줄이기 때문에 장기적인 솔루션으로는 권장되지 않습니다. 엄격한 적용을 비활성화하려면

  1. 선택한 편집기를 사용하여 애플리케이션의 JavaScript 구성 파일을 편집합니다. 이 파일은 기본적으로 운영 체제에 따라 다음 위치에 있습니다.

    Mac에서: /Applications/Adobe Experience Manager Desktop.app/Contents/Resources/javascript/lib-smb/config.json

    Windows의 경우: C:\Program Files (x86)\Adobe\Adobe Experience Manager Desktop\javascript\config.json

  2. 파일에서 다음 섹션을 찾습니다.

    code language-shell 
    ...
"assetRepository": {
    "options": {
...

  3. 다음과 같이 "strictSSL": false을(를) 추가하여 섹션을 수정합니다.

    code language-shell 
    ...
"assetRepository": {
    "options": {
        "strictSSL": false,
...

  4. 파일을 저장하고 Adobe Experience Manager 데스크톱 앱을 다시 시작합니다.

다른 서버로 전환할 때 로그인 문제 발생 cannot-login-cookies-issue

Experience Manager 서버를 사용한 후 다른 서버로의 연결을 변경하려고 하면 로그인 문제가 발생할 수 있습니다. 오래된 쿠키가 새로운 인증을 방해하기 때문입니다. Clear Cookies에 대한 기본 메뉴의 옵션이 도움이 됩니다. 앱의 현재 세션에서 로그아웃하고 연결을 계속하기 전에 Clear Cookies을(를) 선택하십시오.

서버를 전환할 때 쿠키 지우기

앱이 응답하지 않음 unresponsive

드물게 애플리케이션이 응답하지 않거나, 흰색 화면만 표시되거나, 인터페이스의 맨 아래에 인터페이스 옵션 없이 오류가 표시될 수 있습니다. 다음 순서로 시도해 보십시오.

  • 응용 프로그램 인터페이스를 마우스 오른쪽 단추로 클릭하고 Refresh ​을(를) 클릭합니다.
  • 애플리케이션을 종료하고 다시 엽니다.

두 메서드 모두에서 앱은 루트 DAM 폴더에서 시작됩니다.

만료된 에셋 숨기기 hide-expired-assets

Experience Manager 사용자 인터페이스 내에서 자산을 검색할 때 만료된 자산이 표시되지 않습니다. 관리자는 데스크탑 앱과 자산 링크에서 검색할 때 만료된 자산을 보고 검색하고 가져오지 않도록 설정을 구성할 수 있습니다. 이렇게 하면 이러한 작업 중에 만료된 에셋에 액세스할 수 없게 됩니다. 이 구성은 관리자 권한과 관계없이 모든 사용자에 대해 작동합니다.

Related Articles
recommendation-more-help
d27c3dc5-a94a-4e63-a6d5-c47555beb65d