Workbookinstalaçaoperfsonarpic SL 1.3

Installing and Configuring the perfSONAR
Services
Training Workbook
Installing and Configuring the perfSONAR Services Training Workbook
Issue 1.0
© DANTE 2007
All trademarks are acknowledged.
Every effort has been made to ensure that the information contained in this document is true and correct at the time of going to press.
However, the networks, systems, products, processes, specifications and content in general described in this document are subject to
continuous development and DANTE is entitled to change them at any time and to expand on them. DANTE cannot accept liability for any
loss or damage of any nature whatsoever arising or resulting from the use of or reliance on information or particulars in this document.
All names and other data used in examples are fictitious.
The information contained in this document is of a general nature. Should you require further advice for your particular business
requirements, please refer to the contact details below.
No part of this document may be reproduced by any means, other than with the express written permission of the copyright holder.
DANTE refers to Delivery of Advanced Network Technology to Europe Limited or any of its wholly owned subsidiaries.
Table of Contents
Table of Contents .................................................................................................. 3
Table of Slides ....................................................................................................... 4
Introduction ............................................................................................................ 9
Aim of the Workbook .................................................................................... 10
Course Objectives ........................................................................................ 11
Course Outline ............................................................................................. 12
Module 1 – perfSONAR Technical Overview ...................................................... 13
Module 2: General Installation Considerations.................................................... 46

Exercise: Installing the General Prerequisites ......................................................... 60
Module 3: Installing and Configuring the Lookup Service ................................... 62

Exercise: Installing and Configuring the Lookup Service ......................................... 75
Module 4: Installing and Configuring the BWCTL Measurement Point ............... 79

Exercise: Installing and Configuring the BWCTL MP ............................................... 92
Module 5: Installing and Configuring the SSH / Telnet Measurement Point ....... 94
Exercise: Installing and Configuring the SSH / Telnet MP ..................................... 111
Module 6: The Service Desk.............................................................................. 113
Module 7: Installing and Configuring the RRD Measurement Archive .............. 123
Exercise: Installing and Configuring the RRD MA.................................................. 147
Module 8: Carrying out an Installation on Debian.............................................. 152
Module 9: Installing and Configuring the SQL Measurement Archive ............... 161
Exercise: Installing and Configuring the SQL MA .................................................. 189
© DANTE 2007 Page 3 of 192

