ࡱ>  @ PDbjbjPP "::P<FFFFG|czjXH~IIIIJKLK(zzzzzzz{R~vzUJJUUzIIzO[O[O[UIIzO[UzO[O[tvILH pƺ FU*buz3z0czzu8~Yl~0vv~v@'LO O[QR'L'L'Lzzd*H-E[ H-OnTimeMeasure-GENI Installation Document Prasad Calyam, Weiping Mandrawa, Kunpeng Zhu May 31, 2010 Software License: 'GENI Project License (GPL)'  TOC \o "1-3" \h \z \u  HYPERLINK \l "_Toc265050450" 1. Introduction  PAGEREF _Toc265050450 \h 1  HYPERLINK \l "_Toc265050451" 2. OnTimeMeasure-GENI Installation  PAGEREF _Toc265050451 \h 2  HYPERLINK \l "_Toc265050452" 2.1 System Requirements:  PAGEREF _Toc265050452 \h 2  HYPERLINK \l "_Toc265050453" 2.2. User Accounts  PAGEREF _Toc265050453 \h 2  HYPERLINK \l "_Toc265050454" 2.3 ProtoGENI Slice Creation and Configuration  PAGEREF _Toc265050454 \h 3  HYPERLINK \l "_Toc265050455" 2.4 Sliver Creation and Management  PAGEREF _Toc265050455 \h 4  HYPERLINK \l "_Toc265050456" 2.5 Prerequisites Installation  PAGEREF _Toc265050456 \h 4  HYPERLINK \l "_Toc265050457" 2.6 Prerequisite Configuration  PAGEREF _Toc265050457 \h 6  HYPERLINK \l "_Toc265050458" 2.7 OnTimeMeasure Invocation  PAGEREF _Toc265050458 \h 8  <(Should be consistent with Package Name throughout the document and should match naming in software package. Suggest changing title to OnTimeMeasure-v1.0 Installation or GENI OnTimeMeasure-v1.0 Installation 1. Introduction <(Should give scope of the document and introduce the user to the structure of the multistep install process.) (Suggestion: make Section 1 an Introduction and move system requirements to the Installation section 2.) 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 'OnTimeMeasure researcher web-portal' enables a ProtoGENI/Emulab user to register, create and monitor experiment slices on a geographically distributed backbone encompassing Internet2 resources with experiment nodes at Kansas, Washington and Utah locations. <> (Not sure how these two example help with an overview of the features delivered?) An example deployment of centralized OnTimeMeasure-GENI could feature 1 Root Beacon at Kansas, and 2 Node Beacons at Washington and Utah locations, respectively. An example deployment of distributed OnTimeMeasure-GENI could feature Node Beacons at Kansas, Washington and Utah locations, respectively. 2. OnTimeMeasure-GENI Installation 2.1 System Requirements: The OnTimeMeasure Service package has the following system requirements: Operating System: Fedora Prerequisite Software: MySQL, Graphite, Perl, Python, Iperf, Ruby, Bwctl-server, Bwctl-client, Twisted, perl-CPAN <>Tthe perl-cpan package is installed by scripts, should be added to the list. <> Should the Prerequisites Software be listed by system type? Operating System: Fedora (Which version?) RootBeacon Prerequisite Software: perl-CPAN, iperf, ruby, mysql-server, mysql-devel, python-devel, Django, mod_python, python-memcached, twisted, whisper, graphite, carbon. NodeBeacon Prerequisite Software: perl-CPAN, iperf, ruby, bctl-server, bwctl-client. Prerequisite Perl Modules: Config::Natural, POSIX, Sys::HostIP, DBD::MySQL, IO::SOCKET::SSL, Log::Log4perl:Net::SSLeay, Math::Random, YAML <> the YAML package is installed by scripts, should be added. The Prerequisites Software and Perl Modules installation is handled by the ontime_perlmodule_install.sh scripts delivered in the OnTimeMeasure-GENI-V1.0 package. See section following sections for details. 2.2. User Accounts To use the OnTimeMeasure-GENI service, a user must: register at the 'OnTimeMeasure researcher web-portal'. have an Emulab account for the University of Utah Emulab. 2.3 ProtoGENI Slice Creation and Configuration Once accounts are obtained, user should register a slice registration and create a sliver, these should exist before installation because <> (Should explain why slice and sliver are createdf before install??) Note: To obtain detailed information about ProtoGENI slice creation, please refer to the 'ProtoGENI Tutorial' THIS LINK NO LONGER EXISTS https://users.emulab.net/trac/protogeni/wiki/TutorialNew 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 'Emulab web-page'. Note that you will need to have an Emulab account to access the web-page. 2.4 Sliver Creation and Management Following are examples of slice registration and sliver creation, these should exist before installation because <> (Should explain why slice and sliver are createdf before install??) - Register a slice registerslice.py n Create sliver inside slice createssliver.py n - Start sliver startsliver n - Check sliver status sliverstatus n Note: You may need to renew your sliver just after successful creation. For this, renewsliver n