Table Of Contents

R Commands

rollback running-config checkpoint

rmon alarm

rmon event

rmon hcalarm

R Commands

---

This chapter describes the Cisco NX-OS system management commands that begin with the letter R.

rollback running-config checkpoint

To implement a rollback for the configured checkpoint file, use the rollback running-config checkpoint command.

rollback running-config checkpoint name [atomic | best-effort | stop-at-first-failure]

Syntax Description

best-effort	(Optional) Implements a rollback and skips any errors.
atomic	(Optional) Implements a rollback only if no errors occur.
stop-at-first-failure	(Optional) Implements a rollback that stops if an error occurs.

Defaults

None

Command Modes

Configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to implement a rollback for the configured checkpoint file:

switch# rollback running-config checkpoint stable 

Related Commands

Command	Description
show diff rollback-patch	Displays the differences between the source and the destination file.

rmon alarm

To configure a 32-bit remote monitoring RMON alarm, use the rmon alarm command. To delete RMON alarms, use no form of this command.

rmon alarm alarm number mib-object sample-interval {absolute | delta} rising-threshold value [rising-event] falling-threshold value [falling-event] [owner alarm-owner]

no rmon alarm alarm-number

Syntax Description

alarm number	RMON alarm number. The range is from 1 to 65535.
mib-object	MIB object to monitor. The maximum length is 80 characters.
sample-interval	Sample interval in seconds. The range is from 1 to 2147483647
absolute	Specifies to test each sample directly.
delta	Specifies to test the difference (delta) between the current and previous sample.
rising-threshold value	Specifies the rising threshold value. The range is from en-2147483648 to 2147483647.
rising-event	(Optional) Specifies the event to trigger on a rising threshold crossing. The range is from 1 to 65535. If no event is specified, event 0 is used.
falling-threshold value	Specifies the falling threshold value. The range is from en-2147483648 to 2147483647.
falling-event	(Optional) Specific the event to trigger on a falling threshold crossing. The range is from 1 to 65535. If no event is specified, event 0 is used.
owner alarm owner	(Optional) Specifies an owner for the alarm. The maximum size is 80 characters.

Defaults

None

Command Modes

Global Configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the 32-bit alarm number 20 for OID (1.3.6.1.2.1.2.2.1.14). The sample interval is 30 seconds and delta samples are tested. The rising threshold is 15 errors per sample window; reaching this level triggers event1. The falling threshold is 0 errors in the sample window; reaching this level triggers event 0 (no action).

switch# config terminal

switch(config)# rmon alarm 20 1.3.6.1.2.1.2.2.1.14.16777216 30 delta rising-threshold 15 1 falling-threshold 0 owner cisco

switch(config)#

Related Commands

Command	Description
rmon event	Configures an RMON event.
rmon hcalarm	Configures the 64-bit RMON alarm.
show rmon	Displays RMON configuration and logged information.

rmon event

To configure a RMON event, use the rmon event command. To delete an RMON event, use the no form of this command.

rmon event event-number [description text] [log] [trap community-string] [owner owner-name]

no rmon event event-number

Syntax Description

event-number	RMON event number. The range is from 1 to 65535.
description text	(Optional) Specifies a description of the event. The maximum length is 80 characters.
log	(Optional) Generates an RMON log entry in the onboard RMON log when the event is triggered by an alarm.
trap community-string	(Optional) Generates SNMP traps with the specified name when the event is triggered by an alarm. The maximum length is 32 characters.
owner owner-name	(Optional) Specifies an owner for the alarm. The maximum length is 80 characters.

Defaults

None

Command Modes

Global configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

You can trigger an events created by this command with an alarm that you configured by using the rmon alarm or rmon hcalarm commands.

Usage Guidelines

This command does not require a license.

---

Note Events can be used by both rmon alarm (32-bit) and hcalarm (64-bit) commands.

---

Examples

This example shows how to configure RMON event 2 to log the onboard RMON log and send an SNMP trap to public community trap destinations:

switch# config terminal

switch(config)# rmon event 2 log trap public description CriticalErrors owner cisco

switch#

Related Commands

Command	Description
rmon alarm	Configures a 32-bit RMON alarm.
rmon hcalarm	Configures a 64-bit RMON alarm.
show rmon	Displays RMON configuration and logging information.

rmon hcalarm

To configure a 64-bit RMON high-capacity alarm (hcalarm), use the rmon hcalarm command. To delete an rmon hcalarm, use the no form of this command.

rmon hcalarm alarm-number mib-object sample-interval {absolute | delta} {rising-threshold- high value rising-threshold-low value [rising-event] [falling-threshold-high value falling-threshold-low value [falling-event]]} [owner alarm-owner]

no rmon hcalarm alarm-number

Syntax Description

alarm-number	RMON hcalarm number. The range is from 1 to 65535.
mib-object	MIB object to monitor. The maximum length is 80 characters.
sample-interval	Sample-interval in seconds. The range is from 1 to 700000.
absolute	Specifies to test each sample directly.
delta	Specifies to test the difference (delta) between the current and previous sample.
rising-threshold -high value	Configures the upper 32 bits of the 64-bit rising threshold value. The range is from 0 to 4294967295.
rising-threshold- low value	Configures the lower 32 bits of the 64-bit rising threshold value. The range is from 0 to 4294967295.
rising-event	(Optional) Event to trigger on rising threshold crossing. The range is from 0 to 65535.
falling-threshold- high value	Configures the upper 32 bits of the 64-bit falling threshold value. The range is from 0 to 4294967295.
falling-threshold- low value	Configures the lower 32 bits of the 64-bit falling threshold value. The range is from 0 to 4294967295.
falling-event	(Optional) Event to trigger on a falling threshold crossing. The range is from 0 to 65535.
owner alarm-owner	(Optional) Specifies an owner for the alarm. The maximum size is 80 characters.

Defaults

None

Command Modes

Configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

Event number 0 is a predefined null (or no operation) event. When no event is specified by the user in an alarm, this event is automatically used by the system. The event causes no action to be taken when triggered; however, the alarm is still reset. The event cannot be redefined by the user. It is a predefined event.

This command does not require a license.

Examples

This example shows how to configure a RMON high-capacity alarm:

switch# config terminal

switch(config) rmon hcalarm 2 1.3.6.1.2.1.31.1.1.1.6.22544384 30 delta  

rising-threshold-high 55 rising-threshold-low 3776798720 4 falling-threshold-high 41  

falling-threshold-low 3906340864 owner cisco

Related Commands

Command	Description
rmon alarm	Configures a 32-bit RMON alarm.
rmon hcalarm	Configures a 64-bit RMON alarm.
show rmon	Displays RMON configuration and logging information.