Table of Slides
The perfSONAR Administration Guide ................................................................ 14
What is perfSONAR?........................................................................................... 15
What are the perfSONAR Services? ................................................................... 16
Design Objectives................................................................................................ 17
Three-Tier Architecture........................................................................................ 18
What is a Service?............................................................................................... 19
Architectural Principles ........................................................................................ 20
The perfSONAR Services Framework (1) ........................................................... 21
The Client ............................................................................................................ 23
The Lookup Service............................................................................................. 24
The lookup Service (1) ........................................................................................ 25
The Lookup Service (2) ....................................................................................... 26
The Authentication Service.................................................................................. 27
The Authentication Service.................................................................................. 28
The Measurement Point Service ......................................................................... 29
Measurement Points............................................................................................ 30
The Measurement Archive Service ..................................................................... 31
Measurement Archives........................................................................................ 32
The Transformation Service ................................................................................ 33
The Resource Protector Service ......................................................................... 34
Protocols.............................................................................................................. 36
Generic Services and Service Implementations.................................................. 37
Service Implementations ..................................................................................... 38
Data Collection, Normalisation and Sharing via the Framework ......................... 39
Framework Facilitates Normalised end-to-end Performance Data (Simplified
Depiction) ..................................................................................................... 40
The perfSONAR Pilot: Measurement and Archiving Services............................. 41
The perfSONAR Pilot .......................................................................................... 42
The Roadmap...................................................................................................... 43
Technical Overview: Summary............................................................................ 44
The perfSONAR Services Framework - Recap................................................... 45
Page 4 of 192 © DANTE 2007
General Installation Prerequisites (1) .................................................................. 47
General Installation Prerequisites (2) .................................................................. 48
Other Installation Prerequisites............................................................................ 49
The Role of the Administration Guide.................................................................. 50
The Role of the Service Desk .............................................................................. 51
Installation Steps ................................................................................................. 52
How Does the Bundle Installer Work?................................................................. 53
Configuring the Services - Stitching .................................................................... 54
Stitching in Context (1) ........................................................................................ 55
Stitching in Context (2) ........................................................................................ 56
The Advantages of Stitching................................................................................ 57
Other Considerations........................................................................................... 58
Backups ............................................................................................................... 59
Lookup Messages................................................................................................ 67
Lookup Service-Specific Requirements............................................................... 68
Three-Stage Installation....................................................................................... 69
Hints and Tips...................................................................................................... 70
Testing ................................................................................................................. 71
Interaction with the Service Desk (1)................................................................... 72
Interaction with the Service Desk (2)................................................................... 73
Lookup Service Installation Overview.................................................................. 74
Measurement Points (1) ...................................................................................... 80
Measurement Points (2) ...................................................................................... 81
BWCTL MP Specifics .......................................................................................... 82
The BWCTL MP: User-Advantages..................................................................... 83
Four Stage Installation......................................................................................... 84
Installation Prerequisites...................................................................................... 85
Hints and Tips...................................................................................................... 86
Testing ................................................................................................................. 87
Issues When Installing Under Debian ................................................................. 88
Adding Measurements With Other Tools ............................................................ 89
Interaction With the Service Desk ....................................................................... 90
BWCTL MP Installation Overview ....................................................................... 91
SSH / Telnet MP Specifics (1) ............................................................................. 95
SSH / Telnet MP Specifics (2) ............................................................................. 96
SSH / Telnet MP: Available Commands.............................................................. 97
SSH / Telnet Measurement Point Use Cases ..................................................... 98
SSH / Telnet MP Prerequisites............................................................................ 99
Supported Network Devices .............................................................................. 100
Three Stage Installation..................................................................................... 101
Stitching............................................................................................................. 102
An Example of Stitching .................................................................................... 103
Hints and Tips (1) .............................................................................................. 104
Hints and Tips (2) .............................................................................................. 105
Hints and Tips (3) .............................................................................................. 106
Testing............................................................................................................... 107
Issues When Installing Under Debian ............................................................... 108
Interaction With the Service Desk ..................................................................... 109
SSH / Telnet MP Installation Overview ............................................................. 110
The Role of the Service Desk............................................................................ 114
The Duties of the Service Desk (1).................................................................... 115
Incident Management Example – Known Errors ............................................... 116
The Duties of the Service Desk (2).................................................................... 117
Success Factors ................................................................................................ 118
Supported Software........................................................................................... 119
L2 Status ........................................................................................................... 120
Information to Provide to the ASD ..................................................................... 121
Contact Details .................................................................................................. 122
Measurement Archives...................................................................................... 124
The RRD Measurement Archive (1) .................................................................. 125
The RRD Measurement Archive (2) .................................................................. 126
The RRD Measurement Archive in Context ...................................................... 127
RRD MA Installation Overview .......................................................................... 128
The RRD MA: Three Stage Installation ............................................................. 129
Testing ............................................................................................................... 130
Stitching for the RRD Measurement Archive..................................................... 131
RRD MA Stitching in Context............................................................................. 132
The Metadata Configuration File ....................................................................... 133
Stitching for the RRD MA – Three Step Process............................................... 134
Stitching for the RRD MA – Step 1 .................................................................... 135
Stitching for the RRD MA - Chains .................................................................... 136
RRD MA Metadata Chains – Example of Metadata .......................................... 137
RRD MA Metadata Chains – Example of Data.................................................. 138
Stitching for the RRD MA: Step 2 ...................................................................... 139
Stitching for the RRD MA: Step 3 ...................................................................... 140
Making the Measurement Archive Available to the Visualisation Tools ............ 141
Installation Prerequisites.................................................................................... 142
Hints and Tips.................................................................................................... 143
Issues When Installing Under Debian ............................................................... 144
RRD MA Installation Overview .......................................................................... 146
Overview of Debian ........................................................................................... 153
RRD MA Installation: Debian Base Installation ................................................. 154
Reminder: APT, DPKG, Locate are all Friends ................................................. 155
perfSONAR Bundle Installer / RRD MA Dependencies..................................... 156
Tomcat............................................................................................................... 157
Potential Issues ................................................................................................. 158
Final Touch ........................................................................................................ 159
Last but not Least…. Security ........................................................................... 160
The SQL Measurement Archive (1) ................................................................... 162
The SQL Measurement Archive (2) ................................................................... 163
Stitching for the SQL Measurement Archive ..................................................... 164
SQL MA Stitching in Context ............................................................................. 165
The Metadata Configuration File ....................................................................... 166
Stitching for the SQL MA – Three Step Process ............................................... 167
Stitching for the SQL MA – Step 1..................................................................... 168
SQL MA Architecture ......................................................................................... 169
Understanding the Path Status Metadata.......................................................... 170
Link Metadata and Node Metadata ................................................................... 171
Stitching – Metadata for Nodes and Links......................................................... 172
Stitching – Path Status Chains .......................................................................... 173
Simplified Link Path Metadata Example............................................................ 174
Node Metadata Example ................................................................................... 175
Link Chains – an Example................................................................................. 176
Link Chain Data – an Example .......................................................................... 177
SQL MA Architecture......................................................................................... 178
Stitching for the SQL MA – Interface Utilisation Chains .................................... 179
Stitching for the SQL MA: Step 2....................................................................... 180
Stitching for the SQL MA: Step 3....................................................................... 181
Three Stage Installation of the SQL MA............................................................ 182
Making the Measurement Archive Available to the Visualisation Tools ............ 183
Testing............................................................................................................... 184
Installation Prerequisites ................................................................................... 185
Hints and Tips.................................................................................................... 186
SQL MA Installation Overview........................................................................... 188

Installing and Configuring the perfSONAR Services: Training Workbook
Introduction
Introduction

Introduction
Aim of the Workbook
This workbook is designed for use in conjunction with the Installing and Configuring the
perfSONAR Services course.
The course is structured so that the facilitator presents functionality using slides. Where
relevant and possible, the participants then have the opportunity to complete exercises to
consolidate their learning. A training environment has been set up, allowing participants to
practice in a safe environment.
The aim of the workbook is to be a working document, reinforcing the information presented by
the facilitator. Each delegate will have a copy of this workbook, which can be taken away and
can be referred to at a later date. The workbook has not been designed to provide a detailed
guide to installing and configuring the perfSONAR services. Separate guides are however
available for this purpose.
For further information about GÉANT2 training courses, mail peter.webster@DANTE.org.uk.

