Issues with uninstalling ADX Portal from Microsoft Dynamics CRM Online and how to tackle them
In this blog, we shall see how can a user uninstall the ADX Portals from Microsoft Dynamics CRM Online and what are the various that a user might face while uninstalling the Adxstudio solutions from CRM before installing the new CRM Portals.
Pre-Requisites:
- D365 CRM Portals
- D365 CRM Environment
How to Uninstall the ADX Portals:
According to ADX Studio the following is the procedure to uninstall ADX Portals from the CRM Environment:
“The process of uninstalling the solutions is to delete the solutions in the reverse order they were installed. If customizations have been made that depend on any of the components in Adxstudio solutions, those customizations must be undone before a delete will be successful. Delete any suplementary Adxstudio solutions such as Adxstudio Forums, Adxstudio Ideas, etc. that may have been installed. Then delete Adxstudio Portals solution, then delete Adxstudio Portals Dependencies solution.”
Process:
Step 1: The user will have to go Settings in the ‘All Select Area’ and click on Solutions option.
Step 2: The user will have to make a list of the Adxstudio solution that are present in the CRM Solution list.
*Note: The solutions are already arranged in the grid view in descending order of their installation. The user must uninstall in that order only (with Adxstudio installer to be the last solution to be installed).
The following below is the list of solution in the descending order of their uninstallation.
*Note: The following list may/may not contain all the solution components of Adxstudio but consists of most of the solutions that are used in ADX Portals.
| Sr. No. | Solution Name | Display Name |
| 1. | AdxstudioIssuesWorkflows | Adxstudio Issues Workflows |
| 2. | AdxstudioIssues | Adxstudio Issues |
| 3. | AdxstudioIdeasWorkflows | Adxstudio Ideas Workflows |
| 4. | AdxstudioIdeas | Adxstudio Ideas |
| 6. | AdxstudioBadges | AdxstudioBadges |
| 7. | AdxstudioCareersWorkflows | Adxstudio Careers Workflows |
| 8. | AdxstudioCareers | Adxstudio Careers |
| 9. | AdxstudioBlogs | Adxstudio Blogs |
| 10. | AdxstudioIdentityWorkflows | Adxstudio Identity Workflows |
| 11. | AdxstudioPortalsWorkflows | Adxstudio Portals Base Work |
| 12. | CustomerServiceSurvey | Customer Service Survey |
| 13. | AdxstudioHelpDeskWorkflows | Adxstudio Help Desk Workflows |
| 14. | AdxstudioHelpDesk | Adxstudio Help Desk |
| 15. | AdxstudioCommerce | Adxstudio Commerce |
| 16. | AdxstudioForumWorkflows | Adxstudio Forum Workflows |
| 17. | AdxstudioForums | Adxstudio Forums |
| 18. | AdxstudioEventManagement | Adxstudio Event Management |
| 19. | AdxstudioWebForms | Adxstudio Web Forms |
| 20. | AdxstudioIdentity | Adxstudio Identity |
| 21. | AdxstudioPortals | Adxstudio Portals Base |
| 22. | AdxstudioPortalsDependencies | Adxstudio Portals Dependencies |
| 23. | AdxstudioCRM2011ProductivityPack | Adxstudio CRM 2011 Productivity Pack |
| 24. | AdxstudioInstaller | Adxstudio Installer |
Step 3: Once all the solutions of ADX Portal are deleted or uninstalled from CRM Environment the user can then configure a new portal for the same CRM Environment.
Problems Faced while Uninstalling/ Deleting solutions of ADX Portal
The user might face many difficulties while uninstalling / deleting solutions from the CRM environment.
One of the major problems which users mostly face is “Solution having other internal Dependencies” which prevents the solution from being uninstalled. In the below example we will try to uninstall the “Adxstudio Portal Base” solution from the CRM Online environment.
Step 1: Select the ADX Portal solution that you want to delete from the system, in this case it is “Adxstudio Portal Base” solution.
Step 2: On clicking the delete command the following dialog box will appear click on OK to proceed. Mostly the following error message appears as shown below(i.e. the error message pops up cause the solution that the user is trying to delete has internal dependencies), the user will have to click on ‘Details’ to view the list of dependencies.
Fig 3.1 Pop up dialog to Uninstall the solution.
Fig 3.2 Error message that solution cannot be deleted
Fig 3.3 List of Dependency Details which are preventing the solution from being uninstalled.
Step 3: The user has now the list of dependencies due to which the solution cannot be uninstalled from the CRM Environment. The user has to remove/delete the dependencies in order to uninstall the solution. If the user is able to remove the dependencies the user can proceed to uninstall the solutions.
Issue Faced:
Most of the times the dependencies cannot be deleted which in return causes the solution from being uninstalled from which in return causes the ADX Portal from not being uninstalled.
The following are possible ways of dealing with the issue faced:
- Mostly the users will have to leave the solutions that aren’t being uninstalled as residual solutions and try provisioning the new CRM Portal.
- Else will have to wait for Microsoft to fix the following issue of not being able to uninstall the residual solution in their future updates on Portals.
Conclusion:
Dependencies in the Adxstudio solutions can cause the ADX Portal solution from not being uninstalled. In this case the user can try installing the CRM Portal leaving the uninstalled solutions as ‘Residual solution’. Waiting for the following issue to be fixed in further updates on portals from Microsoft.