close Warning: Can't synchronize with repository "(default)" (/common/SVN/wimax does not appear to be a Subversion repository.). Look in the Trac log for more information.

Changes between Version 4 and Version 5 of Old/WiMAX/05/01


Ignore:
Timestamp:
Dec 1, 2010, 9:14:25 PM (10 years ago)
Author:
hmussman
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Old/WiMAX/05/01

    v4 v5  
    1 = gg =
     1= 6.  Case 2:  Hardware and Software Installation =
     2
     3
     4== WiMAX OID and IP Address Assignment ==
     5
     6
     7|| Campus || OID || IP Range ||
     8|| WINLAB || 44:51:DB:00:00:XX || 10.3.0.XX ||
     9|| NECLabs || 44:51:DB:00:01:XX || 10.3.1.XX ||
     10|| BBN || 44:51:DB:00:02:XX || 10.3.2.XX ||
     11|| Stanford || 44:51:DB:00:03:XX || 10.3.3.XX ||
     12|| Poly || 44:51:DB:00:04:XX || 10.3.4.XX ||
     13|| UMass || 44:51:DB:00:05:XX || 10.3.5.XX ||
     14|| Columbia || 44:51:DB:00:06:XX || 10.3.6.XX ||
     15|| UColorado || 44:51:DB:00:07:XX || 10.3.7.XX ||
     16|| UWisconsin || 44:51:DB:00:08:XX || 10.3.8.XX ||
     17|| UCLA || 44:51:DB:00:09:XX || 10.3.9.XX ||
     18
     19Each campus can have up to 127 basestations (each BS needs two addresses) and/or multiple ASN gateways. The basestations are assigned OIDs and IPs starting from 1 and counting up while ASN gateway machines are assigned IP addresses that are assigned starting from 254 and counting down. For example, first basestation in WINLAB gets IP address on primary controller of 10.3.0.1 and the IP address for the networking card of 10.3.0.2 while the gateway machine gets 10.3.0.254
     20
     21
     22==  Base Station Server Installation ==
     23
     24
     25=== Prerequisites ===
     26
     27 * Expected OS: Ubuntu 9.04
     28   {{{
     29   lsb_release -a
     30   No LSB modules are available.
     31   Distributor ID: Ubuntu
     32   Description:    Ubuntu 9.04
     33   Release:        9.04
     34   Codename:       jaunty
     35   }}}   
     36 * It is expected that there be 3 wired Ethernet interfaces named: eth0, eth1, eth2. You may need to edit '''/etc/udev/rules.d/70-persistent-net.rules''' to make the names
     37   reflect the correct physical ports. The '''/etc/network/interfaces''' file should look similar to this:
     38   {{{
     39   # This file describes the network interfaces available on your system
     40   # and how to activate them. For more information, see interfaces(5).
     41   
     42   # The loopback network interface
     43   auto lo
     44   iface lo inet loopback
     45
     46   # This interface connect to the Base Station
     47
     48   auto eth1
     49   iface eth1 inet static
     50   address 192.168.1.50
     51   network 192.168.1.0
     52   netmask 255.255.255.0
     53   broadcast 192.168.1.255
     54
     55   #This is the gateway interface, it should get a routeable address from DHCP
     56   
     57   auto eth2
     58   iface eth2 inet dhcp
     59
     60   #Reserved for future USE
     61
     62   auto eth0
     63   iface eth0 inet static
     64   address 10.41.0.3
     65   network 10.41.0.0
     66   netmask 255.255.0.0
     67   broadcast 10.41.255.255
     68   }}}
     69
     70=== Install Required Packages ===
     71
     72 1. Configure apt/sources to include mytestbed.net and orbit-lab.org. Edit the '''/etc/apt/sources.list''' and add the following lines:
     73    {{{
     74    deb http://pkg.mytestbed.net/ubuntu karmic/
     75    deb http://packages.orbit-lab.org/ubuntu jaunty main
     76    }}}
     77 1. Update information based on the changed sources.list.
     78    {{{
     79     sudo apt-get update
     80    }}}
     81 1. Now install the ASN-GW software
     82    {{{
     83    sudo apt-get install asn-gw0.9.0 click1.6.0 omf-wimaxrf-aggmgr-5.2
     84    }}}
     85    This will install 333MB or so worth of packages. You will need to confirm some of the packages from our repository.
     86
     87
     88== Setting up the NEC BTS ==
     89
     90Please note: Do not restart BTS until all changes are complete. If you do happen to restart, you will have to use the serial interface to connect to the BTS.
     91
     92=== Step1 Configuring the IP ===
     93
     94We'll need to adjust the ip's of both interfaces. They're managed via two independent files which exists on two different machines/ip combos.
     95
     96 1. The "DSP" machine:
     97  1. Copy the attached [attachment:networkenv.orbit networkenv.orbit] file locally (to your console) and edit it's addresses to reflect
     98     [wiki:WiMAX/00/Configuration/AddressAssignments your organisations Address Structure]. If this is the first BTS in your organization
     99     your address should be of the form 10.3.X.1, where X is the numerical ID given to your group. You'll only need to edit the #MACO segment of information.
     100     You will also need to set the NAMESERVER flag to something reasonable like googles public DNS (8.8.8.8), or a specfic DNS in your network. Note that we're using
     101     class B addresses.
     102     {{{
     103     #MAC0
     104     export INTERFACE_0=eth0
     105     export IPADDR_0=10.3.X.1
     106     export NETMASK_0=255.255.0.0
     107     export BROADCAST_0=10.3.255.255
     108     export GATEWAY_0=10.3.X.1
     109     export NAMESERVER_0=8.8.8.8
     110     }}}
     111  1. Copy the file to /flash/networkenv on the DSP machine (via SCP). The default IP of the DSP machine is 192.168.1.10.
     112     {{{
     113     scp networkenv.orbit root@192.168.1.10:/flash/networkenv
     114     }}}
     115 1. The "Network" Machine
     116  1. Telnet to the N/W card at 192.168.1.42/24. User root as the username, you will not be asked for a password.
     117  1. Edit the /etc/network/interfaces eth1 entry to organisations Address Structure. It should be of the form 10.3.X.2, for the first BTS. The entry should look
     118     similar to:
     119     {{{
     120     auto eth1
     121     iface eth1 inet static
     122     address 10.3.X.2
     123     network 10.3.0.0
     124     netmask 255.255.0.0
     125     broadcast 10.3.255.255
     126     gateway 10.3.X.1
     127     }}}
     128 1. Finally you'll need to configure your own interface to be in the same subnet as the BS Ip's. For the first BS it should be of the form 10.3.X.254.
     129
     130=== Step 2a Configure The BS software ===
     131  1. ssh to the new IP of the DSP machine. ssh !root@10.3.x.1
     132  1. Use wiset commands below to correct configuration on the BTS:
     133   1. Enter these '''Verbatim'''
     134      {{{
     135      wiset authgw_id 0x41534E47
     136      wiset authgw_port 0x08B7
     137      wiset asngw_id 0x41534E4757303030
     138      wiset asngw_dp_port  0x08B7
     139      wiset asngw_ep_port 0x08B7
     140      wiset bs_rx_port 0x08B7
     141      wiset frequency  2551500
     142      wiset bs_tx_power 40
     143      wiset bw_mode 0
     144      wiset dlul_ratio 2
     145      wiset ttg 296
     146      wiset rtg 168
     147      wiset framesync_mode 2
     148      wiset antenna_gain 0
     149      }}}
     150   1. These commands require you to change the IP paramter specfied in hex. The IP should that of the console's eth1 interface (which speaks to the BTS).
     151      {{{
     152      wiset authgw_ip 0x0A030047
     153      wiset asngw_dp_ip 0x0A030047
     154      wiset asngw_ep_ip 0x0A030047
     155      }}}
     156   1. You will find your bsid (OID) on [wiki:WiMAX/00/Configuration/AddressAssignments this page]. Note remove the colons, and set the last two digits to
     157      reflect the IP of the DSP machine (e.g. the first one should be 01).
     158      {{{
     159      wiset bsid 0x303030303030
     160      }}}
     161
     162After this process, the BS will require a reboot.
     163
     164This [http://www.kloth.net/services/iplocate.php site] converts dot quad to hex.
     165
     166
     167
     168=== Step 2b  BTS Configuration ===
     169
     170Cat the following code to a shell script and execute after sshing into the BTS at the default ip: 192.168.1.10.
     171If ssh does not work, try with a serial console.
     172
     173{{{
     174/usr/sbin/wimax/cmd_app 3 authgw_id 0x41534E4757303030
     175/usr/sbin/wimax/cmd_app 3 authgw_port 0x08B7
     176/usr/sbin/wimax/cmd_app 3 asngw_id 0x41534E4757303030
     177/usr/sbin/wimax/cmd_app 3 asngw_dp_port  0x08B7
     178/usr/sbin/wimax/cmd_app 3 asngw_ep_port 0x08B7
     179/usr/sbin/wimax/cmd_app 3 bs_rx_port 0x08B7
     180/usr/sbin/wimax/cmd_app 3 bsid 0x000004000000
     181/usr/sbin/wimax/cmd_app 3 frequency  2551500
     182/usr/sbin/wimax/cmd_app 3 bs_tx_power 40
     183/usr/sbin/wimax/cmd_app 3 bw_mode 0
     184/usr/sbin/wimax/cmd_app 3 dlul_ratio 2
     185/usr/sbin/wimax/cmd_app 3 ttg 296
     186/usr/sbin/wimax/cmd_app 3 rtg 168
     187/usr/sbin/wimax/cmd_app 3 framesync_mode 2
     188/usr/sbin/wimax/cmd_app 3 antenna_gain 0
     189/usr/sbin/wimax/cmd_app 3 authgw_ip 0xC0A80132
     190/usr/sbin/wimax/cmd_app 3 asngw_dp_ip 0xC0A80132
     191/usr/sbin/wimax/cmd_app 3 asngw_ep_ip 0xC0A80132
     192}}}
     193
     194
     195
     196
     197== Manual Configuration Of SAMrb ==
     198
     199Note these instructions need to be followed if you are using just the SAMrb instead of the full omf-wimaxrf-aggmgr-5.2 webservice.
     200
     201Once you untar and enter in the SAMrb directory you can edit the file SimpleAuthManager.rb.
     202
     203In this file please change the following to reflect your network settings:
     2041. The $ips hash table should be updated to include your client mac to IP mapping.
     2052. The $def_gw = "10.41.0.1"   and $net_mask = "255.255.0.0" settings should be used to reflect the CSN side settings.
     206
     207== Configuration of ASN-GW Controller and NEC IDU ==
     208
     209Configuration of software both for the ASN-GW and the WiMAX BTS is done through a single yaml configuration file on the ASN.
     210
     211To enable the features we will need to copy the '''wimaxrf.yaml''' from '''/etc/omf-aggmgr-5.2/available''' to '''/etc/omf-aggmgr-5.2/enabled/'''.
     212
     213Edit this file change settings (if needed)
     214{{{
     215# NOTE: use only 'spaces' to indent !
     216# ('tab' indents are not supported by the ruby yaml parser used to read this file)
     217#
     218# This is the Config file for the WiMAXRF GridService
     219#
     220---
     221wimaxrf:
     222
     223  asngw:
     224   if: eth1
     225   ip: 192.168.1.50
     226   port: 2231
     227   id: ASNGW000
     228   tecnh: 3
     229   dsc: IP-Config-Mgmt
     230
     231  click:
     232    def_gw: 10.41.0.1
     233    net_mask: 255.255.0.0
     234    def_ip: 10.41.0.254
     235
     236  bs:
     237   ip: 192.168.1.10
     238   mask: 255.255.255.0
     239   bsid: 00:00:04:00:00:01
     240   frequency: 2590000                           
     241}}}
     242
     243Making changes in this file should propagate changes to the ASN software and the BTS (IDU) software.
     244
     245
     246
     247
     248== Testing ==
     249
     250=== Simple Checks ===
     251
     252A few simple checks to make sure things are working:
     253 1. You should be able to ping the Base Station, it was assigned the fixed IP 192.168.1.10.
     254 1. Some log files should start filling up in '''/var/log''':
     255  1. asnctrl.log
     256  1. epctrl.log
     257 1. There should also be a green light on the IDU after a software power cycle of the IDU. The software power cycle can be preformed by the following commands:
     258    {{{
     259    /etc/init.d/asn-gw stop
     260    /etc/init.d/asn-gw start
     261    }}}
     262 1. There should be 3 running processes:
     263    {{{
     264    root      3128     1  0 19:10 ?        00:00:00 trapctrl
     265    root      3137     1  0 19:10 ?        00:00:02 asnctrl
     266    root      3227     1  0 19:10 ?        00:00:02 epctrl
     267    }}}
     268
     269
     270=== Prerequisites ===
     271
     2721. Confirm that all hardware and software has been properly installed.
     273
     274
     275=== Hardware connectivity check ===
     276
     277Login through the console on the ASN-GW and test the following.
     278
     2791. Is the BTS is reachable from the ASN-GW. with the default IP setting
     280    - ping the BTS interface
     281    - measure the round trip times
     282
     2832. Power cycle the BTS through the use of stop and start scripts.
     284   - Perform a hard reset if required (if updated parameter values are not reflected).
     285
     2863. Ping the outside interface and see if the DMZ gateway is reachable from the ASN-GW
     287
     288After successful completion we know that the ASN is able to send traffic both downlink to the IDU
     289and outbound towards the internet.
     290
     291=== Test the RF Transmission ===
     292
     2931. Scan on the client and check if the basestation's signal is seen using the procedure described below. If we are able to connect step 2 can be ignored. Else try step 2.
     294
     295Configure driver at the client to ensure all required parameters are configured correctly.
     296   - Change the /etc/asnctrl_service_class.conf to include client and service class information.
     297   - possibly include SSID to match with the BTS
     298   - Check center frequency to match with the BTS
     299   - Enable (locks) if any
     300   - Disable wifi if operating on a dual mode card (since quite a few times they work in a mutually exclusive mode)
     301   - Enable a static IP setting at the client to allow for baseline IP connectivity
     302
     303
     3042. If possible sweep the spectrum through an analyzer to determine proper transmission at the center frequency.
     305   - Vary transmit power at the BTS using wiset calls on the BTS or through the web interface and then measure the corresponding changes on the analyzer.
     306