Day 03 - AEM Installation and Consoles

Hola amigos ๐Ÿ‘‹! In this post, we will discuss how to run a local AEM instance and what are some useful consoles in it. So, without further ado, letโ€™s have fun ๐Ÿ˜Ž.

Install AEM

So first things first, letโ€™s see how can we install AEM on our local system. There are two ways to do that -

  • Install AEM JAR file directly
  • Deploy AEM WAR file on some application server.

In this article, we are going to look into only the first way as it is the most popular and easy way to install AEM.

Install AEM as a JAR file

Prerequisites

  • Java 8 or 11 (11 only for AEM 6.5)
  • AEM >= 6.3 (6.3, 6.4 or 6.5), in this tutorial I am using AEM 6.5
  • RAM >= 4GB (for better performance)

Steps

  1. Create a directory in your system at your desired location and name it as - AEM.
  2. Create two directories in the above created directory. Name them as author and publish.
  3. Paste your AEM jar file along with your license.properties file.
  4. In the author folder, name the jar file as - aem-author-p4502.jar.
  5. In the publish folder, name the jar file as - aem-publish-p4503.jar.
  6. After this, your directory structure should look like this -
AEM Folder Structure
  1. AEM has two types of servers - author, where content authors make changes to the content and publish, where the end user of the website sees the content. To replicate content from author to the publish instance, we used in built AEM process - Replication.
  2. You must have noticed the names of the jar files - it is a standard to use such names which define the mode (author or publish) and ports (4502 or 4503). You can name your file anything but this is the convention we are gonna use in this series.
  3. Now, navigate to the author directory and run the following command - '''shell java -agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n -jar aem-author-p4502.jar -gui ''' This command runs the AEM in debug mode; which means you can debug your code while developing. While developing on the local environment, it is always useful to run AEM in debug mode. If you donโ€™t want to run AEM in debug mode then just run the following command - '''shell java -jar aem-author-p4502.jar -gui '''
  4. When you first run this command, it will take some time to create the CRX repository and load all the required stuff. After a few minutes, a browser window will automatically open on '''http://localhost:4502/โ€โ€™ and you will see something like this -
AEM Login Screen
  1. Login using following credentials ''' Username: admin Password: admin '''
  2. You will now see the start screen of AEM at '''http://localhost:4502/aem/start.html/'''. The steps are similar for the publish instance. For this tutorial, we are not going to need publish instance.

Congratulations ๐Ÿค! you have successfully installed AEM on your local system. You should be proud of yourself ๐Ÿ‘.

AEM Consoles

Now, we have AEM server up and running, we can explore it and see what it offers. We will see important consoles one by one. You will get to know about rest of the consoles as you go deeper into AEM stuff.

AEM Home Screen

Here, we can icons for different consoles in AEM. It looks like as follows - AEM Home Screen

AEM Sites Console

This console will display the pages of the websites that we will create. In a normal installation, a sample website called We.Retail is present. You can go ahead and play with it. AEM Sites Console

AEM Assets Console

This console will display all the assets in your organization. It lets you store, update, create, or delete assets. AEM Assets Console

Felix Console

This console is the one where you can see all the OSGi bundles - out of the box as well as your custom ones. It has various other consoles which we will see gradually. AEM System Console

CRX/DE

CRX DE stands for Content Repository eXtreme Development Environment. It is an implementation of JCR and here we can see the nodes and properties. We can also develop code here. CRX DE

There are many other consoles in AEM but these four are the most important and a developer interacts with them frequently.

Conclusion

In this short post, we did our first hands-on on AEM. Itโ€™s not very interesting but doing this is essential before getting our hands dirty with some code.

In the next post, we will set up our AEM development environment and will get familiar with some tools which are important for enjoyable AEM development.

I would love to hear your thoughts on this post and would like to have suggestions from you to make this post better.

Happy Learning ๐Ÿ˜Š and Namaste ๐Ÿ™.

Note: all AEM related icons/imagery are property of Adobe Systems.

Created and maintained by@Anirudh Sharma
I love to learn and share. Hence, this site has no ads, no affiliation links, or any BS. If you like what you see, give me a thumbs up.

GitHub iconMedium iconTwitter iconFacebook iconLinkedIn iconStackoverflow icon