6.1 CUSTOMIZING SUBMAPS
Submaps may be customized on a per-map basis to allow each NNM user to focus on specific needs. For example, a particular user might want to see the systems placed geographically on a submap according to the location in which the systems physically reside. A user might also want to create custom icons that will launch frequently used applications. The following sections include some of the commonly used map customizations.
6.1.1 Setting the Default Map and Home Submap
The user default map is the map that is open when a user starts the NNM GUI. If the specification of the default map is not modified, the map named "default" will be opened. The administrator can create as many maps as necessary, limited only by disk space.[1] Generally speaking, you should never make customizations to the default map. A better practice would be to make a copy of the default map, saving it under a new name. Customizations should then be made to this new map. After making customizations to a map (such as background graphics, auto-layout, and so on), you may want to set this map as your user default map. The user can set his default map by performing the following:
[1] Maps are written to the directory $OV_DB/openview/mapdb. For UNIX systems, use du k $OV_DB/openview/mapdb to view the sizes of the map databases in kilobytes. For information on the du command, refer to the UNIX man page on du . For Window systems, view the directory properties from Microsoft Explorer.
- Select from the menu bar Map
Open…
- Select the map you would like as your default (see Figure 6-1).
[View full size image]Figure 6-1. Select
MapOpen from the menu bar to set the user default map. Select the map name and click the [Set User Default] button. The User Default Map shown here is the map named "default."
height="186" SRC="/image/library/english/10090_06fig01.jpg" >
- Click the [Set User Default] button.
Check to ensure that every map was opened with read/write privileges. The map will not synchronize without being opened with read/write privileges. After the synchronization of the maps, run ovw mapcount . This should run without errors.
export DISPLAY=displayhostname :0.0
for map in 'ovwls x | egrep v "opcadm|opcop" `
do
ovw map $map &
done
6.1.2 Submap Overlay, Window Geometry, and Symbol Hiding
Many customizations may be made to a map, including the behavior of the submap overlay. By default, when you drill down through a map's hierarchy by double clicking, the child submap of the selected object replaces the current submap.[2] Likewise, when you click the up arrow icon from the toolbar, the parent submap of the current submap replaces the child. This prevents the user from having too many open submaps. If you prefer not to have this submap overlay feature turned on, you can modify this behavior on both a map and a submap basis by selecting from the menu bar
[2] In earlier implementations of NNM, every time you double-clicked an object a new window opened. If you double-clicked twenty objects, you had twenty windows. This became a bit cumbersome to keep track of all the open windows. The submap overlay feature allows you to customize this per map and per submap.
ViewSubmap Overlay
Off For This Submap View
Submap Overlay
Off For All Submaps
Another user customization is the ability to save window size and placement. For instance, if you prefer the IP Internet submap on the left side of your monitor and a particular node-level submap on the right side, simply adjust the submap overlay to open multiple submaps, arrange the submap size and location to your liking, and save the window geometry by selecting View
[3] Use the control and left mouse button simultaneously to multi-select symbols. This also toggles the selection.
The status line at the bottom of each submap displays the number of hidden objects on the current submap, as shown in Figure 6-2. You may have a need to hide a particular type of object. For example, you may want to hide all Windows systems because they are all DHCP devices that appear to go down frequently. Follow these steps to hide all systems that have a common attribute such as the operating system:
- Search for the object by the attribute.Edit
Find
Object By Symbol Type…
- Select Computer class Windows NT subclass and click the [Apply] button.
- Double-click one of the items listed under the "Located and Highlighted" section.
- Select the items that were found.View
Highlights
Select Highlighted
- Hide the objects that were selected.View
Hidden Objects
Hide Selected From This Submap
- Hidden objects can be unhidden at any time by selectingView
Hidden Objects
Show Hidden On This Submap
- Recall that the submap hierarchy isRoot
Internet
Network
Segment
Node
Figure 6-2. The status line displays the map name (default), the access mode (Read-Write), the number of hidden symbols (Hidden:8), and whether Auto-Layout is enabled.
Chapter 9, "Scalability and Distribution."
6.1.3 Setting Background Graphics and Automatic Layout
Background graphics can be used to enhance the appearance of a submap. They can be used to display geographic regions, floor plans, or organizational structures. A number of file formats are supported for submap background graphics. If you have a file that is not in the list, check the Release Notes for currently supported file formats. Supported file formats for background graphics are listed in Table 6-1.
GIF |
TIFF |
BMP |
XBM |
PCX |
Image |
Starbase |
XPM |
XWD |
JPEG |
- Select Map
Submap
Properties from the menu bar.
- Click the [Browse…] button listed by the Background Graphics section of the dialog box. This is located on the View tab for Windows.
- Select a graphic as shown in the list of Figure 6-3.
Figure 6-3. The administrator can set a background graphic for each submap. Many of the provided graphics include geographic locations. The administrator can also import a custom graphic such as a floor plan.
height="356" SRC="/image/library/english/10090_06fig03.gif" >
- Click [OK] .
6.1.3.1 Memory Considerations when using Background Graphics
One thing to remember when setting background graphics is the amount of physical memory (RAM) you have on your NNM system. When you open a map, all objects, including background graphics, are loaded into memory[4]. The more objects in the database, the more memory required to load objects into memory. Similarly, the more complex the graphic, the more memory required. One way to tell if your system is memory-bound is if the synchronization process takes a long time (more than a few minutes) when you open a map. If synchronization is taking too long, try decreasing the number of objects being loaded into memory. One way to achieve this is by changing the persistence level of your map.
[4] The default behavior of NNM on UNIX systems is to load all objects in to memory. The default behavior on Windows NT/2000 is to only load objects into memory on the IP Internet submap and higher.
6.1.3.2 Submap Persistence
The persistence level of a submap indicates the level at which objects are loaded into memory. If you select any choice other than All Levels , the objects appearing on submaps below that level are not loaded into memory until you open that specific submap. You can define the persistence level of a map by following these steps.
- Select the map properties.Map
Properties
- Select IP Map and click [Configure For This Map…]
- Scroll down to the section that readsOn-Demand:
To what level should submaps be persistent. - Select one of the levels:All Levels Segment Level and Higher Network Level and Higher Internet Level
- After selecting the persistence level, click [Verify] and [OK] in the IP Map configuration dialog box and [OK] in the Map Properties dialog box.
- Submap Overlay
- Window Geometry
- Hidden Objects
- Background Graphics
- Auto-layout
Any objects contained in the submaps that have customizations such as these will be loaded into memory whenever the map is open. As another example, if you set your persistence level to Internet Level and set a background graphic on every submap, you defeat the purpose of setting the persistence level.
6.1.3.3 Automatic Layout
The purpose of automatic layout is to allow a device discovered by NNM to have its symbols placed on a submap without human intervention. When using background graphics, you may find that you would like to manually control the placement of symbols. When placing objects on a floor plan, for example, you can turn off auto layout and place the symbols where they physically reside. To turn off automatic layout for an individual submap, select View
Figure 6-4. This submap has been configured with Georgia as the background graphic. NNM ships with a GIF file for each US state and many countries. Turn off automatic layout to allow manual placement of symbols.
[View full size image]
Figure 6-5. The
New Object Holding Area is created when automatic layout is turned off. Newly discovered devices are placed in the New Object Holding Area. They can be manually placed on a submap by drag-and-drop.[View full size image]
6.1.4 Partitioning the Internet Submap
NNM knows how to lay out devices based on the information provided by SNMP queries. The submap hierarchy from top to bottom is
RootInternetNetworkSegmentNode
The layout of your network can be customized at the Internet level submap. The purpose is to allow partitioning of your network based on geographical or logical information. NNM does an excellent job of providing the physical connections of your network but makes no assumptions as to the organizational structure. This customization is known as partitioning the Internet submap.Partitioning the Internet submap requires that you add a special type of symbol called a location symbol. The steps to partition the IP Internet submap are as follows:
- From the Internet submap selectEdit
Add Object
- Select the Location symbol (Figure 6-6) and drag any of the subclass symbols to the submap.
Figure 6-6. Location objects can be used to partition the IP Internet submap. Notice the location objects added to the submap shown (Japan and Australia) are in the application plane (no shading appears around the symbol).
- Provide a Label and click [OK].
- Repeat the creation of location icons until you have defined all necessary locations.
- Drag each symbol and drop it in the desired location.[5] Connections will automatically be established between location symbols as shown in Figure 6-7.
[5] The Windows version of NNM requires using cut and paste instead of drag and drop.
Figure 6-7. When partitioning the Internet submap, connections between the locations are automatically established as symbols are moved into the location icons.
6.1.5 Creating Executable Symbols
By default, symbols on a submap spawn a child submap when double clicked. This behavior is referred to as "explodable." Symbol properties on a submap may be modified to launch an application when double-clicked rather than opening a child submap. This behavior is referred to as "executable." A number of pre-defined applications exist and are accessible in NNM. In fact, most applications available from the menu bar and the toolbar may be used in creating executable symbols. These applications are defined in NNM through Application Registration Files (ARFs). In addition to using the pre-defined applications, you can create your own applications by defining ARFs as discussed in Chapter 7, "Advanced Customization."To make use of the executable symbol feature in NNM, follow the steps listed here. For this example, use a system that allows incoming telnet sessions.
- Access the symbol properties by right-clicking and selecting Symbol Properties as shown in Figure 6-8.
Figure 6-8. The first step in making an icon executable is to place the cursor over the symbol, click the right mouse button, and select
Symbol Properties… from the symbol popup menu.height="435" SRC="/image/library/english/10090_06fig08.gif" >
- Modify the symbol behavior to Execute , as shown in Figure 6-9. Notice the list of Applications that appear under the section labeled "Application Action."
Figure 6-9. The second step in making an icon executable is to modify the behavior of the symbol to
Execute and select to application to be launched. - Scroll through the list and select the applicationTerminal Connect:
XTerm Telnet - Click the [Target Objects…] button.
- Click the [Add] button to include the hostname and click [OK] on the Target Objects dialog box as shown in Figure 6-10.
Figure 6-10. The third step in creating an executable icon is to click the
[Target Objects] button, which displays the dialog box shown. Select the [Add] button to add the hostname as a target object. - Click [OK] on the Symbol Properties dialog box and you will see the executable symbol as shown in Figure 6-11. When the symbol is double clicked it launches a telnet session to the system.
Figure 6-11. The executable icon (r208w100) shows up as a button. Double-click it to launch the application. You can also drag a symbol and drop it on the button to launch the application on another object.
[View full size image]height="435" SRC="/image/library/english/10090_06fig11.jpg" >
6.1.6 MIB Applications
Many of the options from the tool and menu bar access applications that communicate with the MIB. When launched, these applications send SNMP queries to the selected node to access certain MIB variables. Some applications create tables that contain the data and others generate real-time graphs. NNM provides many built-in MIB applications as well as the capability to create your own MIB applications via the GUI.
6.1.5.1 Built-in MIB Applications
Most MIB applications require you to select a node before launching. If nothing is selected, the menu items will be grayed out and unavailable. Let's look at some of the built-in MIB applications. Select a node and select from the menu bar Performance
Figure 6-12. Interface Traffic is a built-in MIB application available from the menu bar. Select a node and select
Network Activity6.1.5.2 Creating MIB Applications
NNM provides the ability to create MIB applications that will be incorporated into the NNM menu bar. This can be achieved by using the MIB application builder.The MIB application builder allows you to create custom graphs and tables by defining the MIB variables you want to be displayed.Follow these steps to create your MIB graph:
- Select Options
MIB Application Builder: SNMP from the menu bar. This displays an empty MIB application dialog box as shown in Figure 6-13.
Figure 6-13. To create a MIB application, select
OptionsMIB Application Builder: SNMP from the menu bar. The list will be empty by default. Select Edit?Add MIB Application… .
height="239" SRC="/image/library/english/10090_06fig13.gif" >
- Select Edit
Add MIB Application… . You will see the dialog box as shown in Figure 6-14.
Figure 6-14. Specify the Application ID, Application Type, Application Title, Menu Path and click the
[Add…] button.
[View full size image]height="513" SRC="/image/library/english/10090_06fig14.gif" >
- Complete the following fields to define the MIB application:Application ID
This must be a unique ID not containing spaces or special characters. For this example, use InVSOut Application Type
Set this to table, form, or graph. For this example specify graph.Application Title
Name the application whatever you want. This can contain spaces and special characters. For this example, specify "In Packets VS Out Packets".Menu Path
This describes the cascaded menu bar for the application beginning with the top-level menu. This may also contain spaces. Use "->" to indicate cascading menus. For this example, specify yourname Custom AppsIn VS OutSelection Rule
The Selection Rule describes the node type for which this application will work. Until you are familiar with the filtering language described in Chapter 9, it is best to leave it set to the default. The default Selection Rule (isSNMPSupported || isSNMPProxied) will function on any device that supports SNMP or has an SNMP proxy. - Click the [Add…] button to define the MIB variables for the application.
- Traverse the MIB tree to include the MIB variables for the application. Use the control key and left mouse click simultaneously to select the desired variables. This example uses the MIB variables ieeeMacTransmitted and ieeeMacFramesReceived shown in Figure 6-15 under the MIB subtree private.enterprises.hp.nm.interface .ieee8023Mac.ieee8023MacTable.ieeeMacEntry
Figure 6-15. You should be familiar with the MIB tree structure in order to create MIB applications. Press the control key and left click simultaneously to select multiple variables.
- After selecting the desired variables, click [OK] from the Add MIB Objects dialog box.
- Click [OK] from the Add MIB Application dialog box. You should see your custom menu as shown in Figure 6-16. You are now ready to execute your application.
Figure 6-16. Select the node on which to execute the newly created MIB application. Select the application from the menu bar specified in the Menu Path of the MIB application builder.
height="437" SRC="/image/library/english/10090_06fig16.jpg" >
6.1.5.3 Use Your MIB Application as an Executable Symbol
After you've created an MIB application it becomes an NNM registered application. The MIB application can now be used when creating executable symbols. Add an object to a submap, change the behavior to executable, and check the list for your application. An Application Registration File (ARF) is created when you define an MIB application.