Home

Welcome to the AEM Demo Machine wiki!

Summary

The AEM Demo Machine consists of a [graphical user interface](User Interface), scripts and packages to install, to manage and to run demos for AEM [Sites](Scenario Sites), [Assets](Scenario Assets), [Communities](Scenario Communities), [Apps](Scenario Apps) and [Forms](Scenario Forms), which in most situations require more setup than starting a QuickStart instance, and sometimes additional infrastructure such as MongoDB, SOLR, MySQL, FFMPEG or email servers.

Built using Apache ANT, the AEM Demo Machine accepts a number of properties and [targets](Command Line).

The AEM Demo Machine was tested successfully with CQ 5.5, CQ 5.6.1, AEM 6.0, AEM 6.1 and current AEM 6.2 snapshots, on Windows, MacOS and Linux.

#Introduction Click here to view an introduction video to the AEM Demo Machine (13 minutes)

Dashboard:

New demo environment:

Installation

Two options are available to get the AEM Demo Machine installed:

1. Preferably, clone the aem-demo-machine Git project on your system
2. Configure your GitHub account for SSH access
3. Run the following command: "git clone [email protected]:Adobe-Marketing-Cloud/aem-demo-machine.git"
4. Periodically run the "git pull" command to get the latest updates
5. Or if you don't want to rely on Git, Download the Demo Machine from the Git home page

Getting Started

The AEM Demo Machine can be experienced from a Graphical User Interface or via Command Line. It is recommended to get started with the Graphical User Interface:

1. Double-click on demomachine.jar to get the Demo Machine GUI
2. Put a valid AEM license file named license-aem6.properties in the /dist/license folder
3. Download or put a valid AEM .jar file in the /dist/bin folder
4. Configure your personal properties, especially
5. The AdobeID.user and AdobeID.password properties for downloads from PackageShare
6. The demo.admin.* properties with your first name, last name, short bio and profile picture
7. The integrations properties for Analytics, Target, Social, etc.
8. Use the "New / Demo Environment" menu option to create your first demo environment!

See a detailed walkthrough for the AEM Communities demo scenarios

Prerequisites

• MacOS or Windows7/8 or Linux
  • On Windows, please install Cygwin, making sure to include the "curl" package
  • On Windows, the cygwin bin folder must be added to your environmental variables PATH. Instructions
• Java7 or Java8
  • Open a terminal, make sure that "java -version" returns Java version 7 or later
    • Note: Jenv is a very convenient tool to run multiple JDKs on MacOS
• At least one CQ or AEM .jar file
  • You can download most releases from the AEM Demo Machine GUI (Download menu option)
  • Or you can run the "ant download_snapshot" command which will download the latest AEM build
• At least one CQ or AEM license file
• Memory requirements
  • The default memory settings are designed for 16Gb laptops or servers. Please update the memory settings if needed, e.g. for 8Gb laptops:
    • AdobeAEM.memorymin=512m
    • AdobeAEM.memorymax=1024m