Building .Net Connectors and Connector Framework

Last modified 22 Apr 2021 17:31 +02:00
This functionality is obsolete. It is no longer supported or maintained.

Information provided on this page was tested on Windows 7 SP1 machine, but it should work on any reasonably recent Windows platform.

Download and install required software

Required software:

  1. MSBuild Community Tasks - from Tested versions and

  2. NUnit - from Tested versions 2.6.2 and 2.6.4.

  3. Windows Installer XML (WiX) toolset - from Tested versions 3.7.1224.0 and 3.9 R2 (3.9.1208.0).

Optional software:

  1. A development tool (either Visual Studio or SharpDevelop)

Set environment variables

Set the following variables - either via .BAT file or directly in the Control Panel. Of course, use appropriate paths to WiX, NUnit and .Net framework.

set WIX_HOME=C:\Program Files (x86)\WiX Toolset v3.9
set NUNIT_HOME=C:\Program Files (x86)\NUnit 2.6.4
set Path=%Path%;c:\Windows\Microsoft.NET\Framework\v4.0.30319\;%WIX_HOME%\bin

Get and build the framework (ConnId)

Getting the framework:

C:\midpoint\git> git clone

…​and compiling it:

C:\midpoint\git\ConnId\dotnet> msbuild ConnectorFramework.sln /p:Configuration=Release /p:ZipRelease=true

There are some compilation & NUnit warnings, but overall the build finishes with no hard errors.

As a result, in c:\midpoint\git\ConnId\framework-{version}\ServiceInstall\bin\Release directory there are openicf-{version}-dotnet.{zip|msi} files ready to be installed.
Also, in c:\midpoint\git\ConnId\framework-{version}\Dist there are yet another relevant .zip files.

Get and building AD/Exchange connectors

According to the manual, I’ve created a directory c:\build\icf, holding content of the following zip files:





originally found in c:\build\framework-\Dist.

(Then I do the same for framework-snapshot → c:\build\icf-snapshot.)


C:\build> set OPENICF_HOME=c:\build\icf
C:\build> svn checkout connectors-


C:\build> set OPENICF_HOME=c:\build\icf-snapshot
C:\build> svn checkout connectors-snapshot

…​and compiling it (either snapshot or stable version)

C:\build\connectors-> c:\Windows\Microsoft.NET\Framework\v4.0.30319\MSBuild.exe DotNetConnectors.sln /p:Configuration=Release /p:ZipRelease=true

Again, there are some warnings, but overall the build finishes with no hard errors.

I do not wholly understand the version numbering scheme (framework vs. connectors - vs. Note: Connectors in last stable version ( seem not to be different from the snapshot.

Was this page helpful?
Thanks for your feedback