How to install ACS Commons? | Community
Skip to main content
D
dylanmccurry
Level 4
November 4, 2022
Solved

How to install ACS Commons?

  • November 4, 2022
  • 4 replies
  • 6723 views

I am using AEM as a Cloud Service and running the 6.5 quickstart jar locally.  Not sure which archetype version was used but it's recent (earlier this year)

 

I have followed the documentation here: Using with Maven (adobe-consulting-services.github.io)

 

I am trying to set up the 404 module but it's not working at all.  I suspect that my issue may actually be that ACS Commons is not installed on my local instance.  How can I confirm if the ACS Commons package is installed?  I don't see any logical change in the administration section, for instance...

This post is no longer active and is closed to new replies. Need help? Start a new post to ask your question.
Best answer by Lokesh_Vajrala

@dylanmccurry 

Here are a few checks you can do to troubleshoot & fix the issue - 

  1. What is the target path specified within the embed configuration in pom.xml? Do you have a filter set in META-INF/vault/filter.xml for the same to install the package in AEM through deployment if the path is not covered in the existing filter.xml rules?
  2. What command are you using to do deployment? If you use mvn clean install -PautoInstallSinglePackage, a single artifact will be generated under the project all module. Path -> /all/target/project-name.all-version.zip Unzip/extract the package and check if the ACS artifact is present. Alternatively, you could verify the same in Package Manager. If you don't see the ACS package in package manager or the generated artifact, then the package is not embedded, and you need to recheck the configurations in pom.
  3. If the ACS package is present in the package manager and is in an installed state, then the application packages installed after the ACS package must be overriding it in JCR. You need to adjust the filter roots in your vault/filter.xml not to override the other packages.
  4.  

4 replies

SantoshSai
Community Advisor
SantoshSaiCommunity Advisor
Community Advisor
November 4, 2022

Hi  @dylanmccurry,

You supposed to ACS Commons under Tools as per below screenshot.

Hope that helps!

Regards,

Santosh

Santosh Sai
    D
    dylanmccurryAuthor
    Level 4
    November 4, 2022

    Thanks for confirming @santoshsai - in my case I do not see this.  What are some things I should look out for?

      Mani_kumar_
      Community Advisor
      Mani_kumar_Community Advisor
      Community Advisor
      November 4, 2022

      1. You can also verify if the packages of ACS commons is available in package manager 

      2. Try to install that manually if need to have local setup by taking the latest version from ACS commons website

      3. Verify the acs commons bundles are active and resolved properly.

      For your reference attaching the website for ACS commons

      https://adobe-consulting-services.github.io/acs-aem-commons/

       

        Lokesh_Vajrala
        Community Advisor
        Lokesh_VajralaCommunity AdvisorAccepted solution
        Community Advisor
        November 5, 2022

        @dylanmccurry 

        Here are a few checks you can do to troubleshoot & fix the issue - 

        1. What is the target path specified within the embed configuration in pom.xml? Do you have a filter set in META-INF/vault/filter.xml for the same to install the package in AEM through deployment if the path is not covered in the existing filter.xml rules?
        2. What command are you using to do deployment? If you use mvn clean install -PautoInstallSinglePackage, a single artifact will be generated under the project all module. Path -> /all/target/project-name.all-version.zip Unzip/extract the package and check if the ACS artifact is present. Alternatively, you could verify the same in Package Manager. If you don't see the ACS package in package manager or the generated artifact, then the package is not embedded, and you need to recheck the configurations in pom.
        3. If the ACS package is present in the package manager and is in an installed state, then the application packages installed after the ACS package must be overriding it in JCR. You need to adjust the filter roots in your vault/filter.xml not to override the other packages.
        4.  
          D
          dylanmccurryAuthor
          Level 4
          November 9, 2022

          Thank you- the filter.xml called out /apps/myapp-vendor-packages, where I was targeting /apps/myapp-packages.  Your troubleshooting steps really helped.

            arunpatidar
            Community Advisor
            arunpatidarCommunity Advisor
            Community Advisor
            November 5, 2022

            you can check below article to see, how to install ACS Common along with your project

            https://aemlab.blogspot.com/2022/06/aemaacs-tools.html  

            Arun Patidar
              BrijeshYadav
              BrijeshYadav
              Level 5
              November 7, 2022

              Just Add these two details to your project pom.xml file and acs commons package will get deployed to your AEM along with regular deployment.

               

              Add acs commons dependency under <dependencies> section
              <dependencies>
                   <dependency>
                      <groupId>com.adobe.acs</groupId>
                      <artifactId>acs-aem-commons-content</artifactId>
                      <version>5.2.0</version>
                      <type>zip</type>
                  </dependency>
              </dependencies>
              Configure and embed to vault package plugins

              <!-- V A U L T   P A C K A G E   P L U G I N S                              -->
              <plugin>
                  <groupId>org.apache.jackrabbit</groupId>
                  <artifactId>filevault-package-maven-plugin</artifactId>
                  <extensions>true</extensions>
                  <configuration>
                      <group>yourGroup</group>
                      <packageType>container</packageType>
                      <skipSubPackageValidation>true</skipSubPackageValidation>
                      <allowIndexDefinitions>true</allowIndexDefinitions>
                      <embeddeds>
                          <embedded>
                              <groupId>com.adobe.acs</groupId>
                              <artifactId>acs-aem-commons-content</artifactId>
                              <type>zip</type>
                              <target>/apps/acs-commons-package/application/install</target>
                          </embedded>
                     </embeddeds>
                  </configuration>
              </plugin>

                

                Terms & ConditionsAccessibility statement

                Loading footer...