Finisar Surveyor manual Assigning Names to Protocols Monitor, MONITOR.INI Format

Configuring Surveyor 4

Advanced Configuration

directory and will use that file for its diagnostic information. If no EXPERT- MSG.INI file is found in the directory, Surveyor will not provide diagnostic infor- mation.

You can change the diagnostic information if you want. Changing the diagnostic information may be a useful way to customize Surveyor for your environment. For example, if you have a known problem area to check when certain conditions occur you can include this information directly in the diagnostic information.

Assigning Names to Protocols (Monitor)

Surveyor assigns names to protocols that have been detected, providing users with an easy way to view what protocols have been discovered on the network. In most cases, protocol names are well known; they are defined by the protocol’s creator, or defined by a standards organization. However, you may want explicit information about a protocol that does not have a well known name or is counted in Surveyor monitor screens as a “TCP OTHER” or “UDP OTHER” protocol.

Surveyor includes a MONITOR.INI file to assign names to protocols. Entries in the MONITOR.INI file allow you to:

•Rename the protocols that are currently being detected. For protocols that use TCP or UDP as their transport protocol, the protocol can be assigned a name to override it’s default name.

•Extend the list of protocols that are monitored by Surveyor. You can extend the monitoring of protocols that use TCP or UDP as their transport protocol.

See the section on How Surveyor Assigns Protocol Names to learn how Surveyor names protocols by default. Understanding how Surveyor assigns names to proto- cols by default is important for understanding how protocol names can be altered and how protocols can be added using MONITOR.INI.

The assigning of protocol names does not effect protocol decodes. See Assigning TCP or UDP Ports to Protocol Parsers for information on assigning protocol parsers to specific ports.

The MONITOR.INI file is located in your Surveyor installation directory. Exam- ples of usage are included in the file.

Settings in the MONITOR.INI file will override any other configuration settings you have made for the display of protocols.

MONITOR.INI Format

MONITOR.INI contains two sections, TCP and UPD. Each section may have zero or more entries beginning with the keyword “mapping”. Each “mapping” entry is followed by an equal sign and three variables:

mapping= <port num>,<short name>,<long name>

4-21