All example programs are included | HP Transcend Traffix Manager

Writing your own program 145

Then, when a device is discovered, dblookup does the following:

1dblookup builds a SQL string with the device’s key attributes values and runs a query against the database to find a match.

2If no match is found, it waits for the next device.

3Otherwise it takes the best match, that is to say the one with as few stars as possible.

4If two full matches are returned, dblookup logs an error; otherwise, it takes the result of the first partial match encountered.

Writing your own If the standard attribute lookup programs fileattrs and dblookup

programare not sufficient for your requirements, you can write your own attribute lookup program.

In order to write your own user-defined attribute program, you need Microsoft Visual C++ V5.0 or later, Microsoft Visual Basic or another tool which allows you to compile a program. The rest of this section assumes you are familiar with programming either C or Visual Basic.

All example programs are included in

<installdir>\TraffixServer\examples.

Structure of an Every time Traffix Manager wants to find out attributes for a device, it Attribute Lookup calls all the attribute lookup programs in the user-defined attribute

Program lookup configuration file (see “Contents of the User-defined Attributes Configuration File” on page 138) and asks them to provide attributes for the device.

When you write your own attribute lookup program, your program has to respond to these requests from Traffix Manager and supply attributes for a particular device. Communication with Traffix Manager is done using the functions in the attripc.dll library which is in <installdir>\TraffixServer. Even if you do not know much about DLLs, these functions are designed to make writing your own attribute lookup program as simple as possible.

The main three functions provided by the attripc.dll library are GetNextLookup(), GetAttribute() and SetAttribute(). Below is an example of the central loop of a simple attribute lookup program

Image 145

$HP Transcend Traffix Manager manual All example programs are included, Installdir\TraffixServer\examples$

Contents

