Versions Compared

Version Old Version 1 New Version 2
Changes made by

Tracy Yang

Tracy Yang

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

After a successful ONIE installation of PICOS 34.7.0x, the system generates multiple system partitions including PicOS (partition size: 2G), PicOS2 (partition size: 2G) and User-Data partitions. Among them, PicOS and PicOS2 are two independent system boot partitions. One of them is the active partition on which the running system resides, and the other is the inactive partition. The two-system-boot-partition feature allows the system to revert to a previous version of the installed software package when the it fails to upgrade PICOS by using upgrade2 command.

The ONIE installer removes all partitions to rebuild a brand new OS only when there is no User-Data partition. However, if there exists a User-Data partition (for example, install a new version 34.70.1 from the old one 34.70.0), the ONIE installer only rewrites the "PicOS" partition, installs the new installation package to this partition and sets the system on "PicOS" partition as the default and sole boot system.

...

This document describes how to install PICOS 34.7.0 x software using ONIE installer. 

Installation Notes and Tools 

The installation methods used to install a new PICOS are 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 the PICOS through a non-console port (through the management port), refer to section Nos-boot-mode Installation.
Warning

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

•  When the ONIE installer is used to downgrade the PICOS version from version 34.7.0 x to PICOS 23.11 x or lower versions, we first need to use ONIE to uninstall the higher version PICOS before proceeding with installing PICOS 23.11 x or a lower version. 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.

•  If you enter GRUB rescue mode and the switch has GPT format partition, you can use the following commands to reset the GRUB boot variable to enter ONIE GRUB and then install PICOS.

grub rescue> set prefix=(hd0,gpt2)/grub 
grub rescue> set root=(hd0,gpt2) 
grub rescue> insmod normal 
grub rescue> normal

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

•  All X86 platforms share one installation and upgrade package with the name fixed as: onie-installer-picos-VERSION-x86.bin, where VERSION is the release version. X86 platform are listed below:

•  Edgecore AS4630-54PE
•  Edgecore AS5712-54X 
•  Edgecore AS5812-54T
•  Edgecore AS5812-54X
•  Edgecore AS7312-54X
•  Edgecore AS7326-56X
•  Edgecore AS7712-32X
•  Edgecore AS7726-32X
•  Edgecore AS7816-64X

•  Edgecore AS5835-54X

•  DELL N3248P-ON
•  DELL N3248PXE-ON
•  DELL N3224PX-ON
•  DELL N3248X-ON
•  DELL S4048-ON
•  DELL S4148F-ON
•  DELL S4148T-ON
•  DELL S4128F-ON
•  DELL S5224F-ON
•  DELL S5296F-ON  

•  DELL S5212F-ON

•  DELL S5248F-ON

•  DELL Z9100-ON

•  DELL Z9264F-ON

•  DELL N3224T-ON

•  DELL S4128T-ON

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

ON

•  DELL Z9264F-ON

•  DELL N3224T-ON

•  DELL S4128T-ON


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.

Anchor
traditional_install
traditional_install
Traditional Installation

NOTE：

  •   You need to log in through the console port of the switch and perform the ONIE installation described in this section.
  •   The installation method described in this section only applies to platforms that have pre-installed ONIE.

Mind Map of Installation Process

Figure1 shows the mind map of PICOS installation process.

Figure1 Mind Map of PICOS installation process

Image RemovedImage Added

Manual Installation Process

...

Step2       Enter ONIE installation environment. The process is different on the following two types of platforms:

    • Anchor
      p1
      p1
      ARM Platforms (AS4610 Series Switches)
Section
Column

a)

Column

Verify that the switch is pre-loaded with ONIE, which will be used to load PICOS on the switch. Power on the switch and interrupt the boot sequence by pressing any key when the following line is shown:

...

Code Block
ONIE:/ # onie-nos-install onie-installer-picos-34.70.0-x86.bin
discover: Rescue mode detected. No discover stopped.
ONIE: Executing installer: onie-installer-picos-34.70.0-875b786bd2-x86.bin
Verifying image checksum ... OK.
Preparing image archive ... OK.
  [1]  PICOS L2/L3 (default)
  [2]  PICOS Open vSwitch/OpenFlow
Enter your choice (1,2):1
PICOS L2/L3 is selected.
ONIE installation will overwrite the configuration file of existing system.
It is recommended to follow the upgrade procedure to upgrade the system.
Press any key to stop the installation...
10 9 8 7 6 5 4 3 2 1 ...

...

After finishing installation, the device reboots automatically, the system then comes 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.

Automatic Installation Process

...


Step2         Install PICOS via ONIE. The process is different on the following two types of platforms:

    • Anchor
      p2
      p2
      ARM Platforms (AS4610 Series Switches)

...

