Allied Telesis 2.6.1 manual Triggers, Event, Description, Parameters

Page 100

100

AT-8800 Series Switch User Guide

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 Rapier Switch Software Reference.

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-idMODULE=SWITCH EVENT={LIGHTOFFLIGHTON} PORT=port [AFTER=hh:mm] [BEFORE=hh:mm] [DATE=dateDAYS=day-list] [NAME=name] [REPEAT={YESNOONCEFOREVERcount}] [SCRIPT=filename...] [STATE={ENABLEDDISABLED}] [TEST={YESNOONOFF}]

SET TRIGGER=trigger-idPORTS={port-listALL} [AFTER=hh:mm] [BEFORE=hh:mm] [DATE=dateDAYS=day-list] [NAME=name] [REPEAT={YESNOONCEFOREVERcount}] [TEST={YESNOONOFF}]

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

LINKDOWN

 

Description

The port link specified by the PORT parameter has just gone down.

Parameters

The following command parameter(s) must be specified in the CREATE/SET

 

TRIGGER commands:

 

 

 

 

Parameter

Description

 

 

 

 

PORT=port

The port on which the event will activate the trigger.

Script Parameters

 

The trigger passes the following parameter(s) to the script:

 

 

 

 

Argument

Description

 

 

 

 

%1

The port number of the port which has just gone down.

Event

 

 

LINKUP

 

Description

The port link specified by the PORT parameter has just come up.

Parameters

The following command parameter(s) must be specified in the CREATE/SET

 

TRIGGER commands:

 

 

 

 

Parameter

Description

 

 

 

 

PORT=port

The port on which the event will activate the trigger.

Script Parameters

 

The trigger passes the following parameter(s) to the script:

ArgumentDescription

%1

The port number of the port which has just come up.

 

 

Software Release 2.6.1 C613-02039-00 REV A

