Show Menu
화제×

문제 해결

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

작성자 성능 문제 해결

저작 인스턴스의 느린 성능 분석이 매우 복잡해질 수 있습니다. 첫 번째 단계에서는 성능이 저하되는 기술 스택의 수준을 파악해야 합니다.
다음 의사 결정 트리는 병목 현상을 좁히기 위한 지침을 제공합니다.

기본 최적화

로그 파일 및 감사 로그 구성

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

세부 정보 옵션 사용

AEM WCM을 시작할 때 다음과 같이 명령줄에 -v (verbose) 옵션을 추가할 수 있습니다.java -jar cq-wcm-quickstart-<version>.jar -v.
세부 정보 옵션은 콘솔에 빠른 시작 로그 출력 중 일부를 표시하므로 문제 해결에 사용할 수 있습니다.

일반적인 설치 문제

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

빠른 시작 jar를 두 번 클릭해도 아무런 효과가 없거나 다른 프로그램과 함께 jar 파일을 엽니다(예: 아카이브 관리자).

이는 일반적으로 운영 체제의 데스크톱 환경이 확장명이 .jar인 파일을 열도록 구성되는 방식에 문제가 있음을 나타냅니다. Java가 설치되어 있지 않거나 지원되지 않는 Java 버전을 사용하고 있음을 나타낼 수도 있습니다.
jar 파일이 유비쿼터스 ZIP 포맷을 사용하므로 일부 아카이브 프로그램은 자동으로 jar 파일을 아카이브 파일로 열도록 데스크탑을 구성할 수 있습니다.
문제를 해결하려면 다음을 수행합니다.
  • Java 버전 1.6이 설치되어 있는지 다시 확인하십시오.
  • AEM WCM Quickstart에서 컨텍스트 메뉴(일반적으로 마우스 오른쪽 단추 클릭)를 사용하고 "열기..."를 선택합니다.."
  • Java 또는 Sun Java가 나열되었는지 확인하고 AEM WCM을 실행해 보십시오. 여러 Java 버전이 설치되어 있는 경우 지원되는 버전을 선택합니다.
    이 단계를 성공적으로 수행하고 운영 체제에서 선택된 프로그램을 항상 사용하여 .jar 파일을 실행하는 옵션을 제공하는 경우 선택합니다. 이제 두 번 클릭은 제대로 작동합니다.
  • 경우에 따라 지원되는 Java 버전을 다시 설치하면 올바른 연결을 복원하는 데 도움이 됩니다.
  • 이 문서의 앞부분에 설명된 대로 항상 명령줄을 사용하거나 시작/중지 스크립트를 사용하여 CRX를 실행할 수 있습니다.

CRX에서 실행되는 내 애플리케이션에서 메모리 부족 오류가 발생합니다.

CRX 자체에는 메모리 공간이 매우 적습니다. CRX 내에서 실행되는 응용 프로그램이 더 큰 메모리 요구 사항을 가지고 있거나 메모리 중심 작업(예: 큰 트랜잭션)을 요청하는 경우, CRX가 실행되는 JVM 인스턴스를 적절한 메모리 설정으로 시작해야 합니다.
Java 명령 옵션을 사용하여 JVM의 메모리 설정을 정의합니다(예: java -Xmx512m -jar crx&ast;.jar to set heapsize to 512MB).
명령줄에서 AEM WCM을 시작하는 동안 메모리 설정 옵션을 지정합니다. AEM WCM 시작/중지 스크립트 또는 AEM WCM 시작 관리를 위한 사용자 정의 스크립트를 수정하여 필요한 메모리 설정을 정의할 수도 있습니다.
heapsize를 512MB로 이미 정의한 경우 더미 덤프를 만들어 메모리 문제를 추가로 분석할 수 있습니다.
메모리 부족 시 더미 덤프를 자동으로 만들려면 다음 명령을 사용합니다.
java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar &ast;.jar
더미 덤프 파일( java_...)을 생성합니다.hprof )의 경우 프로세스가 메모리가 부족할 때마다 더미 덤프가 생성된 후에도 프로세스가 계속 실행될 수 있습니다. 일반적으로 하나의 더미 덤프 파일이 문제를 분석하는 데 충분합니다.

