Archived - Map dashlet

To add a Map dashlet to a custom dashboard

Making changes to a map

To change a map's overlay

To highlight a specific View, service or network path on a map

To specify which links to display on a map

To highlight specific objects on a map

To change the layout of objects on a map

To change the background image of a map

To navigate around a map

To drill down into Subviews

To drill down into a device or object

To drill down into connections

To add a custom device to a map

The Map dashlet shows you a topology map display of the managed objects in a View or Subview.

The Map dashlet is only applicable to Views and Subviews. It is not applicable to any other data source (e.g. devices, services, components etc).

The network topology delivered through maps is the product of a number of discovery technologies. Maps can combine these technologies to provide a clear view of the network topology. Please see this article for further information on the connectivity discovery technologies used in ENA.

To add a Map dashlet to a custom dashboard:

1. When adding a dashlet to a new custom dashboard or editing an existing custom dashboard, follow the instructions for adding a dashlet, select Map in the Select Dashlet Type, and click Next.
2. The Create Dashlet form will slide in on the right. Enter a name of your dashlet in the Name field.
3. You can then choose the source of the data to be displayed in the map.
   
   
   The Map dashlet can only display data where the source is a View.
   
   
   • If you want this dashlet to source its data from the context of its parent dashboard, select Dashboard. You can see the context of the parent dashboard in the Dashboard Context field at the top of the form.
   • If you want this dashlet to source its data from another dashlet in this current dashboard, select Dashlet.
   • If you want this dashlet to source its data from a specific View on your network, select Fixed Object. You can then click Browse to an object to search for the View in Explorer, or drag into the box your desired View in from another browser window.
4. Select whether you want the map to have a Status or Utilization overlay in the Overlay field.
5. Select whether you want the map to highlight a View, service or network path, or none in the Highlight field.
6. Select the links you want to display on the map in the Links field.
7. Click the AdvancedSettings field to open the Advanced Settings form.
   1. Choose whether you want to hide the title of the dashlet in the Hide Title Bar field. If selected, the dashlet's Overflow Menu will also be hidden, but in the Promote Menu Options field you can then choose if you want to display the options in the dashlet's Overflow Menu in the overall dashboard's Overflow Menu.
   2. Choose whether you want the dashlet to automatically refresh in the Auto Refresh field. By default this is set to On.
   3. Click Done in the top right of the form to save and return to the Create Dashlet form, otherwise click Cancel.
8. Click Done in the top right of the form to save, otherwise click Cancel.

Making changes to a map:

In order to make and save changes to a map, you must belong to a user group that has the Edit permission for the View to which the map belongs. Please see this article for help and information on setting View permissions.

To change a map's overlay:

By default, the map overlay is set to 'Status'.

1. Click Overlay: Status. The Map Overlay form will slide in on the right.
2. Click the field and select Status or Utilization.
   • Status - displays the state of the managed objects and their links.
   • Utilization - displays the utilization of links between objects and the CPU utilization of devices.
3. Click Done in the top right of the form to save and exit, or Cancel to cancel.

The status colors are as follows:

Link Color	Link Status	Description
	Down	device or port is being polled and is down.
	Degraded	device or port is being polled and is degraded.
	Unknown	device or port is being polled, but ENA could not determine the status, for example because: -device unreachable but not root cause. -port data unavailable because the device is down.
	OK	device or port is being polled and is OK.
none	Administrative Down	ENA identifies an object as administrative down when: -for a device, polling of the device is disabled. -it is a custom device and is therefore not polled. -for a port, it is set to administrative down. -a link does not have an associated port, e.g. when using a physical connection.

The utilization colors are as follows:

Object Color	Link Color	Utilization Status	(Object Status)	Description
		Critical	(Ok/Degraded)	device or port is responding and has crossed its critical utilization threshold.
		High	(Ok/Degraded)	device or port is responding and has crossed its high utilization threshold.
		Low	(Ok/Degraded)	device or port is responding and has crossed its low utilization threshold.
		Unknown	(Ok/Degraded)	device or port utilization could not be determined.
		Any	(Unknown)	device or port utilization could not be determined.
		Any	(Down)	device or port utilization could not be determined.
		Normal	(OK/Degraded)	device or port is responding and has not any utilization thresholds.
none		Any	(Administrative Down)	ENA identifies an object as administrative down when: -for a device, polling of the device is disabled. -it is a custom device and is therefore not polled. -for a port, it is set to administrative down. -a link does not have an associated port, e.g. when using a physical connection rather than to an interface on the device.
none		Any	(System Uninitialized)	device or port has not yet been fully discovered by the system.
none		Null (no data returned)	(Ok/Degraded)	device or port is OK, but utilization data cannot be retrieved. Possible causes might include: -the device might be a hypervisor or a managed host. -the map's Links are displaying only routing links, and the routing protocols do not refer to ports.

To highlight a specific View, service or network path on a map:

