network polling guide - ibm

Tivoli® Network Manager IP EditionVersion 3 Release 8

Network Polling Guide

SC23-9901-01

��

NoteBefore using this information and the product it supports, read the information in“Notices” on page 51.

This edition applies to version 3, release 8, modification 0 of IBM Tivoli Network Manager IP Edition (5724-S45) andto all subsequent releases and modifications until otherwise indicated in new editions.

© Copyright IBM Corporation 2006, 2011.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

About this publication . . . . . . . . vIntended audience . . . . . . . . . . . . vWhat this publication contains . . . . . . . . vPublications . . . . . . . . . . . . . . viAccessibility . . . . . . . . . . . . . . viiiTivoli technical training . . . . . . . . . . viiiSupport information . . . . . . . . . . . viiiConventions used in this publication . . . . . . ix

Chapter 1. About polling the network . . 1Poll policies . . . . . . . . . . . . . . 1Poll definitions . . . . . . . . . . . . . 2

Polling mechanisms . . . . . . . . . . . 3Poll definition types . . . . . . . . . . . 6

Multibyte data in poll definitions . . . . . . . 7

Chapter 2. Enabling and disabling polls 9

Chapter 3. Creating polls . . . . . . . 11Creating polls by using existing polls . . . . . . 11Creating new polls from scratch . . . . . . . 12

Creating basic threshold polls . . . . . . . 13Creating generic threshold polls . . . . . . 15Creating ping and link state polls . . . . . . 17

Chapter 4. Creating poll definitions . . 21Creating generic threshold poll definitions . . . . 21

Creating basic threshold poll definitions . . . . 22Example trigger and clear thresholds . . . . . 24

Creating ping and link state poll definitions . . . 25

Chapter 5. Changing polls . . . . . . 27

Changing poll policies . . . . . . . . . . . 27Example customized poll policy . . . . . . 29

Changing poll definitions. . . . . . . . . . 30Changing generic threshold poll definitions . . 30Changing basic threshold poll definitions . . . 31Changing ping and link state poll definitions . . 32

Chapter 6. Deleting poll policies . . . . 35

Chapter 7. Deleting poll definitions . . 37

Appendix A. Default poll policies . . . 39Default ping policies . . . . . . . . . . . 39Default remote ping policies . . . . . . . . . 39Default SNMP threshold policies . . . . . . . 40Default SNMP link state policies . . . . . . . 42

Appendix B. Default poll definitions . . 43

Appendix C. Probe for TivoliNetcool/OMNIbus . . . . . . . . . . 49Configuration of the Probe for TivoliNetcool/OMNIbus . . . . . . . . . . . . 49

Properties file. . . . . . . . . . . . . 49Map file . . . . . . . . . . . . . . 49Rules file . . . . . . . . . . . . . . 50

Notices . . . . . . . . . . . . . . 51Trademarks . . . . . . . . . . . . . . 53

Index . . . . . . . . . . . . . . . 55

© Copyright IBM Corp. 2006, 2011 iii

iv IBM Tivoli Network Manager IP Edition: Network Polling Guide

About this publication

IBM Tivoli Network Manager IP Edition provides detailed network discovery,device monitoring, topology visualization, and root cause analysis (RCA)capabilities. Network Manager IP Edition can be extensively customized andconfigured to manage different networks.

The IBM Tivoli Network Manager IP Edition Network Polling Guide describes how touse IBM Tivoli Network Manager IP Edition to poll network devices.

Intended audienceThis publication is intended for users, and system and network administrators whoare responsible for configuring IBM Tivoli Network Manager IP Edition.

IBM Tivoli Network Manager IP Edition works in conjunction with IBM TivoliNetcool/OMNIbus; this publication assumes that you understand how TivoliNetcool/OMNIbus works. For more information on Tivoli Netcool/OMNIbus, seethe publications described in “Publications” on page vi.

What this publication contains

This publication contains the following sections:v Chapter 1, “About polling the network,” on page 1

Describes poll policies and poll definitions, and how they interact to create anetwork poll.

v Chapter 2, “Enabling and disabling polls,” on page 9Describes how to enable and disable polls.

v Chapter 3, “Creating polls,” on page 11Describes how to create polls, both by copying an existing poll and using thePoll Policy Wizard.

v Chapter 4, “Creating poll definitions,” on page 21Describes how to create new poll definitions.

v Chapter 5, “Changing polls,” on page 27Describes how to change polls.

v Chapter 6, “Deleting poll policies,” on page 35Describes how to delete poll policies when they are no longer required.

v Chapter 7, “Deleting poll definitions,” on page 37Describes how to delete poll definitions when they are no longer required.

v Appendix A, “Default poll policies,” on page 39Describes the poll policies that are included with an installation of IBM TivoliNetwork Manager IP Edition

v Appendix B, “Default poll definitions,” on page 43Describes the poll definitions that are included with an installation of IBM TivoliNetwork Manager IP Edition

v Appendix C, “Probe for Tivoli Netcool/OMNIbus,” on page 49

© Copyright IBM Corp. 2006, 2011 v

Describes the Probe for Tivoli Netcool/OMNIbus, the probe that enables eventsgenerated by the Network Manager IP Edition polls to be sent to the TivoliNetcool/OMNIbus ObjectServer.

PublicationsThis section lists publications in the Network Manager IP Edition library andrelated documents. The section also describes how to access IBM Tivolipublications online and how to order IBM Tivoli publications.

Network Manager IP Edition library

The following documents are available in the Network Manager IP Edition library:v IBM Tivoli Network Manager IP Edition Installation and Configuration Guide,

SC23-9498-01Describes how to install IBM Tivoli Network Manager IP Edition. It alsodescribes necessary and optional post-installation configuration tasks. Thispublication is for administrators who need to install and set up IBM TivoliNetwork Manager IP Edition.

v IBM Tivoli Network Manager IP Edition Administration Guide, SC23-9499-01Describes administration tasks for IBM Tivoli Network Manager IP Edition, suchas how to administer processes, query databases and start and stop the product.This publication is for administrators who are responsible for the maintenanceand availability of IBM Tivoli Network Manager IP Edition.

v IBM Tivoli Network Manager IP Edition Discovery Guide, SC23-9500-01Describes how to use IBM Tivoli Network Manager IP Edition to discover yournetwork. This publication is for administrators who are responsible forconfiguring and running network discovery.

v IBM Tivoli Network Manager IP Edition Product Overview, GC23-9497-01Gives an overview of IBM Tivoli Network Manager IP Edition. It describes theproduct architecture, components and functionality. This publication is foranyone interested in IBM Tivoli Network Manager IP Edition.

v IBM Tivoli Network Manager IP Edition Network Problem Resolution Guide,GC23-9903-01Describes how to use IBM Tivoli Network Manager IP Edition to troubleshootnetwork problems identified by the product. This publication is for networkoperators who are responsible for identifying or resolving network problems.

v IBM Tivoli Network Manager IP Edition Topology Visualization Guide, SC23-9902-01Describes how to use IBM Tivoli Network Manager IP Edition to visualize yourdiscovered network. This publication is for network operators who areresponsible for monitoring the health of the network.

v IBM Tivoli Network Manager IP Edition Management Database Reference,SC23-9906-00Describes the schemas of the component databases in IBM Tivoli NetworkManager IP Edition. This publication is for advanced users who need to querythe component databases directly.

v IBM Tivoli Network Manager IP Edition Topology Database Reference, SC23-9905-01Describes the schemas of the database used for storing topology data in IBMTivoli Network Manager IP Edition. This publication is for advanced users whoneed to query the topology database directly.

v IBM Tivoli Network Manager IP Edition Language Reference, SC23-9904-01

vi IBM Tivoli Network Manager IP Edition: Network Polling Guide

Describes the system languages used by IBM Tivoli Network Manager IPEdition, such as the Stitcher language, and the Object Query Language. Thispublication is for advanced users who need to customize the operation of IBMTivoli Network Manager IP Edition.

Prerequisite publications

To use the information in this publication effectively, you must have someprerequisite knowledge, which you can obtain from the following publications:v IBM Tivoli Netcool/OMNIbus Installation and Deployment Guide, SC23-9680

Includes installation and upgrade procedures for Tivoli Netcool/OMNIbus, anddescribes how to configure security and component communications. Thepublication also includes examples of Tivoli Netcool/OMNIbus architectures anddescribes how to implement them.

v IBM Tivoli Netcool/OMNIbus User's Guide, SC23-9683Provides an overview of the desktop tools and describes the operator tasksrelated to event management using these tools.

v IBM Tivoli Netcool/OMNIbus Administration Guide, SC23-9681Describes how to perform administrative tasks using the TivoliNetcool/OMNIbus Administrator GUI, command-line tools, and process control.The publication also contains descriptions and examples of ObjectServer SQLsyntax and automations.

v IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide, SC23-9684Contains introductory and reference information about probes and gateways,including probe rules file syntax and gateway commands.

v IBM Tivoli Netcool/OMNIbus Web GUI Administration and User's Guide SC23-9682Describes how to perform administrative and event visualization tasks using theTivoli Netcool/OMNIbus Web GUI.

Accessing terminology online

The Tivoli Software Glossary includes definitions for many of the technical termsrelated to IBM Tivoli software. The Tivoli Software Glossary is available at thefollowing IBM Tivoli software library Web site:

http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm

The IBM Terminology Web site consolidates the terminology from IBM productlibraries in one convenient location. You can access the Terminology Web site at thefollowing Web address:

http://www.ibm.com/software/globalization/terminology

Accessing publications online

IBM posts publications for this and all other IBM Tivoli products, as they becomeavailable and whenever they are updated, to the IBM Tivoli Information CenterWeb site at:

http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp

About this publication vii

http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm

http://www.ibm.com/software/globalization/terminology

http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp

Note: If you print PDF documents on other than letter-sized paper, set the optionin the File → Print window that allows Adobe Reader to print letter-sized pages onyour local paper.

Ordering publications

You can order many publications online at the following Web site:

http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss

You can also order by telephone by calling one of these numbers:v In the United States: 800-879-2755v In Canada: 800-426-4968

In other countries, contact your software account representative to order IBM Tivolipublications. To locate the telephone number of your local representative, performthe following steps:1. Go to the following Web site:

