How to install Ubuntu on Netberg Aurora switches

The main repo:

https://github.com/netbergtw/files/tree/master/debian-bsps

Model-dependent repos:

Aurora 221

Aurora 610

Aurora 621

Aurora 710

Aurora 721

Aurora 750

Aurora 810

Aurora 830

OS installation:

We are going through a standard ONIE procedure.

Please wipe the drive clean if a NOS was installed.

Please refer to this article if ONIE is missing.

Ubuntu 24.04 installation

You can a get ready to use Ubuntu 24.04 ONIE image and user-data, meta-data, and vendor-data for the autoinstall proccess.

Install the OS with the onie-nos-install command from a remote or local source (remember to put the data files and Ubuntu installation ISO near the image).

 onie-nos-install http://192.168.0.4:8000/ubuntu-noble-amd64-mini-ONIE.bin

Also, you can redefine the ubuntu iso name and location with the following command:

 export os_iso_url=http://your.local.server/ubuntu-24.04.1-live-server-amd64.iso

Post-intallation steps:

Update repos:

 sudo apt update
 sudo apt upgrade
 sudo reboot

Install additional components:

 sudo apt install openssh-server build-essential git i2c-tools

Build optoe driver

 git clone https://github.com/netbergtw/oom.git --branch kern-68 --single-branch
 cd oom/optoe
 echo "ccflags-y := -DLATEST_KERNEL68" > Makefile
 echo "obj-m := optoe.o" >> Makefile
 make -C /lib/modules/$(uname -r)/build M=$(pwd) modules
 sudo make -C /lib/modules/$(uname -r)/build M=$(pwd) modules_install
 sudo depmod

Ubuntu 20.04 installation

You can make your own ONIE image with the preseed file (https://github.com/opencomputeproject/onie/blob/master/contrib/debian-iso/README.md)

or get a ready to use Ubuntu 20.04 image:

Ubuntu image and preseed file.

Install OS with the onie-nos-install command from a remote or local source (don’t forget to put debian-preseed.txt near the image).

onie-nos-install http://192.168.0.4:8000/ubuntu-focal-amd64-mini-ONIE.bin

During installation

Please unplug the USB drive if inserted or follow debian-preseed.txt

# Due notably to potential USB sticks, the location of the MBR can not be
# determined safely in general, so this needs to be specified:
#d-i grub-installer/bootdev  string /dev/sdb
# To install to the first device (assuming it is not a USB stick):
d-i grub-installer/bootdev  string default

Select the proper network device:

e.g. enp8s0: Intel Corporation I210 Gigabit Network Connection.

Agree to a weak password (onie/onie is the default user/password).

Post-intallation steps:

Update repos:

sudo apt update
sudo apt upgrade
sudo apt install --install-recommends linux-generic-hwe-20.04
sudo reboot

Install additional components:

apt install openssh-server build-essential git i2c-tools

Build optoe driver

git clone https://github.com/opencomputeproject/oom.git
cd oom/optoe
echo "ccflags-y := -DLATEST_KERNEL" > Makefile
echo "obj-m := optoe.o" >> Makefile
make -C /lib/modules/$(uname -r)/build M=$(pwd) modules
make -C /lib/modules/$(uname -r)/build M=$(pwd) modules_install
depmod

Model-dependent steps (using Aurora 710 as an example)

Install i2c_utils.sh

wget https://github.com/netbergtw/files/raw/master/debian-bsps/aurora-710/i2c_utils.sh -O /usr/sbin/i2c_utils.sh
chmod +x /usr/sbin/i2c_utils.sh

Init the switch

With this, you can initialize the switch i2c tree:

i2c_utils.sh i2c_init

There are a lot of useful i2c_utils.sh options.
Just execute it without parameters to show all of them.

Example of a simple systemd monitoring service

# wget https://github.com/netbergtw/files/raw/master/debian-bsps/aurora-710/aurora-710-monitor.service -O /etc/systemd/system/aurora-710-monitor.service
# wget https://github.com/netbergtw/files/raw/master/debian-bsps/aurora-710/aurora_710_monitor.sh -O /usr/sbin/aurora_710_monitor.sh
# chmod +x /usr/sbin/aurora_710_monitor.sh
# systemctl enable aurora-710-monitor

This script will automatically run during the system boot, start the i2c_init function, and control fans/LEDs.

P4 Studion installation on Aurora 750, 710, and 610

Please refer to our FTP for instructions.

Broadcom SDK installation on BCM-enabled systems

How to run OpenBCM SDK on Netberg Aurora switches.

For Broadcom SDK/HSDK installation, please contact our sales team.