Installing the Nodinite LDAP Adapter for Microsoft BizTalk Server
Accelerate your integration projects with the Nodinite LDAP Adapter for Microsoft BizTalk Server. This guide walks you through a seamless installation process, ensuring you get the most out of your LDAP and Active Directory integrations.
✅ Simple MSI-based installation for rapid deployment
✅ Supports side-by-side versioning and easy upgrades
✅ Flexible configuration for multiple BizTalk nodes and environments
✅ Robust ALM support with best practices for updating and maintenance
Info
This guide teaches how to install the Nodinite LDAP Adapter for Microsoft BizTalk Server for use with LDAP and Active Directory.
Before you begin
Make sure you comply with the prerequisites.
Step 1: Execute the MSI-based installer
Repeat all steps on every BizTalk node part of the same BizTalk group
- Log on to the BizTalk node.
- Download the version of the LDAP adapter to the BizTalk node.
- Exit/quit/close all instances of BizTalk administration console(s) MMC.
- On the BizTalk node; Run/Execute the MSI file to install the binaries.
Accept the EULA to proceed with installation.
You must accept the EULA; check the checkbox 'I accept the terms in the License Agreement'. If you do not accept the terms, you cannot install or use the product.
The Advanced option lets you choose an alternate install path and select where to install components. We recommend using this option to copy the proposed path for later use. Always include a version number if you provide an alternate path. You can install this adapter side by side with future or older versions.
Tip
Save the selected installation paths and options in your documentation.
Example with the default installation path.
C:\Program Files (x86)\IS BizTalk LDAP Adapter 1.0\
- Select the features to install.
- On developer machines, you do not have to install the LDAP Adapter.
- On TEST/PROD machines, you do not need the examples or the test client.
Choose only the features you need for your environment.
- Finish the installation process of binaries by pushing the finish button.
Installation complete—ready for registration and configuration.
Step 2: Register the Nodinite LDAP Adapter for Microsoft BizTalk Server
In this step, you will GAC some assemblies by running an executable.
Depending on the features installed, the target folder(s) now contain the following files and folders (all features installed). Please verify that this is the case.
Don't run anything at this point yet, follow the documented steps that follow next.
Verify all binaries are present before proceeding.Import the LDAP Adapter into the BizTalk Server group.
Open an administrative command prompt (run as administrator) and navigate to the folder where you installed the binaries in earlier steps (path in your clipboard!). We recommend this approach since the install client may output valuable information about its progress.
From inside the administrative command prompt, execute the 'IS.BizTalk.Adapters.LDAP.InstallationClient.exe'
Register the adapter using the installation client tool.
Make sure you get the same output with Done and no errors as shown above.
Step 3: Import the Nodinite LDAP Adapter for Microsoft BizTalk Server
- Open the BizTalk Administration Console
Navigate to Adapters | right click to open dialogue | New | Adapter... |
Add a new LDAP Adapter in the BizTalk Administration Console.Select the LDAP Adapter from the Adapter drop down list
Name the LDAP Adapter. We strongly recommend a name including the version. This adapter was engineered with great versioning support and you are able to deploy multiple versions of the same adapter on the same environment (!!!) A unique name with version information will facilitate an upgrade without the need to uninstall dependent artifacts. A common hassle for BizTalk solutions…
You are free to choose the name; however, choosing a name for your LDAP Adapter can be a daunting prospect. It stays with the BizTalk Server for the rest of its life, so no pressure—it's a big decision.
Example with name including version number
Example: Naming the adapter with version information for easy upgrades.
A dialogue will appear informing about pending restart of the host instance. However, you should explicitly set the send handlers first, which is the next step. Press Ok and go to the next step in this guide.
Dialog prompts for host instance restart—set send handlers first.Navigate to the LDAP Adapter and make sure to set the preferred send handlers (Hosts) available for use in send ports in your solutions.
Assign send handlers to the LDAP Adapter for your BizTalk solutions.
The adapter supports both 32 and 64 bit handlers and there can be any number of send handlers associated with this adapter.
If there are multiple nodes in the BizTalk group, install the LDAP adapter by running the MSI installer on each node with the selected host instances. Since this might be a late design decision that may change over time, we recommend installing the binaries on all BizTalk Server nodes.
Make sure to install the run-time binaries on the other nodes before proceeding to the next step. Also, install the binaries using the same path on all nodes (recommended for easier maintenance and documentation).All host instances (on all nodes) associated with this adapter must now be restarted. Navigate to "Host Instances" in the BizTalk admin console for the group where the LDAP adapter was installed and restart the host instances.
Warning
Restarting BizTalk host instances can disrupt the availability of your other BizTalk Server integration solutions using the same set of BizTalk Host instances.
Next Step
The LDAP Adapter is a software product under constant development and new features and bug fixes are added over time. New releases are regularly available and free download and usage is covered by your SA.
We recommend that you plan for the updates of the LDAP Adapter within the context of your ALM process.
Related Topics
Nodinite LDAP Web API