Solstice Enterprise Manager 4.1 Managing Your Network Doc Set ContentsPreviousNextIndex


Chapter 4

Viewing Network Components

The power of Solstice Enterprise Manager (Solstice EM) resides in one or more distributed Management Information Server (MIS) databases containing information about every component on your network. To use this power, though, you need a way to consolidate access to your MIS databases, and to design meaningful views of the information they contain.

Network Views is a graphical tool for viewing and working with the information in your MIS databases. You can create and save custom views of your network, in geographical or logical formats, and access the other Solstice EM tools through menu commands and point-and-click interaction with your managed objects. Think of Network Views as a convenient place from which you can visualize your network and initiate all of your day-to-day management functions.

With the Network Views tool, you can:

This chapter provides background information about the Network Views tool, step-by-step instructions for using Network Views, and detailed reference information.

This chapter comprises the following topics:

4.1 Overview

Every managed object in a Solstice EM MIS can be represented as a icon in a Network Views window. These icons can include representations of physical network components, such as routers, hubs, switches, gateways, and hosts, and logical constructs, like universes, subnetworks, and domains.

You can point and click on these Network Views icons to initiate actions on the managed objects they represent. For example, by default, double-clicking on an object icon opens the Solstice EM Alarms tool, and right-clicking displays a pop-up menu, from which you can display the Object Properties dialog box and modify properties for the managed object. You can change the default behaviors of mouse clicks and menus to suit your needs, and you can define custom views to display whatever groupings of icons you want.

Before using Network Views, it is important to understand a few basic Network Views concepts and to have a sense of the kind of tasks you can perform from the Network Views window. Basic Network Views concepts are explained in the following section.

4.1.1 Basic Network Views Concepts

There are seven basic items with which you work in a Network Views window:

4.1.1.1 Component Representations

When you view or manipulate icons in a Network Views window, you are, in fact, working with representations of the managed objects in your MIS, not the network components themselves. You could, for example, use several different icons to represent a single MIS managed object, depending on the kinds of management tasks you want to perform. Everything you do in Network Views--retrieve and set object properties, clear alarms, launch other tools, and so forth--acts upon the managed objects in your MIS.


FIGURE 4-1   Network Component Representation in Network Views

Managed objects in the MIS, in turn, are representations of software agents that interact with the real, physical components on your network--that is, you could have several managed objects in the MIS all referring to the same physical network component.

When you finally get down to the real, physical component level, software agents associated with a given component are what actually perform most management functions. Moreover, the capabilities of the agent object associated with a component will constrain what you can see or do with that component in the Network Views window, and the results of any management action performed on a given component depend on the interaction of other management objects and agents associated with that component.

4.1.1.2 Object Properties

Every managed object definition includes a set of attributes on which the object's programmatic methods can act. The behavior of a given real world network component depends on the properties--that is, the specific attribute values--used for the managed object instance representing that component.

To put it another way, every physical network component can be represented by one or more particular types of managed objects. The type of managed object used to represent a component has associated with it a set of attributes that define what kind of information and settings can be gathered from, or applied to, the component. In Solstice EM, object properties refer to the specific values used for a given set of attributes for a given object type.

For example, a Printer Device object provides attributes for host name, printer type, and IP address, among others, whereas a Router Device provides attributes for IP address, port number, and so forth. The values you specify for a given object's attributes are referred to collectively as the object's properties.

See Section 4.5 Managing Object Properties for more information about working with object properties.

4.1.1.3 Icon Objects

As views, or access points, into MIS managed objects, Network Views icon objects represent two related groups of MIS objects:

Network Views lets you work with several different icon object types. The following table briefly describes the default Network Views icon object types.

TABLE 4-1   Network Views Default Icon Object Types 
Object Type Description
Array
Contains groups of objects in a compact array; object names are displayed in the array cells.
Bus
Multisegmented line; links objects that are connected to it.
Container
Contains other objects, such as views, networks, and subnetworks.
Device
Physical components, such as hosts, routers, hubs, and printers.
Link
Connects two other objects; link containers can contain other links.
Monitor

RouterArray

RouterContainer
Container object divided into one or more sections; each section contains a view of one of the objects contained in the monitor.

Allows to use this object type as an array; each array cell contains an object name.

Allows to use this object type as a container; contains the objects in the router.
Vendor-specific
Custom or platform-specific objects; for example, Sun hardware.


Within each category of icon object type are one or more object icons representing a particular component or logical construct. The table Table 4-2 shows the standard object icons with which you will work most often.

TABLE 4-2   Common Network Views Object Icons 






Array
Bridge
BSC
BTS
Bus
Bus Container






Circle
Container
Device
Hexagon
Hexagon120
HLR






Host
Hub
Interface
Java
Link
MSC






Network
OMC
Omnisector
PC
Printer
Router






Server
SPARC
Subnetwork
Universe
VLR
XCDR


You can define additional object icons and object icon types as needed for your environment. See Section4.4.11 Adding an Object Type to the Object Palette for more information about adding object types to your Solstice EM environment.

4.1.1.4 Saved Views

In the Network Views tool, a view is a named collection of icons representing a set of managed objects or logical constructs. Views themselves are represented as a kind of container object in the MIS.

The Network Views window displays one view at a time. You can easily switch back and forth among different views, and you can also run multiple instances of the Network Views tool so you can display multiple views simultaneously.

You can display two general types of views:

4.1.2 Related Tasks

4.1.3 Related Files

4.1.4 Further Reading

4.2 Getting Started With Network Views

You can start the Network Views tool from the command line, the Network Tools window, or the Tools menu in one of the other Solstice EM tools. Unlike most of the other Solstice EM tools, Network Views is a purely graphical tool--no matter how you start it, you will always get the Network Views graphical interface.

As with other Solstice EM tools, before running Network Views, you must configure your environment settings with emenv.csh or emenv.sh, as described in Chapter 2."

Having said this, it is important to note that one of the components of Network Views, the Object Properties window, is actually a separate binary from Network Views itself--that is, the Network Views binary is em_viewer, and the Object Properties binary is em_oct. Unlike Network Views, you can run em_oct directly from the command line, bypassing the graphical interface, and separately from Network Views. This can be especially useful if you want to use a script or a custom application to automate the creation or modification of managed objects.

Finally, you can only display one view at a time in a Network Views window, but you can run multiple instances of Network Views and display a different view in each window.

If you start Network Views without first running at least one Network Discovery to populate the MIS, Network Views displays only an empty Root view with no object icons. See Section 4.3.1 Populating the Network Views Window for information about running a Network Discovery for the first time. See Chapter 3" for complete information about using the Network Discovery tool.

 

To Use Network Views

1. Start the Network Views tool in one of the following three ways:

2. From the Network Views window, perform one or more tasks, as described in this chapter.

Refer to the subsequent procedures in this chapter and to Section4.8 Reference for complete information about the various Network Views tasks and tools.

3. Click File->Exit to close the Network Views window.

4.3 Working With Views

This section provides step-by-step instructions for getting around in the Network Views window, creating views, and viewing, selecting, and searching for objects.

4.3.1 Populating the Network Views Window

If you start Network Views without first running at least one Network Discovery to populate the MIS, Network Views displays only an empty Root view with no object icons. While you can manually create managed objects using the Object Properties dialog, as described in Section 4.5.4 Creating New Managed Objects, the fastest and easiest way to populate the Network Views window is to run a Network Discovery.

 

To Populate the Network Views Window

1. Start the Network Discovery tool in one of the following three ways:

2. From the Network Discovery window, select the various Discover options you want to use, or load an existing Network Discovery rules file, and then initiate the discovery process.

3. When the discovery process is complete, click File->Exit to close the Network Discovery window.

See Chapter 3" for complete information on using the Network Discovery tool.

4.3.2 Selecting a View

Each view in a Network Views window lets you look at a selected subset of your network. The Available Views pane on the left side of the Network Views window displays a branched tree list of the views available to you, starting from the topmost view, called Root. The specific views available depends on the views that have been defined. You can only display one view at a time in a Network Views window, but you can switch between views any time you want.


Note – You can run multiple instances of Network Views, each showing a different view, to display multiple views simultaneously.

 

To Select a View

4.3.3 Starting Network Views in a Specific View

By default, Network Views displays the Root view on startup. You can temporarily override this default behavior or specify a new default behavior to display whatever view you want when you start Network Views.

 

To Temporarily Override the Default View Setting

 

To Specify a New Default View

1. In the Network Views window, click File->Customize->Display Settings to display the Display Settings dialog box.

2. Select the Display tab, if it is not already selected.

3. Type the name of the view you want to use as the new default in the Default View field, and then click OK.

You can also modify the command line used to invoke Network Views from the various Solstice EM Tools menu, and the Network Views button in the Network Tools window, so that Network Views always starts with the view of your choice. See Section 4.4.8 Configuring the Tools Menu for instructions on configuring the Network Views Tools menu. These instructions apply to configuring the Tools menu in other Solstice EM tools in general. Also see Section 2.8 Modifying Tool Configurations for detailed instructions on configuring the Network Tools window.

4.3.4 Displaying and Selecting Objects

You can display objects by opening the view in which the object is located, or by using one of the Network Views search methods described in the next section, Searching for an Object.

Once an object is displayed, you can select it and perform management functions with it. For example, you could manage alarms, view or modify object properties, or copy objects to other views.

 

To Display and Select an Object Within a View

1. Open the view in which the object is located.

