Skip to content

Install OPX on Dell EMC ON series platforms

Jump to bottom
Amy Buck edited this page Dec 13, 2018 · 32 revisions

This information describes how to install OPX on Dell EMC Networking S3048-ON, S4048-ON/S4048T, S4128F-ON/S4128T-ON, S4148F-ON/S4148FE-ON, S4148T-ON, S6010-ON, and Z9100-ON platforms. See Hardware support for complete information.

The S6000-ON has reached end of life by Dell EMC Networking.

Requirements

  • Dell EMC Networking ONIE-enabled device with ONIE pre-installed
  • OPX ONIE installer binary
  • OPX image

Upgrading to OPX 2.2.0 must be done via ONIE. Release 2.3.0 and later supports upgrade the apt-get dist-upgrade command.

Before you start

Verify you have connected the ONIE-enabled device correctly:

1. Connect a serial cable/terminal emulator to the system Console port and set at 115200, 8 data bits, and no parity.

2. Connect the Management port to the network to install and/or download an OPX image.

The front panel ports that connect to the switching ASIC are not available in an ONIE installation.

See the Getting Started Guide shipped with your specific device to locate the Console and Management ports.

Install generic OPX image

When you power up the ONIE-enabled device, the boot menu is visible and accessible via the console:

  • Install OS — Installs an OPX image offering both zero-touch through DHCP or manual installation.
  • Rescue — Provides access to troubleshoot or re-install an ONIE image.
  • Uninstall OS — Deletes the contents of all disk partitions except ONIE.
  • Update ONIE — Installs a new ONIE image.
  • Embed ONIE — Formats an empty disk and installs ONIE.
  • Diag ONIE — Runs system diagnostics.

If you have a current OS installed on your ONIE-enabled device, use the Uninstall OS option before starting installation of the OPX image.

Automatic installation

You can automatically (zero-touch) install an OPX image using the ONIE discovery process. Before you start installation, ensure that the image file follows the naming convention required for ONIE auto-discovery. The image filename must start with the keyword "onie-installer".

See ONIE User Guide for complete ONIE information.

Manual installation

If the DHCP server not available, there are a number of other ways to install the OPX image. This information describes how to install an OPX image over a network.

To start installation, you need the IP address of the Management interface, along with the IP address and path of the ONIE image. If an IP address for the Management interface is not found when the switch boots, 192.168.3.10 is automatically assigned by default.

1. Store the OPX image on an HTTP/TFTP/FTP server.

2. Power up the switch and boot ONIE.

3. Select ONIE: Install for automatic-discovery or ONIE: Uninstall OS for manual installation.

4. Stop the ONIE discovery process if using manual installation.

$ onie-discovery-stop

5. Configure the Management port IP address. Once you configure the Management port, the response should be up.

$ ifconfig eth0 <ipaddress> netmask <mask>

6. (Optional) Configure the default gateway.

$ route add default gw <gateway-IP>
$ echo "nameserver 8.8.8.8" > /etc/resolv.conf

7. Install the OPX image on the switch.

$ onie-nos-install https://archive.openswitch.net/installers/x.x.x/Dell-EMC/PKGS_OPX-3.x.x.x-installer-x86_64.bin

Where x.x.x represents the location to download the image from, and 3.x.x.x represents the version number of the software to install.

The ONIE software automatically reboots the switch. You are now ready to install the OPX package.

USB installation

You can manually install the OPX software image using USB media. Verify that the USB storage device supports a FAT or EXT2 file system. Plug the USB storage device into the USB port on the device.

1. Power up the system to automatically boot with the ONIE: Rescue option.

2. (Optional) Stop the ONIE discovery process if the device boots to ONIE: Install.

onie-discovery-stop

3. Create a USB mount location on the system.

mkdir /mnt/media

4. Mount the USB media plugged into the USB port on the device.

mount —t vfat /dev/sdb /mnt/media

5. Install the software from the USB, where /mnt/media specifies the path where the USB partition is mounted.

onie-nos-install /mnt/media/image_file

The ONIE auto-discovery process discovers the image file at the specified USB path, loads the software image, and reboots.

OPX package repository

1. Add the OPX package repositories

echo "deb http://deb.openswitch.net/ 3.0.0 main opx opx-non-free" | sudo tee -a /etc/apt/sources.list
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys AD5073F1
sudo apt-get update

2. (Optional) Upgrade the pre-installed OPX package.

sudo apt-get dist-upgrade
sudo reload

3. Log into the switch with admin as the default username and password.

See OPX commands for specific Linux management command information.

© 2019 OpenSwitch project. All information is contributed to and made available by OPX under the Creative Commons Attribution 4.0 International License (available at http://creativecommons.org/licenses/by/4.0/).

Clone this wiki locally