Application Server 설치 application-server-install

NOTE
JARWAR은(는) AEM(Adobe Experience Manager)가 출시된 파일 유형입니다. 이러한 형식은 Adobe이 약속한 지원 수준에 맞게 품질 보증을 받고 있습니다.

이 섹션에서는 애플리케이션 서버와 함께 Adobe Experience Manager(AEM)를 설치하는 방법을 설명합니다. 개별 애플리케이션 서버에 대해 제공된 특정 지원 수준에 대한 자세한 내용은 지원되는 플랫폼 섹션을 참조하십시오.

다음 애플리케이션 서버의 설치 단계가 설명되어 있습니다.

웹 애플리케이션 설치, 서버 구성 및 서버 시작 및 중지 방법에 대한 자세한 내용은 해당 애플리케이션 서버 설명서를 참조하십시오.

NOTE
WAR 배포에서 Dynamic Media을 사용하는 경우 Dynamic Media 설명서를 참조하세요.

일반 설명 general-description

응용 프로그램 서버에 AEM 설치 시 기본 동작 default-behaviour-when-installing-aem-in-an-application-server

AEM은 단일 war 파일로 제공되며,

배포된 경우 기본적으로 다음 상황이 발생합니다.

  • 실행 모드는 author입니다.

  • 인스턴스(Repository, Felix OSGI 환경, 번들 등)가 ${user.dir}/crx-quickstart에 설치되어 있습니다. ${user.dir}이(가) 현재 작업 디렉터리이며 crx-quickstart의 이 경로는 sling.home입니다.

  • 컨텍스트 루트는 war 파일 이름입니다(예: aem-6).

구성 configuration

다음과 같은 방법으로 기본 동작을 변경할 수 있습니다.

  • 실행 모드 : 배포 전에 AEM war 파일의 WEB-INF/web.xml 파일에서 sling.run.modes 매개 변수를 구성합니다.

  • sling.home: 배포하기 전에 AEM war 파일의 WEB-INF/web.xml파일에서 sling.home 매개 변수를 구성합니다.

  • 컨텍스트 루트: AEM war 파일 이름 바꾸기

Publish 설치 publish-installation

게시 인스턴스를 배포하려면 실행 모드를 게시로 설정해야 합니다.

  • AEM war 파일에서 WEB-INF/web.xml 압축을 풉니다.
  • 게시할 sling.run.modes 매개 변수 변경
  • web.xml 파일을 AEM war 파일로 다시 압축
  • AEM war 파일 배포

설치 확인 installation-check

모두 설치되었는지 확인하려면 다음을 수행할 수 있습니다.

  • error.log파일을 추적하여 모든 콘텐츠가 설치되었는지 확인합니다.
  • /system/console에서 모든 번들이 설치되어 있는지 확인합니다.

동일한 애플리케이션 서버에 두 개의 인스턴스 two-instances-on-the-same-application-server

데모용으로 작성자 및 게시 인스턴스를 하나의 애플리케이션 서버에 설치하는 것이 적절할 수 있습니다. 이를 위해 다음을 수행합니다.

  1. 게시 인스턴스의 sling.home 변수 및 sling.run.modes 변수를 변경합니다.
  2. AEM war 파일에서 WEB-INF/web.xml 파일의 압축을 풉니다.
  3. sling.home 매개 변수를 다른 경로로 변경합니다(절대 및 상대 경로가 가능).
  4. 게시 인스턴스에 게시하도록 sling.run.modes 를 변경합니다.
  5. web.xml 파일을 다시 압축합니다.
  6. war 파일의 이름이 다르도록 이름을 변경합니다. 예를 들어 한 이름은 aemaauthor.war로 바뀌고 다른 이름은 aempublish.war로 바뀝니다.
  7. 더 높은 메모리 설정을 사용하십시오. 예를 들어 기본 AEM 인스턴스는 -Xmx3072m을(를) 사용합니다
  8. 두 웹 애플리케이션을 배포합니다.
  9. 배포 후 두 웹 응용 프로그램을 중지합니다.
  10. 작성자 및 게시 인스턴스 모두에서 sling.properties 파일의 속성 felix.service.urlhandlers=false 가 false 로 설정되었는지 확인합니다(기본적으로 true로 설정됨).
  11. 두 웹 애플리케이션을 다시 시작합니다.