Introduction
Course Objectives
By the end of this course, you will be able to:
• Describe key perfSONAR services.
• Install, configure and deploy the following perfSONAR services:
a. The Lookup Service
b. The BWCTL Measurement Point
c. The SSH / Telnet Measurement Point
d. The RRD Measurement Archive
e. The SQL Measurement Archive
• Identify how to interact with the Service Desk.

Introduction
Course Outline
• Module 1 – perfSONAR Technical Overview
• Module 2 – General Installation Prerequisites
• Module 3 - Installing and Configuring the Lookup Service
• Module 4 – Installing and Configuring the BWCTL MP
• Module 5 – Installing and Configuring the SSH / Telnet MP
• Module 6 –The Service Desk
• Module 7 – Installing and Configuring the RRD MA
• Module 8 – Carrying out an Installation on Debian
• Module 9 – Installing and Configuring the SQL MA
• Module 10 –Feedback on perfSONAR Installation and Configuration

Module 1 – perfSONAR Technical Overview

The perfSONAR Administration Guide
Notes:

What is perfSONAR?
Notes:

What are the perfSONAR Services?
Notes:

Design Objectives
Notes:

Three-Tier Architecture
Notes:

What is a Service?
Notes:

Architectural Principles
Notes:

The perfSONAR Services Framework (1)
Notes:

Notes:

The Client
Notes:

The Lookup Service
Notes:

The lookup Service (1)
Notes:

The Lookup Service (2)
Notes:

The Authentication Service
Notes:

The Authentication Service
Notes:

The Measurement Point Service
Notes:

Measurement Points
Notes:

The Measurement Archive Service
Notes:

Measurement Archives
Notes:

The Transformation Service
Notes:

The Resource Protector Service
Notes:

Notes:

Protocols
Notes:

Generic Services and Service Implementations
Notes:

Service Implementations
Notes:

Data Collection, Normalisation and Sharing via the Framework
Notes:

Framework Facilitates Normalised end-to-end Performance Data (Simplified

Depiction)
Notes:

The perfSONAR Pilot: Measurement and Archiving Services
Notes:

The perfSONAR Pilot
Notes:

The Roadmap
Notes:

Technical Overview: Summary
Notes:

The perfSONAR Services Framework - Recap
Notes:

Module 2: General Installation Considerations
Module 2: General Installation

Considerations

General Installation Prerequisites (1)
Notes:

General Installation Prerequisites (2)
Notes:

Other Installation Prerequisites
Notes:

The Role of the Administration Guide
Notes:

The Role of the Service Desk
Notes:

Installation Steps
Notes:

How Does the Bundle Installer Work?
Notes:

Configuring the Services - Stitching
Notes:

Stitching in Context (1)
Notes:

Stitching in Context (2)
Notes:

The Advantages of Stitching
Notes:

Other Considerations
Notes:

Backups
Notes:

Exercise: Installing the General Prerequisites
Installing Tomcat
) The exercise below assumes a working knowledge of the vi file editor. If you are not familiar with vi please
let your trainer know.
1. Locate the jakarta-tomcat-5.0.28.tar.gz file in your home directory on the training

server.
2. Issue the command tar –xvzf jakarta-tomcat-5.0.28.tar.gz to untar the file. The
directory jakarta-tomcat-5.0:28 will be created in your current directory.
3. Issue the command ls to check that the jakarta-tomcat-5.0.28 directory is present.
4. Issue the command cd jakarta-tomcat-5.0.28/conf to move to Tomcat’s configuration
directory.
5. Issue the command vi server.xml file to edit the server.xml file.
6. Find the Connector tag in the file (look for <Connector port=”8080”).
7. Change the default port number (8080) to the port number advised by your trainer.
) For training purposes, each participant must have a unique port.
8. Find the Server tag in the file (look for <Server port=”8005” shutdown=”SHUTDOWN”
debug=”0”).
9. Change the default port number (8005) to the port number advised by your trainer.
) For training purposes, each participant must have a unique port.
10. Press the escape key and then type in :wq to exit from the file saving your changes.
11. Issue the command cd jakarta-tomcat-5.0.28/bin to move to Tomcat’s bin directory.
12. Issue the command ./startup.sh to start the Tomcat web server.
13. Open an internet browser and navigate to the following URL:
http://srv2.ams.nl.geant2.net:xxxx replacing xxxx with your connector port number. If
you have successfully set up Tomcat a confirmation web page will be displayed.
Please make a note of the location of your Tomcat installation below and your connector port number,
as you will require these later in the course.
Tomcat location:
Connector port:

