사용자 지정 독립형 설치

이 섹션에서는 독립형 AEM 인스턴스를 설치할 때 사용할 수 있는 옵션에 대해 설명합니다. AEM 6을 새로 설치한 후 백엔드 저장소 유형을 선택하는 방법에 대한 자세한 내용은 스토리지 요소를 참조할 수도 있습니다.

파일의 이름을 변경하여 포트 번호 변경

AEM의 기본 포트는 4502입니다. 해당 포트를 사용할 수 없거나 이미 사용 중인 경우 Quickstart는 다음과 같이 첫 번째 사용 가능한 포트 번호를 사용하도록 자동으로 구성됩니다.4502, 8080, 8081, 8082, 8083, 8084, 8085, 888, 9362, <random>

빠른 시작 jar 파일의 이름을 변경하여 파일 이름에 포트 번호를 포함하도록 포트 번호를 설정할 수도 있습니다.예: cq5-publish-p4503.jar 또는 cq5-author-p6754.jar.

quickstart jar 파일의 이름을 바꿀 때 따라야 할 다양한 규칙이 있습니다.

  • 파일 이름을 바꿀 때 cq5-publish-p4503.jar에서와 같이 cq;으로 시작해야 합니다.

  • 항상 포트 번호에 -p; 접두사를 지정하는 것이 좋습니다.cq5-publish-p4503.jar 또는 cq5-author-p6754.jar의 포맷을 참조하십시오.

노트

이는 포트 번호를 추출하는 데 사용되는 규칙을 완전히 채우는 데 대해 걱정할 필요가 없도록 하기 위한 것입니다.

  • 포트 번호는 4자리 또는 5자리여야 합니다.
  • 이 숫자는 대시 뒤에 와야 합니다.
  • 파일 이름에 다른 숫자가 있으면 포트 번호 앞에 -p가 있어야 합니다.
  • 파일 이름 시작 부분에 있는 "cq5" 접두사가 무시됩니다.
노트

시작 명령에서 -port 옵션을 사용하여 포트 번호를 변경할 수도 있습니다.

실행 모드

모바일 실행: 특정 목적을 위해 AEM 인스턴스를 조정할 수 있습니다.예를 들어 작성 또는 게시, 테스트, 개발, 인트라넷 등을 할 수 있습니다. 이러한 모드를 사용하면 샘플 컨텐츠의 사용을 제어할 수 있습니다. 이 샘플 컨텐츠는 quickstart를 만들기 전에 정의되었으며 패키지, 구성 등을 포함할 수 있습니다. 이 기능은 샘플 컨텐츠 없이 설치를 계속 유지하려는 경우 바로 사용할 수 있는 설치 환경에 특히 유용합니다. 자세한 내용은 다음을 참조하십시오.

파일 설치 공급자 추가

기본적으로 crx-quickstart/install 폴더가 파일에 대해 감시됩니다.
이 폴더는 존재하지 않지만 런타임에 만들 수 있습니다.

번들, 구성 또는 컨텐츠 패키지를 이 디렉토리에 넣으면 자동으로 선택되어 설치됩니다. 제거되면 제거됩니다.
번들, 컨텐츠 패키지 또는 구성을 저장소에 배치하는 또 다른 방법입니다.

이 기능은 다음과 같은 여러 사용 경우에 특히 유용합니다.

  • 개발 중에 파일 시스템에 내용을 삽입하는 것이 더 쉽습니다.
  • 문제가 발생하면 웹 콘솔 및 저장소에 연결할 수 없습니다. 이 코드를 사용하면 이 디렉토리에 추가 번들을 넣을 수 있으며 번들을 설치해야 합니다.
  • quickstart를 시작하기 전에 crx-quickstart/install 폴더를 만들 수 있으며 추가 패키지를 거기에 배치할 수 있습니다.

Adobe Experience Manager을 Windows 서비스로 설치 및 시작

노트

관리자로 로그온하는 동안 다음 절차를 수행하거나 관리자로 실행 컨텍스트 메뉴 선택을 사용하여 이러한 단계를 시작/실행해야 합니다.

