Programmable Internetworking & Communication Operating System Docs ... Click Spaces -> Space Directory to see docs for all releases ...
Page tree
Skip to end of metadata
Go to start of metadata

Introduction

When using ONIE installer to install PICOS, the installer reinstalls the software, rebuilds all the PICOS file system. This can erase the configuration files and system logs from the previous installation. All the system files under /mnt/open/picos, including the configuration files, are removed. Because of this, the user needs to backup the configuration files before ONIE installation.

The new system will be installed under the directory /mnt/open/picos.

After ONIE installation is finished, the system files and configuration files are located indirectory /mnt/open/picos of the flash. A list and brief description of these files is as follows.

* uImage1.itb

* pica1.sqsh

* config1/backup_files

* config1/fresh_install

The installation methods used to install PICOS are first-time installing PICOS, traditional installation and nos-boot-mode installation. You can choose a suitable installation method that is convenient and appropriate for your installation environment.

  •   If you want to install PICOS through a non-console port (i.e. through the management port), refer to section Nos-boot-mode Installation.

The PICA8 PICOS software can be installed on any switch listed in the PicOS Hardware Compatibility List.

NOTE

    You need to log in through the console port of the switch and perform the ONIE installation.

  Other NOSes including user data will be removed when install PicOS under ONIE environment.

  Do not plug in the USB disk during onie-nos-installer process until ONIE starts up. If you have plugged in the USB disk before the installation operation, ONIE will find the installer on the USB disk when beginning the installation. On AS4610 series switches, when installation is complete, the installer will display: Please take out the usb disc, then remove the USB disk within 10 seconds after installation successful, and before machine restarts.

  N3048EP-ON and N3132PX do not support onie-uninstaller command.

  The image file of PICOS 3.7.0 and the later versions is a .bin file that can be used for both installation and upgrade, for example onie-installer-picos-s3048-3.7.0.bin. 

  The size of the image file is 230-250M.

  Use onie-nos-install to downgrade PICOS from 3.7.0 to 2.11.x. Before proceeding this, we first need to use ONIE to uninstall PICOS. On the ARM platform, execute the onie_uninstaller command at the ONIE prompt to uninstall the current version PICOS. On the x86 platform, select the "ONIE: Uninstall OS" option in the GRUB menu to uninstall the current version PICOS.

  When use USB for PICOS installation, USB can't be mounted to /mnt or /mnt/sd_card or /mnt/usb, which are reserved for pica8 itself. Users can manually create a new directory as a mount point, such as /media.

Installation Tools

What is U-Boot

Das U-Boot (Universal Boot Loader), or U-Boot for short, is an open source, primary boot loader developed for embedded systems. A boot loader is a computer program that loads the operating system or some other system software. U-Boot comes pre-installed as firmware on bare metal network switches.

What is ONIE 

ONIE (Open Network Install Environment) is an open source project of OCP (Open Compute Project). ONIE provides the environment to install any network operating system on a bare metal network switch. ONIE liberates users from captive pre-installed network operating systems, like the Cisco IOS, and provides them with a choice.

ONIE is a small Linux operating system that comes pre-installed as firmware on bare metal network switches. ONIE acts as an enhanced boot loader, extending the features provided by U-Boot. ONIE is used to install PICA8 PICOS on compatible switches. The bare metal switches listed in the PicOS Hardware Compatibility List must be pre-loaded with ONIE prior to installing PICOS.

First-time Installing PICOS

NOTE

You need to log in through the console port of the switch and perform the ONIE installation described in this section.

Step1         Make sure that the installation package of .bin file has been loaded to the server (server could be HTTP, TFTP, or an FTP server or the switch local directory according to the actual installation environment).

Step2         Enter Boot Main Menu. Power on the switch, when the Dell EMC Networking Boot Options menu appears, choose option “2” to enter Boot Main Menu.

Dell EMC Networking Boot Options
================================

Select a menu option within 3 seconds or the Operational Code will start

automatically...

1 - Start Operational Code
2 - Display Boot Menu

Select (1, 2)#2

Step3         Enter ONIE rescue mode. When Boot Main Menu appears, choose option “13” to enter ONIE rescue mode.

Boot Main Menu
==============

    1  - Start Operational Code
    2  - Select Baud Rate
    3  - Retrieve Logs
    4  - Load New Operational Code
    5  - Display Operational Code Details
    9  - Reboot
   10  - Restore Configuration to Factory Defaults
   11  - Activate Backup Image
   12  - Start Password Recovery
   13  - Boot ONIE (Rescue Mode)
   14  - Boot Diagnostics

Enter Choice# 13


NOTE

If no operation is performed, the system will boot to PICOS after 5 seconds.

 Step4         From the ONIE prompt, run onie-nos-install command as follows to install PICOS.

    • Install via TFTP
ONIE# onie-nos-install tftp://<path to image>/PicOS.bin
    • Install via FTP

                 When installing via FTP, you need to type username and password of the FTP server on which the image file is loaded.

ONIE# onie-nos-install ftp://username:password@<path to image>/PicOS.bin
    • Install via HTTP
ONIE# onie-nos-install http://<path to image>/PicOS.bin
    • Install via Local Directory

  a) In ONIE rescue mode, copy the image file to the current directory.

ONIE# scp username@<path to image>/PicOS.bin .

  b) Run onie-nos-install command to start installation.