Installing Ant
1. Locate the apache-ant-1.6.5-bin.tar.gz file in your home directory on the training server.
2. Issue the command tar –xvzf apache-ant-1.6.5-bin.tar.gz to untar the file. The
directory apache-ant-1.6.5 will be created in your current directory.
3. Issue the command ls to check that the apache-ant-1.6.5 directory is present.
Please make a note of the full path to your Ant installation below, as you will require this later in the
course.
Editing Your .bash_profile File
1. Locate the apache-ant-1.6.5-bin.tar.gz file in your home directory on the training server.
2. Issue the command tar –xvzf apache-ant-1.6.5-bin.tar.gz to untar the file. The
directory apache-ant-1.6.5 will be created in your current directory.
3. Ensure that you are in your home directory.
4. Issue the command vi .bash_profile file to edit the .bash_profile file.
5. Add a new line to the .bash_profile file for your ant home. This new line should read:
ANT_HOME=xxxx where xxxx is the full path to your ant directory as noted above (e.g.
/home/ps00/apache-ant-1.6.5).
6. Add a new line to the .bash_profile file. This new line should read:
export ANT_HOME.
7. Append the location of the ant bin directory to the PATH environmental variable.
8. Press the escape key and then type in :wq to exit from the file saving your changes.
9. To check that you have successfully changed your environmental variables, exit from
your unix session and re-login in. Then issue the command ant –version. The version
of your apache ant should be returned.

Module 3: Installing and Configuring the Lookup Service
Module 3: Installing and Configuring the

Lookup Service

Notes:

Notes:

Notes:

Notes:

Lookup Messages
Notes:

Lookup Service-Specific Requirements
Notes:

Three-Stage Installation
Notes:

Hints and Tips
Notes:

Testing
Notes:

Interaction with the Service Desk (1)
Notes:

Interaction with the Service Desk (2)
Notes:

Lookup Service Installation Overview
Notes:

Exercise: Installing and Configuring the Lookup Service
Dependency Checks – are all of the Required Prerequisites Installed?
1. Log on to the training server using the credentials supplied to you by your trainer.
2. Check that Java is present on the training server by entering the following command:
which java.
3. Check the version of java that is present by entering the command java –version.
4. Find out the current value of the JAVA_HOME environmental variable by entering echo
$JAVA_HOME.
Make a note of the version of Java that is present on the training server. Refer to the perfSONAR
Administration Guide and verify that your version of Java is compatible with the Lookup Service.
Make a note of your JAVA_HOME location below as you will need this later.
5. Check that ant is present on the training server by entering the following command:
which ant.
6. Check the version of ant that is present by entering the command ant –version.
Make a note of the version of ant that is present on the training server. Refer to the perfSONAR
Administration Guide and verify that your version of ant is compatible with the Lookup Service.
7. Check whether the eXist XML database and the Tomcat application server are installed.
Make a note of the locations of the eXist XML database and the Tomcat application server below.
eXist XML database location:
Tomcat application server location:

Installing Manual Prerequisites – the eXist XML Database
Java Developers’ Kit (JDK) version 1.5 or higher and Apache Ant version 1.6.x are prerequisites
of the Lookup service that must be manually installed. However, JDK was installed on the
training server ahead of the course and you installed Apache Ant yourself during the General
Installation Considerations Module, so both of these are already taken care of. However, you
must now manually install one further prerequisite of the Lookup Service: an eXist XML
database, version 1.0.1 or version 1.1.1. In order to do this, please follow the instructions in the
Exist DB Installation Guide for LS, which has been handed out to you.
) In a live environment, you should ensure that you change your eXist database’s admin password for security
reasons. However, please do not change your amin user’s password during training.
Preparing for the Installation
During the installation process, the perfSONAR Bundle Installer will ask you a series of
interactive questions. Please read through the notes about the interactive questions in the
PerfSONAR Administration Guide and answer the questions below before carrying out the
installation.
1. Where is your Java home?
2. Where is Apache Tomcat home?
3. What port will be used by Tomcat?
4. What is the host name or domain name of the server you are installing on?
5. What is the location (the URL) of your XML database collection?

6. What is your eXist XML database user name and what is the password?
7. What is the admin password for your eXist XML database?
Carrying Out the Installation
Install the Lookup Service by following the instructions in the PerfSONAR Administration Guide
that you have been given.
Make a note below of the access point (URL) of the Lookup Service that you have just installed.
) During the installation process the perfSONAR Bundle Installer will guide you through inserting the XML tag
‘context’ and will then create a directory for you for all of the required service files. Directly after this directory is
created you must manually restart the Tomcat server. Note that the Bundle installer will not tell you that this step
is necessary.
Testing the Installation
1. Open an internet browser window and navigate to the following URL:

http://xxxx:yyyy/XML-LS-1.1/services/LookupService, substituting the DNS name of
your server for xxxx and the port number for yyyy. Verify that you see a response from
the Axis service.
2. Open the perfSONAR Visualisation Tool.
3. Move to the Playground tab and enter the access point (URL) of the Lookup Service
that you have just installed in the Service address field.
4. Return to your internet browser and navigate to the following URL:
http://anonsvn.internet2.edu/svn/perfsonar/tags/XML-LS-1.1.1/schema/example-
instances/perfSONAR/LS/test/. You should see links to eight pieces of XML displayed
at the page that you navigate to.
5. Click the EchoRequest.xml link. Copy and paste the XML that you see displayed into
the Query box of the perfSONAR Visualisation Tool.
6. Under the Execute query heading in the perfSONAR Visualisation UI click Query. A
response should be displayed.
7. Examine the response to your query and try to ascertain whether Lookup Service has
been successfully installed.

8. Repeat steps 4 to 7 for each of the following pieces of XML in sequence:

a. LSRegisterRequest.xml
b. LSQueryRequest.xml
c. LSKeepaliveRequest.xml
d. LSDeregisterRequest.xml

