AEM FAQs
CAUTIONFollow this page to get answers to some AEM troubleshooting and configuration issues.
Sites
How do I configure binary-less distribution?
Binary-less distribution is supported for deployments over a shared data store and involves agents that leverage the Vault-based Distribution package exporter (factory PID: org.apache.sling.distribution.serialization.impl.vlt.VaultDistributionPackageBuilderFactory) package builder.
With binary-less mode enabled, the content packages distributed contain references to binaries rather than the actual binaries.
How do I enable binary-less distribution?
To enable binary-less distribution, deploy with a shared blob store.
Check the useBinaryReferences property in the OSGI configuration with the factory PID ( org.apache.sling.distribution.serialization.impl.vlt.VaultDistributionPackageBuilderFactory) that your agent is using.
How can I customize the error messages while navigating page hierarchy in AEM sites console?
Check the Network panel (of Chrome browser) where a personal setup (JS has not been minified).
View the Initiator column to determine what the initiator of a request was. It provides the files and the line numbers from where the AJAX calls are made. Later, you can trace the error handling function and change the error message as per your requirement.
How to enable permissions while creating Language Copy for Content-Authors in AEM?
To create language copy feature, content-authors need permissions at /content/projects location.
If one requires the authors to manage projects as well, then the workaround is to add the author to project-administrators group.
How to change the format while creating Language Copy for a project?
Create a language root and language copy inside the root, before creating a translation project.
For example,
Create a language root at /content/geometrixx with name as fr_LU (and title as French (Luxembourg)). Subsequently, create language copy of page from the references panel and navigate to Create structure only option in Create & Translate. Finally, create a translation project and then add the language copy to the translation job.
For details, refer to the additional resources below:
How to audit AEM capabilities such as, login attempts and ACL or permission changes?
AEM has introduced the ability to log administrative changes for better troubleshooting and audit. By default, the information is logged in the error.log file. To make monitoring easier, it is recommended that they be redirected to a separate log file.
To redirect the output to a separate log file, see How to audit user management operations in AEM.
How to enable SSL by default?
Adobe Experience Manager (AEM) 6.4 ships with the SSL wizard and offers a User Interface to configure Jetty and Granite Jetty SSL support.
To enable SSL by default, see SSL by default.
What is the recommended architecture when using AEM’s Content Services from a mobile app, ideally React Native?
The Content Services are based on the Sling Models and the AEM developers must provide a Sling Model pojo for each component that is exported.
To understand how to consume AEM content services from a React application, see Get Started with AEM Content Services tutorial.
Also, if the developers want to export a tree of components they can also implement the ComponentExporter and ContainerExporter interfaces as well as use the ModelFactory to iterate over the child components and return their model representation. See the resources below:
[1] Adobe-Marketing-Cloud/aem-core-wcm-components
[2] Apache Sling :: Sling Models
How to disable AEM 6.4 survey pop-up?
You can opt into usage statistics collection by using either the Touch UI or the Web Console. For detailed instructions, see Opting into aggregated usage statistics collection.
Is there a good resource that highlights the key features for upgrading to AEM 6.4?
Refer to Understanding Reasons to Upgrade AEM that describes high-level breakdown of key features for customers considering upgrading to the latest version of Adobe Experience Manager.
How to configure an AEM instance to use the PorterStem filter?
PorterStem filter applies the Porter Stemming Algorithm for English. The results are similar to using the Snowball Porter Stemmer with the language=“English” argument. But this stemmer is coded directly in Java and is not based on Snowball. It does not accept a list of protected words and is only appropriate for English language text.
Oak exposes a set of lucene-provides analyzer configuration elements for use in AEM. To learn how to use filters, refer to Apache Oak Analyzers in Simple search implementation guide.
How to perform a full re-indexing?
Re-indexing should always be approached with proper consideration on its impact to AEM’s overall performance, and performed during periods of low activity or maintenance windows.
Refer to the Best Practices for Queries and Indexing to understand the reasons for re-indexing.
Do we support minified JS libs in Design Importer?
You need to change the JS processor default configs property of the Adobe Granite HTML Library Manager to min:gcc. To import the Design Package successfully, it is recommended to include pre-minified 3rd party libraries in our Client-Side Libraries.
Assets
Why the Assets workflow repeats itself while uploading MP4 files (for example, using drag-and-drop method)?
If the user, uploading the movie files does not have delete permissions under asset node, the delete chunk nodes fail and the upload restarts.
What is the maximum number of digital assets that can be operated with AEM 6.4 at a time?
Adobe Experience Manager (AEM) 6.4 currently lets you upload up to 2 GB of assets at a time.
For additional information on maximum number of assets that can be operated with AEM 6.4, see Assets sizing guide.
What are the default settings for OOTB configurations while creating Language Copy?
When creating language copies through classic UI, Assets are not moved under the new language hierarchy but used from the language master.
Whereas, when you create a language copy through Touch UI (References -> Update Language Copy), a new DAM folder is created under the new language and assets are referenced from there.
This is default setting for OOTB configurations. You can set Translate Page Assets = Do not translate in Translation configurations.
For AEM 6.4, Tools > Cloud Services > Translation Cloud services.
How to disable an AEM component causing exponential growth for the AEM SegmentStore (AEM 6.3.1.1)?
You can disable the OSGi Component Disabler. To use this service, see OSGi Component Disabler.
As a workaround, you can also manually disable the component either via the UI or via a curl command (example below), after every AEM restart.
curl -u admin:$(pass CQ_Admin) 'http://localhost:4502/system/console/components/com.day.cq.analytics.sitecatalyst.impl.importer.ReportImporter' --data 'action=disable'
How to configure Assets Insights with AEM 6.4 instance?
To setup and configure Assets Insights for Experience Manager deployed via Adobe Activation (DTM), refer to Set up Assets Insights with AEM Assets.
How to customize admin consoles?
AEM provides various mechanisms to enable you to customize the consoles and the page authoring functionality of your authoring instance.
To learn how to create a custom console and customize a default view for a console, refer to Customizing the Consoles.
What is the difference between CoralUI 2 and CoralUI 3-based components?
A new set of Sling components of Granite UI Foundation is created for Coral3 and is located under /libs/granite/ui/components/coral/foundation. There is one set for CoralUI 2-based components and one set for CoralUI 3-based components. The new set will not be just a copy-paste of the old set, rather it will be cleaned up (for example streamlining, removing deprecated feature). So it is recommended that a page only use either CoralUI 3-based or CoralUI 2-based set.
To learn more in detail, refer to Migration Guide to CoralUI 3-based.