AEM Quickstart를 두 번 클릭해도 AEM Welcome 화면이 브라우저에 표시되지 않습니다

특정 상황에서 저장소 자체가 성공적으로 실행되더라도 AEM WCM 시작 화면이 자동으로 표시되지 않습니다. 이는 운영 체제 설정, 브라우저 구성 또는 유사한 요인에 따라 달라질 수 있습니다.
일반적인 증상은 AEM WCM Quickstart 창에 "AEM WCM 시작 대기 중..."이 표시됩니다.." 해당 메시지가 상대적으로 오랫동안 표시되는 경우 기본 4502 포트 또는 인스턴스가 실행 중인 포트를 사용하여 AEM WCM URL을 브라우저 창에 수동으로 입력합니다.http://localhost:4502/.
또한 로그에는 브라우저가 시작되지 않는 이유가 표시될 수 있습니다.
경우에 따라 AEM WCM Quickstart 창에 "AEM WCM이 http://localhost:port/에서 실행 중"이라는 메시지가 표시되며 브라우저가 자동으로 시작되지 않습니다. 이 경우 AEM WCM 빠른 시작 창의 URL(하이퍼링크임)을 클릭하거나 브라우저에 URL을 수동으로 입력합니다.
다른 모든 것이 실패하면, 로그를 확인하여 발생한 상황을 확인하십시오.

응용 프로그램 서버를 사용한 설치 문제 해결

geometrixx-outdoor 페이지를 요청할 때 페이지를 찾을 수 없음

WebLogic 10.3.5 및 JBoss 5.1에 적용
geometrixx-outdoors/en 페이지에 대한 요청이 404(페이지 찾을 수 없음)를 반환하는 경우 이러한 특정 응용 프로그램 서버에 필요한 sling.properties 파일에서 추가 sling 속성을 설정했는지 다시 확인할 수 있습니다.
자세한 내용은 AEM 웹 애플리케이션 배포 단계를 참조하십시오.

응답 헤더 크기는 4Kb보다 클 수 있습니다.

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

Uninstalling Adobe Experience Manager

AEM은 단일 디렉토리에 설치되므로 제거 유틸리티를 사용할 필요가 없습니다. AEM을 제거하는 방법은 수행하고자 하는 것과 사용하는 영구 스토리지에 따라 다르지만, 전체 설치 디렉토리를 삭제하는 것만큼 간단하게 제거할 수 있습니다.
예를 들어 기본 TarPM 설치 시 영구 저장소가 설치 디렉토리에 포함되어 있으면 폴더를 삭제하면 데이터도 제거됩니다.
AEM을 삭제하기 전에 저장소를 백업하는 것이 좋습니다. 전체 <cq-installation-directory>를 삭제하면 저장소가 삭제됩니다. <cq-installation-directory>/crx-quickstart/repository 폴더를 삭제하기 전에 저장소 데이터를 유지하려면 다른 폴더를 삭제하기 전에 다른 위치로 이동합니다.
AEM 설치가 외부 저장소(예: 데이터베이스 서버)를 사용하는 경우 폴더를 제거해도 데이터가 자동으로 제거되지는 않지만 저장소 구성이 제거되므로 JCR 컨텐츠를 복원하는 것이 어렵습니다.

JSP 파일은 JBoss에서 컴파일되지 않습니다.

JBoss의 Experience Manager에 JSP 파일을 설치 또는 업데이트하고 해당 서블릿을 컴파일하지 않는 경우 JBoss JSP 컴파일러가 제대로 구성되어 있는지 확인합니다. 자세한 내용은 JBoss 의 JSP 컴파일 문제를 참조하십시오.