Ubuntu 20.04 installation guide on Netberg switches

How to install Ubuntu on Netberg Aurora switches

The main repo:


Model-dependent repos:

Aurora 221

Aurora 610

Aurora 621

Aurora 710

Aurora 750

Aurora 810

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.

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).


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

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 the Netberg sales team.


Latest news