PlanetLab Developer's Guide

This is an area used by  PlanetLab developers to track code changes, define and track milestones, document Modules, and browse source.

Users interested in participating in the development process are also encouraged to join the  developer's mailing list.

To contribute to PlanetLab, download the MyPLC software package, modify the source code in whatever way interests you, and test your fixes and enhancements on a "private PlanetLab" that runs on your own hardware.

SFA User-level documentation

• SFA Tutorial (operator oriented)
• SFA Advanced User and Developer Step-By-Step Tutorial (developer oriented)
• SFA User's Guide (end-user oriented)
• Sface GUI Users Guide (end-user oriented)
• SFA FAQ (end-user oriented)

MyPLC User-level documentation

• MyPLC Users Guide
•  Documentation on Planetflow2
•  Documentation on Vsys
•  Documentation on VNET+
• Tun/tap on PlanetLab
• Reserving Ports on PlanetLab
• Fuse on PlanetLab
• Openflow on PlanetLab
• Choosing a Linux distribution for your PlanetLab slice
• Google App Engine on PlanetLab and VICCI
• DC7900 Donation Directions
• Step-by-step directions to deploy a slice visualized with google earth
• Deployscript - Experiment deployment utility

Downloading the Software

Prebuilt yum repos

•  Daily build of MyPLC including the latest stable build of  MyPLC
•  OneLab builds including  the stable OneLab builds for 4.3 and  5.0
• NOTE: as a convenience for system tests, MyPLC and SFA are built together and exposed in a unique yum repository. However, please note that the release paces for the 2 sofware suites have become very different, and for this reason it is recommended, if you plan on deploying MyPLC and SFA, that you define 2 separate yum.repos.d entries, as explained in SFATutorialInstall#FedoraRPMInstallation

Source code

• NOTE: most of the modules have moved from svn to git. Try out git first
• 2 git repositories are available via gitweb at either  PlanetLab Central or  PlanetLab Europe (OneLab); these are mirrored and should expose identical contents
• the historical svn rpo is browsable at  Direct access via SVN

Changelogs

• See ChangeLogV522 for the latest release notes on 5.0; for older releases you can also refer to ChangeLog page for more migration notes.

Development Conventions & Processes

• Notes on using SVN
• Notes on using git
• Tools used for managing modules and versions
• QA Procedures?
• How to contribute patches?
• Notes on development for libvirt/lxc managed nodes
• port forwarding on lxc containers

Federation / Slice Facility Architecture (SFA)

• Upgrading to SFA 1.0-35
•  Slice-based Facility Architecture (SFA)
•  SFA Implementation Notes
•  Establishing Resource Allocation Policies in Federated Systems (aka sfa_tables)
• SFA Registry Interface
• SFA Slice Interface
• SFI Guide
• SFA Tutorial
• SFA FAQ
• Adding a New Aggregate to the SFA
• Federation Workshop

Operations & Support Hints

• PlanetLabPackageDeployment
• Running the nightly builds to build a full PlanetLab distribution
• Setup a new RT Queue
• Allocating a vsys attribute to a slice?
• Read-only-fs bug on PL
• Intermittent bugs that don't have corresponding tickets
• Documentation on Vsys scripts
• Howto tweak the slice creation delay

IT Infrastructure Behind PLC

• Managing SVN
• Building Vservers
• Updating PLC Servers
• Recipe for restarting critical services
• Physical Servers
• pl-virtual-xx address assignments
• pl-service-xx address assignments
• pl-subnet address assignments
• old hostnames
• Test harnesses
• Managing SSL Certificates
• Infrastructure Matrix
• Configuration Management
• Meta PLC Notes

Recent Changes

For a complete list of local wiki pages, see TitleIndex.