Skip to content
Bertrand de Coatpont edited this page Feb 5, 2018 · 59 revisions

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](AddOn Sites), [Assets](AddOn Assets), [Communities](AddOn Communities), [Mobile](AddOn Mobile) and [Forms](AddOn 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, AEM 6.2, AEM 6.3 and current internal 6.4 snapshots, on Windows, OS X, Linux and Docker.

Introduction

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

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 --depth=1 git@github.com: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

Note: when cloning, --depth=1 will get you the most recent version (HEAD) only (~50Mb) - while a complete git clone will get you all previous commits.

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. For users with Adobe VPN access, setup the Adobe-only properties (one click setup from the properties window)
  8. The integrations properties for Analytics, Target, Social, etc.
  9. 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 and the Cygwin /bin folder into your PATH environment variable
    • 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