Image 100
Contents AT-8800 Series Switch Page Contents Operating the switch AT-8800 Series Switch User GuideMaintenance and Troubleshooting Page Why Read this User Guide? Introducing the AT-8800 Series SwitchChapter Where To Find More Information AT-8800 Series Switch Documentation SetOnline Technical Support Features of the AT-8800 Series SwitchIntroduction Management Features Software FeaturesSpecial Feature Licences Do if You Clear Flash Memory Completely on Getting Started with the Command Line Interface CLI This ChapterTerminal Communication Parameters Connecting a Terminal or PCParameters for terminal communication Value Enter the password at the password prompt Getting Started with the Command Line Interface CLILogging Assigning an IP AddressSetting Routes To change the IP address for an interface, enter the commandChoosing a Password Changing a PasswordTo add a static route, enter the command Using the Commands Not availableTo display the current help file, enter the command Getting Command Line HelpAliases Enabling Special Feature Licences Setting System ParametersGetting Started with the Graphical User Interface GUI Getting Started with the Graphical User Interface GUIWhat is the GUI? Accessing the Switch via the GUIBrowser and PC Setup Supported browsers and operating systemsHttp Proxy Servers Establishing a Connection to the Switch See Option 3 Connecting to an Installed Switch onSee Option 1 Configuring the Switch before Installation on See Option 2 Installing the Switch into the LAN onUse this procedure if Option 1 Configuring the Switch before InstallationSee Http Proxy Servers on page 23 for more information Option 2 Installing the Switch into the LAN Default username is managerAt the login prompt, enter the user name and password Plug the switch into the LANSee Secure Access on page 29 for more information Assign the vlan1 interface an IP addressOption 3 Connecting to an Installed Switch Find out the IP address of the switch’s interfaceSelect a PC If necessary, bypass the Http proxy serverSecure Access Create a Security Officer user accountTo enable system security, use the command Then enter the password for CIPHER, sbr4y3To create an RSA key pair, use the command System Status System StatusUsing the GUI Navigation and Features Configuration MenuUsing Configuration Pages Quality of Service and traffic filtersAn example of a configuration page with a selection table Editable Fields Management Menu Monitoring MenuChanging the Password Diagnostics MenuContext Sensitive GUI Help Combining GUI and CLI Configuration Saving Configuration Entered with the GUIConfiguring Multiple Devices To upgrade the GUI Then delete the GUI resource file, using the commandLoad the new file onto the switch Upgrading the GUIInstall the new file as the preferred GUI TroubleshootingPoint your web browser at the switch’s IP address Accessing the Switch via the GUI Deleting Temporary FilesTraffic Flow Solution SolutionsIP Addresses and Dhcp Time and NTPLoading Software Page Using Scripts on User Accounts and PrivilegesSnmp and MIBs on A Security Officer prompt looks likeLogin To display the current operating mode, enter the command Normal Mode and Security ModeOperating the switch Specific Parameters Remote Management Storing Files in Flash MemoryUsing Scripts Example output from the Show File commandSaving the Switch’s Configuration Storing Multiple ScriptsFile Naming Conventions Loading and Uploading FilesFile extensions and file types Extension File type/function Loading Files SPASetting Loader Defaults Example Load a Patch File Using HttpTo load a patch file Configure the Loader Download the patch fileUploading Files From the Switch Example Upload a Configuration File Using TftpMore information To upload a log fileUpgrading Switch Software To upgrade to a new software release Example Upgrade to a New Software Release UsingLoad the new release file onto the switch Enter the licence password for the software release Make the release the default permanent releaseEnter licence information for the release Test the releaseTo upgrade to a new patch file Example Upgrade to a new patch fileCheck that the file is successfully loaded Using the Built-in Editor Snmp and MIBsWhere interface is the name of an interface, such as vlan11 For More About Operations and FacilitiesAT-8800 Series Switch User Guide Switch Ports Enabling and Disabling Switch PortsTo enable or disable a switch port, use the commands To display information about switch ports, use the commandSTP Autonegotiation of Port Speed and Duplex Mode Port Trunking Speed 10/100Show VLAN=ALL Layer 2 Switching Packet Storm ProtectionPort Mirroring Port security Example output from the Show Switch Port Intrusion command Virtual Local Area Networks VLANsVlan Tagging TpidFormat of user priority and Vlan data in an Ethernet frame Vlan Membership using Vlan Tags Vlan Membership of Untagged Packets Vlan membership of example of a network using tagged portsMember ports Creating VLANs Vlans with untagged portsTo add tagged ports to a VLAN, use the command To destroy a VLAN, use the commandProtected VLANs Summary of Vlan tagging rulesVlan Interaction with STPs and Trunk Groups Generic Vlan Registration Protocol Gvrp Layer 2 Switching ProcessIngress Rules Learning Process Forwarding Process Layer 2 Filtering Example output from the Show Switch Filter command Quality of Service Egress RulesSpanning Tree Protocol STP Spanning Tree ModesSpanning tree port states State Meaning Spanning Tree and Rapid Spanning Tree Port StatesRapid Spanning Tree port states State Meaning Configuring STP SET STP=stpnameALL PRIORITY=0..65535 Example output from the Show STP command Do not occur Switch Max Age Parameter MeaningTo display STP port information, use the command 94AT-8800 Series Switch User Guide Example output from the Show STP Port commandTo show STP counters, use the command 96AT-8800 Series Switch User Guide ReceiveTransmit DiscardedInterfaces to Layer 3 Protocols Igmp SnoopingDisable Igmpsnooping Example output from the Show IP Igmp command Group ListTriggers EventDescription ParametersLayer Then use either of the following commands Displays the interfaces enabled for IP routing FigureInternet Protocol IP IP MulticastingNovell IPX Routing Information Protocol RIPLayer 103 Example output from the Show IPX Circuit command AppleTalkResource Reservation Protocol Rsvp Layer 105Page Maintenance and Troubleshooting How the Switch Starts Up Switch startup messagesHow to Avoid Problems Set system territoryWatch for software updates What to Do if You Clear Flash Memory Completely If you accidentally do this, you will need toWhat to Do if the PPP Link Disconnects Regularly What to Do if Passwords are LostGetting the Most Out of Technical Support Resetting Switch Defaults Checking Connections Using PingTo get debugging output, enter the command Maintenance and Troubleshooting 113Troubleshooting IP Configurations To set Ping defaults, enter the commandStop a Ping that is in progress, enter the command Telnet FailsTroubleshooting Dhcp IP Addresses Your switch is acting as a Dhcp clientYour switch is acting as a Dhcp server Maintenance and Troubleshooting 115Troubleshooting IPX Configurations To check that the PPP link is active, enter the commandLocal Workstations Can Not Access Remote Servers No Routes are Visible to the Remote RouterUsing Trace Route for IP Traffic Check route tablesTo halt a trace route that is in progress, enter the command