= !OnTimeMeasure-GENI Installation Document = '''Prasad Calyam, Kunpeng Zhu'''[[BR]] Original: '''May 31, 2010'''[[BR]] Revised: '''July 16, 2010'''[[BR]] ''Software License:'' [http://www.geni.net/wp-content/uploads/2009/02/geniprojlic.pdf ''GENI Project License (GPL)''] [[BR]] ''For questions regarding this document, please contact - Kunpeng (Tony) Zhu kzhu@osc.edu '' == 1. Getting Started == This document describes the installation, configuration and usage of !OnTimeMeasure-v1.0, which is a prototype measurement service for the GENI facility users. The measurement service can be used to perform centralized and distributed orchestration and provisioning of active measurements within experiment slices for purposes such as: * Network paths monitoring * Network weather forecasting * Network performance anomaly detection * Network-bottleneck fault-location diagnosis The [http://ontime.oar.net ''OnTimeMeasure researcher web-portal''] enables a ProtoGENI/Emulab and !PlanetLab user to register, create and monitor experiment slices on a geographically distributed resources in the GENI facility. Before proceeding further, we highly recommend reading the [http://groups.geni.net/geni/attachment/wiki/OnTimeMeasure/OnTimeMeasure-v1_Tutorial_061610.pdf Early Experimenter Tutorial]. == 2. !OnTimeMeasure Installation: == === 2.1 Requirements === The !OnTimeMeasure software package has the following requirements: A. ''Operating System:'' Fedora[[BR]] B. ''Pre-requisite Software:'' MySQL, Graphite, Perl, Python, Iperf, Ruby, Bwctl-server, Bwctl-client,Cairo, Python_Twisted, Python_Piddle, perl-CPAN[[BR]] C. ''Perl Modules:'' Config::Natural, POSIX, Sys::HostIP, DBI, IO::SOCKET::SSL, Log::Log4perl, Net::SSLeay, Math::Random, YAML[[BR]] '''Note:''' The Pre-requisite Software and Perl Modules installation is handled by the scripts delivered in the !OnTimeMeasure-v1.0 package. See following sections for details. [[BR]] D. ''Open ports:'' For !RootBeacon server: MySQL TCP/3306, Graphite TCP/2003 and TCP/17280, Collector TCP/7777, HTTP TCP/17290; For !NodeBeacon server: BWCTL TCP/4823, Nodescheduler TCP/17249, HTTP TCP/17290 E. ''User Accounts:'' User must have registered accounts in the [http://ontime.oar.net OnTimeMeasure Researcher Web-portal] and [http://www.emulab.net Emulab Network Testbed] === 2.2 ProtoGENI Slice Creation and Configuration === '''Note:''' To obtain detailed information about ProtoGENI slice creation, please refer to the [https://users.emulab.net/trac/protogeni/wiki/TutorialNew ''ProtoGENI Tutorial''][[BR]] To create a ProtoGENI slice, we need to define the corresponding RSpec. An example of a centralized orchestration RSpec that consists of 3 nodes is as follows: {{{ 1000000 1000000 }}} To check availability of nodes to include in an RSpec, please refer to the [http://www.protogeni.net/trac/protogeni/wiki/FlashInterface ''ProtoGENI Flash Interface'']. === 2.3 Sliver Creation and Management === - Register a slice {{{ registerslice.py –n }}} - Create sliver inside slice {{{ createsliver.py –n }}} - Check sliver status {{{ sliverstatus –n }}} '''Note:''' You may need to renew your sliver just after successful creation. For this, {{{ renewsliver –n