WiMAX Tutorial

Prerequisites

This tutorial series assumes you have an ​ORBIT account, have ​scheduled a session on the ORBIT test bed, are familiar with ​SSH'ing ​into the test bed itself, and are familiar with the basics of running ORBIT experiments. If you have not done these things yet, you may wish to do so before taking a look at this slightly more advanced experiment. If you are unfamiliar with or are entirely new to ORBIT, you may wish to start ​here.

---

Getting Started

First, SSH into the test bed you plan on using for the experiment. For this experiment, we use ORBIT's Sandbox 4.

ssh <your_username>@console.sb4.orbit-lab.org

About the Base Station

WiMAX (related to and derived from WiFi) works by sending all data traffic through an ​Access Point called a Base Station. This is similar to how a cell phone connects to a cell tower. In fact, at one point WiMAX was used to provide mobile internet connectivity to cell phones! However, the WiMAX base station at WINLAB is special in that its operation settings can be changed to meet the needs of an experiment. This is good, because it permits tweaking of settings to conduct research. However, it also means that latest person to run experiments may have left the base station with settings that will make conducting experiments difficult. First, tell the base station to use default settings, and then reset it.

Interacting with the Base Station

The base station receives instructions from ​http get requests sent from the corresponding sandbox. For example, consider

wget -qO- http://cons-wm-01:5052/wimaxrf/datapath/config/load?name=defaults

"wget" is the command to send an http request; "-qO-" gives options for outputting the result of the request to the screen; "cons-wm-01" is the name of the base station; "5052" is the port number; "/wimaxrf/datapath/config/load" selects the subsetting "load" from the path; "?" demarcates instructions; "name=defaults" assigns "defaults" to the property "name".

Restoring the Base Station to Defaults

To restore the base station to defaults, run the following commands:

wget -qO- http://cons-wm-01:5052/wimaxrf/defaults
wget http://cons-wm-01:5052/wimaxrf/restart

After issuing the restart command, the base station will be unavailable for 2 minutes.

---