문제 해결 troubleshooting

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

이 섹션에는 문제를 해결하는 데 도움이 되는 로그에 대한 자세한 정보가 포함되며 AEM에서 발생할 수 있는 일부 문제에 대한 정보도 포함됩니다.

작성자 성능 문제 해결 troubleshoot-author-performance

작성 인스턴스의 느린 성능 분석은 매우 복잡할 수 있습니다. 첫 번째 단계에서는 성능이 저하되는 기술 스택의 수준을 파악해야 합니다.

다음 의사 결정 트리는 병목 현상을 줄이는 데 필요한 지침을 제공합니다.

chlimage_1-75

기본 최적화 basic-optimization

chlimage_1-76

로그 파일 및 감사 로그 구성 configuring-log-files-and-audit-logs

AEM은 설치 문제를 해결하기 위해 구성할 수 있는 세부 로그를 기록합니다. 자세한 내용은 감사 레코드 및 로그 파일 작업 섹션을 참조하십시오.

세부 정보 옵션 사용 using-the-verbose-option

AEM WCM을 시작할 때 다음과 같이 명령줄에 -v (세부 정보) 옵션을 추가할 수 있습니다. java -jar cq-wcm-quickstart-<version>.jar -v

세부 정보(verbose) 옵션은 콘솔에 일부 빠른 시작 로그 출력을 표시하므로 문제 해결에 사용할 수 있습니다.

일반적인 설치 문제 common-installation-issues

다음 섹션에서는 설치 문제 및 해당 솔루션에 대해 설명합니다.

Quickstart jar를 두 번 클릭해도 아무런 효과가 없거나 다른 프로그램(예: 아카이브 관리자)에서 jar 파일을 엽니다 double-clicking-the-quickstart-jar-does-not-have-any-effect-or-opens-the-jar-file-with-another-program-for-example-archive-manager

일반적으로 운영 체제의 데스크탑 환경에서 확장명이 .jar인 파일을 열도록 구성하는 방식에 문제가 있음을 나타냅니다. Java가 설치되어 있지 않거나 지원되지 않는 버전의 Java를 사용하고 있음을 나타낼 수도 있습니다.

jar 파일이 유비쿼터스 ZIP 형식을 사용하므로 일부 아카이브 프로그램은 jar 파일을 아카이브 파일로 열도록 데스크탑을 자동으로 구성할 수 있습니다.

문제를 해결하려면 다음을 수행하십시오.

  • Java 버전 1.6 이상이 설치되어 있는지 다시 확인하십시오.

  • AEM WCM Quickstart에서 컨텍스트 메뉴(일반적으로 마우스 오른쪽 단추 클릭)를 클릭하고 "열기…"

  • Java 또는 Sun Java가 나열되었는지 확인하고 Java로 AEM WCM을 실행해 보십시오. 여러 Java 버전이 설치되어 있다면 지원되는 버전을 선택합니다.

    이 단계를 성공적으로 수행하고 운영 체제에서 항상 선택한 프로그램을 사용하여 .jar 파일을 실행하는 옵션을 제공하는 경우 선택합니다. 이제 두 번 클릭하는 것이 작동합니다.

  • 경우에 따라 지원되는 Java 버전을 다시 설치하면 올바른 연결을 복원할 수 있습니다.

  • 이 문서의 앞부분에서 설명한 대로 항상 명령줄이나 시작/중지 스크립트를 사용하여 CRX를 실행할 수 있습니다.

CRX에서 실행 중인 내 애플리케이션에서 메모리 부족 오류가 발생합니다 my-application-running-on-crx-throws-out-of-memory-errors

NOTE
참조 - 메모리 문제 분석.

CRX 자체는 메모리 풋프린트가 매우 적습니다. CRX 내에서 실행 중인 응용 프로그램이 더 큰 메모리 요구 사항이 있거나 메모리 사용량이 많은 작업(예: 큰 트랜잭션)을 요청하는 경우, CRX가 실행되는 JVM 인스턴스는 적절한 메모리 설정으로 시작해야 합니다.

Java 명령 옵션을 사용하여 JVM의 메모리 설정을 정의합니다(예: java -Xmx512m -jar crx*.jar에서 heapsize를 512MB로 설정).

명령줄에서 AEM WCM을 시작하는 동안 메모리 설정 옵션을 지정합니다. AEM WCM 시작/중지 스크립트 또는 AEM WCM 시작 관리를 위한 사용자 지정 스크립트를 수정하여 필요한 메모리 설정을 정의할 수도 있습니다.

heapsize를 512MB로 이미 정의한 경우 힙을 만들어 메모리 문제를 더 분석할 수 있습니다.

메모리가 부족한 경우 힙덤프를 자동으로 만들려면 다음 명령을 사용하십시오.

java -Xmx256m-XX:+HeapDumpOnOutOfMemoryError -jar *.jar

