1.3 GENI WiMAX Site Operations Resources

1.3.1 GENI WiMAX Operations Objectives

1) Each GENI WiMAX site must operate in accordance with their FCC Experimental License and/or agreement with Clearwire, to avoid interference with others (particularly Clearwire) operating in the BRS/EBS spectrum.

2) Each GENI WiMAX site must cooperate with others (particularly Clearwire) if interference is suspected, to resolve the issue. This may involve temporarily going off-the-air, to see if they are or are not the source of the observed interference.

3) Each GENI WiMAX site must verify and maintain the accuracy of the information in the tables listed below, and follow the operations procedures listed below. It is essential that each site have a responsive local "Ops" contact, as listed in the table below.

3a) Task: All entries in tables below must be verified by 12/15/12.

4) Each GENI WiMAX site must install the site monitoring software, included in the latest WiMAX RF AggMgr, so that they are automatically forwarding operating paramaters to the OML Server at Rutgers WINLAB, who will then use the data to populate the ​GENI WiMAX Monitoring site.

4a) Task: Rutgers WINLAB must provide the new latest WiMAX RF AggMgr, that automatically forwards operating parameters to the OML Server at Rutgers WINLAB, by 1/15/13.
4b) Task: All sites must install the new latest WiMAX RF AggMgr, and commence forwarding operating parameters to the OML Server at Rutgers WINLAB, by 2/15/13.

5) Each GENI WiMAX site is expected to make their resources available to GENI experimenters.

1.3.2 GENI WiMAX Operations Procedures

(to be filled in)

1.3.3 GENI WiMAX Operations Contacts

GENI WiMAX operations mailing list:

mail to all site contacts and operations contacts
​subscribe
​mailman archive

GENI WiMAX Operations Contacts:

Index	Organizations	Contacts	Comments	Last Verified
1.1	Rutgers WINLAB	Ivan Seskar	-
1.2	Rutgers WINLAB		-
1.3	Rutgers WINLAB		-
1.4	Rutgers WINLAB		-
2.1	GPO (at BBN Technologies)	Manu Gosain	-
2.2	GPO (at BBN Technologies)	Harry Mussman	-
2.3	GPO (at BBN Technologies)		-
2.4	GPO (at BBN Technologies)		-
3.1	GMOC (at IU)		-
3.2	GMOC (at IU)		-
3.3	GMOC (at IU)		-
3.4	GMOC (at IU)		-
4.1	Clearwire	Paul McCarthy	-
4.2	Clearwire	​Don White	-
4.3	Clearwire	​Josh LaVerne	-
4.4	Clearwire		-

1.3.4 GENI WiMAX Site Monitoring

Each GENI WiMAX site forwrds operating paramaters to an OML Server at Rutgers WINLAB, which uses the data to populate the:

​GENI WiMAX Monitoring site.

1.3.5 GENI WiMAX Sites and Contacts