By default, the map highlight is set to 'None'. 

1. Click Highlight: None. The Map Highlight form will slide in on the right.
2. Click the Highlight field and select what you want to highlight on the map:
   • None - no highlights.
   • View - select View, and then from the View field below, select the View you want to highlight.
   • Service - select Service, and then below select the View which your desired service is in, and then below select your desired service.
   • Network Path - select Network Path, and then below select the View which your desired network path is in, and then below select your desired network path.
3. Click Done in the top right of the form to save and exit, or Cancel to cancel.

To specify which links to display on a map:

 By default, the map link type is set to 'All'.

1. Click Links: All. The Map Link Types form will slide in on the right.
2. Select or deselect the types of links you want or do not want to be highlighted on the map.
3. Click Done in the top right of the form to save and exit, or Cancel to cancel.

To highlight specific objects on a map:

1. Navigate to the desired map dashlet.
2. In the Search box in the top right of the dashlet, enter the name of the object for which you want to search and press Enter.
3. All objects with the search term that you have entered will be highlighted with a pulsing blue circle.
4. To remove the highlight, clear the text from the Search box.

To change the layout of objects on a map:

1. Navigate to the Map dashboard for your selected subview.
2. On the map itself, click and hold down the mouse button on the subview/device you want to move. A purple highlight will appear on the object, so that you can see exactly which object it is you have selected. Drag the object to where you want to move it. The connections from this object will move with it in real time, showing you how the map will look.
3. To move two or more objects at the same time and in the same arrangement, hold CTRL and select the objects you want to move. Drag any of the highlighted objects to where you want them to be moved.

To change the background image of a map:

You can change the background of the map from a blank page to an image of your choice. E.g. you might want to change the background to a map or a plan of an office, and then change the layout of the objects on the map to reflect their real life positions.

1. Navigate to your desired Map dashlet.
2. Right click on the map to open the map's Context Menu and click Background Settings. This will open the Background Image Settings form on the right.
   • Select an image file from the browser, or drag an image file in to the file box.
   • Once you have selected a file, specify the Background Image Settings, either Fit (default), Fill or Stretch.
   • Click Save to save your changes, otherwise click Cancel.

To navigate around a map:

1. Navigate to the Map dashboard for your selected subview.
2. Use your mouse scroll wheel to zoom in and out. Note that you can zoom in and out even whilst you are dragging an object. Alternatively, right click anywhere in the map's blank space and click Fit ToView, Zoom In or Zoom Out.
3. Click and hold anywhere in the map's blank space and then drag the mouse in the direction you want to move the map. Release the mouse button to stop moving the map.

To drill down into a Subview:

1. Navigate to the Map dashboard for your selected View/Subview.
2. Double click on a Subview. This will take you to the selected Subview's level in the hierarchy, and will open its own Map dashboard.
3. You can also right click on a Subview to access more options from a drop down menu. These are:
   • Create View - opens the New View form.
   • Delete View - deletes the View. A deletion confirmation window will open.
   • Edit View - opens the Edit View form.
   • Add To View... - opens the Target View form. Select the View to which you want to add the selected Subview and click Done in the top right.
   • Show Open Incidents - opens the Incidents dashboard for selected Subview.
   • Threshold Settings - opens the Thresholds dashboard for the selected Subview.

To drill down into a device or object:

1. Navigate to the Map dashboard for your selected View/Subview.
2. Right click on a device or object. A drop down menu will appear with the following options:
   • Create Custom Connection - select two devices to create a custom connection between them.
   • Configuration Management
   • Add To View... - opens an Explorer form. Select the View to which you want to add the selected device and click Done in the top right, otherwise click Cancel.
   • Explore - opens the Summary dashboard page for the selected device.
   • MIB Browser - opens the MIB Browser for the selected device.
   • Remote Terminal - opens the Remote Terminal for the selected device.
   • Show Open Incidents - opens the Incidents dashboard page for the selected device.
   • Suppress Events - opens the Event Suppression form for the selected device.
   • Threshold Settings - opens the Thresholds dashboard page for the selected device.
   • Access via Web Browser
   • Connectivity Report - opens the Infrastructure Connectivity Report for the selected device.

To drill down into connections between managed objects:

1. Navigate to the Map for your chosen View/Subview.
2. Double click on the connection you want to look at, or right click on it and click Show Details on the menu that appears.
3. The Connection Details form will slide in on the right. This form lists all of the connections between the two connected managed objects. The status and direction of each connection is displayed, along with the Subviews/components (and their parent devices) that are connected.
4. You can click on each Subview, component or device to open the Summary dashboard for the selected managed object.

To add a custom device to the map:

1. Navigate to your desired Map dashlet.
2. Right click on the map to open the map's Context Menu and click Add Custom Device.
3. This opens the Add Custom Device form on the right. Enter the name of the device and click Done, otherwise click Cancel.