sys-update install
Use this command to upgrade the current software to a newer version. You can do two types of installation:
• If a .deb file is provided, the board is loaded with new binaries.
• If an installer file is provided, the board is completely installed with a new kernel and binaries.
Note:
1. During an upgrade, if a license is not available the existing configuration is not applied. Also, the ZebOS.conf file is not created and the terminal monitor command is not allowed.
2. The URL must be compliant with RFC 3986.
3. When this command is executed without the source-interface parameter, then eth0 and the default management VRF are used. When this command is executed with the source-interface parameter then that interface is used.
4. At times while downloading installer through TFTP protocol, download progress would show 100% from the start to the end of the download. This behavior is observed whenever the TFTP server doesn't support the TFTP Option Negotiation. Also at times TFTP download takes more time to download the installer though the client and server are part of the same subnet, eventually download operation even times out after 30 minutes. The reason for such issue is the latency, here some of the TFTP server implementations are lagging performance. In such instances we recommend to switch to a different TFTP server. This TFTP download operation is verified in Debian Linux machine against the server present in the tftpd-hpa package.
Command Syntax
sys-update install (|(source-interface IFNAME | (source-ip (A.B.C.D | X:X::X:X)))) URL (verbose|)
Parameters
IFNAME
The interface used to download the new version. If not specified, eth0 is used.
URL
Where to get the new version:
http://your-server-ip/path/to/file/<abc-updater.deb or abc-installer>
ftp://your-server-ip/path/to/file/<abc-updater.deb or abc-installer>
tftp://your-server-ip/path/to/file/<abc-updater.deb or abc-installer>
file:///mnt/usb/path/to/file/<abc-updater.deb or abc-installer>
A.B.C.D
The interface IPv4 address used to download the new version.
X:X::X:X
The interface IPv6 address used to download the new version.
verbose
Include upgrade logs in the output.
Default
None
Caution
OcNOS services are using /usr/local/etc path to store the device configuration, and this path mounted into a separate partition to isolate system configurations. This partition is meant only for system configuration. It will affect the system stability if the user uses this partition for storing general files. In this problematic state, if the device reboots, OcNOS services will not start properly, that would even create problems to the device connectivity. There will be an impact on normal system configuration operations.
User must take care of this problem just before issuing the following commands:
• reload/sys-reload - Reboots the device.
• sys-shutdown - This is to shutdown the device, but when users powers the device OcNOS services won't start cleanly.
• reboot / shutdown - From Linux shell
• Also includes all copy commands from Linux shell before issuing the user triggered reload commands.
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#sys-update install source-interface eth2 http://10.12.52.150/myServer/EC_AS5812_54X-OcNOS-1.3.4.266-DC_MPLS_ZEBM-S0-P0-installer verbose
#sys-update install http://10.12.52.150/myServer/EC_AS5812_54X-OcNOS-1.3.4.266-DC_MPLS_ZEBM-S0-P0-installer verbose
#sys-update install http://10.12.52.150/myServer/EC_AS5812_54X-OcNOS-1.3.4.266-DC_MPLS_ZEBM-S0-P0-installer
#sys-update install http://10.12.52.150/myServer/EC_AS5812_54X-OcNOS-1.3.4.266-DC_MPLS_ZEBM-S0-P0-updater.deb
Last modified date: 06/07/2023