애플리케이션 서버 설치 절차 application-servers-installation-procedures

WebSphere® 8.5 websphere

배포하기 전에 위의 일반 설명을 읽으십시오.

서버 준비

  • 기본 인증 헤더가 통과하도록 허용:

    • AEM에서 사용자를 인증하는 한 가지 방법은 WebSphere® 서버의 전역 관리 보안을 비활성화하는 것입니다. 이렇게 하려면 보안 > 전역 보안으로 이동하여 관리 보안 활성화 확인란을 선택 취소하고 서버를 저장한 다음 다시 시작합니다.
  • "JAVA_OPTS= -Xmx2048m" 설정

  • 컨텍스트 루트 = / 를 사용하여 AEM을 설치하려면 기존 기본 웹 응용 프로그램의 컨텍스트 루트를 변경합니다.

AEM 웹 응용 프로그램 배포

  • AEM war 파일 다운로드

  • 필요한 경우 web.xml에서 구성 수행(일반 설명의 위 참조)

    • WEB-INF/web.xml 파일 압축 풀기
    • sling.run.modes 매개 변수를 게시로 변경
    • sling.home 초기 매개 변수의 주석 처리를 제거하고 필요에 따라 이 경로를 설정합니다.
    • web.xml 파일 다시 압축
  • AEM war 파일 배포

    • 컨텍스트 루트를 선택합니다. 슬링 실행 모드를 설정하려면 배포 마법사의 자세한 단계를 선택한 다음 마법사의 6단계에서 지정해야 합니다.
  • AEM 웹 애플리케이션 시작

JBoss® EAP 6.3.0/6.4.0 jboss-eap

배포하기 전에 위의 일반 설명을 읽으십시오.

JBoss® 서버 준비

conf 파일에서 메모리 인수를 설정합니다(예: standalone.conf).

  • JAVA_OPTS="-Xms64m -Xmx2048m"

배포 스캐너를 사용하여 AEM 웹 응용 프로그램을 설치하는 경우 인스턴스의 xml 파일에서 deployment-timeout 특성을 설정하는 deployment-timeout,을(를) 늘리는 것이 좋습니다(예: configuration/standalone.xml):

<subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1">
            <deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" deployment-timeout="1000"/>
</subsystem>

AEM 웹 응용 프로그램 배포

  • JBoss® 관리 콘솔에서 AEM 웹 애플리케이션을 업로드합니다.

  • AEM 웹 애플리케이션을 활성화합니다.

Oracle WebLogic 12.1.3/12.2 oracle-weblogic

배포하기 전에 위의 일반 설명을 읽으십시오.

관리 서버만 있는 간단한 서버 레이아웃을 사용합니다.

WebLogic Server 준비

  • ${myDomain}/config/config.xml보안 구성 섹션에 추가:

  • VM 메모리 설정 늘리기:

    • ${myDomain}/bin/setDomainEnv.cmd 열기(resp .sh) WLS_MEM_ARGS를 검색합니다. WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m 집합과 같이 설정합니다.
    • WebLogic Server 다시 시작
  • ${myDomain}에서 패키지 폴더를 만들고 cq 폴더 및 그 안에 플랜 폴더를 만듭니다.

AEM 웹 응용 프로그램 배포

  • AEM war 파일 다운로드

  • AEM war 파일을 ${myDomain}/packages/cq 폴더에 넣습니다.

  • 필요한 경우 WEB-INF/web.xml에서 구성하십시오(일반 설명의 위 참조).

    • WEB-INF/web.xml파일 압축 풀기
    • sling.run.modes 매개 변수를 게시로 변경
    • sling.home 초기 매개 변수의 주석을 제거하고 필요에 따라 이 경로를 설정합니다(일반 설명 참조).
    • web.xml 파일 다시 압축
  • AEM war 파일을 애플리케이션으로 배포(다른 설정의 경우 기본 설정 사용)

  • 설치하는 데 시간이 걸릴 수 있습니다…

  • 일반 설명에서 위에 언급된 대로 설치가 완료되었는지 확인합니다(예: error.log 추적).

  • WebLogic /console에서 웹 응용 프로그램의 구성 탭에서 컨텍스트 루트를 변경할 수 있습니다.

