NAM Adapter
NAM Adapter is the component in charge of the Network Active Monitoring data within the XIFI Infrastructure Monitoring Middleware (XIMM) (initial description and concepts provided in the deliverable D3.1- XIFI infrastructure adaptation components API open specification). This component provides a multi-domain monitoring mechanism able to handle latency and bandwidth-related tests along a set of points of interest within the federated community.
Install
Installation Requirements
The main recommendation to install the NAM Adapter is to deploy the software package on a host with Ubuntu/ Debian running as Operating System. If this was not the case, it would be necessary to check how to install additional packages that are required. NAM's software repository has been successfully tested with versions 12.10 and 13.10 of Ubuntu, and version 7.3 of Debian. No major issues are expected for upcoming versions.
In order to work properly, the component requires the following set of software modules:
- Node.js
- MongoDB
- NTP
- Iperf
The required software can be installed manually from the default Debian/Ubuntu repositories by using the following commands:
Install Node-js
$ sudo apt-get update
$ sudo apt-get install -y python-software-properties python g++ make
$ sudo add-apt-repository -y ppa:chris-lea/node.js
$ sudo apt-get update
$ sudo apt-get install nodejs
Install mongodb
$ sudo apt-get install mongodb
Install iperf
$ sudo apt-get install iperf
Install ntp
$ sudo apt-get install ntp
Installation of the NAM Adapter in Debian/Ubuntu
For install nam adapter uses the following command:
npm install nam_adapter
Run NAM Adapter
For run nam adapter uses the following commands:
$ cd nodes_modules/nam_adapter
../nam_adapter/ $ ./NAMadapter start
Usage
Request an On-Demand Test between endpoints
A Call instance resource represents a measure between a host A and host B. The following parameters are needed to run Test On-Demand (OWD or BDW):
- URI: http://{hostServerNAM}:{portNAM}/monitoring/host2hosts/{serviceType}/{regionId_Source}-{hostId_Source};{regionId_Destination}-{hostId_Destination}
- Method: GET
- Content-Type: Application/JSON
- Query string parameters: ?format=XML/JSON/TXT
- Request body: none
Example of usage:
curl --header "{my-token}" "http://138.4.47.33:3000/monitoring/host2hosts/owd/Trento-193.205.211.69;Waterford-193.1.202.133"
