Reflects the current release of Nintex for SharePoint 2016. For your version, please access assistance through the Help button in the product.
This topic describes how to uninstall Nintex Workflow and Nintex Forms completely. Follow these instructions for servers on which you do not intend to reinstall Nintex products.
To facilitate an easy reinstall of Nintex products, perform the following tasks prior to uninstalling the Nintex platform.
Completely uninstalling Nintex Workflow and Nintex forms involves removing Nintex solutions, databases, web.config entries, and external platform components, as well as SharePoint libraries and lists used to interact with Nintex products.
Note: Retracting Nintex solutions from SharePoint will not remove Nintex External Relay Service. If Nintex External Relay Service is not stopped before retracting related solutions, then the retraction may fail due to locking issues. See instructions below to remove Nintex External Relay Service.
To uninstall Nintex features and solutions
Disable Nintex features on all relevant sites and site collections in SharePoint.
Nintex Workflow: Disable Nintex features on all sites using Nintex Workflow.
Disable Nintex features on all site collections using Nintex products.
Nintex features for site collections include external forms as well as Nintex Workflow.
Nintex Forms - External forms: Disable external forms options and services.
On the Central Administration Home page, click Nintex Administration, click External forms settings, and then click Disable for Enable external forms.
On the Central Administration Home page, click Nintex Administration, click Remote mobile access, and then click Disabled for Enable External Mobile Access.
Deactivate Nintex features for all relevant web applications.
Nintex Workflow: On the Central Administration Home page, click Nintex Administration, click Web Application activation under Licensing and setup, select the check box for All content web applications, and then click Deactivate.
Nintex Forms: On the Central Administration Home page, click Application Management, click Manage web applications under Web applications, and then for each web application on which you want to deactivate the product, select the web application, click Managed Features, and then click Deactivate for Nintex Forms.
Note: When Nintex Forms is deactivated, the web.config file for the web application is updated to remove Nintex.Forms references.
Stop all Nintex services by disabling related features as follows.
Retract and remove Nintex solutions in the following sequence.
nintexworkflow2016enterprisefeatures.wsp
nintexworkflow2016.wsp
nintexworkflow2016core.wsp
nintexforms2016core.wsp
nintexforms2016.wsp
nintexexternalconnection.wsp
nintexcommon.wsp
Steps to retract and remove a solution:
On the Central Administration Home page, click System Settings and then click Manage farm solutions.
On the Solution Management page, click the name of the solution.
On the Solution Properties page, click Retract Solution. The Solution Management page is redisplayed.
Click the name of the solution again.
On the Solution Properties page, click Remove Solution. The Solution Management page is redisplayed.
Nintex Forms: Delete the following content types and related tasks from all SharePoint lists and sites.
Nintex Workflow Multi Outcome Task (use Nintex Forms)
Nintex Workflow Task (use Nintex Forms)
To remove Nintex databases
Open Microsoft SQL Server Management Studio and delete databases associated with Nintex Workflow and Nintex Forms.
Nintex Forms: Remove the settings object from the SharePoint database: In SharePoint 2016 Management Shell, at the command prompt, type the following.
Caution: This procedure removes the Nintex Forms database, license, and other items from the SharePoint farm. If you plan to reinstall Nintex Forms in the future, we recommend skipping this procedure as removal of these items may cause issues in the installer. The remedy for this installation issue is to run the Install-NFservice PowerShell script using SharePoint 2016 Management Shell.
$farm = Get-spfarm
$farm.RemoveObsoleteClass("4DB6F71E-05FF-4383-B16E-ABC5A57057C5")
To remove Nintex web.config entries
On the server’s file system, navigate to the folder hosting the web application.
Default path: C:\inetpub\wwwroot\wss\virtualdirectories\80
Open web.config with a text editor.
Find and delete any of the following references.
Nintex.Workflow
In SharePoint 2016 Management Shell, use the following commands to remove the farm properties added by Nintex Workflow.
$farm = get-spfarm
$farm.properties.remove(“NintexWorkflowServer2016License”)
$farm.properties.remove(“NW2007ConfigurationDatabase”)
$farm.update()
Note: The "NW2007ConfigurationDatabase" reference is correct.
To remove Nintex External Relay Service
Obtain a login account that meets the following requirements.
Access SharePoint 2016 Management Shell.
Note: Alternatively, you may also run this script in Windows PowerShell. If you do, you need to add the following line to the script: Add-PSSnapin ‘Microsoft.SharePoint.PowerShell’
Enter the following script on each server that is hosting Nintex External Relay Service.
Script (.zip): Right-click to save a copy
Note: This script attempts to stop and uninstall all instances of Nintex External Relay Service and remove Windows and SharePoint services related to Nintex External Relay Service. However, related files remain on the server, typically at the following path. C:\Program Files\Common Files\microsoft shared\Web Server Extensions\16\BIN\ExternalPlatform\
Access the SharePoint 2016 Management Shell; at the SharePoint PowerShell command prompt, type the following, where http://mysharepoint:12345 is your Central Administration web application URL.
Disable-SPFeature -Identity NintexLiveAdminLinks -url http://mysharepoint:12345
Uninstall-ExternalPlatform
Uninstall-SPSolution -Identity NintexExternalConnection.wsp
Remove-SPSolution -Identity NintexExternalConnection.wsp
Note: Select "Y" for all confirmation prompts.
To remove SharePoint libraries, lists, and content types
Nintex Workflow: Delete the following libraries, lists, and (optionally) content types.
Libraries and lists:
/NintexWorkflows
/Lists/NintexWorkflowHistory
/Workflows/NintexWorkflow
Content types:
Nintex Biztalk Task
Nintex Workflow Multi Outcome Task
Nintex Workflow Multi Outcome Task using InfoPath
Nintex Workflow Task
Nintex Workflow Task using InfoPath
Workflow
Workflow Snippet
Workflow Template
Nintex Forms: Delete the following content types and related tasks from all SharePoint lists and sites.
Nintex Workflow Multi Outcome Task (use Nintex Forms)
Nintex Workflow Task (use Nintex Forms)