Hyper Open Edge Cloud

Generate ORS Image

  • Last Update:2022-09-08
  • Version:002
  • Language:en

Install OS

Install Ubuntu 20.04 by downloading the "64-bit PC (AMD64) server install image" iso image here, and then copying it to an USB disk. You can use dd to copy the iso:

laptop:~# dd if=iso_image_path of=/dev/usb_device bs=1M status=progress && sync

During the installation, you should choose these options:

  • language: English
  • keyboard: chose depending on your keyboard
  • Use entire disk
  • No LVM
  • hostname : orsXXX # replace XXX with the number
  • username, password: slapos
  • Install OpenSSH server
  • No snap to install

Connect through SSH

Once the installation is complete and you have rebooted after removing the USB key, the next steps can be done through SSH. To find the IP of the ORS computer, you can use the following command:

laptop:~# sudo nmap -T4 -sP network_ip/prefix_length | grep -B2 Taiwan

Once you have the ip, you can connect to the ORS computer through SSH:

laptop:~# ssh slapos@ors_ip
Password: slapos

Setup SSH keys

Configure network with ifupdown

root@orsXX:~# apt install -y ifupdown

Place the following script inside /etc/network/interfaces

root@orsXX:~# auto lo
root@orsXX:~# iface lo inet loopback

auto enp0s31f6
iface enp0s31f6 inet dhcp
        post-up echo 1 > /proc/sys/net/ipv4/conf/all/forwarding
        post-up iptables -t nat -A POSTROUTING -o enp0s31f6 -j MASQUERADE

auto enp2s0
iface enp2s0 inet dhcp
        post-up echo 1 > /proc/sys/net/ipv4/conf/all/forwarding
        post-up iptables -t nat -A POSTROUTING -o enp2s0 -j MASQUERADE


If you need to add another re6st IPv6 on lo:

auto lo lo:0
iface lo inet loopback
iface lo:0 inet6 static
        address <re6st-ip>
        netmask <re6st-netmask>


root@orsXX:~# apt remove -y --purge netplan.io networkd-dispatcher

Upgrade And fix Ubuntu 

root@orsXX:~# apt update
root@orsXX:~# eatmydata apt dist-upgrade -y
root@orsXX:~# apt autoremove --purge -y
root@orsXX:~# apt remove -y snapd irqbalance
root@orsXX:~# apt install -y net-tools

Install software to flash Xilinx FPGA 

Put flash-trxsdr.tgz on the ORS computer:

root@orsXX:~# wget https://www.erp5.com/rapidspace-ORS.Assembly.Process.Flash.TRXSDR/Base_download

Patch the FPGA:

root@orsXX:~# tar -xzvf flash-trxsdr.tgz
root@orsXX:~# cd flash-trxsdr/
root@orsXX:~/flash-trxsdr# rm -rf openocd.tar.gz
root@orsXX:~/flash-trxsdr# apt install -y git libtool automake pkg-config libusb-dev libftdi-dev libusb-1.0-0-dev build-essential
root@orsXX:~/flash-trxsdr# git clone https://github.com/openocd-org/openocd openocd
root@orsXX:~/flash-trxsdr# cd openocd
root@orsXX:~/flash-trxsdr/openocd# git checkout v0.11.0
root@orsXX:~/flash-trxsdr/openocd# ./bootstrap
root@orsXX:~/flash-trxsdr/openocd# ./configure --enable-ftdi
root@orsXX:~/flash-trxsdr/openocd# make -j 4

Install Amarisoft stack

Remove all previous software if any:

root@orsXX:~# rm -rf lteenb* trx_sdr* mme ots mbms enb

root@orsXX:~# tar -xzvf amarisoft.2021-12-17.tar.gz
root@orsXX:~# cd 2021-12-17/
root@orsXX:~/2021-12-17/# ./install.sh --default

Wait (very long, no output)
Hard reboot

Put the Amarisoft licences:

root@orsXX:~# mkdir ~/.amarisoft

copy lteenb.key and ltemme.key in ~/.amarisoft

Prepare ORS for SlapOS Software Release

The ors-amarisoft SR expects the amarisoft stack to be in /opt/amarisoft/lte

root@orsXX:~# git clone https://lab.nexedi.com/jhuge/amarisoft-private.git
root@orsXX:~# mkdir -p /opt/amarisoft
root@orsXX:~# mv amarisoft-private/v2021-09-18 /opt/amarisoft/
root@orsXX:~# patchelf --set-rpath /opt/amarisoft/v2021-09-18/enb lteenb
root@orsXX:~# setcap cap_sys_nice=+pe lteenb
root@orsXX:~# patchelf --set-rpath /opt/amarisoft/v2021-09-18/enb lteenb-avx2
setcap cap_sys_nice=+pe lteenb-avx2
root@orsXX:~# sudo apt install ansible
root@orsXX:~# git clone https://lab.nexedi.com/nexedi/slapos.package

Prepare ORS for root access

root@orsXX:~# cd /var/www/html/
root@orsXX:/var/ww/html# git clone https://github.com/adolfintel/speedtest
root@orsXX:/var/ww/html# cd speedtest/
root@orsXX:/var/ww/html/speedtest# cp example-singleServer-gauges.html index.html
root@orsXX:/var/ww/html/speedtest# service apache2 restart

Soft reboot so that lte service starts

Scripts from ors-util

root@orsXX:~# git clone https://lab.nexedi.com/nexedi/ors-utils.git
root@orsXX:~# ln -s ors-utils/scripts scripts

Now you can follow the software part of Assembly Process