• Install: This RPC transfers an image to a device. These images are uniquely identified by a version string. This RPC is the similar to the install add command; the main difference is that the image is transferred as part of the RPC. • Activate: This RPC sets the requested OS version, which is part of the input to the RPC, as the version to be used at the next reboot, and reboots the device. This RPC is the same as the install activate and the install commit commands. • Verify: This RPC verifies the current OS version. Cisco IOS XE devices support both install mode and bundle mode to boot software images.
In install mode, you can bring up your device by booting the software package provisioning file that resides in the flash: file system. The ISO file system in each installed package is mounted to the root file system (rootfs) directly from the flash. In bundle mode, you can boot your device by using the bundle (.bin) file. Packages are extracted from the bundle, and copied to the RAM. The ISO file system in each package is mounted to the rootfs. Unlike install boot mode, additional memory that is equivalent to the size of the bundle is used when booting in bundle mode. In the following scenarios, an error message is generated when a device starts in bundle mode:
• The device starts with the current image running in bundle mode. • The install RPC is initiated on the device to install a new image. The following is a sample error message: May 11 09:24:15.385 PST: %INSTALL-3-OPERATION_ERROR_MESSAGE: Switch 1 R0/0: install_engine: Failed to install_add package flash:gNOI_iosxe_17.05.01.0.144.1617180620.bin, Error: [2|install_add(ERR, )]: Booted in bundle mode. For Bundle-to-Install mode conversion, please use one-shot CLI - install add file activate commit Even though an error message is generated, the install RPC returns a success to the client. The error message can be safely ignored; the subsequent activate RPC is not affected.
After rebooting with the new image, the device is in install mode. Note This error message is not displayed if the device was initially running in install mode. It is applicable only when the device starts in bundle mode. To view all the error messages, see https://github.com/openconfig/gnoi/blob/master/os/os.proto#L218 . For more information about installation modes, see the "Performing Device Setup Configuration" chapter of the System Management Configuration Guide for all the Cisco Catalyst 9000 Series Switches. Dual Route Processor Support Cisco devices support both In-Service Software Update (ISSU) (only install mode is supported) and non-ISSU modes.
When ISSU is not supported or is not possible through the Install RPC, the gNOI OS installation service will request a non-ISSU install. If a device supports ISSU upgrade in case of dual Route Processors (RPs), the gNOI OS installation service interface invokes the install activate ISSU workflow. In all other scenarios, where ISSU not is supported, or Model-Driven Programmability OS Installation Service Programmability Configuration Guide, Cisco IOS XE 17.16.x 283