topic Re: Best Way to Uninstall a AMP Module in Alfresco Archive

Best Way to Uninstall a AMP Module

cgonzalez — Wed, 19 Mar 2008 13:13:07 GMT

Hi,I have developed a amp module than extends Alfresco, it works fine,but now i want to uninstall it. How can i do that?If have readed that there's no good way to do that.Any tip?

Re: Best Way to Uninstall a AMP Module

pmonks — Fri, 21 Mar 2008 04:22:57 GMT

By default the MMT tool will create a backup of the original alfresco.war file in the same directory as the original (eg. ${TOMCAT_HOME}/webapps). To revert, simply:

shutdown Alfresco

rename or move the modified alfresco.war file

copy or rename the backed up file to "alfresco.war"

delete the ${TOMCAT_HOME}/webapps/alfresco directory

delete the ${TOMCAT_HOME}/temp directory

delete the ${TOMCAT_HOME}/work directory

restart Alfresco

Cheers,
Peter

Re: Best Way to Uninstall a AMP Module

cgonzalez — Mon, 24 Mar 2008 08:51:55 GMT

Thanks for your reply

If i do that when i start alfresco again i get the next log message.

A previously-installed module 'mymodule' (version 1.0) is not present in your distribution.

Re: Best Way to Uninstall a AMP Module

lvs — Mon, 24 Mar 2008 10:52:46 GMT

Hi,

I think this is a warning message and it should not have consequences on the behaviour of your alfresco

Regards
Laura

Re: Best Way to Uninstall a AMP Module

jpfi — Mon, 24 Mar 2008 13:32:12 GMT

Hi,
if your module only consists of some UI-extension or something like that, you can treat this message as an info. But if your module includes some custom content models AFAIK browsing nodes which uses this content model will lead to errors /error messages.
Cheers,
Jan

Re: Best Way to Uninstall a AMP Module

cgonzalez — Wed, 26 Mar 2008 09:51:06 GMT

So there's no way to uninstall completely an amp module and i always will receive that WARNING?.

Thanks

Re: Best Way to Uninstall a AMP Module

invostar — Mon, 19 May 2008 17:49:45 GMT

So there's no way to uninstall completely an amp module and i always will receive that WARNING?.

Thanks

Does anyone have an answer to this question? Trying to resolve an issue with an amp that seems to have broken our alfresco installation and would like to "roll back" all changes. Using the backup war alone doesn't seem to fix it and there are still references to that amp in alf_data.

Re: Best Way to Uninstall a AMP Module

sacco — Tue, 20 May 2008 23:58:56 GMT

So there's no way to uninstall completely an amp module and i always will receive that WARNING?.

No, as far as I know that's not possible. When you uninstall (ideally before) a module
you should really also hunt down and delete all content items whose type is defined by that module,
including purging them from the deleted items store, as they can cause the system integrity problems
if the model definition is missing, and it is likely to be impossible to remove them afterwards
(due to inbuilt integrity checks). In my experience such problems can become serious, even fatal,
for the repository, even though nothing may obviously break at first.

Although the new dynamic configuration facilities may allow flexibility during development,
Alfresco really does not seem to be well adapted (yet!) for applications which may change and
evolve organically over their lifetime after deployment. In particular, there are (as far as I have seen)
very few tools available for low level maintenance and repair/manipulation of the repository, and those
that exist can be very fragile, e.g. the Node Browser will usually be unable to display anything at all if
it encounters something odd or broken in the repository, though it may be able to display the parent
and even nodes below the problem (i.e. the node can be traversed), which makes it of rather limited
usefulness for diagnosis.

Re: Best Way to Uninstall a AMP Module

sharifu — Tue, 10 Sep 2013 13:22:15 GMT

has this been updated now?

Re: Best Way to Uninstall a AMP Module

kaynezhang — Sat, 21 Sep 2013 17:16:55 GMT

