Installing Additional Tools

You may install tools beyond what is installed on the perfSONAR Toolkit by default. Since the perfSONAR Toolkit is a Linux box, in general any tool compatible with such an environment may be installed. Note that doing so does bare some inherent risk since they may touch configuration files managed by Toolkit software or have additional security considerations. This page details some common additional packages that one may want to install on a Toolkit host.

perfsonarUI

Description

perfsonarUI (psUI) is a web application for running and visualizing on-demand tests between perfSONAR measurement points (MPs) or visualizing historical measurement results obtained from perfSONAR measurement archives (MAs). It is designed to be intuitive and user friendly, thus allowing the network operator the troubleshoot network problems as efficiently as possible. The perfSONAR Toolkit by default contains a service named OPPD that allows for integration into perfsonarUI.

Installation

The perfsonarUI Installation Guide describes the deployment of the psUI for RPM or Debian based distributions using native package system or downloaded packages.

As of July 21st, 2015, current version of the psUI is 1.5.1 and can be downloaded as:

Note

If installing directly on your Toolkit host you will need to use the RPM.

Source Code

The perfSONAR UI source code can be browsed via Fisheye interface or retreived with subversion:

::
svn co http://svn.geant.net/GEANT/SA2/ps-visualisation-tools/perfsonar-ui-web/

Usage

The user guide describing how to use the psUI user interface can be found here. This guide covers each feature of the UI:

  • How to select a perfSONAR service
  • How to access historical measurements
  • How to make an on-demand measurement
  • How to troubleshoot a path
  • How to configure the UI
  • How to configure authentication with an identity provider

MaDDash

Description

The Monitoring and Debugging Dashboard (MaDDash) is software for concisely displaying and analyzing the results of network measurements between multiple hosts. If you have a small collection of tests you may want to install MaDDash on the same host as one of your Toolkit nodes.

Note

It is recommended you install MaDDash on a separate, non-Toolkit host, to ensure it does not affect test results.

Installation

You may install MaDDash via yum with the following:

yum install maddash

Usage

See the MaDDash web site here for a complete install and user guide.

Source Code

The MaDDash source code can be obtained from https://github.com/esnet/maddash