BWCTL and OWAMP MP

From GEANT2-JRA1 Wiki

Contents

[edit]

BWCTL and OWAMP Measurement Point

Responsible: DFN-Labor, win-labor@dfn.de

[edit]

Introduction

This implementation of an MP is mainly a wrapper for command line measurement tools. At the moment, bwctl and owamp (owping) tests are supported. The implementation shares most parts with the Hades MA implementation.

[edit]

Software Download

[edit]

Newest Version 0.41

Only the perfSONAR base and perfSONAR-MP-BWCTL package changed: Fedora/RedHat

[edit]

Version 0.4:

[edit]
WebAdmin Configuration Tool

New WebAdmin configuration tool to configure your BWCTL MP via a web interface.

To install the WebAdmin tool, httpd and perl(cgi) are required. Note that this RPM does not configure your apache! To use it properly, we recommend setting up a password protected access and give the /home/labor/perfsonar.conf file write permissions to the apache user.

[edit]
Release 0.1

Fedora/RedHat

openSUSE 10.3

Debian

Platform independent CPAN tarball

[edit]
Release 0.1 RC5

Fedora/RedHat

[edit]
Release 0.1 alpha

Fedora/RedHat

[edit]
BWCTL MP software

The new release 0.4 is provided in different package formats for different operating system. There is also a platform independent CPAN style tarball that can be installed on any modern Perl installation. We have divided the software in three logically distinct packages, Perl-NWMG, Perl-perfSONAR, and Perl-perfSONAR-MP-BWCTL, compliant with the upcoming MDM perfSONAR 3.0 bundle release. Additionally, it is necessary to install iperf and bwctl software.

[edit]
Release 0.4

Fedora/RedHat

The packages are built on a Fedora 7 system, and probably run on other Fedora distributions also. In order to install these packages, you have to use the "rpm -i" command. They also have some dependencies for perl packages, provided by either Fedora itself or third parties RPM packages. You can install these with the "yum install" command.


openSUSE 10.3 - Broken dependencies! Use at your own risk


Debian


Platform independent CPAN tarballs

To install unpack the tarballs into a temporary directory and use the typical CPAN style Module::Build commands. Install the packages in the same order as below!

Example: 

tar -xzf NMWG-0.01.tar.gz
cd NMWG-0.01
perl Build.PL
./Build
./Build test
./Build install
[edit]
Older releases

Release candidate 5 (all three packages) now available:


Release candidate 4 (all three packages) now available:


Release candidate 3 of Perl-perfSONAR-0.4-MDM_perfSONAR_0.3.noarch.rpm now available:

If you want to upgrade this package, "rpm -U" might not work. as the naming changed slightly. You can erase the old package with "rpm -e" and install the new one with "rpm -i" or do a force upgrade.


Release candidate 2 of Perl-perfSONAR-0.4-MDM_perfSONAR_0.3.noarch.rpm now available:

Note that you also need to install Perl-NMWG and Perl-perfSONAR-MP-BWCTL from below. If you have already installed RC1 completely, you can upgrade Perl-perfSONAR with the "rpm -U" command.


A first release candidate is available:


Changelog to 0.2:

  • Added EchoRequest feature
  • Added Installation support for debian
[edit]

Older Versions:

Version 0.2 (also part of perfSONAR 2.0 bundle): DFN_Perl-Base_BWCTL-MP-0.2.tar.gz (15.03.2007)

Anonymous access to our subversion repository: https://tod.rrze.uni-erlangen.de/hades/tags/release-0.2

In the tools/perfSONAR-client directory you can find a perl client and example XML files to request the MP.

[edit]
Running Service
  • accessible at gandalf.rrze.uni-erlangen.de port 8090
  • can be tested with example XML requests from subversion repository
[edit]
How to install and run a BWCTL MP

1. Install Iperf and bwctl (if not done so already)

2. Download sources (see above)

3. Apply patches and install everything (see above)

4. Start MP service: 

      [/path/to/perfsonar/bin/]> ./perfsonar.pl.pl --port=50000 --pidfile=MP.pid --nosyslog --nologfile [--verbose --debug]

This starts a server, waiting for XML requests on port 50000. With 

      ./perfsonar.pl --help

all options are shown. You can use the syslog features, if you start the service as root.

5. Edit bwctl-req.xml in tools/perfSONAR-client/bwctl-req.xml (from repository):

  • insert source and destination addresses of the test hosts.
  • either source or destination should be the MP service host
  • if either source OR destination is omitted, the MP service host is chosen automatically
  • the following parameters are supported: 
     . "interval"     the report interval (bwctl option -i)
     . "protocol"     either udp or tcp, default is tcp (bwctl option -u for udp)
     . "bufferSize"   size of read/write buffer (bwctl option -l)
     . "windowSize"   size of tcp window / udp socket receive buffer (bwctl option -w)
     . "duration"     duration of test, default is 10 seconds (bwctl option -t)
     . "bandwidth"    limits udp send rate (bwctl option -b)
     . "ToS"          specifies ToS bit (bwctl option -S)
     . "login"        if authentication is needed
     . "password"     dito
  • if no parameters are given, a tcp test lasting 10 seconds is executed.

6. Run the client: 

    [/path/to/repository-checkout/tools/perfSONAR-client/]> ./perfsonar-client --host=<MPservice.host> --port=50000 -f bwctl-req.xml

Then, you have to wait some seconds, until the bwctl test is terminated. The response is then coming in XML format. You can redirect the output from the client to a file named bwctl-resp.xml, et voila!

7. Doing OWAMP

Do exactly the same, but install owping instead and use the owamp example request files in the perfSONAR-client directory.

Retrieved from "http://wiki.perfsonar.net/jra1-wiki/index.php/BWCTL_and_OWAMP_MP"
Personal tools