Getting started with aem
Remarks#
Adobe Experience Manager (AEM) is part of the Adobe Marketing Cloud. Itβs initially a content management platform but now has expanded to
Installation or Setup
AEM can be installed as a standalone executable JAR file or through web application servers, such as JBoss and WebSphere, as a WAR file.
Prerequisites
AEM 6.2 needs at minimum the following in order to run
- Java Runtime Environment (JRE) 1.8x (64bit)
- 5GB of free disk space for installation
- 2GB of RAM
Standalone installation
The standalone installation is the simplest. It only requires quickstart jar file. This is provided by Adobe to you or your company.
Simply double click on the jar file and AEM will start. This might take a while on the initial install (~10 minutes).
Once the initial setup has been completed, a browser window will open (https://localhost:4502
). You can login using the default admin credentials (user: admin
/ pass: admin
). The initial login will prompt you to enter the license details.
Port Number
By default, AEM will be accessible through HTTP at port 4502. If port 4502 is unavailable, it will be set to one of these ports (in order of preference):
- 4502
- 8080
- 8081
- 8082
- 8083
- 8084
- 8085
- 8888
- 9362
- Random number
To set the port to a different port number, there are two options:
- Using the -port option through the command-line (
java -jar aem-quickstart.jar -p 6754
) - Rename the file so that it includes the port number. This has very specific rules
- The file must start with
cq
- the port number must be 4 or 5 digits and must come after a dash (ex.
cq5-author-p4502.jar
,cq5-publish-p4503.jar
) - If there are any other digits in the filename, the port number needs to prefixed with -p (ex.
cq5-author-p4502.jar
,cq5-publish-p6754.jar
)
- The file must start with
Setting Run Modes
Run modes are identifiers that allow to differentiate AEM instances (e.g. development, test, production, authoring, publish). Run modes for an instance can be configured by (in order of resolution):
- sling.properties - change the
sling.run.modes
property in<cq-installation-dir>/crx-quickstart/conf/sling.properties
- Using the -r switch in the command-line - when starting the standalone JAR include the switch
-r <runmode>
(ex.java -jar cq-publish-p6754.jar -r publish
) - system properties (or -D switch) - Set a property in the start script (
-Dsling.run.modes=test,publish,production
) - Changing the JAR filename - Can be used to activate
author
orpublish
run modes using the following templatecq5-<run-mode>-p<port-number>.jar
(ex.cq-publish-p6754.jar
)
Installation with an Application Server
AEM can be deployed in application servers such as Tomcat
, JBoss
and Websphere
. You simple need to deploy a war
file provided to you by Adobe.
Setting Run Modes
Set the sling.run.modes
property in WEB-INF/web.xml