Version 3 (modified by, 7 years ago) (diff)


OnTimeMeasure-GENI Installation Procedure on Windows XP

Prasad Calyam, Yingxiao Xu
February 10, 2012

Software License: 'GENI Project License (GPL)'

1. Getting Started

This document describes the installation, configuration and usage of OnTimeMeasure, which is a measurement service for windows XP users. The measurement service can be used to perform centralized and distributed orchestration and provisioning of measurements within experiment slices for purposes such as:

  • Network paths monitoring
  • Network weather forecasting
  • Network performance anomaly detection
  • Network-bottleneck fault-location diagnosis

2. Requirements

The OnTimeMeasure software package has the following requirements:

  1. Open Ports: For Root Beacon server: MySQL TCP/3306, Graphite TCP/2003 and TCP/17280, Collector TCP/7777, HTTP TCP/17290, Supervisor TCP/17291; For Node Beacon server: Nodescheduler TCP/17249, HTTP TCP/17290, Supervisor TCP/17291 (Note: These ports are opened by default)
  1. User Accounts: User must have registered accounts in the OnTimeMeasure Researcher Web-portal

Note: Typically, two or more Node Beacons and one Root Beacon need to be installed on separate dedicated PCs. For windows users, the best way is to install Node Beacons on Windows, and install Root Beacon on Linux.

3. Node Beacon Installation

3.1 Install iperf

Download and install iperf 2.0.5 package in

3.2 Install Python-django

Download python 2.5.4 in (For other version, see -

Download Django 1.0.2 in (For other version, see -

Install python. Then add path to python installation folder by right click My Computer -> Properties -> Advanced -> Environment Variables -> System Variables -> Path , and add path C:\Python25;C:\Python25\Scripts.

Extract Django, run the following command to install Django. install

Aftar complete, type python, run the following command to check the installation.

 import django
 print django.get_version()

3.3 Install setuptools

Download and install setuptools for python 2.5 win 32 in (For other version, see -

Then navigate to the django-supervisor folder. Type

 easy_install django-supervisor 

Alternate links and methods:

3.4 Install Active-perl

Download and install Active-perl in

3.5 Install Log4Perl

Run ppm tools of Active-perl. Install Log4Perl under ppm prompt by invoke the following command

ppm>  install Log-Log4perl

3.6 Install libio-socket-ssl-perl and libnet-ssleay-perl/

Download and install in and

3.7 Setup SSL

Under ppm prompt by invoke the following command

Ppm> install

Download and unzip folder auto and IO under folder lib to C:\perl\site\lib

Download openSSL from and extract it to c:\OpenSSL-Win32\

Add c:\OpenSSL-Win32\bin to system path.

Make a config.txt file for openssl. A sample config.txt file is as follows:

[ req ]
default_bits = 1024
encrypt_key = yes
distinguished_name = req_dn
x509_extensions = cert_type
[ req_dn ]
OU=Automatically-generated SSL key
[ cert_type ]
nsCertType = server

Use the following command to generate cert and key
    openssl req -new -x509 -days 365 -nodes -config config.txt -out server-cert.pem -keyout server-key.pem

3.8 Copy NodeBeacon

Download and extract the latest OnTimeMeasure release package at

Once you have downloaded the tar file, untar/unzip to see that it contains:

  • NodeBeacon.tar.gz
  • RootBeacon.tar.gz
  • README.txt

Extract NodeBeacon to local disk.

Make two folder(tmp and log ) manually under folder NodeBeacon

4. NodeBeacon Adaption

4.1 Change file name to meet filename restriction of windows.

Change file Datagen\


   my $CurrTestTs = sprintf('%04d-%02d-%02d.%02d:%02d:%02d',

change to:

   my $CurrTestTs = sprintf('%04d-%02d-%02d.%02dX%02dX%02d'

Change file Datagen\


   $tt1 =~ s/\.//g;

Add a line behind:

   $tt1 =~ s/X//g;

4.2 Change the folder path

Change the folder path / to \ in and pythonlogger.conf

4.3 Change the Parser

In file, for tool of each metric you want to measure, change the parser to extract the data from the raw data in windows.

A sample parser for Ping tool

sub ping # ($ts, $src, $dst, @data)
        shift @_; # remove method name.
        my ($tt, $src, $dst, @fData) = @_;
        my @t_line = split (/ms/, $fData[-1]);
        my @data_size = split (/= /, $t_line[0]);
        @data_size = split (/= /, $t_line[1]);
        @data_size = split (/= /, $t_line[2]);
        my $dline = "ping\#$tt\#$min\#$max\#$avg\#$src\#$dst";
        return $dline;

5. NodeBeacon Startup

Run the following command to start NodeBeacon.

cd Datagen

cd Datagen

cd Datagen

6 Install Root Beacon

Choose a Linux machine as root beacon. SSH login into the root beacon.

Download and extract the latest OnTimeMeasure release package at

Invoke the following command to install RootBeacon.

tar xzf RootBeacon.tar.gz
cd RootBeacon/InstallScript

7 Software Invocation

Through OnTime Beacon web-portal

Login to the OnTimeBeacon. Setup resources (provide RSpec information) and control Node/Root Beacons within slice in an interactive manner. Video demos of these steps can be viewed at

Through OnTime Control command-line tools

Follow the 'OntimeControl Manual' to control Node/Root Beacons within slice in an automated manner.


This is only a installation document in case that you have to use Windows. We recommend you install OnTimeMeasure in Linux OS whenever possible.