Changes between Version 22 and Version 23 of Tutorials/g0WmLTE/Tutorial0


Ignore:
Timestamp:
Oct 18, 2012, 1:01:01 AM (12 years ago)
Author:
ffund01
Comment:

—

Legend:

Unmodified
Added
Removed
Modified

  • Tutorials/g0WmLTE/Tutorial0

    v22 v23  
    3737The base station receives instructions from [http://en.wikipedia.org/wiki/GET_(HTTP)#Request_methods "http get requests"] sent from the corresponding sandbox. For example, consider
    3838{{{
    39 wget -qO- http://cons-wm-01:5052/wimaxrf/datapath/config/load?name=defaults
    40 }}}
    41 "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".
     39wget -qO- http://wimaxrf:5052/wimaxrf/bs/default
     40}}}
     41"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/bs/default" is the command to load the default base station settings.
    4242
    4343== Restoring the Base Station to Defaults ==
    … …  
    4545To restore the base station to defaults, run the following commands:
    4646{{{
    47 wget -qO- http://cons-wm-01:5052/wimaxrf/defaults
    48 wget http://cons-wm-01:5052/wimaxrf/restart
     47wget -qO- http://wimaxrf:5052/wimaxrf/bs/default
     48wget -qO- http://wimaxrf:5052/wimaxrf/bs/restart
    4949}}}
    5050After issuing the restart command, the base station will be unavailable for 2 minutes. Do not be alarmed if the base station returns what appears to be the following error message:
    … …  
    6565
    6666{{{
    67 omf-5.3 load -i wmx-tutorial.ndz -t node1-1.sb4.orbit-lab.org,node1-4.sb4.orbit-lab.org
    68 }}}
    69 
    70 You should assume that this command is whitespace-sensitive.
     67omf-5.3 load -i wmx-tutorial.ndz -t node1-4.sb4.orbit-lab.org,node1-6.sb4.orbit-lab.org
     68}}}
     69
     70You should assume that this command is whitespace-sensitive (do not include any spaces between the node names and the commas).
    7171
    7272[[Image(pxe1.png)]]
    … …  
    8080SSH into the nodes, one at a time, to confirm that the settings loaded correctly.
    8181{{{
    82 ssh root@node1-1
     82ssh root@node1-4
     83}}}
     84
     85If you get a message that says,
     86{{{
     87The authenticity of host 'node1-4 (10.14.1.4)' can't be established.
     88RSA key fingerprint is 62:ee:bf:75:50:84:f3:e8:86:f3:e5:e0:75:f0:3a:1a.
     89Are you sure you want to continue connecting (yes/no)?
     90}}}
     91
     92answer
     93{{{
     94yes
    8395}}}
    8496
    8597If this works, proceed to the next section. If not, here is some error-checking advice.
    8698
    87 If you receive an error message like the one below, it may mean that your node is off after the imaging process. If so, you should turn it on.
    88 
    89 [[Image(failconnect.png)]]
    90 
    91 Sometimes nodes also 'hiccup' after imaging, and will deny connections. This can be worked around by turning the affected nodes off and back on.
    92 
    93 ----
     99If you receive an error message like
     100
     101{{{
     102ssh: connect to host node1-4.sb4.orbit-lab.org port 22: No route to host
     103}}}
     104
     105it may mean that your node is off after the imaging process. If so, you should turn it on by running the following command:
     106
     107{{{
     108omf-5.3 tell -a on -t node1-4.sb4.orbit-lab.org,node1-6.sb4.orbit-lab.org
     109}}}
     110
     111
     112Sometimes nodes also 'hiccup' after imaging, and will deny connections. This can be worked around by turning the affected nodes off and back on as follows:
     113
     114{{{
     115omf-5.3 tell -a offh -t node1-4.sb4.orbit-lab.org,node1-6.sb4.orbit-lab.org
     116}}}
     117
     118{{{
     119omf-5.3 tell -a on -t node1-4.sb4.orbit-lab.org,node1-6.sb4.orbit-lab.org
     120}}}
     121
     122----
     123
     124If you have successfully logged into a node with SSH, you will see the following prompt:
     125
     126{{{
     127root@node1-4:~#
     128}}}
     129
    94130Check that the drivers loaded correctly using the ''lsmod'' command. The WiMAX drivers on this testbed are of the i2400 family.
    95131
    … …  
    114150}}}
    115151
     152The output should be:
     153{{{
     154Enter Command:
     155q - Quit AppSrv
     156t - Trace ReInit (ReLoads Registry Values)
     157u - uplink(Apdo uplink event
     158h - Help
     159d - Toggle driver messages to display - debug & internal only
     160
     161
     162Another instance of wimax (pid 681) is already running!. Shutting down...
     163}}}
     164
    116165=== Connect to the WiMAX Network ===
    117166
    … …  
    127176=== Assign an IP Address ===
    128177
    129 By this point, the drivers are loaded, and the network is connected. However, the WiMAX card hasn't been given an IP address yet. Below is the recommended IP address for node 1 on sandbox 4. (Alternate IP addresses are allowed, but require additional configuration at other stages of an experiment.)
     178By this point, the drivers are loaded, and the network is connected. However, the WiMAX card hasn't been given an IP address yet. Below is the recommended IP address for node 4 on sandbox 4. (Alternate IP addresses are allowed, but require additional configuration at other stages of an experiment.)
    130179
    131180{{{
    132181ifconfig
    133 ifconfig wmx0 10.41.14.1 netmask 255.255.0.0 up
     182ifconfig wmx0 10.41.14.4 netmask 255.255.0.0 up
    134183ifconfig
    135184}}}
    … …  
    143192== Repeat for Other Nodes ==
    144193
    145 For the sake of brevity, we will not repeat the previous process at length for the other nodes. However, we will give sample instructions for node 4, and elaborate on some general rules.
    146 
    147 {{{
    148 ssh root@node1-4 # will take to another screen
     194For the sake of brevity, we will not repeat the previous process at length for the other nodes. However, we will give sample instructions for node 6, and elaborate on some general rules.
     195
     196{{{
     197ssh root@node1-6 # will take to another screen
    149198lsmod | grep i2400
    150199modprobe i2400m_usb # only if needed
    151200wimaxcu ron
    152201wimaxcu connect network 51
    153 ifconfig wmx0 10.41.14.4 netmask 255.255.0.0 up
    154 }}}
    155 
    156 === ''ifconfig'' Recommended Settings ===
     202ifconfig wmx0 10.41.14.6 netmask 255.255.0.0 up
     203}}}
     204
     205===  Recommended Settings for IP Addresses ===
    157206
    158207For most of the sandboxes on ORBIT, the rule of thumb for assigning IP addresses is:
    … …  
    16020910.41.1X.Y
    161210}}}
    162 Where 10.41 is the hostname, X is the sandbox number, and Y is the node number.
     211Where 10.41 is the hostname, X is the sandbox number, and Y is the node number (e.g., node1-4 has Y=4).
     212
     213
     214On the "outdoor" testbed, the rule is
     215{{{
     21610.41.40+X.Y
     217}}}
     218
     219and on the "grid" testbed, the rule is
     220{{{
     22110.41.100+X.Y
     222}}}
     223
     224where X and Y are the node coordinates (e.g., node1-4 has X=1, Y=4).
    163225
    164226----
    … …  
    166228== Testing Connection ==
    167229
    168 Repeat the previous steps for other nodes. To test the connection between two nodes, use the ''ping'' utility, which sends packets at an IP address and checks for confirmation of receipt. Assuming that nodes 1 and 4 have already been connected:
    169 
    170 {{{
    171 ssh root@node1-1
     230Repeat the previous steps for other nodes. To test the connection between two nodes, use the ''ping'' utility, which sends packets at an IP address and checks for confirmation of receipt. Assuming that nodes 4 and 6 have already been connected:
     231
     232{{{
     233ssh root@node1-6
    172234ping 10.41.14.4
    173235}}}
    … …  
    191253
    192254{{{
    193 wget -qO- http://cons-wm-01:5052/wimaxrf/client/status
    194 wget -qO- http://cons-wm-01:5052/wimaxrf/client/add...
    195 wget -qO- http://cons-wm-01:5052/wimaxrf/client/delete...
     255wget -qO- http://wimaxrf:5052/wimaxrf/datapath/clients/list
     256wget -qO- http://wimaxrf:5052/wimaxrf/datapath/clients/add...
     257wget -qO- http://wimaxrf:5052/wimaxrf/datapath/clients/delete...
    196258}}}
    197259