If you do not know where the object is located, use the search methods described in the next section.

2. Click once on the object to select it; use Control-click to select multiple objects.

Alternatively, you can select multiple objects by clicking and dragging to draw a bounding box around a group of objects.

4.3.5 Searching for an Object

Network Views provides two ways to search for objects in the current view or across multiple views:

 

To Search for an Object Using Find by Name

1. In the Network Views main window, type the name of the object you want to find in the Find by Name field, just below the Network Views toolbar, and then press Enter.

If only one such object exists, the view in which the object is located is opened and the object is selected. If multiple objects exist, the Multiple Views dialog is displayed, listing all instances of the object.

2. In the Multiple Views dialog, select the object you want to view, and then click Go to View.

 

To Search for an Object Using the Find Dialog

1. In the Network Views window, click Actions->Find to display the Find dialog.

2. Select the name of the MIS in which you want to search.

By default the MIS loaded when you started Network Views is selected.

3. Select the object type and/or type the name of the object for which you want to search.

You can use either or both of these options. Separate multiple object names with spaces.

4. Click Find to initiate the search.

5. In the Results pane, select the object you want to view.

6. Click Go to View to display the view containing the object.

4.3.6 Creating a Logical (Non-topological) View

You can create logical views--also known as non-topological views--that are based on logical relationships you define, rather than on physical network hierarchy. For example, you could create a view showing all your administration building routers in one view and all your campus file servers in another view.

The process of creating or modifying a logical view involves two general steps:

  1. Select the objects you want to include in the logical view.

  2. Add the selected objects to the new or existing logical view.

These steps are described in more detail below.


Note – By default, when you run a Network Discovery, a topological view is created--that is, a hierarchical view that directly corresponds to your physical network topology. You can override this behavior in the Network Discovery tool, so that newly discovered object will be added to a logical view. See Section 3.7 Creating a New MIS Managed Object Database for more information.

 

To Create a Logical View

1. In the Network Views window, click Actions->Find to display the Find dialog.

2. Select the name of the MIS in which you want to search for objects.

By default the MIS loaded when you started Network Views is selected.

3. Select the object type and/or type the name(s) of the object(s) for which you want to search.

You can use either or both of these options. Separate multiple object names with spaces.

4. Click Find to initiate the search.

5. In the Results pane, select the object(s) you want to include in the logical view.

6. Click Add to View to display the Add To dialog.

Alternatively, you can drag-and-drop with the middle mouse button to drop the selected objects into the current view.

7. Type a new or existing view name to which you want to add the selected objects, and then click Save.

8. Repeat Steps 2 through 7, if desired, to add other objects to the logical view; when you are finished, click Close to exit the Find dialog and return to the Network Views window.

4.3.7 Creating a Network Views Icon Object

You can create new Network Views icon objects in any one of three ways:

Note that the last method, using the View->Create View menu, only lets you create new view objects--that is, a container object of some type.

 

To Create an Icon Object With the Actions->Create Menu Item

 

To Create an Icon Object From the Object Palette

1. In the Network Views window, click Tools->Object Palette to display the Network Views Object Palette.

2. Select the desired subset of object types to display in the palette, if desired, by selecting the type you want from the Object Types drop-down list.

3. Double-click the icon representing the type of object you want to create.

The Object Properties dialog is displayed (same as invoking em_oct from the command line), from which you can specify various properties for the new icon object. See Section 4.5.4 Creating New Managed Objects for more information.
Alternatively, you can drag-and-drop with the middle mouse button to drop the selected objects from the object palette into the current view. This method does not open the Object Properties dialog.
 

To Create a View Object with the View->Create View Menu Item

4.3.8 Editing View Contents

You can copy and paste icon objects from one view to another. This can be a convenient way to build custom views. Alternatively, you can use the Actions->Find dialog to add selected objects to a view.

 

To Copy and Paste Objects From One View to Another

1. Display the view containing the object(s) you want to copy.

2. Select the object(s) you want to copy.

3. Click Edit->Copy.

4. Switch to the view into which you want to copy the object(s).

5. Click Edit->Paste to paste the objects into the current view.

 

To Add Objects to a View With the Find Dialog

1. In the Network Views window, click Actions->Find to display the Find dialog.

2. Select the name of the MIS containing the object(s) you want to add to a view.

By default the MIS loaded when you started Network Views is selected.

3. Select the object type and/or type the name(s) of the object(s) for which you want to search.

You can use either or both of these options. Separate multiple object names with spaces.

4. Click Find to initiate the search.

5. In the Results pane, select the object(s) you want to include in a different view.

6. Click Add to View to display the Add To dialog.

7. Type the name of the view to which you want to add the selected objects, and then click Save.

If you specify a new view name here, a view is created as a container object of the type Subnet in the Root view.

4.3.9 Deleting Objects From a View

You can delete objects from individual views or from all views in which they may be located.


Caution – Deleting icon objects from a view also deletes that object from the MIS. If you delete all instances of an object in all views, you will have also completely deleted that object from the MIS.

 

To Delete Objects From a View

1. Display the view containing the object(s) you want to delete.

2. Select the object(s) you want to delete.

3. Click Actions->Delete.

If the object exists in more than one view, you are asked whether you want to delete it in just the current view or in all views.

4.3.10 Zooming In or Out in the Current View

Network Views provides several zoom controls that let you adjust the magnification of a view or view region for the current view. Specifically, you can:

The Network Views zoom controls are available from the View->Zoom menu and from the Network Views toolbar, both of which are in the Network Views main window.


FIGURE 4-4   Network Views Toolbar Zoom Controls

The zoom level you set with the View->Zoom command applies to the current view only. To set zoom parameters for Network Views in general, use the procedures described in Section 4.4.3 Configuring Zoom Settings.

 

To Use View Zoom Controls

4.3.11 Navigating in Geographical Map Views

When you use a geographical map background in a view, the Network Views main window displays three additional Map toolbar buttons to the right of the Zoom controls. You can use these buttons to center the map in the view window, and pan across the map to see objects beyond the window edge.


FIGURE 4-5   Network Views Map Toolbar

See Section4.4.6 Using Background Images for information about configuring geographical map backgrounds.

 

To Navigate in a Geographical Map View

Alternatively, you can use the commands on the View->Background menu in the Network Views main window.


Note – The Map Toolbar and the View->Background menu are only enabled if you have configured Network Views to use a geographical map background. See Section 4.4.6 Using Background Images for more information.

4.3.12 Changing Icon Size in the Current View

You can change the size of icons in the current view by using the View->Icon Size command in the Network Views main window.

The icon size you set with the View->Icon Size command applies to the current view only. To set icon size parameters for Network Views in general, use the procedures described in Section 4.4.2 Configuring Icon and Label Display.

 

To Set the Icon Size in the Current View

4.3.13 Changing Label Size for the Current View

You can change the size of icon labels and view labels in the current view by using the View->Label Size command in the Network Views main window. Sizes are expressed as points in the current font.

The label size you set with the View->Label Size command applies to the current view only. Also, you can only change the label size with this command, and not the label font. To set label size and font parameters for Network Views in general, use the procedures described in Section 4.4.2 Configuring Icon and Label Display.

 

To Set the Label Size in the Current View

4.3.14 Changing the Background Image for the Current View

If a particular view is configured to use a background image, you can change the image that is used by modifying the container object's properties with the Object Properties tool.


Note – These instructions describe only how to change the background image used for a view. To use these instructions, you must configure the object and the Network Views tool to use background images, as described later in this chapter, in Section 4.4.6 Using Background Images.

 

To Change the Background Image for the Current View

1. Right-click the container object for which you want to change the background image, and click Properties from the pop-up menu.

2. In the Object Properties dialog, select the Display tab.

3. Type or browse for the name of the background image or geographical map background you want to use.

4. Click Apply.

4.3.15 Displaying Specific Object Types

Each of the Network Views object types--for example, Links, Hosts, Routers, Networks, and so forth--are stored in distinct logical layers. By default, all of these logical layers are displayed in any given view. If a large number of objects are in a single view, you may want to suppress the display of selected object types to make it easier to sort through the view.


Note – The Object Layers selection you make applies to all views in the current instance of Network Views. You can run multiple instances of Network Views, with each using a different Object Layers setting.

 

To Display Only Specific Object Types

1. In the Network Views main window, click File->Customize->Object Type Layers to display the Object Type Layers dialog box.

2. Select Selected Object Layers option.

3. Select the Object Layers you want to display.

4. Click OK.

4.3.16 Displaying Specific Map Layers

If you are using a geographical map for a view background, you can use the View->Background->Layers dialog to display only specific map layers. Similar to displaying specific object type layers, described above, this option can be useful for working with large or complex views.

See Section4.4.6 Using Background Images for instructions on configuring views to use background images, including geographical maps.

 

To Display Only Specific Map Layers

1. Ensure that the display of geographical map backgrounds is enabled, as described in Section 4.4.6 Using Background Images.

2. In the Network Views main window, click View->Background->Layers to display the Map Layers dialog.

3. In the Map Layers dialog, enable the Selected Map Layers option.

4. Select the map layers you want to display.

5. Click OK.

The specific map layers available depend on the map file you are using.

4.3.17 Saving and Loading View Settings

You can save your view settings--icon location, zoom area, icon and label sizes--so that when you restart viewer, these settings are used by default. Similarly, after moving icons, changing zoom levels, and resizing icons and labels, you can restore your initial view settings to get back to where you started.

