Edgecore Networks Corporation

END USER LICENSE AGREEMENT

LEASE READ THIS END USER LICENSE AGREEMENT (THE “AGREEMENT”) CAREFULLY BEFORE USING SOFTWARE FROM EDGECORE. BY USING EDGECORE SOFTWARE (THE “SOFTWARE”), YOU SIGNIFY YOUR ASSENT TO AND ACCEPTANCE OF THIS END USER LICENSE AGREEMENT AND ACKNOWLEDGE YOU HAVE READ AND UNDERSTAND THE TERMS. AN INDIVIDUAL ACTING ON BEHALF OF AN ENTITY REPRESENTS THAT HE OR SHE HAS THE AUTHORITY TO ENTER INTO THIS END USER LICENSE AGREEMENT ON BEHALF OF THAT ENTITY. IF YOU DO NOT ACCEPT THE TERMS OF THIS AGREEMENT, THEN YOU MUST NOT USE THE SOFTWARE. THIS END USER LICENSE AGREEMENT DOES NOT PROVIDE ANY RIGHTS TO EDGECORE SERVICES SUCH AS SOFTWARE MAINTENANCE, UPGRADES OR SUPPORT. PLEASE REVIEW YOUR SERVICE OR SUBSCRIPTION AGREEMENT(S) THAT YOU MAY HAVE WITH EDGECORE OR OTHER AUTHORIZED EDGECORE SERVICE PROVIDERS REGARDING SERVICES AND ASSOCIATED PAYMENTS.

1) Trademarks:

Edgecore, regardless of capital or lower case, is a registered trademark of Edgecore Networks Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners. Protected trademarks are not marked as such herein. This does not mean, however that they may be used freely.

2) License grant:

"SOFTWARE” means the software contained in this package and any subsequent versions or upgrades received as a result of having down loaded this package. Edgecore grants YOU a license to use one copy of the version of this SOFTWARE only on a single Edgecore hardware. "YOU" or “BUYER” means a company, an entity or an individual taken as the original purchaser of the SOFTWARE. "USE" means storing, loading, installing, executing or displaying the SOFTWARE. YOU may not modify the SOFTWARE or disable any licensing or control features of the SOFTWARE except as an intended part of the SOFTWARE's programming features. This license is not transferable to any other company, entity or individual. YOU may not publish any registration information (serial numbers, registration keys, etc.) or pass it to any other company, entity or individual. BUYER may not electronically transfer the program from one Edgecore hardware to the other devices over any type of network. BUYER may not distribute copies of the SOFTWARE or the accompanying documentation to others either for a fee or without charge. BUYER may not modify or translate the SOFTWARE or documentation. BUYER may not disassemble the SOFTWARE or allow it to be disassembled into its constituent source code. BUYER's use of the SOFTWARE indicates his/her acceptance of these terms and conditions. If BUYER does not agree to these conditions, return the distribution media, documentation, and associated materials to the vendor from whom the SOFTWARE was obtained, and erase the SOFTWARE from any and all storage devices upon which it may have been installed.

3) Open Source Software:

Certain components of the SOFTWARE may incorporate “open source” software. To the extent required by an Open Source License that applies to Open Source Software included in or provided with the Software: (a) the terms of such Open Source License will apply to such Open Source Software instead of the terms of the license grant in this Agreement; and (b) any restrictions prohibited by such Open Source License that are contained in this Agreement will not apply to such Open Source Software. Notwithstanding the foregoing, SONiC is an open source Network Operating System (NOS) project and all the open source components and links to associated source code are available on the github at https://github.com/Azure/SONiC. The github will continuously get updated as the community adds new open source components to SONiC. Details are available on the Edgecore Networks Corporation, website (www.edge-core.com).

4) Ownership and Copyright:

The SOFTWARE is owned and copyrighted by Edgecore or Edgecore’s licensors. Your license confers no title or ownership of the SOFTWARE and should not be construed as a sale of any rights for the SOFTWARE. YOU acknowledge that the title and full ownership rights to the SOFTWARE will remain the exclusive property of Edgecore or Edgecore’s licensors and YOU will not acquire any rights to the SOFTWARE except as expressly set forth in this license. YOU agree that any copies of the SOFTWARE will contain the same proprietary notices which appear on and in the SOFTWARE.

5) Unauthorized Use:

