The R2lab Tutorials
Let's get you started
All this contents is accessible through the TUTORIALS INDEX dropdown that appears on the upper right end of the navbar, in all tutorial pages.
Sign up for a R2lab account
- All information about how to register and schedule a node
Shell tools available in the R2lab gateway
- Discover how to do basic control of the nodes by logging in at the
faraday.inria.frgateway from a regular
- how to check for the nodes status, leases, images, and phones even.
Examples of experimentation scripts with
nepi-ng : install
- How to install
nepi-ngon your laptop
nepi-ng : the basics - a.k.a. the A series
- A couple examples to get started with the
- A1 : simplest way to run a simple ping from
- A2 : same functions, but can pass a slice name on the command line
- A3 : run the ping from a node instead of from the gateway
- A4 : check for a valid reservation
- A5 : run ping between two nodes inside the chamber, on the wired network
nepi-ng : wireless - a.k.a. the B series
- A few more pings to see how one can initialize and configure wireless links
- B1 : like A5, but on a wireless ad hoc network
- B2 : same scenario, simplified by using
- B3 : same scenario, but extract all the shell code in a single external file
- B4 : add an infinite loop that prints out TICK every second
- B5 : same but using a Watch instance for showing elapsed time instead
nepi-ng : file exchange - a.k.a. the C series; a full loop doing file transfers, i.e.:
- A set of examples that deal with file transfers, using SFTP to and from the nodes; and that show an example of file transfer between two nodes
- C1 : a random file is produced locally, and pushed on one node,
- C2 : then transferred to a second node using netcat over the wired network,
- C3 : and retrieved back on the local laptop where it is compared with the original;
- C3bis : a variant on C2, that deals with a service that is started and stopped in sync with another job.
nepi-ng : preparation - a.k.a. the D series;
- A set of examples that deal with preparing the testbed from a
- D1 : adding a command-line option to load images,
- D2 : turning off unused nodes while loading images,
- D3 : passing chosen nodes on the command line,
- D4 : using a nested scheduler, for more modular scripts.
nepi-ng : troubleshooting guidelines
- COMMON_MISTAKES how to check for common mistakes
- CODE_UPDATE how to check your software environment
- VERBOSITY how to enable more verbosity
nepi-ng: real scale examples
- MULTI_PING : dealing with any number of nodes, run pings between all couples of nodes.
R2lab and OpenAirInterface
- Some indications on the features present on R2lab to deploy experiments based on OpenAirInterface.
Video tutorials on YouTube
- End-to-End Experiment : Running a wireless experiment end-to-end.
- OAI 5G experiment : Setting up an OpenAirInterface-based 5G infrastructure, and a tour in the chamber using Skype on a commercial android phone.
If you have any issue with this tutorial, or with using R2lab more generally, please contact us at firstname.lastname@example.org
You can subscribe to that
fit-r2lab-users discussion list by sending
an email to
subscribe fit-r2lab-users in the
body of the message.
You can do this by simply clicking this link
We use the
#r2lab channel on freenode; also once you are logged into
the website, in the RUN page, you will find on top of the page a
button that will let you join this chat room in a single click.