8.3 Designing Service Map Views

To design a Service Map view, create a new Service Map view or check out an existing Service Map view from the CCDB. The Control Center console provides a variety of tools for designing the Service Map view.

The Enterprise Layout view of the Navigation pane enables you to select the objects, Events views, Servers views, and other Service Map views you want to embed into the Service Map view. When embedding a view, you can embed views from other management groups to provide the most flexible filtering mechanism and display only the objects you want in the corresponding view. To embed an object or view, drag the item onto the view pane.

The view pane enables you to edit the contents of a Service Map view. While a Service Map view is checked out, the workspace banner indicates the Service Map view is “Under Construction” and displays the name and description of the Service Map view.

The Service Map ribbon enables you to add rectangles, ellipses, rounded rectangles, text boxes, custom node objects, and links (lines or arrows) between objects. You can also set a background image.

8.3.1 Creating Service Map Views

Use the Control Center console to create and edit Service Map views. From the Enterprise Layout view of the Navigation pane, you can create a new Service Map view or check out an existing Service Map view from the CCDB. Note that you can continue to use other Control Center views while a Service Map view is checked out. You can also create a new Service Map view and embed it in another Service Map view.

To create a Service Map view:

  1. In the Enterprise Layout view of the Navigation pane, right-click a management group or folder where you want to create the Service Map view, and then click New > Service Map.

  2. In the General tab, specify the options you want for the Service Map view. For more information about these options, see the Help.

  3. In the Grid tab, specify the grid options you want for the Service Map view. For more information about grid options, see the Help.

  4. Click OK.

To change the properties of a Service Map view:

  1. In the Enterprise Layout view of the Navigation pane, right-click the Service Map view you want, and then click View Properties > General.

  2. In the General tab of the Service Map View Properties window, update the options you want for the Service Map view. For more information about these options, see the Help.

  3. In the Grid tab, update the grid options you want for the Service Map view. For more information about grid options, see the Help.

  4. Click OK.

8.3.2 Adding and Deleting Objects

To add discovered objects to a Service Map view, drag and drop objects onto the view pane from the Enterprise Layout view of the Navigation pane. You can also add objects from the Servers group in the Tasks pane. Add discovered objects to a Service Map view to manage events, jobs, custom properties, and data streams and view discovery details for the object. If you want to represent an object that is not discovered, you can use a custom node. For more information, see Section 8.3.10, Adding a Custom Node.

The default object name uses the format <computer>\<object>. For example, an IIS server installed on WebServer01 has the default name WebServer01\IIS Server:WebServer01. The memory object for the computer WebServer01 is named WebServer01\Memory.

To add objects to a Service Map view, the Service Map view must be checked out of the CCDB. Objects do not display event status information until after you check the Service Map view into the database.

After you add AppManager objects to the workspace, you can visually connect them to other AppManager objects and embedded views using lines and arrows. For more information, see Section 8.3.8, Connecting AppManager Objects.

To delete an object from a Service Map view, right-click the object and then click Delete. This removes the object from the Service Map view.

If an object is deleted from the Enterprise Layout view of the Navigation pane, the corresponding object in any Service Map views is not deleted. Instead the object is displayed with a Deleted icon. If the same object is re-discovered, the object is not updated in any Service Map views and continues to indicate the object has been deleted. You must manually delete the object from any Service Map views and add it again.

8.3.3 Modifying Object Properties

Once you add an object to a Service Map view, you can change the properties of the object, such as the object name, label color, and icon size. You can also use custom icons.

To change the properties of an object in a Service Map view:

  1. Check out the Service Map with the object whose properties you want to modify.

  2. Right-click the object you want to modify, and then click Object Properties.

  3. In the Object Properties window, make your changes. For more information, see the Help.

  4. Click OK.

8.3.4 Embedding a View

You can embed a Service Map view, Servers view, or Events view in a Service Map view. To embed a view, drag and drop the Servers, Events, or Service Map view you want from the Enterprise Layout view of the Navigation pane onto the view pane. To embed a view, the Service Map view must be checked out of the CCDB.

