Versions Compared

Key

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

Table of Contents

...

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

•  PICOS 4.x is only supported on X86 platform.

  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 4.x to PICOS 3.x or lower versions, we first need to use ONIE to uninstall the higher version PICOS before proceeding with installing PICOS 3.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

...

Code Block
LOADER -> run onie_bootcmd
Loading Open Network Install Environment ...
Platform: arm-accton_as4610_54-r0
Version : 2021.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-16656onie-installer-picos-4.0.0-x86.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$

...

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
ONIE:/ # onie-nos-install onie-installer-picos-4.0.0-x86.bin
discover: Rescue mode detected. No discover stopped.
ONIE: Executing installer: onie-installer-picos-4.0.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 ...

...

Code Block
host pica8-3922 {
hardware ethernet 70:72:cf:12:34:56;
fixed-address 192.168.2.50;
option default-url = "http://192.168.2.42/onie-installer-powerpc-picos-4.0.0-x86.bin";
}

              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-picos-4.0.0-x86.bin

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

...

Code Block
admin@Xorplus:~$ version
Copyright (C) 2009-2021 Pica8, Inc.
===================================
Hardware Model                : as7312_54x
Linux System Version/Revision    : 4.0.10/cc8d268
Linux System Released Date       : 5/18/2021
L2/L3 Version/Revision           : 4.0.10/cc8d268
L2/L3 Released Date             : 5/18/2021
OVS/OF Version/Revision         : 4.0.10/cc8d268
OVS/OF Released Date           : 5/18/2021