Module 4: Installing and Configuring the BWCTL Measurement Point

BWCTL Measurement Point

Measurement Points (1)
Notes:

Measurement Points (2)
Notes:

BWCTL MP Specifics
Notes:

The BWCTL MP: User-Advantages
Notes:

Four Stage Installation
Notes:

Installation Prerequisites
Notes:

Hints and Tips
Notes:

Testing
Notes:

Issues When Installing Under Debian
Notes:

Adding Measurements With Other Tools
Notes:

Interaction With the Service Desk
Notes:

BWCTL MP Installation Overview
Notes:

Exercise: Installing and Configuring the BWCTL MP
2. Check the versions of the BWCTL tool, iperf and perl that are present on the machine by
entering the following commands:
a. which bwctl
b. which iperf
c. which perl
Make a note of the versions of the BWCLT tool, iperf and perl below:
BWCTL tool version:
Iperf version:
Perl version:
Refer to the perfSONAR Administration Guide to confirm that these software versions are compatible
with the BWCTL MP.
installation.
1. Which UNIX user and group will be used to run the perfSONAR daemon?

Install the BWCTL Measurement Point Service by following the instructions in the PerfSONAR
Administration Guide that you have been given.
1. Run the test script called test that you will find in the installation directory in order to
confirm that your BWCTL MP has been successfully installed.

Module 5: Installing and Configuring the SSH / Telnet Measurement Point

SSH / Telnet Measurement Point

SSH / Telnet MP Specifics (1)
Notes:

SSH / Telnet MP Specifics (2)
Notes:

SSH / Telnet MP: Available Commands
Notes:

SSH / Telnet Measurement Point Use Cases
Notes:

SSH / Telnet MP Prerequisites
Notes:

Supported Network Devices
Notes:
© DANTE 2007 Page 100 of 192

Three Stage Installation
Notes:
© DANTE 2007 Page 101 of 192

Stitching
Notes:
© DANTE 2007 Page 102 of 192

An Example of Stitching
Notes:
© DANTE 2007 Page 103 of 192

Hints and Tips (1)
Notes:
© DANTE 2007 Page 104 of 192

Hints and Tips (2)
Notes:
© DANTE 2007 Page 105 of 192

Hints and Tips (3)
Notes:
© DANTE 2007 Page 106 of 192

Testing
Notes:
© DANTE 2007 Page 107 of 192

Notes:
© DANTE 2007 Page 108 of 192

Notes:
© DANTE 2007 Page 109 of 192

SSH / Telnet MP Installation Overview
Notes:
© DANTE 2007 Page 110 of 192

Exercise: Installing and Configuring the SSH / Telnet MP
In a previous exercise you noted down the versions of Java and ant present on the training server.
Now refer to the perfSONAR Administration Guide and verify that your versions of Java and ant are
compatible with the SSH / Telnet MP.
2. Check whether the Tomcat application server is installed.
From a previous exercise, you already know that the Tomcat application server is present. Now verify
that the version of Tomcat is compatible with the SSH / Telnet Measurement Point.
Installing Manual Prerequisites
Java Developers’ Kit (JDK) version 1.5 or higher and Apache Ant version 1.6.x are prerequisites
of the Lookup service that must be manually installed. However, JDK was installed on the
training server ahead of the course and you installed Apache Ant yourself during the General
Installation Considerations Module, so both of these are already taken care of.
installation.
1. Where is Apache Tomcat installed?
© DANTE 2007 Page 111 of 192

3. What is the name of and path to the sample service.configuration file that was supplied
with the installation?
4. What is the URL of the Lookup Service that you installed earlier in the course?
5. What is the IP address or DNS name of the host you are going to install the service on?
Install the SSH / Telnet MP Service by following the instructions in the PerfSONAR
is necessary.
Examining the service.properties file
The exercise above will have resulted in the creation of a service.properties file. Examine this
file to ensure that it reflects the settings you input during the configuration step of the installation
process.
Need an exercise about testing the MP.
© DANTE 2007 Page 112 of 192

Module 6: The Service Desk
© DANTE 2007 Page 113 of 192

The Role of the Service Desk
Notes:
© DANTE 2007 Page 114 of 192

The Duties of the Service Desk (1)
Notes:
© DANTE 2007 Page 115 of 192

Incident Management Example – Known Errors
Notes:
© DANTE 2007 Page 116 of 192

The Duties of the Service Desk (2)
Notes:
© DANTE 2007 Page 117 of 192

Success Factors
Notes:
© DANTE 2007 Page 118 of 192

Supported Software
Notes:
© DANTE 2007 Page 119 of 192

L2 Status
Notes:
© DANTE 2007 Page 120 of 192

Information to Provide to the ASD
Notes:
© DANTE 2007 Page 121 of 192

Contact Details
Notes:
© DANTE 2007 Page 122 of 192

Module 7: Installing and Configuring the RRD Measurement Archive

RRD Measurement Archive
© DANTE 2007 Page 123 of 192

Measurement Archives
Notes:
© DANTE 2007 Page 124 of 192

The RRD Measurement Archive (1)
Notes:
© DANTE 2007 Page 125 of 192

The RRD Measurement Archive (2)
Notes:
© DANTE 2007 Page 126 of 192

