Skip to content

AddOn Communities

Jump to bottom Edit New page
yasirgithub edited this page Dec 15, 2016 · 29 revisions

By selecting the "Communities" add-on when building a new Demo configuration, your environment will be setup for fully fledged Communities demos, with sample sites and content.

4 demo sites can be configured according to the following demo.communities.* Properties:

Property Default Value Description Package
.samples.communities true A generic Demo site for AEM Communities, created from a Community Site template leveraging all of the AEM Communities features. Works with AEM 6.1 and beyond Link
.samples.enablement true The reference Demo site for AEM Communities "Enablement" features. Works with AEM 6.1 FP1 and beyond. Requires MySQL and SCORM to be setup first Link
.samples.scoring false The reference Demo site for AEM Communities "Advanced gamification" features. Works with AEM 6.2 and beyond. Requires the Advanced Scoring packages (ant download_communities_advanced with VPN access) Link
.samples.weretail false A generic Demo site for AEM Communities, created as a sub-site for the AEM We.Retail demonstration site. Works with AEM 6.2 and beyond. Requires the We.Retail packages. (ant download_weretail) Link

Note: If not using the AEM Demo Machine "Communities" addon, you can also manually upload the respective packages as regular AEM package, then double-click on the Home page under /content/sites to go through a setup wizard for your own AEM instances.

Recommended Setup

In order to demonstrate the AEM Communities features, it is recommended to proceed as follows:

  • Install the required infrastructure
    • MongoDB and SOLR for MSRP (recommended Common Store)
    • MySQL and FFMEG for the Enablement features
  • Download the latest Feature Packs from the GUI
    • Set the "demo.communities.featurepack" property to the desired Feature Pack, e.g. "aem61-fp4" or "aem62-fp1" as per the files downloaded under /dist/communities/featurepacks
  • Set the "demo.communities.enablement" property to "true" if needed

MySQL

If you already are using MySQL, you can also point at an existing instance:

  • From the Demo Machine GUI, set the "demo.mysql.external" to "true" and verify the credentials

MongoDB

If you are already using MongoDB, you can point at an existing instance:

  • From the Demo Machine GUI, set the "demo.mongo.external" to "true" and verify the credentials

Demonstration Sites

Reference Demo Site

Primary forum, activity feeds and file sharing

Enablement features

Calendar, blog and analytics

Enablement Demo Site

Scoring Demo Site

We.Retail Demo Site

Detailed Installation Walkthrough

Here's an example of an end to end scenario to get a Demo Machine configured for demonstrating AEM Communities with the sample demo sites:

  1. Download the AEM Demo Machine
  2. It's better if you can clone it using GitHub, so that any changes or updates are kept in sync
  3. Only follow the steps (2a-2e) below to setup GitHub Desktop app to keep updates on AEM Demo Machine in sync, between the GitHub repository and your local computer, otherwise if you are manually downloading AEM Demo Machine, can skip to Step#2 below a. Download GitHub Desktop (https://desktop.github.com), available for Mac and Windows
    b. Sign into GitHub Desktop app (via Preferences>Accounts) and also sign in on GitHub.com where you download AEM Demo Machine from
    c. On GitHub.com, where you download AEM Demo Machine, click on the green "close or download" button and click "Open in Desktop"
    d. This should bring up GitHub desktop app and will ask you where you want to download AEM Demo Machine and then keep it in sync, choose the location on your computer where you want to install AEM Demo Machine and hit "Clone"
    e. This should install and setup the clone of AEM Demo Machine on your local computer, once done, you should see a "Synch" button in GitHub Desktop app on the top right, which you can use from time to time to ensure AEM Demo Machine updates are synced to your local computer
  4. If you downloaded from GitHub rather than cloning, then extract the zip file
  5. Put an AEM license file under /dist/license folder and make sure it says “license-aem6.properties”.
  6. (VPN) You can obtain the license file from this internal link, or use one of your previous AEM instances you’re running on your machine to get the license file. Partners and system integrators can use their own license obtained as part of the development license or partner program.
  7. Run the AEM Demo Machine GUI by double-clicking in “demomachine.jar” in the extracted folder
  8. Go to “Infrastructure > All in one setup” and let it finish
  9. This is going to download roughly 500Mb of software, so a good quality Internet access is required
  10. Add the path to FFMPEG binaries {demomachinehome}/ffmpeg to your system PATH variable
  11. Special instructions apply on Windows and Unix for MySQL
  12. (VPN) Setup the Marketing Cloud Integrations
  13. Download build-mac.properties
  14. Go to the section that says “Connecting to the Marketing Cloud”
  15. Get the build-mac.properties file by clicking on step 1’s link “Marketing Cloud demo properties”
  16. In the Demo Machine GUI, go to “New>Demo Properties”
  17. Click on Load in the Demo Machine GUI
  18. Browse and select the downloaded build-mac.properties file to load, once loaded you’ll see various properties checked
  19. Now perform the following, to update some additional properties:
  20. set the “AdobeID.user” property to [your Adobe ID username or email address]
  21. set the “AdobeID.password” property to [your Adobe ID password]
  22. set the "demo.communities.featurepack" property to the desired feature pack, e.g. "aem61-fp3" (without the double-quotes!) or "aem61-fp4" or "aem62-fp1"
  23. set the "demo.communities.enablement" property to "true" (without the double-quotes!)
  24. Hit save on the GUI window where properties are loaded and then hit apply
  25. Download latest hotfixes, without Step 7 you can't download the hotfixes
  26. Go to "Other > Download Latest Hotfixes (PackageShare)" in the Demo Machine GUI
  27. Download latest feature packs, without Step 7, you can’t download the packages
  28. Go to “Add-ons > Communities>Download Packages (PackageShare)” in the Demo Machine GUI
  29. (VPN) Download AEM jar file by going to “Other>AEM & License files (VPN)>Download AEM 6.x” in the Demo Machine GUI (6.1, 6.2...)
  30. In the Demo Machine GUI, go to New > Demo Environment
  31. demo config: Demo (Communities)
  32. topology: Author and Publish
  33. aem/cq .jar: aem61.jar or aem62.jar
  34. micro-kernel: tarmk
  35. communities: MSRP if possible, or JSRP if not
  36. Wait for the build to complete - approximately 20 minutes.
  37. Check the main Communities demo site on the Publish instance.

(VPN): Make sure you are on the Adobe VPN before starting this download. If you do not have access to the Adobe VPN, replace these steps accordingly.

Primary Demo Users

The main demo users and credentials are:

Configuring existing AEM instances

If you want to prepare your existing AEM author and publish instances for AEM Communities demo, without having the AEM instances setup by the demo machine:

  • From the Demo Machine GUI, set the "demo.external" to "true"
  • From the Demo Machine GUI, set the "demo.communities.upload" to "true"
  • From the Demo Machine GUI, run the "Add-on / Communities / Install add-on" command

lewkjer

Add a custom sidebar
Clone this wiki locally