Skip to content
Bertrand de Coatpont edited this page Oct 20, 2015 · 10 revisions

MongoDB (MacOS)

The Demo Machine includes ways to setup a local MongoDB server on MacOS. This allows for demos requiring the use of AEM Communities with the "MSRP" persistence option and AEM/MongoMK configurations in general.

The MongoDB server can be started/stopped from the Demo Machine [GUI](User Interface) (Infrastructure menu) and via the ANT start_mongo and stop_mongo targets. The download_mongo and intall_mongo targets take care of download and installation on MacOS.

On Windows/Unix, you need to setup MongoDB separately, then update the demo.mongo.external=true property, making sure all the demo.mongo.* properties are correct (port, credentials, path to binary)

See here for the official AEM documentation on setting up MongoDB for AEM Communities.

MySQL (MacOS)

The Demo Machine includes ways to setup a local MySQL server on MacOS. This allows for demos requiring the use of AEM Communities with the "Enablement" add-on option (demo.communities.enablement=true) and AEM/RDBMK configurations in general.

The MySQL server can be started/stopped from the Demo Machine [GUI](User Interface) (Infrastructure menu) and via the ANT start_mysql and stop_mysql targets. The download_mysql and intall_mysql targets take care of download and installation on MacOS.

On Windows/Unix, you need to setup MySQL separately, then update the demo.mysql.external=true property, making sure all the demo.mysql.* properties are correct (port, credentials)

See here for the official AEM documentation on setting up MySQL for AEM Communities, especially regarding character set configuration.

Apache SOLR (MacOS, Unix, Windows)

The Demo Machine includes ways to setup a local Apache SOLR server. This allows for demos requiring the use of AEM Communities with the "MSRP" persistence option and AEM/SOLR integrations in general.

The SOLR server can be started/stopped from the Demo Machine [GUI](User Interface) (Infrastructure menu) and via the ANT start_solr and stop_solr targets. The download_solr and intall_solr targets take care of download and installation on all platforms.

Apache James SMTP/POP (MacOS, Unix, Windows)

The Demo Machine includes ways to setup a local SMTP/POP/IMAP server, Apache James v3. This allows for demos requiring the use of email (inbound and outbound) with local server and demo users.

The email server is setup with inboxes for the users defined in the demo.emailserver.users.* properties and the domains defined in the demo.emailserver.domains.* properties.

Your can configure your preferred email client (e.g. Mac Mail) for these inboxes as per the demo.emailserver.* properties, e.g.:

  • SMTP server is on port 1025 (no SSL), driven by demo.emailserver.smtp property
  • POP server is on port 1110 (no SSL), driven by demo.emailserver.pop property
  • password is "password", driven by demo.emailserver.password property
  • user name is the email address

The email server can be started/stopped from the Demo Machine [GUI](User Interface) (Infrastructure menu) and via the ANT start_james and stop_james targets. The james_config target lists the registered users and domains.

FFMPEG (MacOS)

The demo machine includes ways for to setup a local FMPEG install on MacOS. This allows for video thumbnails and renditions to be generated, this is used by AEM Assets and AEM Communities.

Once installed, don't forget to add the /ffmpeg folder to your local PATH variable (e.g. in ~/.bash_profile on MacOS or in the system environment variables on Windows)

On Windows/Unix, you have to install FFMPEG separately.

FFMPEG can be downloaded/installed from the Demo Machine [GUI](User Interface) (Infrastructure menu) and via the ANT download_ffmpeg and install_ffmpeg targets.

FFMPEG on OSX

On MacOS, you can also do:

  • brew install ffmpeg (assuming you have installed brew)

FFMPEG on Unix/CentOS

On CentOS, you can also do the following:

FFMPEG on Unix/RHEL

On RedHat you can also do the following: