Install guide

50 Release Note
Rapier Switch Software Release 2.1.0
C613-10200-01 Rev A
Triggers
The Trigger Facility can be used to automatically run specified command
scripts when particular triggers are activated. When a trigger is activated by an
event, global parameters and parameters specific to the event are passed to the
script that is run. For a full description of the Trigger Facility, see the Trigger
Facility chapter in the AR Series Router Reference Manual at
http://www.alliedtelesyn.co.nz/support/rapier/
.
The switch can generate triggers to activate scripts when a fibre uplink port
loses or gains coherent light. To create or modify a switch trigger, use the
commands:
CREATE TRIGGER=trigger-id MODULE=SWITCH
EVENT={LIGHTOFF|LIGHTON} PORT=port [AFTER=hh:mm]
[BEFORE=hh:mm] [DATE=date|DAYS=day-list] [NAME=name]
[REPEAT={YES|NO|ONCE|FOREVER|count}] [SCRIPT=filename...]
[STATE={ENABLED|DISABLED}] [TEST={YES|NO|ON|OFF}]
SET TRIGGER=trigger-id PORTS={port-list|ALL} [AFTER=hh:mm]
[BEFORE=hh:mm] [DATE=date|DAYS=day-list] [NAME=name]
[REPEAT={YES|NO|ONCE|FOREVER|count}]
[TEST={YES|NO|ON|OFF}]
The following sections list the events that may be specified for the EVENT
parameter, the parameters that may be specified as module-specific-parameters,
and the arguments passed to the script activated by the trigger.
Event
LIGHTOFF
Description
The fibre port specified by the PORT parameter has just lost coherent light.
Parameters
The following command parameter(s) must be specified in the CREATE/SET
TRIGGER commands:
Script Parameters
The trigger passes the following parameter(s) to the script:
Interface Name The name of an IP interface, followed by “(DR)” if the
interface is acting as the designated router.
Group List A list of multicast group memberships for this interface.
Group. The group multicast address.
Last Adv. The last host to advertise the membership report.
Refresh time The time interval (in seconds) until the membership group
will be deleted if it does not receive another membership
report before then.
Table 20: Parameters in the output of the SHOW IP IGMP command. (Continued)
Parameter Meaning
Parameter Description
PORT=
port
The port on which the event will activate the trigger.
Argument Description
%1 The port number of the port which has just lost coherent light.