Index	Campus	Location	CW Table	CW Srvc	CW Agree	FCC Exp Lic	Type	Lower Freq (MHz)	Upper Freq (MHz)	Status	Contacts	Comments	Last Verified
0a	Rutgers WINLAB	Piscataway (MIDDLESEX), NJ; NL 40-31-17; WL 74-27-40; xxdeg azim; yyft height	-	Yes	-	​WE2XWE; thru 12/5/13	NEC	2585	2595	On-the-air	Ops:ORBIT Admin; PI:​Ivan Seskar	At WINLAB	6/20/13
0b	-	Piscataway (MIDDLESEX), NJ; NL 40-31-17; WL 74-27-40	-	-	-	-	NEC	2585	2595	Non-radiating testbed ​sanbox4	-	At WINLAB	6/20/13
0c	-	North Brunswick (MIDDLESEX), NJ; NL 40-28-05; WL 74-26-44; xxdeg azim; yyft height	-	Yes	-	​WE2XWE; thru 12/5/13	Airspan	2605	2615	On-the-air	-	On Busch Campus	6/20/13
2a	Raytheon BBN Tech	Cambridge (MIDDLESEX), MA; NL 42-23-18; WL 71-08-57; xxdeg azim; yyft height	-	Yes	-	​WF2XHS; thru 3/26/14	-	2512.5	2517.5	Not in use (per CW request)	Ops:Manu Gosain; PI:Manu Gosain		6/14/2013
2b	-	Cambridge (MIDDLESEX), MA; NL 42-23-18; WL 71-08-57; xxdeg azim; yyft height	-	Yes	-	​WF2XHD; thru 2/24/14	-	2585	2595	Not in use (per CW request)	-
2c	-	Cambridge (MIDDLESEX), MA; NL 42-23-18; WL 71-08-57; xxdeg azim; yyft height	-	Yes	-	​WG2XJH; thru 9/19/15	NEC alternating Airspan	2573	2583	On-the-air (freq per CW suggest)	-		6/14/2013
4a	NYU Poly	Brooklyn, NY; NEC - NL 40-41-40.25; WL 73-59-9.5; 187 xxdeg azim; 60 yyft height from ground level; Airspan - NL 40-41-41; WL 73-59-09; 277 xxdeg azim; 60 yyft height from ground level;	Yes	Yes	-	​WF2XJM; thru 4/1/14	NEC or Airspan	2590	2600	On-the-air	Ops:Fraida Fund; PI:Thanasis Korakis
4b	-	Brooklyn, NY; NL 40-41-41; WL 73-59-09; xxdeg azim; yyft height; NL 40-41-39; WL 73-59-10; xxdeg azim; yyft height	Yes	Yes	-	​WF2XJM; thru 4/1/14		2610	2620	Not in use (per CW request)	-
4c	-	Brooklyn, NY; NL 40-41-41; WL 73-59-09; xxdeg azim; yyft height; NL 40-41-39; WL 73-59-10; xxdeg azim; yyft height	Yes	Yes	-	​WF2XKY; thru 6/1/14		2535	2540	Not in use (per CW request)	-
5	UMass Amherst	Amherst (HAMPSHIRE); MA - NL 42-23-37; WL 72-31-55; xxdeg azim; yyft height	Yes	Yes	-	​WF2XGQ; thru 3/1/13	NEC	2590	2600	On-the-air	Ops:Cong Wang; PI:Mike Zink		3/3/2013
6	Columbia Univ	New York (Manhattan), NY; NL 40-48-34; WL 73-57-36; 270° azim; 170ft height (16th floor)	Yes	Yes	-	​WF2XIU; thru 4/1/13	NEC	2590	2596	On-the-air	Ops:Jan Janak; PI:Henning Schulzrinne		3/3/2013
7	Univ Colorado, Boulder	Boulder (BOULDER), CO; NL 39-59-53; WL 105-15-07; xxdeg azim; yyft height; NL 40-00-24; WL 105-16-17; xxdeg azim; yyft height; NL 40-00-26; WL 105-15-47; xxdeg azim; yyft height; NL 40-00-29; WL 105-16-04; xxdeg azim; yyft height	-	?	-	​WF2XJV; thru 5/1/14	NEC	2572	2584	On-the-air	Ops:; PI:Dirk Grunwald
8a	Univ Wisconsin, Madison	Madison (DANE), WI; NL 43-04-17; WL 89-24-24; xxdeg azim; yyft height	-	Yes	-	​WF2XXF; thru 3/30/13	Cisco	2584.5	2589.5	On-the-air	Ops:Derek Meyer; PI:Suman Banerjee		5/28/2013
8b	-	Madison (DANE), WI; NL 43-04-31; WL 89-24-24; xxdeg azim; yyft height	-	Yes	-	​WF2XXF; thru 3/30/13	NEC	2544.5	2554.5	On-the-air	-		5/28/2013
8c	-	Madison (DANE), WI; NL 43-04-34; WL 89-25-34; xxdeg azim; yyft height	-	Yes	-	​WF2XXF; thru 3/30/13	Airspan	2585.5	2595.5	On-the-air	-		5/28/2013
8d	-	Kemp Station (VILAS); WI - NL 45-50-22; WL 89-40-33; xxdeg azim; yyft height	-	Yes	-	​WF2XXF; thru 3/30/13	NEC	2544.5	2554.5	On-the-air	-		5/28/2013
8e	-	Madison (DANE), WI; NL 43-07-30; WL 89-38-20; xxdeg azim; yyft height	-	Yes	-	​WF2XXF; thru 3/30/13	Airspan	2568	2578	On-the-air	-		5/28/2013
9a	UCLA	Los Angeles (LOS ANGELES), CA; NL 34-04-09; WL 118-26-36; xxdeg azim; 80ft height	-	Yes	-	​WF2XLG; thru 6/1/14	NEC	2567	2577	On-the-air	Ops: Davide Pesavento; PI: Giovanni Pau		7/1/2013
9b	-	Los Angeles (LOS ANGELES), CA; NL 34-04-09; WL 118-26-36; xxdeg azim; yyft height	-	Yes	-	​WF2XLG; thur 6/1/14	Airspan	2585	2595	Not yet deployed	-		7/1/2013
10a	Clemson Univ	Greenville (GREENVILLE), SC; NL 34-49-31; WL 82-18-26; 20deg azim; <6ft height	-	Yes	Yes; thru 3/1/15	​WG2XCG; thru 2/10/14	Airspan	2502	2535	On-the-air	Ops:Fan Yang; PI:K-C Wang		4/20/2013
10b	-	Greenville (GREENVILLE), SC; NL 34-49-31; WL 82-18-26; 200deg azim; <6ft height	-	Yes	Yes; thru 3/1/15	​WG2XCG; thru 2/10/14	Airspan	2502	2535	On-the-air	-		4/20/2013
10c	-	Greenville (GREENVILLE), SC; NL 34-48-50; WL 82-19-38; 50deg azim; <6ft height	-	Yes	Yes; thru 3/1/15	​WG2XCG; thru 2/10/14	Airspan	2502	2535	On-the-air	-		4/20/2013
10d	-	Greenville (GREENVILLE), SC; NL 34-48-50; WL 82-19-38; 250deg azim; <6ft height	-	Yes	Yes; thru 3/1/15	​WG2XCG; thru 2/10/14	Airspan	2502	2535	Not-in-use	-
10e	-	Clemson (PICKENS), SC; NL 34-40-37; WL 82-50-1; 50deg azim; <6ft height	-	Yes	Yes; thru 3/1/15	​WG2XCG; thru 2/10/14	Airspan	2502	2535	Not-in-use	-
10f	-	Clemson (PICKENS), SC; NL 34-40-37; WL 82-50-1; 250deg azim; <6ft height	-	Yes	Yes; thru 3/1/15	​WG2XCG; thru 2/10/14	Airspan	2502	2535	Not-in-use	-
10g	-	Clemson (PICKENS), SC; NL 34-40-31; WL 82-50-21; 50deg azim; <6ft height	-	Yes	Yes; thru 3/1/15	​WG2XCG; thru 2/10/14	Airspan	2502	2535	Not-in-use	-
10h	-	Clemson (PICKENS), SC; NL 34-40-31; WL 82-50-21; 250deg azim; <6ft height	-	Yes	Yes; thru 3/1/15	​WG2XCG; thru 2/10/14	Airspan	2502	2535	Not-in-use	-
11a	Wayne State Univ	Detroit, MI; Lat 42.357500; Long -83.065000; 270deg azim; 207ft height	Yes	Yes	Yes	-	Airspan	2591	2601	On-the-air	Ops:​mailto; PI:Hongwei Zhang		4/10/2013
11b	-	Detroit, MI; Lat 42.357500; Long -83.065000; 30deg azim; 202ft height	Yes	Yes	Yes	-	Airspan	2591	2601	On-the-air	-		4/10/2013
11c	-	Detroit, MI; Lat 42.357500; Long -83.065000; 150deg azim; 202ft height	Yes	Yes	Yes	-	Airspan	2591	2601	Not yet deployed	-
12	Univ Michigan	Ann Arbor, MI; NL 42-17-31.9992; WL 83-42-52.9986; xxdeg azim; yyft height	Yes	Yes	Yes; thru 2/18/13	-	Airspan	2502	2512	On-the-air	Ops:​mailto;PI:Morley Mao		6/1/2013
13a	Temple Univ	Philadelphia, PA; NL 39-57-35; WL 75-11-26 (39.98038, -75.15703); xxdeg azim; yyft height	Yes	Yes	Yes; thru 1/31/13	-	Airspan	2585	2595	Deployed (Not-On-the-air)	Ops:;PI:Shan Lin	Freq shared with Drexel	6/20/2013
13b	-	Philadelphia, PA; NL 39-57-35; WL 75-11-26 (39.98038, -75.15703); xxdeg azim; yyft height	Yes	Yes	Yes; thru 1/31/13	-	Airspan	2603	2613	Not yet deployed	-	Freq shared with Drexel
14a	Drexel Univ	Philadelphia (PHILADELPHIA),PA; NL 39-57-35; WL 75-11-26; xxdeg azim; yyft height	Yes	Yes	Yes; thru 1/31/13	​WG2XBX; thru 2/13/14	Airspan	2585	2595	Not yet deployed	Ops:Kevin Wanuga; PI:Kapil Dandekar	Freq shared with Temple
14b	-	Philadelphia (PHILADELPHIA),PA; NL 39-57-35; WL 75-11-26; xxdeg azim; yyft height	Yes	Yes	Yes; thru 1/31/13	​WG2XBX; thru 2/13/14	Airspan	2603	2613	Not yet deployed	-	Freq shared with Temple