Tomcat 8/8.5 tomcat

배포하기 전에 위의 일반 설명을 읽으십시오.

  • Tomcat 서버 준비

    • VM 메모리 설정 늘리기:

      • bin/catalina.bat(UNIX의 경우 catalina.sh 다시 ®)에서 다음 설정을 추가합니다.
      • set "JAVA_OPTS= -Xmx2048m
    • Tomcat을 사용하면 설치 시 관리자 또는 관리자가 액세스할 수 없습니다. 따라서 다음 계정에 대한 액세스를 허용하려면 tomcat-users.xml을(를) 수동으로 편집해야 합니다.

      • 관리자 및 관리자에 대한 액세스 권한을 포함하도록 tomcat-users.xml을(를) 편집합니다. 구성은 다음 예제와 유사해야 합니다.

        code language-xml
        <?xml version='1.0' encoding='utf-8'?>
        <tomcat-users>
        role rolename="manager"/>
        role rolename="tomcat"/>
        <role rolename="admin"/>
        <role rolename="role1"/>
        <role rolename="manager-gui"/>
        <user username="both" password="tomcat" roles="tomcat,role1"/>
        <user username="tomcat" password="tomcat" roles="tomcat"/>
        <user username="admin" password="admin" roles="admin,manager-gui"/>
        <user username="role1" password="tomcat" roles="role1"/>
        </tomcat-users>
        
    • 컨텍스트 루트 "/"와 함께 AEM을 배포하려면 기존 ROOT 웹 앱의 컨텍스트 루트를 변경해야 합니다.

      • ROOT 웹 앱 중지 및 배포 취소
      • tomcat의 webapps 폴더에서 ROOT.war 폴더 이름 바꾸기
      • 웹 앱 다시 시작
    • Manager-gui를 사용하여 AEM 웹 애플리케이션을 설치하는 경우 기본적으로 50MB의 업로드 크기만 허용하므로 업로드된 파일의 최대 크기를 늘려야 합니다. 이를 위해 관리자 웹 응용 프로그램의 web.xml을 엽니다.

      webapps/manager/WEB-INF/web.xml

      max-file-size 및 max-request-size를 최소 500MB로 늘립니다. 이러한 web.xml 파일의 다음 multipart-config 예를 참조하십시오.

      code language-xml
      <multipart-config>
      <!-- 500MB max -->
      <max-file-size>524288000</max-file-size>
      <max-request-size>524288000</max-request-size>
      <file-size-threshold>0</file-size-threshold>
      </multipart-config>
      
  • AEM 웹 응용 프로그램 배포

    • AEM war 파일을 다운로드합니다.

    • 필요한 경우 web.xml에서 구성을 만듭니다(일반 설명의 위 참조).

      • WEB-INF/web.xml 파일의 압축을 풉니다.
      • sling.run.modes 매개 변수를 게시로 변경합니다.
      • sling.home 초기 매개 변수의 주석 처리를 제거하고 필요에 따라 이 경로를 설정합니다.
      • web.xml 파일을 다시 압축합니다.
    • AEM war 파일을 루트 웹 앱으로 배포하려면 이름을 ROOT.war로 변경합니다. aemaauthor를 컨텍스트 루트로 사용하려면 이름을 aemaauthor.war로 바꿉니다.

    • tomcat의 webapps 폴더에 복사합니다.

    • AEM이 설치될 때까지 기다립니다.

문제 해결 troubleshooting

설치 중에 발생할 수 있는 문제 처리에 대한 자세한 내용은 다음을 참조하십시오.

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