Installation Guide for IF-MAP Server And Client

IF-MAP is a standard interface between the Metadata Access Point and other elements of the Trusted Network Connect (TNC) architecture. You can find documents define and specify IF-MAP HERE:

IF-MAP Server (Java)

– Install

IF-MAP Client/Library (C/C++)

– Install

Download one zip file from project iron (SERVER):
Download two zip file from libifmap2c (CLIENT):- “libifmap2c-0.2.0.tar.gz” & “libifmap2c-examples-0.2.0.tar.gz“.

I will provide Installation steps for above downloaded file on Ubuntu Linux.

The following are the files or dependencies required before starting Installation/build process:-

  1. g++
  2. cmake
  3. libxml2-dev
  4. libcurl4-gnutls-dev

For SERVER Installation:

The server file is already pre-build i.e binary file. You just have to extract And run it.

  1. Extract file
  2. cd irond-0.2.2-bin (Go inside the directory)
  3. run the shell script name ./
  4. and your server will start giving first message “0 [main] INFO – Starting irond version 0.2.2…

For CLIENT Installation:

You need to build the library source and please install all dependencies mentioned above before proceedings.

  1. Extract file libifmap2c-0.2.0.tar.gz
  2. $cd libifmap2c-0.2.0/build/ (Go inside the directory named ‘build’)
  3. $cmake ../
  4. $make
  5. $sudo make install
  6. And you are DONE!

Now, Building the IF-MAP examples:-

  1. Extract file libifmap2c-examples-0.2.0.tar.gz
  2. $cd libifmap2c-examples-0.2.0/build/
  3. $cmake ../
  4. $make
  5. $ls ./ (list current directory build)

After listing your current directory, you will see many binary executable files are present.

These are the examples which you will run for testing the IF-MAP Client Server interaction.

Now, lets test some examples given in the WIKI and see the messages on the server of IF-MAP which we started earlier.

  1. $mkdir capath (in the current directory ‘build’)
  2. you need to copy a valid server certificate i.e $cp /path/to/servercert.pem capath
  3. If you have no valid certificate no need to panic if you get the error message given below when running the module with given parameters.
  4. $./ip-mac update 11:bb:cc:dd:ee:ff https://localhost:8443 test test capath/

Doing newSession... CommunicationError: server certificate verification failed.
CAfile: none CRLfile: none

There is a SMALL TWEAK which will help you testing your module without verification of valid certificate:

You have to edit the following file given in:


"#define CURL_VERIFY_PEER 1L" Change to "#define CURL_VERIFY_PEER 0L"

‘0L’ will skip the verification of certificate.

Again build the Client Library as shown above. Now, run again the module like this

$./ip-mac update 11:bb:cc:dd:ee:ff https://localhost:8443 test test capath/

Doing newSession… Ok! SessionID=”990489538-1344493087-220289568-279621823″ PublisherID=”test-18160887771″
Doing publish… Ok!
Doing endSession… Ok!

Baaamm!!! The module is executed successfully and you can also see the event messages on Server debug console. :)

  2 comments for “Installation Guide for IF-MAP Server And Client

  1. June 24, 2011 at 5:26 pm

    Hi Ankit,

    nice post 😉

    Regarding the “small tweak” you mentioned. This shouldn’t appear if you use the libcurl4-openssl-dev package instead of the libcurl4-gnutls-dev. I still need to figure out why they behave differently, but an easy fix is to simply replace the gnutls package with the openssl one. Also, running c_rehash for the capath is mandatory.


  2. June 24, 2011 at 5:46 pm

    Hi Arne,

    Thanks a lot for the information and glad that you gone throough this post.

    Well, I am very new to the IF-MAP. I started playing with IF-MAP client & server few days ago for one project. So, I thought to write a blog post for newbie like me to get started. 😉 I had no clue about libcurl4-openssl-dev package for this. I will try using this package also.

    ~Thanks again and keep clicking!

Comments are closed.

Social Media Icons Powered by Acurax Social Profile Design Experts