When you exit Network Views, if any of your view settings have changed, you are prompted to save the changes.

 

To Save View Settings

1. Arrange your view to your liking.

For example, Layout, Icon Size, Label Size, Zoom.

2. Click View->Save Initial Values to View to display the Save to View dialog.

3. Select the location and zoom/size options, as desired.

4. Click Save.

 

To Restore View Settings

4.3.18 Viewing the Network Views Message Log

The Network Views Message Log displays system messages returned by Network Views. For example, viewing object properties spawns the em_oct process; this action, along with the parameters passed to em_oct, are displayed in the Network Views Message Log.

 

To View the Network Views Message Log

4.4 Configuring Object Icons and the Workspace

This section provides step-by-step instructions for configuring the Network Views workspace, menus, and default behaviors.

You may also want to refer to the following sections for information about other Network Views tasks:

4.4.1 Configuring General Display Properties

The Network Views window can be configured to display object information in a variety of ways with the settings on the Display tab in the File->Customize->Display Settings dialog. Specifically, the general Display settings are:

The settings you choose are used for all views in the current instance of Network Views. Subsequent instances of Network Views also inherit the settings.

Many display options can also be used on a per object basis. For example, you can specify background image and alarm severity propagation for an individual container object. See Section4.5.3 Modifying Object Properties for instructions on modifying individual object properties.

 

To Configure General Display Properties

1. In the Network Views main window, click File->Customize->Display Settings to display the Display Settings dialog box.

2. Select the Display tab, if it is not already selected.

3. Select a Canvas Layout option.

4. Type the name of a Default View.

See Section4.3.3 Starting Network Views in a Specific View for more information about default views.

5. Enable or disable the display of Alarm Severity Relationships.

Enabling this option displays peer to peer propagation relationships drawn as dashed lines from node to node in the relationship. An arrow indicates the direction of propagation. Enabling this option causes Network Views to display the associated alarm severity color on the label in addition to the icon. The colored icon objects and labels give the node's condition greater visibility. For objects without children, this color is the same as that for Propagated Alarm Severity. See Section 4.6.3 Propagating Alarm Severity for more details.

6. Enable or disable the Show Severity on Label Background option.

Enabling this option colors icon labels based on alarm severities, as described in Section 4.4.4 Customizing Color Settings.

7. Enable or disable the Display Background Image option.

Enabling this option causes the currently selected background image to be displayed. See Section4.4.6 Using Background Images for more information.

8. Click OK to apply your settings and exit the Display Settings dialog, or click Apply if you want to modify other settings in the dialog before exiting.

4.4.2 Configuring Icon and Label Display

You can separately configure the display of icons and icon labels in Network Views windows. Specifically, you can specify default size, scaling and font sizes with the settings on the Icon/Label tab in the File->Customize->Display Settings dialog box.

Icon and icon label colors are specified on the Colors tab in the same dialog box, as described in Section 4.4.4 Customizing Color Settings.

 

To Configure Icon and Label Display

1. In the Network Views main window, click File->Customize->Display Settings to display the Display Settings dialog box.

2. Select the Icon/Label tab, if it is not already selected.

3. Select a default Icon Size.

Icon sizes are displayed in terms of percentages of icon size, as defined in given file. Icon files are stored by default in the $EM_HOME/glyphs directory.

4. Select Icons always display using this value, if desired.

Selecting this option causes all icons to be displayed at the same size, regardless of zoom level or any previously saved view settings. Selecting this option disables the View->Icon Size command in the Network Views main window.

5. Select an icon Label Font.

This is the font that will be used to display all icon labels.

6. Select an icon Label Size.

7. Select Labels always display using these values, if desired.

Selecting this option causes all icon labels to be displayed at the same size, regardless of zoom level or any previously saved view settings. Selecting this option disables the View->Label Size command in the Network Views main window.

8. Click OK to apply your settings and exit the Display Settings dialog, or click Apply if you want to modify other settings in the dialog before exiting.

4.4.3 Configuring Zoom Settings

You can specify how icons and icon labels are scaled, zoom increments, and the zoom level at which icon labels are suppressed, by using the settings on the Zoom tab in the File->Customize->Display Settings dialog.


Note – The settings on this tab are only used if either or both the "Icons always display using this value," or "Labels always display using these values" options are left unselected on the Icon/Label tab, described above.

 

To Configure Zoom Settings

1. In the Network Views main window, click File->Customize->Display Settings to display the Display Settings dialog box.

2. Select the Zoom tab, if it is not already selected.

3. Click Modify, if you want to specify icon and icon label maximum and minimum scaling settings.

The Variable Icon/Label Size dialog is displayed.
  1. Select the minimum icon size to display.
  2. Select the minimum zoom level at which the minimum icon size will be displayed.
    Icon sizes will not scale any smaller than the minimum size at the minimum zoom level.

  3. Select the maximum icon size to display.
  4. Select the maximum zoom level at which the maximum icon size will be displayed.
    Icon sizes will not scale any larger than the maximum size at the maximum zoom level.

4. Select a Zoom Increment.

The percentage you specify is used each time you click one of the Network Views zoom tools, described in Section 4.3.10 Zooming In or Out in the Current View.

5. Select a percentage below which the display of icon labels will be suppressed.

6. Click OK to save your settings and exit the Display Settings dialog, or click Apply if you want to modify other settings in the dialog.

4.4.4 Customizing Color Settings

You can use the options on the Colors tab in the File->Customize->Display Settings dialog box to specify colors for general presentation purposes and to indicate alarm status. Specifically, you can control colors for:

 

To Specify Alarm Status Color

1. In the Network Views main window, click File->Customize->Display Settings to display the Display Settings dialog box.

2. Select the Colors tab, if it is not already selected.

3. In the Icon Status Color Source group, select the color source option you want to use:

4. Click OK to save your settings and exit the Display Settings dialog, or click Apply if you want to modify other settings in the dialog.

The following table lists the default alarm severity mapping used by Network Views.

TABLE 4-3   Default Alarm Severity Color Mapping 
Color Alarm Severity
Red
Critical
Orange
Major
Cyan
Minor
Yellow
Warning
Blue
Indeterminate


 

To Set Network Views Presentation Colors

1. In the Network Views main window, click File->Customize->Display Settings to display the Display Settings dialog box.

2. Select the Colors tab, if it is not already selected.

3. In the Presentation group, select the item you want to modify, and then click Modify to open the Color Chooser dialog box.

You can modify the colors for Viewer Canvas (background), Object Selection, and Object Label Text.
  1. Grab a color, if desired, from another item on your desktop, by clicking Grab Color and then clicking on the item with the desired color.
  2. User the Color Editor controls, if desired, to create a custom color.

    • R, G, and B - Red, green, and blue color values
    • Hue - Color balance
    • Saturation ( ) - Color purity
    • Brightness ( ) - Dark/light value
  3. Click OK to save the color and return to the Display Settings dialog.

4. Repeat Step 3 for each item you want to modify.

5. Click OK to save your settings and exit the Display Settings dialog, or click Apply if you want to modify other settings in the dialog.

4.4.5 Customizing View Layout

You can arrange the icons in your views in four general ways by using the View->Layout command in the Network Views main window. The four general layout patterns are as follows:

Following immediately below is the general procedure for customizing your view layout. Each layout style has it its own set of options; refer to the subsequent procedures in this section to set options for the layout style you want to use.

The View->Layout command spawns the em_layout binary, if desired, you can run em_layout directly from the command line, outside of Network Views. See Section4.8.1.3 Network Views Layout Options for more information about the em_layout command.

 

To Customize Your View Layout

1. In the Network Views main window, click View->Layout to display the Layout dialog box.

2. Select the Layout Style you want to use from the drop-down list.

3. Specify the desired options for the layout style you have selected.

Refer to the procedures immediately below for more information.

4. Click Apply to update the current view with the options you have selected without exiting the Layout dialog.


Note – Your modifications affect only the current view in the current instance of Network Views. If you add icons to the current view after modifying the layout settings, the new icons do not automatically align according to your settings; you must use the Layout dialog again to apply layout settings to the new icons.

5. Click View->Save Initial Values to View to save the new layout options.

6. Click OK to update the view and exit the dialog.

 

To Set Tile Layout Options

1. In the View->Layout dialog, select Tile from the Layout Style list.

2. Specify horizontal and vertical spacing values, as desired.

3. Specify whether you want the view to contain a fixed number of columns.

If yes, the view will contain the number of columns you specify; otherwise the number of columns will vary according to window size.

4. Click OK or Apply to update the view with your settings.

 

To Set Tree Layout Options

1. In the View->Layout dialog, select Tree from the Layout Style list.

2. Specify whether you want the tree orientation to be horizontal or vertical.

3. Specify whether you want objects at the same hierarchical level to be top-aligned, center-aligned, or bottom-aligned.

4. Specify horizontal and vertical spacing values, as desired.

5. Specify the minimum slope for connecting lines between icons.

Depending on the number of objects in your view, this option can affect the width or height of the displayed object tree.

6. Click OK or Apply to update the view with your settings.

 

To Set Mesh Layout Options

1. In the View->Layout dialog, select Mesh from the Layout Style list.

2. Select mesh options, as desired.

3. Click OK or Apply to update the view with your settings.

 

To Set Cluster Layout Options

1. In the View->Layout dialog, select Cluster from the Layout Style list.

2. Select Cluster options, as desired.

3. Click OK or Apply to update the view with your settings.

4.4.6 Using Background Images