ONIE# onie-nos-install PicOS.bin

                The installer runs and after finishing installation will reboot automatically, the system will come up running the new network operating system.

NOTE

  • After the system restarts, you need to enter the username and password, the initial login username is admin and password is pica8.
  • After the username and password are entered, user will be asked to choose a new password for admin. This is the only post installation step after which the PicOS operating system can be used.

Traditional Installation Process

NOTE

You need to log in through the console port of the switch and perform the ONIE installation described in this section.

Step1         Make sure that the installation package of .bin file has been loaded to the server (server could be HTTP, TFTP, or an FTP server or the switch local directory according to the actual installation environment).

Step2         Enter ONIE installation environment. Power on the switch, when Boot Main Menu appears, choose option “2” to enter ONIE rescue mode.

Boot Main Menu
====================
1 - Boot PICOS (DEFAULT)
2 - Boot ONIE (Rescue Mode)
3 - Boot Diagnostics
4 - Boot Dell EMC Networking System
Enter your choice (1,2,3,4): 2

NOTE

If no operation is performed, the system will boot to PICOS after 5 seconds.

 Step3        From the ONIE prompt, run onie-nos-install command as follows to install PICOS.

    • Install via TFTP
ONIE# onie-nos-install tftp://<path to image>/PicOS.bin
    • Install via FTP

                 When installing via FTP, you need to type username and password of the FTP server on which the image file is loaded.

ONIE# onie-nos-install ftp://username:password@<path to image>/PicOS.bin
    • Install via HTTP
ONIE# onie-nos-install http://<path to image>/PicOS.bin
    • Install via Local Directory

  a) In ONIE rescue mode, copy the image file to the current directory.

ONIE# scp username@<path to image>/PicOS.bin .

  b) Run onie-nos-install command to start installation.

ONIE# onie-nos-install PicOS.bin

                The installer runs and after finishing installation will reboot automatically, the system will come up running the new network operating system.

NOTE

  • After the system restarts, you need to enter the username and password, the initial login username is admin and password is pica8.
  • After the username and password are entered, user will be asked to choose a new password for admin. This is the only post installation step after which the PicOS operating system can be used.

Nos-boot-mode Installation

NOTE

The installation method described in this section applies to installation through either the console port or the management port.

The installation methods described in Traditional Installation Process must be performed through the console port. When you want to install the system through a non-console port, you can use the nos-boot-mode command to perform the installation which is described in this section.

Usage of nos-boot-mode command:

admin@Xorplus$sudo nos-boot-mode                            

USAGE

    install or uninstall NOS(es)

SYNOPSIS

    nos-boot-mode [install|uninstall]

DESCRIPTION

    install- Install NOS

uninstall- Remove all NOS(es) including PICOS

When nos-boot-mode install command is executed, PICOS will switch to ONIE install mode, and the user should go on to complete the subsequent installation. The steps for the manual installation process and the automatic installation process using the nos-boot-mode install command are described below.

When nos-boot-mode unsinstall command is executed, the system will remove all NOS(es) including PICOS from the device. Therefore, it is suggested to use the nos-boot-mode unsinstall command with caution.

Step1         Make sure that the installation package of .bin file has been loaded to the server (server could be HTTP, TFTP, or an FTP server or the switch local directory depending on the actual installation environment).

Step2         From the linux shell prompt, execute the nos-boot-mode install command to enter ONIE installation environment.

admin@Xorplus:~$ sudo nos-boot-mode install

Step3         Type “yes” when the below prompt is shown, which will take the system to ONIE installation environment.

Type 'yes' to install NOS!
Type 'no' to exit
[no]/yes: yes

Step4         From the ONIE prompt, run onie-nos-install command as follows to install PICOS.

    • Install via TFTP
ONIE# onie-nos-install tftp://<path to image>/PicOS.bin
    • Install via FTP

                 When installing via FTP, you need to type username and password of the FTP server on which the image file is loaded.

ONIE# onie-nos-install ftp://username:password@<path to image>/PicOS.bin
    • Install via HTTP
ONIE# onie-nos-install http://<path to image>/PicOS.bin
    • Install via Local Directory

  a) In ONIE rescue mode, copy the image file to the current directory.

ONIE# scp username@<path to image>/PicOS.bin .

  b) Run onie-nos-install command to start installation.

ONIE# onie-nos-install PicOS.bin

                The installer runs and after finishing installation will reboot automatically, the system will come up running the new network operating system.

NOTE

  • After the system restarts, you need to enter the username and password, the initial login username is admin and password is pica8.
  • After the username and password are entered, user will be asked to choose a new password for admin. This is the only post installation step after which the PicOS operating system can be used.

Verifying Version after Installation

Use the version command to check the version of the running system software.

admin@XorPlus$version

Copyright (C) 2009-2020 Pica8, Inc 
=================================== 
Hardware Model : N3048EP-ON
Linux System Version/Revision : 3.7.0.n3048.0/ad7caa9 
Linux System Released Date : 05/07/2020
L2/L3 Version/Revision : 3.7.0.n3048.0/ad7caa9 
L2/L3 Released Date : 05/07/2020
OVS/OF Version/Revision : 3.7.0.n3048.0/ad7caa9 
OVS/OF Released Date : 05/07/2020

  • No labels