URS urs

Unsupported Repository Structure

Background background

URS Identifies cases of URS (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 avoiding conflict between them all, content is being restructured out of /etc to other folders in the repository. Doing so adhere to the following high-level rules:

  • AEM product code is always placed in /libs that custom code must not overwrite.
  • 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 can likely cause problems during deployment.

Possible solutions solutions

  • See Repository Restructuring for guidance to prepare for AEM as a Cloud Service.
  • See also AEM Project Structure if you want to learn more about mutable and immutable areas of the repository.
  • Contact the AEM Support Team for clarifications or to have concerns addressed.
  • Use 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.