User Guide 3Com Corporation 5400 Bayfront Plaza Santa Clara, California Contents Part II HOW Traffix Manager Works Collecting Data Overview Predefined Event Rules Displaying Connections To and From Objects Viewing Events Report Types 3Com Agents Supported Interface Types Using the SubnetsDB File How Subnet Grouping Works Online Technical Services 163 World Wide Web Site Monitoring Network Segments Using RMON-1 AgentsSnmp Tables used by Traffix Manager Page About this Guide Where to find specific informationDocumentation If you are looking for Turn to Appendix a List conventions that are used throughout this guide ConventionsText Conventions Icon Description This Guide Terminology UsedRelated Documents Miscellaneous CommentsPddtechpubscomments@3com.com Compliance Year3Com Year 2000 Web Getting Started with Traffix Manager Page Traffix Manager Overview Traffix Manager Overview How Does Traffix Manager Work? Traffix Manager Gathers Data from the Network Users Strategy for New Traffix Manager Overview Transcend NCS Network Administration Guide for Installing RmonLaunching Traffix Manager For the First Time Agents on Your Traffix Manager LaunchingServer Client Launching the Traffix Manager Client Traffix Manager Main Window Managerwindow Reference Main WindowGrouping devices Minus sign next to the group Display Menu Option Function Events CollectionReports Help Traffix Manager Main Window Menu Options HOW Traffix Manager Works Page How Traffix Collecting DataManager Processes Collected Data Collected Data is added to a Relational Database Rmon Overview How Traffix Overview MAPThis chapter contains the following sections Geographical location Be familiar with the concepts of attributes and groupings AttributesPredefined attributes you can change these or add your own Unknown, or unassigned Installdir Assigning MAC Addresses GroupingsRecords an entry for both devices and both devices appear Device a with the MAC address of the router Groupings Select this grouping Deselect Collapse Redundant Grouping Groupings Groupings dialog box Running Traffix Manager IIIPage Launching a Traffix Launching Traffix Manager After the First TimeManager Client After the first time. It contains the following sections There are two access levels for running the client Interfaces Configuring Agents for Data Collection Configuring Agents for Data Collection Adding and Editing Agents Community Access LevelsLevel Description Polling for Data Collection Viewing Agent StatisticsPolling Agents Over a WAN Link Suspending and Resuming Data Collection Manually Finding Agents for Data Collection Configuring Agents for Data Collection Loading Network Displaying Network Traffic Main WindowTraffic Data You make these selections in the Load Traffic dialog box Objects in the Main Working withWindow Group Statistics Displaying NetworkSelecting Them From Objects ObjectsDescription of Display Buttons Protocols Applications Favorites Displaying Network Traffic in the Main Window RMON-2 Limitations Displaying Network Traffic in the Main Window Information about selected items Displaying Traffic in Graphs Panel Using the Graph Graph Dialog Box Using the LaunchItems in the Map Launch Graph dialog box Using the Launch Graph Dialog Box Displaying Traffic in Graphs Using Event Rules Using Event Rules Rules Examples of Event Monitor Critical Devices Monitor Network Resource Usage Monitor Network Trends Monitor Critical Connections Selecting Protocols Specifying Devices Specifying Sensitivity Specifying the Time FilterSpotting General Long Term Trends Maintaining Network Security Monitoring Which Devices Are Using a ServerEnforcing Corporate Policy About Network Usage Monitoring Protocol Usage Detecting Unauthorized Servers Monitoring WAN Links and BackboneMonitoring Congestion on WAN Links Detecting Network Misuse Using Event Rules Viewing Events You use the Event List to display information about events Viewing Events Filter dialog box By severity Do not summarize By event rulePrint Managing Selected ViewingEvents Configuring an Open Management Platform OMP Configuring Traffix Manager to Forward Events as Snmp TrapsClick Add Forwarding Events as Snmp Traps Viewing Events During a specified period Overview of Reporting Time Line for Daily Report Generation Reports Daily Reports Monthly Reports Weekly Reports Report Manager Report Manager has three main areas Managing Reports Running Ad Hoc Scheduling ReportsReports Managing Raw Data Managing Reports Change the lifetime of that raw report data or output Reporting Strategy forTraffix Manager Use Graphs to Identify Key Components Quickly On Reports Effects of Grouping Report Types Report Section Chart Title Connection Activity Report ChartsReport Device Activity There are three ways you can report on groups Group ActivityExternal Traffic flowing into or out of the group only Internal Traffic flowing within the group only Segment Activity Report Charts Unusual error totals. These baselines are calculated Received over the report period Top N Connections Top N Connections Report Charts Top N Devices Report Charts Top N Connections Report Charts Top Devices Remainder are grouped as other Device History Top N Groups Top N Groups Report Charts Top N Segments Report Charts Percentage of errorsTop N Segments Segments report Top N Segments Report Charts Utilization Appendices and Index Page Troubleshooting Troubleshooting Traffix ManagerRunning Traffix Manager, and their solutions Contains descriptions of problems you might encounter when Diagnosing Traffix Manager Problems Reporting features of Traffix ManagerReports If Browser is not in your path message is displayed Internal traffic Error could not Appendix a Troubleshooting Traffix Manager This appendix contains Traffix Control Panel These applications help you to manage and organize a number DatabaseNetwork over time Provides the following applications for managing databases Database Maintenance Repair databases Clean databases Optimize databases Upgrading Traffix Manager Install\traffix\config Manager Deinstalling Traffix To deinstall Traffix Manager 2.0 for NT Appendix B Database Management Using Traffix Control Panel Aggregating Devices DefaultAggregation Local Domain Specification Selecting the Default Aggregation Action Com Setting a Maximum Device Limit Using Using the Subnetsdb FileSubnetsDB File File can be edited and reapplied at any time Class Description How Subnet Grouping Works Appendix D Using the Subnetsdb File Overview Automatic Attribute Assignment Contents User-defined Attributes Configuration File Mylookup fileattrs.exe c\my data\data.txt True Performing Using the fileattrs ProgramAttribute Assignment True Appendix E Automatic Attribute Assignment Lookup2 Lookup2 Companies dblookup.exe c\data\companies.mdb All example programs are included Installdir\TraffixServer\examples Simple attribute lookup process in C There is one version in Visual Basic and one in C Name Language Description Example Programs FunctionDescription Library functions available GetAttribute Function Description Appendix E Automatic Attribute Assignment Types Supported RMON-2 Devices Appendix F Supported RMON-2 Devices Downloading Configuring 3COMFirmware to 3Com Standalone Agents RMON-1 Table Sizes RMON-2 Table Sizes RMON-2 AgentsPage Appendix G Configuring 3COM Standalone RMON-2 Agents Dhcp Devices Manager MonitorsWhat Effect Do Dhcp Devices Have Chapter H Dhcp Using RMON-1 Using RMON-1 AgentsMonitoring Network Segments Appendix I Using RMON-1 Agents Snmp Tables used by Traffix Manager RetrievalMandatory Comments ProtoDist For protocol distribution reports only Services ServicesTechnical Support Online Technical Username anonymous Access by Analog ModemHours a day, 7 days a week Country Data Rate Telephone Number 847 262 Access by Digital Modem408 727 Country Telephone Number Asia, Pacific Rim Europe, South Africa, and Middle East Country Telephone Number Fax Number Page Glossary Glossary Glossary Glossary Glossary Tree See Object List Numbers Index Community names definition 53 overview Dhcp 153 Html Detecting unauthorized machine access RMON-2 Snmp User Authorization dialog box 50 User Guide Structure Index 3Com Corporation Limited Warranty Limitation of Liability