You can configure your Network Views container objects to display a background image. This image can either be a simple bitmap or a geographical map based on real-world latitude and longitude coordinates. For example, you could use a geographical map that displays a blueprint of your building with the location of servers and printers.

The procedure for using background images involves three general steps:

  1. Configure Object Properties - You use the Object Properties dialog to specify the simple bitmap and/or geographical map you want to use for a container object background image.

  2. Enable the display of background images - You can enable or disable the display of background images with the Display Background Image option on the Display tab in the File->Customize->Display Settings dialog.

  3. Enable either a logical or geographical image - You can associate both a simple bitmap and geographical map with an object. The background image that is displayed depends on the Canvas Layout option you select on the Display tab in the File->Customize->Display Settings dialog. If you select Logical for the Canvas layout option, the simple bitmap is used; if you specify Geographical, the geographical map is used.

The procedures for using background images are described below. Please note that the instructions in this section describe the Object Properties dialog and the Display Settings dialog only to the extent required to configure background images. You may also want to refer to the following sections:

 

To Use a Simple Bitmap Background

1. In the Network Views main window, select the container object for which you want to use a background image.


Note – Network Views supports Sun Raster files for background images.

2. Right-click on the object to display the pop-up menu, and then click Properties to display the Object Properties dialog.

3. In the Object Properties dialog, select the Display tab.

4. Type or browse for the name of the Background Image you want to use.

5. Click Apply.

By default, background images are installed in the $EM_HOME/images directory.

6. In the Network Views main window, click File->Customize->Display Settings to open the Display Settings dialog.

7. Select the Display tab, if it is not already selected.

8. Select Logical for the Canvas Layout option.

9. Select On for the Display Background Image option.

10. Click Apply or OK to update the selected view with the background image.

 

To Use a Geographical Map Background

1. In the Network Views main window, select the container object for which you want to use a geographical map background.

You can only use map backgrounds with container objects, like networks and subnetworks. You cannot use map backgrounds with non-container objects, like devices and links.


Note – Several sample geographical map files are provided with your Solstice EM distribution. To install the maps, refer to the instructions in the Solstice EM Installation Guide. The sample map data, if installed, is located by default in $EM_HOME/mapdata directory.

2. Right-click on the object to display the pop-up menu, and then click Properties to display the Object Properties dialog.

3. In the Object Properties dialog, select the Display tab.

4. Type or browse for the name of the Geographical Map you want to use and then click Apply.

By default, geographical maps are installed in the $EM_HOME/mapdata directory.

5. In the Network Views main window, click File->Customize->Display Settings to open the Display Settings dialog.

6. Select the Display tab, if it is not already selected.

7. Select Geographical for the Canvas Layout option.

8. Select On for the Display Background Image option.

9. Click Apply or OK to update the selected view with the geographical map.

See Section 4.3.11 Navigating in Geographical Map Views for instructions on moving around in views that use a geographical map background.

4.4.7 Configuring Double-click Actions

You can use the File->Customize->Double Click Action command to configure the action that occurs when you double-click an object in the Network Views window. By default, double-clicking on container objects switches to the associated object view, whereas clicking on non-container objects, such as devices and links, opens the Alarms tool (em_alarmmgr).

You can configure a unique double-click action for each object type in your Network Views environment. For example, you can configure different actions for hubs and routers.

 

To Configure Double-click Actions

1. In the Network Views main window, click File->Customize->Double Click Action to display the Configure Double Click Action dialog.

2. Select the object type for which you want to configure an action.

3. In the Command field, type the command you want to use for the double-click action, and then click Apply.

See Section 4.8.2 Network Views Command and Variable Macros for a list of the commands you can use in this field.

4. Repeat Steps 2 and 3 to configure additional double-click actions, if desired.

4.4.8 Configuring the Tools Menu

You can use the File->Customize->Tools Menu to add, modify, or remove commands from the Network Views Tools menu.

 

To Add a Tools Menu Entry

1. In the Network Views main window, click File->Customize->Tools Menu to display the Configure Tools dialog.

2. In the Applications list, select the name that precedes the list location where you want to insert the new application.

For example, to insert a new tools menu entry after an existing application named "Application A," select "Application A."

3. Type a new name in the Application Name field.

This is the name that will be displayed on the Tools menu.


Note – If the Application Name field has not been changed before clicking Add, the user will receive the error message: "Add Failed: Duplicate Application Name."

4. In the Path to Executable field, type the path and name of the executable you want to associate with the menu entry.

For example, if you wanted to add the Network Discovery tool (em_discover) to the menu, you would type:
$EM_HOME/bin/em_discover

5. In the Arguments field, type any command line arguments you want to pass to the executable.

For example, if you wanted to run the Network Discovery GUI and connect to the default MIS, you would type:
-host EM_MIS -T
See Section 4.8.2 Network Views Command and Variable Macros for a complete list of Network Views commands and variables.

6. Click Add to post the new entry.

7. Click Apply to update the Tools menu.

8. Click Cancel to close the Configure Tools dialog.

 

To Modify a Tools Menu Entry

1. In the Network Views main window, click File->Customize->Tools Menu to display the Configure Tools dialog.

2. In the Applications list, select the name of the application you want to modify.

3. Enter modified parameters, as desired, in the Application Name, Path to Executable, and Arguments fields.

See Section4.8.2 Network Views Command and Variable Macros for a complete list of Network Views commands and variables.

4. Click Change to accept the modified entry.

5. Click Apply to update the Tools menu.

6. Click Close to close the Configure Tools dialog.

 

To Delete a Tools Menu Entry

1. In the Network Views main window, click File->Customize->Tools Menu to display the Configure Tools dialog.

2. In the Applications list, select the name of the application you want to delete from the Tools menu.

3. Click Delete.

4. Click Apply to update the Tools menu, and then click Close to close the Configure Tools dialog.

4.4.9 Configuring Pop-up Menus

You can use the File->Customize->Pop-up Menus command to configure the menu that displays when you right-click an object in the Network Views window.

You can configure a unique pop-up menu for each object type in your Network Views environment. For example, you can configure different pop-up menus for hubs and routers.

 

To Configure Pop-up Menus

1. In the Network Views main window, click File->Customize->Pop-up Menu to display the Configure Pop-up Menu dialog.

2. Select the Device Type for which you want to configure a pop-up menu.

The existing menu entries, if any, for the selected object type are displayed in the Menu Options list.

3. If desired, select an Object Type from which you want to copy a menu configuration.

Copying an existing menu configuration from another object type is often the easiest way to create or modify a pop-up menu. In many cases, you may find that similar devices--say a SPARC10 and SPARC20 workstation--can use the same pop-up menu configuration.

4. Add, change, or delete Menu Options, as desired.

See Section 4.8.2 Network Views Command and Variable Macros for a list of Network Views commands.

5. Click Apply to update your pop-up menus, and then click Close to close the Configure Pop-up Menu dialog.

4.4.10 Configuring the Object Attributes Command

When you select an object in a Network Views window, and then click Actions->Properties, Network Views opens the Object Properties tool (em_oct) by default. You can configure Network Views to use another object editor, if desired, with the Misc tab in the File->Customize->Display Settings dialog.

 

To Configure the Object Attributes Command

1. In the Network Views main window, click File->Customize->Display Settings to open the Display Settings dialog.

2. Select the Misc tab, if it is not already selected.

3. Type the command you want to use to handle object properties.

The default command is:
$EM_HOME/bin/em_oct -host EM_MIS
This command opens the Object Properties tool and connects to the MIS from which Network Views is running.

4. Click Apply or OK to update the Actions menu.

4.4.11 Adding an Object Type to the Object Palette

The Tools->Object Palette command displays all object types defined in your Network Views environment. The objects displayed here are also those that are available to the View->Create View and Actions->Create commands.

You can add new objects to the Object Palette by editing the Solstice EM init_user file. This is an advanced procedure done outside the Network Views interface, and involves instantiating objects in the MIS, and in some cases restarting the MIS.

 

To Add an Object Type to the Object Palette

1. Determine the class of the object type (Device, Link, Container, and so forth) you want to add.

As an example, in this procedure, you will add a new Container class object called Satellite.

2. Edit the $EM_HOME/conf/init_user file to provide the pertinent information.

For example, to add Satellite as a new Container class, modify init_user to include the following entry (note exact punctuation):

CREATE
{
OC = topoType
SOI = `topoTypeDBId=NULL'
topoTypeId = Satellite
topoTypeDerivedFrom = `{ "Container" }'
topoTypeDrawMethod=circle
topoTypeDefaultLayer = Default
}

By default, your Solstice EM installation includes this example in the init_user file, but the lines are commented out.

3. Configure the new object type so it can be displayed in its own layer.

To do this, the topoTypeDefaultLayer attribute needs to be changed to match the topoTypeId attribute. For example:

CREATE
{
OC = topoType
SOI = `topoTypeDBId=NULL'
topoTypeId = SpecialView
topoTypeDerivedFrom = `{ "Container" }'
topoTypeDrawMethod=circle
topoTypeDefaultLayer = SpecialView
}
 
SET
{
OI = `topoNodeDBId=NULL'
topoAllLayer += `{ "SpecialView" }'
}

4. Create an icon for the Satellite Container class object and save it to the following file:

$EM_HOME/glyphs/Satellite.pm
Network Views will look for the Satellite.pm file to obtain the icon associated with the Satellite object class. This icon must be in X pixmap format (xpm). Other formats may be incompatible with Network Views.

