Home

NMS SNMP Reference Manual

1. supervisorlndex kwAllowedR angi kwDescription 1 ExtendedManagementComponents 0 clkmgr emc Object readOnly lt no range gt lt none gt 2 ExtendedManagementComponents 1 HotSwap emc Object teadOnly lt no range gt lt none gt 3 Products 0 AG_2000 String readOnly lt no range gt lt none gt 4 Products 1 AG_4000_1E1 String readOnly lt no range gt lt none gt 5 Products 2 AG_4000_1T1 String readOnly lt no range gt lt none gt 6 Products 3 AG_4000_2E1 String readOnly lt no range gt lt none gt 7 Products 4 AG_4000_2T1 String readOnly lt no range gt lt none gt 8 Products 5 AG_4000_4E1 String readOnly lt no range gt lt none gt E Products 6 AG_4000_4T1 String readOnly lt no range gt lt none gt 10 Products 7 AG_4000C_2E1 String readOnly lt no range gt lt none gt 11 Products 8 AG_4000C_2T1 String readOnly lt no range gt lt none gt 12 Products 9 AG_4000C_4E1 String readOnly lt no range gt lt none gt 13 Products 10 AG_4000C_4T1 String readOnly lt no range gt lt none gt 14 Products 11 AG_CPCI_Quad_E1 String readOnly lt no range gt lt none gt 15 Products 12 AG_CPCI_Quad_T1 String readOnly lt no range gt lt none gt 16 Products 13 AG_Dual_E1 String readOnly lt no range gt lt none gt 17 Products 14 AG_Dual_T1 String readOnly lt no range gt lt none gt 18 Products 15 AG_Quad_Connect_E1 String teadOnly lt no range gt
2. supervisorlndex keywordName kwAllowedR ang kwD escription 1 ExtendedManagementComponents 0 clkmgr emc Object readOnly lt no range gt lt none gt 2 ExtendedM anagementComponents 1 HotSwap emc Object readOnly lt no range gt lt none gt 3 Products 0 AG_2000 String readOnly lt no range gt lt none gt 4 Products 1 AG_4000_1E1 String readOnly lt no range gt lt none gt 5 Products 2 AG_4000_1T1 String readOnly lt no range gt lt none gt 6 Products 3 AG_4000_2E1 String readOnly lt no range gt lt none gt 7 Products 4 AG_4000_2T1 String readOnly lt no range gt lt none gt 8 Products 5 AG_4000_4E1 String readOnly lt no range gt lt none gt 9 Products 6 AG_4000_4T1 String readOnly lt no range gt lt none gt 10 Products 7 AG_4000C_2E1 String readOnly lt no range gt lt none gt 11 Products 8 AG_4000C_2T1 String readOnly lt no range gt lt none gt 12 Products 9 AG_4000C_4E1 String readOnly lt no range gt lt none gt 13 Products 10 AG_4000C_4T1 String readOnly lt no range gt lt none gt 14 Products 11 AG_CPCI_Quad_E1 String readOnly lt no range gt lt none gt 15 Products 12 AG_CPCI_Quad_T1 String readOnly lt no range gt lt none gt 16 Products 13 AG_Dual_E1 String readOnly lt no range gt lt none gt 17 Products 14 AG_Dual_T1 String readOnly lt no range gt lt none gt 18 Products 15 AG_Quad_Connect_E1 String readOnly lt no range gt lt none gt 1
3. Valid options include Option Description cCommunity_name Specify a community name The default is public rn Number of retries The default is 1 retry tn Timeout in hundredths of a second The default is 100 1 second snmpTrunkLog is similar to the trunkmon utility See the NMS OAM System User s Manual for more information Procedure To run snmpTrunkLog 1 From the command line navigate to the nms ctaccess demos snmp snmptrunklog directory or the opt nms ctaccess demos snmp snmptruklog directory under UNIX 2 Enter the following snmpTrunkLog 10 1 20 45 NMS Communications 267 Demonstration programs NMS SNMP Reference Manual The following example shows snmpTrunkLog being run 268 NMS Communications WBEM support under windows Overview of WBEM support The Distributed Management Task Force DMTF has launched the Web Based Enterprise Management WBEM initiative that extends the Common Information Model CIM to represent management objects This Common Information Model is an extensible data model for logically organizing management objects in a consistent unified manner in a managed environment WBEM is a technology that establishes management infrastructure standards and provides a standardized way to access information from various hardware and software management systems in an enterprise environment Using WBEM standards developers can create tools and technolo
4. rtpAgent RTP MIB agent installed with Fusion package Under Windows 2000 the SNMP components are implemented as services Under UNIX they are implemented as daemon programs To obtain error information you can start the subagents in console mode directly To do so specify the d option on the command line softRevAgent d In console mode the agent displays information like the following ngewe AL 0 L Ad ODO dd seres 2 Li Oo lo Hol AOS oa el Laser 3 ol Sn G5 Lo des Wo FOZ y Ss del Nms Snmp Software Revision Agent service started 36 NMS Communications NMS SNMP Reference Manual Reconfiguring multiplexer I P UDP ports This section describes how to change the IP UDP ports used by the NMS multiplexer once the master agent the NMS multiplexer and the subagents are running By default the following IP UDP are used by the NMS multiplexer IP UDP Port Value Communication port between the NMS multiplexer and the network 161 Communication port between the SNMP master agent and the NMS multiplexer 49212 Communication port between the NMS SNMP subagents and the NMS multiplexer 49213 These values are stored in the snmp cfg file To change the values 1 Locate the snmp cfg file in one of the following directories Operating system Directory NT nms ctaccess cfg UNIX opt nms ctaccess cfg 2 Modify the settings in the file Save and close the fi
5. 1 ISA bus not supported in Natural Access versions 4 0 and later 2 PCI bus Configuration None 48 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Chassis MIB boardCommand Turns the board on or off Syntax Integer Access Read write OID p 4 3 1 11 n where n is the entry number Details Setting the value of this object turns the board on or off You can then check the boardStatus object to see when the command has completed Valid values are Value Action 1 On same as closing the handles in physical Hot Swap 2 Off Same as opening the handles in physical Hot Swap An operation must complete not be in the pending state before issuing a second command Note The value of this object only applies to CompactPCI boards Configuration Not applicable NMS Communications 49 Chassis MIB boardDescr Provides a textual description of the board optional Syntax DisplayString SIZE 0 255 Access Read only OID p 4 3 1 9 n where n is the entry number Details The default value is the empty string A sample description is Reserved for Fax Apps Only The entry in the snmp cfg file is BoardDesc x Description where x boardFamilyNumber Configuration NMS SNMP Reference Manual This object is configured by editing snmp cfg before starting the NMS Chassis agent 50 NMS Communications
6. Syntax Object Access Not accessible OID p 3 1 1 Details Each row in the Extended Management Component table contains information about an EMC keyword Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Extended Management Component table is populated refer to the OAM MIB EMC table NMS Communications 211 OAM Database MIB NMS SNMP Reference Manual emcl ndex Indicates the EMC to which the keyword belongs Syntax Integer Access Read only OID p 3 1 1 1 n Details This value maps to the index value of the ExtendedManagementComponents x Supervisor keyword listing the EMC in the NMS OAM database For example if ExtendedManagementComponents 1 hotswap emc the Hot Swap EMC all Hot Swap EMC keywords in the OAM Database MIB will have emcl ndex equal to 1 Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Extended Management Component table is populated refer to the OAM MIB EMC table 212 NMS Communications NMS SNMP Reference Manual OAM Database MIB emckeywordName Provides an EMC keyword name Syntax DisplayString SIZE 0 255 Access Read only OID p 3 1 1 3 n Details When a keyword belongs to one or more arrays or structures the array and struc
7. For example to remove the Chassis MIB agent from the registry enter chassisAgent U 26 NMS Communications NMS SNMP Reference Manual Installing and configuring NMS SNMP Modifying the master agent P UDP port Once the NMS subagents and multiplexer are installed modify the SNMP master agent s P UDP port so it connects to the NMS multiplexer port port 49212 instead of the network port port 161 The following sections describe how to change the SNMP master agent s port under all supported operating systems You can use another port if port 49212 is already in use or if you are already using an SNMP multiplexer in your system To configure the secondary port on the multiplexer edit the snmp cfg file and modify the value MasterAgentPort in the common section see Reconfiguring multiplexer IP UDP ports Then restart the multiplexer and the subagents to make your changes effective The following sections describe how to install configure and start the SNMP master agent under various operating systems Windows 2000 To change the SNMP master agent s UDP port 1 Open the file Services for editing This file can be found in WINNT system32 drivers etc Services 2 In this file find the following line SNMP 161 udp 3 Change the line to SNMP 49212 udp 4 Save and close this file Open a command prompt window Stop and restart the SNMP service by entering the following commands nel SLOp snmp ETE SEE an AN
8. HPOpenView output The objects in the Create Board table oamCreateBoard are Object Description productName Product type of the board to create Note All product names supported by NMS OAM can be found in the Supervisor keyword Products x To learn how to access this keyword in the MIB see Accessing Keywords for Boards Plug ins or EMCs boardName Name to give the created board boardNumber Board number to give the created board applyBoardCommand Set this to 1 to create the board based upon the productName boardName and or boardNumber values you specified 172 NMS Communications NMS SNMP Reference Manual OAM Database MIB OAM MIB Board Plug in table The OAM Board Plug i values and qualifiers n table contains for each board plug in a table of the plug in s keywords The objects in the OAM Board Plug in table oamBoardPlugins are Object Description boardPluginTable Top of the table boardPluginEntry Starts a row of the OAM Board Plug in table boardPluginl ndex Plug in index This is equivalent to the index number of the BoardPlugins x keyword listing the board plug in in the Supervisor managed object see below boardPluginKwI ndex Unique index within this table identifying the keyword bpikeywordName The keyword name formatted as described in OAM database MIB tables and keywords bpikwValue The value of the keyword bpik
9. NMS SNMP Reference Manual Chassis MIB boardEntry Starts the series of objects for a row in the Board table Syntax Object Access Not accessible OID p 4 3 1 Details A boardEntry variable is added to the Board table whenever a board is inserted and removed from the table when a board is extracted Configuration Not applicable NMS Communications 51 Chassis MIB NMS SNMP Reference Manual boardi ndex Identifies a row in the Board table that is defined by this boardEntry block of objects Syntax Integer Access Read only OID p 4 3 1 1 n where n is the entry number Details If the board is turned off using Hot Swap the board index and values will still exist but the Trunk MIB will not see any lines When the board is extracted the board index will also be removed A board that is inserted will use the next available index number Configuration Not applicable 52 NMS Communications NMS SNMP Reference Manual boardFamilyl d Indicates the board family Syntax Integer Access Read only OID p 4 3 1 7 n where n is the entry number Details Expected values are shown in the following table Value Board family 1 other default 2 AG CG 3 QX 4 TX not supported 5 CX Configuration Not applicable NMS Communications Chassis MIB 53 Chassis MIB NMS SNMP Reference Manual boardFamilyNumber Indicates the logical n
10. kwType Indicates the type of the Supervisor keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 1 4 1 4 n Details Valid types include Type Description Integer An integer String A string of 0 or more characters Object An EMC board plug in or board managed object OAM Database MIB kwType is equivalent to the value of the Type qualifier for the keyword in the NMS OAM database Keywords of other types for example Array Struct StructAndArray are not included as separate entries in MIB tables For more information see Keywords in the OAM database MIB Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Supervisor Keyword table is populated refer to the OAM supervisor tables NMS Communications 225 OAM Database MIB NMS SNMP Reference Manual kwValue Indicates the Supervisor keyword value Syntax DisplayString SIZE 0 255 Access Read write OID p 1 4 1 3 n Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Supervisor Keyword table is populated refer to the OAM supervisor tables 226 NMS Communications NMS SNMP Reference Manual OAM Database MIB oamAlertRegister Enables or disables the sending of
11. Configuration When the OAM Database SNMP agent starts up it populates all MIB tables based upon values from the NMS OAM database For more information refer to Populating OAM MIB tables NMS Communications 245 OAM Database MIB otherObjectskwValue Indicates a keyword value Syntax DisplayString SIZE 0 255 Access Read write OID p 5 1 1 4 n Configuration NMS SNMP Reference Manual When the OAM Database SNMP agent starts up it populates all MIB tables based upon values from the NMS OAM database For more information refer to Populating OAM MIB tables 246 NMS Communications NMS SNMP Reference Manual OAM Database MIB otherObjectsTable Syntax Object Access Not accessible OID p 5 1 Details Starts a sequence of otherObjectsEntry objects each of which composes a row in the Other Objects table Configuration When the OAM Database SNMP agent starts up it populates all MIB tables based upon values from the NMS OAM database For more information refer to Populating OAM MIB tables NMS Communications 247 OAM Database MIB NMS SNMP Reference Manual productName Product name of the board to create for more information refer to Creating and deleting board managed objects Syntax DisplayString SIZE 0 255 Access Read write OID p 1 5 1 Configuration Configured by the user as necessary 248 NMS Communications NMS SNMP Reference Manual OAM Database MIB supervis
12. For a board to be available for starting it must exist as a managed object in the NMS OAM database To start or stop a board or query its status 1 Determine the index of the board managed object To do so access the Supervisor Keyword table supervisorTable and search for the board name in the Boards x array keyword The index of the board name in the array maps to the index of the board managed object Find the boardManagementl ndex with the index value 3 To start the board set brdStartStop in this row to 1 To stop the board set brdStartStop in this row to 2 To query the status of the board query brdStartStop Testing boards For a board to be available for testing it must exist as a managed object in the NMS OAM database To test a board 1 Determine the index of the board managed object To do so access the Supervisor Keyword table SupervisorTable and search for the board name in the Boards x array keyword The index of the board name in the array maps to the index of the board managed object Find the boardManagementl ndex with the index value 3 Set brdTest in this row to the board test level you wish to run an integer between 1 and 255 For more information about board testing refer to the NMS OAM System User s Manual 256 NMS Communications NMS SNMP Reference Manual Using the NMS OAM database MIB Starting and stopping the supervisor You can stop and restart the NMS OAM Supervisor using the O
13. Gauge Positive integer from O to 4294967295 2 1 Object Another object type from this MIB TimeStamp Positive integer from O to 4294967295 2 1 TruthValue Integer value where 1 is True and 2 is False Access The type of access allowed for this object Options are Read only This object can not be modified by SNMP Read write SNMP can configure this object OID The OID defines the path from the root to this object All Ol Ds start with p where p is is 1 3 6 1 4 1 2628 2 2 the OID for the Chassis MIB Details Describes the object Configuration Describes how to configure the object Example Shows an example of the object The source from which the NMS MIBs was compiled is supplied with the software in ASN1 format text files These files can be found in nms ctaccess doc opt nms ctaccess doc under UNIX NMS SNMP MIBs were compiled using the following files e Chassis MIB chassis mib txt e Trunk MIB chassis mib txt e Software Revision MIB softrev mib txt e OAM Database MIB oamdatabase mib txt Read the appropriate file using the Windows Console Management function to display the SNMP information for the proprietary agent Documentation comments 142 NMS Communications NMS SNMP Reference Manual Software revision MIB dirPath Indicates the name of the directory where the NMS files are installed Syntax DisplayString SIZE 0 255 Access Read only OID p 1 1 Config
14. o m rss gt i oa gt j 3 Board Access Table Board Table Chassis MIB table relations This example shows that a busSegmentCount value of 5 in the Chassis Configuration table results in five entries in the Bus Segment table Bus segment 3 has four occupied slots so there are four entries in the Board Access table for that bus segment Each entry in the Board Access table has a boardIndex field whose value is an index into the Board table for that board Two fields in the Board table match parts of dsx1Circuitl dentifier in the Trunk MIB For more information about how the Chassis MIB and Trunk MIB can be used together see Using the chassis MIB The sequence of objects in the Chassis MIB with relative OIDs for table objects is shown in the following illustration NMS Communications 41 Chassis MIB chassis jchassRevision 1 chassMIBRevision chassConfig 2 chassType chassDescr chassSegmentBusCount busSegmentTable 2 4 f busSegmentEntry busSegmentindex busSegmentType busSegmentDescr busSegmentSlotsOccupied chassBoardAccess 3 jslotTable slotEntry slotBusSegmentindex slotindex slotBoardIndex slotStatus chassBoard 4 chassBoardCount chassBoardTrapEnable boardTable 4 3 boardEntry boardindex boardBusSegmentType boardBusSegmentindex boardSlotNumber boardModel boardModelText boardFamilyld boardFamilyNumber boardDescr boardStatus boardCommand boardTrunkCount b
15. 255 Access Read only OID p 2 1 1 4 n Details This value contains a checksum error if the file has been manually modified or corrupted since it was installed by NMS software Configuration When the Natural Access Server ctdaemon is restarted all values including this one are imported from the sgn files NMS Communications 151 Software revision MIB patchAccess Starts a group containing the Patch Entry table patchEntry Syntax Object Access Not accessible OID p 3 Configuration Not applicable 152 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Software revision MIB patchEntry Starts a row in the Patch Entry table patchEntry Syntax Object Access Not accessible OID p 3 1 1 Configuration When the Natural Access Server ctdaemon is restarted rows are added or removed as necessary to reflect the current sets of installed patches and service packs NMS Communications 153 Software revision MIB patchi ndex Indicates the index of a service pack or patch in the table Syntax Integer Access Read only OID p 3 1 1 2 n Configuration This identifier is internally assigned by the agent 154 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Software revision MIB patchPkgI ndex Identifies the package to which the service pack or patch was applied Syntax Integer Access Read only O
16. 82 Chassis MIB 39 43 44 45 using get commands 44 74 83 84 85 86 87 88 monitoring trunks 89 cumulative statistics 95 current trunk status 94 102 103 104 105 106 107 108 109 110 111 112 113 114 specifying trap information 45 trunk configuration 93 97 98 100 101 115 116 117 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 Trunk MIB 89 93 94 95 trunk status over 24 hour interval 94 118 119 multiplexers 19 26 35 37 muxC 19 35 namespace 11 network management 11 nmsChassScan 263 O OAM database MIB 165 Boards table 175 EMC table 174 Events Traps table 176 277 OAM events 257 Other Objects table 247 overview 16 Supervisor tables 171 tables and keywords 167 OAM MIB tasks 253 accessing keywords 253 creating and deleting board managed objects 254 populating OAM MIB tables 169 querying and setting the board name and number 255 receiving OAM MIB events 257 starting and stopping the supervisor 257 starting stopping and testing boards 256 OAM Supervisor 165 171 oamsys 259 object identifier OID 11 P Plug in keywords 253 plug ins 165 R repeater 12 retrieving OAM board information 175 179 180 181 182 183 184 191 198 199 200 201 202 203 204 205 206 207 208 209 210 retrieving OAM board Plug in information 173 187 188 189 190 191 192 193 194 195 196 197 retrieving OAM EMC informati
17. Configuration table has an entry for each DS1 interface which is identified by dsx1Linelndex This index corresponds to the index in the other tables such that all table entries with the same index number are for the same DS1 interface Three DS1 interfaces are represented so each table has three pages Each column of values is started by an entry object Every 15 minutes the values in the Current table are copied to the next available time slot for example if tl was filled 15 minutes ago t2 will be filled next in the Interval table The Current table values are added to the values in the Total table which continue to add up until the agent is restarted If the Interval table is full when a new timeslot is added to the table the last time slot t97 is discarded and the rest of the timeslots slide forward to make room for the new t1 timeslot 90 NMS Communications NMS SNMP Reference Manual The following illustration shows a tree view of the sequence of objects in the Trunk MIB DS1 E1 RFC 2495 A dsxiConfigTable 6 E dsx1ConfigEntry dsx1Linelndex dsxilfindex dsx1TimeElapsed dsx1ValidIntervals dsxiLineType dsx1LineCoding dsx1SendCode dsx1Circuitidentifier dsx1LoopbackConfig dsxiLineStatus dsx1SignalMode dsx1TransmitClockSource dsx1Fdl dsx1Invalidintervals dsx1LineLength dsx1LineStatusLastChange dsx1LineStatusChangeTrapEnable dsxiLoopbackStatus dsx1DsiChannelNumber dsxiChannelization dsx
18. Description string for the chassis chassDescr Generic PC development computer Descriptions of the boards in the chassis Format lt board no gt lt description string gt boardDescr 0 Tested 01 25 1991 boardDescr 1 Bad boardDescr 3 Bad List of access rights Format lt r w gt lt community gt lt host gt access writeonly private snmplab_3 List of trap destinations Format lt host gt lt community gt trap localhost public trap snmplab_3 private 32 NMS Communications NMS SNMP Reference Manual Installing and configuring NMS SNMP NMS Communications 33 Activating SNMP Starting the NMS multiplexer and subagents To start the NMS multiplexer and the subagents you can e Use the muxC console program e Enter commands at a command prompt Note Under Solaris you must start the Solstice master agent before starting the multiplexer because the Solstice agent will not operate if it discovers on startup that its P UDP port will be shared with the multiplexer If the Solstice agent is started before the multiplexer it will operate normally Starting SNMP using muxC To start the NMS multiplexer and subagents using muxC 1 Access a command prompt 2 Enter the following to start muxC muxC The following appears KKK KKK KK KKK KKKKKKKKKKKKKKKKKKKKKKKK i MULTIPLEXER CONSOLE E KKK KKK KKK KKK KKK KKKKKKKAKKKKKKKKKKKEKK A Show the ports
19. Enter the following to start the SNMP trap service nek stare snmoirap The SNMP trap service is not required if you use only NMS subagents However you will need it if other standard subagents are attached to the master agent NMS Communications NMS SNMP Reference Manual Installing and configuring NMS SNMP 10 11 Enter the following to verify that the master agent is properly installed matstat a If the master agent is installed properly the following appears UDP samolealo mots oleracea UDP snmplab_3 snmp Verify that the SNMP master agent is properly installed To do so you can use any SNMP management station You can also use the snmpwalk demonstration program installed with the SNMP package to enumerate the contents of the Mib II agents Install the NMS subagents and multiplexer as described in Installing the NMS subagents and multiplexer Note Make sure to add the installed components to the registry as described in Modifying the Windows registry When you first install the SNMP service under Windows 2000 the public community has only READ_ONLY access Note For more detailed configuration information see the Windows 2000 documentation for SNMP NMS Communications 25 Installing and configuring NMS SNMP NMS SNMP Reference Manual Installing the NMS subagents and multiplexer Once the SNMP master agent is working properly you can install the NMS subagents and the NMS SNMP multiplexer inc
20. If the keyword type is Integer and is a yes no choice brdkwAllowedRange contains a string of this format Nb values 2 Yes No If the keyword type is Integer and can take a range of values brdkwAllowedRange contains a string of this format BASE base min_value lt gt max_value where e base is a mathematical base of the integer for example 16 for a hexadecimal number e min_value is the minimum allowed value e max_value is the maximum allowed value For example BASE 0 lt S 65535 If the keyword type is String brdkwAllowedRange contains all the allowed strings for this keyword separated by commas For example YES NO If any string is acceptable this field contains lt no range gt brdkwAllowedRange reflects the combined values of the Base Min Max and Choices qualifiers for the keyword in the NMS OAM database Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Keyword table is populated see OAM Boards table 200 NMS Communications NMS SNMP Reference Manual OAM Database MIB brdkw Description Provides a short description of the board keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 4 3 1 8 n Details brdkwDescription is equivalent to the value of the Description qualifier for the keyword in the NMS OAM database If no description is given brd
21. OAM MIB Other Objects table cere E Ennn Ennn 176 OAM MIB Events Traps table oooccccccccccncoconcnccnnnnonnnccnnnccnnnccnnnrrnnnrrnnnnrnnnrrnnnrrnnrnannrnannrrannnn 176 Using the OAM database MIB object reference oooococccccccccnnnccnnnccnnnccnnnccnnnccnnnncnnnncnnnnanccnannes 177 APPlVBOardCOMMANG seese eaei aad tad iii 178 DOATOENUtY tbc it roads 179 DONA ii A A A Pen a naa AEP ee Aan 180 boardK WI NOX ici A tee 181 boardManageMentEntTY coocccccnccnnnccnnnncnnnn cnn nn rn ner reee eee eee 182 boardManageMentiNdeX oocccccccoccocconcoccnnnnnnnnno rn nr nn rn rr nr rn EEE EDS E DEES ESSE SDSS SESE ESSE GEESE SEES SEE EEE SEES 183 boardManagementTable a darned 184 bOardNaMme tess eter ees heer ne es tale id 185 DOSFONUMD iva A 186 HoardPlUgINENtTY ai d 187 boardPluginindeX uid ida 188 bDoardPlUGINK WINS 20 da 189 HOardPlugin Fables A td 190 board Table s anri e a aiii 191 pike yWwordNam e a anean A A AA A eae Gree Ailes 192 DpikwAllowedR age avecina 193 DpIKWDESCFIPTION comida atada 194 DPIKWMOAE ala A A A A AA 195 DPI WIP e end Ce da e a nn de er DS O NS 196 DPIKWValUC noors n o 197 DrdDelete io ES e i ME ee ne eaii 198 DrdkeywordN AIM Gi cocoa adi in a id 199 brdkwAllowedRange s voii ads 200 brdkwDescriptionie icescscciviee ce tase de selec ek We eed So A Dedede eda 201 DOK WMO ess ai abi tena deta ide hate el ed 202 DrdKWIY pene settee vest det haste neal feel ted veal Sec taal tee dle aa eee vet Wee te el
22. Object of class SNMP_OAMDATABASE_MIB_oamEventsTraps 1 propertie s Property oamEventDescription Value Object of class SNMP_OAMDATABASE MIB _boardPluginTable 8 propertie s Property boardPluginIndex Value 1 Property boardPluginKwIndex Value 1 Property bpikeywordName Value BootDiagnosticLevel Property bpikwAllowedRange Value Base 10 0 lt gt 3 Property bpikwDescription Value lt none gt Property bpikwMode Value readWrite Property bpikwType Value Integer Property bpikwValue Value 0 Object of class SNMP_OAMDATABASE MIB _oamBoards 2 propertie s Property createdBoardCount Value 0 Property detectedBoardCount Value 0 Object of class SNMP_OAMDATABASE MIB _oamSupervisor 3 propertie s Property oamAlertRegister Value disable Property oamEventMask Valdek Al Property i Oamstarestop Value oamStop Object of class SNMP_OAMDATABASE MIB _supervisorTable 7 propertie s Property keywordName Value ExtendedManagementComponents 0 274 NMS Communications NMS SNMP Reference Manual WBEM support under windows Using enumsnmp htm To launch enumsnmp htm Launch Internet Explorer and open the file Note If you already have an Internet Explorer window opened you can simply drag and drop enumsnmp htm into the Internet Explorer window The following illustration shows the results output by enumsnmp htm when opened in the Internet Explorer
23. and multiplexer To configure the NMS subagents modify the file snmp cfg as described in Reconfiguring multiplexer IP UDP ports To install configure and start the SNMP master agent under Windows 2000 1 24 Click Start gt Settings gt Control Panel The Control Panel window appears In the Control Panel window double click the Add Remove Programs icon The Add Remove Programs dialog box appears Click Add Remove Windows Components in the bar to the left of the window The Windows Components Wizard dialog box appears displaying Windows packages you can install Select the Management and Monitoring Tools package and press Next The Management and Monitoring Tools package is installed During installation you will be prompted to insert the Windows 2000 distribution CD Optional Configure the SNMP master agents To do so a Inthe Control Panel window double click on the Administrative Services icon The Administrative Services dialog box appears b Right click on SNMP Service and select Properties in the menu that appears The SNMP Properties dialog appears Select the Traps tab Add a Community Name For example public e Add the addresses of the hosts that you wish to send traps to if any to the Trap Destination list f Inthe Security tab you can modify the access rights g When you are finished click OK Open a command prompt window Enter the following to start the SNMP service net start snmp
24. the group names are appended to the keyword name in the table separated by periods For example the keyword FallBackClockSource in the struct HBus which is within Clocking is expressed as Clocking HBus FallBackClockSource Populating OAM MIB tables When the OAM Database SNMP agent is launched it opens the NMS OAM Supervisor managed object It populates the OAM Database MIB tables based on information it finds in this managed object and in objects referenced in this object For each Integer or String keyword in the NMS OAM Supervisor managed object the agent creates a row in the Supervisor Keyword table supervisorTable and stores the keyword and qualifier information as described in OAM database MIB keywords and tables It also uses some of the Supervisor keywords to access the board plug ins EMCs and board managed objects so it can populate the other tables in the MIB This operation is described in greater detail in the illustration that follows NMS Communications 169 OAM Database MIB NMS SNMP Reference Manual The sequence of objects in the OAM Database MIB with relative OIDs for table objects is shown in the following illustration a oam a oamSupervisor oamStartStop oamEventMask oamAlertRegister a supervisorTable E supervisorEntry supervisorIndex keywordName kwValue kwType kwMode kwAllowedRange kwDescription E oamCreateBoard productName boardName boardNumber applyBoardCommand a oamBoardPlugins a board
25. 1 2 n Configuration When the Natural Access Server ctdaemon is restarted all values including this one are imported from the sgn files 162 NMS Communications NMS SNMP Reference Manual Software revision MIB pkgTable Starts a sequence of pkgEntry objects each of which composes a row in the Package Entry table Syntax Object Access Not accessible OID p 1 3 Details The number of pkgEntry objects in the table is exactly equal to pkgCount Configuration When the Natural Access Server ctdaemon is restarted rows are added or removed as necessary to reflect the current set of installed packages NMS Communications 163 Software revision MIB NMS SNMP Reference Manual pkgVersion Indicates the base version of the package Syntax DisplayString SIZE 0 255 Access Read only OID p 1 3 1 3 n Configuration When the Natural Access Server ctdaemon is restarted all values including this one are imported from the sgn files 164 NMS Communications OAM Database MIB NMS OAM database representation The OAM Database MIB presents an SNMP front end to the contents of the NMS OAM database on a system Within this database NMS OAM software maintains tables of configuration data for hardware and software components in the system Each table of configuration data constitutes a managed object the logical representation of the component to the system Using the OAM Database MIB you can qu
26. For more information refer to Populating OAM MIB tables NMS Communications 243 OAM Database MIB NMS SNMP Reference Manual otherObjectskeywordName Indicates the name of a keyword in the managed object for the object Syntax DisplayString SIZE 0 255 Access Read only OID p 5 1 1 3 n Details Where a keyword belongs to one or more arrays or structures the array and structure names are appended to the keyword name in the table separated by periods For example the keyword FallBackClockSource in the struct HBus which is within Clocking is expressed as Clocking HBus FallBackClockSource Configuration When the OAM Database SNMP agent starts up it populates all MIB tables based upon values from the NMS OAM database For more information refer to Populating OAM MIB tables 244 NMS Communications NMS SNMP Reference Manual otherObjectskwType Indicates the type of the keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 5 1 1 5 n Details Valid keyword types are Type Description Integer An integer String A string of 0 or more characters OAM Database MIB otherObjectskwType is equivalent to the value of the Type qualifier for the keyword in the NMS OAM database Keywords of other types for example Array Struct StructAndArray are not included as separate entries in MIB tables For more information see OAM Database MIB tables and keywords
27. MUX Configuring the SNMP master agent UDP port 4 Start up the SNMP master agent NMS multiplexer and subagents 5 If you wish to include a third party multiplexer set it up between the network and the NMS multiplexer and configure the ports accordingly Configuring a third party multiplexer Note In all cases all ports must be unique and the UDP port connecting to the network must be port 161 22 NMS Communications NMS SNMP Reference Manual Installing and configuring NMS SNMP Installing the master agent under UNI X This topic describes how to install configure and start the SNMP master agent on SPARC Solaris and Linux systems Note The installation and configuration procedures for NMS subagents are different from that of the master agent To install the NMS subagents and multiplexer refer to Installing the NMS subagents and multiplexer To configure the NMS subagents modify the file snmp cfg as described in Reconfiguring multiplexer P UDP ports Installing under Solaris To install configure and start the SNMP master agent on a Solaris system Note For detailed information see the Solstice Enterprise Agents User Guide 1 Log on as superuser 2 Install the Solstice Enterprise agent access control 3 Access a command prompt 4 To start the master agent enter the following SES UME ey limi sima Sess 5 Verify that the SNMP master agent is properly installed To do so you can use any SNMP management
28. NMS SNMP Reference Manual Software revision MIB pkgCount Indicates the total number of installed packages Syntax Integer Access Read only OID p 1 2 Configuration When the Natural Access Server ctdaemon is restarted this value is updated to reflect the current number of installed packages NMS Communications 159 Software revision MIB NMS SNMP Reference Manual pkgEntry Starts a row in the Package Entry table pkgTable Syntax Object Access Not accessible OID p 1 3 1 Details The number of pkgEntry objects in the table is exactly equal to pkgCount Configuration When the Natural Access Server ctdaemon is restarted rows are added or removed as necessary to reflect the current set of installed packages 160 NMS Communications NMS SNMP Reference Manual Software revision MIB pkgl ndex Identifies an installed package in the Package Entry pkgTable table Syntax Integer Access Read only OID p 1 3 1 1 n Details Each package is assigned a unique pkgl ndex number in this table sequentially between 1 and pkgCount pkgl ndex provides an index into the File Entry fileTable and Patch Entry patchTable tables Configuration This identifier is internally assigned by the agent NMS Communications 161 Software revision MIB NMS SNMP Reference Manual pkgName Indicates the name of the package Syntax DisplayString SIZE 0 255 Access Read only OID p 1 3
29. Natural Access Server ctdaemon Note Information in this MIB is not updated if files are added or removed manually that is without using NMS installation software Software revision MIB structure The Software Revision MIB represents a system as a single managed node that contains all packages installed within it There are three major tables within the Software Revision MIB Table Description Package Lists each package name and base version File Lists each file in a package and the file version Patch Lists patches or service packs applied to each package NMS Communications 137 Software revision MIB NMS SNMP Reference Manual The following illustration shows how the tables in the Software Revision MIB are related to one another a ewee nn III AAA a es A A E A e ee N pkgindex Package Name Base Version patchIndex pkgIndex ID patch 2112 gt _2 NMS ISDN s NMS cas E Naturatrax 3 27 Patch 3671 Package Table Patch 3428 rent A Patch Table a File Table Software revision MIB table relationships As shown in the previous illustration each package is identified by a unique package index pkgI ndex which is assigned to it in the Package Table In the File Table files are listed by package index and each file is assigned a unique file index filel ndex The file version of each file is also given here In the following illustration ag
30. Reference Manual fileTable Starts a sequence of fileEntry objects each of which composes a row in the File Entry table Syntax Object Access Not accessible OID p 2 1 Details The number of fileEntry objects in the table is exactly equal to filesCount Configuration When the Natural Access Server ctdaemon is restarted rows are added or removed as necessary to reflect the current sets of installed files Note This table is not updated if files are added or removed manually that is without using NMS installation programs 148 NMS Communications NMS SNMP Reference Manual Software revision MIB filePkgl ndex Identifies the package to which the file belongs Syntax Integer Access Read only OID p 2 1 1 1 n Details This object matches the pkgl ndex identifier of an installed package in the Package Entry pkgTable table Configuration This identifier is internally assigned by the agent NMS Communications 149 Software revision MIB NMS SNMP Reference Manual fileName Indicates the name of the package Syntax DisplayString SIZE 0 255 Access Read only OID p 2 1 1 3 n Configuration When the Natural Access Server ctdaemon is restarted all values including this one are imported from the sgn files 150 NMS Communications NMS SNMP Reference Manual Software revision MIB fileVersion Indicates the base version of the package Syntax DisplayString SIZE 0
31. WSH Windows Scripting Host interpreter If enumsnmp js is launched this way a dialog box appears for each SNMP object found through WBEM and for each property value pair e Open an MS DOS console window and enter cscript enumsnmp js Ifenumsnmp js is launched this way the console mode WSH interpreter cscript exe is used instead of wscript exe and the entire list of SNMP objects properties and values in the system appears in the console window NMS Communications 273 WBEM support under windows NMS SNMP Reference Manual The following example is partial output of enumsnmp js when launched with cscript C NMS CTAccess Demos snmp wbem gt cscript enumsnmp js Microsoft R Windows Script Host Version 5 1 for Windows Copyright C Microsoft Corporation 1996 1999 All rights reserved Object of class SNMP_OAMDATABASE MIB _oamCreateBoard 4 propertie s Property applyBoardCommand Value donothing Property boardName Value Property boardNumber values 1L Property productName Value Object of class SNMP_OAMDATABASE_MIB_emcTable 8 propertie s Property emcIndex Value 1 Property emckeywordName Value Name Property emckwAllowedRange Value lt no range gt Property emckwDescription Value KINON Property emcKwIndex Value 1 Property emckwMode Value readOnly Property emckwType Value Object Property emckwValue Value clkmgr emc
32. base of the integer for example 16 for a hexadecimal number min_value is the minimum allowed value e max_value is the maximum allowed value For example BASES O5535 If the keyword type is String this field contains all the allowed strings for this keyword separated by commas For example YES NO If any string is acceptable this field contains lt no range gt If the keyword type is Object no possible values are given Description Text describing the keyword Equivalent to the A string of text If no description is given this value of the keyword s Description qualifier keyword contains lt none gt 168 NMS Communications NMS SNMP Reference Manual OAM Database MIB Within NMS OAM keywords are grouped into a variety of formats which allow an application to enumerate keyword sets to determine their values These formats include arrays structs structs containing arrays arrays containing structs and so forth Each group of keywords is represented by a keyword that does not actually contain configuration data but instead merely represents the group Within the OAM database MIB keyword enumeration takes place transparently Thus there is no need to include group name keywords as separate entries in the MIB Instead only keywords that actually contain values that is keywords of type Integer or String are given separate entries in the tables Where a keyword belongs to one or more groups
33. can also appear in the subagent specific sections to define additional access and trap host settings for individual subagents only Traps from a given subagent will be sent to all hosts listed in the section for the subagent as well as the hosts listed in the common section NMS Communications 31 Installing and configuring NMS SNMP NMS SNMP Reference Manual Sample SNMP configuration file The following code shows typical entries within an SNMP configuration file Indentations in the file are optional for user readability only snmp cfg This is an example of a file that specifies an SNMP configuration This file must be placed in the nms ctaccess cfg directory common Definition of the UDP IP ports used by the multiplexer to communicate with the Master Agent and the NMS agents SnmpPort 161 MasterAgentPort 49212 CommunicationPort 49213 Default access rights to the NMS agents Format lt r w gt lt community gt lt host gt access readwrite public access readonly guest snmplab_3 Default trap destinations for the NMS agents Format lt host gt lt community gt trap localhost public trap snmplab_3 private Keep this line to allow the Multiplexer to send requests to NMS subagents access readwrite localhost chassisAgent Type of chassis Allowed values 1 Unknown chassis 2 CPCI chassis 3 Generic PC chassis 4 Generic Sun chassis chassType 3
34. configuration tu n tart the SNMP Master Agent tart the NMS Multiplexer tart the NMS Sub agents IO U Y n E top the SNMP Master Agent F Stop the NMS Multiplexer G Stop the NMS Sub agents H Show the running NMS Sub agents I Refresh the screen Q Quit the console COMMAND gt _ 3 Enter B to start the SNMP master agent 4 Enter C to start the NMS Multiplexer 5 Enter D to start the SNMP subagents By default muxC starts and stops the SNMP subagents and the multiplexer as Windows services using the net start and net stop commands NMS Communications 35 Activating SNMP NMS SNMP Reference Manual The muxC command line option d causes a terminal window to be created each time you start the multiplexer and or the SNMP subagents The components are started in debug mode with the following command MERC 0l Starting SNMP using the command line To start the components using the command line 1 Access a command prompt 2 Enter the following for each component For this operating system type Enter Windows 2000 net start Component_name UNIX component_name component_name is the name of the component to start component_name can be any of the following Name Description mux NMS multiplexer chassisAgent Chassis MIB agent dslAgent Trunk MIB agent oamAgent OAM Database MIB agent softRevAgent Software Revision MIB agent
35. configure this object OID The OID defines the path from the root to this object All OIDs start with p where p is is 1 3 6 1 4 1 2628 2 2 the OID for the Chassis MIB Details Describes the object Configuration Describes how to configure the object Example Shows an example of how the object is used The source from which the NMS MIBs was compiled is supplied with the software in ASN1 format text files These files can be found in nms ctaccess doc opt nms ctaccess doc under UNIX NMS SNMP MIBs were compiled using the following files e Chassis MIB chassis mib txt e Trunk MIB chassis mib txt e Software Revision MIB softrev mib txt e OAM Database MIB oamdatabase mib txt Read the appropriate file using the Windows Console Management function to display the SNMP information for the proprietary agent 46 NMS Communications NMS SNMP Reference Manual Chassis MIB boardBusSegmentNumber Number of the bus segment in which this board is installed Corresponds to the busSegmentl ndex in the Bus Segment table Syntax Integer Access Read only OID p 4 3 1 3 n where n is the entry number Configuration Not applicable NMS Communications 47 Chassis MIB boardBusSegmentType Indicates the Bus type for a particular board Syntax Integer Access Read only OID p 4 3 1 2 n where n is the entry number Details Acceptable values are as follows Value Type
36. core is installed by default but the SNMP provider must be manually installed If the software is not located on the installation CD you can download the installation file wmisnmp exe from Microsoft s Web site This file can be found at http download microsoft com download platformsdk SNMPX86 1 5 NT45 EN US wmisnmp exe 270 NMS Communications NMS SNMP Reference Manual WBEM support under windows Verifying the SNMP provider installation The SNMP provider installation automatically creates the following namespaces with WMI e root snmp localhost e root snmp SMIR To check that the namespaces have been properly created browse for the namespaces in the WMI Control dialog box shown in the following illustration E WHI Control 21 x General Logging Backup Restore Security Advanced Namespace navigation allows you to set namespace specific security 3 Security ClMy2 03 DEFAULT SECURITY 3 snmp 61 03 localhost a SMIR Cancel Apply Help WMI Control dialog box To access this dialog box in Windows 2000 1 Double click on Administrative Tools The Administrative Tools window appears 2 Double click on Computer Management The Computer Management window appears Under Services and Applications highlight WMI Control 4 In the Action menu click Properties The WMI Control Properties dialog box appears 5 Clic
37. each MIB and OID is unique The namespace for the entire tree is maintained by the IETF and related organizations who delegate that authority only for MIBs below the Enterprises MIB whose OID is 1 3 6 1 4 1 NMS Communications 11 Overview of NMS SNMP NMS SNMP Reference Manual Managed network components A typical managed network consists of the following components e Managed nodes e Management information bases e Management stations e Management protocol Managed nodes Any device which connects to a data network and can execute the SNMP protocol can be an SNMP managed node A managed node can be e A host system such as a workstation a printer a file server a terminal server or a mainframe e A network router a bridge a hub an analyzer or a repeater The following illustration shows managed nodes as grey and management stations as white Telephone Management Station Network CompactPCl chassis with boards from NMS Communications PC with boards from NMS Communications Network Printer Telephone p Network Printer Router Public Data Network Management Station Managed nodes and management stations 12 NMS Communications NMS SNMP Reference Manual Overview of NMS SNMP A managed node executes a program called the SNMP service which communicates with the management station The SNMP service responds to messages from the host and sends unsolicited messages if a define
38. equal to the value of dsx1Linel ndex for boards made by NMS Communications Configuration Not applicable NMS Communications 117 Trunk MIB NMS SNMP Reference Manual dsx1lntervalNumber Number of this dsx1IntervalEntry in the Interval table where each block of variables covers a fifteen minute interval Syntax Integer 1 96 Access Read only OID p 8 1 2 n where n the index number of the DS1 interface Details There are be 96 rows in the Interval table after the DTM agent has been active for 24 hours Configuration Not applicable 118 NMS Communications NMS SNMP Reference Manual dsx1I ntervalValidData Indicates if the data for this interval is valid not supported Syntax TruthValue Access Read only OID p 8 1 13 n where n the index number of the DS1 interface Configuration Not applicable NMS Communications Trunk MIB 119 Trunk MIB NMS SNMP Reference Manual dsx1I nvalidi ntervals Indicates the number of intervals with invalid data which will always be o not supported Syntax Integer Access Read only OID p 6 1 14 n where n the index number of the DS1 interface Configuration Not applicable 120 NMS Communications NMS SNMP Reference Manual dsx1lLinel Identifies a DS1 interface managed by this agent Syntax ndex Integer 0x1 Ox7fffffff Access Read only OID p 6 1 1 n where n the index number of the DS1 interfac
39. exist as a managed object in the NMS OAM database Querying or setting the board number of a board To set or query the name of a board 1 Determine the index of the board managed object To do so access the Supervisor Keyword table supervisorTable and search for the board name in the Boards x array keyword The index of the board name in the array maps to the index of the board managed object 2 Find the boardManagementl ndex with the index value 3 To set the name of the board set brdName in this row to the new name To query the board s name query brdName Querying or setting the board number of a board For a board to be available it must exist as a managed object in the NMS OAM database To set or query the board number of a board 1 Determine the index of the board managed object To do so access the Supervisor Keyword table SupervisorTable and search for the board name in the Boards x array keyword The index of the board name in the array maps to the index of the board managed object 2 Find the boardManagementl ndex with the index value 3 To set the board number of the board set brdNumber in this row to the new board number To query the board s number query brdNumber NMS Communications 255 Using the NMS OAM database MIB NMS SNMP Reference Manual Starting stopping and testing boards You can use the OAM database MIB to start stop and test boards in the system Starting and stopping boards
40. filEPKQI NGSX coc Gives Geico ey id dns Eevee des eed ie bev ee EE 149 MEN Mrs id a 150 HEVIA E RARA A O e ala SS 151 patchACcess iii a eee ies 152 PATCH ENUY reniir E E t 153 DaCCHIINGEX PE EE EEA EEA A E ATS 154 patchPkglndex sinin ek eee eee i ee ed ee ie ind oe vee a EE ed a 155 pateh Table ma basic oil 156 pati Dia ld ll des 157 NMS Communications 5 Table of Contents NMS SNMP Reference Manual DACKAGEACCESS naposan a A AAA as Denia edad A AAA AA id 158 LA O OO O 159 PEN e art dt dai 160 aleia Te ED AN A A E AA E E ida 161 PON Mei e ee dee a ee a a nde de os eae a 162 PK OT ADI Gs eters retrace tinder nent it ron 163 PROMESA 164 OAM Database MIB oocccnocononcocnnnacnnnncnnrarnnrncnnrnrnnrnrnnrnrnnrnrnnrnrnnrnrnnrnnnrnnanrnnancnnancananeananeasa 165 NMS OAM database representation oocccccccccnccnnnccnnnccnnnccnnnncnnnccnnnnrnnnrcnnnrrnnnrrnnnrnnnrnancennness 165 Managed COMPONEN ES cri En coe Coteus mabe beens aa Ios 165 OAM Database MIB tables and KeyWords ocoocccccccncnccnnnccnnnccnnnccnnnccnnnccnnncnnnrnnnnrnannrnannnnnnncn 167 Keywords in the OAM database MIB cccccce eee eee eee eee etna eee eee 168 Populating OAM MIB tables xiii teeter eee tae alee ee Radek ea PR Des 169 OAM MIB Supervisor tableS ssssssssrssssrsssrrrsrtr tetit een REEE EEEE 171 OAM MIB Board Plug in table seriinin naeia eee i Eaa ENa 173 OAM MLB EME table ihur a a e E din id 174 OAM MIB Boards table aae thas a aa a A eA 175
41. keyword Configuration Not applicable NMS Communications 231 OAM Database MIB NMS SNMP Reference Manual oamEventDescription Returns a string containing the last event sent back by OAM for more information refer to OAM MIB events Syntax String SIZE 0 255 Access Read only OID p 6 1 Configuration Updated whenever a new OAM event is generated 232 NMS Communications NMS SNMP Reference Manual OAM Database MIB oamEventMask Determines the mask to use to filter NMS OAM events Syntax Integer Access Read write OID p 1 2 Details Reading this value returns the current event mask setting If no mask is set this value returns 1 OXFFFFFFFF For more information refer to OAM MIB events Configuration Not applicable NMS Communications 233 OAM Database MIB NMS SNMP Reference Manual oamEventsTraps Starts the OAM Traps table allowing an application to receive OAM events through the MIB Syntax Object Access Not accessible OID p 6 Details Objects in the OAM Events Traps table oamEventsTraps include Object Description oamEventDescription The last event sent back by OAM Configuration Not applicable 234 NMS Communications NMS SNMP Reference Manual oamOtherObjects OAM Database MIB Starts the Other Objects table Syntax Object Access Not accessible OID p 5 Details The Other Objects table is incl
42. lt none gt 19 Products 16 AG_Quad_Connect_T1 String readOnly lt no range gt lt none gt 20 Products 17 AG_Quad_El String readOnly lt no range gt lt none gt 21 Products 18 AG_Quad_T1 String readOnly lt no range gt lt none gt 22 Products 19 CG_6000C_Quad String readOnly lt no range gt lt none gt 23 Products 20 CX 2000 16 String readOnly lt no range gt lt none gt 24 Products 21 CX 2000 32 String readOnly lt no range gt lt none gt 25 Products 22 CX 2000C 16 String readOnly lt no range gt lt none gt 26 Products 23 CX 2000C 32 String readOnly lt no range gt lt none gt 27 Products 24 CX 2000C 48 String readOnly lt no range gt lt none gt 28 Products 25 QX 2000 100 4L String readOnly lt no range gt lt none gt 29 Products 26 QX 2000 200 4L String readOnly lt no range gt lt none gt 30 Products 27 QX 2000 80 1L String readOnly lt no range gt lt none gt 31 Products 28 QX 2000 80 4L String readOnly lt no range gt lt none gt 32 BoardPlugins 0 agplugin bpi Object readOnly lt no range gt lt none gt 33 BoardPlugins 1 cg6kpi bpi Object readOnly lt no range gt lt none gt 34 BoardPlugins 2 cx bpi Object readOnly lt no range gt lt none gt 35 BoardPlugins 3 qx2kpi bpi Object readOnly lt no range gt lt none gt 36 Boards 0 Namel Object readOnly lt no range gt lt none gt 37 Boards 1 Namel Object readOnly lt no range gt lt none gt 38 Name Supervisor Object readOnly lt no range gt lt n
43. management system consists of e One or more managed nodes running one or more SNMP agents An agent keeps information about its managed node in a database called a Management Information Base MIB e One or more network management stations which run network management software and display network information The management station is called the host e A network management protocol which determines how the managed node and the management station can communicate with each other over the network The following illustration shows the relationship of SNMP components Management Station host Network Management Protocol Managed Managed Node Node SNMP network components In the following illustration one management station is shown communicating with two managed nodes The first managed node has more than one agent and each agent has its own MIB The dotted lines in the managed node show that there can be more agent MIB pairs running on a managed node The dotted lines to the right of the managed nodes show that there can be additional nodes managed by a single management station Object identifiers An object identifier OID is a unique sequence of integers that represents how to traverse the MIB tree to get to a managed object All MIBs have a common root node and all OID integer sequences start from that root The OIDs are assigned by the IETF The entire tree of MIBs is referred to as a namespace which means that
44. not guaranteed to arrive at the host You should plan your network management policies to consider lost messages 14 NMS Communications NMS SNMP Reference Manual Overview of NMS SNMP Accessing MIB objects Objects in a MIB can be accessed in the following ways Type Description Single Contains a single value Getting the value for an instance of this object type requires adding a 0 to the end of the OID For example if the OID to a single object type is p then use p 0 to get its value Indexed Table The column is the type of item and the row index is the instance of that item type The OID of the start of the table is p and p column index describes a field where index specifies the row Doubly Indexed Table Uses two indices to specify a row The column is the type of item and the row is defined by two indices that further define the meaning of that row The OID of the start of the table is p p column index1 index2 specifies a field where get next operator finds the next object in the current MIB that has a value It returns the value of the object and its OID If the current object is in a table it returns the next column which is the last digit in the OID The OID to a field in an indexed table is get next retrieves the next get next moves to the next column These actions represent reading the table from top to bottom then left to right For example the Trunk MIB has an indexed table call
45. object in the Board table contains information about a single board in the chassis This group of objects includes the board model a textual description of the board model a family identifier the board s status the trunk count the board revision the board s serial number and the board s date of manufacture Each boardEntry is identified by the boardi ndex object whose value is assigned by the NMS Chassis agent New boardEntry objects are added to this table and configured for NMS OAM when a board is added to the chassis Entries in the Board table are removed if a board physically is extracted If a board is inserted a new entry will be added to the Board table using the next free index Whenever a board is inserted or extracted a trap is sent if traps have been enabled The objects in the Board table are Object Description chassBoard Start of the board descriptions chassBoardCount Number of boards in the chassis chassBoardTrapEnable Sets the default value for the boardStatusChangeTrapEnable object for the entries in this table boardTable Starts the Board table boardEntry Starts a row of the Board table boardl ndex Number of this row in the Board table boardBusSegmentType Type of bus segment boardBusSegmentNumber Number of the bus segment this board is in boardSlotNumber Number of the slot boardModel Model of this board numeric boardModelTex
46. of that segment s boards will be listed next The Board Access table provides an index into the Board table that allows an application to directly access specific boards using get commands based on the board s bus type bus segment number or logical slot number Object Action Bus Type Examine the Bus Segment table to find the bus segment type you are interested in Look for that entry s busSegmentl ndex value in the Board Access table and use each matching entry s slotBoardl ndex value to find the entry in the Board table Bus Segment Number Find the slotBusSegmentNumber in the Board Access table and use that entry s slotBoardl ndex value to find the entry in the Board table Slot Number Find the slotl ndex value for a chosen bus segment and use that row s boardl ndex value to index into the Board table The objects in the Board Access Slot table include Object Description chassBoardAccess Starts the Board Access table slotTable Starts the rows of the Board Access table slotEntry Starts a row in the Board Access table slotBusSegmentI ndex Number of the bus segment this board is in sloti ndex Logical slot index of a board in the bus segment slotBoardl ndex Index into the Board table for this bus segment slotStatus Status of the slot hot swap status 44 NMS Communications NMS SNMP Reference Manual Chassis MIB Chassis MIB Board table Each boardEntry
47. the NMS OAM event mask or indicates its status oamAlertRegister Registers for NMS OAM alert notification or indicates the status of the registration supervisorTable Supervisor Keyword table containing NMS OAM Supervisor keywords values and qualifiers oamCreateBoard Create Board table containing values that allow you to create board instances in the database The objects in the Supervisor Keyword table SupervisorTable are Object Description supervisorTable Top of the table supervisorEntry Starts a row of the Supervisor Keyword table supervisorl ndex Unique index within this table identifying the keyword keywordName The keyword name formatted as described in OAM database MIB keywords and tables kwValue The value of the keyword kwType The type of the keyword Integer String Or Object kwMode 1 indicates keyword value is read only 2 indicates keyword value is read write kwAllowedRange The range of allowable values for the keyword formatted as described in OAM database MIB keywords and tables kw Description A short description of the keyword NMS Communications 171 OAM Database MIB NMS SNMP Reference Manual The following illustration shows sample HPOpenView output displaying the contents of the Supervisor Keyword table
48. you can use WBEM to retrieve information contained in the NMS subagents These programs are for Windows only They can be found in nms ctaccess demos snmp wbem NMS Communications 269 WBEM support under windows NMS SNMP Reference Manual Installing Microsoft WMI and the WMI SNMP Provider To install Microsoft WMI and the WMI SNMP Provider 1 Verify your SNMP installation 2 Obtain the installation files if they are not included on the Windows 2000 installation CD and install these files 3 Verify the SNMP Provider installation Verifying the SNMP installation The SMNP provider can interact with an SNMP agent only when the agent is working properly To make sure the SNMP data will be available through WBEM WMI first check the NMS related information using the demonstration programs described in Using SNMP demonstration programs of this manual Obtaining and installing WMI software The following sections describe how to obtain and install the Microsoft WMI and WMI SNMP Provider software under different Windows 2000 installations Windows 2000 server and advanced server The WMI core is installed by default under Windows 2000 However the SNMP provider must be manually installed To do so run the wbemsnmp exe installation program located in the System32 WBEM directory of the current installation or in the i386 directory of the Windows 2000 installation CD Windows 2000 Professional As with the Windows 2000 Server the WMI
49. 000 Professional c cece ents ete teeta ene nates 270 Verifying the SNMP provider installation ccccceee cece e eee eee ener e ents 271 Installing NMS MOF files in the WBEM repository 0ceeeee eee eee eee eee tena eee eaten teeta ed 272 Testing MOF files aaa 273 USING EMNUMSNMP Simi da 273 Using CAUSA NN reese cece acs ccs cet e ade a ra SA AEE SEa dada daaa SARTE deeds sate aaa SATIE eae gare ETEEN 275 8 NMS Communications Introduction Simple Network Management Protocol SNMP is a protocol defined by the Internet Engineering Task Force IETF Network devices supporting this protocol allow a management station to monitor network status modify network settings and receive network events The NMS SNMP Reference Manual explains how to configure and install SNMP for NMS Communications NMS products The manual is intended for customers who want to add SNMP monitoring to NMS Communications boards It provides an overview of SNMP and describes the Management Information Bases MIBs and agents used to support SNMP on NMS hardware NMS Communications 9 Overview of NMS SNMP Using network management Network management allows administrators to maintain network integrity SNMP is an industry standard protocol that defines a method for performing network management SNMP was initially made available for IP based enterprise networks and is now available for telephony networks An SNMP network
50. 3 MIBs fall into two categories MIB Description Standard A standard MIB is defined by the IETF An example of a standard MIB is RFC 2495 the Trunk MIB Private A non standard proprietary MIB is defined by an enterprise The IETF assigns a unique OID number to a company under which they can define their own OIDs for their specific products An example of a private MIB is the NMS Communications chassis MIB Management stations A management station is a system running e The network management protocol e One or more network management applications The network management station host determines which information is required from the managed node The host sends queries to a managed node to determine what information is available and to retrieve that information The host then uses those responses to display the information in human readable form Host applications are much larger than agent applications because they are designed to do most of the work in the SNMP architecture and because one host application communicates with many agents One example of a host management station is HP Openview NMS Communications 13 Overview of NMS SNMP NMS SNMP Reference Manual Management protocol SNMP defines a mechanism to transport network management information Messages containing queries and replies are sent between the host management system and managed nodes over a connectionless transport service A commonly
51. 34 oaMOtherObj ects A Se ede dd 235 DAMASCO Picota tai 236 OAMSUPCIVISOM ss oa Revie a A A A A AE E 237 OtherObjectsEntry 2 da 238 otherObjectsindeX aidara idee sees a A A aia 239 otherObjectSkwAllowedRange c cece ee ene nee een tenants 240 otherObjectskw Description ce rn nr r nn nn rnn nr nn nnrrnnnrnnnnrnnnnrnnnninnnninnnn 241 otherObjectSKwINdex icc cied veh easgedeee eens iranin dope ira iana A Aena 242 OotherObjectSKWMOdEe cc Ene nr nn runa rnn n rnn nren 243 otherObjectskeywordNaMe cece nn nn rnnt erre rra nr rn nn rra nnrnnnnrrannrnannrnannen 244 OtherODjectsKkWTYDE ceci A A ieee 245 otherObjectskwValle sn li linia 246 OtherObjectslabler uiiai a E ls 247 productiNaMe icocui aaa a ar vageruetsaecedersagoenetsgUesduneng pipi 248 MA O O ties 249 Superyisor Entry ic dd bd 250 A A A A e 251 Using the NMS OAM database MI B cocnccoccococnoracncnnrannnracnnracnnrncnnrarnnrncnnrncnnrnrnnraracnnracanes 253 Accessing keywords for boards plug ins or EMCS 0oooocccccccnccncnnnncnnnncnnnncnnnnnnnnnnnnnnnnnnnnnnnnnns 253 Creating and deleting board Managed Objects ooococccccccccccnccncnccnnnccnnnccnnnccnnnccnnncannnnnnnnnnnnns 254 Deleting board Managed Objects cece ener neat need 254 Querying and setting the board name and numbel cceece eee nett eee e teeta teeta e tenet nates 255 Querying or setting the board number of a bOard cece cece eee eee eee e een eta ne eae 255 Q
52. 9 Products 16 AG_Quad_Connect_T1_ Strimg readOnly lt no range gt lt none gt 20 Products 17 AG_Quad_El String readOnly lt no range gt lt none gt 21 Products 18 AG_Quad_T1 String readOnly lt no range gt lt none gt ee Products 19 CG_6000C_Quad String readOnly lt no range gt lt none gt 23 Products 20 CX 2000 16 String readOnly lt no range gt lt none gt 24 Products 21 CX 2000 32 String readOnly lt no range gt lt none gt 25 Products 22 CX 2000C 16 String readOnly lt no range gt lt none gt 26 Products 23 CX 2000C 32 String readOnly lt no range gt lt none gt 27 Products 24 CX 2000C 48 String readOnly lt no range gt lt none gt 28 Products 25 QX 2000 7100 4L String readOnly lt no range gt lt none gt 29 Products 26 QX 2000 200 4L String readOnly lt no range gt lt none gt 30 Products 27 QX 2000 80 1L String readOnly lt no range gt lt none gt 31 Products 28 QX 2000 80 4L String readOnly lt no range gt lt none gt 32 BoardPlugins 0 agplugin bpi Object readOnly lt no range gt lt none gt 33 BoardPlugins 1 cg6kpi bpi Object readOnly lt no range gt lt none gt 34 BoardPlugins 2 cx bpi Object readOnly lt no range gt lt none gt 35 BoardPlugins 3 qx2kpi bpi Object readOnly lt no range gt lt none gt 36 Boards 0 Namel Object readOnly lt no range gt lt none gt 37 Boards 1 Namel Object readOnly lt no range gt lt none gt 38 Name Supervisor Object readOnly lt no range gt lt none gt
53. A REVISION a O A ASIA EE AE ia 59 bodrdSerial NUM AD 60 DOSTASIOLENUMDEE Sarna AA A tie 61 DO GRC SA CUS ia A E RT AA A aie aay A A lt EA 62 boardStatusChangeTrapEnable ooooccccccccccccncnccnnnccnnnncnnnncnnnncnnn rra nn rra nnr nn nnrrnnnrnnnnrrnrnnannnnannnss 63 boardStatuslastCnanGe caia obrs 64 Doa rd TADS ci AS A noO la 65 DOI UNNE NN EASTA 66 DUSSEGMENTD ESC ii a bi dd 67 DusSegmentEnt Via nta take Aid ah de 68 DUSSEGMENElNAEX iii ii ia 69 busSegmentSlOtSOCCupied 0 nena tenet ate eae 70 DUSSEGMENERADIG ont al A A A al data tad 71 b sSegmentType ii daa 72 chassBO ini id as 73 chassBO0ardACCOSS a a A A A a 74 ChHaASSBOArA UM No 75 chassBoard TrapEnablec icocio doc a A id 76 CHASSCOMMIG cti ode cani 77 CASS DES RR ORO 78 ChAaSSMIIBREVISION Ses arar ida a dais 79 chassRevisSiON ci a da a o a O a 80 ChAaSSSEGMENCBUSCOUNE e Ed 81 CHASST VPO cuetins ia ve AA A AAA A 82 SlotBoard NA a a a a ina 83 SlotBusSegmentl nde x siii li ed 84 SIOLENTY coito 85 Akesa iato ES SEEE EEEE a ao sa e lo o cda 86 OE o aon sae 87 Sloan ds a UA da ais rar e dain aria S 88 Trunk MIB isa drena 89 Trunk MIB structure and limitations 2 0 0 ccc cece cece cece eee eeeeeeeeeeeeeeeeeeugeeeeegaeeeuguneeugunenegs 89 KIOWA LIF TEAEL OMS ina vecina vi vi A id idad is 89 TrUNK MIB Node tables E A AA A ed 92 Trunk MIB Configuration table ooooccccccccnccocnccnnnccnnnncnnnncnnnncnnnnnnnnnnnnnnnnnnnrnnnnrnnnnrannnrannnnannnss 93 TrunkMIBinterval Tabla oi
54. AG 4000 El AG 4000 T1 AG 4000C Dual El AG 4000C Dual T1 AG 4000C Quad El AG 4000C Quad T1 AG 4000C El AG 4000C T1 7 CG 6000 CG 6000 Quad CG 6000C Quad CG 6100C CG 6100C 16 CG 6100C 8 8 CX 2000 16 CX 2000 32 CX 2000C 16 CX 2000C 32 CX 2000C 48 CX 2000 Configuration Not applicable 56 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual boardModelText Provides a textual description of the board Syntax DisplayString SIZE 0 255 Access Read only OID p 4 3 1 6 n where n is the entry number Details Acceptable values are Board type Value AG AG_2000 AG_2000_ BRI AG_2000_ENM AG_2000_VTG AG_2000C AG_4000_1E1 AG_4000_1T1 AG_4000_2E1 AG_4000_2T1 AG_4000_4E1 AG_4000_4T1 AG_4000_E1 AG_4000_T1 AG_4000C_2E1 AG_4000C_2T1 AG_4000C_4E1 AG_4000C_4T1 AG_4000C_E1 AG_4000C_T1 AG_Dual_E1 AG_Dual_T1 AG_CPCI_Quad_E1 AG_CPCI_Quad_T1 AG_Quad_Connect_E1 AG_Quad_Connect_T1 AG_Quad_El AG_Quad_T1 AG_QuadDual_E1 AG_QuadDual_T1 QX QX 2000 80 1L QX 2000 80 4L QX 2000 100 4L QX 2000 200 4L NMS Communications Chassis MIB 57 Chassis MIB Board type Value CG CG_6000 CG_6000_Quad CG_6000C_Quad CG_6100C CG_6100C_16 CG_6100C_8 CX CX 2000 16 CX 2000 32 CX 2000C 16 CX 2000C 32 CX 2000C 48 CX 2000 NMS SNMP Reference Manual The value of this object corresponds to the textual part of th
55. AM Database MIB e To stop the Supervisor set oamStartStop to 2 e To start the Supervisor set oamStartStop to 1 You can determine the current status stopped or running of the Supervisor by querying oamStartStop Note If you query this keyword while the Supervisor is in the process of shutting down the keyword indicates that the Supervisor is running OAM MIB events NMS OAM events both solicited and unsolicited are available via SNMP An SNMP application can receive them either as SNMP traps or by querying the OAM database MIB To receive NMS OAM events as SNMP traps set oamAlertRegister to 1 To stop receiving events as traps set oamAlertRegister to 2 Regardless of whether SNMP is registered to receive NMS OAM events an application can always determine the last event received by querying oamEventDescription This value contains a string of the form eventname name objectname where e eventname is the name of the last event received for example OAMEVN_STARTBOARD_ DONE e objectname is the name of the object sending the event for example MyBoard For example OAMEVN_STARTBOARD_DONE name MyBoard The events in the following table are reported slightly differently in oamEventDescription Event name String in oamEventDescription OAMEVN_ALERT eventname name objectname message message message is the alert message sent OAMEVN_REPORT eventname name objectname message message message is the alert messa
56. Access Not accessible OID p 3 1 Details The Board Access table provides an index into the Board table slotBoardl ndex allowing direct access to a specific board based on its bus characteristics This table is composed of exactly n m slotEntry objects where n chassSegmentBusCount from the Chassis table and m busSegmentSlotsOccupied from the Bus Segment table Configuration Not applicable 88 NMS Communications Trunk MIB Trunk MIB structure and limitations The NMS Communications implementation of the Trunk MIB RFC 2495 The organization of the tree detailed descriptions of the nodes and the available functions are also provided Compliance to the Trunk MIB is also detailed All the boards in a chassis are represented as one managed node Each trunk is represented by a numerical index which is generated by sequentially numbering the trunks on all the boards RFC 2495 defines the near end and far end of each DS1 interface The near end is the interface on the board that the agent is monitoring The far end is the remote end of the trunk connected to that interface Support is defined for the near end The RFC 2495 MIB defines the following groups Group Description DS1 Near End Group Contains configuration information about the DS1 interfaces and statistics collected from the near end interface DS1 Far End Group Optional and not supported Fractional Table Optional and not suppor
57. Board all keywords for this board in the OAM Database MIB will have boardIndex equal to 1 Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Keyword table is populated refer to the OAM Boards table 180 NMS Communications NMS SNMP Reference Manual OAM Database MIB boardKwI ndex Indicates the keyword s index Syntax Integer Access Read only OID p 4 3 1 2 n Details Keywords are numbered sequentially from 1 upward Configuration Determined when the OAM Database SNMP agent populates the OAM Boards table as described in OAM Boards table NMS Communications 181 OAM Database MIB NMS SNMP Reference Manual boardManagementEntry Starts a row in the Board Management table boardManagementTable Syntax Object Access Not accessible OID p 4 4 1 Details Each row contains entries which allow you to start stop test or delete a board or query its status Configuration Not applicable 182 NMS Communications NMS SNMP Reference Manual OAM Database MIB boardManagementl ndex Provides the index of the board to manage Syntax Integer Access Read only OID p 4 4 1 1 n Details The index matches the boardi ndex of the board in the Board Keywords table Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon
58. COMMUNICATIONS NMS SNMP Reference Manual P N 9000 6744 16 NMS Communications Corporation 100 Crossing Boulevard Framingham MA 01702 NMS SNMP Reference Manual No part of this document may be reproduced or transmitted in any form or by any means without prior written consent of NMS Communications Corporation 2002 NMS Communications Corporation All Rights Reserved Alliance Generation is a registered trademark of NUS Communications Corporation or its subsidiaries NUS Communications Natural MicroSystems AG CG CX QX Convergence Generation Natural Access CT Access Natural Call Control Natural Media NaturalFax NaturalRecognition NaturalText Fusion PacketMedia Open Telecommunications Natural Platforms NMS HearSay and HMIC are trademarks or service marks of NUS Communications Corporation or its subsidiaries Multi Vendor Integration Protocol MVIP is a registered trademark of GO MVIP Inc UNIX is a registered trademark in the United States and other countries licensed exclusively through X Open Company Ltd Windows NT MS DOS MS Word Windows 2000 and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and or other countries Clarent and Clarent ThroughPacket are trademarks of Clarent Corporation Sun Sun Microsystems the Sun logo are trademarks or registered trademarks of Sun Microsystems Inc in the United States and or other countries All SPARC trademarks are use
59. D Solaris To change the SNMP master agent s UDP port 1 Log in as superuser 2 Open the file etc init d init snmpdx for editing 3 In this file find the line beginning with usr lib SNMP snmpdx p 161 4 Replace the first section of the line with usr lib SNMP snmpdx p 49212 Save and close this file Access a console window Stop and restart the master agent if it is running To determine if the master agent is running enter ps A grep snmpdx If the master agent is running the command will produce output similar to 136 0 00 snmpdx NMS Communications 27 Installing and configuring NMS SNMP NMS SNMP Reference Manual 8 If the master agent is running run the kill command to send a kill signal to that process using the output of the previous command lei 9 136 Another way to stop the master agent process is by entering etc init d init snmpdx stop 9 Restart the master agent To do so enter etc init d init snmpdx start The following is an extract of the file init snmpdx iv COINAGE SC I oy Suit Macros yStems Mine All rights reserved tident init snmpdx iL 2 SNIL 0s SMa case US t a start if etc SNMP conf snmpdx rsrc a x usr lib SNMP snmpdx then usr lib sNMP snmpdx p 161 y c etc SNMP conf d 0 JRA STO usr bin pki11 9 x u 0 snmpdx snmpv2d mibiisa Y rr ES sciio Ussges SO sieeiae suo 1 28 NMS Communications NMS SN
60. Database MIB NMS SNMP Reference Manual Configuration Database NMS OAM 5 Board ASOCIA Plug In Board A Managed Object _ RS i Boards b a d i Board Plug In Managed Object Hot Swap EMC Managed Object Hot Swap EMC i Clock Management H EMC Managed Object Clock Management EME ff he A E NMS OAM Supervisor gt Managed Object NMS OAM components and managed objects 166 NMS Communications NMS SNMP Reference Manual OAM Database MIB tables and keywords Within the OAM Database MIB the data in the NMS OAM database is represented in the following tables OAM Database MIB Table Contains oamSupervisor A table allowing access to the configuration data for the Supervisor managed object Additional values in this table allow an application to e Start and stop the Supervisor process e Set up event masking e Configure alert registration e Create new board entries oamBoardPlugins A table allowing access to the configuration data for each installed board plug in oamEMCs A table allowing access to the configuration data for each installed EMC oamBoards Tables allowing access to the configuration data for each board in the system These tables allow an application to e Query and change keywords for managed objects e Query and change board names and numbers e Start and stop a board e Test a board e De
61. FarEndLOMF 512 Far End Sending TS16 LOMF Not supported dsx1XmtFarEndLOMF 1024 Near End Sending TS16 LOMF Not supported dsx1RcvTestCode 2048 Near End detects a test code dsx10therFailure 4096 Any interface status not defined Note Far end is not supported Configuration Not applicable 124 NMS Communications NMS SNMP Reference Manual dsx1LineStatusChange Sent when the value of an instance dsx1LineStatus changes Syntax TruthValue Access Read only OID p 15 0 1 Configuration Not applicable NMS Communications Trunk MIB 125 Trunk MIB NMS SNMP Reference Manual dsx1LineType Indicates the type of DS1 interface implementing the circuit Syntax Integer Access Read write OID p 6 1 5 n where n the index number of the DS1 interface Details Valid entries are Type Value Description Other 1 Unlisted dsx1ESF 2 Extended SuperFrame DS1 dsx1D4 3 AT amp T D4 format DS1 dsx1E1 4 CCITT Recommendation G 704 Table 4a dsx1E1 CRC 5 CCITT Recommendation G 704 Table 4b dsx1E1 MF 6 G 704 Table 4a with TS16 multiframing enabled dsx1E1 CRC MF 7 G 704 Table 4b with TS16 multiframing enabled Values 3 and 4 are the only options the agent can return For example El interfaces return dsx1E1 and T1 interfaces return dsx1D4 Configuration Not applicable 126 NMS Communications NMS SNMP Reference Manual dsx1LineStatu
62. ID p 3 1 1 1 n Details This object matches the pkgl ndex identifier of an installed package in the Package Entry pkgTable table Configuration This identifier is internally assigned by the agent NMS Communications 155 Software revision MIB NMS SNMP Reference Manual patchTable Starts a sequence of patchEntry objects each of which composes a row in the Patch Entry table Syntax Object Access Not accessible OID p 3 1 Configuration When the Natural Access Server ctdaemon is restarted rows are added or removed as necessary to reflect the current sets of installed patches and service packs 156 NMS Communications NMS SNMP Reference Manual Software revision MIB patchi D Indicates the ID or number of the patch Syntax DisplayString SIZE 0 255 Access Read only OID p 3 1 1 3 n Configuration When the Natural Access Server ctdaemon is restarted all values including this one are imported from the sgn files NMS Communications 157 Software revision MIB NMS SNMP Reference Manual packageAccess Starts a group containing the dirPath pkgCount and pkgTable objects Syntax Object Access Not accessible OID p 1 Details The group contains the following Object Description dirPath Top of the table pkgCount Total number of installed packages pkgTable Package Entry table Configuration Not applicable 158 NMS Communications
63. ID p 4 Configuration Not applicable NMS Communications 73 Chassis MIB NMS SNMP Reference Manual chassBoardAccess Starts the sequence of objects that make up the Board Access table in the Chassis MIB Syntax Object Access Not accessible OID p 3 Configuration Not applicable 74 NMS Communications NMS SNMP Reference Manual Chassis MIB chassBoardCount Indicates the number of boards currently installed in the chassis Syntax Integer Access Read only OID p 4 1 Details Corresponds to the number of boardEntry objects which starts a row in the table Incremented when a board is inserted and decremented when a board is extracted Configuration Not applicable NMS Communications 75 Chassis MIB NMS SNMP Reference Manual chassBoardTrapEnable Sets the default value for the boardStatusChangeTrapEnable object for the entries in this table Syntax Integer Access Read write OID p 4 2 Details Valid values are Value Description 1 Enabled 2 Disabled default Configuration Not applicable 76 NMS Communications NMS SNMP Reference Manual chassConfig Starts a group of three objects that describe the chassis Syntax Object Access Not accessible OID p 2 Configuration Not applicable NMS Communications Chassis MIB 77 Chassis MIB NMS SNMP Reference Manual chassDescr Provides a textual description of
64. MP Reference Manual Installing and configuring NMS SNMP Linux To change the SNMP master agent s UDP port 1 2 3 Log in as superuser Open the file etc rc d init d snmpd for editing In this file find the line beginning with daemon usr sbin snmpd Replace the first section of the line with daemon usr sbin snmpd p 49212 Save and close this file Open a console window Now stop and restart the master agent if it is running To determine if the master agent is running enter ps A grep snmpd If the master agent is running the command will produce output similar to 136 0 00 snmpd If the master agent is running run the kill command to send a kill signal to that process using the output of the previous command kill 9 136 Another way to stop the master agent process is by invoking etc re d init d snmpd stop Restart the master agent by entering etc re d init d snmpd start NMS Communications 29 Installing and configuring NMS SNMP NMS SNMP Reference Manual Configuring NMS SNMP Use the SNMP configuration file snmp cfg to set the IP UDP ports used by the multiplexer to communicate with the master agents receive or send SNMP requests and communicate with the NMS subagents You can also use snmp cfg to e Set the write access for a given subagent using a community name e Set the trap destination for one or more subagents e Set information specific to a given MIB for example the Chassi
65. MP Reference Manual OAM Database MIB Using the OAM database MIB object reference The following sections describe the objects in this MIB A typical object description includes Syntax The datatype of the object is shown SNMP data types include Integer 16 bit signed DisplayString ASCII text Gauge Positive integer from 0 to 4294967295 2 1 Object Another object type from this MIB TimeStamp Positive integer from 0 to 4294967295 277 1 TruthValue Integer value where 1 is True and 2 is False Access The type of access allowed for this object Options are Read only This object can not be modified by SNMP Read write SNMP can configure this object OID The OID defines the path from the root to this object All OIDs start with p where p is is 1 3 6 1 4 1 2628 2 2 the OID for the Chassis MIB Details Describes the object Configuration Describes how to configure the object Example Shows an example of the object The source from which the NMS MIBs was compiled is supplied with the software in ASN1 format text files These files can be found in nms ctaccess doc opt nms ctaccess doc under UNIX NMS SNMP MIBs were compiled using the following files e Chassis MIB chassis mib txt e Trunk MIB chassis mib txt e Software Revision MIB softrev mib txt e OAM Database MIB oamdatabase mib txt Read the appropriate file using the Windows Console Management fu
66. MS Communications Installing and configuring NMS SNMP Installation summary This topic summarizes procedures for installing and activating NMS SNMP software Note NMS SNMP software components fully support SNMP version 1 but do not fully support SNMP version 2 For example the get bulk operator is not correctly supported and SNMP traps are generated in version 1 format We thus recommend that you use SNMP request version 1 when accessing NMS subagents Supported operating systems NMS SNMP software is available for the following operating systems e Windows 2000 e SPARC Solaris e Intel Solaris e Red Hat Linux Installation and configuration overview This section outlines the steps required to install and configure NMS SNMP Each step is described in detail in the sections that follow To install and configure NMS SNMP 1 Install the SNMP master agent By default the master agent communicates with the network using UDP port 161 Subagents Installing the SNMP master agent NMS Communications 21 Installing and configuring NMS SNMP NMS SNMP Reference Manual 2 Install the NMS multiplexer mux and subagents Note problem here Installing the NMS multiplexer 3 To set up the NMS multiplexer between the network and the SNMP master agent configure the master agent so one of its UDP ports matches the NMS multiplexer By default the NMS multiplexer s secondary port is port 49212 Changed to match NMS
67. Minutes DMs Syntax Gauge Access Read only OID p 7 1 10 n where n the index number of the DS1 interface Details A Degraded Minute is one in which the estimated error rate exceeds 1E 6 but does not exceed 1E 3 see CCITT Specifications Volume III Recommendation G 821 Degraded Minutes are determined by collecting all of the Available Seconds removing any Severely Errored Seconds grouping the result in 60 second long groups and counting a 60 second long group as degraded if the cumulative errors during the seconds present in the group exceed 1E 6 Available Seconds are merely those seconds which are not Unavailable Seconds dsx1CurrentUASs Configuration Not applicable 104 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx1CurrentEntry Starts a group of objects that make up a table for the DS1 interface identified by dsx1Currentl ndex Syntax Object Access Not accessible OID p 7 1 Details There is one entry object for each DS1 interface Configuration Not applicable NMS Communications 105 Trunk MIB NMS SNMP Reference Manual dsx1CurrentESs indicates the mumber of Errored Seconds Syntax Gauge Access Read only OID p 7 1 2 n where n the index number of the DS1 interface Details For ESF and El CRC links an Errored Second is a second with one or more Path Code Violations OR one or more Out of Frame defects OR one or more Controlled Slip events
68. NMP Reference Manual Trunk MIB dsx1LoopbackStatus Represents the current state of the loopback on the DS1 interface Syntax Integer 1 127 Access Read only OID p 6 1 18 n where n the index number of the DS1 interface Details This value contains information about loopbacks established by a manager and remotely from the far end dsx1LoopbackStatus is a bit map represented as a sum therefore it can represent multiple loopbacks simultaneously The bit positions are Bit Value 1 dsx1NoLoopback 2 dsx1NearEndPayloadLoopback 4 dsx1NearEndLineLoopback 8 dsx1NearEndOtherLoopback 16 dsx1NearEndI nwardLoopback 32 dsx1FarEndPayloadLoopback 64 dsx1FarEndLineLoopback Note The NMS SNMP agent always returns dsx1NoLoopback because loopback is not supported Configuration Not applicable NMS Communications 129 Trunk MIB NMS SNMP Reference Manual dsx1SendCode Indicates the type of code being sent across the DS1 interface by the device Syntax Integer Access Read write OID p 6 1 7 n where n the index number of the DS1 interface Details Valid values include Type Value Description dsx1SendNoCode 1 Sending looped or normal data dsx1SendLineCode 2 Sending a request for a line loopback dsx1SendPayloadCode 3 Sending a request for a payload loopback dsx1SendResetCode 4 Sending a loopback termination req
69. NMS OAM alert messages and events as SNMP traps Syntax Integer enable 1 disable 2 Access Read write OID p 1 3 Details Reading this value determines its current setting For more information refer to OAM MIB events Configuration Not applicable NMS Communications 227 OAM Database MIB NMS SNMP Reference Manual oamBoardPlugins Provides the start of the OAM Board Plug in table containing for each board plug in a table of the plug in s keywords values and qualifiers Syntax Object Access Not accessible OID p 2 Details The objects in the OAM Board Plug in table are Object Description boardPluginTable Top of the table boardPluginEntry Starts a row of the OAM Board Plug in table boardPluginI ndex Plug in index This is equivalent to the index number of the BoardPlugins x keyword listing the board plug in in the Supervisor managed object see below boardPluginKwI ndex Unique index within this table identifying the keyword bpikeywordName The keyword name formatted as described in OAM database MIB tables and keywords bpikwValue The value of the keyword bpikwType The type of the keyword Integer or String bpikwMode 1 indicates keyword value is read write 0 indicates keyword value is read only bpikwAllowedRange The range of allowable values for the keyword formatted as described in OAM database MIB tables and keywords bpikw Descr
70. Not accessible OID p 6 1 Configuration Not applicable NMS Communications 101 Trunk MIB NMS SNMP Reference Manual dsx1CurrentBESs Indicates the number of Bursty Errored Seconds BESs Syntax Gauge Access Read only OID p 7 1 9 n where n the index number of the DS1 interface Details A Bursty Errored Second also known as Errored Second type B is a second with fewer than 320 and more than 1 Path Coding Violation error events no Severely Errored Frame defects and no detected incoming AIS defects Controlled slips are not included in this parameter This is not incremented during an Unavailable Second dsx1CurrentUASs Configuration Not applicable 102 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx1CurrentCSSs Indicates the number of Controlled Slip Seconds Syntax Gauge Access Read only OID p 7 1 6 n where n the index number of the DS1 interface Details A Controlled Slip Second is a one second interval containing one or more controlled slips A Controlled Slip is the replication or deletion of the payload bits of a DS1 frame A Controlled Slip may occur when there is a difference between the timing of a synchronous receiving terminal and the received signal A Controlled Slip does not cause an Out of Frame error Configuration Not applicable NMS Communications 103 Trunk MIB NMS SNMP Reference Manual dsx1CurrentDMs Indicates the number of Degraded
71. OR a detected AIS defect For D4 and E1 noCRC links the presence of Bipolar Violations also triggers an Errored Second This value is not incremented during an Unavailable Second Configuration Not applicable 106 NMS Communications NMS SNMP Reference Manual dsx1Currentl ndex Number of the DS1 interface to which block of variables apply Syntax Integer Access Read only OID p 7 1 1 n where n the index number of the DS1 interface Details The following block of variables apply for Hot Swap If a board is Then the Extracted Index will be removed Inserted Next available index number will be used Replaced Next available index number will be used This is the same as dsx1Linel ndex in the Configuration table Configuration Not applicable NMS Communications Trunk MIB 107 Trunk MIB NMS SNMP Reference Manual dsx1CurrentLCVs Indicates the number of Line Code Violations LCVs Syntax Gauge Access Read only OID p 7 1 11 n where n the index number of the DS1 interface Details A Line Coding Violation LCV is the occurrence of either a Bipolar Violation BPV or Excessive Zeroes EXZ Error Event Also known as CV L See T1 231 Section 6 5 1 1 An Excessive Zeroes error event for an AMI coded signal is the occurrence of more than fifteen contiguous zeroes See ANSI T1 231 Section 6 1 1 1 2 For a B8ZS coded signal the defect occurs when
72. PluginTable E boardPluginEntry boardPluginindex boardPluginKwIndex bpikeywordName bpikwValue bpikwType bpikwMode bpikwAllowedRange bpikwDescription a oamEMCs a emcTable a emcEntry emcindex emcKwIndex emckeywordName emckwValue emckwType emckwMode emckwAllowedRange emckwDescription a oamBoards detectedBoardCount createdBoardCount a boardTable E boardEntry boardIndex boardKwIndex brdkeywordName brdkwValue brdkwType brdkwMode brdkwAllowedRange brdkwDescription aj boardManagementTable E boardManagementEntry boardManagementindex brdName brdNumber brdStartStop brdTest brdDelete a oamOtherObjects a otherObjectsTable E otherObjectsEntry otherObjectsIndex otherObjectsKwIndex otherObjectskeywordName otherObjectskwValue otherObjectskwType otherObjectskwMode otherObjectskwAllowedRange otherObjectskwDescription E oamEventsTraps oamEventDescription OAM database MIB objects 170 NMS Communications NMS SNMP Reference Manual OAM MIB Supervisor tables The OAM Supervisor table contains e A table of Supervisor keywords values and qualifiers OAM Database MIB e Values that allow you to start or stop the Supervisor process set up event masks register for NMS OAM alert events and create board instances in the database The objects in the OAM Supervisor table oamSupervisor are Object Description oamStartStop Starts or stops the NMS OAM Supervisor process or indicates its status oamEventMask Sets
73. Read only OID p 4 3 1 12 n where n is the entry number Details O means no trunks Configuration Not applicable 66 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual busSegmentDescr Proves a textual description of the Bus Segment Syntax DisplayString SIZE 0 255 Access Read only OID p 2 4 1 3 n where n ranges from 1 to the number of bus segments Details The value can be one of the following e PCI bus segment number 0 e ISA Configuration Not applicable NMS Communications Chassis MIB 67 Chassis MIB NMS SNMP Reference Manual busSegmentEntry Starts a row in the Bus Segment table Syntax Object Access Read only OID p 2 4 1 Details A busSegmentEntry object block is added to the Bus Segment table when a board is inserted into a slot on a previously unpopulated bus This object and the associated block of objects is removed when a board is extracted from the bus Configuration Not applicable 68 NMS Communications NMS SNMP Reference Manual busSegmentl ndex Identifies this row in the Bus Segment table Syntax Integer Access Read only OID p 2 4 1 1 n where n ranges from 1 to the number of bus segments Details Internally assigned by the agent The value range is 1 lt n lt chassSegmentBusCount Configuration Not applicable NMS Communications Chassis MIB 69 Chassis MIB NMS SNMP Reference M
74. S Communications NMS SNMP Reference Manual OAM Database MIB otherObjectskw Description Provides a short description of the keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 5 1 1 8 n Details otherObjectskw Description is equivalent to the value of the Description qualifier for the keyword in the NMS OAM database If no description is given otherObjectskwDescription contains lt none gt Configuration When the OAM Database SNMP agent starts up it populates all MIB tables based upon values from the NMS OAM database For more information refer to Populating OAM MIB tables NMS Communications 241 OAM Database MIB NMS SNMP Reference Manual otherObjectsKw ndex Indicates the keyword s index Syntax Integer Access Read only OID p 5 1 1 2 n Details Keywords are numbered sequentially from 1 upward Configuration This value is determined when the OAM Database SNMP agent populates the Other Objects table 242 NMS Communications NMS SNMP Reference Manual OAM Database MIB otherObjectskw Mode Indicates if the keyword is read only or read write Syntax Integer readOnly 1 readWrite 2 Access Read only OID p 5 1 1 6 n Details otherObjectskw Mode reflects the value of the keyword s ReadOnly qualifier in the NMS OAM database Configuration When the OAM Database SNMP agent starts up it populates all MIB tables based upon values from the NMS OAM database
75. S SNMP Reference Manual slotBusSegmentl ndex Identifies the bus segment to which this slot belongs Syntax Integer Access Read only OID p 3 1 1 1 n m where n is the index of this segment in the Bus Segment table and m is the index of the slot in this segment Details This value corresponds to busSegmentl ndex in the Bus Segment table Configuration Not applicable 84 NMS Communications NMS SNMP Reference Manual Chassis MIB slotEntry Starts a row in the Board Access table Syntax Object Access Not accessible OID p 3 1 1 Details A slotEntry block of objects is added to the Board Access table whenever a board is inserted and removed when a board is extracted Objects belonging to this entry belong to a Doubly Indexed table and are accessed using an OID of p 3 1 1 x n m where x the object of the group and the column number of this row n the bus segment number slotBusSegmentIndex the first index m the slot number slotl ndex the second index For more information about Doubly Indexed tables see Accessing MIB objects Configuration Not applicable NMS Communications 85 Chassis MIB NMS SNMP Reference Manual slotl ndex Provides the logical index of a slot within the bus segment Syntax Integer Access Read only OID p 3 1 1 2 n m where n is the index of this segment in the Bus Segment table and m is the index of the slot in this segment Con
76. SNMP Reference Manual OAM Database MIB emckwMode Indicates if the EMC keyword is read only or read write Syntax Integer readOnly 1 readWrite 2 Access Read only OID p 3 1 1 6 n Details emckwMode reflects the value of the keyword s ReadOnly qualifier in the NMS OAM database Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Extended Management Component table is populated see OAM MIB EMC table NMS Communications 217 OAM Database MIB emckwType Indicates the type of the EMC keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 3 1 1 5 n Details Valid EMC keyword types include Type Description Integer An integer String A string of O or more characters NMS SNMP Reference Manual emckwType is equivalent to the value of the Type qualifier for the keyword in the NMS OAM database Keywords of other types for example Array Struct StructAndArray are not included as separate entries in MIB tables For more information see Keywords in the OAM database MIB Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Extended Management Component table is populated refer to the OAM MIB EMC table 218 NMS Communica
77. able emci ndex EMC index emcKwl ndex Unique index within this table identifying the keyword emckeywordName The keyword name formatted as described in OAM database MIB tables and keywords emckwValue The value of the keyword emckwType The type of the keyword Integer or String emckwMode 1 indicates keyword value is read only 2 indicates keyword value is read write emckwAllowedRange The range of allowable values for the keyword formatted as described in OAM database MIB tables and keywords emckw Description A short description of the keyword To populate this table the OAM Database SNMP agent opens the NMS OAM Supervisor managed object and retrieves the values in the ExtendedManagementComponents x keyword This is an array listing the EMCs installed and running under the Supervisor The agent opens the managed object for each listed EMC and creates a row in the Extended Management Object table oamEMCs for each keyword in the managed object Each keyword is given two indices e The index of the EMC to which the keyword belongs emcl ndex This is equivalent to the index of the ExtendedManagementComponents x keyword listing the managed object e A unique numerical index emcKwlndex from 1 upwards 174 NMS Communications NMS SNMP Reference Manual OAM Database MIB OAM MIB Boards table The OAM Boards table contains e The number of boards automatically detected in the system e The total number of board
78. able lists the information stored in a MIB for each keyword Datum Description Valid values Managed Object Index The index of the managed object to which the keyword belongs Any integer from 1 upward Index A unique within the table index for the keyword Any integer from 1 upward Keyword Name The name of the keyword The keyword name preceded by one or more group keyword names separated by periods see below Keyword Value The value of the keyword Any value permitted by the keyword s type and possible value parameters Type Type of keyword value Equivalent to the value Integer String or Object Keywords of type of the keyword s Type qualifier Object appear only in the Supervisor Keyword table supervisorTable Mode Indicates if keyword value is read only or not 1 indicates keyword value is read only Reflects the value of the keyword s Readonly qualifier 2 indicates keyword value is read write Possible Values Indicates the range of possible values for the keyword Combines information from the keyword s Base Min Max and Choices qualifiers If the keyword type is Integer and is a yes no choice this field contains a string of this format Nb values 2 Yes No If the keyword type is Integer and can take a range of values this field contains a string of this format BASE base min_ value lt gt max_ value where base is a mathematical
79. anual busSegmentSlotsOccupied Indicates the number of occupied slots in this entry s bus segment Syntax Integer Access Read only OID p 2 4 1 4 n where n ranges from 1 to the number of bus segments Details This value determines the number of entries in the Board Access by slot table for this bus segment Updated by the agent when a board is inserted into or extracted from the associated bus segment Configuration Not applicable 70 NMS Communications NMS SNMP Reference Manual Chassis MIB busSegmentTable Starts a sequence of busSegmentEntry objects that compose a row in the Bus Segment table Syntax Object Access Not accessible OID p 2 4 Details The Bus Segment table row is composed of exactly n busSegmentEntry objects where n chassSegmentBusCount Configuration Not applicable NMS Communications 71 Chassis MIB busSegmentType Indicates the bus type Syntax Integer Access Read only OID p 2 4 1 2 n where n ranges from 1 to the number of bus segments Details Valid values are Value Type 1 ISA bus not supported in Natural Access versions 4 0 and later 2 PCI or CompactPCI bus Configuration Not applicable 72 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Chassis MIB chassBoard Starts the series of variables that constitutes the Board table Syntax Object Access Not accessible O
80. ates all MIB tables based upon information from the NMS OAM database For more information on how the Supervisor Keyword table is populated refer to the OAM supervisor tables 222 NMS Communications NMS SNMP Reference Manual OAM Database MIB kw Description Provides a short description of the Supervisor keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 1 4 1 7 n Details kwDescription is equivalent to the value of the Description qualifier for the keyword in the NMS OAM database If no description is given kwDescription contains lt none gt Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Supervisor Keyword table is populated refer to the OAM supervisor tables NMS Communications 223 OAM Database MIB NMS SNMP Reference Manual kw Mode Indicates if the Supervisor keyword is read only or read write Syntax Integer readOnly 1 readWrite 2 Access Read only OID p 1 4 1 5 n Details kwMode reflects the value of the keyword s ReadOnly qualifier in the NMS OAM database Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Supervisor Keyword table is populated refer to the OAM supervisor tables 224 NMS Communications NMS SNMP Reference Manual
81. base OAM MIB Other Objects table The Other Objects table is included so that future extensions to NMS OAM do not require changes to the structure of the OAM Database MIB The Other Objects table will contain for each object a table of the objects keywords values and qualifiers The objects in the Other Objects table oamOtherObjects are Object Description otherObjectsTable Top of the table otherObjectsEntry Starts a row of the Other Objects table otherObjectsl ndex Object index otherObjectsKwl ndex Unique index within this table identifying the keyword otherObjectskeywordName The keyword name formatted as described in OAM database MIB tables and keywords otherObjectskw Value The value of the keyword otherObjectskwType The type of the keyword Integer or String otherObjectskw Mode 1 indicates keyword value is read only 2 indicates keyword value is read write otherObjectskwAllowedRange The range of allowable values for the keyword formatted as described in OAM database MIB tables and keywords otherObjectskwDescription A short description of the keyword OAM MIB Events Traps table The OAM Events Traps table allows an application to receive OAM events through the MIB The objects in the OAM Events Traps table oamEventsTraps are Object Description oamEventDescription The last event sent back by OAM 176 NMS Communications NMS SN
82. bjects defined by RFC 2495 Configuration Not applicable 114 NMS Communications NMS SNMP Reference Manual dsx1Ds1ChannelNumber Represents the channel number of the DS1 E1 on its parent DS2 E2 or DS3 E3 Syntax Integer 0 28 Access Read only OID p 6 1 19 n where n the index number of the DS1 interface Details A value of 0 indicates this DS1 E1 does not have a parent DS3 E3 Note The NMS SNMP agent always returns 0 Configuration Not applicable NMS Communications Trunk MIB 115 Trunk MIB NMS SNMP Reference Manual dsx1Fdl Describes the use of the facilities data link and the sum of its capabilities Syntax Integer Access Read write OID p 6 1 13 n where n the index number of the DS1 interface Details Valid entries include Type Value Description other 1 Unknown protocol used dsx1Ansi T1 403 2 FDL exchange recommended by ANSI dsx1Att 54016 4 ESF FDL exchanges dsx1Fdl none 8 Device does not use the FDL Note The NMS SNMP agent always returns dsx1Fdl none 8 Facilities data link is not supported Configuration Not applicable 116 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx11 fl ndex For NMS boards identifies a DS1 interface managed by this agent Syntax Integer 0x1 Ox7fffffff Access Read only OID p 6 1 2 n where n the index number of the DS1 interface Details This value is
83. cable 62 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Chassis MIB boardStatusChangeTrapEnable Determines whether traps are generated for the board Syntax Integer Access Read write OID p 4 3 1 17 n where n is the entry number Details Enabling this object will cause traps to be sent to the management station and update the boardStatusLastChange object Valid values are Value Description 1 Enabled 2 Disabled default Configuration Not applicable NMS Communications 63 Chassis MIB NMS SNMP Reference Manual boardStatusLastChange Provides the time stamp of when the status of the board last changed Syntax TimeTicks Access Read only OID p 4 3 1 16 n where n is the entry number Configuration Not applicable 64 NMS Communications NMS SNMP Reference Manual Chassis MIB boardTable Starts a sequence of boardEntry objects which defines the rows of the Board table Syntax Object Access Not accessible OID p 4 3 Details The Board table contains configuration and status information for all boards in the chassis This table consists of exactly n m boardEntry entries where n chassSegmentBusCount and m busSegmentSlotsOccupied Configuration Not applicable NMS Communications 65 Chassis MIB boardTrunkCount Indicate the number of trunks on this board Syntax Integer Access
84. cococoncoronooros tacon nono caian E ce uan eden cute 39 C assis MI B representaatio Mt priri ieseist vices seed ccteaghdivece pia EA aE TAE GEE p EA a cual A EEA 39 Using theChassiS MiBio ciar tata pd EA anda TAO 39 TAS di aci n 39 HOES Wap wes O ON acetate es 39 BORA A tel ua te pedis pel ed oan Ga tee E ea pene ete ae ia ae 39 Linking tothe trunk MiBcucioa ii 40 Chassis MI B StrUCtUT Oia de uve eee ees euee 0 ee eed eve eke PEA Eiaa Era ek ce Fes Taa PENi eee 40 Chassis MIB Configuration table serres sarena nren nia renee nena ene aAa 43 Chassis MIB Bus Segment table ccc erent ate nate naees 43 Chassis MIB Board Access table ce cece ee nent nee nent nates 44 Chassis MIB Board table viii REED 45 Chassis Trap Group iii 45 Using the Chassis MIB object reference 0 ccc nst rt nnrir nnt r rnnt u ete Ennn nrun nenun nnt 46 boardBuSSeQMentNUMbe Lr 20 ccc a a AE a E A A E AE 47 boardBusSegmently O 2 35 anise ican Mi eee a nd Sea ea Ee em cea a ea A EERE A 48 NMS Communications 3 Table of Contents NMS SNMP Reference Manual DOA GOP AING uti Stes ese a A Dacia eat A A di Stree eae tal nde ice 49 DOAKODESCE sc cctee Gaara ae Siete an elles acawaklet aid 50 board EMEY casara ds 51 DOMAIN A A RAE Cee 52 b ardFamilyl dsann A onde 53 BoardF amy NUMDe E sica aorta 54 board ManUiDater sn A A A AA A AA eee aaa ae 55 DOM ii ea oo OE a E A E 56 b ardModelTeXt aanraai rt a Di E E A ia A ana DTA 57 DOS T
85. d event occurs on the managed node The SNMP service is a daemon on UNIX systems and a system service under Windows The SNMP service runs one or more agents which are applications that collect information about the managed node and keep it in a MIB A managed node can have more than one MIB and has one agent for each MIB See Installation summary for information about how to activate the SNMP service and load an agent The SNMP architecture is designed to be simple and fast The processing load is placed on the management station and minimized on the managed node The set of information contained in the MIB is designed to be simple so information about the network will not congest the network Management Information Bases A Management Information Base MIB defines the information that will be maintained by the associated agent A MIB is viewed as a database but is actually a sequential list of managed objects The managed objects are logically grouped to represent a row in a table where each object in that group represents a field The field may be a variable or a structure of variables Each managed object is referred to by a unique object identifier OID A MIB is often shown as a tree where the nodes of the tree define the database and its tables rows and fields The collection of all MIBs is organized in a tree structure where each node on the tree represents a single MIB The SNMP MIB hierarchy is defined by RFC 1155 and RFC 121
86. d under license and are trademarks or registered trademarks of SPARC International Inc in the United States and or other countries Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems Inc All other marks referenced herein are trademarks or service marks of the respective owner s of such marks All other products used as components within this product are the trademarks service marks registered trademarks or registered service marks of their respective owners Every effort has been made to ensure the accuracy of this manual However due to the ongoing improvements and revisions to our products NMS Communications cannot guarantee the accuracy of the printed material after the date of publication or accept responsibility for errors or omissions Revised manuals and update sheets may be published when deemed necessary by NUS Communications P N 9000 6744 16 Revision history Revision Release date Notes 1 0 September 1999 EPS for CT Access 3 0 1 1 January 2000 EPS for CT Access 3 0 GA 1 2 July 2000 EPS SJC Platform support for Fusion 4 0 1 3 September 2000 SJC for CT Access 4 0 GA 1 4 January 2001 CYF 1 5 August 2001 CYF for NACD 2001 1 GA 1 6 May 2002 MVH for NACD 2002 1 This manual printed May 28 2002 Refer to the NMS web site www nmscommunications com for product updates and for information about NMS support policies warranty inf
87. dade 203 bro kw Vall Ue iiss se Sok recs ice os ada ok Sa ens Weed od leeds nee od Side Riles ee og atv inde E ee oa nae a kaaa 204 BraN aM dd tele aa eta ee aa aan 205 DrONUMDER vse tee aea a e a oe ea te a ean eave dees Wee eda dae eee No ete Nereida aad 206 A 207 91 e o o A dene E E E 208 create dBOar COUNT ee e A cokes 209 detectedBoardlount e o ee 210 An o A A ERE 211 email ii dll dae 212 6 NMS Communications NMS SNMP Reference Manual Table of Contents EMCKeYWOrdNAMe sico tiara ees eee a a a aces a a unas setts aa cede naa renee atari ede 213 EmckwAllowedRange ii A REI Se AA a ee oe 214 EIMICKW DOSEFIPEIO Naiara add 215 OMEKWINO AER ci 216 EMCKWMOde sisena ees ened dele ei Eaten EE T Hale dine ieee by Salvi as e Geen eevee C 217 OMEKWTY Plica as rr 218 CMCKWV Ale cia A A 219 A te Nee Ses Ee od ie ieee das Eevee a ee ie ee Ne EY 220 KEY WORN GING iio anene oae AA EEE E a OE EE A E aaia 221 KWAIOWEDRAN GOs isea a a E A id 222 kwDescriptioM iii ie 223 KW MOG ts Sd no 224 KW YPC cui e 225 KWV ale cia a a ie ie ee ed es i ide ene a EI ee ea 226 camAlertReg iSeries 227 OAMBOardPIUGINS A A oo ed ld ts ol So pete og ol ie 228 OAIMBOAMAS ici SES Eee a ee de ee We ee de ee ene ee ede Dea ee ee Be ee Se ey ee De nee EEN 229 camtGreateBO mocos ocn 230 OAMEMGS AA A A A a 231 oamEventDescriptiON s niiae e i a a EE E E EE aa EEEa eee eee ene eee eee nae 232 OAMEVENEMASK Hart 233 OAMEVENS ITAD Seien eai ea aAa T AAA AAA A E dine astaaaes 2
88. dsx1I ntervalNumber and dsx1IntervalValidData These are explained in the following sections Trunk MIB Current table The following table summarizes each object in the Trunk MIB Current table otherwise known the dsx1CurrentEntry block of variables Object Syntax Description dsx1Currentl ndex Integer Number of the DS1 interface dsx1CurrentESs Gauge Number of errored seconds dsx1CurrentSESs Gauge Number of severely errored seconds dsx1CurrentSEFSs Gauge Number of severely errored framing seconds dsx1CurrentUASs Gauge Number of unavailable seconds dsx1CurrentCSSs Gauge Number of controlled slip seconds dsx1CurrentPCVs Gauge Number of path coding violations dsx1CurrentLESs Gauge Number of interface errored seconds dsx1CurrentBESs Gauge Number of bursty errored seconds dsx1CurrentDMs Gauge Number of degraded minutes dsx1CurrentLCVs Gauge Number of line code violations 94 NMS Communications NMS SNMP Reference Manual Trunk MIB Trunk MIB Total table The Total table contains the sum of the statistics that the RFC 2495 MIB has kept for the managed node since the agent for this MIB first started All the descriptions match the variables in the Current table except that for the Total table the values are for the total time the MIB has been written to and for the Current table the values are for the current 15 minute period The names of the variables in the two tables match
89. e Details Trunk MIB The number in the index is assigned in the sequence that the agent finds the interfaces on the boards which does not necessarily represent the physical order of the interfaces For Hot Swap valid values include If a board is Then the Extracted Index will be removed Inserted Next unused index number will be used Replaced Next unused index number will be used Configuration Not applicable NMS Communications 121 Trunk MIB NMS SNMP Reference Manual dsx1LineCoding Indicates the type of Zero Code Suppression used on the interface Syntax Integer Access Read write OID p 6 1 6 n where n the index number of the DS1 interface Details Valid values include Type Value Description dsx1J BZS 1 Jammed Bit Zero Suppression in which the AT amp T specification of at least one pulse every 8 bit periods is implemented by forcing a pulse in bit 8 of each channel Only seven bits per channel or 1 344 Mbps is available for data dsx1B8ZS 2 Specified pattern of normal bits and bipolar violations which replace a sequence of eight zero bits dsx1HDB3 3 El links with or without CRC use dsx1HDB3 or dsx1AMI dsx1ZBTSI 4 ANSI Clear Channels may use dsx1ZBTSI or Zero Byte Time Slot Interchange dsx1AMI 5 Mode where no zero code suppression is present and the interface encoding does not solve the problem directly In this appl
90. e Board table oamCreateBoard to add a board managed object to the NMS OAM database To do so Note This operation does not require that the board currently be physically installed in the system Specify a valid product name for productName A list of valid product names can be retrieved by querying the Supervisor keyword Products x Optional Specify a board name for boardName Optional Specify a board number for boardNumber Set applyBoardCommand to 1 A board managed object for product productName is added to the NMS OAM database If you did not specify a board name or number default values are generated Access and modify the board s keywords as described in Accessing board plug in and EMC keywords to perform further configuration In particular modify the Location PCl Bus and Location PCI Slot keywords to specify the location of the board for NMS OAM If the board is physically installed in the system start the board as described in Starting stopping and testing boards Deleting board managed objects To delete a board managed object 1 2 3 254 Stop the board as described in Starting stopping and testing boards Find the boardManagementlI ndex with the index value of the managed object for the board Set brdDelete in this row to 1 NMS Communications NMS SNMP Reference Manual Using the NMS OAM database MIB Querying and setting the board name and number For a board to be available it must
91. e dsx1Circuitl dentifier object in the Trunk MIB Configuration Not applicable 58 NMS Communications NMS SNMP Reference Manual boardRevision Returns the board revision Syntax DisplayString SIZE 0 255 Access Read only OID p 4 3 1 13 n where n is the entry number Configuration Not applicable NMS Communications Chassis MIB 59 Chassis MIB boardSerialNumber Indicates the board s serial number Syntax DisplayString SIZE 0 255 Access Read only OID p 4 3 1 14 n where n is the entry number Configuration Not applicable Example 123456754 60 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Chassis MIB boardSlotNumber Indicates the slot of the bus segment in which the board is installed Syntax Integer Access Read only OID p 4 3 1 4 n where n is the entry number Configuration Not applicable NMS Communications 61 Chassis MIB boardStatus Indicates the board status Syntax Integer Access Read only OID p 4 3 1 10 n where n is the entry number Details Expected values include Value Status 1 Online 2 Online Pending The board coming online is in progress 3 Failed 4 Offline The board is turned off and can be extracted 5 Offline Pending Waiting for activity to stop which can be time consuming 6 Extracted Configuration Not appli
92. eElapsed Number of seconds that have elapsed since the beginning of the current error measurement period Syntax Integer 0 899 Access Read only OID p 6 1 3 n where n the index number of the DS1 interface Configuration Not applicable NMS Communications 133 Trunk MIB NMS SNMP Reference Manual dsx1TransmitClockSource Indicates the source of the transmit clock that the board uses for synchronization Syntax Integer Access Read write OID p 6 1 12 n where n the index number of the DS1 interface Details Valid values include Type Value Description loopTiming 1 The recovered receive clock of this interface is used as the transmit clock Also know as slave localTiming 2 The recovered receive clock from another interface is used as the transmit clock Also known as master throughTiming 3 A local clock source is used Configuration This object is configured by editing the system configuration before starting the Chassis MIB agent 134 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx1Validl ntervals Indicates the number of 15 minute intervals for which valid data was collected Syntax Integer 0 96 Access Read only OID p 6 1 4 n where n the index number of the DS1 interface Details The value is always 96 unless the agent has been running for less than 24 hours in which case it indicates the number of 15 minute inter
93. ectory under UNIX 2 Enter the following snmpget localhost An example of running this command is snmpGet exe localhost SNMP Get to localhost SNMPV1 Retries 1 Timeout 100ms Community public Cid OS o2o lclo1 0 Value Hardware x86 Family 6 Model 3 Stepping 4 AT AT COMPATIBLE Software Windows 2000 Vien eV SAS 260 NMS Communications NMS SNMP Reference Manual Demonstration programs snmpnext Purpose Demonstrates SNMP get next Retrieves the value of the next object after a specified OID Usage snmpnext address cnmssnmpoid options Use the following parameters Parameter Description address The address or DNS name of a local or remote host running an SNMP agent about which to return information nmssnmpoid OID of an object in one of the MIBs available on the host for which you wish to see information The default is sysDescr Valid options include Option Description v1 Use SNMPv1 default v2 Use SNMPv2 ccommunity_name Specify a community name The default is public rn Number of retries The default is 1 retry tn Timeout in hundredths of a second The default is 100 1 second Procedure To run snmpnext 1 From the command line navigate to the nms ctaccess demos snmp snmpnext directory or the opt nms ctaccess demos snmp snmpnext directory under UNIX 2 Enter the following SIMPSON CREO O An example of running thi
94. ects in the Create Board table are Object Description productName Product type of the board to create boardName Name to give the created board boardNumber Board number to give the created board applyBoardCommand Set this to 1 to create the board based upon the productName boardName and or boardNumber values you specified Configuration Not applicable 230 NMS Communications NMS SNMP Reference Manual oamEMCs OAM Database MIB Starts the Extended Management Component EMC table containing for each EMC a table of the EMC s keywords values and qualifiers Syntax Object Access Not accessible OID p 3 Details The objects in the Extended Management Component EMC table are Object Description emcTable Top of the table emcEntry Starts a row of the Extended Management Component table emcindex EMC index emcKwl ndex Unique index within this table identifying the keyword emckeywordName The keyword name formatted as described in Keywords in the OAM database MIB emckwValue The value of the keyword emckwType The type of the keyword Integer Or String emckwMode 1 indicates keyword value is read write 0 indicates keyword value is read only emckwAllowedRange Range of allowable values for the keyword formatted as described in Keywords in the OAM database MIB emckwDescription A short description of the
95. ed the Current table where each row is the index of the interface and each column is a statistic If you get ESs for interface 1 then each get next retrieves ESs for the next interface as shown in the following illustration interface Indexed table When get next has retrieved ESs for interface 5 the next get next retrieves SESs for interface 1 The OID to a field in a doubly indexed table is p column index1 index2 The field is grouped by index1 and the particular field in that group is specified by get ES for the first time interval of the third interface get next retrieves ES for the next time interval as shown in the following illustration interface ESs SESS See time interval Doubly indexed table When get next has retrieved ES for all intervals of interface 3 the next get next will either get ES for the first interval of the next interface if there is one or SES for the first interval of interface 3 For more information refer to Trunk MIB Current table and Trunk MIB Interval table NMS Communications 15 Overview of NMS SNMP NMS SNMP Reference Manual Supported MI Bs NMS produces agents for the following MIBs MIB Description Ownership Installed by Trunk The Trunk MIB also called the DS1 MIB which RFC 2945 obsolete RFC 1406 OAM package represents DS1 and higher speed lines and is defined by the IETF Chassis Represents the PCI buses and slots bus segments and Proprietary OAM packa
96. ed upon information from the NMS OAM database For more information on how the Board Plug in table is populated refer to the OAM Board Plug in table NMS Communications 197 OAM Database MIB NMS SNMP Reference Manual brdDelete Deletes a board managed object Syntax Integer enable 1 disable 2 Access Read write OID p 4 4 1 6 n Details For more information see Creating and deleting board managed objects Configuration Not applicable 198 NMS Communications NMS SNMP Reference Manual OAM Database MIB brdkeywordName Indicates a board keyword name Syntax DisplayString SIZE 0 255 Access Read only OID p 4 3 1 3 n Details Where a keyword belongs to one or more arrays or structures the array and structure names are appended to the keyword name in the table separated by periods For example the keyword FallBackClockSource in the struct HBus which is within Clocking is expressed as Clocking HBus FallBackClockSource Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Keyword table is populated refer to OAM Boards table NMS Communications 199 OAM Database MIB NMS SNMP Reference Manual brdkwAllowedRange Indicates a range of allowed values for the board keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 4 3 1 7 n Details
97. er SolariS iman a A dvi 23 instal lingsUn der LINUX bart its 23 Installing the master agent under Windows 2000 0 cece cece e eee eee eee eee teen neta ene nates 24 Installing the NMS subagents and multiplexer 2 ccc eee eee eee eee reat ene tate nates 26 Modifying the Windows registry Windows ONIy ceceee eee e eee e eee eee ee eee eee eee eee eee 26 Modifying the master agent IP UDP port cece eee entree eee e teeta eae 27 Windows 2000 00000 ae Seine ee ead e oe ee ee ee de ee ee ee eee 27 Solanis e aaah enema 27 LIMUR oien A a a A A dathewweveet ewe dats 29 Configuring NMS SNMP peciit idee oe eee ie od ae eee oe Va ee od vide ee Dae ed eevee oe bade ed tev ey Blk 30 Configuration PITS SY MCA cia ra prin 30 Sample SNMP configuration file oooooocccccnccnoncccnnoncnnnccnnnncnnnccnnnnonnnnnnnnnnnn nn nnrnnnrennnnrnnnnannnes 32 Activating SNMP ooonncoococoononnconnncnnnncnnnnrnnnn cnn cnn cnn cnn ran rnnnnrnnnnrnnnnrnnnnrnrarnnrncnnrncanencnnes 35 Starting the NMS multiplexer and SUDAgenNtS ooocccccccccnccnnnccnnnccnnnccnnnnnnnnnnnnnnnnnnrannnnnnnnrannnnnns 35 Starting SNMP USING MUXG a2 sacl riot ta 35 Starting SNMP using the command line cece eee eee teenie eae ea eee 36 Reconfiguring multiplexer IP UDP ports cece cece nenet aetna tate eae 37 Running NMS SNMP so seeded aecsvuaedectaehe tack hae cae ane bee ads deer ied da eee ere aaa eT Pie ead 38 Chassis MiB cico
98. ersion of the package and the number of files in the package The Package table is represented in the MIB by the object packageAccess The objects in the Package table are Object Description dirPath Path where the sgn files can be found pkgCount Total number of installed packages pkgTable Package Entry table The objects in the Package Entry table are Object Description pkgEntry Top of the table pkgI ndex Unique identifier for an installed package pkgName Name of the package pkgVersion Base version of the package filesCount Total number of files in the package As shown in Software Revision MIB representation the pkglndex object provides an index into the File and Patch tables described in this topic 140 NMS Communications NMS SNMP Reference Manual Software revision MIB File table The File table contains a File Entry table This table contains a list of all files in each package For each file the table contains e The index of the package to which the file belongs e The name of the file e The base version of the file The File table is represented in the MIB by the object fileAccess The objects in the File table are Object Description fileTable File Entry table The objects in the File Entry table are Object Description fileEntry Top of the table filePkglndex Index of the package to which the file belon
99. ery add modify or delete information for managed objects in much the same way as NMS OAM does For detailed information on NMS OAM refer to the NMS OAM System User s Manual and to the NMS OAM Service Developer s Reference Manual Managed components NMS OAM manages the following components see the following illustration e Boards A separate set of configuration information is kept for each AG CG CX and QX board in the system e NMS OAM Supervisor NMS OAM keeps configuration information for its Supervisor process which oversees all other NMS OAM components e Board plug ins NMS OAM communicates with boards using software extensions called board plug ins There is one plug in per board family NMS OAM maintains a separate set of configuration information for each plug in e Extended management components EMCs Extended management components EMCs are software modules which add functionality to NMS OAM A separate set of configuration data is kept for each EMC Currently two EMCs are supplied with NMS OAM e Hot Swap EMC e H 100 and H 110 Clock Management EMC For more information about the Hot Swap EMC and Clock Management EMC refer to the NMS OAM System User s Manual The following illustration illustrates the relationship between the components in a system their representation as managed objects within NMS OAM and the relationship of managed objects to data within the NMS OAM database NMS Communications 165 OAM
100. example shows running snmpChassScan 264 NMS Communications NMS SNMP Reference Manual Demonstration programs snmpHsMon Purpose Demonstrates how to monitor a CompactPCI chassis how to receive traps when board status changes and how to remotely insert or extract a board Usage snmpHsMon parameter Use the following parameter Paramete Description r address The address or DNS name of a local or remote host running an SNMP agent about which to return information snmpHsMon is similar to the hsmon utility For more information see the NMS OAM System User s Manual for Natural Access 4 0 or later or the Hot Swap Manager Developer s Reference Manual for Natural Access 3 x Procedure To run snmpHsMon 1 From the command line navigate to the nms ctaccess demos snmp snmphsmon directory or the opt nms ctaccess demos snmp snmphsmon directory under UNIX 2 Enter the following snmpHsMon NMS Communications 265 Demonstration programs NMS SNMP Reference Manual The following example shows running snmpHsMon 266 NMS Communications NMS SNMP Reference Manual Demonstration programs snmpTrunkLog Purpose Shows the status of digital trunks of each board in a chassis Usage snmpTrunkLog address options Use the following parameters Paramete Description r address The address or DNS name of a local or remote host running an SNMP agent about which to return information
101. except that one starts with dsx1Current and the other starts with dsx1Total For example dsx1CurrentESs matches dsx1TotalESs Refer to Current table for descriptions of the Total table variables Trunk MIB Trap group The Trunk MIB Trap group has one object dsx1LineStatusChange that determines whether a trap is sent when the status of the interface changes NMS Communications 95 Trunk MIB NMS SNMP Reference Manual Using the Trunk MIB object reference The following sections describe the objects in this MIB A typical object description includes Syntax The datatype of the object is shown SNMP data types include Integer 16 bit signed DisplayString ASCII text Gauge Positive integer from 0 to 4294967295 2 1 Object Another object type from this MIB TimeStamp Positive integer from 0 to 4294967295 2 1 TruthValue Integer value where 1 is True and 2 is False Access The type of access allowed for this object Options are Read only This object can not be modified by SNMP Read write SNMP can configure this object OID The OID defines the path from the root to this object All OIDs start with p where p is is 1 3 6 1 4 1 2628 2 2 the OID for the Chassis MIB Details Describes the object Configuration Describes how to configure the object Example Shows an example of how the object is used The source from which the NMS MIBs was compiled is supplied wit
102. figuration Not applicable 86 NMS Communications NMS SNMP Reference Manual Chassis MIB slotStatus Indicates the Hot Swap status from the Hot Swap state machine Syntax Integer Access Read only OID p 3 1 1 4 n m where n is the index of this segment in the Bus Segment table and m is the index of the slot in this segment Details Acceptable values are Value Status Online OnLine Pending The board coming online is in progress Failed Offline Pending Waiting for activity to stop which can be time consuming 1 2 3 4 Offline The board is turned off and can be extracted 5 6 Extracted For Natural Access 3 x acceptable values are Value State Description 1 PO Board is not present in the slot 2 so Board is present but not configured for Hot Swap 3 s1 Hot Swap device instance is not started 4 S1F The Hot Swap device instance failed to start 5 S1l The Hot Swap device instance is started but the board is not prepared for use insertion is in progress 6 S1B Board is being prepared insertion is in progress 7 S1BF Board preparation failed 8 S2 Board is ready 9 S2R Extraction in progress Configuration Not applicable NMS Communications 87 Chassis MIB NMS SNMP Reference Manual slotTable Starts a sequence of slotEntry objects that make up the Board Access table Syntax Object
103. flects the combined values of the Base Min Max and Choices qualifiers for the keyword in the NMS OAM database Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Extended Management Component table is populated refer to the OAM MIB EMC table 214 NMS Communications NMS SNMP Reference Manual OAM Database MIB emckwDescription Provides a short description of the EMC keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 3 1 1 8 n Details emckwDescription is equivalent to the value of the Description qualifier for the keyword in the NMS OAM database If no description is given emckwDescription contains lt none gt Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Extended Management Component table is populated refer to the OAM MIB EMC table NMS Communications 215 OAM Database MIB NMS SNMP Reference Manual emcKwl ndex Indicates the keyword s index Syntax Integer Access Read only OID p 3 1 1 2 n Details Keywords are numbered sequentially starting at 1 Configuration This value is determined when the OAM Database SNMP agent populates the Extended Management Component table as described in the OAM MIB EMC table 216 NMS Communications NMS
104. ge boards in the chassis The Chassis MIB detects the presence of each board and monitors its operational status Software Tracks the versions of all NMS software installed in a Proprietary OAM package Revision chassis The MIB tracks each NMS package the files in each package and service packs and patches applied to each package The Software Revision MIB is modified whenever packages service packs or patches are installed or removed OAM Represents the contents of the NMS OAM database Proprietary OAM package Database board board plug in and Extended Management Component EMC settings The contents of the NMS OAM database can be modified via this MIB RTP Allows monitoring of the managed objects of the RTP RFC 2959 Fusion package system configuration is not allowed Displays only RTP session parameters and statistics using the NMS MSPP service This subagent does not allow row creation or parameter modification For more information about the RTP MIB refer to the Fusion Developer s Manual NMS has been assigned a namespace under the Enterprises MIB The OID for the NMS MIB is 1 3 6 1 4 1 2628 under which the Chassis MIB Software Revision MIB and OAM Database MIB reside and future private MIBs will be created 16 NMS Communications NMS SNMP Reference Manual Overview of NMS SNMP In the following illustration the SNMP subagents are shown with their major tables The MIBs that are curren
105. ge sent OAMEVN_TRACE eventname name objectname message message message is the alert message sent OAMEVN_RENAMED eventname oldname oldname newname newname oldname is the original name of the board newname is the new name of the board NMS Communications 257 Using the NMS OAM database MIB NMS SNMP Reference Manual You can mask the alerts received by SNMP either as traps or by querying the MIB by setting oamEventMask The following are valid mask values Mask Value Description TRAP_MASK_OAMEVN_ALERT 0x1 An OAM alert has been generated TRAP_MASK_OAMEVN_REPORT 0x2 Special internal code used to log report info TRAP_MASK_OAMEVN_CREATED 0x4 Object was created TRAP_MASK_OAMEVN_DELETED 0x8 Object was deleted TRAP_MASK_OAMEVN_RENAMED 0x10 Object was renamed text new name TRAP_MASK_OAMEVN_TRACE 0x20 Indicates trace info potentially high speed TRAP_MASK_OAMEVN_MODIFIED 0x40 Object was modified closed after write access TRAP_MASK_OAMEVN_BOARD_DEAD 0x80 A board has failed TRAP_MASK_OAMEVN_STARTBOARD_DONE 0x100 A board was successfully started TRAP_MASK_OAMEVN_STOPBOARD_DONE 0x200 A board was successfully stopped TRAP_MASK_OAMEVN_TESTBOARD_DONE 0x400 A board test was successfully initiated TRAP_MASK_HSWEVN_REMOVAL_REQUESTED 0x800 A board extraction has begun or board extraction was initiated in software TRAP_MASK_HSWEVN_BOARD_OFFLI NE 0x1000 A board has gone off l
106. gies that reduce the complexity and costs of enterprise management WBEM provides a point of integration through which data from management sources can be accessed and it complements and extends existing management protocols and instrumentation such as Simple Network Management Protocol SNMP Desktop Management Interface DMI and Common Management Information Protocol CMIP The Microsoft Windows Management Instrumentation WMI technology is the Microsoft implementation of the WBEM initiative The Windows Management Instrumentation WMI technology is a management infrastructure that supports the syntax of CIM the Managed Object Format MOF and a common programming interface The MOF syntax defines the structure and contents of the CIM schema in human and machine readable form Windows Management Instrumentation offers a powerful set of services including query based information retrieval and event notification These services and the management data are accessed through a Component Object Model COM programming interface The WMI scripting interface also provides scripting support When running Windows 2000 installed with SNMP and WMI services SNMP data can be accessed as WBEM data through WMI mechanisms The WMI SNMP provider optionally installed performs the link between SNMP and WMI The Microsoft SNMP provider comes with additional MIB and MOF files reflecting the standard RFC NMS SNMP includes demonstration programs that show how
107. gs matches the pkgl ndex value for the package in the Package Entry table filel ndex Unique identifier for the file fileName Path and filename of the file fileVersion Base version of the file Patch table The Patch table contains a Patch Entry table This table contains a list of all service packs or patches applied to each package For each patch or service pack the table contains the e Index of the package to which the the service pack or patch was applied e D ofthe service pack or patch The File table is represented in the MIB by the object patchAccess The objects in the Patch table are Object Description patchTable Patch Entry table The objects in the Patch Entry table are Object Description patchEntry Top of the table patchPkglndex Index of the package to which the patch was applied matches the pkgl ndex value for the package in the Package Entry table patchI ndex Unique identifier for the patch patchI D ID of the patch NMS Communications 141 Software revision MIB NMS SNMP Reference Manual Software Revision MIB object reference Using the Software revision MIB object reference The following sections describe the objects in this MIB A typical object description includes Syntax The datatype of the object is shown SNMP data types include Integer 16 bit signed DisplayString ASCII text
108. guration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Supervisor Keyword table is populated refer to the OAM supervisor tables NMS Communications 221 OAM Database MIB NMS SNMP Reference Manual kwAllowedRange Indicates the range of allowed values for the Supervisor keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 1 4 1 6 n Details If the keyword type is Integer and is a yes no choice kwAllowedRange contains a string of this format Nb values 2 Yes No If the keyword type is Integer and can take a range of values kwAllowedRange contains a string of this format BASE base min_value lt gt max_value where e base is a mathematical base of the integer for example 16 for a hexadecimal number e min_value is the minimum allowed value e max_value is the maximum allowed value For example BASE 0 lt GH535 If the keyword type is String kwAllowedRange contains all the allowed strings for this keyword separated by commas For example YES NO If any string is acceptable this field contains lt no range gt If the keyword type is Object no possible values are given kwAllowedRange reflects the combined values of the Base Min Max and Choices qualifiers for the keyword in the NMS OAM database Configuration When it starts up the OAM Database SNMP agent popul
109. h the software in ASN1 format text files These files can be found in nms ctaccess doc opt nms ctaccess doc under UNIX NMS SNMP MIBs were compiled using the following files e Chassis MIB chassis mib txt e Trunk MIB chassis mib txt e Software Revision MIB softrev mib txt e OAM Database MIB oamdatabase mib txt Read the appropriate file using the Windows Console Management function to display the SNMP information for the proprietary agent 96 NMS Communications NMS SNMP Reference Manual dsx1Channelization Indicates whether this DS1 E1 is channelized or not Syntax Integer Access Read write OID p 6 1 20 n where n the index number of the DS1 interface Details Possible values are Value Description 1 disabled 2 enabledDsO 3 enabledDs1 Note The NMS SNMP agent always returns enabledDsO because NMS boards are always channelized Configuration Not applicable NMS Communications Trunk MIB 97 Trunk MIB dsx1Circuitl dentifier Provides the circuit identifier Syntax DisplayString SIZE 0 255 Access Read write OID p 6 1 8 n where n the index number of the DS1 interface Details The circuit identifier is represented by name of board_board number_trunk number where name of board is one of the following Board type Value AG AG_Dual_El AG_Dual_T1 AG_Quad_El AG_Quad_T1 AG_Quad_Connect_El AG_Quad_Connec
110. he current state of the loopback on the DS1 interface dsx1Ds1ChannelNumber Integer Represents the channel number of the DS1 E1 on its parent DS2 E2 or DS3 E3 dsx1Channelization Integer Indicates whether this DS1 E1 is channelized or not NMS Communications 93 Trunk MIB Trunk MIB Interval table NMS SNMP Reference Manual Most of the variables in the Interval table have descriptions that match a variable with a name similar to one in the Current table For example dsx1IntervalESs in the Interval table matches dsx1CurrentESs in the Current table Both these variables contain the number of errored seconds for a 15 minute interval The following table shows the matching variables from the two tables Current table Interval table dsx1Currentl ndex dsx1I ntervall ndex dsx1CurrentESs dsx1I ntervalESs dsx1CurrentSESs dsx1I ntervalSESs dsx1CurrentSEFSs dsx1I ntervalSEFSs dsx1CurrentUASs dsx1I ntervalUSASs dsx1CurrentCSSs dsx1I ntervalCSSs dsx1CurrentPCVs dsx1I ntervalPCVs dsx1CurrentLESs dsx1I ntervalLESs dsx1CurrentBESs dsx1I ntervalBESs dsx1CurrentDMs dsx1I ntervalIDMs dsx1CurrentLCVs dsx1I ntervalLCVs dsx1 IntervalNumber dsx1I ntervalValidData The Interval table is a doubly indexed table For information about accessing a doubly indexed table see Accessing MIB objects There are two variables that do not match entries in the Current table
111. he following table summarizes each object in as the dsx1ConfigEntry block of variables the Trunk MIB Configuration table otherwise known Object Type Description dsx1Linel ndex Integer Identifies a DS1 interface in this managed node dsx11 fl ndex Integer Same as dsx1Linel ndex dsx1TimeElapsed Integer Time of current measurement period dsx1Validl ntervals Integer Number of 15 minute measured intervals dsx1LineType Integer Type of DS1 interface dsx1LineCoding Integer Type of Zero Code Suppression for this interface dsx1SendCode Integer Type of code in the interface dsx1Circuitl dentifier DisplayString Transmission vendor s circuit identifier dsx1LoopbackConfig Integer Loopback configuration dsx1LineStatus Integer Interface status dsx1SignalMode Integer Circuit s signal mode dsx1TransmitClockSource Integer Source of the transmit clock dsx1Fdl Integer Describes the facilities data link dsx1Invalidl ntervals Integer Indicates the number of intervals with invalid data which will always be O not supported dsx1LineLength Integer Indicates the length of the DS1 line in meters which will always be O not supported dsx1StatusLastChange TimeStamp Indicates the time when the status of the interface last changed dsx1LineStatusChangeTrapEnable Integer Determines whether traps should be generated for this interface dsx1LoopbackStatus Integer Represents t
112. iCurrentTable 7 dsxiCurrentEntry dsx1Currentindex dsx1CurrentESs dsx1CurrentSESs dsx1CurrentSEFSs dsx1CurrentUASs dsx1CurrentCSSs dsx1CurrentPCVs dsx1CurrentLESs dsx1CurrentBESs dsx1CurrentDMs dsx1CurrentLCVs EdsiTraps dsxiLineStatusChange RFC 2495 MIB tree NMS Communications dsxiIntervalTable 8 dsxilntervalEntry dsx1Intervalindex dsx1IntervalNumber dsx1IntervalESs dsx1IntervalSESs dsxiIntervalSEFSs dsx1IntervalUASs dsx1lIntervalCSSs dsxiIntervalPCVs dsxiIntervalLESs dsxiIntervalBESs dsx1IntervalDMs dsxlIntervalLCVs dsx1IntervalValidData dsxiTotalTable 9 dsx1TotalEntry dsx1Totallndex dsx1TotalESs dsx1TotalSESs dsx1TotalSEFSs dsx1TotalUASs dsx1TotalCSSs dsx1TotalPCVs dsx1TotalLESs dsx1TotalBESs dsx1TotalDMs dsx1TotalLCVs Trunk MIB 91 Trunk MIB NMS SNMP Reference Manual Trunk MIB node tables The Trunk MIB includes the following node tables e Configuration table e Interval table e Current table e Total table e Trap group The source from which the NMS MIBs was compiled is supplied with the software in ASN1 format text files These files can be found in nms ctaccess doc opt nms ctaccess doc under UNIX The Trunk MIB was compiled from trunk mib txt Read this file using the Windows Console Management function to display the SNMP information for this proprietary agent 92 NMS Communications NMS SNMP Reference Manual Trunk MIB Trunk MIB Configuration table T
113. ica 94 Tr nk MI B C rrent table nn Pit A A AA E ET aaa an tah tat dee 94 Trunk MIB Total Ta le oa 95 RUN K MIB Trap FOU Dicc Abs 95 Using the Trunk MIB object reference ooooccccccccnccncnccnnnccnnnccnnnncnnnncnnnncnannrnnnnrnrnnncrnnnnenannenaness 96 ASIAN oia 97 dsx1CircCuitldentifier oooocccccnccccnnncncnnnnncnnnnn nn a aE a ae E aa raras 98 oo AE OTAN Ke N RE ol EAEE EATE teo cto A ATT 100 dsX1ConfigEntry ieres eed ee E de ed Se ed ee ee i dies ee 101 ASX TL CURFEREB ESS taria antic i oh 102 GSXECUPFENEGS Saad A A ah de ladera da lia 103 4 NMS Communications NMS SNMP Reference Manual Table of Contents asxiCUrrentDM Sra A A A ne 104 ASXTCUFFENEER ERY ES EA Ad 105 ASXTICUFTENtES Sat A AS 106 ASX EGU PREM EMS ise A ashi dela cate nate ne te ea eae A T E eee Gal and ee edna Seaton 107 ASX T CUPFENELEV SA Nos 108 dsx1CUSrrentLESS 0 0 cece ccc cece e eee ee cece ee ee cease eeeeeeeueeeeeuugeeeeegeeeeueeeeegeeeeegaeeeugunetuuaneeugaes 109 ASX C r ent CV Sr ache Setter a tic atts A caida eae ocala WA AR eat Na ea a ea ae eT a es 110 SX CUPrEMES EES Size cei e o 111 CSXT CUE RMES ESS ninia da ea it rta 112 ASX CU rental A AA A AA A a 113 ASX TE CURFENCWASS AS 114 ASX EDS LE Mame NUMA BSR tii A AAA a E a 115 C6 co AN it A NTN ORSON CORON E E RTC once oe T 116 a ONO 117 ASXLINterva NU Mb iia tbn 118 dsx1IntervalValidData cda 119 CA ANN 120 ASXLLINC NA A is 121 ASXLEINECOGINO mece a a late a din do 122 ASX LLINGLEMGEN
114. ication the higher layer must provide data which meets or exceeds the pulse density requirements such as inverting HDLC data other 6 Unlisted default Configuration This object is configured by editing the system configuration file before starting the Chassis MIB agent 122 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx1LineLength Indicates the length of the DS1 line in meters which will always be o not supported Syntax Integer Access Read write OID p 6 1 15 n where n the index number of the DS1 interface Configuration Not applicable NMS Communications 123 Trunk MIB dsxlLineStatus Indicates the status of the interface Syntax Integer 1 8191 Access Read only OID p 6 1 10 n where n the index number of the DS1 interface Details NMS SNMP Reference Manual This value provides loopback failure received alarm and transmitted alarm information Possible status values include Status Value Description dsx1NoAlarm 1 No Alarm Present dsx1RcvFarEndLOF 2 Yellow Alarm Not supported dsx1XmtFarEndLOF 4 Near end sending LOF Indication Not supported dsx1RcvAlS 8 Far end sending AIS blue Not supported dsx1XmtAlS 16 Near end sending AIS dsx1LossOfFrame 32 Near end LOF Red Alarm dsx1LossOfSignal 64 Near end Loss Of Signal dsx1LoopbackState 128 Near end is looped dsx1T16AIS 256 El TS16 AIS dsx1Rcv
115. ies 1 Timeout 100ms gt ENMS SANO r iR Orel SS AZ ZO gt Current Value 2 gt Value Type is Integer gt Value The program asks for new value In this example enter 1 to enable traps lt Value 1 gt Set Status Success 262 NMS Communications NMS SNMP Reference Manual Demonstration programs snmpChassScan Purpose Demonstrates how to navigate the chassis MIB how to retrieve chassis type and description and how to navigate by bus recognize ISA and PCI boards and show board description and status information Usage snmpChassScan address options Use the following parameter Paramete Description r address The address or DNS name of a local or remote host running an SNMP agent about which to return information Valid options include Option Description ccommunity_name Specify a community name The default is public rn Number of retries The default is 1 retry tn Timeout in hundredths of a second The default is 100 1 second Polling is set interactively by the application See the example in the Procedure section below Procedure To run nmsChassScan 1 From the command line navigate to the nms ctaccess demos snmp snmpchassscan directory or the opt nms ctaccess demos snmp snmpchassscan directory under UNIX 2 Enter the following nmsChassScan NMS Communications 263 Demonstration programs NMS SNMP Reference Manual The following
116. iguration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Keyword table is populated see OAM Boards table NMS Communications 203 OAM Database MIB brdkwValue Indicate the board keyword value Syntax DisplayString SIZE 0 255 Access Read write OID p 4 3 1 4 n Configuration NMS SNMP Reference Manual When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Keyword table is populated see OAM Boards table 204 NMS Communications NMS SNMP Reference Manual OAM Database MIB brdName Syntax DisplayString SIZE 0 255 Access Read write OID p 4 4 1 2 n Details Sets or determines the name of the board For more information refer to Querying and setting the board name and number Configuration Not applicable NMS Communications 205 OAM Database MIB NMS SNMP Reference Manual brdNumber Sets or determines the board number of the board Syntax Integer Access Read write OID p 4 4 1 3 n Details For more information refer to Querying and setting the board name and number Configuration Not applicable 206 NMS Communications NMS SNMP Reference Manual OAM Database MIB brdStartStop Starts or stops a board or indicates whether it is started or
117. ii A da 123 dsxtLineStatuS snme ranen Ae ain a a e ia ach annrednetetnelincnaatersclb 124 dsxLEMestatus CONDE A isi dei a r E di A a 125 ASXLLiN TY a YEE eee ee 126 dsxlLineStatusChangeTrapEnable ooococcccccccccncoccnnnccnnnccnnnccnnnccnnnccnnnnnnncnnnnrnnnnrnnnnrnannrnnnnnn 127 dsx1Lo0pbackC ONO asin A 128 AsSxLLO00pbackStatUS ui id 129 ASILO AC Olea a A a In a de dase O E 130 dasxiSignalMode ct di onda 131 dsx1StatuslLastChanGe ii e dd il 132 dsxITiIMeElaPSO dicos ep A atea 133 dsx1TRaNSMIEETOCKSOUTCE ii iia 134 ASMA a o 135 SoftWare revision MI B mai ai 137 Software Revision MIB representation ooococcoccoccocconnonnonnonnnoncnncnncnncnncnnrnnrnnrnrnnrnnrnnrnnrnaranos 137 Software revision MIB STrUCTUTO ooooccccccccnccnnnnnnnnnnnannnnnn non nara n nn anna nr nn nn nn aran nn rn rnnn nano 137 Software Revision MIB Package table oooooccocccccocconnccnonncnncnncnncnncnnnconcnncnnrnnnnnnnnnnrnnranrnnnnns 140 Ale tableta NE Need 141 ANLE IAEN I EE a denna Gea A A A A E N daa 141 Software Revision MIB object reference 0 cece eee eee erent eee terete neta eee 142 Using the Software revision MIB object reference cece cece eee eee eee eee e neta e nena na eee 142 IGP tesa eh e rie 143 TIVE ANC CESS iaa EE 144 HESCOUNAC LA AE ek aren AAA aha at hd tae atten aha AD saree Ea 145 file Entry cireni ee eee tes A ee ee ene a ode oe ke E aa a 146 PAV SV NLS Xt a ld id 147 TETRA raat a a A A ee aa a aha A aah doe aah hae 148
118. ill be detected if configured Refer to the Natural Access installation booklet and to the NMS OAM System User s Manual for more information about starting Natural Access and the NMS OAM service NMS Communications Chassis MIB Chassis MIB representation The Chassis MIB represents the boards installed in an NMS chassis Boards and lines trunks are numbered sequentially and are assigned to tables The Chassis agent detects each NMS board that has both been registered to NMS OAM and has booted correctly and monitors its operational status The board model type revision bus segment and slot and logical ID are represented Removing or inserting a board Hot Swap is also monitored and traps are sent if the status of a board changes Using the Chassis MIB This section describes how to use the values in the Chassis MIB and provides other information common to more than one table Traps Traps can be enabled to report a change in board status The boardStatusChangeTrapEnable object in the Board table can be set to enable or disable traps Traps must also be configured See Installation summary for more information about configuring traps Hot Swap Extracting a board causes the entry for that board in the Board table to be removed If all the boards in a bus segment are extracted that bus segment entry will be removed from the Bus Segment table If the removed entry creates a non contiguous numerical sequence that number w
119. ill be used the next time a board is inserted and recognized by the agent The Hot Swap software sees an inserted board before the agent has access to it Note Hot Swap works only with the CompactPCI bus The Hot Swap functionality described above is available only if the Hot Swap Manager is running For more information on running the Hot Swap Manager refer to the NMS OAM System User s Manual If using Natural Access 3 x refer to the Hot Swap Developer s Manual Board status Board status differs depending on which version of Natural Access you are using e When using Natural Access 3 x two board status objects are used boardStatus in the Board table and slotStatus in the Board Access by slot table boardStatus provides a simple online offline or pending message and slotStatus gives a finer grain value the Hot Swap state For more information about Hot Swap states see the Hot Swap Developer s Manual e In Natural Access 4 0 or later boardStatus and slotStatus are identical and their functionality is equivalent to that of slotStatus under CT Access 3 x The two objects tie together by an index value boardl ndex in the Board table matches the slotBoardl ndex in the Board Access by slot table NMS Communications 39 Chassis MIB NMS SNMP Reference Manual Linking to the trunk MIB dsx1Circuitl dentifier in the Trunk MIB RFC 2495 contains the name of the board that the line is on as well as a board number and trunk n
120. ine TRAP_MASK_HSWEVN_BOARD_REMOVED 0x2000 A board has been removed TRAP_MASK_HSWEVN_BOARD_INSERTED 0x4000 A board has been inserted TRAP_MASK_HSWEVN_ONLINE_PENDING 0x8000 A board has been inserted and is about to go online TRAP_MASK_HSWEVN_PCI_CONFIG_ FAILED 0x10000 A PCI configuration attempt failed TRAP_MASK_HSWEVN_PREPARATION_FAILED 0x20000 Preparation for board removal failed TRAP_MASK_HSWEVN_BOARD_READY 0x40000 A board is ready By default no masks are set For more information about NMS OAM events refer to your NMS OAM Service Developer s Reference Manual 258 NMS Communications Demonstration programs Using SNMP demonstration programs The demonstration programs show how you can use the information in the NMS MIBs to provide useful information to a network administrator and how to get and set SNMP variables All demonstration programs are run by executing the program from the command line Each demonstration program resides in its own directory under nms ctaccess demos snmp or the opt nms ctaccess demos snmp directory under UNIX along with the source code and makefile The following demonstration programs are provided Program Description snmpget Retrieves information about the SNMP master agent on the specified host snmpnext Gets the value of the next SNMP variable snmpset Sets the value of the current SNMP variable snmpChassScan Navigates the NmsChassis MIB and displays inf
121. information from the NMS OAM database NMS Communications 183 OAM Database MIB NMS SNMP Reference Manual boardManagementTable Provides a table that allows management of boards through the OAM Database MIB Syntax Object Access Not accessible OID p 4 4 Details The objects in the Board Management table are Object Description boardManagementEntry Top of the table boardManagementindex Index of the board to manage matches the boardi ndex of the board in the Board Keywords table brdName Queries or changes the name of the board brdNumber Queries or changes the board number brdStartStop Starts or stops the board or indicates its status brdTest Tests the board or indicates the testing status brdDelete Deletes the board instance from the NMS OAM database Configuration Not applicable 184 NMS Communications NMS SNMP Reference Manual boardName Indicates the name to give the created board Syntax DisplayString SIZE 0 255 Access Read write OID p 1 5 2 Details For more information see Creating and deleting board managed objects Configuration Configured by the user as necessary NMS Communications OAM Database MIB 185 OAM Database MIB NMS SNMP Reference Manual boardNumber Specifies a number to give the created board Syntax Integer Access Read write OID p 1 5 3 Details For more information see Creating a
122. iption A short description of the keyword Configuration Not applicable 228 NMS Communications NMS SNMP Reference Manual oamBoards Starts the OAM Boards table Syntax Object Access Not accessible OID p 4 Details This entry contains e The number of boards automatically detected in the system e The total number of boards registered to NMS OAM e A table of boards each with their keywords values and qualifiers OAM Database MIB e Values that allow you to start or stop a board test a board delete a board instance from the database change a board s name or number or query its status The objects in the OAM Boards table are Object Description detectedBoardCount Number of boards automatically detected in the system createdBoardCount Total number of boards registered to NMS OAM boardTable Board Keyword table containing a list of boards each with their keywords values and qualifiers boardManagementTable Board Management table containing values that allow you to start stop test or delete a board change a board s name or number or query its status Configuration Not applicable NMS Communications 229 OAM Database MIB NMS SNMP Reference Manual oamCreateBoard Starts the Create Board table containing values that allow you to create board instances in the database Syntax Object Access Not accessible OID p 1 5 Details The obj
123. k on the Security tab in this dialog box NMS Communications 271 WBEM support under windows NMS SNMP Reference Manual To access the WMI Control dialog box in Windows 2000 1 Click Start gt Programs gt Administrative Tools gt WMI Config Manager The WMI Control Properties dialog box appears 2 Click on the Security tab in this dialog box You can also check namespaces using the CIM studio in the WBEM SDK if installed Installing NMS MOF files in the WBEM repository The following MOF files can be found in the nms ctaccess demos snmp wbem directory Filename Description nmsChassis mof MOF file of the Chassis MIB nmsTrunk mof MOF file of the Trunk MIB nmsOamDatabase mof MOF file of the OAM Database MIB nmsSoftRev mof MOF file of the Software Revision MIB nmsRtp mof MOF file of the RTP MIB Installed with the Fusion package If the namespaces are properly created SNMP related MOF files can be added into the CIMOM repository To do so 1 Open an MS DOS console 2 Navigate to the directory nms ctaccess demos snmp wbem 3 Enter the following for each MOF file mofcomp mof_filename where mof_filename is the name of the MOF file associated with the component to start mofcomp responds with information similar to the following Parsing MOF file nmsChassis mof MOF file has been successfully parsed Storing data in the repository Done To view the contents of the rep
124. kwDescription contains lt none gt Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Keyword table is populated see OAM Boards table NMS Communications 201 OAM Database MIB NMS SNMP Reference Manual brdkw Mode Indicates if the board keyword is read only or read write Syntax Integer readOnly 1 readWrite 2 Access Read only OID p 4 3 1 6 n Details brdkwMode reflects the value of the keyword s ReadOnly qualifier in the NMS OAM database Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Keyword table is populated see OAM Boards table 202 NMS Communications NMS SNMP Reference Manual brdkwType Indicates the type of the board keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 4 3 1 5 n Details Valid types include Type Description Integer An integer String A string of 0 or more characters OAM Database MIB brdkwType is equivalent to the value of the Type qualifier for the keyword in the NMS OAM database Keywords of other types for example Array Struct StructAndArray are not included as separate entries in MIB tables For more information see Keywords in the OAM database MIB Conf
125. le 4 To make your changes effective restart the master agent the NMS multiplexer and subagents edit this file as follows For more information on the snmp cfg file see Configuring NMS SNMP NMS Communications Activating SNMP 37 Activating SNMP NMS SNMP Reference Manual Running NMS SNMP Once NMS SNMP is installed in order for the software to operate All Natural Access environment variables must be properly set To learn about Natural Access environment variables refer to the Natural Access Developer s Reference Manual The DTM service must be specified in the cta cfg file By default this service is specified in the file Refer to the Natural Access Developer s Reference Manual for more information about cta cfg Refer to the T1 E1 Digital Trunk Monitor Service Developer s Reference Manual for information about DTM The Natural Access server ctdaemon must be running The NMS SNMP agents will not recognize any boards unless ctdaemon is running in order to activate the NMS OAM database Also the agents will not report any data to SNMP requests To verify that ctdaemon is running 1 Access a command prompt 2 Enter the ps command as follows ps A grep ctdaemon This command produces output similar to the following 1028 TS 85 pts 3 0 00 ctdaemon Note The SNMP subagents continue to work whether or not ctdaemon is running If you restart 38 ctdaemon while a subagent is running boards w
126. lete a board configuration from the database oamOtherObjects Contains a table allowing access to the configuration data for other managed objects if any oamEventsTraps Allows you to examine incoming NMS OAM events The following illustration illustrates the relationship between the NMS OAM database and SNMP MIBs Boards EMC Hot Swap EMC Clock Management SNMP OAM Database MIB Configuration Database NMS OAM Managed Object Managed Object Board Plug In Managed Object Clock Management EMC Managed Object y NMS OAM Supervisor Managed Object NMS OAM database and SNMP MIB tables NMS Communications 167 OAM Database MIB Keywords in the OAM database MIB Configuration data in both the NMS OAM database and the OAM database MIB is expressed as keyword name value pairs for example AutoStart YES Keywords and values can be queried added modified or deleted Modifying a keyword in the MIB modifies the keyword in the NMS OAM database and vice versa NMS SNMP Reference Manual Each keyword has several attributes called qualifiers For example the qualifier Type indicates the type of value it accepts Integer String etc The qualifier ReadOnly indicates if a keyword is read only Within the OAM database MIB qualifier information for each keyword is stored with the keyword The following t
127. luded on the Natural Access CD ROM Installing the NMS OAM package from a Natural Access CD ROM installs the NMS SNMP subagents For information about installing Natural Access refer to the installation booklet included with the CD ROM For further information on NMS OAM refer to the NMS OAM System User s Manual When you have installed the NMS subagents and multiplexer modify the P UDP port used by the SNMP master agent as described in Modifying the master agent IP UDP port Modifying the Windows registry Windows only Under Windows 2000 Natural Access automatically registers all installed components in the registry When Natural Access is uninstalled the components are automatically removed from the registry You can manually add or remove components from the registry To do so access a command prompt and enter the following command component_name directive where component_name is the name of the component to add component_name can be any of the following Value Description mux NMS multiplexer chassisAgent Chassis MIB agent ds1Agent Trunk MIB agent oamAgent OAM Database MIB agent softRevAgent Software Revision MIB agent rtpAgent RTP MIB agent installed with Fusion package directive indicates whether to install or remove the component directive can be either of the following Option Description 1 Install the component U Uninstall the component
128. mon exe agtrace exe and ctdaemon exe are part of the Natural Access 3 1 package pkgl ndex 1 Since the package was installed agtrace exe has been modified by Patch 2112 and ctdaemon exe has been modified by Patch 3671 In the Patch Table each installed service pack and patch is listed by the pkgl ndex of the package it modified Each patch is assigned a unique patch index patchl ndex In the following illustration the Natural Access 3 1 package pkgl ndex 1 has been modified twice by Patch 2112 and Patch 3671 138 NMS Communications NMS SNMP Reference Manual Software revision MIB The sequence of objects in the Software Revision MIB with relative OIDs for table objects is shown in the following illustration softRev packageAccess dirPath pkgCount pkgTable 3 pkgEntry pkgindex pkgName pkgVersion filesCount A fileAccess fileTable 1 A fileEntry filePkgIndex fileIndex fileName fileVersion patchAccess patchTable 1 patchEntry patchPkgIndex patchIndex patchID Software revision MIB objects NMS Communications 139 Software revision MIB Software Revision MIB Package table The Package table contains the following information e The name of the directory where NMS packages are installed e The total number of installed packages NMS SNMP Reference Manual e A Package Entry table containing information about each installed package including the name of the package the base v
129. more than seven contiguous zeroes are detected Configuration Not applicable 108 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx1CurrentLESs Syntax Gauge Access Read only OID p 7 1 8 n where n the index number of the DS1 interface Details Number of Line Errored Seconds A Line Errored Second according to T1M1 3 is a second in which one or more Line Code Violation error events were detected Configuration Not applicable NMS Communications 109 Trunk MIB NMS SNMP Reference Manual dsx1CurrentPCVs Indicates the number of Path Coding Violations Syntax Gauge Access Read only OID p 7 1 7 n where n the index number of the DS1 interface Details A Path Coding Violation error event is a frame synchronization bit error in the D4 and El noCRC formats or a CRC or frame synch bit error in the ESF and E1 CRC formats Also known as CV P see ANSI T1 231 Section 6 5 2 1 Configuration Not applicable 110 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx1CurrentSEFSs Indicates the number of Severely Errored Framing Seconds Syntax Gauge Access Read only OID p 7 1 4 n where n the index number of the DS1 interface Details A Severely Errored Framing Second is a second with one or more Out of Frame defects or a detected AIS defect Configuration Not applicable NMS Communications 111 Trunk MIB NMS SNMP Reference Manual dsx1Cu
130. n MIB NmsTrunk mib Trunk MIB DS1 NmsRtp mib RTP MIB installed by Fusion package These text files require other MIB description files documented in RFCs such as SNMPv2 TC SNMPv2 CONF SYSAPPL MIB etc These files can be easily found on the web The NMS Communications hierarchy shown in the following illustration is defined in the NMS SMI MIB 18 NMS Communications NMS SNMP Reference Manual Overview of NMS SNMP NMS SNMP architecture NMS SNMP consists of the following components e The NMS multiplexer mux e NMS subagents for each MIB As shown in the following illustration the NMS multiplexer is located between the native SNMP master agent and the UDP port to the external network The native master agent is reconfigured to communicate with the NMS multiplexer instead of the external network The NMS multiplexer communicates with the NMS subagents one for each MIB UDP Ports UDP Port NMS Subagents The NMS multiplexer handles all requests coming from the UDP network port and communicates with the NMS subagents as needed SNMP requests not addressed to the NMS multiplexer are routed to the native master agent Each NMS subagent runs in a different process and exchanges information with the multiplexer using a UDP socket connection The NMS multiplexer is thus connected to three different P UDP ports e SNMP network port default value 161 e Communication port between the SNMP master agent and the multi
131. nction to display the SNMP information for the proprietary agent NMS Communications 177 OAM Database MIB NMS SNMP Reference Manual applyBoardCommand Set this value to 1 to create a new board managed object in the NMS OAM database based on the productName boardName and boardNumber values you specified Syntax Integer create 1 donothing 2 Access Read write OID p 1 5 4 Details Reading this value always returns 2 For more information see Creating and deleting board managed objects Configuration Configured by the user as necessary 178 NMS Communications NMS SNMP Reference Manual OAM Database MIB boardEntry Starts a row in the OAM Boards table boardTable Syntax Object Access Not accessible OID p 4 3 1 Details Each row in the OAM Boards table contains information about a board keyword Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Keyword table is populated refer to the OAM Boards table NMS Communications 179 OAM Database MIB NMS SNMP Reference Manual boardi ndex Indicates the board managed object to which the keyword belongs Syntax Integer Access Read only OID p 4 3 1 1 n Details This keyword s maps to the index value of the Supervisor keyword Boards x listing the board in the NMS OAM database For example if Boards 1 My
132. nd deleting board managed objects Configuration Configured by the user as necessary 186 NMS Communications NMS SNMP Reference Manual OAM Database MIB boardPluginEntry Starts a row in the Board Plug in table boardPluginTable Syntax Object Access Not accessible OID p 2 1 1 Details Each row in the Board table contains information about a board plug in keyword Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Plug in table is populated refer to the OAM Board Plug in table NMS Communications 187 OAM Database MIB NMS SNMP Reference Manual boardPluginl ndex Indicates the board plug in to which the keyword belongs Syntax Integer Access Read only OID p 2 1 1 1 n Details This value maps to the index value of the Supervisor keyword BoardPlugins x listing the board plug in in the NMS OAM database For example if BoardPlugins 1 agplugin bpi the AG board plug in all AG board plug in keywords in the OAM Database MIB will have boardPluginI ndex equal to 1 Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Plug in table is populated refer to the OAM Board Plug in table 188 NMS Communications NMS SNMP Reference Manual OAM Database MIB b
133. never resets so the values are sums from the first time you started the DTM agent NMS Communications 89 Trunk MIB NMS SNMP Reference Manual The following illustration shows how the tables for DS1 relate dsx1Linelndex dsx1Totalindex dsx1TimeElapsed dsx1Validintervals dsxiLineType dsxiLineCoding dsxiSendCode dsx 1Circuitidentifier dsx LLoopbackConfig dsxiLineStatus ee Tdsxitotaless J Pdsxirotalsess CdsxiTotalserss PdsxitotaluaSs dsx Totaicsss LdsxiTotalPcvs Pdsxitotailess Pdsxitotalbess PdsxitotalDMs Pdsxitotalicvs dsx1TransmitClockSource asxlinvalidintervals dsx1LineLength dsx1LineStatusLastChange dsx1LineStatusChangeTrapEnable dsx1LoopbackStatus dsx1Ds1ChannelNumber dsx1Channelization a O dsx1Currentindex A A asxiCurrentESs dsxICurrentsESs DasxiCurrentseFSs Pdsxicurrentuass 195 t96 t97 dsxlIntervalESs dsx1IntervalSESs E dsx1IntervalSEFSs dsxiintervalUASs dsxiIntervalPCVs dsx1IntervalLESs mal dsx1IntervalBESs Ek dsxiIntervalDMs J dsxiintervalLCVs _ dsx1IntervalIntervalValidData dsxICurrentesss ldsxICurremtPcvs dsxiCurrentLESs TdsxicurrentBess PdsxicurrentoMs dsxicurrentLcvs_ Copy values to Interval table 2495 MIB table relationships The previous illustration shows a logical view of the tables for three DS1 interfaces The
134. no boards in the chassis There can only be one ISA bus segment but there can be more than one PCI bus segment This value determines how many entries there will be in the Bus Segment table This object is updated when a board is inserted into a slot in a previously unpopulated bus segment and is recognized by the agent or when a board is removed Configuration Not applicable NMS Communications 81 Chassis MIB chassType Indicates the chassis type Syntax Integer Access Read only OID p 2 1 Details Valid values include Value Description 1 Unknown chassis default 2 CompactPCI chassis 3 Generic PC chassis 4 Generic Sun chassis NMS SNMP Reference Manual The chassis type is specified in the snmp cfg configuration file The keyword and value are ChassisType 1 12 1314 Configuration This object is configured by editing snmp cfg before starting the NMS Chassis agent 82 NMS Communications NMS SNMP Reference Manual Chassis MIB slotBoardl ndex Provides an index into the Board table for the board in the associated bus segment and logical slot Syntax Integer Access Read only OID p 3 1 1 3 n m where n is the index of this segment in the Bus Segment table and m is the index of the slot in this segment Details This value matches boardi ndex in the Board table Configuration Not applicable NMS Communications 83 Chassis MIB NM
135. oardPluginKw ndex Indicates the keyword s index Syntax Integer Access Read only OID p 2 1 1 2 n Details Keywords are numbered sequentially starting at 1 Configuration This value is determined when the OAM Database SNMP agent populates the Board Plug in table as described in the OAM Board Plug in table NMS Communications 189 OAM Database MIB NMS SNMP Reference Manual boardPluginTable Starts a sequence of boardPluginEntry objects each of which composes a row in the Board Plug in table Syntax Object Access Not accessible OID p 2 1 Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Plug in table is populated refer to the OAM Board Plug in table 190 NMS Communications NMS SNMP Reference Manual OAM Database MIB boardTable Starts a sequence of boardEntry objects each of which composes a row in the OAM Boards table Syntax Object Access Not accessible OID p 4 3 Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Keyword table is populated refer to the OAM Boards table NMS Communications 191 OAM Database MIB bpikeywordName Specifies a board plug in keyword name Syntax DisplayString SIZE 0 255 Access Read onl
136. oardRevision boardSerialNumber boardManufDate boardStatusLastChange boardStatusChangeTrapEnable chassBackPlane 5 jchassisTraps 6 boardStatusChange Not supported in this revision Included here because it is defined in the MIB description file Chassis MIB object 42 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Chassis MIB Chassis MIB Configuration table The Chassis Configuration table contains the following information e Type of chassis e Description e Number of bus segments within the chassis Information about each bus segment such as type of bus segment description and number of occupied slots is contained within an object block that makes up the Bus Segment table The objects in this table are under the chassConfig table of the Chassis MIB Values are assigned to these objects by the NMS Chassis agent The objects in the Chassis Configuration table are Object Description chassConfig Top of the table chassType Chassis type chassDescr Description of the chassis chassSegmentBusCount Number of bus segments within the chassis Chassis MIB Bus Segment table The Bus Segment table contains information about each bus segment such as type of bus segment description and number of occupied slots There can only be one ISA bus segment but there can be many PCI or compact PCI bus segments Each busSegmentEntry object is identified by a busSegmen
137. on 211 212 213 214 215 216 217 218 219 220 retrieving software information 140 files associated with software 141 144 146 147 148 149 150 151 software packages 140 143 145 158 159 160 161 162 163 164 software patches 141 152 153 154 155 156 157 Software Revision MIB 137 140 141 RFC 1155 12 RFC 1213 12 RFC 1406 16 RFC 1573 89 RFC 2495 12 39 89 95 114 128 RFC 2945 16 RFC 2959 16 router 12 running NMS SNMP 38 S sgn files 137 278 NMS SNMP Reference Manual SNMP 19 architecture 19 configuring 30 configuring NMS SNMP 30 network management 11 object identifiers 11 overview 12 running NMS SNMP 38 sample configuration file 32 snmp cfg 19 27 30 snmpChassScan 259 263 snmpget 259 260 snmpHsMon 259 265 snmpnext 259 261 snmpset 259 262 snmpTrunkLog 259 267 snmpwalk 23 Software Revision MIB 137 File table 141 overview 16 Package table 140 Patch table 141 starting and stopping boards 256 starting SNMP 35 38 supported MIBs 16 T testing boards 256 Trap messages 12 Trunk MIB 89 Configuration table 93 Current table 94 Interval table 94 overview 16 tables and keywords 92 Total table 95 trap group 95 U UDP ports 21 27 V verifying the SNMP provider installation 271 verifying the software installation 270 Ww WBEM 269 273 WMI software 270 NMS Communications
138. one gt enumsnmp htm output NMS Communications 275 Index A agmon 137 259 agtrace 137 analyzer 12 Board keyword tables 253 board plug ins 165 bridge 12 C Chassis MIB 39 Board Access table 44 Board table 45 Bus Segment table 43 Configuration table 43 overview 16 structure 40 trap group 45 using the chassis MIB 39 CMIP 269 CompactPCI bus 39 Component Object Model COM 269 configuring NMS SNMP 30 32 controlling the OAM Supervisor 171 178 185 186 221 222 223 224 225 226 227 230 233 236 248 249 250 251 cta cfg file 38 ctdaemon 38 137 259 D demonstration programs 259 260 261 262 263 265 267 DNS 261 262 263 265 267 DS1 interfaces 16 89 93 94 EMC keywords 253 enumsnmp htm 273 enumsnmp js 273 extended management components EMCs 16 165 174 G get 15 get next 15 H H 100 165 H 110 165 NMS Communications Hot Swap 39 hub 12 installation 21 23 24 26 270 272 ISA boards 43 L Linux 23 27 M managed components 12 managed networks 12 managed nodes 12 management protocols 11 management stations 12 master agent 23 24 27 MI Bs 11 15 MOF files 273 monitoring boards 39 77 78 81 82 board description and status 45 47 48 49 50 51 52 53 54 55 56 57 59 60 61 62 63 64 65 66 73 75 76 bus segment 43 67 68 69 70 71 72 chassis information 43 77 78 81
139. opulates all MIB tables based upon values from the NMS OAM database For more information refer to Populating OAM MIB tables NMS Communications 239 OAM Database MIB NMS SNMP Reference Manual otherObjectskwAllowedRange Indicates the range of allowed values for the keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 5 1 1 7 n Details If the keyword type is Integer and is a yes no choice otherObjectskwAllowedRange contains a string of this format Nb values 2 Yes No If the keyword type is Integer and can take a range of values otherObjectskwAllowedRange contains a string of this format BASE base min_value lt gt max_value where e base is a mathematical base of the integer for example 16 for a hexadecimal number e min_value is the minimum allowed value e max_value is the maximum allowed value For example BASE 0 lt 65535 If the keyword type is String otherObjectskwAllowedRange contains all the allowed strings for this keyword separated by commas For example YES NO If any string is acceptable this field contains lt no range gt otherObjectskwAllowedRange reflects the combined values of the Base Min Max and Choices qualifiers for the keyword in the NMS OAM database Configuration When the OAM Database SNMP agent starts up it populates all MIB tables based upon values from the NMS OAM database For more information refer to Populating OAM MIB tables 240 NM
140. ord separated by commas For example YES NO If any string is acceptable this field contains lt no range gt bpikwAllowedRange reflects the combined values of the Base Min Max and Choices qualifiers for the keyword in the NMS OAM database Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Plug in table is populated refer to the OAM Board Plug in table NMS Communications 193 OAM Database MIB NMS SNMP Reference Manual bpikwDescription Provides a short description of the board plug in keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 2 1 1 8 n Details bpikw Description is equivalent to the value of the Description qualifier for the keyword in the NMS OAM database If no description is given bpikwDescription contains lt none gt Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Plug in table is populated refer to the OAM Board Plug in table 194 NMS Communications NMS SNMP Reference Manual OAM Database MIB bpikwMode Indicates if the Supervisor keyword is read only or read write Syntax Integer readOnly 1 readWrite 2 Access Read only OID p 2 1 1 6 n Details bpikwMode reflects the value of the keyword s ReadOnly
141. orl ndex Indicates the keyword s index Syntax Integer Access Read only OID p 1 4 1 1 n Details Keywords are numbered sequentially from 1 upward Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Supervisor Keyword table is populated refer to OAM MIB supervisor tables NMS Communications 249 OAM Database MIB NMS SNMP Reference Manual supervisorEntry Starts a row in the Supervisor Keyword table supervisorTable Syntax Object Access Not accessible OID p 1 4 1 Details Each row in the Supervisor table contains information about a Supervisor keyword The number of rows is exactly equal to supervisorl ndex Configuration The rows in the Supervisor Keyword table are configured by the OAM Database SNMP agent when it starts up For more information refer to Populating OAM MIB tables 250 NMS Communications NMS SNMP Reference Manual OAM Database MIB supervisorTable Starts a sequence of supervisorEntry objects each of which composes a row in the Supervisor Keyword table Syntax Object Access Not accessible OID p 1 4 Details The number of rows in the Supervisor table is exactly equal to supervisori ndex Configuration The rows in the Supervisor Keyword table are configured by the OAM Database SNMP agent when it starts up For more information refer to Pop
142. ormation and service offerings 2 NMS Communications Table of Contents INTTOUCTHION D di ieedecasases we didens E we 9 Overview Of NMS SNMP oooocccoccncoccnconnonnrnnnncnnnnrnnnnrnnnnrnnnnrnnnnrnnnnrnnnnrnnnnrananrnrannnrnnanennanennaness 11 Using network MAaNaAGeMEN cc cnn rr r rr rr ate tate eae 11 Ob CCtildentitlens esni atsainiai peaa aaeei a iaaa a aa aaa ara E aia Enaka a da Sa EiS 11 Managed network COMPONENTES ccc nr nn nen n rr nn rr nn nr nnnrrrnnrrrnnnrrnnrirnaninanes 12 Managed nodes icicionici a dc o e 12 Management Information BaseS ooooccccnccnconcnncnnnncnnnncnnnncnnnnrnnncrnnnrennnrrnnnnenanrrnnnnannerancinannes 13 Management Stats a ii A da 13 Management protocol da dee 14 Accessing MIB Objects AAPP 5 O er oi aai aa KETAN EOU aaa TREE 15 ATOL I AREO IN EA A E T E A a EA E 16 NMS SNMP architecture 00 e Ea E iaaa E EEA E K AEE EAE E Ea E Ea PEE Ea 19 Installing and configuring NMS SNMP sssssssssssnssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnna 21 Installation SUMMArY herrea a A DAE vie E a a S eee ee dat 21 Supported operating SyYStemMS ooooccccccnconcnccnccnnnccnnnncnnnnrnn nr nn ren nn r enn nr rene eaten ene EEEE EEEE nnt 21 Installation and configuration OVerVieW oooccccccccnccnnnccnnnncnnnccnnnccnnnncnnnncnnnnrnnnnannrnnnnrnnnninannes 21 Installing the master agent under UNIX ooocccccccccccococcnnnccnnnncnnnncnnnncnnnnnnnnnnnnnnnnnnnrnnnncrnnnnannnss 23 Installing Und
143. ormation about the chassis and boards snmpHsMon Monitors a CompactPCI chassis for traps snmpTrunkLog Shows the status of digital trunks You must start the Natural Access server with ctdaemon exe and initialize the system hardware with oamsys before running the SNMP demonstration programs Note snmpHsMon is the only demonstration program that supports board insertion extraction NMS Communications 259 Demonstration programs NMS SNMP Reference Manual snmpget Purpose Demonstrates SNMP get Retrieves and displays information about a specified SNMP agent running at a specified IP address Usage snmpget address nmssnmpoid options Use the following parameters Parameter Description address The address or DNS name of a local or remote host running an SNMP agent about which to return information nmssnmpoid OID of an object in one of the MIBs available on the host for which you wish to see information The default is sysDescr Valid options include Option Description v1 Use SNMPv1 default v2 Use SNMPv2 ccommunity_name Specify a community name The default is public rn Number of retries The default is 1 retry tn Timeout in hundredths of a second The default is 100 1 second Procedure To run snmpget 1 From the command line navigate to the nms ctaccess demos snmp snmpget directory or the opt nms ctaccess demos snmp snmpget dir
144. ository enter sm sm lse 1L Information like the following appears SmilZsming 2 Versio Ly 0 OSO OO smi2smir Modules in the SMIR UNMSM ASIS Sil 272 NMS Communications NMS SNMP Reference Manual WBEM support under windows Under certain circumstances the repository is not updated correctly by the mofcomp utility If you experience this problem do the following 1 Delete the entire repository by entering smi2smir p 2 Add the MOF files as described in the above procedure 3 Stop the WMI service by entering net stop winmgmt 4 Restart the WMI service by entering net start winmgmt The WMI repository should be correctly set up Testing MOF files Once the MOF files have been successfully compiled and inserted test your setup using one of the SNMP enumeration example programs provided with the NMS WBEM software Program Description enumsnmp js A JScript program which enumerates SNMP objects in the system enumsnmp htm An HTML file containing an embedded J Script program which enumerates SNMP objects in the system Both programs can be found in nms ctaccess demo snmp wbem Note The console mode WSH interpreter is faster than using the Windows WSH interpreter or the embedded J script Using enumsnmp js To launch enumsnmp js you can do either of the following e Double click on the file enumsnmp js in a Windows Explorer window This launches the script with wscript exe the default
145. plexer default 49212 NMS SNMP architecture e Communication port between the SNMP subagents and the multiplexer default 49213 These IP UDP ports can be changed by editing the snmp cfg file as described in Reconfiguring multiplexer IP UDP ports The multiplexer console program muxC can read the snmp cfg file and can display the currently used IP UDP ports It can also start and stop the agents gracefully without having to kill the process Also it can display all currently registered subagents NMS Communications 19 Overview of NMS SNMP NMS SNMP Reference Manual As shown in the following illustration configurable IP UDP ports allow the NMS multiplexer to be inserted in a chain of multiplexers if necessary In this configuration each multiplexer processes incoming SNMP requests Requests not addressed to a given multiplexer are passed to the next one Multiplexer chain The main reasons for the multiplexer are the following e Uniform structure of SNMP agents and subagents e Dynamic agent and subagent insertion removal and update e Independence from differing master agent implementation and protocols under each operating system e Uniform trap environment adopting a SOLARIS like approach The following illustration shows the inner architecture of the NMS multiplexer Dispatcher Transmit Query Incoming Query Transmit Query default NMS NMS multiplexer internal architecture 20 N
146. qualifier in the NMS OAM database Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Plug in table is populated refer to the OAM Board Plug in table NMS Communications 195 OAM Database MIB bpikwType Indicates the type of the board plug in keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 2 1 1 5 n Details Valid types include Type Description Integer An integer String A string of O or more characters NMS SNMP Reference Manual bpikwType is equivalent to the value of the Type qualifier for the keyword in the NMS OAM database Keywords of other types for example Array Struct StructAndArray are not included as separate entries in MIB tables For more information see OAM database representation Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Plug in table is populated refer to the OAM Board Plug in table 196 NMS Communications NMS SNMP Reference Manual OAM Database MIB bpikwValue Indicates the board plug in keyword value Syntax DisplayString SIZE 0 255 Access Read write OID p 2 1 1 4 n Configuration When it starts up the OAM Database SNMP agent populates all MIB tables bas
147. rdkw Description A short description of the keyword To populate the Board Keyword table boardTable the OAM Database SNMP agent opens the NMS OAM Supervisor managed object and retrieves the values in Boards x keyword This is an array listing the boards managed by the board plug ins running under the Supervisor The agent opens the managed object for each listed board and creates a row in the Board Keyword table for each keyword in the managed object Each keyword is given two indices e The index of the board to which the keyword belongs boardi ndex This is equivalent to the index of the Boards x keyword listing the managed object Note This index does not necessarily match the board number the value of the Number keyword for the board e A unique numerical index boardKwlndex from 1 upwards NMS Communications 175 OAM Database MIB NMS SNMP Reference Manual The objects in the Board Management table boardManagementTable are Object Description BoardManagementEntry Top of the table BoardManagementlndex Index of the board to manage matches the boardi ndex of the board in the Board Keywords table BrdName Use to query or change the board name BrdNumber Use to query or change the board number BrdStartStop Starts or stops the board or indicates its status BrdTest Tests the board or indicates the testing status BrdDelete Delete the board instance from the NMS OAM data
148. rface is unavailable The DS1 interface is said to be unavailable from the onset of 10 contiguous SESs or the onset of the condition leading to a failure If the condition leading to the failure was immediately preceded by one or more contiguous SESs dsx1CurrentSESs then the DS1 interface unavailability starts from the onset of these SESs e Once unavailable and if no failure is present the DS1 interface becomes available at the onset of 10 contiguous seconds with no SESs e Once unavailable and if a failure is present the DS1 interface becomes available at the onset of 10 contiguous seconds with no SESs if the failure clearing time is less than or equal to 10 seconds If the failure clearing time is more than 10 seconds the DS1 interface becomes available at the onset of 10 contiguous seconds with no SESs or the onset period leading to the successful clearing condition whichever occurs later All DS1 error counts are incremented while the DS1 interface is deemed available While the interface is deemed unavailable the only count that is incremented is UASs A special case exists when the 10 or more second period crosses the 900 second statistics window boundary because the Severely Errored Second and Unavailable Second counters must be adjusted when the Unavailable Signal State is entered Successive gets of the affected get occurs during the first few seconds of the window This is an unavoidable side effect of selecting the managed o
149. rrentSESs Indicates the number of Severely Errored Seconds Syntax Gauge Access Read only OID p 7 1 3 n where n the index number of the DS1 interface Details This value is defined differently for different signal types For this signal A Severely errored second is type ESF signals A second with 320 or more Path Code Violation Error Events or one or more Out of Frame defects or a detected AIS defect E1 CRC signals A second with 832 or more Path Code Violation error events or one or more Out of Frame defects El no CRC signals A second with 2048 Line Code Violations or more D4 signals A count of one second intervals with Framing Error events or an OOFdefect OR 1544 Line Code Violations or more Controlled slips are not included in this parameter This value is not incremented during an Unavailable Second Configuration Not applicable 112 NMS Communications NMS SNMP Reference Manual dsx1CurrentTable Starts the Current table Syntax Object Access Not accessible OID p 7 Configuration Not applicable NMS Communications Trunk MIB 113 Trunk MIB NMS SNMP Reference Manual dsx1CurrentUASs Indicates the number of Unavailable Seconds Syntax Gauge Access Read only OID p 7 1 5 n where n the index number of the DS1 interface Details Unavailable Seconds UAS are calculated by counting the number of seconds that the inte
150. s MIB information The snmp cfg file is installed in one of the following directories OS Path Windows 2000 nms ctaccess cfg UNIX opt nms ctaccess cfg Configuration file syntax Statements within the file appear one to a line Any text appearing after a pound sign is a comment and is ignored Statements are case insensitive except where operating system conventions prevail for example filenames under UNIX The snmp cfg file is divided into multiple sections Each section has a header appearing in square brackets 1 The statements within each section apply to one or more subagents The sections are as follows Section Subagent s common All subagents chassisAgent Chassis subagent only ds1Agent Trunk subagent only oamAgent OAM Database subagent only softRevAgent Software Revision subagent only rtpAgent RTP subagent only Statements within a section each consist of a keyword name followed by an equals sign and then a value keyword value 30 NMS Communications NMS SNMP Reference Manual Installing and configuring NMS SNMP The common section The common section contains statements that apply to all subagents This section contains the following keywords Keyword Description Allowed values Manda tory SnmpPort Defines the port through which SNMP Valid UDP port number Yes queries will be sent to the multiplexer Ma
151. s command is gt onmpnext 101 20 48 Lo Dedo do dls dsd SNMP GetNext to 10 1 20 46 SNMPV1 Retries 1 Timeout 1000ms Community public O iel 1 3 Ba 1 2 1 1 2e0 Wells LL MS ld NMS Communications 261 Demonstration programs NMS SNMP Reference Manual snmpset Purpose Demonstrates SNMP set Sets the value of a specified SNMP object Usage snmpset address nmssnmpoid options Use the following parameters Parameter Description address The address or DNS name of a local or remote host running an SNMP agent about which to return information nmssnmpoid OID of an object in one of the MIBs available on the host for which you wish to see information The default is sysDescr Valid options include Option Description v1 Use SNMPv1 default v2 Use SNMPv2 ccommunity_name Specify a community name The default is public rn Number of retries The default is 1 retry tn Timeout in hundredths of a second The default is 100 1 second Procedure To run snmpset 1 From the command line navigate to the nms ctaccess demos snmp snmpset directory or the opt nms ctaccess demos snmp snmpset directory under UNIX 2 Enter the following Siimosee localhost 1 3 6 1 4 1 262852 AO Note An example of running this command to set the chassBoardTrapEnable follows gt snmpoet exe localhost Los 565154 do 2628 2 2546 da lO gt SNMP Set to localhost SNMPV1 Retr
152. s registered to NMS OAM e A table of boards each with their keywords values and qualifiers e Values that allow you to start or stop a board test a board or delete a board instance from the database The objects in the OAM Boards table oamBoards are Object Description detectedBoardCount The number of boards automatically detected in the system createdBoardCount The total number of boards registered to NMS OAM boardTable Board Keyword table containing a list of boards each with their keywords values and qualifiers boardManagementTable Board Management table containing values that allow you to start stop test or delete a board change the board name or number or query its status The objects in the Board Keyword table boardTable are Object Description boardTable Top of the table boardEntry Starts a row of the Board Keyword table boardi ndex Board index boardKwI ndex Unique index within this table identifying the keyword brdkeywordName The keyword name formatted as described in OAM database MIB tables and keywords brdkwValue The value of the keyword brdkwType The type of the keyword Integer or String brdkw Mode 1 indicates keyword value is read only 2 indicates keyword value is read write brdkwAllowedRange The range of allowable values for the keyword formatted as described in OAM database MIB tables and keywords b
153. sChangeTrapEnable Determines whether traps should be generated for this interface Syntax Integer Access Read write OID p 6 1 17 n where n the index number of the DS1 interface Details Possible values are Value Description 1 Enabled 2 Disabled default Configuration Not applicable NMS Communications Trunk MIB 127 Trunk MIB NMS SNMP Reference Manual dsx1LoopbackConfig Represents the loopback configuration of the DS1 interface Syntax Integer Access Read write OID p 6 1 9 n where n the index number of the DS1 interface Details The Trunk agent returns badValue in response to a requested loopback state that the interface does not support Valid types for RFC 2495 are Type Value Description dsx1NoLoop 1 Not in the loopback state A device that is not capable of performing a loopback on the interface will always return this value dsx1PayloadLoop 2 The received signal at this interface is looped through the device Typically the received signal is looped back for re transmission after it has passed through the device s framing function dsx1LineLoop 3 The received signal at this interface does not go through the device dsx1OtherLoop 4 Loopbacks that are not defined Note The agent will only return dsx1NoLoop 1 Loopback is not supported Configuration Not applicable 128 NMS Communications NMS S
154. station You can also use the snmpwalk demonstration program installed with the SNMP package to enumerate the contents of the Mib II agents 6 Install the NMS subagents and multiplexer as described in Installing the NMS subagents and multiplexer Installing under Linux The SNMP package has been tested using the UCD University of Columbia at Davis SNMP release ucd snmp 4 0 1 4 rpm You can find the latest UCD package at rpmfind net or at net snmp sourceforge net previously known as ucd snmp ucdavis edu web site To install configure and start the SNMP master agent on a Linux system 1 Install the SNMP package To do so access a command prompt and enter rem i ucd snmp 4 0 1 4 rpm 2 Start the SNMP master agent by entering eee el imiti oso Siceuaie 3 Verify that the SNMP master agent is properly installed To do so you can use any SNMP management station You can also use the snmpwalk demonstration program installed with the SNMP package to enumerate the contents of the Mib II agents 4 Install the NMS subagents and multiplexer as described in Installing the NMS subagents and multiplexer NMS Communications 23 Installing and configuring NMS SNMP NMS SNMP Reference Manual Installing the master agent under Windows 2000 The installation and configuration procedures for NMS subagents are different from that of the master agent To install the NMS subagents and multiplexer refer to Installing the NMS subagents
155. sterAgentPort Defines the port through which the Valid UDP port number Yes multiplexer will send SNMP requests not addressed to its subagents CommunicationPort Defines the port used by the multiplexer Valid UDP port number Yes the subagent and the console to communicate for registration stop or info commands access Defines the access rights and the defined access community host No communities that can be used to send where requests to the agents e access defines the access right readonly writeonly or readwrite community is the name of a defined community that can be used to send requests to the agents e host specifies the name of the host where the SNMP requests are authorized An asterisk character indicates that any host is allowed trap Defines the host where the trap will be community host No sent and the community that will be used where community is the name of a defined community that can be used to send requests to the agents e host specifies the name of the host where the SNMP requests are authorized An asterisk character indicates that any host is allowed The subagent specific sections Below the common section appear sections containing statements that apply to individual subagents only Any configuration parameters needed by a given subagent must appear in the section for the subagent The access and trap keywords defined as in the common section
156. stopped Syntax Integer brdStart 1 brdStop 2 Access Read write OID p 4 4 1 4 n Details For more information refer to Starting stopping and testing boards Configuration Not applicable NMS Communications 207 OAM Database MIB NMS SNMP Reference Manual brdTest Initiates board testing or indicates if a board is currently testing or not Syntax Integer Access Read write OID p 4 4 1 5 n Details Reading this value always returns 1 For more information refer to Starting stopping and testing boards Configuration Not applicable 208 NMS Communications NMS SNMP Reference Manual OAM Database MIB createdBoardCount The number of boards created within NMS OAM for this board family Syntax Integer Access Read only OID p 4 2 Configuration This value is updated whenever board managed objects are created or deleted NMS Communications 209 OAM Database MIB NMS SNMP Reference Manual detectedBoardCount Indicates the number of boards physically detected for this board family Syntax Integer Access Read only OID p 4 1 Configuration This value is updated whenever the NMS OAM automatic board detection functions are activated For more information see the NMS OAM Service Developer s Reference Manual 210 NMS Communications NMS SNMP Reference Manual OAM Database MIB emcEntry Starts a row in the Extended Management Component table emcTable
157. t Model of this board textual boardFamilyl d Family of the board boardFamilyNumber Logical number of the board boardDescr Board description boardStatus Board status online or offline boardCommand Turns the board on or off boardTrunkCount Number of trunks on this board boardRevision Board revision boardSerialNumber Board serial number boardManufDate Date the board was manufactured boardStatusLastChange When the status of the board last changed boardStatusChangeTrapEnable Determines if boardStatusLastChange traps will be generated Chassis Trap group The Chassis MIB Trap group is used by the agent to specify trap information It has a valid object identifier but does not contain usable information for developers NMS Communications 45 Chassis MIB NMS SNMP Reference Manual Using the Chassis MIB object reference The following sections describe the objects in this MIB A typical object description includes Syntax The datatype of the object is shown SNMP data types include Integer 16 bit signed DisplayString ASCII text Gauge Positive integer from 0 to 4294967295 2 1 Object Another object type from this MIB TimeStamp Positive integer from 0 to 4294967295 2 1 TruthValue Integer value where 1 is True and 2 is False Access The type of access allowed for this object Options are Read only This object can not be modified by SNMP Read write SNMP can
158. t_T1 AG_CPCI_Quad_E1 AG_CPCI_Quad_T1 AG_4000_Single_El AG_4000_Single_T1 AG_4000_Dual_E1 AG_4000_Dual_T1 AG_4000_Quad_E1 AG_4000_Quad_T1 AG_4000C_Dual_E1 AG_4000C_Dual_T1 AG_4000C_Quad_E1 AG_4000C_Quad_T1 CG CG_6000C_Quad 98 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Trunk MIB For Natural Access 3 x acceptable values are Board type Value AG Ag4000 Dual T1 Ag4000 Quad T1 Ag4000 T1 AgT1 Ag Dual T1 Ag Quad T1 Board Ag Quad T1 Connect Ag4000 Dual El Ag4000 El Ag4000 Quad El AgE1 Ag Dual E1 Ag Quad E1 Board Ag Quad E1 Connect board number is a two digit number starting at 0 trunk number is a two digit number starting at 0 For example board 0 trunk 3 is AG _ 4000 Single E1 00 03 The circuit identifier matches the boardModelText object in the Chassis MIB which allows cross referencing DS1 interfaces between the two MIBs Configuration Not applicable NMS Communications 99 Trunk MIB NMS SNMP Reference Manual dsx1ConfigTable Starts a sequence of dsx1ConfigEntry objects each representing a DS1 interface Syntax Object Access Not accessible OID p 6 Configuration Not applicable 100 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx1ConfigEntry Starts a sequence of 13 objects that describe the configuration of the DS1 interface identified by dsx1Linel ndex Syntax Not applicable Access
159. ted Channel Mapping Table Optional and not supported Trap Group Enables a trap to be sent when the status of the interface changes Known limitations RFC 1573 defines an ifTable for all the interfaces in the system as part of MIB2 The ifTable is not accessible by the NMS SNMP agent Therefore some portions of the RFC 2495 MIB are not supported The dsx1ChannelMappingTable is also not available The DS1 Near End Group consists of four tables Table Description Configuration Contains information about each DS1 interface such as the number of bits per second that the circuit can reasonably carry variety of Zero Code Suppression and the vendor s circuit identifier Current Contains statistics for the current 15 minute interval Interval Contains statistics collected by each DS1 interface for the last 24 hours of operation The past 24 hours are broken into 96 15 minute intervals After 24 hours the next interval pushes the oldest one out of the table Total Contains the cumulative sum of the statistics for the period of time since this MIB was first started Each field in this table contains the sum of the fields in the Current table for a particular interface The information in the Current table refreshes continuously Every 15 minutes the current table s contents are copied to the Interval table and the sum of values from the Current table are added to the Total table The Total table
160. the chassis Syntax DisplayString SIZE 0 255 Access Read only OID p 2 2 Details The default value is the empty string An example string could be CPCI chassis location Floor 2 West Wing The chassis description is specified in the snmp cfg configuration file The keyword and value are ChassisDescription Description Configuration This object is configured by editing snmp cfg before starting the NMS Chassis agent 78 NMS Communications NMS SNMP Reference Manual Chassis MIB chassMI BRevision Indicates the revision ID of the Chassis MIB Syntax DisplayString SIZE 0 255 Access Read only OID p 1 1 Details The value of the revision ID set by NMS is Wednesday May 24 2000 This object identifies the MIB so the management station can tell if it is configured for the correct MIB Configuration Not applicable Note In versions of the software prior to 2001 1 the OID for this node was p 1 NMS Communications 79 Chassis MIB chassRevision Starts a group for the revision field Syntax Object Access Not accessible OID p 1 Configuration Not applicable 80 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Chassis MIB chassSegmentBusCount Indicates the number of known bus segment types ISA bus and or PCI segments in the chassis Syntax Integer Access Read only OID p 2 3 Details The default value is 0 there are
161. tions NMS SNMP Reference Manual emckwValue Indicates the EMC keyword value Syntax DisplayString SIZE 0 255 Access Read write OID p 3 1 1 4 n Configuration OAM Database MIB When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Extended Management Component table is populated refer to the OAM EMC table NMS Communications 219 OAM Database MIB NMS SNMP Reference Manual emcTable Starts a sequence of emcEntry objects each of which composes a row in the Extended Management Component table Syntax Object Access Not accessible OID p 3 1 Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Extended Management Component table is populated refer to the OAM EMC table 220 NMS Communications NMS SNMP Reference Manual OAM Database MIB keywordName Indicates a Supervisor keyword name Syntax DisplayString SIZE 0 255 Access Read only OID p 1 4 1 2 n Details When a keyword belongs to one or more arrays or structures the array and structure names are appended to the keyword name in the table separated by periods For example the keyword FallBackClockSource in the struct HBus which is within Clocking is expressed as Clocking HBus FallBackClockSource Confi
162. tl ndex object whose value is assigned by the NMS Chassis agent busSegmentEntry objects are added to the table when a board is added to a new bus segment If all boards are extracted that bus segment will be deleted from the table Note ISA boards are not supported by Natural Access version 4 0 and later The objects in the Bus Segment table are Object Description busSegmentTable Starts the Bus Segment table busSegmentEntry Starts a row of the Bus Segment table busSegmentl ndex Number of this row in the Bus Segment table busSegmentType Bus type busSegmentDescr Describes the bus segment busSegmentSlotsOccupied Number of occupied slots in this bus segment NMS Communications 43 Chassis MIB NMS SNMP Reference Manual Chassis MIB Board Access table The Board Access table simplifies access to the Board table s variables The Board table can be sequentially accessed by using a series of get next commands starting from the beginning of the table But this type of access is not convenient for all types of queries For example an application may be interested in the trunk count of all boards on PCI segment 2 Using get next commands the application must traverse the entire table in order to ensure that all boards are accounted for With the index table the application only needs to find the first entry with the busSegmentNumber that matches PCI segment 2 and the rest
163. tly implemented are shown in grey Internet 1 Directory Mgmt 1 2 El Private Experimental 4 3 Mib_2 Enterprises 1 1 Session Table Transmission Reverse Session Table 10 Sender Table Receiver Table Configuration Table Current Table Interval Table Total Table Directory 1 Board Table Bus Slot Access Table Backplane Access Table Package Access Table File Access Table Patch Access Table Enterprise MIB NMS Communications Reverse Sender Table Reverse Receiver Table Experimental 4 DAM Supervisor Table OAM Board Plugins Table DAM EMCs Table DAM Boards Table DAM Other Objects Table DAM Events Traps 17 Overview of NMS SNMP NMS SNMP Reference Manual The NMS subtree consists of the following MIBs MIB Description Directory Describes all MIBs defined by NMS Common Contains general purpose MIBs applicable across multiple product lines Specific Contains specialized MI Bs for individual products Experimental Contains MIBs that are under development and test MIB description files in ASN 1 language for the NMS SNMP subagents can be found in the nms ctaccess doc directory The following table lists the MIB description files MIB Description File Description NmsChassis mib Chassis MIB NmsO0amDatabase mib OAM Database MIB NmsSmi mib NMS hierarchy MIB NmsSoftRev mib Software Revisio
164. ture names are appended to the keyword name in the table separated by periods For example the keyword FallBackClockSource in the struct HBus which is within Clocking is expressed as Clocking HBus FallBackClockSource Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Extended Management Component table is populated refer to the OAM MIB EMC table NMS Communications 213 OAM Database MIB NMS SNMP Reference Manual emckwAllowedRange Specifies the range of allowed values for the EMC keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 3 1 1 7 n Details If the keyword type is Integer and is a yes no choice emckwAllowedRange contains a string of this format Nb values 2 Yes No If the keyword type is Integer and can take a range of values emckwAllowedRange contains a string of this format BASE base min_value lt gt max_value where e base is a mathematical base of the integer for example 16 for a hexadecimal number e min_value is the minimum allowed value e max_value is the maximum allowed value For example BASE 0 lt gt GB535 If the keyword type is String emckwAllowedRange contains all the allowed strings for this keyword separated by commas For example YES NO If any string is acceptable this field contains lt no range gt emckwAllowedRange re
165. uded so that future extensions to NMS OAM will not require changes to the structure of the OAM Database MIB The objects in the Other Objects table are Object Description otherObjectsTable Top of the table otherObjectsEntry Starts a row of the Other Objects table otherObjectsI ndex Object index otherObjectsKwl ndex Unique index within this table identifying the keyword otherObjectskeywordName The keyword name formatted as described in OAM database MIB tables and keywords otherObjectskwValue The value of the keyword otherObjectskwType The type of the keyword Integer or String otherObjectskw Mode 1 indicates keyword value is read write 0 indicates keyword value is read only otherObjectskwAllowedRange The range of allowable values for the keyword formatted as described in OAM database MIB tables and keywords otherObjectskwDescription A short description of the keyword Configuration Not applicable NMS Communications 235 OAM Database MIB NMS SNMP Reference Manual oamStartStop Stop or start the NMS OAM Supervisor or queries its status for more information refer to Starting and stopping the supervisor Syntax Integer oamStart 1 oamStop 2 Access Read write OID p 1 1 Configuration Not applicable 236 NMS Communications NMS SNMP Reference Manual OAM Database MIB oamSupervisor Starts a Super
166. uerying or setting the board number of a bOard cece cece eect eee eee ee eee eee a teeta teeta ties 255 Starting stopping and testing DOArdS cece eee ene eee tena eaten tne ea ties 256 Starting ANd STOPPING DOAFAS void aa Ea a a E AAS 256 Testing boards eiri AA AAA AA A tn ee 256 Starting and stopping the SUPerviSOT ooocccccnccncnccnnnccnnnccnnnncnnnncnnnccnnnnrnnnnrnannrnnnnrnanrrnnnninaness 257 OAM MIB CV CNS ii el a a teeta nein renin E E E E 257 Demonstration Programs ccccseeeeeceeeeeeeeeeeeeeeeeeeueceauaseeuaeeauaseasaseaeaseasaeeaeeeuasseueeausseansgeass 259 Using SNMP demonstration programMs cccece cece eee ened 259 SMIMPO GU wiser cae A E A Latah OOO 260 SMIMPMEX Cie a 261 NMS Communications 7 Table of Contents NMS SNMP Reference Manual A ON 262 SONMPERAASS ICM A AAA 263 SAMPAS MON turis detandtacaasb a a a E E a E E 265 SNMP Tru nKLOG iia id 267 WBEM support under WINdOWS ccsceceeeeceeeeeeeeeeeaeeeeaeeeuaeeeuaeeeuaeeauaeeeeeeaeeeuaeeeuaeeaeaeegnanes 269 Overview Of WBEM SUPPOIMt cc cece eee nates 269 Installing Microsoft WMI and the WMI SNMP Providel ccceeeee eee eee eee ee eee e ete e eee need 270 Verifying the SNMP installation ccc erent ene tenets 270 Obtaining and installing WMI Software c ccc ce eee eee eee eee nee ene e ena 270 Windows 2000 server and advanced Servel cccccee eee eee eee nett ene eee na eae 270 Windows 2
167. uest dsx1SendQRS 5 Sending a Quasi Random Signal QRS test pattern dsx1Send511Pattern 6 Sending a 511 bit fixed test pattern dsx1Send3in24Pattern 7 Sending a fixed test pattern of 3 bits set in pattern of 24 dsx1SendOtherTestPattern 8 Sending a test pattern other than those described by this object Note The SNMP agent returns dsx1SendNoCode normal data Loopback is not supported Configuration Not applicable 130 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx1SignalMode Indicates the signal mode of the circuit Syntax Integer Access Read write OID p 6 1 11 n where n the index number of the DS1 interface Details Valid entries include Type Value Description none 1 No bits are reserved for signaling on this channel robbeaBit 2 T1 Robbed Bit Signaling is in use bitOriented 3 El Channel Associated Signaling is in use messageOriented 4 See Channel Signaling is in use either on channel 16 of an E1 link or on channel 24 of a T1 link Configuration Not applicable NMS Communications 131 Trunk MIB NMS SNMP Reference Manual dsx1StatusLastChange Indicates the time when the status of the interface last changed Syntax TimeStamp Access Read only OID p 6 1 16 n where n the index number of the DS1 interface Configuration Not applicable 132 NMS Communications NMS SNMP Reference Manual Trunk MIB dsx1Tim
168. ulating OAM MIB tables NMS Communications 251 Using the NMS OAM database MIB Accessing keywords for boards plug ins or EMCs To access a particular keyword for a board a board plug in or an EMC 1 Determine the index of the managed object containing the keyword To do so access the Supervisor Keyword table supervisorTable and search for the managed object name in one of the following array keywords For this managed object Search this array Board Boards x Board Plug in BoardPlugins x EMC ExtendedManagementComponents x 2 Access the table containing keywords for the managed object type For this managed object Access this table Board boardTable Board Plug in boardPluginTable EMC emcTable Each of these tables is doubly linked The first index the managed object index maps to the index you determined in step 1 Within the entries in the table beginning with the desired index search for the keyword 4 To set a keyword first determine that it is read write If it is make sure the type for example integer or string of your setting is correct for the keyword and is within the range of allowed values Board settings do not take effect until the board is stopped and restarted NMS Communications 253 Using the NMS OAM database MIB NMS SNMP Reference Manual Creating and deleting board managed objects You can use the items in the Creat
169. umber The board text portion maps to the boardFamilyl d in the Chassis MIB and the board number maps to the boardi ndex in the Chassis MIB both objects are in the Board table For example dsx1Circuitl dentifier AG_Dual_T1_02_01 boardModelText AG_Dual_T1 boardFamilyNumber 2 In this example dsx1Circuitl dentifier says that the trunk is on an AG_Dual_T1 board the family number is 2 and the trunk number is 1 trunk number has no direct match in the Chassis MIB Chassis MIB structure The Chassis MIB represents a chassis as single managed node that consists of the buses slots and devices installed in a chassis There are five major tables within the Chassis MIB Table Description Chassis Configuration Provides information about the chassis Bus Segment Provides information about the bus segments in this chassis Board Access by bus slot Provides an index into the Bus Segment table and the Board table Board Provides information about each board Board Access by backplane Not implemented Reserved for future use 40 NMS Communications NMS SNMP Reference Manual Chassis MIB The following illustration shows how the tables in the Chassis MIB are related to one another Bus segment type Bus segment index Bus segment slots occupied See MAA E Bus segment count 15 ISA C Chassis Configuration PCI es Table A Slot oe Board Board Bus index index segment index y
170. umber of a board in this family Syntax Integer Access Read only OID p 4 3 1 8 n where n is the entry number Details This value matches the number in the oamsys cfg file and the board number in the dsx1Circuitl dentifier in the Trunk MIB For Natural Access 3 x the logical board number matches the number in the ag cfg file and the board number in the dsx1Circuitl dentifier in the Trunk MIB Configuration Not applicable 54 NMS Communications NMS SNMP Reference Manual boardManufDate Indicates the board s manufacturing date Syntax DisplayString SIZE 0 255 Access Read only OID p 4 3 1 15 n where n is the entry number Configuration Not applicable Example week 5 00 NMS Communications Chassis MIB 55 Chassis MIB boardModel Indicates the board type Syntax Integer Access Read only OID p 4 3 1 5 n where n is the entry number Details Supported board types for Natural Access 4 0 or later include Value Board Types 1 other 2 QX 2000 80 1L QX 2000 80 4L QX 2000 100 4L QX 2000 200 4L 3 AG 2000 AG 2000 BRI AG 2000 E amp M AG 2000 VTG AG 2000C 4 AG Dual El AG Dual T1 5 AG CompactPCI Quad El AG CompactPCI Quad T1 AG Quad Connect El AG Quad Connect T1 AG Quad El AG Quad T1 AG QuadDual El AG QuadDual T1 6 AG 4000 Single E AG 4000 Single T AG 4000 Dual El AG 4000 Dual T1 AG 4000 Quad El AG 4000 Quad T1
171. uration This value is set when the first NMS package is installed NMS Communications 143 Software revision MIB fileAccess Starts a group containing the File Entry table fileEntry Syntax Object Access Not accessible OID p 2 Configuration Not applicable 144 NMS SNMP Reference Manual NMS Communications NMS SNMP Reference Manual Software revision MIB filesCount Indicates the number of files included in the package Syntax Integer Access Read only OID p 1 3 1 4 n Configuration This value is updated when the Natural Access Server ctdaemon is restarted NMS Communications 145 Software revision MIB NMS SNMP Reference Manual fileEntry Starts a row in the File Entry table fileTable Syntax Object Access Not accessible OID p 2 1 1 Details The number of fileEntry objects in the table is exactly equal to filesCount Configuration When the Natural Access Server ctdaemon is restarted rows are added or removed as necessary to reflect the current sets of installed files 146 NMS Communications NMS SNMP Reference Manual filel ndex Indicates the index of a file in the package Syntax Integer Access Read only OID p 2 1 1 2 n Details This value is a number between 1 and filesCount Configuration This identifier is internally assigned by the agent NMS Communications Software revision MIB 147 Software revision MIB NMS SNMP
172. used transport service is User Datagram Protocol UDP which is part of the IP suite Two types of messages are supported Message Description Traversal Provides a way for the host to read the values in an agent s MIB Trap Sent by an agent to report events to the host The following illustration shows the host and agent message flow Traversal Message r Response to Traversal Message and Trap Messages SNMP Management System Host SNMP agent SNMP management software SNMP service SNMP message flow Traversal messages are generated by host commands These commands are Command Description get Requests a specific value for example the amount of hard disk space available get next Requests the next value in a MIB after using the get command Useful when getting a block of related objects set Changes the value of an object in a MIB Only objects with read write access can be set Trap messages are sent by an agent to notify the host about an unusual occurrence The host can then request the value of related variables to determine more about the managed node s condition The agent can be set to send a trap when certain conditions arise such as an error on a line Care must be taken to ensure that trap information does not congest the network or overwhelm the host Connectionless transport does not guarantee delivery which means that traps and other network messages are
173. vals that the agent has been running minus 1 since the time periods start with 1 Configuration Not applicable NMS Communications 135 Software revision MIB Software Revision MIB representation The Software Revision MIB represents all NMS software packages installed in a system Each file in each installed software revision is tracked in the MIB The Software Revision agent keeps the MIB up to date as packages are installed or removed However the agent cannot track revisions of NMS files manually copied to or deleted from a system that is without use of NMS installation software To keep the MIB up to date the Software Revision agent relies on information from the module identification signature files sgn files installed with each Natural Access product These files are stored in the nms bin directory opt nms bin under UNIX When the Natural Access Server ctdaemon is restarted the Software Revision agent modifies the MIB to match the current set of signature files Note Certain NMS patches do not install their sgn files in the nms bin or opt nms bin directory If the sgn file is not installed in one of these directories locate the file and manually copy it to the correct directory The MIB cannot track a patch unless its sgn file is in the correct directory Once you have installed NMS packages service packs or patches the values in the Software Revision MIB are updated automatically when you restart the
174. visor group Syntax Object Access Not accessible OID p 1 Details The Supervisor group contains the following objects Object Description oamStartStop Starts or stops the NMS OAM Supervisor process or indicates its status oamEventMask Sets the NMS OAM event mask or indicates its status oamAlertRegister Registers for NMS OAM alert notification or indicates the status of the registration supervisorTable Supervisor Keyword table containing NMS OAM Supervisor keywords values and qualifiers oamCreateBoard Create Board table containing values that allow you to create board instances in the database Configuration Not applicable NMS Communications 237 OAM Database MIB NMS SNMP Reference Manual otherObjectsEntry Starts a row in the Other Objects table otherObjectsTable Syntax Object Access Not accessible OID p 5 1 1 Details Each row in the Other Objects table contains information about a keyword Configuration When the OAM Database SNMP agent starts up it populates all MIB tables based upon values from the NMS OAM database For more information refer to Populating OAM MIB tables 238 NMS Communications NMS SNMP Reference Manual OAM Database MIB otherObjects I ndex Indicates the managed object to which the keyword belongs Syntax Integer Access Read only OID p 5 1 1 1 n Configuration When the OAM Database SNMP agent starts up it p
175. wType The type of the keyword Integer or String bpikw Mode 1 indicates keyword value is read only 2 indicates keyword value is read write bpikwAllowedRange The range of allowable values for the keyword formatted as described in OAM database MIB tables and keywords bpikw Description A short description of the keyword To populate this table the OAM Database SNMP agent opens the NMS OAM Supervisor managed object and retrieves the values in BoardPlugins x keyword This is an array listing the board plug ins installed and running under the Supervisor The agent opens the managed object for each listed plug in and creates a row in the Board Plug in table oamBoardPlugins for each keyword in the managed object Each keyword is given two indices The index of the plug in to which the keyword belongs boardPluginIndex This is equivalent to the index of the BoardPlugins x keyword listing the managed object NMS Communications A unique numerical index boardPluginKwI ndex from 1 upwards 173 OAM Database MIB NMS SNMP Reference Manual OAM MIB EMC table The Extended Management Component EMC table contains for each EMC a table of the EMC s keywords values and qualifiers The objects in the Extended Management Component EMC table oamEMCs are Object Description emcTable Top of the table emcEntry Starts a row of the Extended Management Component t
176. y OID p 2 1 1 3 n Details NMS SNMP Reference Manual Where a keyword belongs to one or more arrays or structures the array and structure names are appended to the keyword name in the table separated by periods For example the keyword FallBackClockSource in the struct HBus which is within Clocking is expressed as Clocking HBus FallBackClockSource Configuration When it starts up the OAM Database SNMP agent populates all MIB tables based upon information from the NMS OAM database For more information on how the Board Plug in table is populated refer to the OAM Board Plug in table 192 NMS Communications NMS SNMP Reference Manual OAM Database MIB bpikwAllowedRange Indicates the range of allowed values for the board plug in keyword Syntax DisplayString SIZE 0 255 Access Read only OID p 2 1 1 7 n Details If the keyword type is Integer and is a yes no choice bpikwAllowedRange contains a string of this format Nb values 2 Yes No If the keyword type is Integer and can take a range of values bpikwAllowedRange contains a string of this format BASE base min_value lt gt max_value where e base is a mathematical base of the integer for example 16 for a hexadecimal number e min_value is the minimum allowed value e max_value is the maximum allowed value For example BASES 65535 If the keyword type is String bpikwAllowedRange contains all the allowed strings for this keyw

NMS SNMP Reference Manual

Contents

Download Pdf Manuals

Related Search

Related Contents