이렇게 하면 heap 덤프 파일(java_…hprof)를 만들 수 있습니다. 힙이 생성된 후에도 프로세스가 계속 실행될 수 있습니다. 일반적으로 한 개의 더미 덤프 파일이 문제를 분석할 수 있습니다.

AEM Quickstart를 두 번 클릭해도 AEM 시작 화면이 브라우저에 표시되지 않습니다 the-aem-welcome-screen-does-not-display-in-the-browser-after-double-clicking-aem-quickstart

저장소 자체가 성공적으로 실행되어도 AEM WCM 시작 화면이 자동으로 표시되지 않는 경우가 있습니다. 운영 체제 설정, 브라우저 구성 또는 유사한 요소에 따라 달라질 수 있습니다.

일반적인 증상은 AEM WCM Quickstart 창에 "AEM WCM 시작, 서버 시작을 기다리는 중…"이 표시되는 것입니다…" 해당 메시지가 상대적으로 오랫동안 표시되는 경우, 기본 4502 포트를 사용하여 브라우저 창에 AEM WCM URL을 수동으로 입력하거나 인스턴스가 실행 중인 포트를 입력합니다. http://localhost:4502/

또한 로그는 브라우저가 시작되지 않는 이유를 나타낼 수 있습니다.

경우에 따라 AEM WCM Quickstart 창에 "AEM WCM에서 http://localhost:port/에서 실행 중"이라는 메시지가 표시되고 브라우저가 자동으로 시작되지 않습니다. 이 경우 AEM WCM Quickstart 창의 URL(하이퍼링크)을 클릭하거나 브라우저에 URL을 수동으로 입력합니다.

다른 모든 작업이 실패하면 로그를 확인하여 발생한 사항을 확인하십시오.

애플리케이션 서버를 사용한 설치 문제 해결 troubleshooting-installations-with-an-application-server

geometrixx-outdoors 페이지를 요청할 때 페이지를 찾을 수 없음 이 반환되었습니다 page-not-found-returned-when-requesting-a-geometrixx-outdoor-page

WebLogic 10.3.5 및 JBoss 5.1에 적용

geometrixx-outdoors/en 페이지에 대한 요청이 404(페이지가 없습니다)를 반환하는 경우 이러한 특정 애플리케이션 서버에 필요한 sling.properties 파일에서 추가 sling 속성을 설정했는지 다시 확인할 수 있습니다.

다음을 참조하십시오. AEM 웹 애플리케이션 배포 절차 를 참조하십시오.

응답 헤더 크기는 4Kb보다 클 수 있습니다. response-header-size-can-be-greater-than-kb

502 오류는 웹 서버가 AEM HTTP 응답 헤더의 크기를 처리할 수 없음을 나타낼 수 있습니다. AEM은 4Kb보다 큰 크기의 쿠키를 포함하는 HTTP 응답 헤더를 생성할 수 있습니다. 최대 응답 헤더 크기가 4kb를 초과할 수 있도록 서블릿 컨테이너가 구성되어 있는지 확인합니다.

예를 들어 Tomcat 7.0의 경우 HTTP 커넥터 머리글 크기에 대한 제한을 제어합니다.

Adobe Experience Manager 제거 uninstalling-adobe-experience-manager

AEM은 단일 디렉터리에 설치되므로 제거 유틸리티가 필요하지 않습니다. 제거할 방법은 원하는 항목과 사용하는 영구 스토리지에 따라 AEM 제거 방법이 달라지더라도 전체 설치 디렉토리를 삭제하는 것만큼 간단할 수 있습니다.

영구 저장소가 설치 디렉토리에 포함된 경우(예: 기본 TarPM 설치 시) 폴더를 삭제하면 데이터도 제거됩니다.

NOTE
Adobe은 AEM을 삭제하기 전에 리포지토리를 백업하는 것을 권장합니다. 전체 <cq-installation-directory>리포지토리를 삭제합니다. 삭제하기 전에 리포지토리 데이터를 유지하려면 <cq-installation-directory>/crx-quickstart/repository 폴더를 삭제하기 전에 다른 폴더에 배치합니다.

AEM 설치 시 외부 저장소(예: 데이터베이스 서버)를 사용하는 경우 폴더를 제거해도 데이터가 자동으로 제거되지는 않지만 저장소 구성이 제거되므로 JCR 컨텐츠를 복원하기가 어렵습니다.

JSP 파일은 JBoss에 컴파일되지 않습니다. jsp-files-are-not-compiled-on-jboss

JBoss에서 Experience Manager을 위해 JSP 파일을 설치하거나 업데이트한 경우 해당 서블릿이 컴파일되지 않으면 JBoss JSP 컴파일러가 올바르게 구성되어 있는지 확인하십시오. 자세한 내용은
JBoss의 JSP 컴파일 문제 문서.

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56