- 3 minutes to read

Nodinite Null Adapter for Microsoft BizTalk Server 2020

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 4.7

Install

Repeat the install steps below on all BizTalk Server processing nodes.

Step 1: Install the software

  1. As a local administrator, execute the MSI package

Step 2: Navigate to the install folder

Navigate to the folder where you installed the Nodinite Null Adapter, default location is:

C:\Program Files\Nodinite\Null Adapter

Step 3: Run the installer

Logged on as local administrator, run the Install.exe

InstallCommand

You should then be prompted to install the Nodinite Null Adapter for Microsoft BizTalk Server 2020. Answer 'Y' to confirm intent to install.

InstallCommand Successful installation

Step 3: Add Adapter to BizTalk

Next you will add the adapter to the list of installed Adapters.

  1. As 'BizTalk Server Administrator', open the BizTalk Server MMC

  2. Expand the tree and open the Adapters sub tree

  3. Right click and select the Add new Adapter option
    Add Adapter

  4. Select the `Nodinite Null Adapter 2.0.2.0'
    Select Adapter

  5. Name the Adapter
    Name

  6. Assign Hosts (Must be a Send Handler) Assign Hosts

Make sure to restart the hosts instances if you perform any changes

Restart Host Instances

Use the Null Adapter

From a Send Port, select the Nodinite Null Adapter (with the name you gave it during the installation):
Use

  1. Click on the Configure... button
  2. Enter a Name for this port (forms the URI and thereby provides traceability)
  3. Enter an optional Comment
  4. 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

NOTE: Logging to the local event log should ONLY be performed during debugging (you may post sensitive data to the local event log)

Uninstall

Step 1: Remove Adapter from BizTalk

  1. As 'BizTalk Server Administrator', open the BizTalk Server MMC
  2. Remove the Null Adapter from all Send ports where it is being used
  3. Remove the Adapter from the list of installed Adapters
  4. Restart Host instances where it was once used

Step 2: Remove Adapter from GAC

  1. Logged on as local administrator, run the Install.exe
    Uninstall
  2. Select 'Y' to remove the Adapter from GAC
  3. Restart the BizTalk MMC

Known issues

.NET Framework 4.7 Dependency

The installer cannot verify that .NET 4.7 is installed due to current limitations with the WIX installer.

Local Event Log

The events written to the local application log may be truncated due to restrictions in Windows. Please use Nodinite if you need logging from BizTalk.