YOU affirm that YOU will not attempt to reverse compile, modify, translate, or disassemble the SOFTWARE in whole or in part. It is strictly prohibited for YOU to use copy, rent, lease, sell, modify, decompile, disassemble, otherwise reverse engineer, or transfer the SOFTWARE except as provided in this Agreement. Any such unauthorized use shall result in immediate and automatic termination of this Agreement.

6) No Warranties:

This SOFTWARE is provided on an "AS IS" basis. Edgecore disclaims all warranties relating to this SOFTWARE, whether expressed or implied, including but not limited to any implied warranties of merchantability, non-infringement or fitness for a particular purpose. Neither Edgecore nor anyone else who has been involved in the creation, production, or delivery of this SOFTWARE shall be liable for any indirect, consequential, or incidental damages arising out of the use or inability to use such SOFTWARE, even if Edgecore has been advised of the possibility of such damages or claims. The person using the SOFTWARE bears all risk as to the quality and performance of the SOFTWARE. Some jurisdictions may not allow the exclusion of implied warranties or limitations on how long an implied warranty may last, or the exclusion or limitation of incidental or consequential damages, so that the above given limitations or exclusions may not apply to YOU.

7) Limited Liability:

BUYER acknowledges that the SOFTWARE may not be free from defects and may not satisfy all of BUYER's needs. Edgecore warrants all media on which the SOFTWARE is distributed for 90 days to be free from defects in materials and workmanship under normal use. The SOFTWARE and any accompanying written materials are licensed "AS IS". BUYER's exclusive remedy during the warranty period shall consist of replacement of distribution media if determined to be faulty. In no event will Edgecore be liable for direct, indirect, incidental or consequential damage or damages resulting from loss of use, or loss of anticipated profits resulting from any defect in the program, even if it has been advised of the possibility of such damage. In no event will Edgecore's liability for any claim, whether in contract, tort or any other theory of liability, exceed the aggregate amount paid by YOU for the SOFTWARE.

8) Compliance with laws:

Each party agrees to comply with all applicable laws, rules and regulations in connection with its activities under this Agreement. Without limiting the foregoing, YOU acknowledge and agrees that the Software, including technical data, is subject to United States export control laws, including the United States Export Administration Act and its associated regulations, and may be subject to export or import regulations in other countries. End User agrees to comply strictly with all such regulations and acknowledges that End User has the responsibility to obtain licenses to export, re-export, or import the SOFTWARE.

9) Termination:

Without prejudice to any other rights, Edgecore may immediately terminate this license without notice if YOU fail to comply with any terms and conditions of this Agreement. In such event, YOU must: 1. Cease all use of the SOFTWARE; 2. Destroy or return to Edgecore the original and all copies of the SOFTWARE; and 3. Delete the SOFTWARE from all Edgecore hardware on which it was resident. All disclaimers of warranties and limitation of liability set forth in this Agreement shall survive termination of this Agreement.

10) Governing Law and Jurisdiction:

This Agreement shall be governed by the laws of California, USA, excluding its conflict of law provisions. To the extent permitted by law, any Dispute any dispute arising out of or relating to this Agreement shall be subject to the exclusive jurisdiction of the state and federal courts located in Orange County, California, USA.

11) General:

This Agreement represents the complete agreement between YOU and Edgecore relating to this license for the SOFTWARE and supersedes all prior agreements, communications, proposals and representations between the parties and prevails over any conflicting or additional terms of any quote, order, acknowledgement or similar communication. This Agreement may only be modified by a written document signed by both parties. If any provision of this Agreement is held by a court of competent jurisdiction to be contrary to law that provision will be enforced to the maximum extent permissible and the remaining provisions of this Agreement will remain in full force and effect. All rights not expressly granted herein are reserved to Edgecore Networks Corporation.

[Enterprise SONiC] Installation & Upgrade image Follow

andyyl_chen 陳英倫

November 05, 2024 05:24
Updated

How to install SONiC images, how to upgrade, how to set start-up image when you have multiple images in your device and how to remove the image you don't need.

Install SONiC from HTTP or TFTP via ONIE
Install SONiC from USB via ONIE
Edgecore SONiC Upgrade
Edgecore SONiC Upgrade via USB
Specified the startup image
Remove installed image

Tested model & firmware version:

Switch model name:

AS7326-56X

Edgecore SONiC version:

202006.4

202012.0~202012.7

202111.0~202111.8

Restriction:

Suggest you should not install different branch SONiC image on switch, it may cause some exception issue.
If your switch installed SONiC, you login to "ONIE :install OS" mode via grub, it will let the grub miss SONiC option. After 202111.3, default login onie will be resued mode. It avoid grub miss SONiC option

Install SONiC from HTTP or TFTP via ONIE

Topology:

Procedure:

Step 1. Enter the ONIE install mode

Note: Switch shall automatically enter the ONIE install mode if there's no NOS installed yet.

                          GNU GRUB  version 2.02
 
+----------------------------------------------------------------------------+
|*ONIE: Install OS                                                           |
| ONIE: Rescue                                                               |
| ONIE: Uninstall OS                                                         |
| ONIE: Update ONIE                                                          |
| ONIE: Embed ONIE                                                           |
| DIAG: Accton Diagnostic (accton_as7326_56x)                                |
|                                                                            |
|                                                                            |
|                                                                            |
|                                                                            |
|                                                                            |
|                                                                            |
+----------------------------------------------------------------------------+
 
     Use the ^ and v keys to select which entry is highlighted.
     Press enter to boot the selected OS, `e' to edit the commands
     before booting or `c' for a command-line.
  The highlighted entry will be executed automatically in 2s.

Caution:

Since switch will automatically start the ONIE Service Discovery, this command can make user types easily.

This is not a necessary command. It won't affect installation no matter user execute it or not.

ONIE:/ # onie-discovery-stop
discover: installer mode detected.
Stopping: discover... done.

Step 2. Setup the ip address binding to switch management port

ONIE:/ # ifconfig eth0 192.168.1.2 netmask 255.255.255.0

Caution: Default ONIE will get ip from DHCP

Step 3. Install the image from remote URL via HTTP or TFTP

ONIE:/ # onie-nos-install tftp://192.168.1.1/Edgecore-SONiC_20231127_051854_ec202111_657.bin

If the installation is successful, the device will reboot automatically and boot-up with SONiC.

After finish the installation, user might need to check this article.

1. Username and Password

2. ecSONiC License Installation (License is no longer required from SONiC.Edgecore-SONiC 201911.2 2020 Aug version and later)

Install SONiC from USB via ONIE

Restriction:

The ONIE don't support NTFS file system.

Topology:

Procedure:

Step 1. Copy Edgecore SONiC installer file to USB flash drive with a name "onie-installer".

Step 2. Reboot switch and plug in USB drive to switch

Step 3. Enter ONIE install mode

                          GNU GRUB  version 2.02
 
+----------------------------------------------------------------------------+
|*ONIE: Install OS                                                           |
| ONIE: Rescue                                                               |
| ONIE: Uninstall OS                                                         |
| ONIE: Update ONIE                                                          |
| ONIE: Embed ONIE                                                           |
| DIAG: Accton Diagnostic (accton_as7326_56x)                                |
|                                                                            |
|                                                                            |
|                                                                            |
|                                                                            |
|                                                                            |
|                                                                            |
+----------------------------------------------------------------------------+
 
     Use the ^ and v keys to select which entry is highlighted.
     Press enter to boot the selected OS, `e' to edit the commands
     before booting or `c' for a command-line.
  The highlighted entry will be executed automatically in 2s.

Step 4. Wait for ONIE to discover USB and start automatically uploading new firmware via USB drive.