관리자 권한이 있는 사용자로 로그온하는 것은 불충분한​입니다. 이러한 단계를 완료할 때 관리자로 로그온하지 않은 경우 액세스 거부 오류를 수신합니다.

AEM을 Windows 서비스로 설치하고 시작하려면 다음을 수행합니다.

  1. 텍스트 편집기에서 crx-quickstart\opt\helpers\instsrv.bat 파일을 엽니다.

  2. 64비트 Windows 서버를 구성하는 경우 운영 체제에 따라 prunsrv의 모든 인스턴스를 다음 명령 중 하나로 바꿉니다.

    • prunsrv_amd64
    • prunsrv_ia64

    이 명령은 32비트 Java 대신 64비트 Java에서 Windows 서비스 데몬을 시작하는 적절한 스크립트를 호출합니다.

  3. 프로세스가 두 개 이상의 프로세스로 변환되지 않도록 하려면 최대 더미 크기 및 PermGen JVM 매개변수를 늘립니다. set jvm_options 명령을 찾아 다음과 같이 값을 설정합니다.

    set jvm_options=-XX:MaxPermSize=256M;-Xmx1792m

  4. 명령 프롬프트를 열고 현재 디렉토리를 AEM 설치의 crx-quickstart/opt/helpers 폴더로 변경한 다음 다음 다음 명령을 입력하여 서비스를 생성합니다.

    instsrv.bat cq5

    서비스가 만들어졌는지 확인하려면 관리 도구 제어판에서 서비스를 열거나 명령 프롬프트에 start services.msc을 입력합니다. cq5 서비스가 목록에 나타납니다.

  5. 다음 중 하나를 수행하여 서비스를 시작합니다.

    • 서비스 제어판에서 cq5를 클릭하고 시작을 클릭합니다.

    chlimage_1-71

    • 명령줄에서 net start cq5를 입력합니다.

    chlimage_1-72

  6. 서비스가 실행 중임을 나타냅니다. AEM 시작 및 prunsrv 실행 파일이 작업 관리자에 나타납니다. 웹 브라우저에서 AEM으로 이동하여(예: http://localhost:4502) AEM 사용을 시작합니다.

    chlimage_1-73

노트

instsrv.bat 파일의 속성 값은 Windows 서비스를 만들 때 사용됩니다. instsrv.bat에서 속성 값을 편집하는 경우 서비스를 제거한 다음 다시 설치해야 합니다.

노트

AEM을 서비스로 설치할 때 Configuration Manager의 com.adobe.xmp.worker.files.ncomm.XMPFilesNComm에 로그 디렉토리의 절대 경로를 제공해야 합니다.

서비스를 제거하려면 서비스 제어판 또는 명령줄에서 중지​를 클릭하고 instsrv.bat -uninstall cq5를 입력합니다. 서비스 제어판 또는 net start를 입력할 때 명령줄에서 서비스가 제거됩니다.

임시 작업 디렉터리 위치를 다시 정의하는 중

java 컴퓨터의 임시 폴더의 기본 위치는 /tmp입니다. AEM에서는 패키지를 빌드할 때 이 폴더도 사용합니다.

임시 폴더의 위치(예: 사용 가능한 공간이 많은 디렉토리가 필요한 경우)를 변경하려면 JVM 매개 변수를 추가하여 <new-tmp-path>을 정의합니다.

-Djava.io.tmpdir="/%3Cnew-tmp-path%3E?lang=ko"

다음 중 하나를 수행합니다.

  • 서버 시작 명령줄
  • serverctl 또는 시작 스크립트의 CQ_JVM_OPTS 환경 매개 변수

Quickstart 파일에서 사용할 수 있는 추가 옵션

추가 옵션 및 이름 바꾸기 규칙은 -help 옵션을 통해 사용 가능한 빠른 시작 도움말 파일에 설명되어 있습니다. 도움말에 액세스하려면 다음을 입력합니다.

  • java -jar cq5-<version>.jar -help
Loading quickstart properties: default
Loading quickstart properties: instance
Setting properties from filename '/Users/Desktop/AEM/cq-quickstart-5.6.0.jar'
-----------------------------------------------------------------------------
---
Adobe Experience Manager Quickstart (build 20130129)                            
-----------------------------------------------------------------------------
---
Usage:                                                                          
 Use these options on the Quickstart command line.                              
-----------------------------------------------------------------------------
---

-help (--help,-h)
         Show this help message                                                 
-quickstart.server.port (-p,-port) <port>
         Set server port number                                                 
-contextpath (-c,-org.apache.felix.http.context_path) <contextpath>
         Set context path                                                       
-debug <port>
         Enable Java Debugging on port number; forces forking                   
-gui 
         Show GUI if running on a terminal                                      
-nobrowser (-quickstart.nobrowser)
         Do not open browser at startup                                         
-unpack
         Unpack installation files only, do not start the server (implies       
         -verbose)                                                              
-v (-verbose)
         Do not redirect stdout/stderr to files and do not close stdin          
-nofork
         Do not fork the JVM, even if not running on a console                  
-fork
         Force forking the JVM if running on a console, using recommended       
         default memory settings for the forked JVM.                            
-forkargs <args> [<args> ...]
         Additional arguments for the forked JVM, defaults to '-Xmx1024m        
         -XX:MaxPermSize=256m '.  Use -- to specify values starting with -,     
         example: '-forkargs -- -server'                                        
-a (--interface) <interface>
         Optional IP address (interface) to bind to                             
-pt <string>
         Process type (main/fork) - do not use directly, used when forking a    
         process                                                                
-r <string> [<string> [<string> [<string> [<string> [<string> [<string> [<string> [<string> [<string>]]]]]]]]]
         Runmode(s) - Use this to define the run mode(s)                        
-b <string>
         Base folder - defines the path under which the quickstart work folder  
         is created                                                             
-low-mem-action <string>
         Low memory action - what to do if memory is insufficient at startup    
-use-control-port
         Start a control port                                                   
-ll <level>
         Define launchpad log level (1 = error...4 = debug)                     
-----------------------------------------------------------------------------
---
Quickstart filename options                                                     
-----------------------------------------------------------------------------
---
Usage:                                                                          
 Rename the jar file, including one of the patterns shown below, to set the     
corresponding option. Command-line options have priority on these filename      
patterns.                                                                       
-----------------------------------------------------------------------------
---

-NNNN
         Include -NNNN.jar or -pNNNN in the renamed jar filename to run on port 
         NNNN, for example: quickstart-8085.jar                                 
-nobrowser
         Include -nobrowser in the renamed jar filename to avoid opening the    
         browser at startup, example: quickstart-nobrowser-8085.jar             
-publish
         Include -publish in the renamed jar filename to run cq5 in "publish"   
         mode, example: cq5-publish-7502.jar                                    
-----------------------------------------------------------------------------
---
The license.properties file
-----------------------------------------------------------------------------
---
  The license.properties file stores licensing information, created from the    
  licensing form displayed on first startup and stored in the folder from where 
  Quickstart is run.                                                            
-----------------------------------------------------------------------------
---
Log files
-----------------------------------------------------------------------------
---
  Once Quickstart has been unpacked and started, log files can be found under   
  ./crx-quickstart/logs.                                                        
-----------------------------------------------------------------------------
---

Amazon EC2 환경에 AEM 설치

Amazon EC2(Elastic Compute Cloud) 인스턴스에 AEM을 설치할 때 작성자와 게시를 모두 EC2 인스턴스에 설치하는 경우, AEM🔗 인스턴스의 설치 방법에 대한 절차를 따라 작성자 인스턴스가 올바르게 설치됩니다.하지만 게시 인스턴스는 작성자가 됩니다.

EC2 환경에 게시 인스턴스를 설치하기 전에 다음을 수행하십시오.

  1. 인스턴스를 처음으로 시작하기 전에 게시 인스턴스에 대한 jar 파일의 압축을 해제합니다. 파일의 압축을 풀려면 다음 명령을 사용합니다.

    java -jar quickstart.jar -unpack
    
    노트

    인스턴스를 처음 시작하는 모드 after​를 변경하는 경우 실행 모드를 변경할 수 없습니다.

  2. 다음을 실행하여 인스턴스를 시작합니다.

    java -jar quickstart.jar -r publish
    
    주의

    위의 명령을 실행하여 인스턴스를 압축 해제한 후 먼저 실행해야 합니다. 그렇지 않으면 quickstart.properties 채우기가 생성되지 않습니다. 이 파일이 없으면 향후 AEM 업그레이드에 장애가 발생합니다.

  3. bin 폴더에서 start 스크립트를 열고 다음 섹션을 확인하십시오.

    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='author'
    fi
    
  4. 실행 모드를 publish​로 변경하고 파일을 저장합니다.

    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='publish'
    fi
    
  5. 인스턴스를 중지하고 start 스크립트를 실행하여 다시 시작합니다.

설치 확인 중

다음 링크를 사용하여 설치가 작동되는지 확인할 수 있습니다(모든 예는 인스턴스가 localhost의 포트 8080에서 실행 중이며, CRX는 /crx 및 Launchpad 아래에 설치됨).

  • http://localhost:8080/crx/de

    CRXDE Lite 콘솔.

  • http://localhost:8080/system/console

    웹 콘솔.

설치 후 작업

AEM WCM을 구성하는 방법은 여러 가지가 있지만 특정 작업을 수행하거나 설치 후 즉시 검토해야 합니다.

  • 시스템이 안전한지 확인하는 데 필요한 작업은 보안 검사 목록을 참조하십시오.
  • AEM WCM과 함께 설치되는 기본 사용자 및 그룹 목록을 검토합니다. 다른 계정에 대해 조치를 취할 것인지 확인하십시오. 자세한 내용은 보안 및 사용자 관리를 참조하십시오.

CRXDE Lite 액세스 및 웹 콘솔

AEM WCM이 시작되면 다음 항목에 액세스할 수도 있습니다.

  • CRXDE Lite - 저장소 액세스 및 관리에 사용
  • 웹 콘솔 - OSGi 번들(OSGi 콘솔이라고도 함)을 관리하거나 구성하는 데 사용됩니다.

CRXDE Lite 액세스

CRXDE Lite을 열려면 시작 화면에서 CRXDE Lite​을 선택하거나 브라우저를 사용하여

 https://<<i>host</i>>:<<i>port</i>>/crx/de/index.jsp

예:
http://localhost:4502/crx/de/index.jsp ``

installcq_crxdelite

웹 콘솔 액세스

Adobe CQ 웹 콘솔에 액세스하려면 시작 화면에서 OSGi 콘솔​을 선택하거나 브라우저를 사용하여

 https://<<i>host</i>>:<<i>port</i>>/system/console

예:
http://localhost:4502/system/console
또는 번들 페이지의 경우
http://localhost:4502/system/console/bundles

chlimage_1-74

자세한 내용은 웹 콘솔과 함께 OSGi 구성을 참조하십시오.

문제 해결

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

Adobe Experience Manager 제거

AEM은 단일 디렉토리에 설치되므로 제거 유틸리티를 사용할 필요가 없습니다. AEM 제거 방법은 원하는 방법과 계속 사용하는 스토리지에 따라 다르지만, 전체 설치 디렉토리를 삭제하는 것만큼 간단하게 제거할 수 있습니다.

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

노트

Adobe은 AEM을 삭제하기 전에 저장소를 백업하는 것이 좋습니다. 전체 <cq-installation-directory>를 삭제하면 저장소가 삭제됩니다. 다른 폴더를 삭제하기 전에 저장소 데이터를 유지하려면 <cq-installation-directory>/crx-quickstart/repository 폴더를 다른 위치로 이동하거나 복사하십시오.

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

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now