Did you know there are properties you can’t see in your Apache Sling / Adobe Experience Manager repository? Jackrabbit OAK includes the concept of hidden nodes and properties. Hidden nodes and properties are prefixed with a colon and are not visible to consuming applications.
If you are lucky, you will never have to deal with hidden properties, but if you do, you should know that the Oak Run JAR includes a couple of very helpful utilities for revealing these properties.
- Oak Run Console – Interactive CLI console for traversing down through the Jackrabbit Oak repository
- Oak Run Explore – Java GUI tool for exploring the current state of the Jackrabbit repository
Both of these tools have similar functions but operate quite similarly. In my experience, the console is quicker whereas the GUI is easier to use.
Getting Oak Run
The first step to getting Oak Run is to find the version required for your Apache Sling / AEM instance. You can find it by checking the version of the Oak Core bundle:
From there, you can download the correct version of the Oak Run jar from Maven:
Using Oak Run Console / Explore
Once you have the Jar downloaded copy it into the installation directory and then run the commands as such:
java -jar oak-run-[version].jar [command] crx-quickstart/repository/segmentstore
java -jar oak-run-[version].jar [command] sling/repository/segmentstore
Running the commands you will get a screen like the following.
Oak Run Explore
A few nice things you’ll notice in the explore GUI:
- Tree view of the Oak repository
- ALL nodes and properties including the hidden ones
- Repository size by node tree
Oak Run Console
The console allows you to navigate the Oak repository like a filesystem and has a number of nifty commands. You can find out more by entering
Dan is a certified Adobe Digital Marketing Technologist, Architect, and Advisor, having led multiple successful digital marketing programs on the Adobe Experience Cloud. He’s passionate about solving complex problems and building innovative digital marketing solutions.
Dan is a PMC Member of the Apache Sling project, frequent Adobe Beta participant and committer to ACS AEM Commons, allowing a unique insight into the cutting edge of the Adobe Experience Cloud platform.