AEM의 설치 문제 해결

마지막 업데이트: 2023-05-23
  • 주제:
  • Deploying
    이 항목에 대한 자세한 내용 보기
  • 작성 대상:
  • Developer

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

작성자 성능 문제 해결

작성 인스턴스에서 느린 성능을 분석하는 작업이 복잡해질 수 있습니다. 첫 단계로 어느 정도의 기술스택에서 성능이 저하되고 있는지 파악해야 한다.

다음 진단트리는 병목 지점을 좁히는 지침을 제공합니다.

chlimage_1-75

기본 최적화

chlimage_1-76

로그 파일 및 감사 로그 구성

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

세부 정보 표시 옵션 사용

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

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

일반적인 설치 문제

다음 섹션에서는 일부 설치 문제와 해결 방법에 대해 설명합니다.

Quickstart jar를 두 번 클릭해도 아무런 효과가 없거나 다른 프로그램(예: archive manager)으로 jar 파일을 엽니다.

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

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

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

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

  • AEM WCM 빠른 시작에서 상황에 맞는 메뉴(보통 마우스 오른쪽 버튼 클릭)를 시도하고 "연결 프로그램"을 선택합니다…

  • Java™ 또는 Sun Java™이 나열되어 있는지 확인하고 이 목록을 사용하여 AEM WCM을 실행해 보십시오. 여러 Java™ 버전이 설치된 경우 지원되는 버전을 선택합니다.

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

  • 경우에 따라 지원되는 Java™ 버전을 다시 설치하면 올바른 연결을 복원하는 데 도움이 됩니다.

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

CRX에서 실행 중인 내 응용 프로그램에서 메모리 부족 오류가 발생합니다.

노트

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

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

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

힙 크기를 512MB로 이미 정의한 경우 힙 덤프를 생성하여 메모리 문제를 추가로 분석할 수 있습니다.

메모리가 부족할 때 힙 덤프를 자동으로 만들려면 다음 명령을 사용합니다.

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

이 메서드는 힙 덤프 파일(java_…hprof) 프로세스에 메모리가 부족할 때마다 힙 덤프가 생성된 후에도 프로세스가 계속 실행될 수 있습니다. 일반적으로 문제를 분석하는 데 하나의 힙 덤프 파일로 충분합니다.

AEM 빠른 시작을 두 번 클릭한 후 AEM 시작 화면이 브라우저에 표시되지 않습니다

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

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

또한 로그에 브라우저가 시작되지 않는 이유가 표시될 수 있습니다.

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

다른 모든 것이 실패하면 로그를 확인하여 발생한 사항을 확인합니다.

Java™ 11을 사용하여 웹 사이트가 로드되지 않거나 간헐적으로 실패합니다

Java™ 11에서 실행 중인 AEM 6.5에서 웹 사이트가 간헐적으로 로드되지 않거나 실패할 수 있는 알려진 문제가 있습니다.

이 문제가 발생하면 다음 작업을 수행하십시오.

  1. 를 엽니다. sling.properties 파일 아래 crx-quickstart/conf/ 폴더

  2. 다음 줄을 찾습니다.

    org.osgi.framework.bootdelegation=sun.,com.sun.

  3. 다음과 같이 바꿉니다.

    org.osgi.framework.bootdelegation=sun.,com.sun.,jdk.internal.reflect,jdk.internal.reflect.*

  4. 인스턴스를 다시 시작합니다.

애플리케이션 서버를 사용한 설치 문제 해결

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 커넥터 헤더 크기에 대한 제한을 제어합니다.

Adobe Experience Manager 제거

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

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

노트

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

AEM의 설치에서 외부 스토리지(예: 데이터베이스 서버)를 사용하는 경우 폴더를 제거하면 데이터가 자동으로 제거되지는 않지만 스토리지 구성이 제거되므로 JCR 콘텐츠를 복원하기가 어렵습니다.

JSP 파일이 JBoss에서 컴파일되지 않았습니다®

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

이 페이지의