= LAMP I&M System: Tutorial =

Welcome to the LAMP I&M System tutorial. This tutorial will take you through the steps in creating a [https://www.protogeni.net/trac/protogeni/ ProtoGENI] slice with Instrumentation & Measurement (I&M) capabilities based on the [http://www.perfsonar.net/ perfSONAR framework] and the [http://psps.perfsonar.net/ perfSONAR-PS software suite]. This tutorial and the full documentation for the LAMP I&M System is still under development, but we have made a [wiki:LAMP/Tutorial#QuickStart Quick Start Guide] to get you started right away. Please feel free to contact us with questions or any type of feedback at lamp@damsl.cis.udel.edu.

== Getting Ready ==

The LAMP I&M System is currently tailored to characteristics of the ProtoGENI Control Framework. The LAMP I&M System is also limited to the UBUNTU91-LAMP disk image that can be found on Utah's (Emulab.net) ProtoGENI testbed. We intend to create software packages and instructions for customizing existing or new images with the LAMP software. In the meantime, the following steps must be taken prior to testing our system:

- Get a ProtoGENI account and familiarize yourself with using ProtoGENI. The [http://www.protogeni.net/trac/protogeni/wiki/Tutorial ProtoGENI tutorial] is a great resource for this. Make sure you follow the instructions to get your SSH Keys set up.

- Download the ProtoGENI test scripts. We will use these to create and start our slice.

- Download the following LAMP scripts: [http://groups.geni.net/geni/attachment/wiki/LAMP/Tutorial/lamp-getcertificate.py lamp-getcertificate.py] and [http://groups.geni.net/geni/attachment/wiki/LAMP/Tutorial/lamp-sendmanifest.py lamp-sendmanifest.py]. These scripts will be used to help setup your LAMP-enabled slice. You can place them on the same directory as the test scripts.


== Quick Start ==

This section will guide you through creating and starting a slice, requesting a LAMP services certificate for you slice, uploading your experiment's topology to [http://groups.geni.net/geni/wiki/LAMP/Glossary#UNIS UNIS], and setting up the instrumentation and measurement of your slice.

=== Few words on the LAMP I&M System design ===

It is useful to understand the general principles behind the steps we will take throughout this tutorial. The LAMP I&M System is built on top of three pillars: 

- LAMP Portal: The LAMP Portal is the goto resource for experimenters to manage and visualize their I&M services and data. The portal is deployed with the LAMP image and will usually be enabled through the initial RSpec configuration for the experiment. The portal can run on any node or (nodes) within the slice. The LAMP Portal is derived from the Web Admin component of the pS-Performance Toolkit 3.2 RC1 (although not required, looking at the [http://code.google.com/p/perfsonar-ps/wiki/pSPerformanceToolkit31 comprehensive Quick Start guide] of the pS Toolkit can be very useful to understand the LAMP I&M System setup).

- UNIS and Topology-based Configuration: xxxxxxx

- perfSONAR-PS software suite: xxxxx


All the services on the LAMP I&M System have Authentication and Authorization (AA) capabilities based on the ProtoGENI AA model. See our [http://groups.geni.net/geni/wiki/LAMP/AA AA page] for more information.