OS Verify RPC The Verify RPC verifies the running OS version. The response to the RPC contains information about the support and presence of a standby RP. If there was an error in the last activate RPC, that error is returned in the response as a string. The gNOI OS installation service uses the install operational model and platform model to populate this information. Currently, the install operational model does not support different versions running on two RPs. GNOI Factory-Reset Services Cisco IOS XE Cupertino 17.7.1 supports gNOI factory-reset services as specified in the reset.proto . The gNOI factory-reset service supports a single RPC, Start .
This RPC instructs a device to clean the existing state, and boot the device in the same condition as it was shipped from the factory. The state includes, storage, configuration, logs, certificates, licenses, crashinfo, and Rommon variables. Not all Rommon variables are removed, enough are preserved on a per-platform basis to allow the image to automatically reboot with the preserved image. The device then reboots with the current Operating System image, and comes back into the default state, based on the simplified bootstrapping workflow. This RPC is accepted only if the target device is in a provisioned state.
The Start RPC is similar to the factory-reset all command, however; the RPC preserves the current Operating System image, unlike the command, which deletes the image. As part of the factory-reset scripts, both the flash: or harddisk:, where the current image resides is cleaned up. However, when the factory-reset scripts are run, the boot image or packages are backed up to the / tmp folder, and restored. The regular factory-reset erases all the customer-specific data stored in a device and restores the device to its original configuration at the time of shipping.
Data that is erased includes configurations, log files, boot variables, core files, and credentials such as Federal Information Processing Standard-related (FIPS-related) keys. The erasure is consistent with the clear method, as described in NIST SP 800-88 Rev. 1. For more information, see the "Performing Factory Reset Services" module of the System Management Configuration Guide for your platform. gNOI Factory-Reset Error Messages gNOI factory-reset services return an empty ResetSuccess message upon successfully triggering the factory reset on a device. Some of the error messages that are returned in the context of gRPC and factory reset services are described in this section: Table 20:
gNOI Factory-Reset Error Messages Model-Driven Programmability OS Verify RPC Error Message Error Description When the factory os field is requested, the GNMIB _ returns a gRPC error code of INVALID ARGUMENT along with the message, _ “Factory OS rollback is not supported.” In the ResetError message, the client will also receive the factory os unsupported field set to TRUE. The _ _ other fields in the message will have default values. Programmability Configuration Guide, Cisco IOS XE 17.16.x 289