Embedded views offer the following capabilities:

  • Service Map views provide “drill down” access to other Service Map views that give more detailed information. For example, to reduce the complexity of a Service Map view, you can create a top-level Service Map view with embedded Service Map views that have additional details.

  • Servers views enable you to manage a dynamic list of events, jobs, and custom properties, and view discovery details. Take advantage of the advanced filtering capabilities provided by rule-based management groups and embed a Servers view from a management group that filters only the objects that correspond to the Service Map view. As the rule-based management group filters matching objects, the embedded Servers view reflects those changes.

    For example, in a Service Map view that displays a business process that relies upon SQL Server databases named DB_Commerce, instead of adding each database object, embed a Servers view that belongs to a rule-based management group which filters databases named DB_Commerce. If your business infrastructure adds or removes a DB_Commerce database, the embedded Servers view automatically reflects that change.

  • Events views enable you to manage a dynamic list of events. Take advantage of the advanced filtering capabilities provided by rule-based management groups and embed an Events view from a management group that filters only the objects that correspond to the Service Map view. As the rule-based management group filters matching objects, the embedded Events view reflects corresponding events.

    For example, you can create a Service Map view that functions as a simple warning system for the availability of a Web site you are hosting. If the monitored Web site becomes unavailable, the related object will indicate an event condition.

Note that you can embed Events, Servers, and Service Map views from any management group.

Once you add a view to a Service Map view, you can change the properties of the view, such as the name, label color, and icon size. You can also use custom icons.

To change the properties of a view embedded in a Service Map view:

  1. Check out the Service Map with the view whose properties you want to modify.

  2. Right-click the view you want to modify, and then click Object Properties.

  3. In the Sub View Properties window, make your changes. For more information, see the Help.

  4. Click OK.

8.3.5 Editing Objects in a Service Map

Once you add objects to a Service Map view, you can edit those objects using the tools available on the Service Map tab of the ribbon. After you select an object, you can:

  • Edit the properties of the object by right-clicking to select Object Properties.

  • Move the object by dragging it with the mouse.

  • Copy the object to the clipboard.

  • Paste the object to the same or different Service Map views.

  • Delete the object.

Note that you can undo or redo an action by clicking Undo and Redo in the Edit group on the Service Map tab of the ribbon.

To select multiple objects, press Ctrl while making your selections or drag the cursor around the objects you want.

8.3.6 Showing and Hiding the Grid

Use the grid to help you align objects in the workspace. With the grid displayed, when you move an object in the workspace, the object is automatically aligned to the nearest grid point. By automatically aligning objects, also known as “snap to grid,” you can quickly and easily align objects.

By default, the workspace is configured to display the grid. To hide or show the grid, right-click the workspace and click Show/Hide Grid.

8.3.7 Adding and Formatting Text

You can add text to a Service Map view. Note that most objects that appear in a Service Map view can be configured to display corresponding label text.

After you add text, you can configure the text properties to specify font size, color, and automatic line wrapping.

To add text:

  1. Check out the Service Map where you want to add text.

  2. On the Service Map tab, in the Tools group, click Text.

  3. In the view pane, click on the Service Map where you want to place the text.

  4. Type the text you want to add to the Service Map view.

  5. When you finish adding text, click on the view pane outside the text box.

  6. (Conditional) If you need to format the text, right click the text box and select Object Properties.

    1. Modify the text properties, such as font and background colors, text wrapping, and font size.

    2. Click OK.

8.3.8 Connecting AppManager Objects

Connect AppManager objects and embedded views to indicate relationships and direction. You can connect AppManager objects and embedded views using the Link with Left Arrow, Link with Right Arrow, > Link with No Arrows, and Link with Double Arrows link tools. You cannot use the link tools to draw lines or to create links between shapes you have drawn, such as an ellipse, rectangle, or rounded rectangle.

