Nintex Forms 2010 Uninstall Guide

Transcription

1 Nintex Forms 2010 Uninstall Guide

2 Contents Uninstalling Nintex Forms Removing the Nintex Forms 2010 Solution... 3 Removing the Nintex Forms Database... 3 Removing the settings object from the SharePoint database... 3 Uninstalling the Nintex Live Framework... 4 Uninstalling the Nintex Live Relay Sevice... 4 Troubleshooting

3 Uninstalling Nintex Forms 2010 Follow the steps below to completely uninstall Nintex Forms Removing the Nintex Forms 2010 Solution 1. Disable the Nintex Forms 2010 site collection features on all site collections that use Nintex Forms Navigate to SharePoint Central Administration. Note: If Nintex Live Forms was enabled, perform the following: a. Disable the Nintex Live Forms site collection feature on all site collections. b. In the Quick Launch menu, click Nintex Forms Management. In the Nintex Forms Management section, click the Live Forms settings link. c. In the Enable Nintex Live Forms section, click on Disable. d. In the Nintex Forms Management section, click on Manage Live Mobile Access. Click Disable to disable the Live Mobile Access. e. In the Application Management section, click on Manage services on server. Locate the Nintex Live Relay Service, and click the Stop link. f. Locate the Nintex Forms Compatibility Relay Service, and click the Stop link. Note: Repeat step E and F for all servers where Nintex Live is installed on. To change the server, click on the dropdown arrow above the Action column in the Services on Server page. 3. In the Quick Launch menu, click Application Management. 4. In the Web Applications section, click the Manage web applications link. 5. Select the Web Application that Nintex Forms 2010 has been deployed to. 6. In the Ribbon, click on Manage Features. 7. In the Manage Web Application Features dialog, click Deactivate on Nintex Forms. Click Deactivate this feature in the warning dialog. 8. In the Quick Launch menu, click System Settings. In the Farm Management section, click the Manage farm solutions link. 9. Click the nintexforms2010.wsp link. 10. Click the Retract solution link. 11. Click on the nintexforms2010.wsp link again, and then click the Remove solution link. 12. Remove the following content types from the site collection by permanently deleting all related tasks and deleting content type from list and site. a. Nintex Workflow Multi Outcome Task using Nintex Forms b. Nintex Workflow Task using Nintex Forms Removing the Nintex Forms Database 1. Open Microsoft SQL Server Management Studio and delete the associated Nintex Form database(s). Removing the settings object from the SharePoint database 1. Click the Start menu and navigate to All Programs > Microsoft SharePoint 2010 Products > SharePoint 2010 Management Shell. 3 9

4 2. In the SharePoint Powershell Command Prompt, type: $farm = Get-spfarm $farm.removeobsoleteclass("4db6f71e-05ff-4383-b16e-abc5a57057c5") Uninstalling the Nintex Live Framework Note: Complete this entire section if you have Nintex Live v installed. If your version of Nintex Live is earlier than v , do not complete step 2. Uninstalling the Nintex Live Relay Sevice Retracting the Nintex Forms 2010 Solutions and the Nintex Live Core Solution from SharePoint will not remove the Nintex Live Relay Service and the Nintex Forms Compatibility Relay Service. If these two services are not stopped before retracting any of the Nintex solutions, the retract may fail due to file locking issues. The following script should be executed to remove the two Services. Requirements The user executing the script will need appropriate permissions to SharePoint and Windows The server running the script will need access to all other servers within the SharePoint Farm Run the script in SharePoint Management Shell The PowerShell script will: Attempt to uninstall all instances of the Nintex Live Relay Services and Nintex Forms Compatibility Relay Service on each server within the SharePoint Farm Remove Windows Service and SharePoint Service related to the Nintex Live Relay Service and Nintex Forms Compatibility Relay Service Please note: The physical files used by the Nintex Live Relay Service will not be removed, they will remain in the physical directory which is typically located at: "C:\Program Files\Common Files\microsoft shared\web Server Extensions\15\BIN\NintexLive\" Similarly, the physical files used by the Nintex Forms Compatibility Relay Service will not be removed, they will remain in the physical directory which is typically located at: "C:\Program Files\Common Files\microsoft shared\web Server Extensions\15\BIN\NintexForms\" To run the PowerShell script: 1. If you have not previously stopped the Nintex Live Relay Service and Nintex Forms Compatibility Relay Service in Removing the Nintex Forms 2010 solution, ensure you follow steps 2 and 3. If you have stopped these services, begin at step

