wiki:Internal/WiMAX/WiMAXAPI/Usage

Accessing the WiMAX Base Station

The WiMAX ASN Gateway (cons-wm-01) can be accessed from the ORBIT internal server (internal1.orbit-lab.org). Users interested in experimenting with the base station should log on to internal1.orbit-lab.org using their ORBIT username and password. The next steps are enumerated below

  • Initialize the grid service:

Initializes the VM grid service. Checks for running VMs and initializes datapath on the machine.

Input Command

wget http://wm-asngw-02:5012/wimaxvm/initvms

Expected Output

01 0
 #mac vm4212 1
 #mac vm43
  • List all Virtual Machines that are currently running on the ASN gateway:

Allows the administrator to have a detailed view of the current VMs and provides VM statistics in XML format.

Input Command

wget http://wm-asngw-02:5012/wimaxvm/vmlist

Expected Output

0vm42  VLANID 1
1vm43  VLANID 2

  • Start Virtual Machines

Starts VM instance. Configures VLANs on VM substrate

Input Command

wget http://wm-asngw-02:5012/wimaxvm/start?vmname=vm1 

Expected Output

started vm1 with vlan tag 3
  • Add Mobile Client to the Virtual Machine

Registers a client with the slice. Currently adds default service flow settings for the client. Adds mapping to the datapath controller on ASN-GW.

Input Command

wget http://wm-asngw-02:5012/wimaxvm/addclient?vmname=vm1\&clientmac=84:22:10:14:2b:9a 

Expected Output

vm1 and 84:22:10:14:2b:9a

Sample Experiment Script

This script demnstrates how to start VM instances and switch the mobile client with MAC: "84:22:10.14.2b.9a" between two VMs: VM1, VM2 every 20 secs.

wget http://wm-asngw-02:5012/wimaxvm/start?vmname=vm1 
wget http://wm-asngw-02:5012/wimaxvm/stop?vmname=vm2 
sleep 10
while 1
  wget http://wm-asngw-02:5012/wimaxvm/addclient?vmname=vm1\&clientmac=84:22:10:14:2b:9a 
  sleep 20
  wget http://wm-asngw-02:5012/wimaxvm/addclient?vmname=vm2\&clientmac=84:22:10:14:2b:9a 
  sleep 20
end
Last modified 10 years ago Last modified on 05/20/10 15:51:29