- 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.

Understanding the Uninstall Process

The adapter is registered in two places: once in the BizTalk group (the adapter entry in the administration console) and once on every BizTalk node (the binaries in the GAC, installed by the MSI). Remove it from the group first, then from each node.

graph LR roStop["fa:fa-stop Stop send hosts
and remove send ports"] --> roGroup["fa:fa-layer-group Remove adapter
from BizTalk group"] roGroup --> roNode["fa:fa-server Unregister and uninstall MSI
on every node"] roNode --> roStart["fa:fa-play Start host instances"]

Diagram: the order of the uninstall steps, from the BizTalk group down to each node.

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.

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
    BizTalk Administration Console Send Ports view sorted on Transport Type
    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, as described below.

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.

  5. 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, read more on the Support page to submit your experience with our adapter. We appreciate your comments.

Next Steps