AEM의 설치 문제 해결 troubleshooting

이 섹션에는 문제를 해결하는 데 도움이 되는 로그에 대한 자세한 정보와 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(verbose) 옵션을 명령줄에 추가할 수 있습니다. java -jar cq-wcm-quickstart-<version>.jar -v

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

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

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

Quickstart jar를 두 번 클릭해도 아무런 효과가 없거나 다른 프로그램(예: archive manager)으로 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 빠른 시작에서 상황에 맞는 메뉴(보통 마우스 오른쪽 버튼 클릭)를 시도하고 "연결 프로그램"을 선택합니다…

  • Java™ 또는 Sun 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의 메모리 설정을 정의합니다(예: heapsize를 512MB로 설정하려면 java -Xmx512m -jar crx*.jar).

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

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

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

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

이 메서드는 힙 덤프 파일(java_…hprof) 프로세스에 메모리가 부족할 때마다 힙 덤프가 생성된 후에도 프로세스가 계속 실행될 수 있습니다.

문제를 분석하려면 종종 일정 기간 동안 수집된 세 개의 힙 덤프 파일이 필요합니다.

  • 오류가 발생하기 전
  • 실패 중 1
  • 실패 중 2
  • 이상적으로는 이벤트가 해결된 후 정보를 수집하는 것도 좋을 것이다

이를 비교하여 변경 사항과 객체가 메모리를 사용하는 방법을 확인할 수 있습니다.

NOTE
이러한 정보를 정기적으로 수집하거나 힙 덤프를 읽은 경험이 있는 경우 문제를 분석하는 데 하나의 힙 덤프 파일로 충분할 수 있습니다.

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

저장소 자체가 성공적으로 실행 중인 경우에도 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을 사용하여 웹 사이트가 로드되지 않거나 간헐적으로 실패합니다 the-website-does-not-load-or-fails-intermittently-with-java11

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. 인스턴스를 다시 시작합니다.

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

geometrixx-outdoor 페이지를 요청할 때 페이지를 찾을 수 없음 이 반환됨 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

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2