​definition of azimuth

1.3.6 GENI WiMAX Site Experimenter Login Interfaces

Several GENI WiMAX sites support interfaces that allow an Experimenter to login, reserve resources, and then conduct experiments utilizing resources available at that site. See the following table for details.

This login approach follows the method supported by the ORBIT testbed, although the exact login process varies as noted.

Index	Campus	Available?	url	Comments
0	Rutgers WINLAB	Yes	?	-
1	NECLabs	NA	-	-
2	Raytheon BBN Tech	Pending	-	-
3	Stanford	NA	-	-
4	Poly	Yes	?	-
5	UMass	No	-	-
6	Columbia	No	-	-
7	UColorado	No	-	-
8	UWisconsin	Yes	?	-
9	UCLA	Yes	-	-
10	Clemson	No	-	-
11	Wayne State	No	-	-
12	UMichigan	No	-	-
13	Temple	No	-	-
14	Drexel	No	-	-

1.3.7 GENI WiMAX Site Backbone Connections

Several GENI WiMAX sites have connections to the GENI backbone provided by Internet2, as summarized in the following table.

Index	Campus	I2 connection	ION ckt to Rutgers WINLAB	Support multi-site experiments?
0	Rutgers WINLAB	Yes	Yes	Yes
1	NECLabs	NA	-	-
2	Raytheon BBN Tech	Yes	Yes	Yes
3	Stanford	NA	-	-
4	Poly	Yes	Yes	Yes
5	UMass	No	-	-
6	Columbia	No	-	-
7	UColorado	No	-	-
8	UWisconsin	Yes	Yes	-
9	UCLA	Yes	Yes	Yes
10	Clemson	Yes	Pending	Pending
11	Wayne State	No	-	-
12	UMichigan	No	-	-
13	Temple	No	-	-
14	Drexel	No	-	-

