사용자 지정 독립형 설치

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

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

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

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

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

  • 파일 이름을 바꿀 때는 cq; 로서의 cq5-publish-p4503.jar.

  • 권장 사항 항상 포트 번호 접두사로 -p; cq5-publish-p4503.jar 또는 cq5-author-p6754.jar에서와 같습니다.

노트

이렇게 하면 포트 번호 추출에 사용되는 규칙을 채우는 데 대해 걱정할 필요가 없습니다.

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

를 사용하여 포트 번호를 변경할 수도 있습니다 -port start 명령의 옵션.

Java 11 고려 사항

oracle Java 11(또는 일반적으로 Java 8 이후 버전)을 실행하는 경우 AEM을 시작할 때 명령줄에 추가 스위치를 추가해야 합니다.

  • 다음 - -add-opens 에서 관련 반사 액세스 WARNING 메시지를 방지하려면 스위치를 추가해야 합니다 stdout.log
--add-opens=java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-opens=java.base/sun.net.www.protocol.jrt=ALL-UNNAMED --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED --add-opens=java.xml/com.sun.org.apache.xerces.internal.dom=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED -Dnashorn.args=--no-deprecation-warning
  • 또한 -XX:+UseParallelGC 잠재적인 성능 문제를 완화하도록 전환합니다.

다음은 Java 11에서 AEM을 시작할 때 추가 JVM 매개 변수가 어떻게 표시되어야 하는지에 대한 샘플입니다.

-XX:+UseParallelGC --add-opens=java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-opens=java.base/sun.net.www.protocol.jrt=ALL-UNNAMED --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED --add-opens=java.xml/com.sun.org.apache.xerces.internal.dom=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED -Dnashorn.args=--no-deprecation-warning

마지막으로 AEM 6.3에서 업그레이드된 인스턴스를 실행 중인 경우 다음 속성이 true 아래에 sling.properties:

  • felix.bootdelegation.implicit

실행 모드

모드 실행 특정 목적에 맞게 AEM 인스턴스를 조정할 수 있습니다. 예를 들어 작성자 또는 게시, 테스트, 개발, 인트라넷 등이 있습니다. 이러한 모드에서는 샘플 컨텐츠 사용을 제어할 수도 있습니다. 이 샘플 콘텐츠는 빠른 시작을 만들기 전에 정의되며 패키지, 구성 등을 포함할 수 있습니다. 이 기능은 샘플 컨텐츠 없이 설치를 효율적으로 유지하려는 경우 프로덕션 준비 설치에 특히 유용합니다. 자세한 내용은 다음을 참조하십시오.

파일 설치 공급자 추가

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

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

특히 몇 가지 사용 사례에서 흥미로운 부분입니다.

  • 개발 중에 파일 시스템에 내용을 입력하는 것이 더 쉬워질 수 있습니다.
  • 문제가 발생하면 웹 콘솔 및 리포지토리에 연결할 수 없습니다. 이를 통해 이 디렉토리에 추가 번들을 추가할 수 있으며 해당 번들이 설치됩니다.
  • 다음 crx-quickstart/install quickstart를 시작하기 전에 폴더를 만들고 추가 패키지를 저장할 수 있습니다.

Adobe Experience Manager as a Windows Service 설치 및 시작

노트

관리자로 로그온하는 동안 다음 절차를 수행하거나 관리자로 실행 컨텍스트 메뉴 선택.

관리자 권한이 있는 사용자로 로그온하는 것은 불충분한. 관리자 권한으로 로그온하지 않은 경우 받게 됩니다 액세스 거부 오류가 발생합니다.

