cisco IOS XE 17.16.x — OS Install RPC

the device supports a single RP, the gNOI OS installation service uses a regular non-ISSU image install workflow to process the gRPC activate request. In bundle mode, the upgrade is done through the install add file filename activate commit command. This upgrade is the same for devices with a single RP. No ISSU support means that both the RPs are reloaded at the same time, and the device is down until one RP comes up. In install mode without ISSU, both the RPs are reloaded at the same time and the device is down until one RP comes up. In install mode with ISSU, the reload of the RPs is simultaneous, and the device downtime is shorter.

OS Install RPC The Install RPC transfers an image to a device. The RPC consists of the input InstallRequest RPC, and the output InstallResponse RPC, both of which are bidirectional streaming RPCs. This RPC does not support Software Maintenance Update (SMU). The following is a high-level message sequence for an Install RPC on a device with a single RP that is running the operating system Version 1: 1. A client initiates an Install RPC to the device. 2. The client sends a TransferRequest message to the device, with version set to Version 2. 3. The device responds with a TransferReady message to the client. This is required for the client to start transferring the image. 4.

The client transfers the image by sending multiple transfer_content messages to the device. 5. Optionally, the device sends TransferProgress messages to the client. 6. The client sends a TransferEnd message to the device, indicating that the image transfer is complete. 7. In install mode, the device does an operation equivalent of the install add command programmatically. The contents of the package are extracted. 8. The device sends a Validated message, which contains the version extracted from the image, to the client, indicating that the image transfer is valid.

Note If the Install RPC is stopped prematurely by the client, or if any part of the operation fails, the local image file is removed, and the install remove inactive command is invoked automatically. An appropriate status code is returned to the client. Model-Driven Programmability OS Install RPC Programmability Configuration Guide, Cisco IOS XE 17.16.x 284