The RRD Measurement Archive in Context
Notes:
© DANTE 2007 Page 127 of 192

RRD MA Installation Overview
Notes:
© DANTE 2007 Page 128 of 192

The RRD MA: Three Stage Installation
Notes:
© DANTE 2007 Page 129 of 192

Testing
Notes:
© DANTE 2007 Page 130 of 192

Stitching for the RRD Measurement Archive
Notes:
© DANTE 2007 Page 131 of 192

RRD MA Stitching in Context
Notes:
© DANTE 2007 Page 132 of 192

The Metadata Configuration File
Notes:
© DANTE 2007 Page 133 of 192

Stitching for the RRD MA – Three Step Process
Notes:
© DANTE 2007 Page 134 of 192

Stitching for the RRD MA – Step 1
Notes:
© DANTE 2007 Page 135 of 192

Stitching for the RRD MA - Chains
Notes:
© DANTE 2007 Page 136 of 192

RRD MA Metadata Chains – Example of Metadata
Notes:
© DANTE 2007 Page 137 of 192

RRD MA Metadata Chains – Example of Data
Notes:
© DANTE 2007 Page 138 of 192

Stitching for the RRD MA: Step 2
Notes:
© DANTE 2007 Page 139 of 192

Stitching for the RRD MA: Step 3
Notes:
© DANTE 2007 Page 140 of 192

Making the Measurement Archive Available to the Visualisation Tools
Notes:
© DANTE 2007 Page 141 of 192

Notes:
© DANTE 2007 Page 142 of 192

Hints and Tips
Notes:
© DANTE 2007 Page 143 of 192

Notes:
© DANTE 2007 Page 144 of 192

Notes:
© DANTE 2007 Page 145 of 192

RRD MA Installation Overview
Notes:
© DANTE 2007 Page 146 of 192

Exercise: Installing and Configuring the RRD MA
compatible with the RRD MA.
2. Check whether RRDTool is present on the training server by entering the following
command: which rrdtool.
Is RRDTool present on the training server?
From a previous exercise, you already know that an eXist XML database and the Tomcat application
server are present. Now verify that the versions of both are compatible with the RRD Measurement
Archive.
Installing Manual Prerequisites – the RRD Tool
Java Developers’ Kit (JDK) version 1.5 and Apache Ant version 1.6.x are prerequisites of the
RRD Measurement Archive service that must be manually installed. However, JDK was
installed on the training server ahead of the course and you installed Apache Ant yourself
during the General Installation Considerations Module, so both of these are already taken care
of. RRD Tool version 1.2.x is also a prerequisite that requires manual installation. However,
RRD Tool has been installed for you on the training server, so there is no further manual
installations are required.
) Note that the RRDMA requires JDK version 1.5 and not any other version.
© DANTE 2007 Page 147 of 192

installation.
3. What type of operating system does the server use (linux, linux-64bit, freebsd, solaris,
other)?
4. What is the location of the header file of the rrdtool (rrd.h)?
5. What is the location of the library files for the rrdtool (librrd*)?
6. What is your Java ‘home’?
7. What is the user name and password for your eXist XML database?
8. What is the password of the admin user for your eXist XML database?
© DANTE 2007 Page 148 of 192

9. What is the name of and the path to the sample RRD metadata configuration file that
came with the installation?
Install the RRD Measurement Archive Service by following the instructions in the PerfSONAR
is necessary.
Before you move to the next stage (editing your metadata configuration file), use the Bundle
installer’s test facility to verify that your installation is working.
1. Use perfSONAR UI to visualize the data that YOUR installation of RRD MA is exporting
2. Open a web browser and point it to http://perfSONAR.acad.bg. Click on perfSONAR UI