AEM as a 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=-Xmx1792m

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

    instsrv.bat cq5

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

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

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

    chlimage_1-11

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

    chlimage_1-12

  6. 서비스가 실행 중임을 나타냅니다. AEM이 시작되고 prunsrv 실행 파일이 작업 관리자에 나타납니다. 웹 브라우저에서 AEM으로 이동합니다(예: https://localhost:4502 AEM 사용을 시작하려면 다음을 수행하십시오.

    chlimage_1-13

노트

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

노트

AEM을 서비스로 설치할 때 의 로그 디렉토리에 대한 절대 경로를 제공해야 합니다 com.adobe.xmp.worker.files.ncomm.XMPFilesNComm 구성 관리자에서 가져옵니다.

서비스를 제거하려면 정지 에서 서비스 컨트롤 패널이나 명령줄에서 폴더 및 형식으로 이동합니다 instsrv.bat -uninstall cq5. 서비스가 의 목록에서 제거됩니다 서비스 컨트롤 패널이나 명령줄에 있는 목록에서 net start.

임시 작업 디렉터리의 위치 재정의

Java 컴퓨터의 임시 폴더의 기본 위치는 다음과 같습니다 /tmp. AEM에서는 이 폴더도 사용합니다(예: 패키지 작성 시).

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

-Djava.io.tmpdir="/<*new-tmp-path*>"

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

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

Quickstart 파일에서 추가 옵션을 사용할 수 있습니다

추가 옵션 및 이름 변경 규칙은 -help 옵션을 통해 사용할 수 있는 Quickstart 도움말 파일에 설명되어 있습니다. 도움말에 액세스하려면 다음을 입력합니다.

  • java -jar cq-quickstart-6.5.0.jar -help
주의

이러한 옵션은 AEM 6.5의 원래 릴리스(6.5.0.0)부터 유효합니다. 이후 SP 릴리스에서 변경될 수 있습니다.

Loading quickstart properties: default
Loading quickstart properties: instance
Setting properties from filename '/Users/Desktop/AEM/cq-quickstart-6.5.0.jar'
--------------------------------------------------------------------------------
Adobe Experience Manager Quickstart (build 20190328)
--------------------------------------------------------------------------------
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
-nointeractive
         Start with no interactivity
-ll <level>
         Define launchpad log level (1 = error...4 = debug)
-n
         Do not install shutdown hook
-D<property>=<value>
         Additional framework properties.
-listener-port <listener-port>
         Set listener port number
-x <string>
         Run a Quickstart extension.
  Options for executing Quickstart extensions:

    -xargs <arg> [<arg> ...]
         Construct an arguments list for a Quickstart extension (e.g. -xargs --
         -arg1 val1 -arg2 val2).
--------------------------------------------------------------------------------
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 in "publish" mode,
         example: cq-publish-7502.jar
-dynamicmedia
         Include -dynamicmedia in the renamed jar filename to run in
         "dynamicmedia" mode, example: quickstart-dynamicmedia-4502.jar
-dynamicmedia_scene7
         Include -dynamicmedia_scene7 in the renamed jar filename to run in
         "dynamicmedia_scene7" mode, example:
         quickstart-dynamicmedia_scene7-p4502.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
  /Users/aemdocs/CQInstallationKits/AEM-65150-L8/crx-quickstart/logs.
--------------------------------------------------------------------------------

Amazon EC2 환경에 AEM 설치

Amazon EC2(Elastic Compute Cloud) 인스턴스에 AEM을 설치할 때 EC2 인스턴스에 작성자와 게시를 모두 설치하면 다음 절차에 따라 작성자 인스턴스가 올바르게 설치됩니다 AEM Manager 인스턴스 설치; 하지만 게시 인스턴스는 작성자가 됩니다.

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. 실행 모드를 다음으로 변경 게시 파일을 저장합니다.

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

설치 확인

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

  • https://localhost:8080/crx/de
    CRXDE Lite 콘솔.

  • https://localhost:8080/system/console
    웹 콘솔.

설치 후 작업

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

  • 자세한 내용은 Security 검사 목록 시스템 보안을 유지하는 데 필요한 작업
  • 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

예:
https://localhost:4502/crx/de/index.jsp

installcq_crxdelite

웹 콘솔 액세스

Adobe CQ 웹 콘솔에 액세스하려면 다음을 선택할 수 있습니다 OSGi 콘솔 시작 화면에서 또는 브라우저를 사용하여

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

예:
https://localhost:4502/system/console
또는 번들 페이지에 대해
https://localhost:4502/system/console/bundles

chlimage_1-14

자세한 내용은 웹 콘솔을 사용한 OSGi 구성 자세한 내용

문제 해결

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

Adobe Experience Manager 제거

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

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

노트

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

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

이 페이지에서는