Jmib Tools (1426) - Ca Technologies

Transcript

Titlepage JMibTools Document 1426 Network Management Copyright Notice Document 1426. Copyright © 2002 - present by Aprisma Management Technologies, Inc. All rights reserved worldwide. Use, duplication, or disclosure by the United States government is subject to the restrictions set forth in DFARS 252.227-7013(c)(1)(ii) and FAR 52.227-19. Liability Disclaimer Aprisma Management Technologies, Inc. (“Aprisma”) reserves the right to make changes in specifications and other information contained in this document without prior notice. In all cases, the reader should contact Aprisma to inquire if any changes have been made. The hardware, firmware, or software described in this manual is subject to change without notice. IN NO EVENT SHALL APRISMA, ITS EMPLOYEES, OFFICERS, DIRECTORS, AGENTS, OR AFFILIATES BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATED TO THIS MANUAL OR THE INFORMATION CONTAINED IN IT, EVEN IF APRISMA HAS BEEN ADVISED OF, HAS KNOWN, OR SHOULD HAVE KNOWN, THE POSSIBILITY OF SUCH DAMAGES. Trademark, Service Mark, and Logo Information SPECTRUM, IMT, and the SPECTRUM IMT/VNM logo are registered trademarks of Aprisma Management Technologies, Inc., or its affiliates. APRISMA, APRISMA MANAGEMENT TECHNOLOGIES, the APRISMA MANAGEMENT TECHNOLOGIES logo, MANAGE WHAT MATTERS, DCM, VNM, SpectroGRAPH, SpectroSERVER, Inductive Modeling Technology, Device Communications Manager, SPECTRUM Security Manager, and Virtual Network Machine are unregistered trademarks of Aprisma Management Technologies, Inc., or its affiliates. For a complete list of Aprisma trademarks, service marks, and trade names, go to http://www.aprisma.com/manuals/trademark-list.htm. All referenced trademarks, service marks, and trade names identified in this document, whether registered or unregistered, are the intellectual property of their respective owners. No rights are granted by Aprisma Management Technologies, Inc., to use such marks, whether by implication, estoppel, or otherwise. If you have comments or concerns about trademark or copyright references, please send an e-mail to [email protected]; we will do our best to help. JMibTools Page 2 Restricted Rights Notice (Applicable to licenses to the United States government only.) This software and/or user documentation is/are provided with RESTRICTED AND LIMITED RIGHTS. Use, duplication, or disclosure by the government is subject to restrictions as set forth in FAR 52.227-14 (June 1987) Alternate III(g)(3) (June 1987), FAR 52.227-19 (June 1987), or DFARS 52.227-7013(c)(1)(ii) (June 1988), and/or in similar or successor clauses in the FAR or DFARS, or in the DOD or NASA FAR Supplement, as applicable. Contractor/manufacturer is Aprisma Management Technologies, Inc. In the event the government seeks to obtain the software pursuant to standard commercial practice, this software agreement, instead of the noted regulatory clauses, shall control the terms of the government's license. Virus Disclaimer Aprisma makes no representations or warranties to the effect that the licensed software is virusfree. Aprisma has tested its software with current virus-checking technologies. However, because no antivirus system is 100 percent effective, we strongly recommend that you write-protect the licensed software and verify (with an antivirus system in which you have confidence) that the licensed software, prior to installation, is virus-free. Contact Information Aprisma Management Technologies, Inc. 273 Corporate Drive Portsmouth, NH 03801 Phone: 603-334-2100 U.S. toll-free: 877-468-1448 Web site: http://www.aprisma.com JMibTools Page 3 Contents Introduction 7 JMib Tools Overview ....................................................................................................7 How a MIB is Organized ...........................................................................................8 Object Identifiers ...................................................................................................8 Enterprise MIBs .................................................................................................9 The JMib Tools Interface 11 Launching JMib Tools ................................................................................................12 Basic Features of JMib Tools .....................................................................................14 File Menu Option ....................................................................................................16 View Menu Option ..................................................................................................16 Help Menu Option ...................................................................................................16 About Serialization (.ser) Files ................................................................................16 About TheWorld Database .....................................................................................17 Using the Browser 18 Contacting a Device ...................................................................................................19 Contacting All Devices on a Subnet .......................................................................21 Specifying Community Name Access to a Device ..................................................22 Viewing MIB Information Stored in the JMib Tools Database ....................................23 The MIB Tree Display .............................................................................................24 The Radar View ......................................................................................................26 The Find Button ......................................................................................................26 Querying MIB Objects on Network Devices ...............................................................29 Querying a Device with the Query Button ..............................................................29 Stopping a Query ................................................................................................31 Querying a Device with the Build Request Button ..................................................31 Viewing and Formatting Query Results 33 Resizing the Query Results Fields .............................................................................35 Clearing Query Results ..............................................................................................36 Printing Query Results ...............................................................................................36 JMibTools Page 4 Con t en ts C o n t e nt s Saving Query Results ................................................................................................37 Using Tables to View Query Results ..........................................................................38 Changing Row/Column Orientation ........................................................................39 Changing Column Position and Width ....................................................................41 Printing Table Views ...............................................................................................41 Saving Table Views .............................................................................................42 Using Charts to View Query Results ..........................................................................42 Creating Charts ...................................................................................................43 The Chart Window ..............................................................................................46 Changing the Appearance of Pie Charts .............................................................49 Changing the Appearance of Line Charts ..............................................................51 Changing the Appearance of Bar Charts ................................................................52 Using Logarithms ....................................................................................................54 Logging and Loading Data ..................................................................................54 Adding or Removing Chart Objects ........................................................................56 Changing Object Captions and Colors ...................................................................59 Creating Custom Colors .........................................................................................60 Adding a New Color ............................................................................................61 Removing a Color ...............................................................................................63 Creating and Using Color Files ...............................................................................63 Taking and Printing Snapshots (Print Preview) ......................................................64 Setting MIB Objects 66 Using the Editor 69 Viewing the Contents of a MIB Database ..................................................................71 Searching for Objects in a Database ......................................................................71 Editing a MIB Database ..........................................................................................72 Selecting the Target Database ............................................................................73 Selecting a Source MIB File to Import .................................................................74 Importing the Source File ...........................................................................................77 Deleting a MIB from a Database ................................................................................77 Creating a New MIB Database ...................................................................................78 Loading a New Database into the Browser ................................................................79 Viewing the Devices List 81 Deleting a Device .......................................................................................................82 JMibTools Page 5 Con t en ts C o n t e nt s Viewing MIB Details ...................................................................................................82 MIB Object Definitions ............................................................................................85 Setting JMib Tools Preferences 87 Index 90 JMibTools Page 6 Introduction This section provides a brief introduction to the basic organization of JMib Tools. JMib Tools Overview JMib Tools is a suite of applications that lets you access and manage any SNMP-compliant device through its Management Information Bases (MIBs). A MIB is a database maintained by the device that stores all its known management information. Each individual element of information in the MIB is termed an object. An information database isolated at the device, however, is useless if there is no means of communicating that information between the device and remote management. That communication is accomplished by means of an SNMP agent, which understands how to retrieve information from and store information to a MIB. The JMib Tools application incorporates its own database of MIBs supported by devices on your network, and uses this database as a knowledge base with which to communicate with your network devices. As a simple analogy, think of a network device as knowing a specific language. The JMib Tools database stores the syntax and vocabulary of that language, and the application and the device can then communicate (via the SNMP management protocol) to share or change the information stored in the device’s MIBs. JMib Tools provides a default database known as “TheWorld”. The JMib Tools application also has the ability to query the MIB objects on your network devices directly using an object identifier (see Object Identifiers on Page 8). This function allows you to retrieve information about a MIB object without having to import the entire MIB into the Jmib Tools database. JMibTools Page 7 Int rod uc tion J Mi b T oo l s O v e r v i ew How a MIB is Organized Because networking devices made by a variety of manufacturers must all be able to communicate with one another, the International Standards Organization requires that each network device organize its management information according to a pre-defined tree format. This tree structure branches out into several subtrees, with each subtree organized into branches (groups of related information) and leaves (the individual pieces of information, or objects). The Internet subtree is administered by the Internet Assigned Numbers Authority (IANA) and is designed to identify SNMP manageable agents. Object Identifiers Each layer of this tree is numerically encoded, so that each branch (group) and leaf (object) is identified by a unique number known as an Object Identifier (OID). This identifier is a path to the information stored as the object’s value, and provides the means by which the SNMP agent is able to locate the object in a device’s MIB. An ASCII name is also assigned to each branch or OID, for convenience in identifying a management object. MIB II is a standard MIB defined by RFC1213. This MIB is stored on the Management branch of the Internet subtree. The following example shows the numeric identification for the MIB II object ipForwarding. Each branch is associated with a specific number. numeric OID: 1. 3. 6. 1. 2. 1. 4. 1 ASCII string: iso /org /dod /internet /mgmt /mib-2 /ip /ipForwarding Figure 1, below, displays how this sample MIB II object fits into the Internet tree. The JMib Tools uses folders and leaf icons to show subtrees, branches and objects within a MIB. Each folder (subtree or JMibTools Page 8 Int rod uc tion J Mi b T oo l s O v e r v i ew branch) in the display indicates that more objects are contained in that level of the tree structure. Individual objects are identified by leaf icons. 1.3.6.1 .2 .1 .4 .1 Figure 1: A Sample OID in the Internet Tree In addition, some objects may occur multiple times for a single device. Objects of this type are called tabular objects, since they reside in tables. Each occurrence of a tabular object is called an instance, and each instance is also numerically encoded. For example, if you were querying a two-port bridge’s interface table, there would be two instances (values) returned for each leaf object in the table (one for each port), and each instance would have a unique instance value appended to the object’s OID. For more information on accessing table information, see Using Tables to View Query Results on Page 38. Enterprise MIBs Many devices are supported by standard MIBs like MIB II. However, some vendors also use proprietary MIBs to support their devices. The Enterprise branch of the Internet subtree is used to store proprietary MIBs. Private vendors can apply to IANA to be assigned a branch of the Enterprises subtree for storing MIBs specific to their products. When a vendor does this, they receive their own unique number identifying their specific branch of the Enterprise subtree. JMibTools Page 9 Int rod uc tion J Mi b T oo l s O v e r v i ew For example, Cisco devices use two kinds of management information, or MIBs: IETF standard MIBs, which appear under the iso—>org—>dod— >internet—>mgmt (or 1.3.6.1.2) branch of the MIB tree; and Cisco proprietary MIBs, which are registered under the iso—>org—>dod— >internet—> private—>enterprises (or 1.3.6.1.4.9) subtree. The numeric identifier assigned to the Cisco branch of the enterprises subtree is 9; therefore, each Cisco-proprietary piece of management information will be preceded by the OID string of iso—>org—>dod—>internet— >private—>enterprises—>cisco or 1.3.6.1.4.1.9. If an enterprise specific Cisco MIB were imported into the database used by the JMib Tools, it would be stored within the Enterprises folder to correspond with the Enterprise subtree. For more information on importing vendor specific MIBs into theWorld database, see Using the Editor on Page 69. For further information about MIBs and the Structure of Management Information (SMI) tree, refer to the following resources: The Simple Book, An Introduction to Management of TCP/IP-based Internets, by Marshall Rose (1994, Prentice-Hall, Inc.) Managing Internetworks with SNMP, Mark Miller (1989, M&T Publishing, Inc.) JMibTools Page 10 The JMib Tools Interface This section provides an introduction to the functionality of JMib Tools, and access information for this application. In order to successfully communicate with your intelligent devices (via the language of SNMP), JMib Tools uses its own database of MIB information. The OIDs, ASCII names, and other technical information stored in this database allow you to easily search for and select the objects whose information you want to view or change. JMibTools provides you with a starting database (called “The World”) which provides a compilation many IETF standard MIBs. This default database gives JMibTools the ability to query and set (as appropriate) objects from the standard MIBs resident in your devices. You use the Browser tool to both query and set objects in your intelligent devices. See Using the Browser on Page 18. If you wish to use JMibTools to manage devices that are supported by proprietary MIBs, you can either add the appropriate proprietary MIBs to the default database, or create additional databases containing any combination of standard and proprietary MIBs that you want. You can also remove MIB information from the default database or from any database you have created. You use the Editor tool to create and edit databases of MIB information. See Using the Editor on Page 69, for more information. In addition, JMib Tools also allows you to retrieve the value of MIB objects from your network devices even if the MIBs do not exist in the JMib Tools database. To do this, you use an OID value to query a MIB object present in a device on your network. You have the option of retrieving information for a specific OID instance or an entire table of values. JMib Tools also provides the added convenience of storing a list of the devices you have contacted via the Browser. This list, along with some window status and preferences information, is stored in a serialization (.ser) file in your home directory. When you exit JMib Tools, this file will JMibTools Page 11 The J M ib Too ls I nte rf a c e L au n c hi n g J M ib T oo l s be saved and then automatically loaded the next time you launch JMib Tools. Launching JMib Tools JMib Tools can be launched either from the SpectroGRAPH interface or from the command line. Launching JMib Tools from the Command Line It is not necessary to start the SpectroSERVER or SpectroGRAPH before launching JMib Tools from the command line. In the Windows environment, type: \JMibTools\mibtools.bat In the Solaris environment, type: /JMibTools/mibtools Launching JMib Tools from SpectroGRAPH To access the JMib Tools from SpectroGRAPH, you must first start the SpectroSERVER and then start SpectroGRAPH. From the Topology view: Select View —>Icon Subviews —> Utilities —> MIB Tools. or Select Tools —> MIB Tools. JMibTools Page 12 The J M ib Too ls I nte rf a c e L au n c hi n g J M ib T oo l s Once you have launched JMib Tools, the JMib Tools window, Figure 2, will appear. Figure 2: The JMib Tools Window You can resize the window to suit your specific needs. Just click and hold the left mouse button on the border of the window, then drag the mouse until the window is the desired size. JMibTools Page 13 The J M ib Too ls I nte rf a c e B as i c F ea tu r e s o f J M ib Too l s Basic Features of JMib Tools JMib Tools contains several applications (described below), each of which is readily accessed by clicking on the appropriate tab in the JMib Tools window. Browser The Browser is a graphical interface that lets you query any SNMP device on your network and examine its supported MIBs. If the MIB has been imported into the JMib tools database, you can retrieve the value of any MIB object and set the value of any writable MIB object in the imported MIB. If you are querying a MIB object whose MIB does not exist in the JMib Tools database, you can retrieve the value of the MIB object, but you cannot set the value. The MIB information available in the JMib Tools database is visually structured into a tree format, similar to a directory tree. Using the mouse, you can scroll through the tree and click on folder icons to open the tree layer of interest. To quickly shift focus from one area of the MIB tree to another, you can use the Browser’s built in Radar View (Figure 5). You can use the appropriate Windows or Solaris keyboard shortcuts to cut, copy or paste data to and from the Device, Community String, and Search text fields in the Browser. The Browser tabbed page is displayed by default when the JMib Tools application is launched (as illustrated in Figure 2). If you have launched the application from within a Device View, the selected device will be contacted automatically (as long as it is a device with an IP address). Note: Note: JMibTools Your devices may support certain MIB objects or groups of MIB objects that are not included in the JMib Tools database you received. These MIBs are available electronically, and can be added to the default database or to a new database via the Editor tool. See About TheWorld Database on Page 17, Using the Editor on Page 69. Page 14 The J M ib Too ls I nte rf a c e B as i c F ea tu r e s o f J M ib Too l s Editor The Editor allows you to manipulate the default MIB database (“TheWorld”) provided with JMib Tools. You can also create your own additional databases of MIB information by importing different or updated MIBs into any selected database. Devices When you successfully contact a device via the Browser, its device information is automatically stored in the currently-active serialization (.ser) file. The Devices tabbed page provides a complete listing of all devices entered in the .ser file, and allows you to sort the list by device name, IP address, MAC address, device type, or description. You can also delete devices from the file via this window. If you have launched the application from within a Device View, the selected device will automatically be contacted and added to the device list in the .ser file. You can also delete any items from the device table by highlighting the desired item and pressing delete. Details The Details tabbed page provides detailed technical information about the MIB object currently selected in the Browser page. Information displayed in the Details window automatically changes as you select new branches and/or objects in the Browser window. You can even detach the Details page from the main JMib Tools window so that you can view both the MIB tree display and the associated detail simultaneously. Preferences The Preferences tabbed page allows you to set some display and polling parameters. These parameters are stored in the serialization (.ser) file when you exit JMib Tools. The next time you launch JMib Tools, the .ser file last in use will be automatically loaded and the preferences stored there will be in effect. JMibTools Page 15 The J M ib Too ls I nte rf a c e B as i c F ea tu r e s o f J M ib Too l s File Menu Option Exit Click on this menu option to exit JMib Tools from any of the applications. View Menu Option View Compiled Mib List Click on this menu option to view the available list of Mibs that you can view. Help Menu Option Online Manuals Click on this menu option to view the contents of the JMib Tools guide (9031426). About JMib Tools Click on this menu option to view the basic information about JMib Tools version number and OS descriptions. About Serialization (.ser) Files When you launch the JMib Tools application for the first time, the JMib Tools window will be empty, no devices will appear in the Devices tabbed page, preferences will be set to their default values, and the default MIB database (“TheWorld”) will be loaded. As you successfully contact devices via the Browser window, set JMib Tools preferences, or change the position or size of the JMib Tools window, that information is stored in a serialization, or .ser, file in your home directory. When you exit JMib Tools, changes to this .ser file are automatically saved. The next time you launch JMib Tools, the .ser file last in use will automatically be loaded. JMibTools Page 16 The J M ib Too ls I nte rf a c e B as i c F ea tu r e s o f J M ib Too l s Note: Note: If you launch the JMib Tools application from within a Device View, the selected device will automatically be contacted and added to the device list of the .ser file. To remove the device, use the Delete option in the Devices tabbed page. About TheWorld Database JMib Tools maintains its own database of MIB information. A default database entitled “TheWorld” includes most IETF standard MIBs. You can use this database as is, or you can edit it to incorporate new or updated MIBs. You can also use the Editor to import proprietary MIBs, so that the Browser can successfully communicate with your devices. You can also create additional MIB databases. You create and edit MIB databases, as well as select the MIB database you wish to use, via the Editor tabbed page. JMibTools Page 17 Us in g th e Br ows e r B as i c F ea tu r e s o f J M ib Too l s Using the Browser With the Browser, you can examine the MIBs supported by an active device on your network and perform SNMP Get, Get Next, and Set requests on the MIB objects. The following illustration displays the elements of the Browser window. Figure 3: .Browser Window Overview System Name and Device fields let you select a device from the device database. Contact Button and Status Indicator. The Find Button The Radar Panel Status Bar The Query button and the Build Request button allow you to retrieve MIB information. JMibTools Use the Graph button to reformat your query results into pie, line, or bar charts. Set Button Page 18 Us in g th e Br ows e r C on t ac t in g a D ev i c e The Browser window has three main areas of functionality: • Contacting a device on the network. • Browsing the MIBs stored in the JMib Tools database. • Querying and setting values for a network device’s MIB objects. Contacting a Device You can select the device you want to contact from the System Name or Device drop-down lists. To contact a device not currently listed, you must use the Device field. You can also use the Device field to perform a discovery of all devices on a subnet, then select which device or devices you wish to add to the current device database. Clicking the Contact button allows you to initiate contact when a new device is selected or retry contact after a failed device poll. You may stop an attempt to contact a device by clicking the Stop button. Contact status is shown by the traffic light indicator. Note: Note: Note: Note: If JMib Tools is launched from a host outside the CORBA broadcast domain and fails to establish SNMP communication with a device, you must configure the CORBA location/naming service agents as described in the SPECTRUM Installation Guide (0675). A user with read-only privileges has access only to the default community string “public” when specifying criteria to contact a device in the JMib Tools Browser. To select a device from the current device database: 1 Click on the arrow located to the right of the System Name and select the appropriate system name. Press Enter or click on the Contact button to initiate contact. JMibTools Page 19 Us in g th e Br ows e r C on t ac t in g a D ev i c e 2 Click on the arrow located to the right of the Device field. Select the device you wish to contact, and release. Press Enter or click on the Contact button to initiate contact. 3 If the contact is unsuccessful, you might need to change the community name used to contact the device; to do so, click in the Community String field and enter a new community name. Click on the Contact button to initiate contact. To add a new device to the current device database: 1 Click in the Device field; delete any address already displayed, then enter either the IP address or host name of the device you wish to contact. 2 Click in the Community String field, and enter the community name you wish to use to contact the device. The permissions assigned to the community name you enter here will determine the level of access you have to the device’s MIB information, so be sure to use a community name with the appropriate level of access. 3 Press Enter or click on the Contact button. Contact will be initiated. The Browser issues an SNMP poll to the device, using the community name you have associated with the device (by default, “public”). You can see the status of the connection attempt, both via the traffic light indicator in the top right of the window, and via the Status bar at the bottom of the window: The Browser is attempting to establish SNMP contact with the selected device. The traffic light will display yellow; the Status bar will read “Attempting to establish SNMP communications....” The connection has been made. The Status bar will briefly display “Successfully established SNMP communication.” and the traffic light will display green. The connection attempt has failed, either because the device is unreachable, because an invalid community name was used, or because the SNMP service is unavailable. The Status bar displays “Failed to establish SNMP communication.”; the traffic light displays red. JMibTools Page 20 Us in g th e Br ows e r C on t ac t in g a D ev i c e If for some reason contact with the device fails, you can re-send a device poll by clicking on the Contact button to the left of the traffic light indicator. Contacting All Devices on a Subnet You can also use the Device field to perform a mini-discovery of all devices on a subnet that is defined by the third byte of the IP address. To do this, insert a wildcard character (*) in place of the fourth byte of the address. To do so: 1 Click in the Device field, and delete any address already displayed. Then, enter the three-byte subnet address followed by a wildcard character (*) in the fourth-byte position (e.g., 134.141.60.*). 2 Click in the Community String field, and enter the community name you wish to use to contact devices on the selected subnet. Remember, the permissions assigned to the community name you enter here will determine the level of access you have to the devices’ MIB information. Be sure to use a community name with the appropriate level of access. 3 Press Enter or click on the Contact button. Contact will be initiated, and the status bar will read “Waiting to hear from X devices.” 4 When the discovery is complete, the Select Devices window, Figure 4, will appear, with a list of all devices on the designated subnet which were successfully contacted. JMibTools Page 21 Us in g th e Br ows e r C on t ac t in g a D ev i c e Figure 4: The Select Devices Window Selected Devices 5 Click to select the device or devices you wish to add to the current device database file. Use ctrl-click or shift-click to select multiple devices, or select all the devices by clicking on the Select All button. The Select All button changes to an UnSelec… (Unselect All) button when you click on it. 6 Click Apply and the selected device or devices will be added to the current device database. Note that you have only one opportunity to select the discovered devices you wish to add; once you click Apply, the Select Devices window will close. Specifying Community Name Access to a Device SNMP community names are used to control management access to a device. The level of control that a managing entity has over the device corresponds to the access level provided by the community name used in a management request: Read Only, Read-Write, or Superuser. JMibTools Page 22 Us in g th e Br ows e r V i e wi n g M IB I n fo r ma t io n S t or e d i n t he J M i b To ol s Da ta b as e Note: Note: Since it is possible for devices to employ a component-based MIB architecture, and since some MIB components have unique community names (that is, different from any other component on the same device), it may in some cases be necessary to use different community names to access different information on a single device. By default, all SNMP queries issued by Browser use the community name currently displayed in the Community String field. Note: Note: A user with read-only privileges has access to the default community string “public” only. To issue queries with a different community name: 1 Click on the down arrow to the right of the Community String field. A list box will appear, displaying all community names currently associated with the device in the JMib Tools database. 2 Click to select the community name you wish to use, or enter the name in the field. Press Enter or click on the Contact button. Contact will be initiated using the selected community name. Viewing MIB Information Stored in the JMib Tools Database Once you have successfully contacted a device, you will be able to browse its supported MIBs via the MIB Tree display in the middle of the Browser window. JMibTools Page 23 Convenient features such as the Radar View allow you to rapidly orient the MIB Tree display to the area of interest. Find and List functions allow you to direct your exploration to a specific MIB object name. The MIB Tree Display In the center of the Browser window is the MIB Tree display — a graphical directory of the selected MIB database. The default MIB database (“TheWorld”) is a set of IETF standard MIBs and provides the roadmap that lets you explore a selected device’s MIB information. Note: Note: To view a list of the MIBs contained in the selected MIB database, click the right mouse button anywhere in the MIB Tree display. Select View Compiled MIB List from the resulting menu. A window listing all the MIBs contained in the database will appear. Like a file directory tree, the MIB Tree is represented by a series of collapsible and expandable folders, with the individual MIB Objects represented by leaves: Here, the top level of the MIB Tree is shown. When you click on a level of a tree, it is highlighted to show that it is selected. Each branch of the tree is indicated by a folder. Note: Note: JMibTools The folders and branches that are displayed will reflect the MIB information that has been included in the MIB database that is currently loaded. For more information on editing the default MIB database, creating your own databases, and selecting a MIB database, see Using the Editor on Page 69. Page 24 Us in g th e Br ows e r V i e wi n g M IB I n fo r ma t io n S t or e d i n t he J M i b To ol s Da ta b as e Here, the internet –> mgmt branch has been opened. Its folder is marked with a minus sign (-) to denote that it has been expanded. The mib-2 folder below is marked with a plus sign (+), indicating that it is expandable to reveal more information, but has not yet been opened. Here, an unmarked folder indicates an empty tree branch that is not expandable. The folder will be grayed out to further indicate that no information can be accessed from it. Finally, here the Tree has been expanded to reveal a Management Object (leaf), specifically the internet —> mgmt —> mib-2 —> system —> sysDescr object. Select a MIB branch or object by clicking on its corresponding folder or leaf icon. After you have selected a folder, a small circle appears to the left of the folder. To open a folder and display its contents you can either double-click on the folder, or single-click on the circle; double or singleclick again to close the folder. The MIB tree display will span as each MIB branch is opened, to keep the display focused on the currently selected objects. To shift the display to another section of the Tree, you can use the scroll bars below and to the right of the MIB Tree display, or use the Radar View (described in The Radar View (Page 26)). You can also resize the MIB tree display window to show more information. Just click and hold on the bottom border of the window, then drag the mouse till the window is the desired size. Notice that the currently selected branch or object is identified immediately above the MIB Tree display in the OID text field by its ASCII textual description (if available) and its numerically encoded Object Identifier. Note: Note: JMibTools For more detailed information about a MIB object or objects, click the Details tab to display the MIB Details page; for more information, see Viewing MIB Details on Page 82. Page 25 Us in g th e Br ows e r V i e wi n g M IB I n fo r ma t io n S t or e d i n t he J M i b To ol s Da ta b as e The Radar View To the immediate left of the MIB Tree display, a second display area — the Radar View — reveals a scaled-down version of the Tree. You can use this to quickly orient yourself in the MIB Tree display. As you collapse or expand MIB branches, you will notice that the Radar View reshapes itself accordingly. The portion of the tree that is currently shown in the MIB Tree display panel is represented by a boundary box in the Radar View, as shown in Figure 5, below. Boundary of MIB Tree Display Area Radar View Display MIB Tree Display Figure 5: The Radar View and MIB Tree Displays To quickly orient the MIB Tree Display panel to display a new portion of the MIB Tree: 1 Click and hold the left mouse button within the boundary box in the Radar View. 2 Drag the mouse to shift the boundary box across the scaled-down tree in the Radar View to the approximate location of interest in the MIB Tree. Note that the MIB Tree Display will scroll correspondingly. The Find Button The Browser’s Find feature allows you to search the JMib Tools database for a specific object’s ASCII description or encoded OID string. By using JMibTools Page 26 Us in g th e Br ows e r V i e wi n g M IB I n fo r ma t io n S t or e d i n t he J M i b To ol s Da ta b as e “match-any” characters when performing a search, you can generate a list of multiple objects which meet your search criteria. Note: Note: Remember, only the MIB information stored in the MIB database will be searched; if your current MIB database contains only a subset of the default “TheWorld” database, a Find operation may not locate all the objects you expect. To search for an object based on its specific ASCII descriptor or OID string: 1 In the OID text field above the MIB Tree display, type in the ASCII descriptor or encoded OID string. Note: Note: A search is first performed using the case specified by the search criteria string. If a match is not found, a case insensitive search is automatically performed. If more than one result is found, all results are displayed in the Find Results List box. The search field uses the * character as a wildcard. The * character represents any series of ASCII characters. For example, entering if* and pressing enter would find all MIB objects whose names begin with if. This search is also case insensitive. All results are displayed in the Find Results List box. Find button OID Text Field Figure 6: The Find Button and OID Text Field JMibTools Page 27 Us in g th e Br ows e r V i e wi n g M IB I n fo r ma t io n S t or e d i n t he J M i b To ol s Da ta b as e 2 Click on the Find button or press Enter. If the specified object is in the current MIB database, it will be immediately selected in the MIB Tree display, and its ASCII descriptor and OID string will appear in the OID text field. The Radar View will also adjust to reflect the portion of the MIB Tree which is displayed. 3 If the specified object was not found, the Status bar will turn red and display a message informing you that the search failed. To search for multiple objects using a match-any character: 1 In the OID text field, type in the portion of the ASCII descriptor which you want to search with, followed by an asterisk (*). The match-any * acts as a substitute for the rest of the descriptor. a For example, to search the MIB for all objects in the System group, you would type sys* in the text field. 2 Click on the Find button or press Enter. A Find Result List window will appear listing all objects that met the search criteria. The last MIB object listed in the window will be selected in the MIB Tree display, and its ASCII descriptor and OID string will appear in the OID text field. 3 You can resize the window or use the scroll bars to view the entire list. Figure 7 below displays the results of a search based on sys*. Figure 7: Example of a Match-any Search (sys*) JMibTools Page 28 Us in g th e Br ows e r Q ue r y i ng MI B O b j ec t s o n N et wo r k D ev i c e s 4 Click on any object in the search list, and that object will be displayed in the MIB Tree display with its ASCII descriptor and OID string in the OID text field. Querying MIB Objects on Network Devices To find the current value set at the selected device for a specific MIB object or set of objects, you must query the device for the information. A query consists of an SNMP Get (to retrieve a specific piece of management information) or SNMP Get Next (to traverse a portion of the tree and retrieve all its information) command issued by the Browser to the contacted device. When you query a device, it returns a value for every instance of the specified object(s). The results appear in a scrollable panel below the MIB Tree display. There are two ways to query MIB objects from the Browser. You can use the Query button to query the MIB object or branch of the MIB tree specified in the OID Text field. If you query a MIB in this way, you retrieve all applicable values and have the ability to change the value of a writable object. In order to query a network device’s MIB in this way, the MIB must exist in the JMib Tools database. You can also query a MIB object not included in the JMib Tools database using the Build Request button. The button brings up a dialog box that allows you to query MIB objects directly using an object identifier. Note: Note: Remember, for devices which support the original versions of the component MIB architecture, the level of community name access you are using to contact the device may limit the information that is returned from a query. Querying a Device with the Query Button 1 Make sure you have successfully contacted the device that you wish to query (see Contacting a Device on Page 19). JMibTools Page 29 2 In the MIB Tree Display, scroll through the MIB and select one of the following: b Select the leaf (e.g., ) for a particular object if you want to retrieve an individual piece of management information. or c Select a Branch (e.g., ) or Table (e.g., ) folder, if you want to retrieve information for all objects within that portion of the MIB. The currently selected object identifier (and ASCII name, if available) will appear in the OID text field. 3 Click on the Query button. All values returned from the specified leaf object or from all objects within a folder will display in the Query Results panel (see Figure 8). In the Query Results panel, dark green leaf icons indicate objects which are not writable (and therefore cannot be set); light green leaves indicate writable objects that can be set. Figure 8: Sample Query Results JMibTools Page 30 Us in g th e Br ows e r Q ue r y i ng MI B O b j ec t s o n N et wo r k D ev i c e s Note that the Status bar at the bottom of the window will keep you informed about the progress of your query — reflecting when the query is initiated, the current state of SNMP communications between the Browser and the queried device (including SNMP time-outs and subsequent Browser re-polls), any Get Next failures, and the successful conclusion of a query. To the right of the Query Results panel you can see an active count of the number of objects being found in a multiple object query. Stopping a Query While a query is in process, the Query button becomes a Stop button. You can halt a query in process by clicking on the Stop button. Any pending SNMP Gets will be cancelled. Note that all values returned before the query was stopped will remain in the Query Results panel. Note, too, that the Stop button will only be active while a query is in progress. Querying a Device with the Build Request Button 1 Make sure you have successfully contacted the device that you wish to query (see Contacting a Device on Page 19). 2 Click on the Build Request button to bring up the Build SNMP Request dialog box. 3 Type the OID of the MIB object you would like to query in the OID text box. If you would like to retrieve an instance value, specify the instance in the Instance text box, and choose the Get request type. If JMibTools Page 31 Us in g th e Br ows e r Q ue r y i ng MI B O b j ec t s o n N et wo r k D ev i c e s you would like to retrieve the entire table, leave the Instance box blank, and choose the Get Next request type. 4 Click the Query button. 5 The results will display in the Query Results panel. JMibTools Page 32 Vie w in g a nd For ma tti ng Que ry Re su lts Q ue r y i ng MI B O b j ec t s o n N et wo r k D ev i c e s Viewing and Formatting Query Results This section discusses the various data from the query can be formatted and displayed. The Query Results panel, shown in Figure 8, contains all information returned by the selected device in response to a query initiated on a MIB branch or leaf. Each entry in the Query Results panel is identified by the following: Object The ASCII name of a queried object. Each object is also displayed with a leaf icon: dark green for objects which are not writable and light green for objects which are. Instance The specific occurrence of the object to which the returned value pertains. Some objects may have more than one occurrence, or instance, on the device. For example, a sysContact query returns a single value — the designated contact person for system information or service; an ifIndex query will return a value for each interface index discovered on the selected device. An instance value of zero indicates that the selected object can have only a single instance; an instance value greater than zero indicates that the object is part of a table, and may have multiple instances. Type The structure of the data in the returned value. A MIB Object may have one of the following types: The following four primitive data types are the building blocks of all returned values: JMibTools Page 33 Vie w in g a nd For ma tti ng Que ry Re su lts Q ue r y i ng MI B O b j ec t s o n N et wo r k D ev i c e s INTEGER A data type taking a cardinal number as its value. The number may have a symbolic name associated with it. For example, an interface’s administrative status – ifAdminStatus – returns as an integer representing one of three administrative states: up(1), down(2), or testing(3). OCTET STRING A data type taking zero or more octets as its value. Each byte in the octet string can have a value from 0 to 255. For example, a device name would be encoded in an octet string. OBJECT ID A data type referring to an authoritatively named object in the MIB Tree. For example, sysObjectID returns each vendor’s authoritative identification of their manageable devices, as recorded in their branch of the Internet MIB (internet –> private –> enterprises). NULL A data type acting as a placeholder for future use. This data type is not currently used in Internet management. The following constructor types are an arrangement of data created by structuring individual data elements: SEQUENCE A data type denoting an ordered list of zero or more elements which are other ASN.1 types; analogous to a structure in programming language. For example, ifEntry is a sequence that contains data elements about an individual interface on a device – ifIndex, ifDescr, ifType, and so forth. SEQUENCE OF A data type denoting an ordered list of zero or more type elements which all share the same ASN.1 types; analogous to a dynamic array in programming language. For example, the ifTable (interface table) is a sequential list of the ifEntry data elements returned by all interfaces on the device. For convenience, the structure of management information has Defined data types to be used for network management. Below is a partial list of these. JMibTools Page 34 Vie w in g a nd For ma tti ng Que ry Re su lts Re s iz i n g t he Q u e r y R es u l ts F i el d s IPADDRESS A data type representing an IP address — a four-byte dotted decimal value, with each byte having a value in the range of 0-255. COUNTER A data type representing a non-negative integer, which increases sequentially until it reaches a maximum value (not to exceed 232-1), then it returns to zero. This data type is frequently used to measure statistical values, such as bytes processed by a device since start-up. GAUGE A data type representing a non-negative integer, which may increase or decrease, but latches at a maximum value (not to exceed 232-1). This would be used to measure both current and peak network traffic rate, for example. TIMETICKS A data type representing a non-negative integer, which counts the time in hundredths of a second (not to exceed 232-1) since some epoch (e.g., time since device powerup). OPAQUE A data type representing an arbitrary encoding. Value The current data for the given instance of an object that is stored by the managed device. For more detailed information about a MIB object, you can use the Details page (see Viewing MIB Details on Page 82). The Details page provides the complete MIB definition for each object present in the selected MIB database. Resizing the Query Results Fields If the information returned from a device query is too wide to fit in the current field size, you can resize each field width in the Query Results panel to suit your needs. To do so: 1 With the cursor placed directly on the vertical line separating a Query Results panel field (Object, Instance, Type, or Value), click and hold the left mouse button. (When the line is successfully selected, the arrow cursor will change to a resizing cursor). JMibTools Page 35 Vie w in g a nd For ma tti ng Que ry Re su lts Cl e ar i n g Q u er y Re s u lt s 2 Drag the line to the left or right to adjust the field to the desired size. See the example below. Click and hold the mouse on the vertical line separating a field. (The arrow cursor will change to a resize cursor.) Drag the mouse until the field is the desired width. Figure 9: Resizing a Query Results Field Clearing Query Results The Auto Clear option located to the right of the Query Results panel determines how query results are cleared. If AutoClear is not selected, the results of each query accumulate in the Query Results panel until you remove all responses by clicking on the Clear button. If AutoClear is selected, the results of each query will automatically be erased each time you perform a new query operation. Printing Query Results To print the MIB information which is currently displayed in the Query Results panel: JMibTools Page 36 Vie w in g a nd For ma tti ng Que ry Re su lts S av i n g Q u er y Re s u lt s 1 Click the right mouse button anywhere in the Query Results panel. In the resulting menu, select Print Table. 2 A standard print window appears allowing you to select and set up any printer connected to your workstation, and print the Query Results panel. Saving Query Results You can also save the MIB information which is currently displayed in the Query Results panel: 1 Click the right mouse button anywhere in the Query Results panel. In the resulting menu, select Save Table as Data File. The Save as Data File window, Figure 10, will appear. Use this field to select the folder. Save as Data File Use this field to enter the file name. Figure 10: Save as Data File Window JMibTools Page 37 Vie w in g a nd For ma tti ng Que ry Re su lts U s i ng Tab l e s to Vi e w Q u er y Re s u lt s 2 Select the folder and file name where you want the query results saved. 3 Click the Save button. The Save as Data File window closes. Using Tables to View Query Results Some objects may occur multiple times for a single device. These objects reside in tables. Each occurrence of a tabular object is called an instance, and each instance is numbered. If the results of your query are in table form with multiple objects and instances, a folder icon labeled with a T appears. Using this icon, you can access a table view where you can easily view the table information. You can also print the table, or save the table to a data file. To access the table view: 1 In the Query Results panel, double-click the folder icon of the table you wish to view. Double-click on the folder icon labeled with a T to access the Table View. Figure 11: 2 Accessing the Table View The Table View, Figure 12, will appear. JMibTools Page 38 Vie w in g a nd For ma tti ng Que ry Re su lts U s i ng Tab l e s to Vi e w Q u er y Re s u lt s If Table Figure 12: The Table View You can resize the window to suit your specific needs. Just click and hold the left mouse button on the border of the window, then drag the mouse until the window is the desired size. If not all of the table information can be viewed in the window, use the scroll bars at the side and bottom of the window to view the information. Note: Note: You can change the value of a writable object in a device’s MIB by performing an SNMP set. However, you cannot perform a Set while in a table view. For more information on how to set a MIB object, refer to Setting MIB Objects on Page 66. Changing Row/Column Orientation The Table View opens in a default format with the objects listed across the top of the table as columns, and instances listed down the side as rows. You can change the row/column orientation using a menu accessed with the right mouse button anywhere in the Table View. JMibTools Page 39 Vie w in g a nd For ma tti ng Que ry Re su lts U s i ng Tab l e s to Vi e w Q u er y Re s u lt s Depending on the number of objects versus the number of instances, each column/row orientation has its advantages. For example, in Figure 12, there are more objects than instances and the objects are listed across the top of the table. You may find it easier to view that table with the opposite row/column orientation as shown in Figure 13. To change the Row/Column Orientation: 1 Click the right mouse button anywhere in the Table View. In the resulting menu, select Switch Row/Column Orientation. 2 The row/column orientation will change to the opposite of the orientation previously in use. Table IfIf Table If Table Figure 13: Row/Column Orientation JMibTools Page 40 Vie w in g a nd For ma tti ng Que ry Re su lts U s i ng Tab l e s to Vi e w Q u er y Re s u lt s Note: Note: In the default orientation with objects listed across the top of the table, you can access tooltips describing the object type (e.g. Type: integer) by resting the mouse on the object name. Changing Column Position and Width You can rearrange the order of the columns (in either orientation) if you would like to group or position the columns a certain way in your table. 1 Click on the column you would like to reposition, and drag the column to the desired location. You can change the width of the individual columns: 1 With the mouse cursor placed directly on the vertical line separating column headings, click and hold the left mouse button. (When the line is successfully selected, the arrow cursor will change to a resizing cursor). 2 Drag the line to the left or right to adjust the column to the desired size. Printing Table Views To print the Table View: 1 Click the right mouse button anywhere in the Table View. In the resulting menu, select Print Table. 2 A standard print window appears allowing you to select and set up any printer connected to your workstation, and print the table. JMibTools Page 41 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Note: Note: Choosing the Print to File option in your print driver’s dialog box will not result in saving the table data to a readable text file. Instead the document is saved as a .Prn or a .Ps file with printer formatting, such as font selection and style information. To save the data to a text file, use the Save Table as Data File option explained below. Saving Table Views You can also save the information displayed in a Table View to a data file: 1 Click the right mouse button anywhere in the Table View. In the resulting menu, select Save Table as Data File. The Save as Data File window will appear. 2 Select the folder and file name where you want the table data saved. 3 Click the Save button. The Save as Data File window closes. Using Charts to View Query Results You can convert query results into pie, line, and bar charts using the JMib Tools Chart Manager Application. By using charts, you can compare relative data such as frame counts or error statistics in an easy-to-view format. You can also start and stop the polling of values so that you can monitor the change in values over a period of time. Note: Note: Only objects with a type of counter or integer can be used to start the Chart Manager Application. To start the Chart Manager application: JMibTools Page 42 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s 1 Select an object, branch, or table from the MIB Tree Display panel and perform a query by pressing the Query button. 2 In the Query Results panel, select the objects you would like to view using the Chart Manager application. (Use ctrl-click or shift-click to select multiple objects.) You can select a maximum of 30 objects per pie chart, 10 objects per line chart, and 20 objects per bar chart. The objects must have a type of counter or integer. 3 Press the Graph button to the right of the Query Results panel (see Figure 3). The Graph window (Figure 14) appears. Creating Charts Use the Graph window, Figure 14, to select the chart type (pie, line, or bar) you would like to create. JMibTools Page 43 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Graph Dialog Figure 14: Graph Window At the top of the window, there are several fields that provide information about the device being queried: the IP Address, Community String, and Protocol being used. There is also a Polling Rate field that allows you to set the polling rate for the device. In the middle of the window are three icons specifying the types of charts you can select: pie, line, or bar. Below the icons is an Attribute Count field that displays the number of objects selected. The bottom of the window has an object panel listing the selected OIDs, along with their instances and values. If necessary, use the scroll bars to view the complete list. JMibTools Page 44 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Note: Note: Remember, you can have a maximum of 30 objects per pie chart, 10 objects per line chart, and 20 objects per bar chart. A message box will inform you if you have selected too many objects for the type of chart you wish to create. You must return to the Browser, select the appropriate number of objects in the Query Results panel, and then click on the Graph button. To create a chart: 1 Enter the desired polling rate in seconds in the polling rate field. The valid range is 1 to 999; the default polling rate is 5 seconds. Press Enter. 2 Select the type of chart you wish to create (pie, line, or bar) by clicking on the appropriate icon. 3 Click on the OK button to create the chart. To close the window without creating a chart, click the Cancel button. To create additional charts: 1 Return to the Browser and select an object, branch, or table from the MIB Tree Display panel. Perform a query by clicking the Query button. 2 In the Query Results panel, select the objects you would like to view using the Chart Manager application. Remember, the objects must have a type of counter or integer. 3 Click the Graph button to the right of the Query Results panel. The Graph window appears allowing you to create another chart. JMibTools Page 45 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s The Chart Window The pie, line, or bar chart that you create appears in a Chart Window. Figure 15 shows a Chart Window that contains a pie chart. Details on the graphic are listed below the graphic. The The Canvas see Chart 0 below for details. Access a popup menu in the Desk Top. The Legend see below for details. The Table, see below for details. Start and stop the collection of chart data using the Start and Stop buttons. Figure 15: The Chart Window JMibTools Page 46 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s The chart window is composed of three internal windows called the Canvas, the Legend, and the Table. These internal windows can be moved, resized, maximized, and iconized within the frame of the chart window, as can the entire chart window itself. The desktop is the background on which the Canvas, Legend, and Table are displayed. The Canvas The Canvas displays the actual pie, line, or bar chart. You can manipulate the chart using a popup menu accessed by first clicking to activate the Canvas window, then clicking the right mouse button in the Canvas window. The Legend The Legend displays the name and instance (if any) of each object selected for charting along with a colored icon indicating the chart color used to display each object’s values. You can click on these icons to select or deselect the display of each object. When the Chart Window first opens, all the objects originally selected will be displayed by default. Select the Legend, click on a colored icon and notice that the rendering for that object is removed from the chart. Click on the icon again and the object will reappear. To see the OID for each object listed in the Legend, let the cursor rest on the object name and the OID will be displayed. The Table The table lists information about the objects displayed in the chart. It is composed of six columns: • • • • • • JMibTools Attribute lists the objects selected (with the Instance appended). OID lists the Object ID for each object. Now displays the current value for the object. Average displays the average value for the object for the duration of the chart’s polling history. Peak displays the peak value for the object for the duration of the chart’s polling history. DateofPeak displays the time and date of the peak value for the object. Page 47 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Note: Note: To resize the width of the table columns, click and hold the mouse on the vertical line separating each column. The arrow cursor will change to a resized cursor. Drag the mouse until the column is the desired size. There is an additional column that can be displayed for line and bar charts called Logarithmic Multipliers. You can determine whether this column will be displayed by selecting the Logarithm menu item in the Canvas popup menu. This option is fully explained in Using Logarithms. Chart Window Menu Bar A menu bar across the top of the chart window provides access to File, Attributes, History, and About menu selections. The selections on this menu bar are also available from a popup menu activated by clicking the right mouse button in the desktop of the chart. (The desktop is the background on which the Canvas, Legend, and Table are displayed). File Menu From the File menu, you can access the following selections: • Load from File allows you to load data from a specified file into a chart. The data must be in the format of a “Log to” file (i.e., a file previously created using the Log to File option). Refer to Logging and Loading Data on Page 54, for more information. • Log to File allows you to log chart data to a specified file. Attributes From the Attributes menu, you can add, remove, or modify a chart object: JMibTools • Add allows you to add an object to a chart. • Remove allows you to remove an object from a chart. • Remove All allows you to remove all objects from the chart. • Modify allows you to change the caption or color of an existing object. • Customize Colors allows you to add custom colors to the color scheme. Page 48 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s History The History menu allows you to control the object data: • Clear allows you to erase all the data for the objects while keeping the objects themselves intact. • Size allows you to set the size of the history buffer determining the amount of data that will be stored. The history size range is 1 to 600 data values; the default value is 100. When setting your history size you should consider the following three factors: the polling interval rate, the duration you want to poll, and the total number of data values you want to store. About The About menu has one selection: • About Java Charts displays the version of JDK (Java Development Kit) and JFC (Java Foundation Class) used to create the Chart application. After you have created a chart, you can start and stop the polling process and the collection of data by using the Start and Stop buttons located at the bottom of the Chart window. Changing the Appearance of Pie Charts Using a special popup menu, you can change the look of your pie chart to suit the data you are displaying. JMibTools Page 49 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Use this slider to adjust Pie Size. Click right button in the pie chart canvas to access this popup menu. Use this slider to adjust Pie Thickness. Use these sliders to adjust the placement of the Call Outs. Figure 16: Pie Chart In the pie chart canvas, click the right mouse button to access a popup menu. Click on the option you wish to select: JMibTools • 3D allows you to toggle between a 2-dimensional and 3-dimensional pie. • Pie Size displays a slider used to resize the pie. • Pie Thickness displays a slider used to change the thickness of a 3-dimensional pie. • Call Out displays a slider used to change the horizontal placement of the call outs. • Tail displays a slider used to change the vertical placement of the call outs. • History Date hides or displays the time and date when the pie chart was created. Page 50 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s • Slice Labels allows you to specify if your chart will have labels that display object values, names, or if the chart will have no labels at all. • Slice Calculation allows you to specify which value is displayed in the label: Now, Average, Peak, or Percentage. • Title allows you to change the title of the pie chart. • Print Preview creates a snapshot of the current pie chart that can be printed. For more information about snapshots, see Taking and Printing Snapshots (Print Preview) on Page 64. Changing the Appearance of Line Charts Using a special popup menu, you can change the look of your line chart to suit the data you are displaying. Use this slider to adjust the Strip Width of the line. Click the right mouse in the line chart canvas to access this popup menu. Use this scroll bar to view the line chart data history. Figure 17: Line Chart JMibTools Page 51 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s In the line chart canvas, click the right mouse button to access a popup menu. Click on the option you wish to select: • 3D allows you to toggle between a 2-dimensional and 3-dimensional line chart. • Strip Width displays a slider used to change the width of the line in a 3dimensional line chart. • Grid hides or shows the grid behind the line chart. • Tick Marks hides or shows tick marks along both axes. • Tick Values hides or shows the tick values along both axes. • Time Along X displays either the data numbers or the time elapsed along the X axis. • Title allows you to change the title of the line chart. • Print Preview creates a snapshot of the current pie chart that can be printed. For more information about snapshots, see Taking and Printing Snapshots (Print Preview) on Page 64. • X Axis allows you to change the X axis label, unit, and tick mark count. • Y Axis, allows you to change the Y axis label, unit, and tick mark count. • Logarithm allows you to plot the graph using Logarithms. (See Using Logarithms on Page 54, for more information.) Use the scroll bar at the bottom of the line chart canvas to shift your view of the data. Changing the Appearance of Bar Charts Using a special popup menu, you can change the look of your bar chart to suit the data you are displaying. JMibTools Page 52 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Click the right mouse in the bar chart canvas to access this popup menu. Use this slider to adjust the Bar Width. Use this scroll bar to view the bar chart data history. Figure 18: Bar Chart In the bar chart canvas, click the right mouse button to access a popup menu. Click on the option you wish to select: JMibTools • 3D allows you to toggle between a 2-dimensional and 3-dimensional bar chart. • Bar Width displays a slider used to change the width of the bar in a 3-dimensional bar chart. • Grid hides or shows the grid behind the bar chart. • Tick Marks hides or shows tick marks along both axes. • Tick Values hides or shows tick values along both axes. • Time Along X displays either the data numbers or the time elapsed along the X axis. • Title allows you to change the title of the bar chart. Page 53 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s • Print Preview creates a snapshot of the current bar chart that can be printed. For more information about snapshots, see Taking and Printing Snapshots (Print Preview) on Page 64. • X Axis allows you to change the X axis label and units. • Y Axis allows you to change the Y axis label, units, and tick mark count. • Logarithm allows you to plot the graph using Logarithms. (See Using Logarithms on Page 54, for more information.) Use the scroll bar at the bottom of the bar chart canvas to shift your view of the data. Using Logarithms In Line or Bar charts, when the values of two or more objects are so far apart that a comparison between them is difficult, Log Multipliers can be set for individual objects to shift the values up or down the Y axis, so that they become close enough to make a comparison. To access Log Multipliers: 1 In the Line or Bar Chart canvas, click the right mouse button to access the popup menu. Select Logarithm. 2 A yellow LogMultiplier column will appear in the Table. Click on the row for each object to access a drop-down list that allows you to specify the log multiplier you want. The multiplier 1.0 plots actual values and is the default log multiplier. 3 Select the desired multiplier. The current (Now) values of the object will be multiplied by the respective log multiplier. The new values will be reflected in the chart accordingly. Logging and Loading Data You can log data from a chart to a file and then reload that data into a chart at a later time. JMibTools Page 54 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s To log data to a file: 1 From the File menu in the Chart window, select Log to File. Note that this menu option will be grayed out if the Log From File check box is selected. The Log File Save window, Figure 19, appears. Log Files Figure 19: The Log File Save Window 2 Select the folder and file name where you want to log the data. The file name extension must be “.log”. 3 Click the Save button. The Log File Save window closes and a message appears stating that data from the chart is being logged to the selected file. 4 Use the Start and Stop buttons in the Chart window to collect the data. When you have finished logging data to the file, return to the JMibTools Page 55 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s File menu and click to deselect Log to File, or when you quit the chart it will be automatically deselected. You can import data from a log file into a pie, line, or bar chart. The data must be in the format of a “Log to” file (i.e., a file previously created using the Log to File option). To import data: 1 From the File menu in the Chart window, select Load From File. Note that this menu option will be grayed out if the Log to File check box is selected. The Log File Open window (similar to the Log File Save window, Figure 19), appears. 2 Select the folder and file name of the data file you want to load. The file name extension must be “.log”. 3 Click the Open button. The window closes and a message appears stating that data is being loaded from the selected file. 4 The data will be loaded into the chart. You can return to the File menu and click to deselect the check box Load From File, or when you quit the chart it will be automatically deselected. Adding or Removing Chart Objects You can add or remove the objects (also called attributes) in your charts. To add an object/attribute: JMibTools Page 56 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s 1 From the Attributes menu in the Chart window, select Add. The Add Attribute Window, Figure 20, appears: Add Attribute Figure 20: Add Attribute Window 2 Fields at the top of the window display the IP Address, Community String, Polling Rate and Protocol of the device being queried. The color field displays the first available (unused) color from the color scheme. This color will be automatically assigned to the object. JMibTools Page 57 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Note: Note: When a new object is added, it is automatically assigned the first available (unused) color from the default color scheme. If the color designated in the Add Attribute window is not the color you would like to assign to the object, you must first create the object, then change its color. To change an object’s color, refer to Changing Object Captions and Colors on Page 59. To add a custom color to the default color scheme, see Creating Custom Colors on Page 60. 3 In the Caption field, enter the object name (ASCII descriptor) for the object/attribute you want to add. Do not enter the instance. 4 In the Instance field, enter the instance of the object you wish to chart. 5 In the OID field, enter the OID path for the object. 6 Click on Ok. The object will be added to your chart. To remove an object/attribute: 1 From the Attributes menu in the Chart window, select Remove. 2 In the resulting window, use the drop-down menu to select the object/attribute you wish to remove and click Ok. The object/attribute will be removed from the chart as well as from the Legend and Table. To remove all objects/attributes from a chart: 1 From the Attributes menu in the Chart window, select Remove All. 2 A window will appear asking if you are sure you want to remove all the attributes. Click Yes to remove all the objects/attributes from the chart as well as from the Legend and Table. JMibTools Page 58 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Changing Object Captions and Colors To change a caption (rename an object): 1 From the Attributes menu in the Chart window, select Modify, then drag right to Caption. 2 In the resulting window, from the drop-down menu select the object whose caption you wish to change. Click Ok. 3 Enter the new caption you wish to use without the instance. Click Ok. Note that this does not change the object being polled; it only renames it. To change an object you must remove the object and then add a new object. To change an object’s color: 1 From the Attributes menu in the Chart window, select Modify, then drag right to Color. 2 In the resulting window, from the drop-down menu select the object you wish to change. Click Ok. The Modify Color Window, Figure 21, will appear. JMibTools Page 59 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Modify Color Dialog Figure 21: The Modify Color Window 1 In the top part of the window, the object name and the current color will be displayed. 2 In the Default Colors section, click to select the new color you wish to assign to the object. Colors that have a U on them are already being used and cannot be selected. Click Ok. The new color will now be displayed in the chart. Creating Custom Colors When a new object is added, it is assigned a color from a default color scheme. This default color scheme can be customized, allowing you to associate certain custom colors with certain objects in your charts. The custom color schemes that you create can also be saved to a file. JMibTools Page 60 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s To create a custom color scheme: 1 From the Attributes menu in the Chart window, select Customize Colors. The Color Scheme window, Figure 22, will appear. Color Scheme Dialog Figure 22: Color Scheme Dialog The Color Scheme window shows colored buttons of all the colors that are in the color scheme. Colors that are currently being used have the letter “U” on their buttons. A Tool Tip will appear with the name of the object using that particular color when you rest the cursor on a color button that is being used. The text field shows the RGB value of the currently selected color. The Color Scheme Window also has a popup menu (accessed via the right mouse button) with the following menu items: • Add Color allows you to create and add a new color to the color scheme. • Remove Color removes the currently selected unused color from the color scheme. • Load Colors from File allows you to load a color scheme from a color file. • Save Colors to File allows you to save a color file. Adding a New Color To add a new custom color to the color scheme: 1 In the Color Scheme window, click the right mouse button and select Add Color. The Choose Color to Add window, Figure 23, will appear. JMibTools Page 61 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Figure 23: The Choose Color to Add Windows 2 There are two color generation methods used to create colors: HSV (Hue Saturation Value) and RGB (Red Green Blue). You can access each method by clicking on the appropriate tab; the HSV tab is displayed by default. 3 In the HSV tab, you create your custom color by clicking on the small circle inside the color circle and dragging it until the desired color is displayed. 4 If you change to the RGB tab, the same color will be displayed there. You can change the color by using the red, green, and blue sliders to create the desired color. 5 After you have created the desired color in either tab (remember that both tabs display the same color), click OK. The custom color will be added to the Color Scheme. JMibTools Page 62 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s Removing a Color To remove a color from the color scheme: 1 In the Color Scheme window, click on the color that you wish to remove. (You cannot remove a color that is currently being used.)Then click the right mouse button and select Remove Color. 2 A window will appear asking if you are sure you want to remove the color. Click Ok to remove the color. Creating and Using Color Files By adding custom colors to the default color scheme, you create custom color schemes that you can then save to color files. To save a color scheme to a file: 1 In the Color Scheme window, click the right mouse button and select Save Colors to File. The Color File Save window, Figure 24, will appear. Figure 24: JMibTools The Color File Save Window Page 63 Vie w in g a nd For ma tti ng Que ry Re su lts U s in g C ha r t s to Vi e w Q u er y Re s u lt s 2 Select the folder and file name where you want the color scheme to be saved. The file name extension must be “.clr”. 3 Click the Save button. The Color File Save window closes. To import a color file into the color scheme: 1 In the Color Scheme window, click the right mouse button and select Load Colors From File. The Color File Open window (which is similar to the Color File Save window, Figure 24), will appear. 2 Select the folder and file name that you want to load, and click Open. 3 The window closes, and the color file will be loaded into the color scheme. Taking and Printing Snapshots (Print Preview) You can take a snapshot of any pie, line, or bar chart using the Print Preview selection on the Canvas popup menu. You can then modify the appearance of the snapshot and print it. To take a snapshot: 1 In the chart’s Canvas, click the right mouse button to access the popup menu. Select Print Preview. A shot of the chart will appear like the one shown in Figure 25. Information at the top of the snapshot indicates the date and time the snapshot was taken, and JMibTools Page 64 the IP address and poll rate of the device. Note that the snapshot does not show the Chart Menu Bar. Figure 25: 2 Print Preview of a chart In the snapshot itself, you can click the right mouse button to access a popup menu. Use this menu to modify the appearance of the snapshot as described in earlier sections. Note that the logarithm selection is not available from this menu for line and bar charts. To print: 1 In the snapshot, click the right mouse button to access the popup menu. Select Print. The standard print menu will appear. JMibTools Page 65 S et t i n g M IB O b j ec t s U s in g C ha r t s to Vi e w Q u er y Re s u lt s Setting MIB Objects This section describes how to change the value of MIB Objects within JMibTools. With the Browser, you can change the value of a writable object in a device’s MIB by performing an SNMP SET. You can tell if an object is writable by performing a query. In the query results panel, objects which are writable will be identified by a light green leaf icon; objects which are not are identified by a dark green leaf. To set a MIB object: 1 Be sure that you have contacted the correct device and that you are using a community name which provides you with write access to the desired MIB object. (Remember, the appropriate community name may depend upon which MIB component contains the object you wish to set.) Query the device for the desired MIB object, as described in Querying MIB Objects on Network Devices on Page 29, on. 2 In the Query Results panel, click on the object and instance of interest. Click on the Set button to the right of the Query Results panel. 3 The Set Attribute window, Figure 26, will appear. JMibTools Page 66 S et t i n g M IB O b j ec t s U s in g C ha r t s to Vi e w Q u er y Re s u lt s Figure 26: Set Attribute Window Note: Note: If you click on the Set button with a non-modifiable object selected (a dark green leaf icon), the message “Selected item is not write enabled.” will appear in the status bar. This may occur because you do not have permission to write to the device, or because the object itself has been designated read-only. This may also occur for objects which are present in the device but have not been added to the current MIB database. For information on updating, editing, and selecting a MIB database, see Using the Editor on Page 69 4 Click to select the value field, and edit the value as desired. The value that you enter must match the data type specified for the object. You may want to refer to the MIB Details window to be sure that you are entering a suitable value; see Viewing MIB Details on Page 82, for more information. 5 If the selected object is an enumerated integer type, an arrow will appear next to the value field allowing you to scroll through the possible values that can be set (see Figure 26). 6 Click on the Apply button at the bottom of the Set Attribute window. The Status Bar will display the results of the Set. If the Set was JMibTools Page 67 successful, the new value will be updated immediately and will appear in the Query Results panel the next time you query the object. JMibTools Page 68 Us in g t h e E dit o r U s in g C ha r t s to Vi e w Q u er y Re s u lt s Using the Editor This section describes how to use the JMib Tools Editor to search, view, modify, and import information. This sections also show you how to create new MIB databases. You can use the Editor page to customize the default MIB database, or to create additional customized MIB databases. You also use the Editor to select the database you wish to use. There are several reasons that you may want to import additional or updated MIBs into the default “TheWorld” database, or create custom MIB databases. First, if you wish to manage any third-party devices not already supported, you need to import their vendors’ proprietary MIBs (which will not be included in your default MIB database). Second, MIBs — especially proprietary MIBs — are frequently updated, and you may need to import a new version of a MIB. Finally, some of your newer networking devices may still be under development, and new firmware may include functionality provided by entirely new proprietary MIBs. By using the Editor tool, you can ensure that your MIB databases remain up-to-date and contain all the MIB information you need to successfully monitor and manage your network devices. Note: Note: To reintialize the JMib Tools database you must follow these instructions. In the JMib Tools directory, you can move or remove files from the TheWorld.od(bft) by running the following command: ../Install-Tools/gzip -cd MibDb.tar.gz | ../InstallTools/newtar xvf - To access the JMib Tools Editor window, click on the Editor tab. The Editor window, Figure 27, will appear. JMibTools Page 69 Us in g t h e E dit o r U s in g C ha r t s to Vi e w Q u er y Re s u lt s The Find buttons invoke a MIB search for the object specified in the corresponding Find Field. You can search both the Target and Source Tree by using the appropriate Find button. Use the Open Document button to select a MIB or source database. The Dataset field displays the Target Database. Use the Open Database button to select a new target database. Use the Merge button to import a source file into a target database. Figure 27: The Editor Window JMibTools Page 70 Us in g t h e E dit o r V i e wi n g th e Co n te nt s o f a M IB Da ta b as e The Editor window is divided into two areas: the left side is called the Target area, and the right side is called the Source area. The Target area allows you to view and edit the contents of any databases you have already created. The Source area allows you to select and display any source file you wish to use to create a new database, or import into an existing database. Viewing the Contents of a MIB Database When you first launch JMib Tools, only a single database is available. This is the default database entitled “TheWorld,” which contains many IETF standard MIBs. TheWorld is stored in the directory where the executable is stored, and is loaded by default as the Target database, as indicated by the DataSet field (see Figure 27). The contents of the target MIB database are displayed just as they are in the MIB Tree display portion of the Browser window: MIB branches are displayed as folders; to display folder contents, double-click on the folder of interest. You can also use the Find field at the top of the Target area to search for one or more objects of interest, just as you do in the Browser window. Searching for Objects in a Database Note: Note: Follow the procedures in this section to find a MIB object or objects in either the Target MIB database or the Source MIB text file; just use the appropriate Find field at the top of either window. Remember, only the MIB information stored in the current Source or Target file will be searched. The Editor’s Find feature allows you to search your MIB database for a specific object’s ASCII description or encoded OID string. JMibTools Page 71 Us in g t h e E dit o r V i e wi n g th e Co n te nt s o f a M IB Da ta b as e To search for an object based on its specific ASCII descriptor or OID string: 1 In the Find field above the MIB Tree display, type in the ASCII descriptor or encoded OID string. Note: Note: Searches are case-sensitive, so be sure that the text you enter exactly matches the ASCII descriptor of the MIB Object you want to find. If you enter a numeric OID for your search, be sure to remove any text descriptors that may be left over from a previous search, or the search will fail. 2 Click on the Find button or press Enter. If the specified object is in the current MIB database, it will be immediately selected in the MIB Tree display, and its ASCII descriptor and OID string will appear in the Find field. 3 If the specified object was not found, the Status bar will turn red and display a message informing you that the search failed. JMib Tools does not currently support the ability to search for multiple objects using the Editor’s Find feature. Note: Note: Editing a MIB Database You can edit your MIB database by importing additional (or updated) MIB information from a source text file into a target database. JMibTools Page 72 Us in g t h e E dit o r V i e wi n g th e Co n te nt s o f a M IB Da ta b as e Selecting the Target Database When you open the Editor, the default target database is “TheWorld”. To select a new target database: 1 In the Editor window, click on the Open Database button, located just to the right of the DataSet field. The Select Database to View window (Figure 28), will appear Figure 28: Select Database to View Window 2 Select the folder and file name of the database file you want to load. The file name extension must be “.odb”. 3 Click the Open button. The window closes and the database file is loaded into the Target area. JMibTools Page 73 Us in g t h e E dit o r V i e wi n g th e Co n te nt s o f a M IB Da ta b as e The target database you select here is the one which will be edited in response to any actions you take in the Editor window. Note: Note: Selecting a Source MIB File to Import If you wish to import additional or updated MIB information into the target database, you must first obtain a text MIB file and use the Editor window to compile the text version into the proper database format. Any MIB information you wish to import must be stored in flat ASCII text format, it must be both readable and writable (that is, with file permissions set to read/write), and — for the MIB to be successfully compiled — its contents must conform to Internet-standard SMI (Structure of Management Information) conventions. Caution: The JMib Tools application is designed to be used as a compliment to an SNMP Network Management System, and is therefore expected to be used with MIB objects at or below the Internet subtree. Using objects above the Internet subtree may produce unexpected behavior in relation to compilation, database compatibility, and application functionality. To select a source MIB file: 1 In the Editor window, click the Open Database button in the lower right corner of the window. The Select Text File for Compiling or Database to Load window, Figure 29, will appear. JMibTools Page 74 Us in g t h e E dit o r V i e wi n g th e Co n te nt s o f a M IB Da ta b as e Figure 29: Select Text for Compiling or Database to Load Window 2 Select the folder and file name of the source file you want to open. 3 Click the Open button. (You may have to resize the window to see the Open button in the lower right corner.) The MIB Compiler window, Figure 30, will appear. JMibTools Page 75 Us in g t h e E dit o r V i e wi n g th e Co n te nt s o f a M IB Da ta b as e As your source MIB file compiles, errors and warnings will be listed on the left; successfully compiled objects will be listed on the right. Note that you can import a MIB which compiles with warnings, but not one which compiles with errors. Figure 30: The MIB Compiler Window 4 Click on Compile to start the compiling process. 5 If the compiling is successfully completed (or completed with warnings, but no errors), an OK button appears. Click OK to load the MIB as the source database. JMibTools Page 76 Us in g t h e E dit o r I mp o r ti n g th e S o ur c e F il e 6 If the compile is not successful, a list of errors will appear in the Compiler Warnings and Errors list box, and the OK button will not appear; click Cancel to close the MIB Compiler window, edit the text file as necessary, then try again. 7 Once the source MIB has been successfully compiled and loaded, you can display its contents by clicking on folders in the Source MIB Tree display. You can also use the Find feature to check that the source contains the objects you want to import (see Searching for Objects in a Database on Page 71). Importing the Source File Once a Source MIB has been successfully loaded, the Merge button located between the Target and Source areas in the Editor window will become active. To import the source MIB into the Target database, simply click on the Merge button (refer to Figure 27). You cannot select portions of the source to be imported; you must import the entire source file. Note: Note: Once the Source MIB has been imported, the Source area in the Editor window will be cleared. Note that you cannot “undo” an import; once the Source file has been merged with the Target database, the target is automatically saved in its new form. Deleting a MIB from a Database You can delete a compiled MIB from a database using the following steps: 1 Highlight the MIB that you want to delete in the MIB tree portion of the Editor window. 2 Right click on the MIB’s name and select Delete. JMibTools Page 77 Us in g t h e E dit o r C r ea ti n g a N ew M IB Da ta b as e 3 Go to SPECTRUM’s JmibTool directory and delete all of the files and directories that relate to the MIB that you want to delete, including all .odx, .odb, .odf, and .odt files Note: Note: Once you have deleted a MIB from a MIB database, the MIB will still be listed in the dialog box generated by the View Compiled Target MIB List command available on the View menu in the Editor window. This list is not able to reflect that a MIB has been deleted, but this does not mean that the MIB still exists in the database. Creating a New MIB Database With the default database TheWorld as the target database, compile the first MIB of your new MIB database according to the instructions in the previous section. Then: 1 In the Editor window, click on the Open Database button, located just to the right of the DataSet field. The Select Database to View window (Figure 31), will appear. Figure 31: JMibTools Select Database to View Window Page 78 Us in g t h e E dit o r Lo a di n g a N ew D at ab a s e i nt o th e B r o ws e r 2 Enter the name of the first MIB file (with a “.odb” file extension) you just created. 3 Click the Open button. The window closes and the database file is loaded into the Target area. 4 Compile the second MIB file you want as part of your new database and merge it into the target file. Continue doing this until your new MIB database is complete. If you compile the Redback MIB RBN-SMI.my, you will encounter a warning message that states: Note: Note: Used enterprise from MIB and not from . This warning can be disregarded. The definition of the enterprises MIB object in the RFC 1902 (SNMPv2-SMI) remains unchanged from the definition in the RFC 1155. Therefore importing the Redback MIB leaves the enterprises object unchanged from its current, correct RFC 1155 definition in the database. The warning message does not prevent the Redback MIB from being imported or the database from being created. Loading a New Database into the Browser In order to use a new or modified database in the JMib Tools Browser, you must first load it into the Browser window. To do so: JMibTools Page 79 1 In the Browser window, click the right mouse button anywhere in the MIB Tree panel. In the resulting menu, click on Select Database. The Select Database to View window will appear (Figure 32). Figure 32: Select Database to View Window 2 Select the folder and file name of the database file (with the “.odb” extension) that you want to load into the MIB Tree panel. 3 Click the Open button. The window closes and the database file is loaded into the MIB Tree panel in the Browser window. Note: Note: JMibTools To view a list of the MIBs contained in the selected MIB database, click the right mouse button anywhere in the MIB Tree display. Select MIBs Contained from the resulting menu. A window listing all the MIBs contained in the database will appear. Page 80 V ie w in g t h e De v ic es L is t Lo a di n g a N ew D at ab a s e i nt o th e B r o ws e r Viewing the Devices List This section describes how to view and set Device Lists within JMibTools. As you contact networking devices (or add devices found during a subnet discovery), information identifying each device is stored in the serialization file (see About Serialization (.ser) Files on Page 16). You can view all of the device information stored in the .ser file, as well as sort and/or delete device information, via the Devices List, Figure 330. You access the Devices List by clicking on the Devices tab. Figure 33: Device List For each device which has been successfully contacted via the Browser window, the Devices List displays the following information: Name Displays the MIB-II sysName for each device, if one has been assigned. If none has been assigned, a value of unknown will be displayed; multiple unknown names will be assigned sequential index numbers — unknown(2), unknown(3), etc. — and will be sorted numerically. JMibTools Page 81 V ie w in g t h e De v ic es L is t De le t in g a D ev i c e IP Address Displays the IP address assigned to the device. MAC Displays the MAC, or hardware, address assigned to the device. For multiple-interface devices, the first MAC address returned by the device will be displayed here. Type Displays the device’s sysObjectID which defines the device’s type. Description Displays the device’s sysDescr. You can sort the device list on any of these fields by clicking on any of the column headings. To reposition the columns, just click in the column heading and drag the column to the desired position. You can also resize the columns as described in Resizing the Query Results Fields on Page 35. Deleting a Device Deleting a device from the Devices List deletes the device from the IP Address field and drop-down list in the Browser window, as well as deleting it from the serialization file. To delete a device from the Device List: 1 In the Devices list, click right mouse button to select the device you wish to delete. (Note that you can only select and delete one device at a time.) 2 A Delete button appears. Click on the button; the device will be deleted without any further confirmation. Viewing MIB Details The Details page provides additional technical and descriptive information about any object that is contained in the MIB database. It provides you with the definition of each object as it is stored in the JMib JMibTools Page 82 V ie w in g t h e De v ic es L is t V i ew i ng M I B De t ai l s Tools’ MIB database, including its Object Type, Syntax, Access, Status, and Description. To access the Details window: 1 In the Browser window, click to select a leaf or branch object in the MIB Tree panel. 2 Click on the Details tab to display the Details window. The selected object’s MIB definition will be displayed. Figure 34 displays a sample detail description . Figure 34: The Details Window Each time you select a new MIB object in the Browser, the Details window will display the appropriate MIB definition. So that you need not continually change from one window to the other while viewing MIB definitions for multiple objects, you can detach the Details window from JMibTools Page 83 V ie w in g t h e De v ic es L is t V i ew i ng M I B De t ai l s the main JMib Tools window, then return to the Browser window; the detached Details window will continue to update based on your selections in the Browser window. To detach the Details window: 1 Click in the Details tab to display the Details window. 2 Click along the top of the description text box, below the Details tab, as illustrated in Figure 35. Drag the resulting window in any direction to create a separate Details window. Click here to pop-up the Object Details. Figure 35: JMibTools Detaching the Details Window Page 84 V ie w in g t h e De v ic es L is t V i ew i ng M I B De t ai l s When you no longer need it, use the window control at the top left of the window to close the detached Details window. MIB Object Definitions A defined MIB object is identified by the following: JMibTools OBJECT_TYPE The object’s ASN.1 (Abstract Syntax Notation.1) defined name and type. SYNTAX How the data represented by this object is structured: Integer, Octet String, Object Identifier, Null, Sequence, Sequence of, IpAddress, NetworkAddress, Counter, Gauge, TimeTicks, Opaque, or some other user-defined data type. ACCESS The level of management access available for this specific object: read-only (instances of the object may be read, but not set), read-write (instances of the object may be read or set), write-only (instances of the object may be set but not read), or not-accessible (instances of the object may not be read or set). Note that this does not designate the level of access provided by the community name you used to contact the device, but the maximum level of access available for the object by definition. STATUS Indicates whether a managed device is required to implement this object in its MIB. A status of mandatory indicates that the device must use this object (by convention, all MIBs adhering to the Internet-standard contain only mandatory objects); a status of optional indicates that the device may implement this object (by Internet-standard MIB convention, this is used to denote objects within an experimental MIB); and a status of obsoleted indicates that the device need no longer implement this object, as it is no longer meaningful in an Internet-standard MIB. DESCRIPTION A brief description of the management information conveyed by this object. Page 85 JMibTools ::= The variable name of the object, in the form OBJECT TYPE OBJECT IDENTIFIER fragment. –– The MIB object’s full OID string; its path from the root level of the Internet MIB Tree. Page 86 S et t i n g JM i b T o o l s P re f e re nc e s V i ew i ng M I B De t ai l s Setting JMib Tools Preferences The section describes how to customize your JMib Tools to perform desired tasks. The JMib Tools Preferences window allows you to customize certain operations of JMib Tools, including setting up the poll intervals and retries used when querying devices, selecting the default sort method for the Devices List, and opting to save the screen position on exiting JMib Tools. To access the Preferences window, click on the Preferences tab. Figure 36: Preference Window JMibTools Page 87 S et t i n g JM i b T o o l s P re f e re nc e s V i ew i ng M I B De t ai l s 1 To change the value specified by a selected option, highlight the existing value with the cursor and type in a new value. 2 To enable or disable an option, click its radio button or selection box. 3 Once you have finished setting your preferences, click Apply; the changes will take effect immediately. To restore default settings, click Reset. The Preferences window allows you to specify the following options: Query Retry Count Select the number of times that Browser will attempt to contact a selected device’s SNMP agent. The default value is 1 retry; the allowable range is 1-5. Query Timeout Select the interval after which an SNMP query will be abandoned if there is no response. The default value is 1 second; the allowable range is 1-5. Port This option sets the port on which JMib Tools will communicate with an SNMP Agent. The allowable range is 161-32698. Device Management Display Options Select the sort parameter to be used by default in the Devices List. This selection will also update the sort in the Device section of JMib Tools.Note that your selection here does not limit the sorts you can perform on the list itself: JMibTools Sort by Name Sort alphabetically according to MIB-II sysName; this is the default sort selection for the Device list. Sort by IP Address Sort numerically according to Internet Protocol Address. Sort by MAC Address Sort in hexadecimal sequence. Sort by Device Type Sort by the authoritative identifier of the device’s network management subsystem (an object identifier which identifies the type of box being managed). Page 88 S et t i n g JM i b T o o l s P re f e re nc e s V i ew i ng M I B De t ai l s Sort by Description Sort alphabetically by the MIB-II sysDescr value. JMib Tools Options The JMib Tools option allows you to determine where the JMib Tools window will be positioned when the application is launched. If the option is selected, the JMib Tools window will open in the same screen location it was in when last exited. JMibTools Page 89 Index Symbols "TheWorld" 17, 24, 69 .ser files 11, 15, 81 A ACCESS 85 ASCII descriptor 27, 72 ASCII string 8 ASCII textual description 25 Auto Clear 36 B branch (MIB) 8 Browser 14 C community name 20, 22, 66 Community String 23 compiling source MIB files 76 component-based MIB architecture 23, 29 COUNTER 35 Device field 19 Device Management Display 88 Device Manager 15 discovering devices on a subnet (MIB Tools) 21 E Editor 15 enumerated integer type 67 Exit JMibTools 16 F Find feature 26, 71 flat ASCII text format 74 G GAUGE 35 I IETF standard MIBs 10 importing MIB information 74 instance 9 Instance value 33 D DESCRIPTION 85 Details 15 JMibTools Page 90 Ind ex Ind ex L OID string 27, 72 leaf (MIB object) 9, 25 leaf icon, colors 66 leaf icons colors 30 P M Management Information Bases (MIBs) 7 managing third-party devices via MIB Tools 69 match-any character 21, 27 match-any character (wildcard) 28 Merge button 77 MIB Browser 14 MIB data structure 33 MIB database 17 creating and editing 67, 69 MIB Details detaching 84 MIB Editor 15 MIB Objects, technical description of 33 MIB Tree 24 MIB Tree display 24 N numeric OID 8 O Object (MIB) 7 Object Identifier (OID) 8, 25 OBJECT_TYPE 85 JMibTools preferences (MIB Tools) 87 proprietary MIBs 69 Q Query Query Query Query 29 Results 30 Retry Count 88 Timeout 88 R Radar View 14, 26 resizing columns 35 S search the MIB 28 setting MIB Tools preferences 15 SMI conventions 74 SNMP agent 7 SNMP community names 22 SNMP Get 29 SNMP Get, Get Next, and Set Requests 18 SNMP poll 20 Source 71 source MIB file 74 STATUS 85 Status bar 20 SYNTAX 85 System Name field 19 Page 91 Ind ex Ind ex T tabular objects 9, 33 Target 71 TIMETICKS 35 traffic light indicators 19 W wildcard 21, 27, 28 JMibTools Page 92