Code Block
LOADER -> run onie_bootcmd
Loading Open Network Install Environment ...
Platform: arm-accton_as4610_54-r0
Version : 20202021.09.00.03
WARNING: adjusting available memory to 30000000
## Booting kernel from Legacy Image at 02000000 ...
Image Name: as4610_54x.1.6.1.3
Image Type: ARM Linux Multi-File Image (gzip compressed)
Data Size: 3514311 Bytes = 3.4 MiB
Load Address: 00000000
Entry Point: 00000000
Contents:
Image 0: 2762367 Bytes = 2.6 MiB
Image 1: 733576 Bytes = 716.4 KiB
Image 2: 18351 Bytes = 17.9 KiB
Verifying Checksum ... OK
## Loading init Ramdisk from multi component Legacy Image at 02000000 ...
## Flattened Device Tree from multi component Image at 02000000
Booting using the fdt at 0x02355858
Uncompressing Multi-File Image ... OK
Loading Ramdisk to 2ff4c000, end 2ffff188 ... OK
Loading Device Tree to 03ff8000, end 03fff7ae ... OK
Cannot reserve gpages without hugetlb enabled
setup_arch: bootmem
as4610_54x_setup_arch()
arch: exit

pci 0000:00:00.0: ignoring class b20 (doesn't match header type 01)
sd 0:0:0:0: [sda] No Caching mode page present
sd 0:0:0:0: [sda] Assuming drive cache: write through
sd 0:0:0:0: [sda] No Caching mode page present
sd 0:0:0:0: [sda] Assuming drive cache: write through
sd 0:0:0:0: [sda] No Caching mode page present
sd 0:0:0:0: [sda] Assuming drive cache: write through
ONIE: Using DHCPv4 addr: eth0: 192.168.2.77 / 255.255.255.0
discover: installer mode detected. Running installer.
Please press Enter to activate this console. ONIE: Using DHCPv4 addr: eth0: 192.168.2.77 / 255.255.255.0
ONIE: Starting ONIE Service Discovery
ONIE: Executing installer: http://192.168.2.42/PicOS-4610-16656.bin
Verifying image checksum ... OK.
Preparing image archive ... OK.
PicOS installation
..............................................
./var/local/
./var/run
Setup PicOS environment ...
..............................................
XorPlus login: admin
Password: 
You are required to change your password immediately (root enforced)
Changing password for admin.
(current) UNIX password: 
Enter new UNIX password: 
Retype new UNIX password:
admin@XorPlus$

...

                  The installer runs and will reboot the system after installation is complete.

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.

Anchor
nos_boot_mode
nos_boot_mode
Nos-boot-mode Installation

NOTE：

  •   The installation method described in this section applies to installation through both the console port and the management port.
  •   The installation method described in this section only applies to platforms that have pre-installed ONIE.

The installation methods described in Traditional Installation must be performed through the console port. If 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.

Manual Installation Process

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

...

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

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

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

Step4         Run onie-nos-install command as follows to manually install PICOS.

...

Code Block
ONIE# onie-nos-install http://<path to image>/PICOS.bin
    •   Install from Local Directory

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

...

Code Block
ONIE:/ # onie-nos-install onie-installer-picos-34.70.0-x86.bin
discover: Rescue mode detected. No discover stopped.
ONIE: Executing installer: onie-installer-picos-34.70.0-875b786bd2-x86.bin
Verifying image checksum ... OK.
Preparing image archive ... OK.
  [1]  PICOS L2/L3 (default)
  [2]  PICOS Open vSwitch/OpenFlow
Enter your choice (1,2):1
PICOS L2/L3 is selected.
ONIE installation will overwrite the configuration file of existing system.
It is recommended to follow the upgrade procedure to upgrade the system.
Press any key to stop the installation...
10 9 8 7 6 5 4 3 2 1 ...

...

After finishing installation, the device reboots automatically, the system then comes 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.

Automated Installation Process

...

              b)  Check if the .bin installation file is loaded onto the HTTP server:

Code Block
root@dev:/var/www# ls
index.html onie-installer-powerpc.bin

Step2         Execute the nos-boot-mode install command to enter ONIE installation environment.

Code Block
admin@Xorplus$ sudo nos-boot-mode install

Step3         Type “yes” when the below prompt is shown, and the system will automatically complete the installation.

...

              The installer runs automatically and will reboot the system after installation is completed.

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

After system reboots automatically, the system will come up running the new network operating system.

Code Block
admin@XorPlus$versionadmin@Xorplus:~$ version
Copyright (C) 2009-20202021 Pica8, Inc.
===================================
Hardware Model                : as7312_54x
Linux System Version/Revision    : 34.70.01/4b5f523cc8d268
Linux System Released Date       : 5/2018/20202021
L2/L3 Version/Revision           : 34.70.01/4b5f523cc8d268
L2/L3 Released Date              : 5/2018/20202021
OVS/OF Version/Revision         : 34.70.01/4b5f523cc8d268
OVS/OF Released Date           : 5/2018/20202021