sys-update install

Use this command to upgrade the current software to a newer version. Users can perform two types of installations:

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

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

•

Ensure that the URL complies with RFC 3986.

•

When executing this command without the source-interface parameter, the system uses eth0 and the default management VRF

Virtual Routing and Forwarding. When executing this command with the source-interface parameter, it uses the specified interface.

•

When downloading the installer through the TFTP protocol, users may encounter a situation where the download progress shows 100% from the start to the end of the download. This behavior occurs when the TFTP server doesn't support TFTP Option Negotiation. Additionally, there are instances where TFTP download takes longer, even timing out after 30 minutes, despite the client and server being on the same subnet. This delay is often due to latency issues, with some TFTP server implementations exhibiting performance lag. In such cases, switching to a different TFTP server is recommended. The TFTP download operation has been verified on a Debian Linux machine against the server present in the tftpd-hpa package.

• For SCP and SFTP downloads, ensure that the IP address/hostname is present in the known_hosts file. Otherwise, SCP and SFTP will fail with the error message curl: (60) SSL peer certificate or SSH remote key was not OK. If sys-update fails, the user is prompted to add the hostname/IP address in the known_hosts file to proceed with sys-update.

Command Syntax

Copy

sys-update install (|(source-interface IFNAME | (source-ip (A.B.C.D | X:X::X:X)))) URL (verbose|)

Parameters

source-interface IFNAME

(Optional) Specifies the source interface name used to install the new version. If not specified, eth0 is used.

URL

Specifies the URL parameter to indicate where to get the installer.

	<http://username:password@your-server-ip/path/to/file/<abc-updater.deb> or abc-installer> or

	<ftp://username:password@your-server-ip/path/to/file/<abc-updater.deb> or abc-installer> or

	tftp://your-server-ip/path/to/file/<abc-updater.deb> or abc-installer> or

	scp://username:password@your-server-ip/path/to/file/<abc-updater.deb or abc-installer> or

	sftp://username:password@your-server-ip/path/to/file/<abc-updater.deb> or abc-installer> or

	file:///mnt/usb/path/to/file/<abc-updater.deb or abc-installer>

source-ip A.B.C.D

(Optional) Specifies the IPv4 address of the interface used to download the new version.

source-ip X:X::X:X

(Optional) Specifies the IPv6 address of the interface used to download the new version.

verbose

(Optional) Include download 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 user 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

Introduced before OcNOS version 1.3.

Examples

Copy

OcNOS#sys-update install source-interface eth2 http://10.12.52.150/myServer/OcNOS-SP-MPLS-Q1-6.3.3-41-MR-installer
OcNOS#sys-update install http://10.12.52.150/myServer/OcNOS-SP-MPLS-Q1-6.3.3-41-MR-installer