5 2. In the Application Management section, click on Manage services on server. Locate the Nintex Live Relay Service, and click the Stop link. 3. Locate the Nintex Forms Compatibility Relay Service, and click the Stop link 4. Open SharePoint 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 5. Enter the following script. Note: This script is only applicable if your version of Nintex Live is v3.0.2 or above. function Test-ServiceResult( [string]$operation = $(throw "operation is required"), [object]$result = $(throw "result is required"), [switch]$continueonerror = $false) $retval = -1 if ($result.gettype().name -eq "UInt32") $retval = $result else $retval = $result.returnvalue if ($retval -eq 0) return $errorcode = 'Success,Not Supported,Access Denied,Dependent Services Running,Invalid Service Control' $errorcode += ',Service Cannot Accept Control, Service Not Active, Service Request Timeout' $errorcode += ',Unknown Failure, Path Not Found, Service Already Running, Service Database Locked' $errorcode += ',Service Dependency Deleted, Service Dependency Failure, Service Disabled' $errorcode += ',Service Logon Failure, Service Marked for Deletion, Service No Thread' $errorcode += ',Status Circular Dependency, Status Duplicate Name, Status Invalid Name' $errorcode += ',Status Invalid Parameter, Status Invalid Service Account, Status Service Exists' $errorcode += ',Service Already Paused' $desc = $errorcode.split(',')[$retval] $msg = ("0 failed with code 1:2" -f $operation, $retval, $desc) if (!$continueonerror) Write-Error $msg else Write-Warning $msg function Uninstall-Service( [string]$servicename = $(throw "servicename is required"), [string]$targetserver = $(throw "targetserver is required")) $service = Get-WmiObject -Namespace "root\cimv2" -Class "Win32_Service" -ComputerName $targetserver -Filter "Name='$serviceName'" -Impersonation 3 5 9

6 if (!($service)) Write-Warning "Failed to find Windows Service $servicename on $targetserver. Nothing to uninstall." return "Found windows service $servicename on $targetserver; checking status" if ($service.started) "Stopping windows service $servicename on $targetserver" $result = $service.stopservice() Test-ServiceResult "Stop Service" $result "Attempting to uninstall windows service $servicename on $targetserver" $result = $service.delete() Test-ServiceResult "Delete Service" $result "Uninstall Windows Service $servicename on $targetserver Complete" function Uninstall-SharePointServiceInstance( [string]$servicename = $(throw "servicename is required"), [string]$targetserver = $(throw "targetserver is required")) $instance = Get-SPServiceInstance -Server $targetserver where $_.name -eq $servicename if ($instance -ne $null) "Found SharePoint Service Instance $servicename on $targetserver" $instance.delete() "Uninstall SharePoint Service Instance $servicename on $targetserver Complete" else Write-Warning "Failed to find SharePoint Service Instance$serviceName on $targetserver. Nothing to uninstall." function Uninstall-SharePointService( [string]$servicename = $(throw "servicename is required")) $farm = Get-SPFarm $service = $farm.services where $_.name -eq $servicename if($service -ne $null) "Found SharePoint Service $servicename" $service.delete() "Uninstall SharePoint Service $servicename Complete" else Write-Warning "Failed to find SharePoint Service $servicename. Nothing to uninstall." Add-PSSnapin 'Microsoft.SharePoint.PowerShell' $farm = Get-SPFarm $servers = $farm.servers foreach ($server in $servers) if ($server.role -ne "Invalid") UnInstall-Service -ServiceName "Nintex Forms Compatibility Relay Service" -TargetServer $server.address 6 9