After connecting objects, you can configure the link properties to:

  • Add a label to the link.

  • Change the width and color of the link.

  • Change the link end style.

  • Use a curved line.

To create a link:

  1. With the Service Map view checked out, on the Service Map tab of the ribbon, in the Tools group, click the Link with Left Arrow, Link with Right Arrow, > Link with No Arrows, or Link with Double Arrows link tool.

  2. In the view pane, click the objects you want to connect. The link is created using the default link properties.

Once you add a link to a Service Map view, you can change the properties of the link, such as the label, link color, and link width. You can also change end styles.

To change the properties of a link in a Service Map view:

  1. Check out the Service Map with the links whose properties you want to modify.

  2. Right-click a link you want to modify, and then click Object Properties.

  3. In the Object Properties window, make your changes. For more information, see the Help.

  4. Click OK.

8.3.9 Drawing an Ellipse, Rectangle, or Rounded Rectangle

Use the ellipse, rectangle, and rounded rectangle tools to draw shapes.

To draw a shape:

  1. With the Service Map view checked out, on the Service Map tab of the ribbon, in the Tools group, select the Ellipse, Rectangle, or Rounded Rectangle tool.

  2. Click and drag the tool in the view pane to create the shape.

  3. To resize the shape, select the pointer and drag an object handle.

Once you add a shape to a Service Map view, you can change the properties of the shape, such as color, fill type, border width, and transparency.

To change the properties of a shape in a Service Map view:

  1. Check out the Service Map with the shape whose properties you want to modify.

  2. Right-click a shape you want to modify, and then click Object Properties.

  3. In the Shape Properties window, make your changes. For more information, see the Help.

  4. Click OK.

8.3.10 Adding a Custom Node

Use a custom node to represent an AppManager object that is not available from the Enterprise Layout view of the Navigation pane. This object can be used as a placeholder.

To add a custom node, on the Service Map tab, in the Tools group, click Custom Node, and then click in the workspace where you want to add the custom node. The custom node is created with a default label.

After you add a custom node, you can edit its properties.

To change the properties of a custom node:

  1. Check out the Service Map view with the custom node whose properties you want to modify.

  2. Right-click the custom node you want to modify, and then click Object Properties.

  3. In the Custom Node Properties window, make your changes.

  4. Click OK.

8.3.11 Adding a Background Image

To clarify the relationships between objects, you can also add a background image such as an underlying geographical map or floor plan. A background image is anchored to the top-left corner of the map, and is displayed in its original dimensions. If you need to resize the image, use an image-manipulation program, and then reload it.

You can add a background image from a physical disk, the Windows clipboard, or the CCDB. After you add a background image, it is stored in the CCDB.

You can use images in the following formats:

  • BMP

  • EMF

  • GIF

  • JPG

  • PNG

  • TIFF

  • WMF

NOTE:If you want the Control Center console to load the Service Map views faster, use the JPG or PNG formats for the background image.

To add or change a background image:

  1. With the Service Map view checked out, on the Service Map tab of the ribbon, in the Tasks group, click Set Background Image or right-click the view pane and click Set Background Image.

  2. In the Background Image Properties window, select an option to load the image.

    For...

    Do this...

    File

    Click this option and click Browse to select the file from a physical disk and store it in the CCDB.

    Database

    Click this option and click Browse to select the file from a list of files in the CCDB.

    Windows Clipboard

    Click this option and click Paste to select an item from the Windows clipboard and store it in the CCDB.

    None

    Click this option to not display a background image.

  3. Click OK.

8.3.12 Checking a Service Map View Into and Out of the CCDB

To save your changes, check the Service Map view into the CCDB. To check in a Service Map view, on the Service Map tab of the ribbon, in the Tasks group, click Check In. In the Enterprise Layout view of the Navigation pane, you can also right-click the Service Map view and click Check In.

When you check a Service Map view in, the object icons change to reflect event conditions. If you check in a Service Map view that references a large number of objects, some objects in the Service Map view might remain gray while information about their event conditions is retrieved from the CCDB. Once that information is retrieved, the object icons changes to reflect event conditions. During this time, the Service Map view is operable.