5. Use either of the following two methods to instantiate the Satellite object in the MIS.

4.5 Managing Object Properties

This section provides step-by-step instructions for creating and deleting managed objects, and for viewing and modifying object properties.

You may also want to refer to the following sections for information about other Network Views tasks:

4.5.1 Getting Started With Object Properties

You can run the Object Properties tool as an integrated Network Views component, or as a standalone application. For example, by default, when you right-click a managed object, and then click Properties from the pop-up menu, the Object Properties dialog is displayed. You can also, if you wish, run Object Properties outside of Network Views, from the UNIX command line with the em_oct command.

You can use Object Properties to:

 

To Run Object Properties From the Command Line

4.5.2 Viewing Object Properties

The easiest way to view properties for an existing managed object is to use the Network Views graphical interface. You can also use the command line, if desired, with one or more of the options listed in Section 4.8.1.2 Object Properties Options. The procedure provided here is for viewing object properties from the Network Views interface.

 

To View Properties for an Existing Object

4.5.3 Modifying Object Properties

The easiest way to modify properties for an existing managed object is to use the Network Views graphical interface to invoke the Object Properties tool, and then modify the object properties as desired. You can also use the em_oct command line, if desired, with one or more of the options listed in Section 4.8.1.2 Object Properties Options.

The specific properties that you can modify may vary, depending on the type of object you want to modify. For example, the properties for a container object, like a network or subnetwork, are different than those for a device, like a workstation or a router.

Tasks for modifying object properties can be divided into six general categories:

The procedure below provides a high-level overview of the general steps required to modify managed objects. Subsequent procedures provide more detailed step-by-step instructions for configuring specific object properties. Please note that the instructions here describe how to modify object properties from within the Network Views interface.

 

To Modify a Managed Object

1. In the Network Views main window, use any of the following methods to open the Object Properties dialog with the object you want to modify:

2. Modify the Object Identification fields, as desired.

3. Modify the Object Type, if desired.

You can only change the Object Type within the specific category already defined for the object. For example, if the object you are modifying is a Bridge (Device category), you can change the object to another type of Device, but all other categories will be unavailable.

4. Modify the Detailed Information fields, if desired.

5. When you are done, click Apply or OK to save your changes.

4.5.4 Creating New Managed Objects

The easiest way to create new managed objects is to run a Network Discovery, as described in Chapter 3." You can, however, create managed objects one at a time by using the Object Properties tool.

The procedure for creating a managed object is almost exactly the same as that for modifying an existing object; the primary difference being the ways in which you can start Object Properties. As with modifying existing objects, the specific settings available for your new object depend on the type of object you want to create.

The procedure below provides a high-level overview of the general steps required to create managed objects. Subsequent procedures provide more detailed step-by-step instructions for configuring specific object properties. Please note that the instructions here describe how to create an object from within the Network Views interface.

 

To Create a Managed Object

1. In the Network Views main window, use any of the following methods to open the Object Properties dialog with the object you want to modify:

2. Enter a name for the object in the Object Identification field.

3. Specify an Object Type.

You can only change the Object Type within the specific category you specified when you invoked Object Properties to create the new object. For example, if you clicked Actions->Create->Device->Printer in the Network Views window, the only Object Types available in this instance of Object Properties would be Devices.

4. Modify the Detailed Information fields, if desired.

5. When you are done, click Apply or OK to save your changes.

4.5.5 Configuring Agent Communications

You can use the options on the Agents tab in the Object Properties dialog to configure parameters for SNMP, CMIP, RPC, and MIS agents. You can use the default agent for a given object with a single click of a button, or you can manually configure agents as needed.

The specific agent options available depend on the type of agent you want to configure. The procedures below describe how to automatically configure default agents in general, and how to manually configure each of the four types of agents supported by Solstice EM.

4.5.5.1 Configuring Default Agents

You can configure an object to communicate with a default SNMP, RPC, MIS agent. The default managed object name is the same name as the device you are configuring. The Managed Object Remote Distinguished Name (MO RDN) indicates the relative position in the Management Information Tree (MIT) at which the management information for a given device is located. The default MO RDN is always the base of the agent.


Note – CMIP agents cannot be configured with the default agent function, and must be configured manually.

 

To Configure a Default Agent

1. In the Object Properties dialog, select the Agents tab.

2. Select the type of agent you want to configure from the Protocol drop-down list.

3. Click Configure Default.

4. Select the new agent from the Configured Agents list, and then click Change to display the configuration dialog box for that agent type.

5. Modify configuration information as desired, and then click OK to return to the Object Properties dialog.

See the procedures below for instructions on modifying various agent options.

4.5.5.2 Manually Configuring SNMP Agents

You can manually configure SNMP agents from the Object Properties dialog, or from the UNIX command line with the em_oct -snmp command.

 

To Manually Configure SNMP Agents from the Object Properties Dialog

1. In the Object Properties dialog, select the Agents tab.

2. Select SNMP from the Protocol drop-down list.

3. Click Configure Manually to open the SNMP Configuration dialog.

4. Enter values for each of the fields in the SNMP Configuration dialog:

5. Specify the SNMP MIBs you want to use:

    1. Click Add to display the Add SNMP MIBs dialog.
    2. Use the Add and Remove buttons to specify the MIBs you want to use in the SNMP MIBs to Add list.
    3. When you have finished selecting MIBs, click OK to save your selections and return to the SNMP Configuration dialog.

6. Click Apply or OK to save your configuration and return to the Object Properties dialog.

 

To Configure SNMP Agents From the Command Line

1. Execute the following command at an UNIX prompt to display the SNMP Configuration dialog:

em_oct -snmp

2. Complete the fields as described in the procedure above.

4.5.5.3 Manually Configuring RPC Agents

You can manually configure RPC agents from the Object Properties dialog, or from the UNIX command line with the em_oct -rpc command.

 

To Manually Configure RPC Agents From the Object Properties Dialog

1. In the Object Properties dialog, select the Agents tab.

2. Select RPC from the Protocol drop-down list.

3. Click Configure Manually to open the RPC Configuration dialog.

4. Enter values for each of the fields in the RPC Configuration dialog:

5. Add or remove RPC agents, proxy agents, and SunNet Manager (SNM) schemas, as desired:

    1. Click Add to display the Add RPC Agents dialog.
    2. Use the Add and Remove buttons to specify the RPC agents, proxy agents, and SNM schemas you want to use in the RPC Agents to Add list.
    3. When you have finished selecting agents, click OK to save your selections and return to the RPC Configuration dialog.

6. Click Apply or OK to save your configuration and return to the Object Properties dialog.

 

To Configure RPC Agents From the Command Line

1. Execute the following command at an UNIX prompt to display the RPC Configuration dialog:

em_oct -rpc

2. Complete the fields as described in the procedure above.

4.5.5.4 Manually Configuring MIS Agents

You can manually configure MIS agents from the Object Properties dialog, or from the UNIX command line with the em_oct -mis command. You can configure two types of relationships between an MIS agent and one or more associated objects:

 

To Manually Configure MIS Agents From the Object Properties Dialog

1. In the Object Properties dialog, select the Agents tab.

2. Select MIS from the Protocol drop-down list.

3. Click Configure Manually to open the MIS Configuration dialog.

4. Enter values for each of the fields in the MIS Configuration dialog:

5. Click Apply or OK to save your configuration and return to the Object Properties dialog.

 

To Configure MIS Agents From the Command Line

1. Execute the following command at an UNIX prompt to display the MIS Configuration dialog:

em_oct -mis

2. Complete the fields as described in the procedure above.

4.5.5.5 Manually Configuring CMIP Agents

You can manually configure CMIP agents from the Object Properties dialog, or from the UNIX command line with the em_oct -cmip command.


Note – Unlike other agent protocols in Solstice EM, there is no option to configure default CMIP agents; if you want to use CMIP, you must configure the agents manually.

 

To Manually Configure CMIP Agents From the Object Properties Dialog

1. In the Object Properties dialog, select the Agents tab.

2. Select CMIP from the Protocol drop-down list.

3. Click Configure Manually to open the CMIP Configuration dialog.

4. Specify an Entity Name for the MIS with which you want the CMIP agent to communicate.

5. Select the Basic tab, if it is not already selected, and then enter values for the following:

6. Select the Advanced tab, and then enter values for the following:

7. Click Apply or OK to save your configuration and return to the Object Properties dialog.

 

To Configure CMIP Agents From the Command Line

1. Execute the following command at an UNIX prompt to display the CMIP Configuration dialog:

em_oct -cmip

2. Complete the fields as described in the procedure above.

4.5.5.6 Using Multiple CMIP MPAs Over RFC1006

You can configure multiple CMIP Management Protocol Adapters (MPAs) over RFC1006. RFC1006 is an Internet Engineering Task Force (IETF) specification for "ISO Transport Service on top of the TCP." This section provides instructions for configuring CMIP MPAs on local and remote MIS hosts.


Note – Before starting additional CMIP MPAs, make certain that the CMIP stack on the host machine is configured for RCD1006. See the Solstice EM Management Information Server (MIS) Guide for more instructions. If you just need to restart the CMIP MPA stack, follow the instructions in this chapter, in Section4.5.5.7 Restarting the CMIP MPA Stack.

The general procedure for starting multiple CMIP MPAs over RFC1006 is as follows:

  1. Set the CMIP environment variables.

  2. Verify that the appropriate ancillary MIS processes are running.

  3. Run a CMIP MPA configuration script on the MIS host.