ONIE: Starting ONIE Service Discovery
Info: Attempting file://dev/sdb1/onie-installer-x86_64-accton_as7326_56x-r0 ...
Info: Attempting file://dev/sdb1/onie-installer-x86_64-accton_as7326_56x-r0.bin ...
Info: Attempting file://dev/sdb1/onie-installer-x86_64-accton_as7326_56x ...
Info: Attempting file://dev/sdb1/onie-installer-x86_64-accton_as7326_56x.bin ...
Info: Attempting file://dev/sdb1/onie-installer-accton_as7326_56x ...
Info: Attempting file://dev/sdb1/onie-installer-accton_as7326_56x.bin ...
Info: Attempting file://dev/sdb1/onie-installer-x86_64-bcm ...
Info: Attempting file://dev/sdb1/onie-installer-x86_64-bcm.bin ...
Info: Attempting file://dev/sdb1/onie-installer-x86_64 ...
Info: Attempting file://dev/sdb1/onie-installer-x86_64.bin ...
Info: Attempting file://dev/sdb1/onie-installer ...
Info: Attempting file://dev/sdb1/onie-installer.bin ...
Info: Attempting file://dev/sdb/onie-installer-x86_64-accton_as7326_56x-r0 ...
Info: Attempting file://dev/sdb/onie-installer-x86_64-accton_as7326_56x-r0.bin ...
Info: Attempting file://dev/sdb/onie-installer-x86_64-accton_as7326_56x ...
Info: Attempting file://dev/sdb/onie-installer-x86_64-accton_as7326_56x.bin ...
Info: Attempting file://dev/sdb/onie-installer-accton_as7326_56x ...
Info: Attempting file://dev/sdb/onie-installer-accton_as7326_56x.bin ...
Info: Attempting file://dev/sdb/onie-installer-x86_64-bcm ...
Info: Attempting file://dev/sdb/onie-installer-x86_64-bcm.bin ...
Info: Attempting file://dev/sdb/onie-installer-x86_64 ...
Info: Attempting file://dev/sdb/onie-installer-x86_64.bin ...
Info: Attempting file://dev/sdb/onie-installer ...
Info: Attempting file://dev/sdb/onie-installer.bin ...
ONIE: Executing installer: file://dev/sdb1/onie-installer.bin
Verifying image checksum ... OK.
Preparing image archive ... OK.
Installing SONiC in ONIE
ONIE Installer: platform: x86_64-broadcom-r0
onie_platform: x86_64-accton_as7326_56x-r0

If the installation is successful, the device will reboot automatically and boot-up with SONiC.

After finish the installation, user might need to check this article.

1. Username and Password

2. ecSONiC License Installation (License is no longer required from SONiC.Edgecore-SONiC 201911.2 2020 Aug version and later)

Edgecore SONiC Upgrade

Restriction:

If the switch have different branch image, please reset configuration in new image. (Detail refer the section of “Installation / Upgrade” in release note)

Username/password will not be migrated after upgrading SONiC version.

(Starting from versions 202111.10 and 202211.3, the username and password will be migrated to the newly installed image. Please note that this migration only takes effect when upgrading from one supported version to another.)

Topology:

Step 1. Check the image

admin@sonic:~$ sudo sonic-installer list
Current: SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
Next: SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
Available:
SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575

Step 2. Set the manangement IP (Refer to Management and front port IPv4/IPv6 Address)

admin@sonic:~$ sudo config interface ip add eth0 192.168.1.2/24

Step 3. Upgrade image from remote HTTP server

admin@sonic:~$ sudo sonic_installer install http://192.168.1.1/Edgecore-SONiC_20231127_051854_ec202111_657.bin -y

Caution:

It could only use HTTP to upgrade.
If the current switch configuration include "management vrf" and the http server connect to management port, please do update via "ip vrf exec mgmt" command as bellowing.

admin@sonic:~$ sudo ip vrf exec mgmt sonic_installer install http://192.168.1.3/Edgecore-SONiC_20231127_051854_ec202111_657.bin -y

Step 4. Check the images.

admin@sonic:~$ sudo sonic-installer list
Current: SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
Next: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Available:
SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657

Note: The "Next" boot-up image shall be set with new image automatically.

Step 5. Reboot device

admin@sonic:~$ sudo reboot

Step 6. Check the images status

admin@sonic:~$ sudo sonic-installer list
Current: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Next: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Available:
SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657

Edgecore SONiC Upgrade via USB

Restriction:

SONiC doesn't support the filesystem type 'NTFS'.

Username/password will not be migrated after upgrading SONiC version

root@SWL:/mnt# mount /dev/sdb1 /mnt/test
mount: /mnt/test: unknown filesystem type 'ntfs'.

Topology:

Procedure:

Step 1: Confirm the position of the USB.

root@sonic:~# fdisk -l
Disk /dev/sda: 59.6 GiB, 64023257088 bytes, 125045424 sectors
Disk model: TS64GMTS400     
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: gpt
Disk identifier: CADCD667-AE6B-4F9F-8969-A00D3ADBDBC0

