Adobe Experience Manager (AEM), is a comprehensive content management solution for building websites, mobile apps and forms. And it makes it easy to manage your marketing content and assets.

Table of Contents

  1. Ensure Oracle JDK is installed.
  2. Download AEM jar and License file
  3. Create folder structure
  4. Naming conventions
  5. Installation & Usage
    1. Basic Installation
    2. Advanced Installation

Ensure Oracle JDK is installed.

  • prefer JDK 11 for AEM 6.5+
  • JDK 8 for below 6.5 versions.

Download AEM jar and License file


Create folder structure

  • Create a folder structure on your computer like the following:
    1
    2
    3
    ~/aem-sdk
    /author
    /publish

Naming conventions

  • Rename the downloaded AEM QuickStart JAR to aem-author-p4502.jar and place it beneath the /author directory. Add the license.properties file under /author directory.

    aem-author-p4502.jar - runs as ‘author’ on port ‘4502’. if you dont add port number it will fallback to default port in the sequence 4502/8080/8081/8082/8083/8084/random port

  • Rename the downloaded AEM QuickStart JAR to aem-publish-p4503.jar and place it beneath the /publish directory. Add the license.properties file under the /author directory.

    aem-publish-p4503.jar - runs as ‘publish’ on port ‘4503’. if you dont add port number it will fallback to default port in the sequence 4502/8080/8081/8082/8083/8084/random port


Installation & Usage

Basic Installation

Skip this step if you want advanced/development specific installation

  • Double-click the aem-author-p4502.jar file to install the Author instance. This will start the author instance, running on port 4502 on the local computer.

  • Double-click the aem-publish-p4503.jar file to install the Publish instance. This will start the Publish instance, running on port 4503 on the local computer.

  • To stop just click off on the Java applications running

  • To start again, Double-click the aem-author-p4502.jar/aem-publish-p4503.jar file.

    Stop-AEM-Server

Advanced Installation

  • In Terminal, Navigate to ~/aem-sdk/author. Run below command.

    1
    java -jar aem-author-p4502.jar -unpack
  • In Terminal, Navigate to ~/aem-sdk/publish. Run below command.

    1
    java -jar aem-publish-p4503.jar -unpack
  • In Terminal, Navigate to ~/aem-sdk/publish/crx-quickstart/bin. Edit file start.bat(MAC/Linux) OR start.exe(Windows) and change the below lines. Change CQ_PORT to 4503 and CQ_RUNMODE to Publish

    1
    2
    3
    4
    5
    6
    7
    8
    9
    ::* TCP port used for stop and status scripts
    if not defined CQ_PORT set CQ_PORT=4502

    ::* hostname of the interface that this server should listen to
    :: if not defined CQ_HOST set CQ_HOST=

    ::* runmode(s)
    ::* will not be used if repository is already present
    if not defined CQ_RUNMODE set CQ_RUNMODE=author
  • To START Author and Publish instances, Navigate to ~/aem-sdk/publish/crx-quickstart/bin and ~/aem-sdk/author/crx-quickstart/bin and run below command. Please note the processes will start in background.

    1
    ./start
  • To STOP Author and Publish instances, Navigate to ~/aem-sdk/publish/crx-quickstart/bin and ~/aem-sdk/author/crx-quickstart/bin and run below command.

    1
    ./stop
  • To check Server status for Author and Publish instances, Navigate to ~/aem-sdk/publish/crx-quickstart/bin and ~/aem-sdk/author/crx-quickstart/bin and run below command.

    1
    ./status