These procedures are described in more detail below.

 

To Set CMIP Environment Variables

1. Set variables for the MIS host and port number, as follows:

EM_MIS_DEFAULT_HOST=localhost
EM_MIS_DEFAUL T_PORT=5555

2. Set the variable for the CMIP MPA TCP port number, as follows:

EM_CMIP_MPA_DEFAULT_PORT=5558

3. Set variables for the OSI address for the CMIP MPA, as follows:

EM_CMIP_MPA_PSEL=rfc2
EM_CMIP_MPA_SSEL=Prs< br>EM_CMIP_MPA_TSEL=CMIP
EM_CMIP_MPA_NSAP=0x8192b81d
 

To Verify if Ancillary MIS Processes are Running

 

To Run a CMIP MPA Configuration Script

1. Run a CMIP MPA configuration script as root on the MIS host.

The following is an example of a shell script that will start two additional CMIP MPAs on the local MIS host.

#!/bin/sh
 
# start additional MPA 1
 
EM_MIS_DEFAULT_HOST=localhost
EM_MIS_DEFAULT_PORT=5555
EM_CMIP_MPA_DEFAULT_PORT=5558
 
EM_CMIP_MPA_PSEL=rfc2
EM_CMIP_MPA_SSEL=Prs
EM_CMIP_MPA_TSEL=CMIP
EM_CMIP_MPA_NSAP=0x8192b81d
 
export EM_CMIP_MPA_PSEL EM_CMIP_MPA_SSEL 
EM_CMIP_MPA_TSEL 
EM_CMIP_MPA_NSAP
export EM_MIS_DEFAULT_HOST
export EM_MIS_DEFAULT_PORT
export EM_CMIP_MPA_DEFAULT_PORT
 
echo "Starting CMIP MPA for port 5558"
/opt/SUNWconn/em/bin/em_cmip &
 
# start additional MPA 2
 
EM_MIS_DEFAULT_HOST=localhost
EM_MIS_DEFAULT_PORT=5555
EM_CMIP_MPA_DEFAULT_PORT=5559
 
EM_CMIP_MPA_PSEL=rfc3
EM_CMIP_MPA_SSEL=Prs
EM_CMIP_MPA_TSEL=CMIP
EM_CMIP_MPA_NSAP=0x8192b81d
 
export EM_CMIP_MPA_PSEL EM_CMIP_MPA_SSEL 
EM_CMIP_MPA_TSEL 
EM_CMIP_MPA_NSAP
export EM_MIS_DEFAULT_HOST
export EM_MIS_DEFAULT_PORT
export EM_CMIP_MPA_DEFAULT_PORT
 
echo "Starting CMIP MPA for port 5559"
/opt/SUNWconn/em/bin/em_cmip &

 

To Start Additional CMIP MPAs Over RFC1006 Remotely

1. Run a CMIP MPA configuration script as root on the machine from which you want to start a CMIP MPA on a remote machine.

The following is an example of a shell script that will start a remote CMIP MPA.

#!/bin/sh
 
EM_MIS_DEFAULT_HOST=greco  ## host name on which MIS is 
running
EM_MIS_DEFAULT_PORT=5555
EM_CMIP_MPA_DEFAULT_PORT=5560
 
EM_CMIP_MPA_PSEL=rem1
EM_CMIP_MPA_SSEL=Prs
EM_CMIP_MPA_TSEL=CMIP
EM_CMIP_MPA_NSAP=0x8192b812
 
export EM_CMIP_MPA_PSEL EM_CMIP_MPA_SSEL 
EM_CMIP_MPA_TSEL 
EM_CMIP_MPA_NSAP
export EM_MIS_DEFAULT_HOST
export EM_MIS_DEFAULT_PORT
export EM_CMIP_MPA_DEFAULT_PORT
 
#quarkqa1 0x8192b812
 
echo "Starting remote CMIP MPA for port 5560"
/opt/SUNWconn/em/bin/em_cmip

2. Start $EM_HOME/bin/em_cmip in the background from the script.

You will be prompted for a password if access control is enabled on the MIS and the host from which you ran the script is not on the MIS host's trusted host list.

4.5.5.7 Restarting the CMIP MPA Stack

If communication is not working properly between the CMIP agents and your newly added CMIP MPAs, you need to restart the CMIP MPA stack.

 

To Restart the CMIP MPA Stack

1. Shut down the current CMIP MPA stack:

/etc/rc2.d/S98cmipmpa stop
/etc/rc2.d/S97osimcs stop
/etc/rc2.d/S90rk6 stop

2. Restart the stack:

/etc/rc2.d/S90rk6 start
/etc/rc2.d/S97osimcs start

4.6 Working With Alarms

This section provides step-by-step instructions for basic viewing and responding to alarm data. Specifically, the following tasks:

Complete information about configuring and managing alarms is provided in Chapter 5."

You may also want to refer to the following sections for information about other Network Views tasks:

4.6.1 Viewing Object Alarms

You can view alarm data for objects that have been configured to generate alarms in the Alarms tool by double-clicking non-container objects, clicking Alarms on the object's pop-up menu, or by selecting the object and clicking Actions->Alarms. All of these actions open the Alarms tool, from which you can view alarm data.

 

To View Alarm Data for an Object

4.6.2 Clearing Object Alarms

You can clear all outstanding alarms against a managed object by clicking Clear All Alarms on the object's pop-up menu, or by selecting an object and clicking Actions->Clear All Alarms.


Note – Clearing alarms on a container object will not clear the alarms of the objects within that container.

 

To Clear Alarms for an Object

4.6.3 Propagating Alarm Severity

You can configure a managed object so that its alarm severity data is passed to any parent object in which it is contained. This makes it possible to view in a parent container object the alarm severity states for one or more child objects. For example, you could have managed objects for several printers contained in a network object; by propagating alarm severity from the printer objects, you could monitor alarm status for all of the printers by watching just the parent network object.

You can propagate alarm severity for individual objects, or for an entire view; the methods for propagating alarms for individual managed objects and for views differ slightly from each other. In all cases, though, you must verify that the display of propagated alarm severities is enabled in the Network Views window.

 

To Verify if Propagated Alarm Severities are Enabled in Network Views

1. In the Network Views main window, click File->Customize->Display Settings to open the Display Settings dialog.

2. In the Display Settings dialog, select the Display tab, if it is not already selected.

3. Select On for the Alarm Severity Relationships option.

4. Select the Colors tab.

5. Select Propagated Alarm Severity for the Icon Color Source, if it is not already selected.

6. Click OK to exit the Display Settings dialog.

See Section 4.4.1 Configuring General Display Properties and Section 4.4.2 Configuring Icon and Label Display for more information about the various Network Views display options associated with propagated alarm severities.
 

To Propagate Alarm Severity From an Individual Child Object to a Parent Object

1. In the Network Views main window, select the child object.

2. Click Actions->Properties to open the Object Properties dialog.

3. In the Object Properties dialog, select the Display tab, if it is not already selected.

4. Select On for the Propagate Severity option, and then click OK to save the setting and exit the Object Properties dialog.

 

To Propagate Alarm Severity for Peer Objects

1. In the Network Views main window, switch to the view for which you want to propagate alarm severity.

2. Click Actions->Propagate Severity.

 

To Remove Severity Propagation for Peer Objects

1. In the Network Views main window, select the object or view for which you want to remove severity propagation.

2. Click Actions->Remove Severity Propagation.

4.7 Working With Requests

This section provides step-by-step instructions for creating, modifying, and starting object requests, and for performing get and set requests. Specifically, this section describes the following tasks:

You may also want to refer to the following sections for information about other Network Views tasks:

You can work with two general types of requests in Network Views, both of which are accessible from the Network Views Tools menu:

See the Customizing Guide for more detailed information about working with advanced Nerve Center requests, advanced request templates, and basic requests. See Chapter 7 " for information about automating advanced Nerve Center requests.

4.7.1 Viewing Advanced Request Information

You can view detailed information about all active Nerve Center requests in the current MIS by clicking Tools->Advanced Requests from the Network Views main window.

 

To View Advanced Request Information

1. In the Network Views main window, click Tools->Advanced Requests to display the Requests dialog.

All available and active requests are displayed in the two lists at the top and bottom of the dialog.

2. In the Active Requests list, select the request for which you want to view detailed information, and then click Examine to open the Request Examine dialog.

4.7.2 Viewing Basic Request Information

You can view fault and performance information about RPC and SNMP (via RPC proxy) managed objects by clicking Tools->Basic Requests from the Network Views main window.

 

To View Basic Agent Request Information

1. In the Network Views main window, select an object for which you want to display basic request information, and then click Tools->Basic Requests to open the Basic Requests tool.

2. In the Basic Requests dialog, click View->Requests or View->Request Groups to view available or active requests, or request groups, as desired.

A list of active requests, available requests, or request groups is displayed, according to your choice.

3. Select the request or request group for which you want more information, and then click Actions->Properties to display detailed information.

4.7.3 Creating, Modifying, and Initiating Advanced Requests

You can use the Network Views Requests dialog to start and stop requests based on existing request templates. You can also use the Requests dialog to open the Request Designer tool, from which you can perform a full range of request management tasks. Complete information about using the Request Designer is provided in the Customizing Guide.

 

To Initiate an Advanced Request

1. In the Network Views main window, click Tools->Advanced Requests to display the Requests dialog.

