- 3 minutes to read

Uninstalling the Nodinite LDAP Adapter for Microsoft BizTalk Server

This guide provides a step-by-step process to safely uninstall the Nodinite LDAP Adapter for Microsoft BizTalk Server. Follow these instructions to avoid common pitfalls and ensure a clean removal from your environment.

✅ Clear prerequisites and preparation steps for safe uninstallation
✅ Minimize downtime and avoid BizTalk/GAC issues
✅ Repeatable process for multi-node BizTalk groups

You must restart BizTalk Host Instances configured as Send Handlers for the Nodinite LDAP Adapter for Microsoft BizTalk Server.

Prerequisites

Meet the following conditions before uninstalling the Nodinite LDAP Adapter for Microsoft BizTalk Server:

Before you uninstall

Ensure all prerequisites are met and review this guide before starting the uninstallation process.

Perform the uninstallation steps during an announced, pre-approved service window.

The host instances associated with the Nodinite LDAP adapter (send hosts) must be restarted. This might temporarily disrupt your run-time.

Caution: Multiple versions of the Nodinite LDAP Adapter may co-exist. Remove all installations; repeat the steps as necessary.

Uninstall steps

  1. Make sure no running service instances are using the LDAP adapter.
  2. Ensure there are no suspended messages destined for the LDAP adapter.
  3. Stop the 'Send Hosts' using the LDAP Adapter. This may involve stopping receive locations and orchestrations. Ensure no more messages are published to solutions using the LDAP adapter.
  4. Remove (or re-configure) all send ports using the LDAP Adapter to be uninstalled.
    In the Send Ports view , review the list of send ports using the Nodinite LDAP Adapter for Microsoft BizTalk Server, then sort on Transport Type.
    All Artifacts
    Review all send ports using the LDAP Adapter before removal.
  5. Remove the adapter from the BizTalk group using the BizTalk Server administration console.
  6. Start the host instances to resume normal operations of your Microsoft BizTalk Server environment.
  7. Exit the BizTalk Server Administration Console (group hub).
  8. Unregister the LDAP Adapter on every node where the adapter is installed.

Repeat on all nodes

  1. As an Administrator, log on with RDP to the BizTalk processing node.
  2. Open an administrative command prompt.
  3. Navigate to the location where the adapter is installed.
  4. Execute the following command to unregister the LDAP Adapter:
IS.BizTalk.Adapters.LDAP.InstallationClient.exe /u

If there were no errors reported during the un-registration process, exit the command prompt.

  1. Execute the MSI package and select the option to uninstall.

Post uninstall steps

  1. Update your installation documentation/wiki/sharepoint and inform stakeholders about the new state of the environment.
  2. Cancel the SA agreement if this was the last installation and the product should no longer be used.
  3. Please send feedback to support@nodinite.com about your experience with our adapter. We appreciate your comments.