webstart
3. In the left menu bar, click Service Addresses.
4. In the new window, click Unselect all to unselect all the checkboxes.
5. After unselecting, click New. Scroll down to see the newly added entry.
6. Click anywhere inside the newly Added entry (except the checkbox).
7. Click inside the URL field. Enter the URL for your recently installed RRD MA Service.
8. Inside the Name field, enter any name of your choice.
9. In the Schema dropbox, choose http://schemas.perfsonar.net/2.0.
10. In the Event Type (in) and Event Type (out) fields, type the following:
http://ggf.org/ns/nmwg/characteristic/utilization/2.0
11. Now, to apply these changes, unselect the checkbox for your new entry.
12. You should now see all your changes for the new entry. Yell for help if you don’t.
© DANTE 2007 Page 149 of 192
13. Select the checkbox for your new entry and click OK.
14. In the main window, in the left menu bar, click Retrieve All to see all the values that your
RRD MA can export.
Stitching – Editing the RRD Metadata Configuration File
1. Login to your eXist database with the username and password that you provided during the
installation of the service
2. Locate and open the rrd-database_TEST.xml file.
3. Save the rrd-database_TEST.xml file on your local desktop.
4. Refer to the Metadata Configuration File guide and examine the rrd-database_TEST.xml
file to understand its structure.
5. Edit your local version of the rrd-database_TEST.xml file and change the following fields:
Metadata element with id = meta1
Field Existing Value New Value
Host Name Test-hostName Any Value of your choice (ex:

router.mynetwork.net)
IPV4 interface address 10.1.2.3 Any IPv4 address (ex:

(ifAddress) 193.63.33.2
Interface name (ifName) Test-0 Any name of your choice
Direction in in
authRealm TestRealm Your network domain name
Data element referring to the previous metadata element (meta1). Check for
metadataIdRef. Replace psXX below with your home directory (location of rrd files)
file /home/psxx/perfSONAR-RRD- /home/psxx/data/ rrd-trial-

MA- 1.rrd
2.2/perfsonar/data/rrd/test/test.rrd
Datasource bytes ds0
© DANTE 2007 Page 150 of 192

Metadata element with id = meta2
Host Name Test-hostname Same value as meta1
IPV4 interface address 10.1.2.3 Same value as meta1

(ifAddress)
Interface name (ifName) Test-0 Same name as meta1
Direction out out
authRealm TestRealm Your network domain name
Data element referring to the previous metadata element (meta2). Check for
metadataIdRef. Replace psXX below with your home directory (location of rrd files)
file /home/psxx/perfSONAR-RRD- /home/psxx/data/ rrd-trial-

MA- 1.rrd
2.2/perfsonar/data/rrd/test/test.rrd
Datasource Pkts ds1
6. Save your local version of the rrd-database_TEST.xml file to your desktop.

7. Use the eXist administration console to upload the edited rrd-database_TEST.xml file to
your eXist database.
Testing the Results of Stitching
If you haven’t closed the perfSONAR UI window after doing the tests (just before testing), you
can simply click Clear in the left menu bar and then click Retrieve All.
If you closed perfSONAR UI before doing the stitching, follow instructions given in the previous
Testing the Installation section before the section on Stitching above.
© DANTE 2007 Page 151 of 192

Module 8: Carrying out an Installation on Debian
Module 8: Carrying out an Installation on

Debian
© DANTE 2007 Page 152 of 192

Overview of Debian
Notes:
© DANTE 2007 Page 153 of 192

RRD MA Installation: Debian Base Installation
Notes:
© DANTE 2007 Page 154 of 192

Reminder: APT, DPKG, Locate are all Friends
Notes:
© DANTE 2007 Page 155 of 192

perfSONAR Bundle Installer / RRD MA Dependencies
Notes:
© DANTE 2007 Page 156 of 192

Tomcat
Notes:
© DANTE 2007 Page 157 of 192

Potential Issues
Notes:
© DANTE 2007 Page 158 of 192

Final Touch
Notes:
© DANTE 2007 Page 159 of 192

Last but not Least…. Security
Notes:
© DANTE 2007 Page 160 of 192

Module 9: Installing and Configuring the SQL Measurement Archive

SQL Measurement Archive
© DANTE 2007 Page 161 of 192

The SQL Measurement Archive (1)
Notes:
© DANTE 2007 Page 162 of 192

The SQL Measurement Archive (2)
Notes:
© DANTE 2007 Page 163 of 192

Stitching for the SQL Measurement Archive
Notes:
© DANTE 2007 Page 164 of 192

SQL MA Stitching in Context
Notes:
© DANTE 2007 Page 165 of 192

The Metadata Configuration File
Notes:
© DANTE 2007 Page 166 of 192

Stitching for the SQL MA – Three Step Process
Notes:
© DANTE 2007 Page 167 of 192

Stitching for the SQL MA – Step 1
Notes:
© DANTE 2007 Page 168 of 192

SQL MA Architecture
Notes:
© DANTE 2007 Page 169 of 192

Understanding the Path Status Metadata
Notes:
© DANTE 2007 Page 170 of 192

Link Metadata and Node Metadata
Notes:
© DANTE 2007 Page 171 of 192

Stitching – Metadata for Nodes and Links
Notes:
© DANTE 2007 Page 172 of 192

Stitching – Path Status Chains
Notes:
© DANTE 2007 Page 173 of 192

Simplified Link Path Metadata Example
Notes:
© DANTE 2007 Page 174 of 192

Node Metadata Example
Notes:
© DANTE 2007 Page 175 of 192

Link Chains – an Example
Notes:
© DANTE 2007 Page 176 of 192

Link Chain Data – an Example
Notes:
© DANTE 2007 Page 177 of 192

SQL MA Architecture
Notes:
© DANTE 2007 Page 178 of 192

Stitching for the SQL MA – Interface Utilisation Chains
Notes:
© DANTE 2007 Page 179 of 192

Stitching for the SQL MA: Step 2
Notes:
© DANTE 2007 Page 180 of 192

Stitching for the SQL MA: Step 3
Notes:
© DANTE 2007 Page 181 of 192

Three Stage Installation of the SQL MA
Notes:
© DANTE 2007 Page 182 of 192

Making the Measurement Archive Available to the Visualisation Tools
Notes:
© DANTE 2007 Page 183 of 192

Testing
Notes:
© DANTE 2007 Page 184 of 192

Notes:
© DANTE 2007 Page 185 of 192

Hints and Tips
Notes:
© DANTE 2007 Page 186 of 192

Notes:
© DANTE 2007 Page 187 of 192

SQL MA Installation Overview
Notes:
© DANTE 2007 Page 188 of 192

Exercise: Installing and Configuring the SQL MA
compatible with the SQL MA.
2. Check whether a mySQL database is present on the training server.
Is a mySQL database present on the training server?
From a previous exercise, you already know that an eXist XML database and the Tomcat application
server are present. Now verify that the versions of both are compatible with the RRD Measurement
Archive.
) Note that, although it will not be used in training, you can use the PostgreSQL relational database (version
8.x) as an alternative to the MySQL relational database.
installation.
© DANTE 2007 Page 189 of 192