2. Select the request you want to start from the Available Requests list.

3. Select the target object(s) in the current view, and then click Start.

Alternatively, you can use the middle mouse button to drag a request from the Available Requests list and drop it on an object in the Network Views window.

4. Repeat Steps 2 and 3 for each request you want to initiate, or click Close to exit the Requests dialog.

 

To Halt an Advanced Request

1. In the Network Views main window, click Tools->Advanced Requests to display the Requests dialog.

2. Select the request you want to halt from the Active Requests list.

3. Click Delete.

The request template itself is not deleted from the MIS; only the particular request object instance based on the request template is deleted.

4. Repeat Steps 2 and 3 for each request you want to halt, or click Close to exit the Requests dialog.

 

To Create or Modify an Advanced Request

1. In the Network Views main window, click Tools->Advanced Requests to display the Requests dialog.

2. In the Requests dialog, do either of the following:

3. In the Request Designer, modify or create requests or request templates as desired.

Follow the instructions in the Solstice EM Customizing Guide for complete information about using the Solstice EM Request Designer.

4.7.4 Creating, Modifying, and Initiating Basic Requests

You can use the Basic Requests tool start, stop, create, and modify basic requests and request groups. Complete instructions for using the Basic Requests tool are provided in the Customizing Guide.

 

To Initiate a Basic Request

1. In the Network Views main window, select an object for which you want to initiate a basic request, and then click Tools->Basic Requests to open the Basic Requests tool.

2. Click View->Requests->Active Requests, or View->Request Groups to view active requests or request groups, as desired.

3. Select the request you want to initiate, and then click Actions->Start.

 

To Halt a Basic Request

1. In the Network Views main window, select an object for which you want to halt a basic request, and then click Tools->Basic Requests to open the Basic Requests tool.

2. Click View->Requests->Active Requests, or View->Request Groups to view active requests or request groups, as desired.

3. Select the request you want to halt, and then click Actions->Stop.

 

To Create a Basic Request or Request Group

1. In the Network Views main window, select an object for which you want to create a basic request, and then click Tools->Basic Requests to open the Basic Requests tool.

2. Click Actions->Create->Request or Actions->Create->Request Group, as desired, to open the Create Request or Create Group dialog.

3. Specify Request or Request Group options as needed.

See the Customizing Guide for complete information about the Create Request and Create Request Group options.
 

To Modify a Basic Request or Request Group

1. In the Network Views main window, select an object for which you want to modify a basic request, and then click Tools->Basic Requests to open the Basic Requests tool.

2. Click View->Requests or View->Request Groups to view available or active requests, or request groups, as desired.

A list of active requests, available requests, or request groups is displayed, according to your choice.

3. Select the request or request group you want to modify, and then click Actions->Properties to display detailed information.

If you selected a request group, the Group Properties dialog is displayed. If you selected an individual request, the Request Properties dialog is displayed.

4. Specify Request or Request Group options as needed.

See the Customizing Guide for complete information about the Request Properties and Group Properties dialogs.

4.8 Reference

The remainder of this chapter provides detailed information about command-line options for the various executable files discussed in one or more procedures earlier in the chapter, as well as menu and dialog box options, and other general reference information. Specifically, this reference section includes the following topics:

For detailed information about dialogs, menus, and other user interface elements, refer to the Solstice EM Online Help. To access Online Help, Click the Help button on any dialog box or select options from the Help menu located in the upper right corner of each Solstice EM tool window.

4.8.1 Command-Line Options

This section describes the command-line options for the following tools:

4.8.1.1 Network Views Options

The Network Views command (em_viewer) displays the primary Network Views interface. The general form for the Network Views command is:

 em_viewer -options

The various Network Views command-line options are described in the following table. Step-by-step instructions for using the Network Views tool begin in Section 4.2 Getting Started With Network Views.

TABLE 4-4   Network Views Command-line Options 
Option Description
-help
Print descriptions of em_viewer options.
-host hostname
Specify the remote machine on which the MIS you want to use is located. By default, Network Views uses the local MIS on the machine from which it is invoked. You can specify a DNS name or an IP address.
-init_requests
Initialize requests subsystem.
-no_labels
Suppress the display of object icon labels.
-no_move
Prevent movement of object icons.
-view view
Specify the name of view you want to display when Network Views starts.


4.8.1.2 Object Properties Options

The Object Properties command (em_oct) displays the Object Properties dialog, from which you can create and modify managed objects, and view managed object properties. The Object Properties dialog can also be displayed from the Network Views main window, as described earlier in this chapter. The general form for the Object Properties command is:

 em_oct -options

The various Object Properties command-line options are described in the following table. Step-by-step instructions for using the Object Properties function begin in Section4.5 Managing Object Properties.

TABLE 4-5   Object Properties Command-line Options 
Option Description
-bus_locations x:y:z...
Specify coordinates for a bus object you want to create or modify.
-cmip
Configure a CMIP agent; displays the CMIP Configuration dialog.
-help
Print descriptions of em_oct options.
-host hostname
Specify the remote machine on which the MIS you want to use is located. By default, em_oct uses the local MIS on the machine from which it is invoked. You can specify a DNS name or an IP address.
-id id...
Specify topology IDs; separate multiple IDs with a space.
-link id1 id2
Create a link between id1 and id2.
-mis
Configure an MIS agent; displays the MIS Configuration dialog.
-name name...
Specify the name of an object; separate multiple names with a space.
-parent parent_id
Specify the parent of the object being created or modified
-rpc
Configure an RPC agent; displays the RPC Configuration dialog.
-snmp
Configure an SNMP agent; displays the SNMP Configuration dialog.
-type type
Specify the type of object you want to create.
-visible_children id...
Specify the children of a container object being created or modified; separate multiple IDs with a space.


4.8.1.3 Network Views Layout Options

The Network Views command (em_layout) displays the Network Views Layout dialog, from which you can modify Tree, Tile, Mesh, and Cluster layout options. The Layout dialog can also be displayed by clicking View->Layout in the Network Views main window. The general form for the Network Views Layout command is:

 em_layout -options

The various Layout command-line options are described in the following table. Step-by-step instructions for using the Layout options begin in Section4.4.5 Customizing View Layout.

TABLE 4-6   Network Views Layout Command-line Options  
Option Description
-app_id viewer_instance
Specify the application ID of the instance of Network Views to which you want to connect. You can determine a list of Network Views instances by using the Message Log in the instance.
-help
Print descriptions of em_layout options.
-host hostname
Specify the remote machine on which the MIS you want to used is located. By default, em_oct uses the local MIS on the machine from which it is invoked. You can specify a DNS name or an IP address.


4.8.1.4 Basic Requests Options

The Basic Requests command (em_simplerequests) displays Basic Requests dialog, from which you can start, stop, and manage fault and performance monitoring of RPC and SNMP (via RPC proxy) managed objects. The Basic Requests dialog can also be displayed by clicking Tools->Basic Requests in the Network Views main window. The general form for the Basic Requests command is:

 em_simplerequests -options

The various Basic Requests command-line options are described in the following table. Step-by-step instructions for using the Basic Requests options begin in Section4.7.2 Viewing Basic Request Information. Detailed information about Basic Requests is provided in the Customizing Guide.

TABLE 4-7   Basic Requests Command-line Options 
Option Description
-help
Print descriptions of em_simplerequests options.
-host hostname
Specify the remote machine on which the MIS you want to use is located. By default, Network Views uses the local MIS on the machine from which it is invoked. You can specify a DNS name or an IP address.
-viewer id
Specify the viewer process to which you want to return request information.
-id id...
Specify topology IDs; separate multiple IDs with a space.
-ar
Show available requests on startup.
-rr
Show running requests on startup.
-rg
Show request groups on startup.


4.8.1.5 Request Designer Options

The Request Designer command (em_reqedit) opens the Request Designer tool, from which you can manage advanced requests. The Request Designer is an integral part of the Network Views Request Services function, which is initiated by clicking Tools->Advanced Requests in the Network Views main window. The Request Designer can be displayed from the Network Views Requests dialog by clicking Create or Modify. The general form for the Advanced Requests command line is:

 em_reqedit -options

The various Request Designer command-line options are described in the following table. Basic step-by-step instructions for using the Request Designer options begin in Section4.7.3 Creating, Modifying, and Initiating Advanced Requests. Detailed information about using the Request Designer is provided in the Solstice EM Customizing Guide.

TABLE 4-8   Advanced Requests Command-line Options  
Option Description
-help
Print descriptions of em_reqedit options.
-host hostname
Specify the remote machine on which the MIS you want to use is located. By default, Network Views uses the local MIS on the machine from which it is invoked. You can specify a DNS name or an IP address.
-template template
Specify the name of a request template to load.


4.8.2 Network Views Command and Variable Macros

You can customize the Network Views Tools menu, pop-up menu, and double-click actions to perform a wide range of functions. The procedures for configuring these items are described earlier in this chapter, beginning with Section4.4.7 Configuring Double-click Actions.

The configuration procedure for each of these items includes specifying a command line to execute when a given action is performed. For example, you can define a command to execute when an object is double-clicked. The table below lists the Network Views command and variable macros you can use when configuring command lines for Tools menu, pop-up menu, and double-click actions.