ION circuits provided by Internet2 are used to carry VLANs from the site to a routing server at Rutgers WINLAB, as summarized in the following table.

ION circuit	Status	Start Time	End Time	Source	Source VLAN	Destination	Destination VLAN	Bandwidth	Details
10822	active	02/29/2012	10/03/2012	bbn.newy.ion.internet2.edu	3735	NYU.newy.ion.internet2.edu	4080	100 Mbps	I2 WiMAX BBN to NYU
11347	active	10/01/2012	11/07/2012	bbn.newy.ion.internet2.edu	3733	MAGPI.wash.ion.internet2.edu	3733	100 Mbps	I2 WiMAX BBN to Rutgers
14741	active	10/2/2012	1/7/2014	MAGPI.wash.ion.internet2.edu	194	CalREN.losa.ion.internet2.edu	3150	100 Mbps	I2 WiMAX Rutgers to UCLA
11322	active	9/11/2012	12/31/2012	MAGPI.wash.ion.internet2.edu	190	NYU.newy.ion.internet2.edu	4081	100 Mbps	I2 WiMAX Rutgers to NYU
11428	active	10/22/2012	12/31/2012	MAGPI.wash.ion.internet2.edu	195	SOX.chic.ion.internet2.edu	1780	100 Mbps	I2 WiMAX Rutgers to Clemson
14461	active	2/20/2013	1/7/2014	MAGPI.wash.ion.internet2.edu	196	cic-force10.ion.internet2.edu	915	100 Mbps	I2 WiMAX Rutgers to Wisconsin
18511	active	6/5/2013	1/7/2014	MAGPI.wash.ion.internet2.edu	198	chic.ion.internet2.edu	1815	100 Mbps	I2 WiMAX Rutgers to Wayne state University

