Sunday, 14 September 2014

Uninstalling K2 blackpearl

Uninstalling K2 blackpearl
Use the Installation Manager (K2Setup.exe) to uninstall K2 blackpearl. After successfully uninstalling, there are several manual steps in order to go back to a clean server with no traces of K2 blackpearl. These are detailed in Step 2 below.
Step 1: Remove K2 blackpearl using the Installation Manager
  1. Shut down all K2 related processes (K2 Designer for Visual Studio, K2 Designer for Visio, K2 Web Designer for SharePoint, K2 blackpearl Server service).
  2. Run the installation manager (K2Setup.exe) and select "Remove K2 blackpearl".


[Figure 1. K2 blackpearl Maintenance page]
  1. Follow the prompts through the wizard and reboot after the uninstall is finished.

Step 2: Manually remove remnants
  1. The K2 blackpearl menu item is left in the Start Menu. Delete this menu item by right-clicking the Start menu and selecting Explore All Users. Then browse to the K2 blackpearl folder and delete it.
  2. The SourceCode registry key remains. Delete this registry key, located atHKEY_LOCAL_MACHINE > SOFTWARE > SourceCode
  3. The K2 blackpearl folder structure remains. Delete the folder structure located at[installation drive]:\Program Files (x86)\K2 blackpearl
  4. The databases remain in SQL Server so that data is preserved. To restore the server to a clean state, delete the K2 database. If you need to preserve process or logged information, make a backup copy before deleting the database.
http://help.k2.com/img/hs-note.gif
Note: If you have not consolidated your databases, you must delete the following K2 databases: Categories, Depedencies, EnvrionmentSettings, EventBus, EventBusScheduler, HostServer, K2Server, K2ServerLog, K2SQLUM, SmartBox, SmartBroker, SmartFunctions, WebWorkflow and Workspace. 

Step 3: SQL Reporting Services fix
http://help.k2.com/img/hs-note.gif
Note: This step is only required if you encounter an error browsing to the SQL Web Service or if you are not able to open SQL Reporting Services after the uninstall. This step only needs to be performed on the server that has the K2 for Reporting Services component installed.
  1. After uninstalling K2 blackpearl, browse to C:\Program Files\Microsoft SQL Server\MSSQL.2\Reporting Services\ReportServer (this location may vary depending on where you installed SQL Server Reporting Services as well as the version of SQL that you have installed)
  2. Edit the rssrvpolicy.config file in a text editor such as Notepad
  3. Find the CodeGroup node, and edit it as specified below:

<CodeGroup version="1" PermissionSetName="Nothing">
<IMembershipCondition version="1">
</IMembershipCondition>
</CodeGroup>
  1. Save your changes to the file

Validating the Uninstall
After uninstalling K2 blackpearl and performing the manual steps above, reboot the machine. Then, to ensure the environment does not have any K2-related components, use the following checklist: 
  1. No K2 Databases are present on the SQL Server
  2. The K2 blackpearl menu items are not present under Start > Programs
  3. No K2 components are present in Add/Remove programs (Start > Control Panel > Add/Remove Programs)
  4. No SourceCode nodes are present in the machine.config file
  5. No SourceCode assemblies are in the GAC (C:\Windows\Assembly)
  6. No K2 blackpearl folder is located under Program Files
  7. No K2 For SharePoint tab in the SharePoint 3.0 Central Administration Site
  8. No K2WorklistWebpart.wsp located in the SharePoint 3.0 Central Administration Site
  9. No issues opening the SQL Server Reporting Services home page
  10. Check K2 blackpearl Server service removal. If the service is still present it will be listed in the Services Console but in a stopped state.
  11. Verify SharePoint solutions removal (if SharePoint was part of the solution)
    • Go to [installation drive]\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS and check if the folders of K2 and K2BlackPearlPages are removed
  12. Check IIS to ensure K2 has been completely removed and the app pools associated with K2 sites are removed.