Special scripts

The supported Switch Disconnect action package looks for and calls the disconnect script in the associated device package. Implement this script in your device package to support Switch Disconnect actions.

The supported Move To VLAN action package looks for and calls the moveToVLAN script in the associated device package. Implement this script in your device package to support Move To VLAN actions.

Implement this script in your device package to support Access Control. This script is called periodically by the SMS if the device is configured for Access Control. Specifically, if the property use_radius_authentication exists and is set to true OR if the property use_for_access_control exists and is set to false, onBridgeUpdate will not be called. Otherwise, it will be called whenever the device is added/updated and when the SMS starts and periodically after that.

It is important for new device scripts to use these property names. If these properties do not exist, it is assumed that the switch is used for Access Control.

This script should parse the bridge table of the device and use device.storeBridgeInfo() to store bridge table entries in the database.

Implement this script in your device package to support IP Correlation. This script uses RFC-1213 to find the MAC address for an IP address. It is called during IP Correlation, which can be triggered a number of ways.

Implement this script in your device package to support MAC lookups. This script uses the bridge table to determine if a MAC address is associated with a port on the device. It is called primarily by the MACLOOKUP test feature and through the Web servlet.

Implement this script in your device package to support IP Correlation. This script reads in and stores the different IP subnets serviced by the Layer 3 device. It is called the same as onBridgeUpdate, including periodically. This information is used during IP Correlation to narrow down which devices might be able to correlate an IP address to a MAC.

An action package must have a QUARANTINED script defined that is called when a quarantine event occurs. The QUARANTINED script can register another script to be called when an UNQUARANTINED event occurs. In the supported action packages, this script is named "doUnquarantine". For example:

host.callbackOnState( "UNQUARANTINED", "doUnquarantine" );

The supported Switch Disconnect action package looks for and calls the reconnect script in the associated device package. Implement this script in your device package to support Switch Disconnect actions. This script will undo the action performed by the disconnect script.

The supported Move To VLAN action package looks for and calls the restoreDefaultVLAN script in the associated device package. Implement this script in your device package to support Move To VLAN actions.

Implement this script in your device and action packages to support testing. Device scripts should test connectivity to the network device. Action scripts are dependent on the type of action.