Configuration Guide for Cisco NCS 1014, IOS XR Releases 26.x.x

Reset client optics remotely

Updated: June 18, 2026

Want to summarize with AI?

Use this procedure to configure and run a CLI command to perform a remote cold reset of supported client optics for troubleshooting or management.

Use this procedure to remotely reset client optics with a new CLI exec command. This enables cold reboot options to troubleshoot optics or host platform issues.

Table 1. Feature History Table
Feature Name	Release Information	Description
Remote reset of client optics	Cisco IOS XR Release 25.4.1	You can now remotely reset client optics using a new CLI command and Yang model. This feature allows you to perform cold reboots of optics to resolve issues caused by the host or the optics. Remote power cycling enables more flexible and programmable management of optics. This capability does not apply to CIM 8. Supported optics are: 400GE 4x100GE All QSFP optics ZR optics, including QDD-ZR, QDD-ZR+, 400G-ZR, and 400G Bright ZR+ CLI: The command `reload transceiver Optics R/S/I/P cold` is introduced. Yang model: The new yang model `Cisco-IOS-XR-reset-optics-act.yang` is introduced.

This procedure enables remote power cycling of optics in response to issues arising from the host platform or the optics. It supports flexible and programmable management through CLI. This feature is supported on the 400GE, 4x100GE, ZR optics, including QDD-ZR, QDD-ZR+, 400G-ZR, and 400G Bright ZR+ optics.

Limitations:

Warm reloading is not supported.
CIM-8 pluggables are not supported.

Procedure

Enter the command reload transceiver optics R/S/I/P [cold] to reset the optics for a specific port.

Example:

RP/0/RP0/CPU0:ios#reload transceiver optics 0/0/0/2 [ cold ]

The default is a cold reset, regardless of whether you specify cold or not.

The selected 400GE or 4x100GE optics module is reset remotely, performing a cold reboot as needed for troubleshooting or management.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.