TABLE 4-9   Network Views Command and Variable Macros 
Macro Description
Command Macros
EM_GOTOVIEW
For double-click actions and pop-up menus, changes the current view to the associated object. An error will result if assigned to an object that is not a view (for example a Container or Monitor).
EM_VIEWERCONFIG
Launches em_oct (Object Properties tool).
Variable Macros
EM_OBJNAME
For double-click actions and pop-up menus, substitutes the name of the associated object. For the Tools menu, substitutes the name of the selected object. If more than one object is selected, the object used is arbitrary.
EM_OBJNAMES
For double-click actions and pop-up menus, substitutes the name of the associated object. For the Tools menu, substitutes the names of all selected objects.
EM_OPTIONAL_UNIQUE_IDS
Same as EM_UNIQUE_ID, except the substitution of object identifiers occurs only if object identifiers are specified, otherwise the variable is ignored.
EM_UNIQUE_ID
Same as EM_OBJNAME, except the unique object identifier system-name:id is substituted instead of the object name. Use this to integrate with other EM applications that accept the -id command line option.
EM_UNIQUE_IDS
Same as EM_OBJNAMES, except the unique object identifier system-name:id is substituted instead of the object name. Use this to integrate with other EM applications that accept the -id command line option.
EM_VIEW
Substitutes the name of the current view.
EM_VIEW_UNIQUE_ID
Same as EM_VIEW, except the unique object identifier system-name:id is substituted instead of the object name. Use this to integrate with other EM applications that accept the -id command line option.
EM_MIS
Substitutes the name of the MIS system to which the current instance of Network Views is connected.


4.8.3 More About Object Properties

This section provides detailed tabular listings for:

4.8.3.1 Network Views Object Types

The table below provides descriptions of the various types of Network Views objects you can create, along with their default associated icons.

TABLE 4-10   Network Views Object Icons and Types 
Object Name Object Type Default Icon Description
Array
Array

Contains a group of objects in a compact array. The object names are displayed in the array cells.
Bridge
Device

Device object representing a network bridge.
BSC
Device

Device object representing a base station controller
BTS
Device

Device object representing a base transceiver station
Bus
Bus

A free-standing multisegmented line; links objects that are connected to it. Any links attached to the bus will be connected along the shortest path.
Bus Container
Bus

Same as a Bus object, above, but can also contain other Bus objects.
Circle
Multimonitor

Container object with up to 360 object view sections; each section represents a view of one of the objects contained within it.
Container
Container

Basic container object; often used for logical constructs, like views, networks, and subnetworks.
Device
Device

Represents an object that cannot contain another object--used for physical components, like hosts, routers, and hubs. Devices are connected by link and bus objects.
Hexagon
Multimonitor

Container object with six object view sections; each section represents a view of one of the objects contained within it.
Hexagon120
Multimonitor

Container object with three object view sections; each section represents a view of one of the objects contained within it.
HLR
Device

Device object representing a home location register.
Host
Device

Device object representing a host machine.
Hub
Device

Device object representing a network hub.
Interface
Device

Device object representing an interface that connects two or more hosts or other network devices.
Java
Sun
(Device)

Platform-specific object representing a Sun Javastation.
Link
Link

Link object connecting two other objects; a link container can also contain other objects.
MSC
Container

Container object representing a mobile switching center.
Network
Container

Container object representing a network.
OMC
Device

Device object representing an operations and maintenance center.
Omnisector
Multimonitor

Container object with a single object view section representing a view of the object it contains.
PC
Device

Device object representing a PC.
Printer
Device

Device object representing a printer.
Router




Device











Device object representing a network router.






RouterArray
Device

Device object representing a network router array.


RouterContainer
Device
*
*placeholder for description and icon
Server
Device

Device object representing a server machine.
SPARC
Sun
(Device)

Platform-specific object representing a Sun SPARCstation.
Subnetwork
Container

Container object representing a subnetwork.
Universe
Container

Enterprise-wide container object representing multiple local and wide area networks.
VLR
Device

Device object representing a visitor location register.
XCDR
Device

Device object representing a network transcoder.
Vendor-specific
Varies
(Device)
Varies
Custom or platform specific objects; for example Sun devices. See the Customizing Guide for information about adding object definitions and icons to the Network Views Object Palette.


4.8.3.2 Configurable Object Type Data

The table below lists the data you can configure in the Object Properties dialog for each of the Network Views object types.

TABLE 4-11   OCT Object Types and Configurable Data 
Object Type Array Configurable Data
Bus
Bus Container
defaultData, snm-busdotethernetData
Container
Network
networkData, snm-viewdotbuildingData, snm-viewdotnetworkData, snm-viewdotstarData, snm-viewdotringData, snm-viewdotbusData
Subnetwork
subnetData, snm-viewdotsubnetData, snm-viewdotcampusData
Universe
defaultData
Device
Bridge
defaultData, snm-componentdotbridgeData
Host
hostData, snm-componentdotss1Data, snm-componentdotss2Data, snm-componentdotss5Data, snm-componentdotipcData,snm-componentdotipxData,snm-component dotlxData, snm-componentdotss10Data, snm-componentdotss20Data, snm-componentdotsun3Data, snm-componentdotsun4Data, snm-componentdotsun470Data, snm-componentdotgenwsData, snm-componentdotworkstationData, snm-componentdotgenhostData, snm-componentdotlaptopData, snm-componentdotxhynterminalData,snm-componentdotlanboxData
Hub
defaultData, snm-componentdothubData
Interface
defaultData
Pc
hostData, snm-componentdotsun386Data, snm-componentdotpcData
Printer
hostData, snm-componentdotlaserwriterData, snm-componentdotprinterData, snm-componentdotnewsprinterData
Router
routerData, snm-componentdotrouterData
Server
defaultData, snm-componentdotsunhynserverData, snm-componentdotsc1000Data, snm-componentdotsc2000Data, snm-componentdotss330Data, snm-componentdotss370Data, snm-componentdotserverData, snm-componentdottermsrvrData
Sunws
hostData. snm-componentdotsunhynworkstationData, snm-componentdotsunhyndesksideData
Link
Link Container
linkData, snm-connectiondotlinkData, snm-connectiondotrs232Data
Monitor
Circle
defaultData


Hexagon
defaultData


Hexagon120
defaultData


OmniSector
defaultData


4.8.4 More About Geographical Map Backgrounds

Network Views lets you use geographical maps as background images for container objects. The procedures for doing this are provided earlier in this chapter, in Section4.4.6 Using Background Images. This section describes geographical map backgrounds in more detail, and describes what you need to do to add new map backgrounds to the Network Views environment.

4.8.4.1 Components of Geographical Map Backgrounds

Geographical map backgrounds in Network Views comprise two components:

By default, MD files and GMC files are stored in $EM_HOME/mapdata. If desired, you can store the MD files in a separate directory from the GMC files, because GMC files contain an absolute path description of the location of their associated MD files.

4.8.4.2 Adding New Geographical Maps

To add a geographical map background to the Network Views environment, you must first obtain a suitable MD file, and then create an associated GMC file. See Section 4.8.4.3 Geographical Map Configuration Files for an explanation of the GMC file structure.

4.8.4.3 Geographical Map Configuration Files

GMC files consist of three sections:

Each of these sections is described in more detail below, followed by an example of the three sections put together in a sample GMC file.

Section 1 - Absolute Path to MD Files

Specify the absolute path to the MD files. Use the following format:

TvFileDir
absolute_pathname

TvFileDir indicates the absolute path to the directory containing the MD files.

Section 2 - Relative Path to Style Sheets and Symbol Files

Specify the relative path--that is, relative to the TvFileDir, above--to any style sheet or symbol files to be used when generating the geographical map background. Use the following format:

TvStyleSheet
TvSymbols
relative_pathname
relative_pathname

Section 3 - Relative Path List of Component MD Files

Specify the relative path to the component MD files to be used when generating the geographical map background. Each component MD file represents a map layer in the Network Views window. Use the following format:

Y | N
relative_pathname
"label"

Sample GMC File

A sample GMC file containing the three sections described above is as follows:

TvFileDir
/opt/SUNWconn/em/mapdata/so-ca
TvStyleSheet
TvStyleSheet
TvSymbols
TvSymbols
Y
Apodj.tv
"DCW: Areas - Political & Ocean"
Y
Appdj.tv
"DCW: Areas - Populated Places"
Y
Ldndj.tv
"DCW: Areas - Rivers & Lakes"
Y
Lpodj.tv
"DCW: Lines - Ocean Features"
Y
Lrddj.tv
"DCW: Lines - Roads"
Y
Lrrdj.tv
"DCW: Lines - Railroads"
Y
Ltsdj.tv
"DCW: Lines - Bridges & Tunnels"
Y
Lutdj.tv
"DCW: Lines - Pipelines & Power Lines"
Y
Pdndj.tv
"DCW: Lines - Rivers & Lakes"
Y
Pdsdj.tv
"DCW: Lines - Misc. Rivers & Lakes"
Y
Pofdj.tv
"DCW: Point - Ocean Features"
Y
Ppodj.tv
"DCW: Point - Political & Ocean"
Y
Pppdj.tv
"DCW: Point - Populated Places"
Y
Tdndj.tv
"DCW: Text - Rivers & Lakes"
Y
Tpodj.tv
"DCW: Text - Political & Ocean"
Y
Tppdj.tv
"DCW: Text - Populated Places"
Y
Trddj.tv
"DCW: Text - Roads"
Y
Tutdj.tv
"DCW: Text - Pipelines & Power Lines"


Sun Microsystems, Inc.
Copyright information. All rights reserved.
Doc Set  |   Contents   |   Previous   |   Next   |   Index