Setup Guide

ONIE installation instructions

This section describes the different methods to install ONIE on your switch.

NOTE: After installing the networking operating software (NOS) and diagnostics operating system (DIAG-OS), if you

boot into ONIE Install mode, ONIE assumes ownership of the system; ONIE Install mode is sticky. In this situation, ONIE

stays in Install mode until NOS and DIAG-OS are successfully installed again. If you want to boot into ONIE for any

reason other than installation, use Rescue mode or Update mode.

NOTE: To access ONIE, use the RJ45 console port or MicroUSB console port.

Topics:

• ONIE installation

• ONIE service discovery and OS installation

ONIE installation

The following steps describe how to load ONIE:

• Installing ONIE—these instructions use the universal serial bus (USB) method. To boot from a Linux USB, you must install the

preprogrammed BIOS on your platform.

• ONIE operates using a 115200 baud rate. Ensure that any equipment that is attached to the serial port supports the required 115200

baud rate.

NOTE: The following output examples are for reference only; your output may vary.

NOTE: The management port IP, FTP server IP address, MAC address, and user-id that is shown are for figure purpose

only. Use your system-applicable values.

ONIE service discovery and OS installation

ONIE attempts to locate the installer through several discovery methods.

To download and run an installer, the ONIE Service Discovery feature follows these steps in order and uses the first successful method

found:

1. Pass from the boot loader.

2. Search locally attached storage devices for one of the ONIE default installer filenames—for example, USB.

3. Discover the URLs from DHCPv4.

4. Report discovered URLs based on the DHCPv4 responses.

5. Query to the IPv6 link-local neighbors using HTTP for an installer.

6. Start TFTP waterfall—from the DHCPv4 option 66.

If none of the ONIE Service Discovery methods are successful, you can disable this using the onie-discovery-stop command.

You can install an operating system manually from HTTP, USB, FTP, or TFTP using the onie-nos-install <URL> command.

NOTE:

If you have a recovery USB plugged into your system, you must remove it before using the onie-nos-install

<URL> command.

The ONIE Install environment uses DHCP to assign an IP address to the management interface, eth0. If that fails, it uses the link-local

IPv4 address 169.254.209.190/16.

To display the IP address, use the ifconfig eth0 command, as shown:

ONIE:/ # ifconfig eth0

eth0 Link encap:Ethernet HWaddr 90:B1:1C:F4:9C:76

ONIE installation instructions 9