7 UnInstall-SharePointServiceInstance -ServiceName "NintexFormsCompatibilityRelayServiceInstance" -TargetServer $server.address UnInstall-Service -ServiceName "Nintex Live Relay Service" -TargetServer $server.address UnInstall-SharePointServiceInstance -ServiceName "NintexLiveRelayServiceInstance" -TargetServer $server.address UnInstall-SharePointService -ServiceName "Nintex Live Relay Service" UnInstall-SharePointService -ServiceName "Nintex Forms Compatibility Relay Service" 6. Click the Start menu and navigate to All Programs > Microsoft SharePoint 2010 Products > SharePoint 2010 Management Shell. 7. In the SharePoint Powershell Command Prompt, type: Disable-SPFeature -Identity NintexLiveAdminLinks -url [Replace with Central Administration Web Application] e.g. Disable-SPFeature -Identity NintexLiveAdminLinks -url Uninstall-LiveService Uninstall-SPSolution -Identity NintexLiveCore.wsp Remove-SPSolution -Identity NintexLiveCore.wsp Note: For all the Confirm prompts. Select Y. Note: If the Remove-SPSolution command fails with an error The solution nintexlivecore.wsp has been deployed in the farm and the NintexLiveCore.wsp has not been removed from the Solutions Management in Central Administration. Please perform an iisreset and repeat that last command (Remove-SPSolution - Identity NintexLiveCore.wsp ) 8. In the Quick Launch menu, click System Settings. In the Farm Management section, click the Manage farm solutions link. 9. Click the nintexforms2010core.wsp link. 10. Click the Retract solution link. 11. Click on the nintexforms2010core.wsp link again, and then click the Remove solution link. 7 9

8 Troubleshooting The RPC Server is unavailable If the error message The RPC Server is unavailable appears, this is most likely due to the Firewall. Firewall restrictions may limit access to other servers in the farm. An alternative is to execute the script on each server that contains the error message. Before executing the script on each server, replace the foreach loop at the bottom of the script with the code as shown below (Remember to specify the local server name directly in the script): Replace: foreach ($server in $servers) if ($server.role -ne "Invalid") UnInstall-Service -ServiceName "Nintex Forms Compatibility Relay Service" -TargetServer $server.address UnInstall-SharePointServiceInstance -ServiceName "NintexFormsCompatibilityRelayServiceInstance" -TargetServer $server.address UnInstall-Service -ServiceName "Nintex Live Relay Service" -TargetServer $server.address UnInstall-SharePointServiceInstance -ServiceName "NintexLiveRelayServiceInstance" -TargetServer $server.address With: UnInstall-Service -ServiceName "Nintex Forms Compatibility Relay Service" -TargetServer EnterLocalServerNameHere UnInstall-SharePointServiceInstance -ServiceName "NintexFormsCompatibilityRelayServiceInstance" TargetServer EnterLocalServerNameHere UnInstall-Service -ServiceName "Nintex Live Relay Service" -TargetServer EnterLocalServerNameHere UnInstall-SharePointServiceInstance -ServiceName "NintexLiveRelayServiceInstance" -TargetServer EnterLocalServerNameHere Manually uninstalling the Nintex Live Relay Service may cause the following error in the PowerShell script Found SharePoint Service Instance NintexLiveRelayServiceInstance on SERVERNAME Exception calling "Delete" with "0" argument(s): "An object in the SharePoint administrative framework, "NintexLiveRelayServiceInstance Name=NintexLiveRelayServiceInstance", could not be deleted because other objects depend on it. Update all of these dependants to point to null or different objects and retry this operation. The dependant objects are as follows: SPServiceInstanceJobDefinition Name=job-service-instance-dea1573a a-809f4d5052bc... To correct this: 1. Open SharePoint PowerShell and run the following script: $job = Get-SPTimerJob where $_.Name -eq "NAME_IN_ERROR" $job.delete() 8 9

9 Note: The NAME_IN_ERROR corresponds to the SPServiceInstanceJobDefinition name that is shown in the error when running the uninstall script. 2. Re-run the uninstall script. 9 9