System Backup and Restore from USB Commands

Overview

The System Backup and Restore from USB feature creates a backup of the system configuration or the complete system image and stores it on a USB storage device. The backup operation requires a mounted USB drive and a cached software installer in the /installers directory.

If either prerequisite is missing, the backup operation fails.

Prerequisites

• Before starting the backup procedure, complete the following tasks:
• Connect a supported USB storage device to the system.
• USB Drive should be FAT32 format.
• Verify that the software installer used to boot the system is available in the /installers directory.
• Log in to the OcNOS CLI with administrative privileges.

USB System Backup

1. Configure the system USB backup option.
Copy 
OcNOS(config)#system usb backup ?
all     Backup config + installer + local license
config  Backup config only
There are Two Options; Option 1: Backup All > this would require us to cache the image in the installers directory if not present or else the backup will fail to the USB with the following error;
Refer step 3 to cache the image.
Enter configuration commands, one per line.  End with CNTL/Z.
OcNOS(config)#system usb backup all
OcNOS(config)#commit
OcNOS(config)#end
OcNOS#
OcNOS#
OcNOS#wr
Building configuration...
System USB backup in-progress...
% Error: Unable to find OcNOS-SP-PLUS-Q2-7.0.1-60-MR-installer
in /installers folder
Use command 'sys-update get <url>' to get the installer in /installers folder
Use command 'show installers' command to find the available installers
% Error: System USB backup failed !!!
OcNOS#
OcNOS#
2. Verify that the running software installer is available in the /installers directory.
Copy 
OcNOS# show installers
3. If the installer is not available, download or cache the installer.
Copy 
OcNOS# sys-update get <installer_url>
4. The backup config option does not require the software image to be cached.
  • Execute the write-memory command to start the backup operation. OcNOS automatically mounts the USB drive during the backup process.
Copy 
OcNOS(config)#system usb backup config
OcNOS(config)#commit
OcNOS(config)#end
OcNOS#
OcNOS#
OcNOS#
OcNOS#write
Building configuration...
System USB backup in-progress...
[OK]
OcNOS#
5. Select the appropriate backup option (backup all or backup config) and then execute the backup operation.
6. Start the backup operation.
Copy 
OcNOS# write
7. Verify that the backup completed successfully.
Copy 
OcNOS# show system config backup history
OcNOS version UFI_S9510-28DC-OcNOS-7.0.1.60-SP_PLUS_Q2-MR  07/03/2026 14:27:42
OcNOS>en
OcNOS# show system config backup history
system config backup:
Backup status           : Enabled
Backup Content          : All (Config + Installer + Local License)
Last Successfull Backup : 2026-07-16 17:08:24
OcNOS#
OcNOS#

 

• USB restoration disables Zero Touch Provisioning (ZTP).
• The target board should be in a fresh or clean state before restoration. Ensure that the configuration directory (/usr/local/etc) is empty. When restoring on the same board, clear this directory prior to performing the restore.
• If a USB drive containing an ONIE installer is attached to the board, executing sys-update install command may use the installer from the USB. Ensure that the USB is removed or the USB backup feature is disabled before running sys-update.
• The running installer should present in the /installers directory. If it is not available, use the sys-update get command to download the installer.