3. What is your eXist XML database user name and what is the password?
4. What is the password for the eXist XML database amin user?
5. What is the path of your sql metadata configuration file?
6. What is the set of JDBC (Java Database Connectivity) parameters (database URL, user
name, user password) of your MySQL database?
8. What is the IP or DNS address of the host on which you are going to deploy the
service?
Install the SQL Measurement Archive Service by following the instructions in the PerfSONAR
is necessary.
© DANTE 2007 Page 190 of 192

Testing the installation
1. The bundle installer will ask you if you want to test the service. Select yes.
2. The bundle installer will send a series of xml based requests and record the responses.
3. It will give you the location of these xml responses.
4. Examine the responses (>cat $filename) to check for any errors.
Stitching – Editing the SQL MA Metadata Configuration File
This section requires re-developing…

1. Login to your eXist database with the username and password provided to you by your
trainer.
2. Locate and open the sql-database_TEST.xml file.
3. Save the sql-database_TEST.xml file on your local desktop.
4. Refer to the Metadata Configuration File guide and examine the sql-
database_TEST.xml file to understand its structure.
5. Edit your local version of the sql-database_TEST.xml file and change the following
fields:
Element Existing Value New Value
Node id=”DFN-LRZ” City XYZ
Institution Institution XYZ
Metadata id=”md-link-LRZ- Type REN_XYZ_Link

SARA-DEISA-001”
6. Save your local version of the sql-database_TEST.xml file to your desktop.

7. Use the eXist administration console to upload the edited sql-database_TEST.xml file
to your eXist database.
Testing the results of Stitching
1. Use the Bundle installer to test the service again (modify option in the main menu).
2. After all the tests are run, look for the results of the test run-sqlma-client-data-
L2status-6. This request fetches all data / metadata for L2 path status metrics. The
response file should contain metadata, including metadata with updated values.
3. Confirm that the results of the file show the modified metadata as well as status
information.
© DANTE 2007 Page 191 of 192

© DANTE 2007 Page 192 of 192

Workbookinstalaçaoperfsonarpic SL 1.3

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Workbookinstalaçaoperfsonarpic SL 1.3

Uploaded by

Copyright:

Available Formats

Installing and Configuring the perfSONAR

All trademarks are acknowledged.

All names and other data used in examples are fictitious.

Table of Contents .................................................................................................. 3

Table of Slides ....................................................................................................... 4

Aim of the Workbook .................................................................................... 10

Course Objectives ........................................................................................ 11

Course Outline ............................................................................................. 12

Module 1 – perfSONAR Technical Overview ...................................................... 13

Module 2: General Installation Considerations.................................................... 46

Module 3: Installing and Configuring the Lookup Service ................................... 62

Module 4: Installing and Configuring the BWCTL Measurement Point ............... 79

Module 6: The Service Desk.............................................................................. 113

Module 8: Carrying out an Installation on Debian.............................................. 152

© DANTE 2007 Page 3 of 192

Page 8 of 192 © DANTE 2007

© DANTE 2007 Page 9 of 192

Aim of the Workbook

For further information about GÉANT2 training courses, mail peter.webster@DANTE.org.uk.

Page 10 of 192 © DANTE 2007

By the end of this course, you will be able to:

• Describe key perfSONAR services.

• Install, configure and deploy the following perfSONAR services:

a. The Lookup Service

b. The BWCTL Measurement Point

c. The SSH / Telnet Measurement Point

d. The RRD Measurement Archive

e. The SQL Measurement Archive

• Identify how to interact with the Service Desk.

© DANTE 2007 Page 11 of 192

• Module 1 – perfSONAR Technical Overview

• Module 2 – General Installation Prerequisites

• Module 3 - Installing and Configuring the Lookup Service

• Module 4 – Installing and Configuring the BWCTL MP

• Module 5 – Installing and Configuring the SSH / Telnet MP

• Module 6 –The Service Desk

• Module 7 – Installing and Configuring the RRD MA

• Module 8 – Carrying out an Installation on Debian

• Module 9 – Installing and Configuring the SQL MA

• Module 10 –Feedback on perfSONAR Installation and Configuration

Page 12 of 192 © DANTE 2007

Module 1 – perfSONAR Technical Overview

© DANTE 2007 Page 13 of 192

The perfSONAR Administration Guide

Page 14 of 192 © DANTE 2007

© DANTE 2007 Page 15 of 192

What are the perfSONAR Services?

Page 16 of 192 © DANTE 2007

© DANTE 2007 Page 17 of 192

Page 18 of 192 © DANTE 2007

© DANTE 2007 Page 19 of 192

Page 20 of 192 © DANTE 2007

The perfSONAR Services Framework (1)

© DANTE 2007 Page 21 of 192

The perfSONAR Services Framework (2)

Page 22 of 192 © DANTE 2007

© DANTE 2007 Page 23 of 192

The Lookup Service

Page 24 of 192 © DANTE 2007

The lookup Service (1)

© DANTE 2007 Page 25 of 192

The Lookup Service (2)