Hyper Open Edge Cloud

How to configure ORS with root access

How to configure ORS with root access
  • Last Update:2023-09-08
  • Version:001
  • Language:en

Default provided configuration files

Rapid.Space will provide default configuration files:

  • /root/config-amarisoft/enb/ors-config/enb.TDDXXXX.cfg : eNB configuration
  • /root/config-amarisoft/mme/ors-config/mme-ims.cfg: MME configuration
  • /root/config-amarisoft/mme/ors-config/ue_db-ims.cfg: Sim Card Database configuration

Symbolic links are also made to /root/enb/config/enb.cfg and /root/mme/config/mme.cfg

Switch between 4G and 5G

To switch between 4G and 5G, you can make symbolic links from either eNB configuration files or gNB configuration files:

root@orsXX:~# cd ~/enb/config
root@orsXX:~# ln -sf ~/config-amarisoft/enb/ors-config/enb.XXX.cfg enb.cfg
root@orsXX:~# ln -sf ~/config-amarisoft/enb/ors-config/gnb.XXX.cfg enb.cfg

You do not need to change core network configuration when switching between 4G and 5G.

Log location

While amarisoft is running, you can find logs in /tmp/enb.log, /tmp/gnb.log or /tmp/mme.log.
After amarisoft has finished running logs will be copied to /var/log/lte
You can also use Amarisoft web interface to read the logs, please check Amarisoft documentation.

Please read How To Interpret ORS Logs to learn how to interpret the logs.

Change TX gain

When you change TX gain you need to change the following values in 4G and 5G:

  • 4G: In sib2_3.asn file:  referenceSignalPower tx_gain - OFFSET
  • 5G: In gnb.cfg file: ss_pbch_block_power: tx_gain - OFFSET

OFFSET is equal to 54 if your ORS is a 2 x 1W and 35 if you have a 2 x 0.5W 

License error 1

If Amarisoft exits in a bad state you might have some leftovers lock files, this can cause license error 1 when running Amarisoft.

If you encounter this error please remove the lock files with the following command:

root@orsXX:~# rm -rf /tmp/.lte*

Update Amarisoft

To update amarisoft, please use the install-amarisoft.sh script. Due to an issue with ORS FPGA, you currently need to provide 2021 binaries to this script as well as the recent ones.

First copy both binaries to your ORS:

laptop:~/Downloads# scp amarisoft.2021-XX-XX.tar.gz orsXXX:
laptop:~/Downloads# scp amarisoft.2023-XX-XX.tar.gz orsXXX:
Then run the script on the ORS:
root@orsXX:~# config-amarisoft/install-amarisoft.sh amarisoft.2021-XX-XX.tar.gz amarisoft.2023-XX-XX.tar.gz

Update FPGA

If you get an error saying your FPGA is not up to date, please send us an email and we will provide you the procedure to update your FPGA.