CQ5/AEM How do I detect from a SlingServlet whether it is running on the Master or Slave instance on an author cluster?

The Problem

You have a Sling Servlet performing a task on the author instance, and you are running as a cluster. The code is executing on both the master author and the slave author instance, when it should only be running on one.

How do you detect whether the instance is the master instance?

The Solution

@Reference
private SlingRepository repository;

public boolean isMasterRepository(){
    final String isMaster = repository.getDescriptor("crx.cluster.master");
    return StringUtils.isNotBlank(isMaster) && Boolean.parseBoolean(isMaster);
}

With this code, we can detect whether the current instance is running as the master.

In the execution function, the first conditional should be to detect whether it is running as the master instance or not, and if it is not, it should terminate the function call.

CQ 5.6.1 How to find the current run mode on an instance

The Problem

You suspect your instance is not running in publish mode, or is missing a custom run mode on startup and need to find out easily what runmode the instance is running under.

The Solution

Go to:
http://localhost:4502/system/console/status-slingsettings

You will see the following line down the bottom:

Run Modes = [samplecontent, author, crx2, crx3mongo]

CQ5/AEM How do I find out exactly which maven dependency I need?

The Problem

You are writing a customization in Java for CQ5/AEM, but the class you need is not currently included in the project, but it is available in CQ5.

You may know what dependency you need, but are unsure as to the version. What is the best way to find the right dependency to include in CQ5?

The Solution

Go to:
http://localhost:4502/system/console/depfinder

This is the package dependency lookup service. If you type in the package/class you need in the field, and click on Find, you will get the dependency you need to include.

Just copy and paste the dependency into your pom file.

CQ5/AEM Dispatcher gotchya - dispatcher failed to map segment from shared object permission denied

The Problem

Although your dispatcher mod file is there, you can't seem to load the mod_dispatcher file.

The Solution

First, double check in your httpd.conf file that you are actually pointing to the right place. Remember that your ServerRoot is the prefix appended to the mod_dispatcher.so path file.

If the file is where you would expect it to be, check that the user you are running apache under has the rights to see the file.
ls -al
will show full permissions of the directory listing.
chown group:user will change the file ownership

chmod 755 will give read and execute rights to the owner, the group and everyone.

Finally, if you are running Red Hat Enterprise Linux (RHEL), it is possible you are running selinux, and don't even know it.

Have a look under /etc/sysconfig/selinux.

In the file, you may see selinux=enforcing.

If this is the case, then selinux probably doesn't like the dispatcher mod, and is blocking it. You can drop the permissions down to permissive or disable to remove it entirely, but check with your systems administrator, as this will have other effects on the system.

AEM/CQ5 How do I let users reset their own passwords?

The Problem

How do you allow users to reset their own passwords in the admin interface?

The Solution

I get asked this question so frequently, I thought I would make a blog post about it.

Go to the classic interface, and in the top right hand corner, click on your user button.

If you are logged in as the administrator, you do not get the Set Password option.

If you are logged in as administrator and impersonate a user, you will not see the option either.

I believe that this is what causes the confusion. You actually have to log out, and log in as a different user in the admin interface, and you will see the set password option.

AEM/CQ5 SQL2 How do I find all occurrences of a node by name

The Problem

You want to use a SQL2 query to retrieve all nodes that are named "nameofnode"

The Solution

SELECT * FROM [nt:base] AS s WHERE LOCALNAME() LIKE "nameofnode"

The LOCALNAME() function returns the node name. 

How to create your own sling adapter

The Problem

You want to create your own implementation of an adaptTo() class

The Solution

Coming Soon