Network OS Administration Guide

Supporting Network OS 6.0.1a

Part Number: 53-1003768-04

Configuring event-handler options

After you activate an event handler on a RBridge, you can configure various options. For example, you can specify if the event-handler script runs more than once and how multiple triggers are handled.

  1. Activate an event handler on an RBridge, as described in Configuring a basic event-handler profile:
    device# configure terminal
    device(config)# rbridge-id 1
    device(config-rbridge-id-1)# event-handler activate eventHandler1
  2. To specify a delay from when a trigger is received until execution of the event-handler action, enter the delay command.
    device(config-activate-eventHandler1)# delay 60
    The above example specifies a delay of 60 seconds.
  3. To specify multiple iterations of the action when a trigger is received:
    1. Enter the iterations command.
    2. To specify an interval between iterations, enter the interval command.
    device(config-event-handler-eventHandler1)# iterations 3
    device(config-activate-eventHandler1)# interval 30
    The above example sets the number of iterations to 3 and specifies an interval of 30 seconds between each iteration.
  4. To specify that a triggered action not be interrupted by cluster formation, enter the run-mode exclusive command.
    device(config-activate-eventHandler1)# run-mode exclusive
  5. To limit action-recurrence upon multiple trigger-events, enter one of the following commands:
    • trigger-mode only-once—for the duration of a switch's configuration, the event-handler action is launched only once.
      device(config-activate-eventHandler1)# trigger-mode only-once
    • trigger-mode on-first-instance—as long as the switch is running, the event-handler action is launched only once. Following a switch restart, the event-handler action can be triggered again.
      device(config-activate-eventHandler1)# trigger-mode on-first-instance
  6. If multiple triggers are defined, to specify that the action run only if all of the triggers occur, enter the trigger-function AND time-window command.
    device(config-activate-eventHandler1)# trigger-function AND time-window 120
    The above example specifies that the action run only if all triggers occur within 120 seconds.