This arrangement provides a private IP network between all of the connected sites, as summarized in the following figure.

Private IP addresses are assigned at each site, as summarized in the following table.

Index	Campus	OID	BS IP Range	GENI Backbone Client Range
0	Rutgers WINLAB	44:51:DB:00:00:XX	10.3.0.XX	10.43.0.XX
1	NECLabs	44:51:DB:00:01:XX	10.3.1.XX	10.43.1.XX
2	Raytheon BBN Tech	44:51:DB:00:02:XX	10.3.2.XX	10.43.2.XX
3	Stanford	44:51:DB:00:03:XX	10.3.3.XX	10.43.3.XX
4	Poly	44:51:DB:00:04:XX	10.3.4.XX	10.43.4.XX
5	UMass	44:51:DB:00:05:XX	10.3.5.XX	10.43.5.XX
6	Columbia	44:51:DB:00:06:XX	10.3.6.XX	10.43.6.XX
7	UColorado	44:51:DB:00:07:XX	10.3.7.XX	10.43.7.XX
8	UWisconsin	44:51:DB:00:08:XX	10.3.8.XX	10.43.8.XX
9	UCLA	44:51:DB:00:09:XX	10.3.9.XX	10.43.9.XX
10	Clemson	44:51:DB:00:10:XX	10.3.10.XX	10.43.10.XX
11	Wayne State	44:51:DB:00:11:XX	10.3.11.XX	10.43.11.XX
12	UMichigan	44:51:DB:00:12:XX	10.3.12.XX	10.43.12.XX
13	Temple	44:51:DB:00:13:XX	10.3.13.XX	10.43.12.XX
14	Drexel	44:51:DB:00:14:XX	10.3.14.XX	10.43.13.XX

This allows the connected sites to participate in multi-site experiments.

R1 BRS/EBS BAND PLAN

Channel Designation	Lower Frequency	Upper Frequency	Comment
BRS 1	2495	2496	Guard Band
BRS 1	2496	2502	LBS
A1	2502	2507.5
A2	2507.5	2513
A3	2513	2518.5
B1	2518.5	2524
B2	2524	2529.5
B3	2529.5	2535
C1	2535	2540.5
C2	2540.5	2546
C3	2546	2551.5
D1	2551.5	2557
D2	2557	2562.5
D3	2562.5	2568
J	2568	2572
A4	2572	2578	MBS
B4	2578	2584
C4	2584	2590
D4	2590	2596
G4	2596	2602
F4	2602	2608
E4	2608	2614
K	2614	2618
BRS 2	2618	2624	Guard Band
E1	2624	2629.5	UBS
E2	2629.5	2635
E3	2635	2640.5
F1	2640.5	2646
F2	2646	2651.5
F3	2651.5	2657
H1	2657	2662.5
H2	2662.5	2668
H3	2668	2673.5
G1	2673.5	2679
G2	2679	2684.5
G3	2684.5	2690

R2 WiMAX Site Deployments

​GENI WiMAX Site Deployments wiki pages

1.4 GENI WiMAX Omf Site Setup

1.4.1 Network setup and configuration

A site will receive a console machine, which runs all the OMF aggregate manager services and three client resources. Two of these client resources will have a fixed power supply. The third client will have a 12 V power supply so that it can function as a mobile node. All services on the console machine will be configured to use the geni.net sub-domain and all IP addresses will be initially configured in the following scheme.

• Data - 10.20.0.X/24
• CM - 10.0.0.X/24
• Control - 10.10.0.X/24

Three networks Data CM Control 3 switches, 1 partitioned switch, or single cable out.

