Version 26 (modified by 9 years ago) ( diff ) | ,
---|
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
- 9. WiMAX RF Aggregate Manager Service
- Wireless Control Services
- Error Correction Control Services
- Profile Control Services
- Monitoring and Maintenance Services
- Basic Support Services
- bs/info - Configuration Info
- bs/asngw - ASNGW parameters
- bs/config/list - Displays list of base station configuration profiles …
- bs/config/show - Display contents of a base station configuration profile
- bs/config/save - Save current base station parameter values in a …
- bs/config/load - Load an available configuration profile
- bs/config/delete - Delete a base station configuration profile from …
- bs/defaults - reset BS back to defaults
- bs/mcsProfile - get/set downlink / uplink profile
- bs/debug - DEBUG parameters
- bs/status - Get Current Status
- bs/get - Get Basestation Parameter
- bs/set - Set Basestation Parameter
- bs/restart - Restart the Base Station
- Example usage of services from sandbox
- Datapath Control Services
- datapath/config/list - Displays list of ACL (Access control list) profiles
- datapath/config/load - Loads an ACL profile from database
- datapath/config/save - Saves current ACL as a profile in database
- datapath/config/delete - Removes ACL profile from database
- datapath/config/show - Displays content of an ACL profile
- datapath/clients/add - Adds client MAC address to ACL
- datapath/clients/delete - Delete client MAC address from current ACL
- datapath/clients/modify - Modifies client's VLAN or IP address
- datapath/clients/status - Displays current ACL configuration on BS
- datapath/list - Displays current datapath according to Interface, VLAN …
- datapath/status - Displays datapath status by VLAN id
- datapath/add - Adds datapath according to Interface, VLAN id and type
- datapath/delete - Deletes datapath according VLAN id
- datapath/clean - Removes all datapaths
- Example usage of services from sandbox
- RF Matrix Control Services
Installation for NEC BS
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-
Installation for Airspan BS
If this is from a fresh install of Ubuntu 12.04.4, you will have to add the omf5.4 repository.
echo "deb http://pkg.mytestbed.net/ubuntu precise/" | sudo tee -a /etc/apt/sources.list.d/wimax-aggmgr.list sudo apt-get update
Install omf-aggmgr5.4:
sudo apt-get install omf-aggmgr-5.4
apt-get install click wimaxrf
This will install the WimaxRF AM service along with the required OMF packages and the Click software router. An ASN gateway is not needed to operate the Airspan base station. Please confirm that the most current packages of the software are installed. You can check them with the following command.
dpkg -l | egrep 'omf-|click|wimaxrf'
The output should be similar to this:
ii click 2.1~git20131006-1 Modular software router ii omf-aggmgr-5.4 5.4.3-ubuntu2 OMF Aggregate Manager ii omf-common-5.4 5.4.3-ubuntu2 Common ruby classes for OMF ii wimaxrf 1.0~beta3 OMF WiMAX service manager
Configuration
If it is a fresh install, you will have to copy over the omf-aggmgr.yaml configuration file:
sudo cp /usr/share/doc/omf-aggmgr-5.4/examples/omf-aggmgr.yaml /etc/omf-aggmgr-5.4/.
The config file should be changed to where you have these sevices located:
# NOTE: use only 'spaces' to indent ! # ('tab' indents are not supported by the ruby yaml parser used to read this file) # # This is the config file for global configuration items for the OMF Aggregate Manager. # --- :xmpp: :server: "xmpp.example.com" :user: "aggmgr" :password: "example password" :port: 5222 :use_dnssrv: false :http: :address: "0.0.0.0" :port: 5054 # List of the slices that the AM should by default provide its service to # (other slices can be added later dynamically via a Slice Manager) # :default_slices: ["pxe_slice", "default_slice"]
The configuration file for wimaxrf AM is in the same location as for all the other OMF AM services in /etc/omf-aggmgr-5.4/available/wimaxrf.yaml
. The configuration file consists of multiple sections relating to different components of the services.
Default parameter values are shown in []; Bold font indicates mandatory parameters.
database section
database: dbFile: 'db/wimaxrf.db' reset: file: '/defaults/reset.xml'
- dbFile: SQLite 3.x database file that contains datapaths configuration and authorized clients.
- file: location of the default configuration [none]. The file is an XML file that contains default BS parameters and is used with /default wimaxrf service.
asngw section
This section is unused on Airspan and thus ignored.
asngw: if: eth1 ip: 10.3.0.71 rcvport: 54321 sndport: 54321 id: ASNGW000 tecnh: 3 dsc: IP-Config-Mgmt
bs section
bs: type: airspan/nec bsid: 44:51:db:00:xx:yy ip: 10.3.x.y mask: 255.255.0.0 mgmt_if: eth0.1 data_if: eth0 frequency: 2590000 stats: localoml: :omlServer: oml.orbit-lab.org interval: 20 globaloml: :omlServer: oml.orbit-lab.org
- type: BS type,
airspan
andnec
are currently supported - bsid: globally-assigned ID of the base station
- ip: the base station IP address
- mgmt_if: the name of the network interface on the local machine that is used to communicate with the BS for management purposes (e.g. SNMP calls, traps, etc…)
- data_if: the name of the network interface over which data traffic to and from the BS will flow. Can be the same as
mgmt_if
. - The localoml section is used to specify the OML server that will receive client-related measurements while globaloml server section is used to configure parameters that are used by global GENI-wide logging process (should point at
oml.orbit-lab.org
until GENI gmoc takes over reporting function). Both are configured with two parameters:- :omlServer:: value is the hostname of your OML server. 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 your localhost. - interval: collection interval in seconds (defaults: [10] for localoml and [300] for globaloml)
- :omlServer:: value is the hostname of your OML server. If you wish to install the oml2 server on your host locally, please do so by the following commands.
datapath: section
datapath: manage_interface: true
- manage_interface [false]: whether wimaxrf is allowed to create and destroy VLANs on the datapath interface when adding or deleting datapaths via
/datapath/add
and/datapath/delete
. If set to false, the system administrator must ensure that any required VLANs have been properly setup prior to adding the datapath to wimaxrf.
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 a symbolic link in /etc/omf-aggmgr-5.4/enabled:
cd /etc/omf-aggmgr-5.4/enabled ln -s ../available/wimaxrf.yaml
and restarting the OMF aggregate manager service:
/etc/init.d/omf-aggmgr-5.4 restart
Example NEC configuration
# NOTE: use only 'spaces' to indent ! # ('tab' indents are not supported by the ruby yaml parser used to read this file) # # This is the Config file for the WiMAXRF GridService # --- wimaxrf: database: dbFile: '/db/wimaxrf.db' reset: file: '/defaults/reset.xml' asngw: if: eth1 ip: 10.3.0.71 rcvport: 54321 sndport: 54321 id: ASNGW000 tecnh: 3 dsc: IP-Config-Mgmt bs: type: nec ip: 10.3.0.61 mask: 255.255.0.0 bsid: 44:51:DB:00:00:01 frequency: 2590000 stats: localoml: :omlServer: oml.orbit-lab.org interval: 10 globaloml: :omlServer: oml.orbit-lab.org datapath: datapathif: eth0
Example Airspan configuration
# NOTE: use only 'spaces' to indent ! # ('tab' indents are not supported by the ruby yaml parser used to read this file) # # This is the Config file for the WiMAXRF GridService # --- wimaxrf: database: dbFile: 'db/wimaxrf.db' bs: type: airspan bsid: 44:51:db:00:00:10 ip: 10.3.0.10 mask: 255.255.0.0 mgmt_if: eth1 data_if: eth1.500 frequency: 2572000 stats: localoml: :omlServer: oml.orbit-lab.org globaloml: :omlServer: oml.orbit-lab.org datapath: manage_interface: true