URS urs

Unsupported Repository Structure

Background background

URS identifies cases of unsupported repository structure and node characteristics. Beginning in AEM 6.4, guidelines have been provided for the restructuring of repository content. By clearly delineating hierarchies for AEM product code and customer code and avoid conflict between them, content is being restructured out of /etc to other folders in the repository, adhering to the following high-level rules:

  • AEM product code will always be placed in /libs, which must not be overwritten by custom code.
  • Custom code should be placed in /apps, /content and /conf.
  • It is highly recommended that these guidelines are followed for AEM as a Cloud Service.

Subtypes are used to identify the specific types of repository issues that should be addressed:

  • clientlibs.location: A client library referencing /etc by path.
  • file.location: A file under /etc that has been modified since installation.
  • node.location: A node under /etc that has been modified since installation.
  • workflow.location: A workflow model or launcher under /etc/workflow.
  • package.structure: A package that contains both mutable and immutable content.
  • node.size: A node with unsupported size.

Possible implications and risks implications-and-risks

  • Custom code relying on older paths may cause undesired behavior and impact product functionality.
  • Packages containing both mutable and immutable content will likely cause problems during deployment.

Possible solutions solutions

  • Refer to Repository Restructuring for guidance to prepare for AEM as a Cloud Service.
  • Also refer to AEM Project Structure to learn more about mutable and immutable areas of the repository.
  • Please reach out to our AEM Support Team to get clarifications or to address concerns.
  • Leverage the Repository Modernizer to restructure existing project packages by separating content and code into discrete packages to be compatible with the project structure defined for Adobe Experience Manager as a Cloud Service.
recommendation-more-help
c50d24a5-718e-4110-a484-b335e8a63206