Each site is asked to provide an Ubuntu 12.04 Host to run the Wimax-rf software. This requirement is based on the fact that most deployments are in remote locations or higher elevation locations so keeping the base station software closer to the base station is the motivation. This host will have 2 interfaces

• Public Internet Interface to communicate with the console machine.
• Interface that connects to the base station or a switch connected to the base station.

Setup networking as follows on the console host

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The CM network interface
auto eth1
iface eth1 inet static
      address 10.1.0.254
      netmask 255.255.255.0
      broadcast 10.1.0.255

# The Control network interface
auto eth3
iface eth3 inet static
      address 10.10.0.254
      netmask 255.255.255.0
      broadcast 10.10.0.255

# The  Data network interface
auto eth0
iface eth0 inet static
      address 10.20.0.254
      netmask 255.255.255.0
      broadcast 10.20.0.255

# The primary network interface
auto eth2
iface eth2 inet dhcp

One unmanaged switch per subnet

Single managed switch

Single trunk per node

The console is called console.geni.net. You can ssh into it with the following credentials.

username: native 
password: native101

Some useful commands

Once you have the testbed set up as explained above, use the following commands to talk to the nodes or troubleshoot.

1. omf stat

The manual page is shown below.

> omf help stat

Returns the status of the nodes in a testbed

Usage:
       stat [-h]
       stat [-c] [DOMAIN]
       stat "[TOPOLOGY]" [DOMAIN]

      With: 
      -h, --help    print this help message
      -c, --count   print a summary of the node status for the testbed DOMAIN
                    (default is the testbed where this command is executed)
      TOPOLOGY      a valid topology description or file without the trailing '.rb'
                    (default is the entire set of nodes on the default testbed)

      Some Examples: 
                     stat all grid
                     stat "[[1,2],[1,1]]" sb1 
                     stat "[[1,1],[2..6,1..2]]" 
                     stat system:topo:all
                     stat system:topo:circle
                     stat topo_grid_active

Sample output

INFO NodeHandler: OMF Experiment Controller 5.4 (git 5385228)
 INFO NodeHandler: Slice ID: default_slice (default)
 INFO NodeHandler: Experiment ID: default_slice-2013-07-18t11.42.12.965-04.00
 INFO NodeHandler: Message authentication is disabled
 INFO Experiment: load system:exp:stdlib
 INFO property.resetDelay: resetDelay = 90 (Fixnum)
 INFO property.resetTries: resetTries = 1 (Fixnum)
 INFO Experiment: load system:exp:eventlib
 INFO Experiment: load system:exp:winlib
 INFO Experiment: load system:exp:stat
 INFO property.nodes: nodes = "system:topo:all" (String)
 INFO property.summary: summary = false (FalseClass)
 INFO Topology: Loading topology 'system:topo:all'.

Talking to the CMC service, please wait
-----------------------------------------------
 Node: node1.geni.net   	 State: POWEROFF
 Node: node2.geni.net   	 State: POWEROFF
 Node: node3.geni.net   	 State: NOT REGISTERED
-----------------------------------------------

 INFO EXPERIMENT_DONE: Event triggered. Starting the associated tasks.
 INFO NodeHandler: 
 INFO NodeHandler: Shutting down experiment, please wait...
 INFO NodeHandler: 
 INFO run: Experiment default_slice-2013-07-18t11.42.12.965-04.00 finished after 0:5

2. omf tell

The manual page is shown below.

> omf help tell

Switch ON/OFF the nodes in a testbed

Usage:
       tell [-h]
       tell [COMMAND] "[TOPOLOGY]" [DOMAIN]

      With: 
      -h, --help    print this help message

      COMMAND:
      on, -on, --turn-on              turn node(s) ON
      offs, -offs, --turn-off-soft    turn node(s) OFF (soft)
      offh, -offh, --turn-off-hard    turn node(s) OFF (hard)

      TOPOLOGY      a valid topology description or file
                    (default is the entire set of nodes on the default testbed)

      Some Examples: 
                     tell on all grid
                     tell on "1,1..2" 
                     tell offs "[[1,2],[1,1]]" sb1 
                     tell offs "[[1,1],[2..6,1..2]]" 
                     tell offh system:topo:all
                     tell offh topo_grid_active

<insert output here>