Close

Uninstalling the Governance Services AMP files

The Governance Services AMP files can be uninstalled using the Module Management Tool (MMT).

Governance Services consists of two AMP files, which are applied during installation. One of the AMP files, representing the core Governance Services functionality, is applied to the Alfresco Repository WAR file, and the other, representing the Governance Services UI component is applied to the Alfresco Share WAR file.

Both of the AMP files need to be removed in order to uninstall Governance Services. Use the Module Management Tool (MMT) to do this. For more information on the tool, see Module Management Tool (MMT)

The MMT is a command line tool. The syntax for uninstalling an AMP file using MMT is:

$ java -jar bin\alfresco-mmt.jar uninstall <ModuleId> <WARFileLocation>

Note: The apply_amps command does not uninstall AMP files (even if you remove the AMP files manually from the amps and amps_share directories). Use apply_amps to install AMP files only.

  1. Change into the root of the Alfresco installation directory.

  2. Find the core Governance Services AMP file using the following command:

     $ java -jar bin\alfresco-mmt.jar list tomcat\webapps\alfresco.war                                  
    

    This shows the core RM components:

     Module 'org_alfresco_module_rm' installed in 'webapps/alfresco'
        -    Title:        AGS Repo
        -    Version:      23.1
        -    Install Date: null
        -    Description:   Alfresco Governance Services Repository Extension
     Module 'alfresco-rm-enterprise-repo' installed in 'webapps/alfresco'
        -    Title:        AGS Enterprise Repo
        -    Version:      23.1
        -    Install Date: Thurs Nov 02 08:50:15 UTC 2023
        -    Description:   Alfresco Governance Services Enterprise Repository Extension    
    

    To uninstall the AMP file, you’ll need the Enterprise Module ID alfresco-rm-enterprise-repo.

  3. Find the Share RM AMP file using the following command:

     $ java -jar bin\alfresco-mmt.jar list tomcat\webapps\share.war                        
    

    This shows the Share RM component:

     Module 'alfresco-rm-enterprise-share' installed in 'tomcat\webapps\share.war'
     -    Title:        Alfresco Record Management Share Extension
     -    Version:      23.1
     -    Install Date: Thurs Nov 02 08:50:15 UTC 2023
     -    Description:   Alfresco Record Management Share Extension              
    

    To uninstall the AMP file, you’ll need the Enterprise Module ID alfresco-rm-enterprise-share.

  4. Use these commands to uninstall the AMP files:

     $ java -jar bin\alfresco-mmt.jar uninstall alfresco-rm-enterprise-repo tomcat\webapps\alfresco.war            
    
     $ java -jar bin\alfresco-mmt.jar uninstall alfresco-rm-enterprise-share tomcat\webapps\share.war            
    
  5. You can check that the AMP files have been removed by rerunning the commands:

     $ java -jar bin\alfresco-mmt.jar list tomcat\webapps\alfresco.war                        
    

    and

     $ java -jar bin\alfresco-mmt.jar list tomcat\webapps\share.war                                      
    
  6. Delete the tomcat\webapps\alfresco and tomcat\webapps\share folders in the Alfresco installation directory.

    Deleting these directories forces Tomcat to read the edited WAR files when Alfresco is restarted.

  7. Restart Alfresco to see your changes.

Edit this page

Suggest an edit on GitHub
This website uses cookies in order to offer you the most relevant information. Please accept cookies for optimal performance. This documentation is subject to the Documentation Notice.