Nodinite NULL Adapter for Microsoft BizTalk Server 2020
Effortlessly discard unwanted messages and optimize your BizTalk Server environment with the free Nodinite NULL Adapter. This guide explains how to install, use, and get the most value from this unique adapter, including secure tracking and long-term archiving with Nodinite.
✅ Instantly discard messages to prevent messagebox bloat and disk issues
✅ Enable secure, long-term archiving and tracking with Nodinite
✅ Simple installation and configuration—free to use
✅ Event log integration for troubleshooting and compliance
Use the free Nodinite NULL adapter with your BizTalk Server environment to efficiently discard messages of no particular interest. Stockpiling suspended messages in the BizTalk messagebox is inherently bad for performance and can eventually lead to running out of disk space unless addressed.
Important
The purpose of this adapter is to remove data; make sure you know what you are doing as you can permanently lose business-critical data.
Visual overview: The Nodinite NULL Adapter discards messages, while Nodinite enables secure tracking and archiving.
One way to keep the data for a controlled period is to use Nodinite and enable the built-in BizTalk tracking feature. Nodinite is plug and play and you can opt to keep the messages for as long as you like based on the message type. You can enable tracking on send ports with the Nodinite NULL adapter for BizTalk and still get the Logs from within Nodinite.
Read more about how Nodinite adds a long-term archiving solution for logging business-critical transactions here.
Download
Download the latest version of the free NULL adapter for BizTalk Server 2020 here.
Prerequisites
The Nodinite Null Adapter for Microsoft BizTalk Server 2020 requires the following products and versions to be in place before you can install and configure it:
Product | Version |
---|---|
BizTalk Server | 2020(!) |
.NET Framework | 4.7 or later |
Install
Repeat the installation steps below on all Microsoft BizTalk Server processing nodes.
Step 1: Install the software
- Make sure the .MSI file is not blocked by Windows (unblock from the 'Properties' modal).
- As the local administrator, execute the MSI package.
Step 2: Navigate to the install folder
Now, use the administrative CMD-prompt and navigate to the folder where you installed the Nodinite Null Adapter, the default location is:
C:\Program Files\Nodinite\Null Adapter
Step 3: Run the installer
Logged on as the local administrator, now run the Install.exe
file.
Install.exe
Run Install.exe to complete the adapter installation.
You should now be prompted to install the Nodinite Null Adapter for Microsoft BizTalk Server 2020. Answer 'y', to confirm the intent to install.
Step 4: Add Adapter to BizTalk
Next, you will add the Adapter to the list of installed Adapters.
- As 'BizTalk Server Administrator', open the BizTalk Server MMC
- Expand the tree and open the Adapters subtree
- Right-click and select the Add new Adapter option
Add the NULL Adapter to BizTalk Server. - Select the `Nodinite Null Adapter 2.0.2.0'
Select the correct adapter version. - Name the Adapter
Give your adapter a unique name for easy management. - Assign Hosts (Must be a Send Handler)
Assign the adapter to the appropriate send hosts.
Make sure to restart the host instances (if you perform any changes)
Restart host instances to apply changes.
Use the Null Adapter
From a Send Port, select the Nodinite Null Adapter (with the name you gave it during the installation):
Select the NULL Adapter on your Send Port.
- Click the
Configure...
button - Enter a Name for this port (forms the URI and thereby provides traceability)
- Enter an optional Comment
- Select True for the 'Log to local application event log' to get the first 31838 characters. All Events from the Null Adapter are logged with EventId=1337
Important
You should only log the local event during debugging (you may post sensitive data to the local event log).
Uninstall
Step 1: Remove Adapter from BizTalk
- As 'BizTalk Server Administrator', open the BizTalk Server MMC
- Remove the Null Adapter from all Send ports where it is being used
- Remove the Adapter from the list of installed Adapters
- Restart Host instances where it was once used
Step 2: Remove Adapter from GAC
- Logged on as the local administrator, run the
Install.exe
.
Run Install.exe to remove the adapter from the GAC. - Select 'Y' to remove the Adapter from GAC
- Restart the BizTalk Server MMC
Known issues / Troubleshooting
.NET Framework 4.7 Dependency
The installer cannot verify that .NET 4.7 (or later) is already installed, due to the current limitation with the WIX installer.
Local Event Log
The events written to the local application log are truncated due to the length restrictions in Windows. Please use Nodinite if you need logging from BizTalk Server.
If you encounter logs in the Application log stating 'The source was not found, but some or all event logs could not be searched.', then; execute the following Powershell script with elevated privileges.
eventcreate /ID 1 /L APPLICATION /T INFORMATION /SO "Nodinite Null Adapter" /D "Yet another solution to create an event log source"