The quickest way is to move module property file and spring configuration file which is located in classpath*:alfresco/module/youmoduleid/* out of alfresco classpath to other place.

Doing this will give you a warning like "A previously-installed module *** (version **) is not present in your distribution",But alfresco will operate normally.
If you want to suppressing warnings you can do it by deleting nodes in path /{http://www.alfresco.org/model/system/1.0}system-registry/{http://www.alfresco.org/system/modules/1.0}modules that related to the module

Re: Best Way to Uninstall a AMP Module

prof_1 — Wed, 23 Oct 2013 18:58:00 GMT

Here is the best way:
1- Change into the root directory of your Alfresco installation.
2- Check for the presence of the module you wish to delete by typing in the following command:

    java -jar ./bin/alfresco-mmt.jar list tomcat/webapps/alfresco


    This will display a list of installed modules. Make a note of the module ID of the module you wish to uninstall, in this case com_alfresco_tutorials_photo_search.

4- Now, to uninstall the module type the following command:

    java -jar ./bin/alfresco-mmt.jar uninstall com_alfresco_tutorials_photo_search tomcat/webapps/alfresco


    You will see a list of files removed from the WAR.

You have now uninstalled your AMP file.

or check this link: http://docs.alfresco.com/4.2/index.jsp?topic=%2Fcom.alfresco.enterprise.doc%2Ftasks%2Fdev-extensions-tutorials-simple-module-uninstall-amp.html

Re: Best Way to Uninstall a AMP Module

prignony — Thu, 28 Aug 2014 09:42:00 GMT

I'm not sure that this "best way" will take care of removing custom model.

Is there a way to be sure that a previously installed model (via amp) is really removed from alfresco?
I've the same issue installing amp files, non incremental change have been made to the repository so the new module cannot be installed.

is there a way to uninstall a module with a model without removing data having the type? If I run a js script to hunt those file is it possible to unspecialyze their type? Would it be enough?

Here is what I did do remove my amp with the model, the issue is that I've to remove content and that should not happen (sorry it is in french)
<ul>
<li>   Faire une recherche dans le node browser pour tous les objets de type my:document et my:folder<ul>
<li>      Naviguer vers http://my-alfresco-srv/alfresco</li>
<li>      En haut à droite cliquer sur la 1ier icon (Administration Console)</li>
<li>      Cliquer sur « Node Browser »</li>
<li>      Cliquer sur « workspace://SpacesStore »</li>
<li>      A côté du champ « Search » en haut dans la drop-down, choisir « lucene »</li>
<li>      Dans le champ de recherche entrer « +TYPE:"my:content" »</li>
<li>      Dans le champ de recherche entrer « +TYPE:"my:folder" »</li></ul></li>
<li>   Supprimer les objets de ces listes 1 par 1</li>
<li>   Vider la corbeille sur /alfresco<ul>
<li>      Naviguer vers http://my-alfreso-srv/alfresco</li>
<li>      En haut à droite cliquer sur l’icon du petit bonhomme (User Profile)</li>
<li>      Cliquer sur « Manage Deleted Items »</li>
<li>      Cliquer sur le bouton « show all »</li>
<li>      Cliquer sur le lien « Delete Listed Items »</li></ul></li>
<li>   Stopper l'instance</li>
<li>   Supprimer le répertoire [alfresco]/alf_data/solr/archive/spacestore</li>
<li>   Supprimer le répertoire [alfresco]/alf_data/solr/workspace/spacestore</li>
<li>   Supprimer le répertoire [alfresco]/alf_data/solr/archive-spacestore/alfrescomodels</li>
<li>   Supprimer le répertoire [alfresco]/alf_data/solr/workspace-spacestore/alfrescomodels</li>
<li>   Supprimer le contenu du répertoire [alfresco]/alf_data/contentstore.deleted/</li>
<li>   Supprimer le fichier [alfresco]/amps/my-model-alfresco-1.0.amp</li>
<li>   Supprimer le fichier ${TOMCAT_HOME}/shared/lib/my-model-share-1.0.jar</li>
<li>   Renommer or déplacer l'alfresco.war modifié depuis ${TOMCAT_HOME}/webapps/alfresco.war</li>
<li>   Copier or renommer un alfresco.war.bak original en "alfresco.war"</li>
<li>   Supprimer le répertoire ${TOMCAT_HOME}/webapps/alfresco</li>
<li>   Supprimer le répertoire ${TOMCAT_HOME}/temp</li>
<li>   Supprimer le répertoire ${TOMCAT_HOME}/work</li>
<li>   Exécuter le script [alfresco]/bin/apply_amps.sh</li>
<li>   Redémarrer Alfresco</li>
<li>   Surveiller le log pour d’éventuel erreur</li>
<li>Vérifier avec une recherche qu'il n'y a plus de contenu associé à l'anciens modèle</li>
<li>   Stopper l'instance</li>
<li>   Copier la dernière version du amp vers [alfresco]/amps/my-model-alfresco-1.0.amp</li>
<li>   Copier la dernière version du jar vers ${TOMCAT_HOME}/shared/lib/my-model-share-1.0.jar</li>
<li>   Exécuter le script [alfresco]/bin/apply_amps.sh</li>
<li>   Redémarrer Alfresco</li>
<li>   Surveiller le log pour d’éventuel erreurs</li></ul>