http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss2. Select your country from the list and click Go. The Welcome to the IBM

Publications Center page is displayed for your country.3. On the left side of the page, click About this site to see an information page

that includes the telephone number of your local representative.

AccessibilityAccessibility features help users with a physical disability, such as restrictedmobility or limited vision, to use software products successfully.

With this product, you can use assistive technologies to hear and navigate theinterface. You can also use the keyboard instead of the mouse to operate allfeatures of the graphical user interface.

Tivoli® technical training

For Tivoli technical training information, refer to the following IBM TivoliEducation Web site:

http://www.ibm.com/software/tivoli/education

Support informationIf you have a problem with your IBM software, you want to resolve it quickly. IBMprovides the following ways for you to obtain the support you need:

OnlineGo to the IBM Software Support site at http://www.ibm.com/software/support/probsub.html and follow the instructions.

IBM Support AssistantThe IBM Support Assistant (ISA) is a free local software serviceabilityworkbench that helps you resolve questions and problems with IBMsoftware products. The ISA provides quick access to support-relatedinformation and serviceability tools for problem determination. To installthe ISA software, go to http://www.ibm.com/software/support/isa

viii IBM Tivoli Network Manager IP Edition: Network Polling Guide



http://www.ibm.com/software/tivoli/education

http://www.ibm.com/software/support/probsub.html

http://www.ibm.com/software/support/probsub.html

http://www.ibm.com/software/support/isa

Conventions used in this publicationThis publication uses several conventions for special terms and actions andoperating system-dependent commands and paths.

Typeface conventions

This publication uses the following typeface conventions:

Bold

v Lowercase commands and mixed case commands that are otherwisedifficult to distinguish from surrounding text

v Interface controls (check boxes, push buttons, radio buttons, spinbuttons, fields, folders, icons, list boxes, items inside list boxes,multicolumn lists, containers, menu choices, menu names, tabs, propertysheets), labels (such as Tip: and Operating system considerations:)

v Keywords and parameters in text

Italic