To check a Service Map view out of the CCDB, on the Service Map tab of the ribbon, in the Tasks group, click Check Out. In the Enterprise Layout view of the Navigation pane, you can also right-click the Service Map view and click Check Out. In the view pane, you can now edit the Service Map view.

Note that while a Service Map view is checked out, it cannot be checked out by another user. To determine who has checked out a Service Map view, display the Service Map view properties. For more information, see Section 8.3.1, Creating Service Map Views.

After you check out a Service Map view, event status for the objects in the view is not displayed.

8.3.13 Reverting to the Previous Version of a Service Map View

When you check in a Service Map view, the revision number of the view is updated.

While you have a Service Map view checked out, you can revert to the most recent revision number. For example, if you have made a number of changes that you do not want to implement, you can revert to the last revision of the Service Map view.

To revert to the last revision of a Service Map view, on the Service Map tab of the ribbon, in the Tasks group, click Revert. You can also right-click the Service Map view in the view pane, and then click Revert. The last revision of the Service Map view is displayed in read-only mode.

8.3.14 Exporting a Service Map View to an Image File

The ServiceMapImageExporter.exe command line program enables you to export a Service Map view to an image file. This program is located in:

<install_dir>\NetIQ\AppManager\Control Center\bin

This command line program is useful when you want to view the status of several Service Map views, for example, as part of a presentation. You can use Microsoft Task Scheduler to run the ServiceMapImageExporter.exe command line program and export all of your Service Map views.

To configure Microsoft Task Scheduler to run more frequently than on a daily basis, configure the Advanced properties for the task. Alternatively, you can use the NTAdmin_RunDos Knowledge Script to run the ServiceMapImageExporter.exe command line program.

To run this utility from a command prompt, first change directories to: <install_dir>\NetIQ\AppManager\Control Center\bin.

Here are some examples of how to run ServiceMapImageExporter.exe:

  • For Windows authentication: Servicemapimageexporter.exe /trust /S <server_name> /V "AppManager\Master\New Service Map View 1"

  • For SQL authentication: Servicemapimageexporter.exe /U <sql_user> /P <password> /s <server_name> /V "AppManager\Master\New Service Map View 1"

For different image formats:

  • For PNG format: Servicemapimageexporter.exe /trust /s <server_name> /V "AppManager\Master\New Service Map View 1" /I PNG

  • For JPEG format: Servicemapimageexporter.exe /trust /s <server_name> /V "AppManager\Master\New Service Map View 1" /I JPEG

  • For BMP format: Servicemapimageexporter.exe /trust /s <server_name> /V "AppManager\Master\New Service Map View 1" /I BMP

  • For GIF format: Servicemapimageexporter.exe /trust /s <server_name> /V "AppManager\Master\New Service Map View 1" /I GIF

  • For TIFF format: Servicemapimageexporter.exe /trust /s <server_name> /V "AppManager\Master\New Service Map View 1" /I TIFF

In the examples offered, <server_name> indicates the name of the Control Center repository server. Information about how to configure the ServiceMapImageExporter.exe program is available from the command line by typing ServiceMapImageExporter.exe and pressing Enter.

8.3.15 Viewing Revision History for a Service Map View

The revision history helps you keep track of when and by whom changes have been made to a Service Map view.

To see the revision history for a Service Map view:

  1. In the Enterprise Layout view of the Navigation pane, select the Service Map view you want.

  2. On the Service Map tab of the ribbon, in the View group, click Revision History.

  3. The Revision History window displays the following information:

    Column

    Explanation

    Revision

    The number of times the map has been revised. Note that you can only revert to the most recent version of a Service Map view.

    Action Time

    The date and time of a particular action on the Service Map view.

    User

    The user who initiated the action on the Service Map view.

    Action

    The action taken on the Service Map view (for example, Created, Checked Out, Checked In).

  4. Click OK to close the window.