Device       Start      End  Sectors  Size Type
/dev/sda1     2048   526335   524288  256M EFI System
/dev/sda2   526336   788479   262144  128M ONIE boot
/dev/sda3   788480  1050623   262144  128M Linux filesystem
/dev/sda4  1050624 68159487 67108864   32G Linux filesystem


Disk /dev/loop0: 405 MiB, 424693760 bytes, 829480 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes


Disk /dev/loop1: 4 GiB, 4294967296 bytes, 8388608 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes


Disk /dev/sdb: 3.8 GiB, 4043309056 bytes, 7897088 sectors
Disk model: USB Flash Drive 
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: dos
Disk identifier: 0x94723316

Device     Boot Start     End Sectors  Size Id Type
/dev/sdb1       128 7897087 7896960  3.8G  c W95 FAT32 (LBA)

Step 2: Create a folder and mount the USB to the folder that you create.

root@sonic:~# mkdir /mnt/test
root@sonic:~# mount /dev/sdb1 /mnt/test
root@sonic:~# cd /mnt/test
root@sonic:/mnt/test# ls
Edgecore-SONiC_20231127_051854_ec202111_657.bin

Step 3: Upgrade image from the USB

root@sonic:/mnt/test# sudo sonic_installer install /mnt/test/Edgecore-SONiC_20231127_051854_ec202111_657.bin
Warning: 'sonic_installer' command is deprecated and will be removed in the future
Please use 'sonic-installer' instead
New image will be installed, continue? [y/N]: y

Step 4: Check the images.

root@sonic:/mnt/test# sudo sonic-installer list
Current: SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
Next: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Available:
SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657

Step 5. Reboot device

admin@sonic:~$ sudo reboot

Specified the startup image

Procedure:

Step 1. Check the images status

admin@sonic:~$ sudo sonic_installer list
Current: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Next: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Available:
SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575

Caution:

"Current" image, it mean the running image
"Next" image, it mean the next boot up image.
"Available" images, it mean installed SONiC images.

Step 2. Change the default boot-up image

admin@sonic:~$ sudo sonic_installer set_default SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
Command: grub-set-default --boot-directory=/host 1

Step 2. Check the image status

admin@sonic:~$ sudo sonic_installer list
Current: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Next: SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
Available: 
SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575

Then the "Next" boot-up image changed.

Caution:

You can choose the boot-up image in GRUB menu directly, but this way won't change the default boot-up image.

Remove installed image

Procedure:

Step 1. Check the images status

admin@sonic:~$ sudo sonic-installer list
Current: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Next: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Available:
SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575
SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657

Step 2. Remove the image

admin@sonic:~$ sudo sonic-installer remove SONiC-OS-Edgecore-SONiC_20231006_073817_ec202111_575 -y
Updating GRUB...
Done
Removing image root filesystem...
Done
Command: grub-set-default --boot-directory=/host 0
 
Image removed

Step 3. Check the images status

admin@sonic:~$ sudo sonic-installer list
Current: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Next: SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657
Available:
SONiC-OS-Edgecore-SONiC_20231127_051854_ec202111_657

Comments

0 comments

Please sign in to leave a comment.

Category

[Enterprise SONiC] Installation & Upgrade image Follow

Tested model & firmware version:

Restriction:

Install SONiC from HTTP or TFTP via ONIE

Topology:

Procedure:

Install SONiC from USB via ONIE

Restriction:

Topology:

Procedure:

Edgecore SONiC Upgrade

Restriction:

Topology:

Edgecore SONiC Upgrade via USB

Restriction:

Procedure:

Specified the startup image

Procedure:

Remove installed image

Procedure:

Comments

Articles in this section

Edgecore Networks Corporation

END USER LICENSE AGREEMENT

1) Trademarks:

2) License grant:

3) Open Source Software:

4) Ownership and Copyright:

5) Unauthorized Use:

6) No Warranties:

7) Limited Liability:

8) Compliance with laws:

9) Termination:

10) Governing Law and Jurisdiction:

11) General:

Category

Tested model & firmware version:

Restriction:

Install SONiC from HTTP or TFTP via ONIE

Topology:

Procedure:

Install SONiC from USB via ONIE

Restriction:

Topology:

Procedure:

Edgecore SONiC Upgrade

Restriction:

Topology:

Edgecore SONiC Upgrade via USB

Restriction:

Procedure:

Specified the startup image

Procedure:

Remove installed image

Procedure:

Related articles

Articles in this section