v Citations (examples: titles of publications, diskettes, and CDs)v Words defined in text (example: a nonswitched line is called a

point-to-point line)v Emphasis of words and letters (words as words example: "Use the word

that to introduce a restrictive clause."; letters as letters example: "TheLUN address must start with the letter L.")

v New terms in text (except in a definition list): a view is a frame in aworkspace that contains data

v Variables and values you must provide: ... where myname represents....

Monospace

v Examples and code examplesv File names, programming keywords, and other elements that are difficult

to distinguish from surrounding textv Message text and prompts addressed to the userv Text that the user must typev Values for arguments or command options

Operating system-dependent variables and paths

This publication uses the UNIX convention for specifying environment variablesand for directory notation.

When using the Windows command line, replace $variable with %variable% forenvironment variables, and replace each forward slash (/) with a backslash (\) indirectory paths. For example, on UNIX systems, the $NCHOME environmentvariable specifies the directory where the Network Manager core components areinstalled. On Windows systems, the same environment variable is %NCHOME%.The names of environment variables are not always the same in the Windows andUNIX environments. For example, %TEMP% in Windows environments isequivalent to $TMPDIR in UNIX environments.

If you are using the bash shell on a Windows system, you can use the UNIXconventions.

About this publication ix

x IBM Tivoli Network Manager IP Edition: Network Polling Guide

Chapter 1. About polling the network

To poll the network, Network Manager periodically sends queries to the devices onthe network. These queries determine the behavior of the devices, for exampleoperational status, or the data in the Management Information Base (MIB)variables of the devices.

A network poll consists of a poll policy and a poll definition. Network Managerprovides default poll policies and definitions.

Network Manager uses the IBM Tivoli Netcool/OMNIbus SNMP trap probe andthe Syslog probe to monitor the network. To run Tivoli Netcool/OMNIbus probes,use Tivoli Netcool/OMNIbus process control.

The polling process is controlled by the ncp_poller process. The ncp_poller processstores SNMP information in the ncmonitor database; other data is storedin-memory.

Network Manager has a distributed polling mechanism to distribute the load. Ifthe default poller cannot handle the polling demands for your network, you mightneed to use the distributed polling feature.

For more information about administering distributed polling, see the IBM TivoliNetwork Manager IP Edition Administration Guide.

For more information about how to use Tivoli Netcool/OMNIbus process control,see the IBM Tivoli Netcool/OMNIbus Administration Guide.

Poll policiesPoll policies contain all the properties of a network poll operation. They specifyhow often a device is polled, the type of polling mechanism employed to do thepolling, and the information that is collected during the polling operation.

Use the poll policy to define the following parameters:v Name of the poll policyv Poll definition: A poll policy can have only one poll definition associated with it.

If interface-level filtering is required, the poll definition must contain certainsettings.

v Frequency of pollingv Enablement or disablement: A poll policy must be enabled for polling to take

place.v Storage of polled data for historical reporting: If this parameter is set, the data is

stored in the ncpoller database schema.

Restriction: Storage of polled data is not supported for the Cisco Remote Ping,the Juniper Remote Ping, and the Generic Threshold poll definitions.

v Poller to which to assign the poll policy, if distributed polling is set up.v Scope. This contains:

– Device classes from which retrieve data.

© Copyright IBM Corp. 2006, 2011 1

– Device filters: Specify the devices that you want to be polled by filteringagainst the values of fields in specified tables of the Network Connectivityand Inventory Model (NCIM) database. Multiple filters can be combined in aBoolean relationship.

– Interface filters: Specify the interfaces of the devices that you want to bepolled by filtering against the values of fields in the interfaces table.Multiple filters can be combined in a Boolean relationship.

Restriction: Interface filtering is available only for poll policies that have apoll definition based on one of the following poll definition types: interfaceping, SNMP link state, or basic threshold. Additionally, in the specified polldefinition, interface-level filtering must have been enabled.

Network Manager IP Edition provides default poll policies and definitions. Youmight have other polls available if you have migrated poll settings during theinstallation process of Network Manager IP Edition.Related reference

Appendix A, “Default poll policies,” on page 39Network Manager IP Edition provides a set of default poll policies. Use thisinformation to familiarize yourself with these policies and their definitions.

Poll definitionsPoll definitions determine how to poll a network entity. You must associate eachpoll policy with a poll definition. A poll policy can be associated with only onepoll definition.

Network Manager IP Edition provides default poll policies and definitions.

Use the poll definition to define the following parameters:v Namev Poll definition type: This determines the polling mechanism that the poll definition

uses, and restricts the scope of the poll operation in which it is used. Thefollowing polling mechanisms are used:– Ping polling– SNMP polling

v Description of the event that is generatedv Severity level of the event that is generated

Important: The severity level must correspond to a valid severity level asdefined in IBM Tivoli Netcool/OMNIbus.

v In case of threshold poll definitions, the threshold settings for generating andclearing an alert

Related reference

Appendix B, “Default poll definitions,” on page 43Network Manager IP Edition provides a number of default poll definitions thatfulfil the most common polling requirements.

2 IBM Tivoli Network Manager IP Edition: Network Polling Guide

Polling mechanismsPoll definitions use one of two possible polling mechanisms: ping polling andSNMP polling. All poll definitions are based on either of these mechanisms.

Ping pollingPing polling determines the availability of a network device or interface by usingan ICMP echo request.

The ping process ensures that a device is still present, live, and can be contacted inthe network by periodically sending an ICMP packet to an IP address and waitingfor a response.

A ping poll can have the following results:

SuccessfulA response to the ping packets is received. No alerts are generated.

FailureNo response to the ping packets is received within the time specified in thepoll definition. Alerts are raised for network entities that do not respond.

RestoreA device that was unreachable on the last ping attempt becomes reachableagain. An alert is generated to clear the ping failure alert.

Ping polling can be performed on either a chassis or an interface of a device. In thecase of a chassis, the ICMP packets are sent to the main node of an IP address. Themain-node IP address is also associated with an interface. In the case of interfaces,the ICMP packets are sent to the IP address of each interface. Consequently, if youenable ping polling for both chassis and interfaces, the traffic on main-node IPaddresses doubles.

Remember: By default, only the chassis ping poll is enabled on all devices withinthe discovered network topology, with the exception of end-node devices, such asdesktops and printers.

SNMP pollingSNMP polling involves retrieving Management Information Base (MIB) variablesfrom devices in order to determine faulty behavior or connection problems. Faultydevices or faulty connections are then diagnosed by applying predefined formulasto the extracted MIB variables.

Link state polling:

Link state polling monitors changes to the status of the following interface MIBvariables: ifOperStatus and ifAdminStatus.

If the value of one of these MIB variables changes between poll intervals, an eventis raised.

Example

If the value of ifOperStatus was 1 (up) during the previous poll, and changes to 2(down) in the current poll, an event is raised.

Chapter 1. About polling the network 3

The following table shows the events that are generated as a result of the changesin interface status. Additionally, an event is generated when a poll fails to returnany data, and an event with a clear severity is generated when a poll to the samedevice subsequently succeeds.

Table 1. Events generated by SNMP link state polling

Status of theifAdminStatus MIBvariable betweenpoll intervals

Status of theifOperStatus MIBvariable betweenpoll intervals Event generated Event Severity

Remains 1 (up) Changes from 1 (up)to 2 (down)

The interface hasgone down.

Minor

Remains 1 (up) Changes from 2(down) to 1 (up)

The interface hascome up.

Clear

Changes from 1 (up)to 2 (down)

Changes from 2(down) to 1 (up)

The interface hascome up, althoughit should be down.

Clear


Remains 2 (down) An administratorhas confirmed thatthe interfaceshould be down.

Clear



The interface hasgone down.

Minor


Remains 2 (down) An administratorhas instructed theinterface to comeup, but it hasn’t.

Minor

Remote ping polling:

During remote ping polling, enterprise-specific device MIBs are used to verify thestatus of the Multi-Protocol Label Switching (MPLS) path between devices. SpecificMIB modules allow a management station to initiate ping operations remotely.With SNMP remote ping operations you can monitor ping failures by using SNMP.

During remote ping poll operations, Network Manager IP Edition instructs aProvider Edge (PE) device to periodically ping the Customer Edge (CE) device towhich it is attached. The result of that remote ping operation provides informationabout whether the route (the MPLS path) from the PE device to the CE device isavailable or down.

Restriction: Remote ping operations are currently available for Cisco and Juniperdevices only.

For information about setting SNMP passwords, see the IBM Tivoli NetworkManager IP Edition Discovery Guide.

Prerequisites for remote ping polling

Before remote ping polling can operate, the following prerequisites must be met:v You must have write access to the PE device.v The MPLS paths must have been discovered, and the data transferred to the

NCIM database. In NCIM, the data must be located as follows:


– Virtual Private Network Router Forwarding (VRF) tables must be listed in theVPNRouteForwarding table.

– Links from PE to CE devices must be listed in the connects table.v For Juniper remote ping polling, you also require access to Juniper devices

through the View-Based Access Control Model (VACM).

For more information about the VPNRouteForwarding table and the connectstable, see the IBM Tivoli Network Manager IP Edition Topology Database Reference.

Threshold polling:

During threshold polling, predefined formulas are applied to the selected MIBvariables, and if the threshold is exceeded by the MIB variable, then an event isgenerated. A Clear event is generated when the value of the MIB variable eitherfalls below the threshold-value, or falls below a different clear-value.

You can set two thresholds:

Generate thresholdRequired: An event is generated when the value of the MIB variable orvariables exceeds the threshold.

Clear thresholdOptional: A clear-event is generated when the value of the MIB variablefalls below the threshold.

If you do not specify a clear-threshold, the raised event is cleared automaticallywhen the value of the MIB variable or variables no longer exceeds the value of thegenerate-threshold.

Example of threshold polling

The Monitoring Administrator wants to identify all Cisco 29xx routers that haveCPU usage greater than 75%. Using SNMP polling, the administrator can monitorthe behavior of all Cisco 29xx routers in the network, and define that an event isgenerated for each of these routers when their CPU usage exceeds 75%. Aclear-threshold can also be set to generate a notification when CPU usage dropsbelow 60%; if no clear-threshold is specified, a clear-event is generated when theCPU usage no longer exceeds 75%.

Basic and generic threshold polling

Use basic threshold polling to apply simple formulas to the MIB variables, or forfiltering the scope at device and interface level. To filter at interface level, the polldefinition must be set up for interface filtering.

Use generic threshold polling for complex formulas, or for filtering the scope atdevice level only.


Poll definition typesEach poll definition is based on a poll definition type. Poll definition types can begrouped according to the polling mechanism that they use.

Based on the polling mechanisms, the poll definition type restricts the scope of thepoll operation in which it is used.

Ping polling mechanism

The ping polling mechanism has the following poll definition types:

Chassis pingUsed for ping operations on interfaces that are associated with main-nodedevices.

Interface pingUsed for ping operations on interfaces within devices. An interface pingpoll definition has optional interface-level filtering.

SNMP polling mechanism

The SNMP polling mechanism has the following poll definition types:

Generic thresholdUsed for setting formulas to apply against MIB variables. A genericthreshold poll definition consists of the following thresholds:

Generate thresholdRequired: An event is generated when the value of the MIBvariable or variables exceeds the threshold.

Clear thresholdOptional: A Clear event is generated when the value of the MIBvariable falls below the threshold.

Basic thresholdIdentical to a generic threshold, with the addition of optionalinterface-level filtering.

SNMP Link stateUsed for checking the administrative and operational status. An SNMPlink state poll definition has optional interface-level filtering.

Cisco remote pingUsed for checking the availability of devices by using Cisco-specific MIBs.

Juniper remote pingFor checking the availability of devices by using Juniper-specific MIBs.

Related reference



Multibyte data in poll definitionsIf you are running Network Manager in a domain that uses multibyte characterssuch as Simplified Chinese, then you must ensure that Network Manager isconfigured to handle multibyte characters before you configure basic or genericthreshold poll definitions.

For information on how to configure Network Manager to use multibytecharacters, see the IBM Tivoli Network Manager IP Edition Installation andConfiguration Guide.


Chapter 2. Enabling and disabling polls

To activate Network Manager polling, you must enable the poll policies. If anetwork entity is off the network, disable the poll policy that polls that entity.

Tip: You can change the settings for a poll before enabling it. When creating yourown poll policies, use the default poll policies as examples.

By default, only the chassis ping poll is enabled on all devices within thediscovered network topology, with the exception of end-node devices, such asdesktops and printers.

To enable or disable polls:1. Click Administration → Network Polling.2. Select the check box next to the required policy or policies.3. Optional: To enable the selected policy or policies, click Enable Selected

Policies .

4. Optional: To disable policies, click Disable Selected Policies .5. Click OK.


Chapter 3. Creating polls

Create polls if the existing default poll policies and definitions do not meet yourrequirements. Either customize a copy of an existing or default poll, or create anew poll from scratchRelated tasks

Chapter 5, “Changing polls,” on page 27To change a poll, make changes to either the poll policy, or the poll definition onwhich the poll is based.

Creating polls by using existing pollsUse the Poll Policy Editor to create a new poll based on an existing poll definition.

Interface filtering is available only for poll policies that have a poll definition basedon one of the following poll definition types: interface ping, SNMP link state, orbasic threshold. Additionally, in the specified poll definition, interface-level filteringmust have been enabled. If these prerequisites are not met, the Interface Filterfunction is disabled. These restrictions apply to step 10 on page 12.

To create a new poll by using an existing poll:1. Click Administration → Network Polling.2. Make a copy of the required poll policy:

a. In the Select column, select the check box next to the required row and

click Copy Selected Items .b. Click OK.

The copy is added to the bottom of the list.3. Double-click the copy of the poll policy to open the Poll Policy Editor.

Tip: In the Poll Policy Editor, click Save only after you have finishedcompleting the tabs.

4. From the Poll Policy Properties tab, specify a value for each property:

Name Type the name that you want to give the poll policy.

Poll DefinitionSelect a poll definition for the poll policy.

IntervalType the required interval in seconds between poll operations.

Poll EnabledSelect this check box to enable the poll policy.

Store Poll DataSelect this check box to store the poll data so that it can besubsequently retrieved for reporting. The data is stored in the ncpollerdatabase schema.

Restriction: Storage of polled data is not supported for the CiscoRemote Ping, the Juniper Remote Ping, and the Generic Thresholdpoll definitions.


Assign to Poller InstanceFor distributed polling only: Select the poller on which to run the pollpolicy. If only a single poller is defined, the list is read-only.

5. Click the Classes tab. In the Classes tree, select the check boxes of therequired device classes.Attention: If you leave all classes unchecked, then the system polls alldevices that match the scope defined in the Device Filter tab. If no scope isset then, if you leave all classes unchecked, the poll that you create will pollall devices in the current network domain.

6. Optional: Click the Device Filter tab. Select the attribute table that you wantto filter against, and define the filter by using one of the following methods:v Type an SQL WHERE statement.

v Click Edit to set up the filter by using the Filter Builder.7. Optional: In the Filter Builder, build the required query on one of the two tabs

and then click OK:v On the Basic tab, select a field, a comparator, and type a value. Use the %

character as a wildcard. The field is restricted to the selected attribute table.v On the Advanced tab, type the required SQL WHERE statement.

The information that you enter on the Basic tab is automatically written to theAdvanced tab.

8. Optional: To add filters on other attribute tables, click Add new row , andrepeat the steps to edit the row and build the filter.

9. Optional: To combine multiple filters, click All or Any:v All: Only network entities that match all the specified filters are polled. For

example, if you create two filters, a network entity must match both filters.v Any: Network entities that match any of the specified filters are polled.

10. Optional: Click the Interface Filter tab and build the filter against the requiredfields. The Table field is prepopulated with the interfaces table.

11. Click Save.

The poll is added to the bottom of the list.Related concepts

“Poll definition types” on page 6Each poll definition is based on a poll definition type. Poll definition types can begrouped according to the polling mechanism that they use.

Creating new polls from scratchUse the Poll Configuration Wizard to guide you through the steps of creating anew poll policy. You can base the poll policy on an existing poll definition or usethe wizard to create a new definition.

Attention: Use the Poll Configuration Wizard only for generic threshold polldefinitions that use one trigger and one clear threshold. Use the Poll ConfigurationWizard to create a generic threshold poll definition that combines formulas fortrigger and clear thresholds.

Restriction: Do not use the Poll Configuration Wizard to create polls for whichyou want to store the poll data. Instead, use the Poll Policy Editor.


The steps you need to complete in the wizard to create a poll policy depend onwhether you want to use an existing poll definition or create a new poll definitionfor your policy:v If you select an existing poll definition, the settings of the poll definition are

used, and you need to set only the general properties and the scope for the pollpolicy. You can also use the Poll Policy Editor to create poll policies based onexisting poll definitions.

v If you create a new poll definition, the required settings are different for pingpoll and SNMP poll mechanisms. Threshold poll definition types require you toset formulas, whereas other poll definition types have predefined settings.

Related concepts

“Poll definition types” on page 6Each poll definition is based on a poll definition type. Poll definition types can begrouped according to the polling mechanism that they use.Related tasks

“Creating polls by using existing polls” on page 11Use the Poll Policy Editor to create a new poll based on an existing poll definition.

Creating basic threshold pollsUse the Poll Configuration Wizard to create polls based on new basic thresholdpoll definitions.

Restriction: Use the Poll Configuration Wizard to create only thresholds that arebased on single MIB variables or MIB Object Identifiers (OIDs). To createthresholds that contain expressions, use the Poll Definition Editor. You cannot usethe Poll Configuration Wizard for interface-level filtering based on basic thresholdpoll definition types. You must create a copy of an existing poll and use the PollPolicy Editor to make the required settings.

To create a basic threshold poll:1. Click Administration → Network Polling.2. Click Launch Poll Configuration Wizard.3. Click Next. Complete the Poll Policy Details page as follows:

Name Specify a name for the poll policy.

IntervalType the interval, in seconds, at which you want the network entity tobe polled.

Poll EnabledSpecify whether the poll should be enabled. The poll is enabled bydefault. To disable the poll, clear this check box.

Use existing poll definitionLeave this radio button deselected.

Create new poll definitionSelect this radio button and select Basic Threshold from the list.

4. Click Next. On the Poll Policy Scope Details page, provide the requiredfiltering information:v Type an SQL WHERE statement.

v Click Edit to set up the filter by using the Filter Builder.

Chapter 3. Creating polls 13

Attention: If you do not set a scope, then the poll that you create will pollall devices in the current network domain.

5. In the Filter Builder, build the required query on one of the two tabs and thenclick OK:v On the Basic tab, select a field, a comparator, and type a value. Use the %



6. To add filters on other attribute tables, click Add new row , and repeat thesteps to edit the row and build the filter.

7. To combine multiple filters, click All or Any:v All: Only network entities that match all the specified filters are polled. For


8. Click Next and complete the Poll Definition Details page as follows. The Typeand Event ID fields are disabled.

Name Type the name that you want to give the poll definition.

Event SeverityType a valid number. The severity level must correspond to a validseverity level as defined in IBM Tivoli Netcool/OMNIbus.

Note: If you type an invalid number and click Next, the wizard resets theevent severity to the nearest valid number and proceeds to the next pagewithout notifying you.

9. Click Next and set the formula according to which the trigger threshold isgenerated:a. Specify the first MIB variable for comparison. To select the MIB variable

from the MIB tree, click Open MIB picker .b. Select a comparator.c. Specify the second MIB variable for comparison. To select the MIB variable

from the MIB tree, click Open MIB picker .d. In the Generate Description field, type a description.e. To insert the MIB variables in the Generate Description field, click Open

MIB picker . Select the current, previous, or SNMP index value andclick Insert.

10. Click Next and set the formula according to which the clear threshold isgenerated:a. Specify the first MIB variable for comparison. To select the MIB variable


from the MIB tree, click Open MIB picker .d. In the Clear Description field, type a description.e. To insert the MIB variables in the Clear Description field, click Open MIB

picker . Select the current, previous, or SNMP index value and clickInsert.


11. Click Next. On the Poll Policy Summary page, review the information thatyou specified and click Finish.

Related concepts

“Multibyte data in poll definitions” on page 7If you are running Network Manager in a domain that uses multibyte characterssuch as Simplified Chinese, then you must ensure that Network Manager isconfigured to handle multibyte characters before you configure basic or genericthreshold poll definitions.

Creating generic threshold pollsUse the Poll Configuration Wizard to create polls based on new generic thresholdpoll definitions.

Generic threshold poll definition types require you to set formulas for the triggerand clear thresholds. To set a formula, select two MIB variables or MIB ObjectIdentifiers (OIDs) for comparison from the MIB tree, and select a comparator.

Restriction: Use the Poll Configuration Wizard to create only thresholds that arebased on single MIB variables or MIB Object Identifiers (OIDs). To createthresholds that contain expressions, use the Poll Definition Editor.

Attention: Use the Poll Configuration Wizard only for generic threshold polldefinitions that use one trigger and one clear threshold. Use the Poll ConfigurationWizard to create a generic threshold poll definition that combines formulas fortrigger and clear thresholds.

To create a generic threshold poll:1. Click Administration → Network Polling.2. Click Launch Poll Configuration Wizard.3. Click Next. Complete the Poll Policy Details page as follows:




Use existing poll definitionLeave this radio button deselected.

Create new poll definitionSelect this radio button and select Generic threshold from the list.

Restriction: Storage of polled data is not supported for the Cisco RemotePing, the Juniper Remote Ping, and the Generic Threshold poll definitions.

4. Optional: Click Next. On the Poll Policy Scope Details page, provide therequired filtering information:v Type an SQL WHERE statement.




5. Optional: In the Filter Builder, build the required query on one of the two tabsand then click OK:v On the Basic tab, select a field, a comparator, and type a value. Use the %



6. Optional: To add filters on other attribute tables, click Add new row , andrepeat the steps to edit the row and build the filter.

7. Optional: To combine multiple filters, click All or Any:v All: Only network entities that match all the specified filters are polled. For






9. Click Next and set the formula according to which the trigger threshold isgenerated:a. Specify the first MIB variable for comparison. To select the MIB variable


from the MIB tree, click Open MIB picker .d. In the Generate Description field, type a description.e. To insert the MIB variables in the Generate Description field, click Open

MIB picker . Select the current, previous, or SNMP index value andclick Insert.

10. Click Next and set the formula according to which the clear threshold isgenerated:a. Specify the first MIB variable for comparison. To select the MIB variable


from the MIB tree, click Open MIB picker .d. In the Clear Description field, type a description.e. To insert the MIB variables in the Clear Description field, click Open MIB

picker . Select the current, previous, or SNMP index value and clickInsert.



If you selected Poll enabled, the poll policy begins polling the networkimmediately. If you cleared Poll enabled, you must enable the poll policy if youwant it to begin polling.Related concepts

“Poll definition types” on page 6Each poll definition is based on a poll definition type. Poll definition types can begrouped according to the polling mechanism that they use.“Multibyte data in poll definitions” on page 7If you are running Network Manager in a domain that uses multibyte characterssuch as Simplified Chinese, then you must ensure that Network Manager isconfigured to handle multibyte characters before you configure basic or genericthreshold poll definitions.Related tasks


Creating ping and link state pollsUse the Poll Configuration Wizard to create polls based on the following polldefinition types: chassis ping, Cisco remote ping, interface ping, Juniper remoteping, and SNMP link state.

The steps that you perform in the Poll Configuration Wizard are identical whenyou create a poll based on the above poll definition types. The only difference isthe selection that you make from the Create new poll definition list.

Restriction: You cannot use the Poll Configuration Wizard for interface-levelfiltering based on interface ping or SNMP link state poll definition types. To dothis, create a copy of an existing poll and use the Poll Policy Editor to make therequired settings.

To create a ping poll or an SNMP link state poll1. Click Administration → Network Polling.2. Click Launch Poll Configuration Wizard.3. Click Next. Complete the Poll Policy Details page as follows:




4. Select Create new poll definition and select one of the following polldefinition types:v Chassis pingv Interface pingv Juniper remote pingv SNMP link state

5. Click Next. On the Poll Policy Scope Details page, provide the requiredfiltering information:v Type an SQL WHERE statement.




6. In the Filter Builder, build the required query on one of the two tabs and thenclick OK:v On the Basic tab, select a field, a comparator, and type a value. Use the %










10. Click Next and complete the Ping Poll Definition page as follows:

TimeoutType the number of seconds you want the poll policy to wait after ithas pinged the network entity before retrying.

RetriesType the number of times you want the poll policy to retry pingingthe network entity. The maximum number of retries is five.

Note: If you type an invalid number and click Next, the wizard defaults theevent severity to the nearest valid number and proceeds to the next pagewithout notifying you.


If you selected Poll enabled, the poll policy begins polling the networkimmediately. If you cleared Poll enabled, you must enable the poll policy if youwant it to begin polling.


Related concepts

“Poll definition types” on page 6Each poll definition is based on a poll definition type. Poll definition types can begrouped according to the polling mechanism that they use.Related tasks



Chapter 4. Creating poll definitions

Use the Poll Definition Editor to guide you through the steps of creating a newpoll definition.

Before you create or change a poll definition, view an existing poll definition todetermine whether you can use the poll as a template to create a new polldefinition.

Because the poll definition types differ, the Poll Definition Editor displays differentpages depending on which poll definition type you select.

Tip: If you want to create a new poll (that is, a poll policy and poll definition)from scratch, use the Poll Configuration Wizard. The wizard guides you throughall the required settings for both the poll policy and poll definition.Related tasks

“Changing poll definitions” on page 30Change existing poll definitions to customize them for your polling requirements.You change poll definitions in the Poll Definition Editor; the steps you follow differdepending on the poll definition type.“Creating new polls from scratch” on page 12Use the Poll Configuration Wizard to guide you through the steps of creating anew poll policy. You can base the poll policy on an existing poll definition or usethe wizard to create a new definition.Related reference


Creating generic threshold poll definitionsUse the Poll Definition Editor to create new generic threshold poll definitions.

When creating a generic threshold definition, you set formulas and combineformulas.

To create a generic threshold poll definition:1. Click Administration → Network Polling and scroll to the Configure Poll

Definitions page.

2. Click Add New Row . The New Poll Definition Type Selection page isdisplayed.

3. Select Generic Threshold from the list and click OK.4. In the Poll Definition Editor, under the General tab, complete the General

Properties fields as follows:

Name Specify a name for the poll definition.

Type This field is disabled.

Event IDThis field is disabled.


SeveritySpecify a valid number for the severity. The severity level mustcorrespond to a valid severity level as defined in IBM TivoliNetcool/OMNIbus.

5. Click the Trigger Threshold tab. Build the formula that specifies the thresholdby using one of the following methods:v On the Basic tab, use the fields and options to build a formula. To select

values from the MIB tree, click Open MIB Tree .v On the Advanced tab, type the required eval statement in Object Query

Language (OQL).6. Specify the message that is displayed in the AEL for the generated event:

a. In the Event description field, type the message.

b. To insert the MIB variables in the field, click Open MIB Tree . Set themessage to include either the current or previous SNMP value, or theSNMP index, and click OK.

7. Click the Clear Threshold tab. Build the formula that specifies the threshold byusing one of the following methods:v On the Basic tab, use the fields and options to build a formula. To select





9. Click Save, then click OK.

The poll definition is added to the bottom of the list.Related concepts


Creating basic threshold poll definitionsCreate a basic threshold poll definition to run simple formulas against MIBvariables, or to create threshold polls with interface-level filtering.

Before you create or change a poll definition, view an existing poll definition todetermine whether you can use the poll as a template to create a new polldefinition.

To create a basic threshold poll definition:1. Click Administration → Network Polling and scroll to the Configure Poll

Definitions page.



3. Select Basic threshold from the list and click OK.4. In the Poll Definition Editor, under the General tab, complete the General






5. Click the Poll Data tab and specify the required formula:v To specify a MIB Object Identifier (OID), select Single OID. Specify the

current or delta value of the required MIB variable and type the variable intothe next field.

v To specify a complex expression, select Expression and type the formula intothe field.

To select variables directly from the MIB tree, click Add MIB Object . Fromthe MIB tree, you can specify the current or previous values of the selected MIBvariable, or resolve the current value of the variable to the SNMP index.

6. To enable interface-level filtering, select the Enable Interface Level Filteringcheck box. This setting restricts the polled interfaces to MIBs that are based onifIndexes.

7. Click the Threshold tab and specify the formulas for triggering events andclearing events. The MIB OID or expression that you specified on the Poll Datatab is written automatically into the formulas.a. In the Trigger Threshold area, select a comparator from the list and type

the value against which to filter the MIB OID.b. In the Description field, type a meaningful description of the

trigger-formula. Add the MIB variable to the description in parentheses. Thedescription is displayed in the AEL when an event is raised. For example:CPU usage high (avgBusy5=)

c. To insert the underlying eval statement into the description, position the

cursor before the closing parenthesis and click Add MIB Object andnavigate the to specified variable. Specify whether the current or previousvalue of the variable is evaluated, or whether the value is resolved to theSNMP index, and click OK. The statement is inserted, for example:CPU usage high (avgBusy5= eval(int,SNMP.VALUE.avgBusy5"))

d. Repeat steps 7a to 7c for the Clear Threshold area.8. Click Save.Related concepts


Chapter 4. Creating poll definitions 23

Example trigger and clear thresholdsUse the example threshold formulas to set up the clear and trigger thresholds forgeneric threshold poll definitions.

Example trigger threshold

The following example would raise an event in the following cases:v When the current value of the avgBusy5 MIB variable is equal to or greater than

the value of the avgBusy6 MIB variable

To create this threshold, specify the following information on the TriggerThreshold tab of the Poll Definition Editor:1. Select Basic.2. Specify the first threshold:

a. Select Current.

b. Click Add MIB Object .c. Expand the MIB Tree to the following path:

iso/org/dod/internet/private/enterprises/cisco/local/lsystem/avgBusy5

Click Insert

d. Select the comparator >=.e. Select current.

f. Click Add MIB Object .g. Expand the MIB Tree to the following path:


Click Insert.3. Specify the message that is displayed in the Active Event List when the event is

raised:a. In the Event description field, type CPU usage high (avgBusy5= .



d. Select Current SNMP Value and click Insert.e. Type >=.

f. Click Add MIB Object .g. Expand the MIB Tree to the following path:


h. Type ).

The description for the Active Event List should now read as follows:CPU usage high (avgBusy5=eval(text,"SNMP.VALUE.avgBusy5")>=eval(text,"SNMP.VALUE.avgBusy6"))

Example clear threshold

The following example would raise a Clear event in the following cases:v When the value of the avgBusy5 MIB variable is less than 80.


To create this threshold, specify the following information on the Clear Thresholdtab of the Poll Definition Editor:1. Select Basic.2. Specify the threshold:

a. Select Current.



Click Insert

d. Select the comparator <=.e. Select literal.f. Type 80.

3. Specify the message that is displayed in the Active Event List when the event israised:a. In the Event description field, type CPU usage high (avgBusy5= .



d. Select Current SNMP Value and click Insert.e. Type <=.f. Type 80.g. Type ).

The description for the Active Event List should now read as follows:CPU usage high (avgBusy5=eval(text,"SNMP.VALUE.avgBusy5")<=80)

Creating ping and link state poll definitionsUse the Poll Definition Editor to create new poll definitions with the following polldefinition types: chassis ping, Cisco remote ping, interface ping, Juniper remoteping, SNMP link state.

You perform identical steps to create a poll definition based on all the above polldefinition types.

To create a ping poll definition, or an SNMP link state poll definition:1. Click Administration → Network Polling and scroll to the Configure Poll

Definitions page.


3. Select the required definition type from the list:v Chassis Pingv Cisco Remote Pingv Interface Pingv Juniper Remote Pingv SNMP Link State

4. Click OK.

Chapter 4. Creating poll definitions 25

5. In the Poll Definition Editor, under the General tab, complete the GeneralProperties fields as follows:





6. Click the Ping tab and complete the Ping Properties fields as follows:

TimeoutSpecify, in milliseconds, how long you want the poll definition to waitafter it has pinged the network entity before retrying.

RetriesSpecify how many times you want the the poll definition to retrypinging the network entity.

7. Click Save, then click OK.

The poll definition is added to the bottom of the list.


Chapter 5. Changing polls

To change a poll, make changes to either the poll policy, or the poll definition onwhich the poll is based.Related concepts

“Poll policies” on page 1Poll policies contain all the properties of a network poll operation. They specifyhow often a device is polled, the type of polling mechanism employed to do thepolling, and the information that is collected during the polling operation.“Poll definitions” on page 2Poll definitions determine how to poll a network entity. You must associate eachpoll policy with a poll definition. A poll policy can be associated with only onepoll definition.Related tasks

Chapter 3, “Creating polls,” on page 11Create polls if the existing default poll policies and definitions do not meet yourrequirements. Either customize a copy of an existing or default poll, or create anew poll from scratchRelated reference


Changing poll policiesUse the Poll Policy Editor to change the settings of existing poll policies.

Before you create or change a poll policy, view an existing poll policy to determinewhether you can use the poll as a template to create a new poll policy.

Interface filtering is available only for poll policies that have a poll definition basedon one of the following poll definition types: interface ping, SNMP link state, orbasic threshold Additionally, in the specified poll definition, interface-level filteringmust have been enabled. If these prerequisites are not met, the Interface Filter isdisabled. These restrictions apply to step 9 on page 28.

To change a poll policy:1. Click Administration → Network Polling.2. Double-click the required poll policy. The Poll Policy Editor is displayed; the

settings of the selected poll policy are automatically loaded into the fields.3. Under Poll Policy Properties, specify a value for the following fields:

Name Type the name that you want to give the poll policy.

Poll DefinitionSelect a poll definition for the poll policy.

IntervalType the required interval in seconds between poll operations.

Poll EnabledSelect this check box to enable the poll policy.


Store Poll DataSelect this check box to store the poll data so that it can besubsequently retrieved for reporting. The data is stored in the ncpollerdatabase schema.

Restriction: Storage of polled data is not supported for the CiscoRemote Ping, the Juniper Remote Ping, and the Generic Thresholdpoll definitions.

Assign to Poller InstanceFor distributed polling only: Select the poller on which to run the pollpolicy. If only a single poller is defined, the list is read-only.

4. Click the Classes tab. In the Classes tree, select the required device classes.Attention: If you leave all classes unchecked, then the system polls alldevices that match the scope defined in the Device Filter tab. If no scope isset then, if you leave all classes unchecked, the poll that you create will pollall devices in the current network domain.

5. Optional: Click the Device Filter tab.v Type an SQL WHERE statement.

v Click Edit to set up the filter by using the Filter Builder.6. In the Filter Builder, build the required query on one of the two tabs and then

click OK:v On the Basic tab, select a field, a comparator, and type a value. Use the %






9. Optional: Click the Interface Filter tab and build the filter against the requiredfields. The Table field is prepopulated with the interfaces table.

10. Click Save.Related reference



Example customized poll policyUse this example of a customized poll policy to help you copy an existing policyand customize it to your requirements.

Scenario

You must create a poll policy that meets the following requirements:v The poll policy must check the network for devices in class C subnets that have

the IP address 9.1.2.* or 10.123.46*v The poll policy must check the matching subnets for interfaces that have a

description starting with “FastEtherNet.”v The poll policy must check the network at intervals of 60 secondsv The poll policy must begin polling the network immediately after it has been

saved

Required settings

To create a poll that responds to the requirements describe in “Scenario,” make thefollowing settings:1. On the Configure Poll Policies page, make a copy of the ifInErrors poll policy.

Click the copy to edit it in the Poll Policy Editor.2. On the Poll Policy Properties tab, make the following setting:

Name Type a meaningful name, for example Class C subnets with 9.1.2*and 10.123.46* and interface "FastEtherNet*".

IntervalType 60.

Poll Enabled:Select this check box.

3. On the Classes tab, select the NetworkDevice node.4. On the Device Filter tab, make the following settings:

a. Select Any.b. Select mainNodeDetails from the Table list.c. To specify the filter against fields of the ipAddress table, click Open Filter

Builder .d. On the Basic tab of the Filter Builder, complete the fields as follows:

Field Comparator ValueipAddress like 9.1.2.%

e. Click Add and complete the fields as follows:

Field Comparator ValueipAddress like 10.123.46.%

5. On the Interface Filter tab, make the following settings:v Select Any. The Table list is prepopulated with the interface.v To specify the filter against fields of the interfacetable, click Open Filter

Builder .v On the Basic tab of the Filter Builder, complete the fields as follows:

Chapter 5. Changing polls 29

Field Comparator ValueifDescr like ’FastEtherNet%’

Related reference


Changing poll definitionsChange existing poll definitions to customize them for your polling requirements.You change poll definitions in the Poll Definition Editor; the steps you follow differdepending on the poll definition type.

Before you create or change a poll definition, view an existing poll definition todetermine whether you can use the poll as a template to create a new polldefinition.Related tasks

Chapter 4, “Creating poll definitions,” on page 21Use the Poll Definition Editor to guide you through the steps of creating a newpoll definition.Related reference

Appendix B, “Default poll definitions,” on page 43Network Manager IP Edition provides a number of default poll definitions thatfulfil the most common polling requirements.Appendix A, “Default poll policies,” on page 39Network Manager IP Edition provides a set of default poll policies. Use thisinformation to familiarize yourself with these policies and their definitions.

Changing generic threshold poll definitionsUse the Poll Definition Editor to change generic threshold poll definitions.

You can change some of the general properties of the poll definition and theproperties that are associated with the poll definition type. However, you cannotchange the poll definition type.

To change a generic threshold poll definition:1. Click Administration → Network Polling and scroll to the Configure Poll

Definitions page.2. Click the required poll definition.3. In the Poll Definition Editor, under the General tab, complete the General







4. Click the Trigger Threshold tab. Build the formula that specifies the thresholdby using one of the following methods:v On the Basic tab, use the fields and options to build a formula. To select





6. Click the Clear Threshold tab. Build the formula that specifies the threshold byusing one of the following methods:v On the Basic tab, use the fields and options to build a formula. To select





8. Click Save, then click OK.Related concepts

“Multibyte data in poll definitions” on page 7If you are running Network Manager in a domain that uses multibyte characterssuch as Simplified Chinese, then you must ensure that Network Manager isconfigured to handle multibyte characters before you configure basic or genericthreshold poll definitions.Related reference


Changing basic threshold poll definitionsUse the Poll Definition Editor to change basic threshold poll definitions.

To change a basic threshold poll definition:1. Click Administration → Network Polling and scroll to the Configure Poll

Definitions page.2. Click the required poll definition. The poll definition must have the poll

definition type Basic threshold.3. In the Poll Definition Editor, under the General tab, complete the General







4. Click the Poll Data tab and specify the required formula:v To specify a MIB Object Identifier (OID), select Single OID. Specify the

current or delta value of the required MIB variable and type the variable intothe next field.

v To specify a complex expression, select Expression and type the formula intothe field.

To select variables directly from the MIB tree, click Add MIB Object . Fromthe MIB tree, you can specify the current or previous values of the selected MIBvariable, or resolve the current value of the variable to the SNMP index.

5. To enable interface-level filtering, select the Enable Interface Level Filteringcheck box. This setting restricts the polled interfaces to MIBs that are based onifIndexes.

6. Click the Threshold tab and specify the formulas for triggering events andclearing events. The MIB OID or expression that you specified on the Poll Datatab is written automatically into the formulas.a. In the Trigger Threshold area, select a comparator from the list and type

the value against which to filter the MIB OID.b. In the Description field, type a meaningful description of the trigger

formula. Add the MIB variable to the description in parentheses. Thedescription is displayed in the AEL when and event is raised. For example:CPU usage high (avgBusy5=)

c. To insert the underlying eval statement into the description, position the

cursor before the closing parenthesis, click Add MIB Object , andnavigate to the specified variable. Specify whether the current or previousvalue of the variable is evaluated, or whether the value is resolved to theSNMP index, and click OK. The statement is inserted, for example:CPU usage high (avgBusy5= eval(int,SNMP.VALUE.avgBusy5"))

d. Repeat steps 6a to 6c for the Clear Threshold area.7. Click Save.Related concepts


Changing ping and link state poll definitionsUse the Poll Definition Editor to change the following poll definition types: Ciscoremote ping, interface ping, Juniper remote ping, and SNMP link state.

You can change some of the general properties of the poll definition and theproperties that are associated with the poll definition type. However, you cannotchange the poll definition type.

To change a ping poll definition, or an SNMP link state poll definition:1. Click Administration → Network Polling and scroll to the Configure Poll

Definitions page.


2. Click the required poll definition. The poll definition must have one of thefollowing poll definition types:v Cisco remote pingv Interface pingv Juniper remote pingv SNMP link state

3. In the Poll Definition Editor, under the General tab, complete the GeneralProperties fields as follows:





4. Click Save, then click OK.Related reference



Chapter 6. Deleting poll policies

Delete poll policies when they are no longer required.

To delete a poll policy:1. Click Administration → Network Polling.2. In the Select column, select the required poll policies.

3. Click Delete .4. Click OK to confirm the deletion.

The selected poll policies are deleted.


Chapter 7. Deleting poll definitions

Delete poll definitions when they are no longer required.

To delete a poll definition:1. Click Administration → Network Polling and scroll to the Configure Poll

Definitions page.2. In the Select column, select the required poll definitions.

3. Click Delete .4. Click OK to confirm the deletion.

The selected poll definitions are deleted.


Appendix A. Default poll policies

Network Manager IP Edition provides a set of default poll policies. Use thisinformation to familiarize yourself with these poll policies.

Default ping policiesNetwork Manager IP Edition provides default poll policies for ping operations.

The following table provides information on the default ping poll policies.

Table 2. Default ping poll policies

Poll Policy Name Description

Default Chassis Ping Uses the Default Chassis Ping poll definition to performping operations on all network devices, as defined by theclass settings.

This is the only poll policy to be enabled by default.

Default Interface Ping Uses the Default Interface Ping poll definition to performping operations on all interfaces that are within a mainnode with a valid IP address, as defined by the class andscope settings.

End Node Ping Uses the End Node Ping poll definition to perform pingoperations on all end nodes, as defined by the classsettings.

Related concepts


Default remote ping policiesNetwork Manager IP Edition provides default poll policies for remote pingoperations.

The following table provides information on the default remote ping poll policies.

Table 3. Default remote ping poll policies

Poll policy name Description

Cisco Remote Ping Uses the Cisco Remote Ping poll definition to check theavailability of MPLS paths between Cisco Physical Edge(PE) and Customer Edge (CE) devices through SNMPremote ping operations, as defined by the class settings.

This poll policy is applicable only to Cisco devices.


Table 3. Default remote ping poll policies (continued)

Poll policy name Description

Juniper Remote Ping Uses the Juniper Remote Ping poll definition to check theavailability of MPLS paths between Juniper PE and CEdevices through SNMP remote ping operations, as definedby the class settings.

This poll policy is applicable only to Juniper devices.

Restriction: Storage of polled data is not supported for the Cisco Remote Ping, theJuniper Remote Ping, and the Generic Threshold poll definitions.

Default SNMP threshold policiesDefault SNMP threshold poll policies are provided with the product. These pollpolicies are classified as basic or generic; in addition, some are vendor-specific.

Threshold policies

The following table describes the SNMP threshold poll policies.

Table 4. Basic SNMP threshold poll policies

Name Description

dot3StatsAlignmentErrors Poll definition type: Basic threshold. Usesthe dot3StatsAlignmentErrors poll definitionto perform threshold polling on all networkdevices, as defined by the class settings.

frCircuitReceivedBECNs Poll definition type: Basic threshold. Usesthe frCircuitReceivedBECNs poll definitionto perform threshold polling on all networkdevices, as defined by the class settings.

frCircuitReceivedFECNs Poll definition type: Basic threshold. Usesthe frCircuitReceivedFECNs poll definitionto perform threshold polling on all networkdevices, as defined by the class settings.

ifInDiscards Poll definition type: Basic threshold. Usesthe ifInDiscards poll definition to performthreshold polling on all network devices, asdefined by the class settings.

ifInErrors Poll definition type: Basic threshold. Usesthe ifInErrors poll definition to performthreshold polling on all network devices, asdefined by the class settings.

ifOutDiscards Poll definition type: Basic threshold. Usesthe ifOutDiscards poll definition to performthreshold polling on all network devices, asdefined by the class settings.

ifOutErrors Poll definition type: Basic threshold. Usesthe ifOutErrors poll definition to performthreshold polling on all network devices, asdefined by the class settings.


Table 4. Basic SNMP threshold poll policies (continued)

Name Description

snmpInBandwidth Poll definition type: Basic threshold. Usesthe snmpInBandwidth poll definition toperform threshold polling on all networkdevices, as defined by the class settings.

snmpOutBandwidth Poll definition type: Basic threshold. Usesthe snmpOutBandwidth poll definition toperform threshold polling on all networkdevices, as defined by the class settings.

bgpPeerState Poll definition type: Generic threshold. Usesthe bgpPeerState poll definition to performthreshold polling on all network deviceswith an IP forwarding capability, as definedby the class settings and the scope settings.

frCircuitState Poll definition type: Generic threshold. Usesthe frCircuitState poll definition to performthreshold polling on all network devices, asdefined by the class settings.

isdnLinkUp Poll definition type: Generic threshold. Usesthe isdnLinkUp poll definition to performthreshold polling on all network devices, asdefined by the class settings.

rebootDetection Poll definition type: Generic threshold. Usesthe rebootDetection poll definition toperform threshold polling on all networkdevices, as defined by the class settings.

Foundry SNMP threshold poll policies

The following table describes the SNMP threshold policies that are supplied forFoundry devices.

Table 5. SNMP threshold poll policies for Foundry devices

Name Description

snChasActualTemperature Uses the snChasActualTemperature poll definition toperform threshold polling on all Foundry devices, asdefined by the class settings.

snChasFanOperStatus Uses the snChasFanOperStatus poll definition to performthreshold polling on all Foundry devices, as defined by theclass settings.

snChasPwrSupplyOperStatus Uses the snChasPwrSupplyOperStatus poll definition toperform threshold polling on all Foundry devices, asdefined by the class settings.

Cisco SNMP threshold policies

The following table describes the SNMP threshold poll policies that are providedfor Cisco devices.

Appendix A. Default poll policies 41

Table 6. SNMP threshold poll policies for Cisco devices

Name Description

bufferPoll Uses the bufferPoll poll definition to perform thresholdpolling on all Cisco devices, as defined by the classsettings.

ciscoEnvMonFanState Uses the ciscoEnvMonFanState poll definition to performthreshold polling on all Cisco devices, as defined by theclass settings.

ciscoEnvMonSupplyState Uses the ciscoEnvMonSupplyState poll definition toperform threshold polling on all Cisco devices, as definedby the class settings.

ciscoEnvMonTemperatureState

Uses the ciscoEnvMonTemperatureState poll definition toperform threshold polling on all Cisco devices, as definedby the class settings.

ciscoMemoryPool Uses the ciscoMemoryPool poll definition to performthreshold polling on all Cisco devices, as defined by theclass settings.

cpuBusyPoll Uses the cpuBusyPoll poll definition to perform thresholdpolling on all Cisco devices, as defined by the classsettings.

locIfInCrcErrors Uses the locIfInCrcErrors poll definition to performthreshold polling on all Cisco devices, as defined by theclass settings.

memoryPoll Uses the memoryPoll poll definition to perform thresholdpolling on all Cisco devices, as defined by the classsettings.

sysTrafficPoll Uses the sysTrafficPoll poll definition to perform thresholdpolling on all Cisco devices, as defined by the classsettings.

Default SNMP link state policiesThe default SNMP Link State poll policy uses the SNMP Link State poll definitionto check the administrative and operational statuses of all network devices, asdefined by the class settings. Events are generated if there are changes in interfacestatus.


Appendix B. Default poll definitions

Network Manager IP Edition provides a number of default poll definitions thatfulfil the most common polling requirements.

The following table describes the default poll definitions that Network Manager IPEdition provides.

Default SNMP poll definitions

bgpPeerStatePoll definition type: Generic threshold. This poll definition defines BGPpeer-state checking. An alert is raised when Border Gateway Patrol(BGP)peers change to an unestablished state. This poll definition polls thebgpPeerState MIB variable, which has the following path and OID:

Path: iso/org/dod/mgmt/mib-2/bgpPeerTable/bgpPeerEntry/bgpPeerState

MIB OID: 1.3.6.1.2.1.15.3.1.2

bufferPollPoll definition type: Basic threshold. This poll definition definesbuffer-exhaustion checking. An alert is raised when the number of freebuffer elements falls below 100. This poll definition polls the bufferElFreeMIB variable, which has the following path and OID:

MIB path: iso/org/dod/private/enterprises/cisco/local/bufferElFree

MIB OID: 1.3.6.1.4.1.9.2.1.9

ciscoEnvMonFanStatePoll definition type: Generic threshold. This poll definition definesfan-status checking for Cisco devices. An alert is raised if the statuschanges to anything other than 1 (normal). This poll definition polls theciscoEnvMonFanState MIB variable, which has the following path andOID:

MIB Path: iso/org/dod/mgmt/mib-2/private/enterprises/cisco/ciscoMgmt/ciscoEnvMonMIB/ciscoEnvMonObjects/ciscoEnvMonFanStatusTable/ciscoEnvMonFanStatusEntry/ciscoEnvMonFanState

MIB OID: 1.3.6.1.4.1.9.9.13.1.4.1.3

ciscoEnvMonSupplyStatePoll definition type: Generic threshold. This poll definition defines thechecking of the power-supply status for Ciso devices. An alert is raised ifthe status changes to anything other than 1 (normal). This poll definitionpolls the ciscoEnvMonSupplyState MIB variable, which has the followingpath and OID:

MIB path: iso/org/dod/mgmt/mib-2/private/enterprises/cisco/ciscoMgmt/ciscoEnvMonMIB/ciscoEnvMonObjects/ciscoEnvMonSupplyStatusTable/ciscoEnvMonSupplyStatusEntry/ciscoEnvMonSupplyState

MIB OID: 1.3.6.1.4.1.9.9.13.1.5.1.3


ciscoEnvMonTemperatureStatePoll definition type: Generic threshold. This poll definition defines thechecking of the fan-temperature status for Cisco devices. An alert is raisedif the status changes to anything other than 1 (normal). This poll definitionpolls the ciscoEnvMonTemperatureState MIB variable, which has thefollowing path and OID:

MIB path: iso/org/dod/mgmt/mib-2/private/enterprises/cisco/ciscoMgmt/ciscoEnvMonMIB/ciscoEnvMonObjects/ciscoEnvMonTemperatureStatusTable/ciscoEnvMonTemperateureStatusEntry/ciscoEnvMonTemperatureState

MIB OID: 1.3.6.1.4.1.9.9.13.1.3.1.6

ciscoMemoryPoolPoll definition type: Generic threshold. This poll definition defines thechecking of memory-pool usages for Cisco devices. An alert is raised whenthe memory pool usage exceeds 80%. This poll definition polls thefollowing MIB variables:

ciscoMemoryPoolUsed

MIB path: iso/org/dod/mgmt/mib-2/private/enterprises/cisco/ciscoMgmt/ciscoMemoryPoolMIB/ciscoMemoryPoolObjects/ciscoMemoryPoolTable/ciscoMemoryPoolEntry/ciscoMemoryPoolUsed

MIB OID: 1.3.6.1.4.1.9.9.48.1.1.1.5

ciscoMemoryPoolFree

MIB path: iso/org/dod/mgmt/mib-2/private/enterprises/cisco/ciscoMgmt/ciscoMemoryPoolMIB/ciscoMemoryPoolObjects/ciscoMemoryPoolTable/ciscoMemoryPoolEntry/ciscoMemoryPoolFree

MIB OID: 1.3.6.1.4.1.9.9.48.1.1.1.6

Cisco Remote PingPoll definition type: Cisco remote ping. This poll definition defines remoteping operations that use Cisco-specific MIBs.

cpuBusyPollPoll definition type: Basic threshold. This poll definition defines CPU usagechecking. An alert is raised when the value of the avgBusy5 Cisco MIBvariable exceeds 80%. This poll definition polls the avgBusy5 MIB variable,which has the following path and OID:

MIB path: iso/org/dod/private/enterprises/cisco/local/avgBusy5MIB OID: 1.3.6.1.4.1.9.2.1.58

dot3StatsAlignmentErrorsPoll definition type: Basic threshold. This poll definition defines thechecking of error rates for alignments. An alert is raised when the errorrate exceeds 0 per second. This poll definition polls thedot3StatsAlignmentErrors MIB variable, which has the following path andOID:

MIB path: iso/org/dod/mgmt/mib-2/transmission/dot3/dot3StatsTable/dot3StatusEntry/dot3StatsAlignmentErrors

MIB OID: 1.3.6.1.2.1.10.7.2.1.2

frCircuitReceivedBECNsPoll definition type: Basic threshold. This poll definition defines FrameRelay backward-congestion checking for a data link connection identifier


(DLCI). An alert is raised when backward-congestion notices are receivedfor DLCI. This poll definition polls the frCircuitReceivedBECNs MIBvariable, which has the following path and OID:

MIB path: iso/org/dod/mgmt/mib-2/transmission/frameRelayDTE/frCircuitTable/frCircuitEntry/frCircuitReceivedBECNs

MIB OID: 1.3.6.1.2.1.10.32.2.1.5

frCircuitReceivedFECNsPoll definition type: Basic threshold. This poll definition defines FrameRelay forward-congestion checking for DLCI. An alert is raised whenforward-congestion notices are received for DLCI. This poll definition pollsthe frCircuitReceivedFECNs MIB variable, which has the following pathand OID:

MIB path: iso/org/dod/mgmt/mib-2/transmission/frameRelayDTE/frCircuitTable/frCircuitEntry/frCircuitReceivedFECNs

MIB OID: 1.3.6.1.2.1.10.32.2.1.4

frCircuitStatePoll definition type: Generic threshold. This poll definition defines FrameRelay circuit-state checking. An alert is raised when a circuit becomesinactive. To avoid generating alerts for circuits that are inactive at startup,the definition checks for inactive circuits. This poll definition polls thefrCircuitState MIB variable, which has the following path and OID:

MIB path: iso/org/dod/mgmt/mib-2/transmission/frameRelayDTE/frCircuitTable/frCircuitEntry/frCircuitState

MIB OID: 1.3.6.1.2.1.10.32.2.1.3

ifInDiscardsPoll definition type: Basic threshold. This poll definition defines inbounddiscard-rate checking. An alert is raised when the rate exceeds 0 persecond. This poll definition polls the ifInDiscards MIB variable, which hasthe following path and OID:

MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifInDiscards

MIB OID: 1.3.6.1.2.1.2.2.1.13

ifInErrorsPoll definition type: Basic threshold. This poll definition defines inboundinterface error-rate checking. An alert is raised when the rate exceeds 0 persecond. This poll definition polls the ifInErrors MIB variable, which has thefollowing path and OID:

MIB path:iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifInErrors

MIB OID: 1.3.6.1.2.1.2.2.1.14

ifOutDiscardsPoll definition type: Basic threshold. This poll definition defines outbounddiscard-rate checking. An alert is raised when the rate exceeds 0 persecond. This poll definition polls the ifOutDiscards MIB variable, whichhas the following path and OID:

MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifOutDiscards

MIB OID: 1.3.6.1.2.1.2.2.1.19

ifOutErrorsPoll definition type: Basic threshold. This poll definition defines the rate of

Appendix B. Default poll definitions 45

error checking for outbound interfaces. An alert is raised when the rateexceeds 0 per second. This poll definition polls the ifOutErrors MIBvariable, which has the following path and OID:

MIB path:iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifOutErrors

MIB OID: 1.3.6.1.2.1.2.2.1.20

isdnLinkUpPoll definition type: Generic threshold. This poll definition defines ISDNlink-state checking. An alert is raised when an ISDN link is activated. Theactivation of an ISDN link might indicate that a corresponding primarylink has gone down. This poll definition polls the following MIB variables:

MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifOperStatus

MIB OID: 1.3.6.1.2.1.2.2.1.8MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifAdminStatus

MIB OID: 1.3.6.1.2.1.2.2.1.7

Juniper Remote PingPoll definition type: Juniper remote ping. This poll definition definesremote ping operations that use Juniper-specific MIBs.

locIfInCrcErrorsPoll definition type: Basic threshold. This poll definition defines inboundcyclic redundancy checksum (CRC) /alignment error checking. An alert israised when inbound CRC alignment errors occur. This poll definition pollsthe locIfInCRC MIB variable, which has the following path and OID:

MIB path: iso/org/dod/mgmt/mib-2/private/enterprises/cisco/local/linterfaces/lifTable/lifEntry/locIfInCRC

MIB OID: 1.3.6.1.4.1.9.2.2.1.1.12

memoryPollPoll definition type: Basic threshold. This poll definition definesmemory-exhaustion checking. An alert is raised when the amount of freememory falls below 100 bytes. This poll definition polls the freeMem MIBvariable, which has the following path and OID:

MIB path: iso/org/dod/mgmt/mib-2/private/enterprises/cisco/local/lsystem/freeMem

MIB OID: 1.3.6.1.4.1.9.2.1.8

rebootDetectionPoll definition type: Generic threshold. This poll definition definesdevice-reboot detection checking where an alert is generated if a device isrebooted. The reason for a device reboot might be that the SNMPsubsystem on a device has been reset.

Tip: To monitor system uptime, change the sysUpTime MIB variable to thehrSystemUptime MIB variable. The hrSystemUptime MIB variable isavailable only if the HOSTRES-MIB is supported by the device.This poll definition polls the sysUpTime MIB variable, which has thefollowing path and OID:

MIB path: iso/org/dod/mgmt/mib-2/system/sysUpTimeMIB OID: 1.3.6.1.2.1.1.3


snChasActualTemperaturePoll definition type: Generic threshold. This poll definition definestemperature checking for Foundry devices. An alert is raised when theactual temperature of the chassis exceeds the value set for a warning aboutthe temperature level. This poll definition polls the following MIBvariables:

snChasActualTemperature

MIB path: iso/org/dod/mgmt/mib-2/private/enterprises/foundry/foundryProducts/switch/snChassis/snChassGen/snChasActualTemperature

MIB OID: 1.3.6.1.4.1.1991.1.1.1.1.18

snChasWarningTemperature

MIB path: iso/org/dod/mgmt/mib-2/private/enterprises/foundry/foundryProducts/switch/snChassis/snChassGen/snChasWarningTemperature

MIB OID: 1.3.6.1.4.1.1991.1.1.1.1.19

snChasFanOperStatusPoll definition type: Generic threshold. This poll definition definesfan-status checking for Foundry devices. An alert is raised when the fanstatus changes from 2 (normal) to 3 (failure). This poll definition polls thesnChasFanOperStatus MIB variable, which has the following path andOID:

MIB path: iso/org/dod/mgmt/mib-2/private/enterprises/foundry/foundryProducts/switch/snChassis/snChasFan/snChasFanTable/snChasFanEntry/snChasFanOperStatus

MIB OID: 1.3.6.1.4.1.1991.1.1.1.3.1.1.3

snChasPwrSupplyOperStatusPoll definition type: Generic threshold. This poll definition defines thechecking of the power-supply status for Foundry devices. An alert is raisedwhen the power supply status changes from 2 (normal) to 3 (failure). Thispoll definition polls the snChasPwrSupplyOperStatus MIB variable, whichhas the following path and OID:

MIB path:iso/org/dod/mgmt/mib-2/private/enterprises/foundry/foundryProducts/switch/snChassis/snChasPwr/snChasPwrSupplyTable/snChasPwrSupplyEntry/snChasPwrSupplyOperStatus

MIB OID: 1.3.6.1.4.1.1991.1.1.1.2.1.1.3

SNMP Link StatePoll definition type: SNMP link state. This poll definition definesadministrative and operational status checking. An alert is raised if amismatch occurs between the administrative and operational statuses. Thispoll definition polls the following MIB variables:

ifAdminStatus

MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifAdminStatus

MIB OID: 1.3.6.1.2.1.2.2.1.7

ifOperStatus

MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifOperStatus

MIB OID: 1.3.6.1.2.1.2.2.1.8

Appendix B. Default poll definitions 47

snmpInBandwidthPoll definition type: Basic threshold. This poll definition defines thechecking of incoming bandwidth utilization. An alert is raised whenincoming bandwidth usage exceeds 40%. This poll definition polls thefollowing MIB variables:

ifInOctets

MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifInOctets

MIB OID: 1.3.6.1.2.1.2.2.1.10

ifSpeed

MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifSpeed

MIB OID: 1.3.6.1.2.1.2.2.1.5

snmpOutBandwidthPoll definition type: Basic threshold. This poll definition defines thechecking of system traffic usage. An alert is raised when the value of thesysTraffic Cisco MIB variable exceeds 80%. This poll definition polls thefollowing MIB variables:

ifOutOctets

MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifOutOctets

MIB OID: 1.3.6.1.2.1.2.2.1.16

ifSpeed

MIB path: iso/org/dod/mgmt/mib-2/interfaces/ifTable/ifEntry/ifSpeed

MIB OID: 1.3.6.1.2.1.2.2.1.5

Default Ping poll definitions

Default Chassis PingPoll definition type: Chassis ping. This poll definition defines pingoperations for main node devices It sends ICMP packets to the main-nodeIP address of a device.

Default Interface PingPoll definition type: Interface ping. This poll definition defines pingoperations for interfaces within devices. It sends ICMP packets to the IPaddress of each interface.


Appendix C. Probe for Tivoli Netcool/OMNIbus

The Probe for Tivoli Netcool/OMNIbus, nco_p_ncpmonitor, enables the eventsgenerated by the Network Manager IP Edition polls to be sent to the ObjectServer.The ObjectServer sends these events, and other network events, through the EventGateway to AMOS for root cause analysis (RCA).

The Probe for Tivoli Netcool/OMNIbus is installed in the NCHOME/probes directory.

Configuration of the Probe for Tivoli Netcool/OMNIbusTo configure the Probe for Tivoli Netcool/OMNIbus, use the configuration filesthat define probe properties, map or rules.

The properties file, the map file, and the rules file are installed in the$NCHOME/probes directory. The file names are as follows:v Properties file nco_p_ncpmonitor.prop

v Map file: nco_p_ncpmonitor.mapv Rules file: nco_p_ncpmonitor.rules

Properties fileYou can use the properties file to configure some of the options available in thecommand-line arguments of the nco_p_ncpmonitor command. The properties file,in its unedited form, lists all the properties supported by the Probe for TivoliNetcool/OMNIbus. To edit a property, remove the comment from the relevant line.

The following example shows a line that has been commented out.# MapFile : "$NCHOME/probes/arch/nco_p_ncpmonitor.map"

To specify a different location for the map file, remove the comment and edit theline, as in the example below.MapFile : "/home/johnsmith/nco_p_ncpmonitor.map"

In the above example, replace arch with the name of the architecture on which theproduct is installed, for example, solaris2.

For more information about IBM Tivoli Netcool/OMNIbus properties, see the IBMTivoli Netcool/OMNIbus Administration Guide.

Map fileThe Probe for Tivoli Netcool/OMNIbus converts events from the format in whichthey are generated by the polling operations to the format in which they are storedby the ObjectServer in a two-stage process. In the first stage, which is configuredin the map file, the attributes of the event are converted to tokens accessible in therules file.


Rules fileAfter you have configured the map file to convert the attributes of the event totokens that are accessible in the rules file, use the rules file to map the tokens tofields in the ObjectServer.

The second stage of the format conversion of events is governed by the rules file.In this stage, tokens are mapped to fields in the ObjectServer. This conversion isslightly more complex than the simple mapping of the first stage. The probe usesthe rules file to perform some conditional processing on the tokens in order toconvert them to fields in the ObjectServer. Configuring the rules file is onlyrecommended for users with an advanced knowledge of Tivoli Netcool/OMNIbus.

For more information about the ObjectServer, see the IBM Tivoli Netcool/OMNIbusAdministration Guide.


Notices

This information was developed for products and services offered in the U.S.A.

IBM® may not offer the products, services, or features discussed in this documentin other countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia CorporationLicensing2-31 Roppongi 3-chome, Minato-kuTokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law: INTERNATIONALBUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFNON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULARPURPOSE. Some states do not allow disclaimer of express or implied warranties incertain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.


Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Corporation958/NH04IBM Centre, St Leonards601 Pacific HwySt Leonards, NSW, 2069Australia

IBM Corporation896471/H128B76 Upper GroundLondonSE1 9PZUnited Kingdom

IBM CorporationJBF1/SOM1 294Route 100Somers, NY, 10589-0100United States of America

Such information may be available, subject to appropriate terms and conditions,including in some cases, payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurements may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

All statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subjectto change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject tochange before the products described become available.


This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs.

If you are viewing this information softcopy, the photographs and colorillustrations may not appear.

TrademarksThese terms are trademarks of International Business Machines Corporation in theUnited States, other countries, or both:

IBM

Adobe, Acrobat, Portable Document Format (PDF), PostScript, and all Adobe-basedtrademarks are either registered trademarks or trademarks of Adobe SystemsIncorporated in the United States, other countries, or both.

Cell Broadband Engine and Cell/B.E. are trademarks of Sony ComputerEntertainment, Inc., in the United States, other countries, or both and is used underlicense therefrom

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks orregistered trademarks of Intel Corporation or its subsidiaries in the United Statesand other countries.

IT Infrastructure Library is a registered trademark of the Central Computer andTelecommunications Agency which is now part of the Office of GovernmentCommerce.

ITIL is a registered trademark, and a registered community trademark of the Officeof Government Commerce, and is registered in the U.S. Patent and TrademarkOffice

Notices 53

Java and all Java-based trademarks and logos are trademarks orregistered trademarks of Sun Microsystems, Inc. in the United States,other countries, or both.

Linux is a registered trademark of Linus Torvalds in the United States, othercountries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks ofMicrosoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and othercountries.

Other company, product, or service names may be trademarks or service marks ofothers.


Index

Aaccessibility viiiaudience v

Bbasic threshold policies

default 40basic threshold poll definitions

changing 31creation 22

basic threshold pollschanging 27creation 13

Cchanging

basic threshold poll definitions 31generic threshold poll definitions 30link state poll definitions 32ping poll definitions 32poll definitions 30poll policies 27

Chinese charactersSee multibyte data

clear thresholdexample 24

conventions, typeface ixcopying

polls 11creating

basic threshold poll definitions 22basic threshold polls 13generic threshold poll definitions 21generic threshold polls 15link state poll definitions 25link state polls 17ping poll definitions 25ping polls 17poll definitions 21polls

based on existing polls 11from scratch 12

Ddefining using multibyte data 7deleting

poll definitions 37poll policies 35

disabling polls 9

Eeducation

see Tivoli technical training viiienabling polls 9environment variables, notation ix

examplesthreshold polling 5

Ggeneric threshold policies

default 40generic threshold poll definitions


generic threshold pollschanging 27creation 15examples 24

Llegal notices 51link state poll definitions


link state pollschanging 27creation 17

localesSee multibyte data

Mmanuals vimultibyte data

in poll definitions 7

Oonline publications viordering publications vi

Pping policies

default 39ping poll definitions


ping pollingoverview 3poll definition types 6

ping pollschanging 27creation 17

Poll Definition Editor 21poll definition types 6poll definitions 7

changing 30creation 21defaults 43definition 2deletion 37

poll definitions (continued)mechanisms

ping 3SNMP 3

overview 2remote ping 4SNMP link state 3threshold 5

poll policieschanging 27defaults

basic threshold 40generic threshold 40ping 39remote ping 39

definition 1deletion 35example 29overview 1

Poll Policy Editorpoll creation 11

Poll Policy Wizard 12polling

default probes 1overview 1

pollscopying 11creation

based on existing polls 11from scratch 12

disabling 9enabling 9

Probe for Tivoli Netcool/OMNIbusconfiguring 49installation directory 49map file 49overview 49properties file 49rules file 50

publications vi

Rremote ping policies

default 39remote ping polling

overview 4restrictions 4

SSNMP link state polling

overview 3SNMP polling

overview 3poll definition types 6

support information viii


Tthreshold polling

example 5overview 5

Tivoli software information center viTivoli technical training viiitraining, Tivoli technical viiitrigger threshold

example 24typeface conventions ix

Vvariables, notation for ix


��

Printed in the Republic of Ireland

SC23-9901-00

network polling guide - ibm

Documents