WiMAX/17

9. WiMAX RF Aggregate Manager Service

wimaxrf is an Aggregate Manager (AM) that is used to configure and control WIMAX (Basestation) RF Section.

WiMAX RF Aggregate Manager

  1. 9. WiMAX RF Aggregate Manager Service
    1. Installation
    2. Configuration
  2. Wireless Control Services
    1. /driver - Base Station Driver services
    2. /mimo - MIMO Service
    3. /security - Security Parameters
    1. /wireless - Wireless Parameters
    1. /mobile - Mobile Control
  5. Error Correction Control Services
    1. /arq - ARQ Control
    2. /harq - HARQ Control
    1. /mpc - Measurement and Power Control
  7. Profile Control Services
    1. /dlprofile - Down Link Profile
    2. /ulprofile - Up Link Profile
    1. /mimo - MIMO Service
    1. /security - Security Parameters
  10. Monitoring and Maintenance Services
    1. /monitor - Monitor service parameter
    2. /maintenance - Maintenance Parameters
    3. /misc - Miscellaneous Parameters
  11. Basic Support Services
    1. /info - Configuration Info
    2. /status - Get Current Status
    3. /get - Get Basestation Parameter
    4. /set - Set Basestation Parameter
    5. /restart - Restart the Base Station
    6. /default - Reset to Default Parameters
    7. /restore - Restore Base Station Config
    8. Example usage of services from sandbox
  12. Client Control Services
    1. /addClient - Add client MAC address to ACL database
    2. /deleteClient - Delete client MAC address from ACL database
    3. /listClients - List clients registered in the ACL database
  13. RF Matrix Control Services

Installation

   apt-get install omf-wimaxrf-aggmgr-5.2

Please confirm that the most current packages of the software are installed. You can check it
with the following commands. 

dpkg -l | egrep 'omf-|asn-gw|click'

Current version for omf-common-5.2 is 4 and
Current version for omf-aggmgr-5.2 is 6 

ii  omf-aggmgr-5.2                      ubuntu6                                  OMF Aggregate Manager
ii  omf-common-5.2                      ubuntu4                                  Common ruby classes for OMF

In case of wrong version please remove the two packages and reinstall them.

apt-get --purge remove omf-aggmgr-5.2 omf-common-5.2
apt-get install omf-aggmgr-5.2
dpkg -l | grep omf-

Configuration

The configuration file for wimxrf AM is in the same location as for all the other OMF AM services in /etc/omf-agggr-5.2/available/wimaxrf.yaml. The configuration file consists of multiple section sections relating to different components of the services.

Default parameter values are shown in []; Bold font indicates mandatory parameters.

asngw: Section

  asngw:
   if: eth1
   ip: 10.3.0.71
   rcvport: 54321
   sndport: 54321
   id: ASNGW000
   tecnh: 3
   dsc: IP-Config-Mgmt

bs: section

datapath: section

Typical configuration: 

  datapath:
    type: simpleclick
    def_gw: 10.41.0.1
    net_mask: 255.255.0.0
    def_ip: 10.41.0.254

These configuration parameters are temporary -> click is supposed to learn them from client DHCP requests.

  • def_gw: IP address of the default gateway for WiMAX clients [none]
  • net_mask: Network mask for datapath subnet [none]
  • def_ip: IP address that will be given to clients that are not assigned IP address (i.e. unknown clients) [none]

auth: Section

  auth:
    database: /var/spool/asnctrl/wimax-clients.sql
    allow_unknown: true
  • database: Location of the SQLite authentication database /var/spool/asnctrl/wimax-clients.sql
  • allow_unknown: If set to true, will allow access for clients that are not registered in the authentication database [false]

Oml: Section

   localoml:
       omlServer: oml.orbit-lab.org

omlServer: value is the hostname of your OML server. Alternatively if you wish to install the oml2 server on your host
locally, please do so by the following commands. 

  apt-get install oml2-server

and then point the omlServer value to localhost.

reset: Section

  reset:
   file: '/defaults/reset.xml'
  • file: location of the default configuration [none]. The file is an XML file that containes default BS parameters and is used with /default wimaxrf service

Each of the sections in this file should be modified to reflect your deployment configuration (please keep in mind that this is a YAML file and that it depends heavily on spaces and not TABs). Once the configuration file is ready, you have to enable the service by creating the symbolic link in /etc/omf-aggmgr-5.2/enabled: 

ln -s ../available/wimaxrf.yaml

and restarting the OMF aggregate manager service: 

/etc/init.d/omf-aggmgr-5.2 restart

Logging

OMF aggregate managers have quite extended logging capabilities. Log messages from all of the enabled services are stored in /var/log/omf-aggmgr-5.2.log